eslint-plugin-jsdoc 52.0.4 → 53.0.1

package/dist/jsdocUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsdocUtils.js","names":["getDefaultTagStructureForMode","WarnSettings"],"sources":["../src/jsdocUtils.js"],"sourcesContent":["import getDefaultTagStructureForMode from './getDefaultTagStructureForMode.js';\nimport {\n  closureTags,\n  jsdocTags,\n  typeScriptTags,\n} from './tagNames.js';\nimport WarnSettings from './WarnSettings.js';\nimport {\n  tryParse,\n} from '@es-joy/jsdoccomment';\n\n/**\n * @typedef {number} Integer\n */\n/**\n * @typedef {import('./utils/hasReturnValue.js').ESTreeOrTypeScriptNode} ESTreeOrTypeScriptNode\n */\n\n/**\n * @typedef {\"jsdoc\"|\"typescript\"|\"closure\"|\"permissive\"} ParserMode\n */\n\n/**\n * @type {import('./getDefaultTagStructureForMode.js').TagStructure}\n */\nlet tagStructure;\n\n/**\n * @param {ParserMode} mode\n * @returns {void}\n */\nconst setTagStructure = (mode) => {\n  tagStructure = getDefaultTagStructureForMode(mode);\n};\n\n/**\n * @typedef {undefined|string|{\n *   name: Integer,\n *   restElement: boolean\n * }|{\n *   isRestProperty: boolean|undefined,\n *   name: string,\n *   restElement: boolean\n * }|{\n *   name: string,\n *   restElement: boolean\n * }} ParamCommon\n */\n/**\n * @typedef {ParamCommon|[string|undefined, (FlattendRootInfo & {\n *   annotationParamName?: string,\n * })]|NestedParamInfo} ParamNameInfo\n */\n\n/**\n * @typedef {{\n *   hasPropertyRest: boolean,\n *   hasRestElement: boolean,\n *   names: string[],\n *   rests: boolean[],\n * }} FlattendRootInfo\n */\n/**\n * @typedef {[string, (string[]|ParamInfo[])]} NestedParamInfo\n */\n/**\n * @typedef {ParamCommon|\n * [string|undefined, (FlattendRootInfo & {\n *   annotationParamName?: string\n * })]|\n * NestedParamInfo} ParamInfo\n */\n\n/**\n * Given a nested array of property names, reduce them to a single array,\n * appending the name of the root element along the way if present.\n * @callback FlattenRoots\n * @param {ParamInfo[]} params\n * @param {string} [root]\n * @returns {FlattendRootInfo}\n */\n\n/** @type {FlattenRoots} */\nconst flattenRoots = (params, root = '') => {\n  let hasRestElement = false;\n  let hasPropertyRest = false;\n\n  /**\n   * @type {boolean[]}\n   */\n  const rests = [];\n\n  const names = params.reduce(\n    /**\n     * @param {string[]} acc\n     * @param {ParamInfo} cur\n     * @returns {string[]}\n     */\n    (acc, cur) => {\n      if (Array.isArray(cur)) {\n        let nms;\n        if (Array.isArray(cur[1])) {\n          nms = cur[1];\n        } else {\n          if (cur[1].hasRestElement) {\n            hasRestElement = true;\n          }\n\n          if (cur[1].hasPropertyRest) {\n            hasPropertyRest = true;\n          }\n\n          nms = cur[1].names;\n        }\n\n        const flattened = flattenRoots(nms, root ? `${root}.${cur[0]}` : cur[0]);\n        if (flattened.hasRestElement) {\n          hasRestElement = true;\n        }\n\n        if (flattened.hasPropertyRest) {\n          hasPropertyRest = true;\n        }\n\n        const inner = /** @type {string[]} */ ([\n          root ? `${root}.${cur[0]}` : cur[0],\n          ...flattened.names,\n        ].filter(Boolean));\n        rests.push(false, ...flattened.rests);\n\n        return acc.concat(inner);\n      }\n\n      if (typeof cur === 'object') {\n        if ('isRestProperty' in cur && cur.isRestProperty) {\n          hasPropertyRest = true;\n          rests.push(true);\n        } else {\n          rests.push(false);\n        }\n\n        if ('restElement' in cur && cur.restElement) {\n          hasRestElement = true;\n        }\n\n        acc.push(root ? `${root}.${String(cur.name)}` : String(cur.name));\n      } else if (typeof cur !== 'undefined') {\n        rests.push(false);\n        acc.push(root ? `${root}.${cur}` : cur);\n      }\n\n      return acc;\n    }, [],\n  );\n\n  return {\n    hasPropertyRest,\n    hasRestElement,\n    names,\n    rests,\n  };\n};\n\n/**\n * @param {import('@typescript-eslint/types').TSESTree.TSIndexSignature|\n *  import('@typescript-eslint/types').TSESTree.TSConstructSignatureDeclaration|\n *  import('@typescript-eslint/types').TSESTree.TSCallSignatureDeclaration|\n *  import('@typescript-eslint/types').TSESTree.TSPropertySignature} propSignature\n * @returns {undefined|string|[string, string[]]}\n */\nconst getPropertiesFromPropertySignature = (propSignature) => {\n  if (\n    propSignature.type === 'TSIndexSignature' ||\n    propSignature.type === 'TSConstructSignatureDeclaration' ||\n    propSignature.type === 'TSCallSignatureDeclaration'\n  ) {\n    return undefined;\n  }\n\n  if (propSignature.typeAnnotation && propSignature.typeAnnotation.typeAnnotation.type === 'TSTypeLiteral') {\n    return [\n      /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n        propSignature.key\n      ).name,\n      propSignature.typeAnnotation.typeAnnotation.members.map((member) => {\n        return /** @type {string} */ (\n          getPropertiesFromPropertySignature(\n            /** @type {import('@typescript-eslint/types').TSESTree.TSPropertySignature} */ (\n              member\n            ),\n          )\n        );\n      }),\n    ];\n  }\n\n  return /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n    propSignature.key\n  ).name;\n};\n\n/**\n * @param {ESTreeOrTypeScriptNode|null} functionNode\n * @param {boolean} [checkDefaultObjects]\n * @throws {Error}\n * @returns {ParamNameInfo[]}\n */\nconst getFunctionParameterNames = (\n  functionNode, checkDefaultObjects,\n) => {\n  /* eslint-disable complexity -- Temporary */\n  /**\n   * @param {import('estree').Identifier|import('estree').AssignmentPattern|\n   *   import('estree').ObjectPattern|import('estree').Property|\n   *   import('estree').RestElement|import('estree').ArrayPattern|\n   *   import('@typescript-eslint/types').TSESTree.TSParameterProperty|\n   *   import('@typescript-eslint/types').TSESTree.Property|\n   *   import('@typescript-eslint/types').TSESTree.RestElement|\n   *   import('@typescript-eslint/types').TSESTree.Identifier|\n   *   import('@typescript-eslint/types').TSESTree.ObjectPattern|\n   *   import('@typescript-eslint/types').TSESTree.BindingName|\n   *   import('@typescript-eslint/types').TSESTree.Parameter\n   * } param\n   * @param {boolean} [isProperty]\n   * @returns {ParamNameInfo|[string, ParamNameInfo[]]}\n   */\n  const getParamName = (param, isProperty) => {\n    /* eslint-enable complexity -- Temporary */\n    const hasLeftTypeAnnotation = 'left' in param && 'typeAnnotation' in param.left;\n\n    if ('typeAnnotation' in param || hasLeftTypeAnnotation) {\n      const typeAnnotation = hasLeftTypeAnnotation ?\n        /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n          param.left\n        ).typeAnnotation :\n        /** @type {import('@typescript-eslint/types').TSESTree.Identifier|import('@typescript-eslint/types').TSESTree.ObjectPattern} */\n        (param).typeAnnotation;\n\n      if (typeAnnotation?.typeAnnotation?.type === 'TSTypeLiteral') {\n        const propertyNames = typeAnnotation.typeAnnotation.members.map((member) => {\n          return getPropertiesFromPropertySignature(\n            /** @type {import('@typescript-eslint/types').TSESTree.TSPropertySignature} */\n            (member),\n          );\n        });\n\n        const flattened = {\n          ...flattenRoots(propertyNames),\n          annotationParamName: 'name' in param ? param.name : undefined,\n        };\n        const hasLeftName = 'left' in param && 'name' in param.left;\n\n        if ('name' in param || hasLeftName) {\n          return [\n            hasLeftName ?\n              /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n                param.left\n              ).name :\n              /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n                param\n              ).name,\n            flattened,\n          ];\n        }\n\n        return [\n          undefined, flattened,\n        ];\n      }\n    }\n\n    if ('name' in param) {\n      return param.name;\n    }\n\n    if ('left' in param && 'name' in param.left) {\n      return param.left.name;\n    }\n\n    if (\n      param.type === 'ObjectPattern' ||\n      ('left' in param &&\n      (\n        param\n      ).left.type === 'ObjectPattern')\n    ) {\n      const properties = /** @type {import('@typescript-eslint/types').TSESTree.ObjectPattern} */ (\n        param\n      ).properties ||\n        /** @type {import('estree').ObjectPattern} */\n        (\n          /** @type {import('@typescript-eslint/types').TSESTree.AssignmentPattern} */ (\n            param\n          ).left\n        )?.properties;\n      const roots = properties.map((prop) => {\n        return getParamName(prop, true);\n      });\n\n      return [\n        undefined, flattenRoots(roots),\n      ];\n    }\n\n    if (param.type === 'Property') {\n      switch (param.value.type) {\n        case 'ArrayPattern': {\n          return [\n          /** @type {import('estree').Identifier} */\n            (param.key).name,\n            /** @type {import('estree').ArrayPattern} */ (\n              param.value\n            ).elements.map((prop, idx) => {\n              return {\n                name: idx,\n                restElement: prop?.type === 'RestElement',\n              };\n            }),\n          ];\n        }\n\n        case 'ObjectPattern': {\n          return [\n          /** @type {import('estree').Identifier} */ (param.key).name,\n            /** @type {import('estree').ObjectPattern} */ (\n              param.value\n            ).properties.map((prop) => {\n              return /** @type {string|[string, string[]]} */ (getParamName(prop, isProperty));\n            }),\n          ];\n        }\n\n        case 'AssignmentPattern': {\n          switch (param.value.left.type) {\n            case 'ArrayPattern':\n              return [\n                /** @type {import('estree').Identifier} */\n                (param.key).name,\n                /** @type {import('estree').ArrayPattern} */ (\n                  param.value.left\n                ).elements.map((prop, idx) => {\n                  return {\n                    name: idx,\n                    restElement: prop?.type === 'RestElement',\n                  };\n                }),\n              ];\n            case 'Identifier':\n              // Default parameter\n              if (checkDefaultObjects && param.value.right.type === 'ObjectExpression') {\n                return [\n                  /** @type {import('estree').Identifier} */ (\n                    param.key\n                  ).name,\n                  /** @type {import('estree').AssignmentPattern} */ (\n                    param.value\n                  ).right.properties.map((prop) => {\n                    return /** @type {string} */ (getParamName(\n                      /** @type {import('estree').Property} */\n                      (prop),\n                      isProperty,\n                    ));\n                  }),\n                ];\n              }\n\n              break;\n            case 'ObjectPattern':\n              return [\n                /** @type {import('estree').Identifier} */\n                (param.key).name,\n                /** @type {import('estree').ObjectPattern} */ (\n                  param.value.left\n                ).properties.map((prop) => {\n                  return getParamName(prop, isProperty);\n                }),\n              ];\n          }\n        }\n      }\n\n      switch (param.key.type) {\n        case 'Identifier':\n          return param.key.name;\n\n          // The key of an object could also be a string or number\n        case 'Literal':\n        /* c8 ignore next 2 -- `raw` may not be present in all parsers */\n          return /** @type {string} */ (param.key.raw ||\n          param.key.value);\n\n          // case 'MemberExpression':\n        default:\n        // Todo: We should really create a structure (and a corresponding\n        //   option analogous to `checkRestProperty`) which allows for\n        //   (and optionally requires) dynamic properties to have a single\n        //   line of documentation\n          return undefined;\n      }\n    }\n\n    if (\n      param.type === 'ArrayPattern' ||\n      /** @type {import('estree').AssignmentPattern} */ (\n        param\n      ).left?.type === 'ArrayPattern'\n    ) {\n      const elements = /** @type {import('estree').ArrayPattern} */ (\n        param\n      ).elements || /** @type {import('estree').ArrayPattern} */ (\n        /** @type {import('estree').AssignmentPattern} */ (\n          param\n        ).left\n      )?.elements;\n      const roots = elements.map((prop, idx) => {\n        return {\n          name: `\"${idx}\"`,\n          restElement: prop?.type === 'RestElement',\n        };\n      });\n\n      return [\n        undefined, flattenRoots(roots),\n      ];\n    }\n\n    if ([\n      'ExperimentalRestProperty', 'RestElement',\n    ].includes(param.type)) {\n      return {\n        isRestProperty: isProperty,\n        name: /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n          /** @type {import('@typescript-eslint/types').TSESTree.RestElement} */ (\n            param\n          // @ts-expect-error Ok\n          ).argument).name ?? param?.argument?.elements?.map(({\n          // @ts-expect-error Ok\n          name,\n        }) => {\n          return name;\n        }),\n        restElement: true,\n      };\n    }\n\n    if (param.type === 'TSParameterProperty') {\n      return getParamName(\n        /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n          /** @type {import('@typescript-eslint/types').TSESTree.TSParameterProperty} */ (\n            param\n          ).parameter\n        ),\n        true,\n      );\n    }\n\n    throw new Error(`Unsupported function signature format: \\`${param.type}\\`.`);\n  };\n\n  if (!functionNode) {\n    return [];\n  }\n\n  return (/** @type {import('@typescript-eslint/types').TSESTree.FunctionDeclaration} */ (\n    functionNode\n  ).params || /** @type {import('@typescript-eslint/types').TSESTree.MethodDefinition} */ (\n    functionNode\n  ).value?.params || []).map((param) => {\n    return getParamName(param);\n  });\n};\n\n/**\n * @param {ESTreeOrTypeScriptNode} functionNode\n * @returns {Integer}\n */\nconst hasParams = (functionNode) => {\n  // Should also check `functionNode.value.params` if supporting `MethodDefinition`\n  return /** @type {import('@typescript-eslint/types').TSESTree.FunctionDeclaration} */ (\n    functionNode\n  ).params.length;\n};\n\n/**\n * Gets all names of the target type, including those that refer to a path, e.g.\n * `foo` or `foo.bar`.\n * @param {import('comment-parser').Block} jsdoc\n * @param {string} targetTagName\n * @returns {{\n *   idx: Integer,\n *   name: string,\n *   type: string\n * }[]}\n */\nconst getJsdocTagsDeep = (jsdoc, targetTagName) => {\n  const ret = [];\n  for (const [\n    idx,\n    {\n      name,\n      tag,\n      type,\n    },\n  ] of jsdoc.tags.entries()) {\n    if (tag !== targetTagName) {\n      continue;\n    }\n\n    ret.push({\n      idx,\n      name,\n      type,\n    });\n  }\n\n  return ret;\n};\n\nconst modeWarnSettings = WarnSettings();\n\n/**\n * @param {ParserMode|undefined} mode\n * @param {Reporter} context\n * @returns {import('./tagNames.js').AliasedTags}\n */\nconst getTagNamesForMode = (mode, context) => {\n  switch (mode) {\n    case 'closure':\n    case 'permissive':\n      return closureTags;\n    case 'jsdoc':\n      return jsdocTags; case 'typescript':\n      return typeScriptTags;\n    default:\n      if (!modeWarnSettings.hasBeenWarned(context, 'mode')) {\n        context.report({\n          loc: {\n            end: {\n              column: 1,\n              line: 1,\n            },\n            start: {\n              column: 1,\n              line: 1,\n            },\n          },\n          message: `Unrecognized value \\`${mode}\\` for \\`settings.jsdoc.mode\\`.`,\n        });\n        modeWarnSettings.markSettingAsWarned(context, 'mode');\n      }\n\n      // We'll avoid breaking too many other rules\n      return jsdocTags;\n  }\n};\n\n/**\n * @param {import('comment-parser').Spec} tg\n * @param {boolean} [returnArray]\n * @returns {string[]|string}\n */\nconst getTagDescription = (tg, returnArray) => {\n  /**\n   * @type {string[]}\n   */\n  const descriptions = [];\n  tg.source.some(({\n    tokens: {\n      description,\n      end,\n      lineEnd,\n      name,\n      postDelimiter,\n      postTag,\n      tag,\n      type,\n    },\n  }) => {\n    const desc = (\n      tag && postTag ||\n        !tag && !name && !type && postDelimiter || ''\n\n    // Remove space\n    ).slice(1) +\n        (description || '') + (lineEnd || '');\n\n    if (end) {\n      if (desc) {\n        descriptions.push(desc);\n      }\n\n      return true;\n    }\n\n    descriptions.push(desc);\n\n    return false;\n  });\n\n  return returnArray ? descriptions : descriptions.join('\\n');\n};\n\n/**\n * @typedef {{\n *   report: (descriptor: import('eslint').Rule.ReportDescriptor) => void\n * }} Reporter\n */\n\n/**\n * @param {string} name\n * @param {ParserMode|undefined} mode\n * @param {TagNamePreference} tagPreference\n * @param {Reporter} context\n * @returns {string|false|{\n *   message: string;\n *   replacement?: string|undefined;\n * }}\n */\nconst getPreferredTagNameSimple = (\n  name,\n  mode,\n  tagPreference = {},\n  // eslint-disable-next-line unicorn/no-object-as-default-parameter -- Ok\n  context = {\n    report () {\n      // No-op\n    },\n  },\n) => {\n  const prefValues = Object.values(tagPreference);\n  if (prefValues.includes(name) || prefValues.some((prefVal) => {\n    return prefVal && typeof prefVal === 'object' && prefVal.replacement === name;\n  })) {\n    return name;\n  }\n\n  // Allow keys to have a 'tag ' prefix to avoid upstream bug in ESLint\n  // that disallows keys that conflict with Object.prototype,\n  // e.g. 'tag constructor' for 'constructor':\n  // https://github.com/eslint/eslint/issues/13289\n  // https://github.com/gajus/eslint-plugin-jsdoc/issues/537\n  const tagPreferenceFixed = Object.fromEntries(\n    Object\n      .entries(tagPreference)\n      .map(([\n        key,\n        value,\n      ]) => {\n        return [\n          key.replace(/^tag /v, ''), value,\n        ];\n      }),\n  );\n\n  if (Object.hasOwn(tagPreferenceFixed, name)) {\n    return tagPreferenceFixed[name];\n  }\n\n  const tagNames = getTagNamesForMode(mode, context);\n\n  const preferredTagName = Object.entries(tagNames).find(([\n    , aliases,\n  ]) => {\n    return aliases.includes(name);\n  })?.[0];\n  if (preferredTagName) {\n    return preferredTagName;\n  }\n\n  return name;\n};\n\n/**\n * @param {import('eslint').Rule.RuleContext} context\n * @param {ParserMode|undefined} mode\n * @param {string} name\n * @param {string[]} definedTags\n * @returns {boolean}\n */\nconst isValidTag = (\n  context,\n  mode,\n  name,\n  definedTags,\n) => {\n  const tagNames = getTagNamesForMode(mode, context);\n\n  const validTagNames = Object.keys(tagNames).concat(Object.values(tagNames).flat());\n  const additionalTags = definedTags;\n  const allTags = validTagNames.concat(additionalTags);\n\n  return allTags.includes(name);\n};\n\n/**\n * @param {import('./iterateJsdoc.js').JsdocBlockWithInline} jsdoc\n * @param {string} targetTagName\n * @returns {boolean}\n */\nconst hasTag = (jsdoc, targetTagName) => {\n  const targetTagLower = targetTagName.toLowerCase();\n\n  return jsdoc.tags.some((doc) => {\n    return doc.tag.toLowerCase() === targetTagLower;\n  });\n};\n\n/**\n * @param {import('./iterateJsdoc.js').JsdocBlockWithInline} jsdoc\n * @param {(tag: import('@es-joy/jsdoccomment').JsdocTagWithInline) => boolean} filter\n * @returns {import('@es-joy/jsdoccomment').JsdocTagWithInline[]}\n */\nconst filterTags = (jsdoc, filter) => {\n  return jsdoc.tags.filter((tag) => {\n    return filter(tag);\n  });\n};\n\n/**\n * @param {import('./iterateJsdoc.js').JsdocBlockWithInline} jsdoc\n * @param {string} tagName\n * @returns {import('comment-parser').Spec[]}\n */\nconst getTags = (jsdoc, tagName) => {\n  return filterTags(jsdoc, (item) => {\n    return item.tag === tagName;\n  });\n};\n\n/**\n * @param {import('./iterateJsdoc.js').JsdocBlockWithInline} jsdoc\n * @param {{\n *   tagName: string,\n *   context?: import('eslint').Rule.RuleContext,\n *   mode?: ParserMode,\n *   report?: import('./iterateJsdoc.js').Report\n *   tagNamePreference?: TagNamePreference\n *   skipReportingBlockedTag?: boolean,\n *   allowObjectReturn?: boolean,\n *   defaultMessage?: string,\n * }} cfg\n * @returns {string|undefined|false|{\n *   message: string;\n *   replacement?: string|undefined;\n * }|{\n *   blocked: true,\n *   tagName: string\n * }}\n */\nconst getPreferredTagName = (jsdoc, {\n  allowObjectReturn = false,\n  context,\n  tagName,\n  defaultMessage = `Unexpected tag \\`@${tagName}\\``,\n  mode,\n  report = () => {},\n  skipReportingBlockedTag = false,\n  tagNamePreference,\n}) => {\n  const ret = getPreferredTagNameSimple(tagName, mode, tagNamePreference, context);\n  const isObject = ret && typeof ret === 'object';\n  if (hasTag(jsdoc, tagName) && (ret === false || isObject && !ret.replacement)) {\n    if (skipReportingBlockedTag) {\n      return {\n        blocked: true,\n        tagName,\n      };\n    }\n\n    const message = isObject && ret.message || defaultMessage;\n    report(message, null, getTags(jsdoc, tagName)[0]);\n\n    return false;\n  }\n\n  return isObject && !allowObjectReturn ? ret.replacement : ret;\n};\n\n/**\n * @param {import('./iterateJsdoc.js').JsdocBlockWithInline} jsdoc\n * @param {string} tagName\n * @param {(\n *   matchingJsdocTag: import('@es-joy/jsdoccomment').JsdocTagWithInline,\n *   targetTagName: string\n * ) => void} arrayHandler\n * @param {object} cfg\n * @param {import('eslint').Rule.RuleContext} [cfg.context]\n * @param {ParserMode} [cfg.mode]\n * @param {import('./iterateJsdoc.js').Report} [cfg.report]\n * @param {TagNamePreference} [cfg.tagNamePreference]\n * @param {boolean} [cfg.skipReportingBlockedTag]\n * @returns {void}\n */\nconst forEachPreferredTag = (\n  jsdoc, tagName, arrayHandler,\n  {\n    context,\n    mode,\n    report,\n    skipReportingBlockedTag = false,\n    tagNamePreference,\n  } = {},\n) => {\n  const targetTagName = /** @type {string|false} */ (\n    getPreferredTagName(jsdoc, {\n      context,\n      mode,\n      report,\n      skipReportingBlockedTag,\n      tagName,\n      tagNamePreference,\n    })\n  );\n  if (!targetTagName ||\n    skipReportingBlockedTag && targetTagName && typeof targetTagName === 'object'\n  ) {\n    return;\n  }\n\n  const matchingJsdocTags = jsdoc.tags.filter(({\n    tag,\n  }) => {\n    return tag === targetTagName;\n  });\n\n  for (const matchingJsdocTag of matchingJsdocTags) {\n    arrayHandler(\n      /**\n       * @type {import('@es-joy/jsdoccomment').JsdocTagWithInline}\n       */ (\n        matchingJsdocTag\n      ), targetTagName,\n    );\n  }\n};\n\n/**\n * Get all tags, inline tags and inline tags in tags\n * @param {import('./iterateJsdoc.js').JsdocBlockWithInline} jsdoc\n * @returns {(import('comment-parser').Spec|\n *   import('@es-joy/jsdoccomment').JsdocInlineTagNoType)[]}\n */\nconst getAllTags = (jsdoc) => {\n  return [\n    ...jsdoc.tags,\n    ...jsdoc.inlineTags.map((inlineTag) => {\n      // Tags don't have source or line numbers, so add before returning\n      let line = -1;\n      for (const {\n        tokens: {\n          description,\n        },\n      } of jsdoc.source) {\n        line++;\n        if (description && description.includes(`{@${inlineTag.tag}`)) {\n          break;\n        }\n      }\n\n      inlineTag.line = line;\n\n      return inlineTag;\n    }),\n    ...jsdoc.tags.flatMap((tag) => {\n      let tagBegins = -1;\n      for (const {\n        tokens: {\n          tag: tg,\n        },\n      } of jsdoc.source) {\n        tagBegins++;\n        if (tg) {\n          break;\n        }\n      }\n\n      for (const inlineTag of tag.inlineTags) {\n        /** @type {import('./iterateJsdoc.js').Integer} */\n        let line = 0;\n        for (const {\n          number,\n          tokens: {\n            description,\n          },\n        } of tag.source) {\n          if (description && description.includes(`{@${inlineTag.tag}`)) {\n            line = number;\n            break;\n          }\n        }\n\n        inlineTag.line = tagBegins + line - 1;\n      }\n\n      return (\n        /**\n         * @type {import('comment-parser').Spec & {\n         *   inlineTags: import('@es-joy/jsdoccomment').JsdocInlineTagNoType[]\n         * }}\n         */ (\n          tag\n        ).inlineTags\n      );\n    }),\n  ];\n};\n\n/**\n * @param {import('./iterateJsdoc.js').JsdocBlockWithInline} jsdoc\n * @param {string[]} targetTagNames\n * @returns {boolean}\n */\nconst hasATag = (jsdoc, targetTagNames) => {\n  return targetTagNames.some((targetTagName) => {\n    return hasTag(jsdoc, targetTagName);\n  });\n};\n\n/**\n * Checks if the JSDoc comment has an undefined type.\n * @param {import('comment-parser').Spec|null|undefined} tag\n *   the tag which should be checked.\n * @param {ParserMode} mode\n * @returns {boolean}\n *   true in case a defined type is undeclared; otherwise false.\n */\nconst mayBeUndefinedTypeTag = (tag, mode) => {\n  // The function should not continue in the event the type is not defined...\n  if (typeof tag === 'undefined' || tag === null) {\n    return true;\n  }\n\n  // .. same applies if it declares an `{undefined}` or `{void}` type\n  const tagType = tag.type.trim();\n\n  // Exit early if matching\n  if (\n    tagType === 'undefined' || tagType === 'void' ||\n    tagType === '*' || tagType === 'any'\n  ) {\n    return true;\n  }\n\n  let parsedTypes;\n  try {\n    parsedTypes = tryParse(\n      tagType,\n      mode === 'permissive' ? undefined : [\n        mode,\n      ],\n    );\n  } catch {\n    // Ignore\n  }\n\n  if (\n    // We do not traverse deeply as it could be, e.g., `Promise<void>`\n    parsedTypes &&\n    parsedTypes.type === 'JsdocTypeUnion' &&\n    parsedTypes.elements.find((elem) => {\n      return elem.type === 'JsdocTypeUndefined' ||\n        elem.type === 'JsdocTypeName' && elem.value === 'void';\n    })) {\n    return true;\n  }\n\n  // In any other case, a type is present\n  return false;\n};\n\n/**\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} map\n * @param {string} tag\n * @returns {Map<string, string|string[]|boolean|undefined>}\n */\nconst ensureMap = (map, tag) => {\n  if (!map.has(tag)) {\n    map.set(tag, new Map());\n  }\n\n  return /** @type {Map<string, string | boolean>} */ (map.get(tag));\n};\n\n/**\n * @param {import('./iterateJsdoc.js').StructuredTags} structuredTags\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {void}\n */\nconst overrideTagStructure = (structuredTags, tagMap = tagStructure) => {\n  for (const [\n    tag,\n    {\n      name,\n      required = [],\n      type,\n    },\n  ] of Object.entries(structuredTags)) {\n    const tagStruct = ensureMap(tagMap, tag);\n\n    tagStruct.set('namepathRole', name);\n    tagStruct.set('typeAllowed', type);\n\n    const requiredName = required.includes('name');\n    if (requiredName && name === false) {\n      throw new Error('Cannot add \"name\" to `require` with the tag\\'s `name` set to `false`');\n    }\n\n    tagStruct.set('nameRequired', requiredName);\n\n    const requiredType = required.includes('type');\n    if (requiredType && type === false) {\n      throw new Error('Cannot add \"type\" to `require` with the tag\\'s `type` set to `false`');\n    }\n\n    tagStruct.set('typeRequired', requiredType);\n\n    const typeOrNameRequired = required.includes('typeOrNameRequired');\n    if (typeOrNameRequired && name === false) {\n      throw new Error('Cannot add \"typeOrNameRequired\" to `require` with the tag\\'s `name` set to `false`');\n    }\n\n    if (typeOrNameRequired && type === false) {\n      throw new Error('Cannot add \"typeOrNameRequired\" to `require` with the tag\\'s `type` set to `false`');\n    }\n\n    tagStruct.set('typeOrNameRequired', typeOrNameRequired);\n  }\n};\n\n/**\n * @param {ParserMode} mode\n * @param {import('./iterateJsdoc.js').StructuredTags} structuredTags\n * @returns {import('./getDefaultTagStructureForMode.js').TagStructure}\n */\nconst getTagStructureForMode = (mode, structuredTags) => {\n  const tagStruct = getDefaultTagStructureForMode(mode);\n\n  try {\n    overrideTagStructure(structuredTags, tagStruct);\n  /* c8 ignore next 3 */\n  } catch {\n    //\n  }\n\n  return tagStruct;\n};\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean}\n */\nconst isNamepathDefiningTag = (tag, tagMap = tagStructure) => {\n  const tagStruct = ensureMap(tagMap, tag);\n\n  return tagStruct.get('namepathRole') === 'namepath-defining';\n};\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean}\n */\nconst isNamepathReferencingTag = (tag, tagMap = tagStructure) => {\n  const tagStruct = ensureMap(tagMap, tag);\n  return tagStruct.get('namepathRole') === 'namepath-referencing';\n};\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean}\n */\nconst isNamepathOrUrlReferencingTag = (tag, tagMap = tagStructure) => {\n  const tagStruct = ensureMap(tagMap, tag);\n  return tagStruct.get('namepathRole') === 'namepath-or-url-referencing';\n};\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean|undefined}\n */\nconst tagMustHaveTypePosition = (tag, tagMap = tagStructure) => {\n  const tagStruct = ensureMap(tagMap, tag);\n\n  return /** @type {boolean|undefined} */ (tagStruct.get('typeRequired'));\n};\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean|string}\n */\nconst tagMightHaveTypePosition = (tag, tagMap = tagStructure) => {\n  if (tagMustHaveTypePosition(tag, tagMap)) {\n    return true;\n  }\n\n  const tagStruct = ensureMap(tagMap, tag);\n\n  const ret = /** @type {boolean|undefined} */ (tagStruct.get('typeAllowed'));\n\n  return ret === undefined ? true : ret;\n};\n\nconst namepathTypes = new Set([\n  'namepath-defining', 'namepath-referencing',\n]);\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean}\n */\nconst tagMightHaveNamePosition = (tag, tagMap = tagStructure) => {\n  const tagStruct = ensureMap(tagMap, tag);\n\n  const ret = tagStruct.get('namepathRole');\n\n  return ret === undefined ? true : Boolean(ret);\n};\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean}\n */\nconst tagMightHaveNamepath = (tag, tagMap = tagStructure) => {\n  const tagStruct = ensureMap(tagMap, tag);\n\n  const nampathRole = tagStruct.get('namepathRole');\n\n  return nampathRole !== false &&\n    namepathTypes.has(/** @type {string} */ (nampathRole));\n};\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean|undefined}\n */\nconst tagMustHaveNamePosition = (tag, tagMap = tagStructure) => {\n  const tagStruct = ensureMap(tagMap, tag);\n\n  return /** @type {boolean|undefined} */ (tagStruct.get('nameRequired'));\n};\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean}\n */\nconst tagMightHaveEitherTypeOrNamePosition = (tag, tagMap) => {\n  return Boolean(tagMightHaveTypePosition(tag, tagMap)) || tagMightHaveNamepath(tag, tagMap);\n};\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean|undefined}\n */\nconst tagMustHaveEitherTypeOrNamePosition = (tag, tagMap) => {\n  const tagStruct = ensureMap(tagMap, tag);\n\n  return /** @type {boolean} */ (tagStruct.get('typeOrNameRequired'));\n};\n\n/**\n * @param {import('comment-parser').Spec} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean|undefined}\n */\nconst tagMissingRequiredTypeOrNamepath = (tag, tagMap = tagStructure) => {\n  const mustHaveTypePosition = tagMustHaveTypePosition(tag.tag, tagMap);\n  const mightHaveTypePosition = tagMightHaveTypePosition(tag.tag, tagMap);\n  const hasTypePosition = mightHaveTypePosition && Boolean(tag.type);\n  const hasNameOrNamepathPosition = (\n    tagMustHaveNamePosition(tag.tag, tagMap) ||\n    tagMightHaveNamepath(tag.tag, tagMap)\n  ) && Boolean(tag.name);\n  const mustHaveEither = tagMustHaveEitherTypeOrNamePosition(tag.tag, tagMap);\n  const hasEither = tagMightHaveEitherTypeOrNamePosition(tag.tag, tagMap) &&\n    (hasTypePosition || hasNameOrNamepathPosition);\n\n  return mustHaveEither && !hasEither && !mustHaveTypePosition;\n};\n\n/* eslint-disable complexity -- Temporary */\n/**\n * @param {ESTreeOrTypeScriptNode|null|undefined} node\n * @param {boolean} [checkYieldReturnValue]\n * @returns {boolean}\n */\nconst hasNonFunctionYield = (node, checkYieldReturnValue) => {\n  /* eslint-enable complexity -- Temporary */\n  if (!node) {\n    return false;\n  }\n\n  switch (node.type) {\n    case 'ArrayExpression':\n\n    case 'ArrayPattern':\n      return node.elements.some((element) => {\n        return hasNonFunctionYield(element, checkYieldReturnValue);\n      });\n    case 'AssignmentExpression':\n    case 'BinaryExpression':\n    case 'LogicalExpression': {\n      return hasNonFunctionYield(node.left, checkYieldReturnValue) ||\n      hasNonFunctionYield(node.right, checkYieldReturnValue);\n    }\n\n    case 'AssignmentPattern':\n      return hasNonFunctionYield(node.right, checkYieldReturnValue);\n    case 'BlockStatement': {\n      return node.body.some((bodyNode) => {\n        return ![\n          'ArrowFunctionExpression',\n          'FunctionDeclaration',\n          'FunctionExpression',\n        ].includes(bodyNode.type) && hasNonFunctionYield(\n          bodyNode, checkYieldReturnValue,\n        );\n      });\n    }\n\n    /* c8 ignore next 2 -- In Babel? */\n    case 'CallExpression':\n    // @ts-expect-error In Babel?\n    case 'OptionalCallExpression':\n      return node.arguments.some((element) => {\n        return hasNonFunctionYield(element, checkYieldReturnValue);\n      });\n    case 'ChainExpression':\n    case 'ExpressionStatement': {\n      return hasNonFunctionYield(node.expression, checkYieldReturnValue);\n    }\n\n    /* c8 ignore next 2 -- In Babel? */\n    // @ts-expect-error In Babel?\n    case 'ClassProperty':\n\n    /* c8 ignore next 2 -- In Babel? */\n      // @ts-expect-error In Babel?\n    case 'ObjectProperty':\n    /* c8 ignore next 2 -- In Babel? */\n    case 'Property':\n\n    case 'PropertyDefinition':\n      return node.computed && hasNonFunctionYield(node.key, checkYieldReturnValue) ||\n      hasNonFunctionYield(node.value, checkYieldReturnValue);\n\n    case 'ConditionalExpression':\n\n    case 'IfStatement': {\n      return hasNonFunctionYield(node.test, checkYieldReturnValue) ||\n      hasNonFunctionYield(node.consequent, checkYieldReturnValue) ||\n      hasNonFunctionYield(node.alternate, checkYieldReturnValue);\n    }\n\n    case 'DoWhileStatement':\n    case 'ForInStatement':\n\n    case 'ForOfStatement':\n\n    case 'ForStatement':\n\n    case 'LabeledStatement':\n    case 'WhileStatement':\n    case 'WithStatement': {\n      return hasNonFunctionYield(node.body, checkYieldReturnValue);\n    }\n\n    /* c8 ignore next 2 -- In Babel? */\n    // @ts-expect-error In Babel?\n    case 'Import':\n    case 'ImportExpression':\n      return hasNonFunctionYield(node.source, checkYieldReturnValue);\n\n    // ?.\n      /* c8 ignore next 2 -- In Babel? */\n    case 'MemberExpression':\n    // @ts-expect-error In Babel?\n    case 'OptionalMemberExpression':\n      return hasNonFunctionYield(node.object, checkYieldReturnValue) ||\n      hasNonFunctionYield(node.property, checkYieldReturnValue);\n\n    case 'ObjectExpression':\n    /* eslint-disable no-fallthrough */\n    case 'ObjectPattern':\n      /* eslint-enable no-fallthrough */\n      return node.properties.some((property) => {\n        return hasNonFunctionYield(property, checkYieldReturnValue);\n      });\n      /* c8 ignore next 2 -- In Babel? */\n      // @ts-expect-error In Babel?\n    case 'ObjectMethod':\n    /* c8 ignore next 6 -- In Babel? */\n    // @ts-expect-error In Babel?\n      return node.computed && hasNonFunctionYield(node.key, checkYieldReturnValue) ||\n      // @ts-expect-error In Babel?\n      node.arguments.some((nde) => {\n        return hasNonFunctionYield(nde, checkYieldReturnValue);\n      });\n    case 'ReturnStatement': {\n      if (node.argument === null) {\n        return false;\n      }\n\n      return hasNonFunctionYield(node.argument, checkYieldReturnValue);\n    }\n\n    // Comma\n    case 'SequenceExpression':\n\n    case 'TemplateLiteral':\n      return node.expressions.some((subExpression) => {\n        return hasNonFunctionYield(subExpression, checkYieldReturnValue);\n      });\n    case 'SpreadElement':\n\n    case 'UnaryExpression':\n      return hasNonFunctionYield(node.argument, checkYieldReturnValue);\n\n    case 'SwitchStatement': {\n      return node.cases.some(\n        (someCase) => {\n          return someCase.consequent.some((nde) => {\n            return hasNonFunctionYield(nde, checkYieldReturnValue);\n          });\n        },\n      );\n    }\n\n    case 'TaggedTemplateExpression':\n      return hasNonFunctionYield(node.quasi, checkYieldReturnValue);\n\n    case 'TryStatement': {\n      return hasNonFunctionYield(node.block, checkYieldReturnValue) ||\n      hasNonFunctionYield(\n        node.handler && node.handler.body, checkYieldReturnValue,\n      ) ||\n      hasNonFunctionYield(\n        /** @type {import('@typescript-eslint/types').TSESTree.BlockStatement} */\n        (node.finalizer),\n        checkYieldReturnValue,\n      );\n    }\n\n    case 'VariableDeclaration': {\n      return node.declarations.some((nde) => {\n        return hasNonFunctionYield(nde, checkYieldReturnValue);\n      });\n    }\n\n    case 'VariableDeclarator': {\n      return hasNonFunctionYield(node.id, checkYieldReturnValue) ||\n      hasNonFunctionYield(node.init, checkYieldReturnValue);\n    }\n\n    case 'YieldExpression': {\n      if (checkYieldReturnValue) {\n        if (\n        /** @type {import('eslint').Rule.Node} */ (\n            node\n          ).parent.type === 'VariableDeclarator'\n        ) {\n          return true;\n        }\n\n        return false;\n      }\n\n      // void return does not count.\n      if (node.argument === null) {\n        return false;\n      }\n\n      return true;\n    }\n\n    default: {\n      return false;\n    }\n  }\n};\n\n/**\n * Checks if a node has a return statement. Void return does not count.\n * @param {ESTreeOrTypeScriptNode} node\n * @param {boolean} [checkYieldReturnValue]\n * @returns {boolean}\n */\nconst hasYieldValue = (node, checkYieldReturnValue) => {\n  return /** @type {import('@typescript-eslint/types').TSESTree.FunctionDeclaration} */ (\n    node\n  ).generator && (\n    /** @type {import('@typescript-eslint/types').TSESTree.FunctionDeclaration} */ (\n      node\n    ).expression || hasNonFunctionYield(\n      /** @type {import('@typescript-eslint/types').TSESTree.FunctionDeclaration} */\n      (node).body,\n      checkYieldReturnValue,\n    )\n  );\n};\n\n/**\n * Checks if a node has a throws statement.\n * @param {ESTreeOrTypeScriptNode|null|undefined} node\n * @param {boolean} [innerFunction]\n * @returns {boolean}\n */\n// eslint-disable-next-line complexity\nconst hasThrowValue = (node, innerFunction) => {\n  if (!node) {\n    return false;\n  }\n\n  // There are cases where a function may execute its inner function which\n  //   throws, but we're treating functions atomically rather than trying to\n  //   follow them\n  switch (node.type) {\n    case 'ArrowFunctionExpression':\n    case 'FunctionDeclaration':\n    case 'FunctionExpression': {\n      return !innerFunction && !node.async && hasThrowValue(node.body, true);\n    }\n\n    case 'BlockStatement': {\n      return node.body.some((bodyNode) => {\n        return bodyNode.type !== 'FunctionDeclaration' && hasThrowValue(bodyNode);\n      });\n    }\n\n    case 'DoWhileStatement':\n    case 'ForInStatement':\n    case 'ForOfStatement':\n    case 'ForStatement':\n    case 'LabeledStatement':\n    case 'WhileStatement':\n    case 'WithStatement': {\n      return hasThrowValue(node.body);\n    }\n\n    case 'IfStatement': {\n      return hasThrowValue(node.consequent) || hasThrowValue(node.alternate);\n    }\n\n    case 'SwitchStatement': {\n      return node.cases.some(\n        (someCase) => {\n          return someCase.consequent.some((nde) => {\n            return hasThrowValue(nde);\n          });\n        },\n      );\n    }\n\n    case 'ThrowStatement': {\n      return true;\n    }\n\n    // We only consider it to throw an error if the catch or finally blocks throw an error.\n    case 'TryStatement': {\n      return hasThrowValue(node.handler && node.handler.body) ||\n        hasThrowValue(node.finalizer);\n    }\n\n    default: {\n      return false;\n    }\n  }\n};\n\n/**\n * @param {string} tag\n */\n/*\nconst isInlineTag = (tag) => {\n  return /^(@link|@linkcode|@linkplain|@tutorial) /v.test(tag);\n};\n*/\n\n/**\n * Parses GCC Generic/Template types\n * @see {@link https://github.com/google/closure-compiler/wiki/Generic-Types}\n * @see {@link https://www.typescriptlang.org/docs/handbook/jsdoc-supported-types.html#template}\n * @param {import('comment-parser').Spec} tag\n * @returns {string[]}\n */\nconst parseClosureTemplateTag = (tag) => {\n  return tag.name\n    .split(',')\n    .map((type) => {\n      return type.trim().replace(/^\\[?(?<name>.*?)=.*$/v, '$<name>');\n    });\n};\n\n/**\n * @typedef {true|string[]} DefaultContexts\n */\n\n/**\n * Checks user option for `contexts` array, defaulting to\n * contexts designated by the rule. Returns an array of\n * ESTree AST types, indicating allowable contexts.\n * @param {import('eslint').Rule.RuleContext} context\n * @param {DefaultContexts|undefined} defaultContexts\n * @param {{\n *   contexts?: import('./iterateJsdoc.js').Context[]\n * }} settings\n * @returns {(string|import('./iterateJsdoc.js').ContextObject)[]}\n */\nconst enforcedContexts = (context, defaultContexts, settings) => {\n  const contexts = context.options[0]?.contexts || settings.contexts || (defaultContexts === true ? [\n    'ArrowFunctionExpression',\n    'FunctionDeclaration',\n    'FunctionExpression',\n    'TSDeclareFunction',\n  ] : defaultContexts);\n\n  return contexts;\n};\n\n/**\n * @param {import('./iterateJsdoc.js').Context[]} contexts\n * @param {import('./iterateJsdoc.js').CheckJsdoc} checkJsdoc\n * @param {import('@es-joy/jsdoccomment').CommentHandler} [handler]\n * @returns {import('eslint').Rule.RuleListener}\n */\nconst getContextObject = (contexts, checkJsdoc, handler) => {\n  /** @type {import('eslint').Rule.RuleListener} */\n  const properties = {};\n\n  for (const [\n    idx,\n    prop,\n  ] of contexts.entries()) {\n    /** @type {string} */\n    let property;\n\n    /** @type {(node: import('eslint').Rule.Node) => void} */\n    let value;\n\n    if (typeof prop === 'object') {\n      const selInfo = {\n        lastIndex: idx,\n        selector: prop.context,\n      };\n      if (prop.comment) {\n        property = /** @type {string} */ (prop.context);\n        value = checkJsdoc.bind(\n          null,\n          {\n            ...selInfo,\n            comment: prop.comment,\n          },\n          /**\n           * @type {(jsdoc: import('@es-joy/jsdoccomment').JsdocBlockWithInline) => boolean}\n           */\n          (/** @type {import('@es-joy/jsdoccomment').CommentHandler} */ (\n            handler\n          ).bind(null, prop.comment)),\n        );\n      } else {\n        property = /** @type {string} */ (prop.context);\n        value = checkJsdoc.bind(null, selInfo, null);\n      }\n    } else {\n      const selInfo = {\n        lastIndex: idx,\n        selector: prop,\n      };\n      property = prop;\n      value = checkJsdoc.bind(null, selInfo, null);\n    }\n\n    const old = /**\n                 * @type {((node: import('eslint').Rule.Node) => void)}\n                 */ (properties[property]);\n    properties[property] = old ?\n      /**\n       * @type {((node: import('eslint').Rule.Node) => void)}\n       */\n      function (node) {\n        old(node);\n        value(node);\n      } :\n      value;\n  }\n\n  return properties;\n};\n\nconst tagsWithNamesAndDescriptions = new Set([\n  'arg', 'argument', 'param', 'prop', 'property',\n  'return',\n\n  // These two are parsed by our custom parser as though having a `name`\n  'returns', 'template',\n]);\n\n/**\n * @typedef {{\n *   [key: string]: false|string|\n *     {message: string, replacement?: string}\n * }} TagNamePreference\n */\n\n/**\n * @param {import('eslint').Rule.RuleContext} context\n * @param {ParserMode|undefined} mode\n * @param {import('comment-parser').Spec[]} tags\n * @returns {{\n *   tagsWithNames: import('comment-parser').Spec[],\n *   tagsWithoutNames: import('comment-parser').Spec[]\n * }}\n */\nconst getTagsByType = (context, mode, tags) => {\n  /**\n   * @type {import('comment-parser').Spec[]}\n   */\n  const tagsWithoutNames = [];\n  const tagsWithNames = tags.filter((tag) => {\n    const {\n      tag: tagName,\n    } = tag;\n    const tagWithName = tagsWithNamesAndDescriptions.has(tagName);\n    if (!tagWithName) {\n      tagsWithoutNames.push(tag);\n    }\n\n    return tagWithName;\n  });\n\n  return {\n    tagsWithNames,\n    tagsWithoutNames,\n  };\n};\n\n/**\n * @param {import('eslint').SourceCode|{\n *   text: string\n * }} sourceCode\n * @returns {string}\n */\nconst getIndent = (sourceCode) => {\n  return (sourceCode.text.match(/^\\n*([ \\t]+)/v)?.[1] ?? '') + ' ';\n};\n\n/**\n * @param {import('eslint').Rule.Node|null} node\n * @returns {boolean}\n */\nconst isConstructor = (node) => {\n  return node?.type === 'MethodDefinition' && node.kind === 'constructor' ||\n  /** @type {import('@typescript-eslint/types').TSESTree.MethodDefinition} */ (\n    node?.parent\n  )?.kind === 'constructor';\n};\n\n/**\n * @param {import('eslint').Rule.Node|null} node\n * @returns {boolean}\n */\nconst isGetter = (node) => {\n  return node !== null &&\n  /**\n   * @type {import('@typescript-eslint/types').TSESTree.MethodDefinition|\n   *   import('@typescript-eslint/types').TSESTree.Property}\n   */ (\n    node.parent\n  )?.kind === 'get';\n};\n\n/**\n * @param {import('eslint').Rule.Node|null} node\n * @returns {boolean}\n */\nconst isSetter = (node) => {\n  return node !== null &&\n  /**\n   * @type {import('@typescript-eslint/types').TSESTree.MethodDefinition|\n   *   import('@typescript-eslint/types').TSESTree.Property}\n   */(\n    node.parent\n  )?.kind === 'set';\n};\n\n/**\n * @param {import('eslint').Rule.Node} node\n * @returns {boolean}\n */\nconst hasAccessorPair = (node) => {\n  const {\n    key,\n    kind: sourceKind,\n    type,\n  } =\n    /**\n     * @type {import('@typescript-eslint/types').TSESTree.MethodDefinition|\n     *   import('@typescript-eslint/types').TSESTree.Property}\n     */ (node);\n\n  const sourceName =\n    /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n      key\n    ).name;\n\n  const oppositeKind = sourceKind === 'get' ? 'set' : 'get';\n\n  const sibling = type === 'MethodDefinition' ?\n    /** @type {import('@typescript-eslint/types').TSESTree.ClassBody} */ (\n      node.parent\n    ).body :\n    /** @type {import('@typescript-eslint/types').TSESTree.ObjectExpression} */ (\n      node.parent\n    ).properties;\n\n  return (\n    sibling.some((child) => {\n      const {\n        key: ky,\n        kind,\n      } = /**\n           * @type {import('@typescript-eslint/types').TSESTree.MethodDefinition|\n           *   import('@typescript-eslint/types').TSESTree.Property}\n           */ (child);\n\n      const name =\n        /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n          ky\n        ).name;\n\n      return kind === oppositeKind && name === sourceName;\n    })\n  );\n};\n\n/**\n * @param {import('./iterateJsdoc.js').JsdocBlockWithInline} jsdoc\n * @param {import('eslint').Rule.Node|null} node\n * @param {import('eslint').Rule.RuleContext} context\n * @param {import('json-schema').JSONSchema4} schema\n * @returns {boolean}\n */\nconst exemptSpeciaMethods = (jsdoc, node, context, schema) => {\n  /**\n   * @param {\"checkGetters\"|\"checkSetters\"|\"checkConstructors\"} prop\n   * @returns {boolean|\"no-setter\"|\"no-getter\"}\n   */\n  const hasSchemaOption = (prop) => {\n    const schemaProperties = schema[0].properties;\n\n    return context.options[0]?.[prop] ??\n      (schemaProperties[prop] && schemaProperties[prop].default);\n  };\n\n  const checkGetters = hasSchemaOption('checkGetters');\n  const checkSetters = hasSchemaOption('checkSetters');\n\n  return !hasSchemaOption('checkConstructors') &&\n    (\n      isConstructor(node) ||\n      hasATag(jsdoc, [\n        'class',\n        'constructor',\n      ])) ||\n  isGetter(node) && (\n    !checkGetters ||\n    checkGetters === 'no-setter' && hasAccessorPair(/** @type {import('./iterateJsdoc.js').Node} */ (node).parent)\n  ) ||\n  isSetter(node) && (\n    !checkSetters ||\n    checkSetters === 'no-getter' && hasAccessorPair(/** @type {import('./iterateJsdoc.js').Node} */ (node).parent)\n  );\n};\n\n/**\n * Since path segments may be unquoted (if matching a reserved word,\n * identifier or numeric literal) or single or double quoted, in either\n * the `@param` or in source, we need to strip the quotes to give a fair\n * comparison.\n * @param {string} str\n * @returns {string}\n */\nconst dropPathSegmentQuotes = (str) => {\n  return str.replaceAll(/\\.(['\"])(.*)\\1/gv, '.$2');\n};\n\n/**\n * @param {string} name\n * @returns {(otherPathName: string) => boolean}\n */\nconst comparePaths = (name) => {\n  return (otherPathName) => {\n    return otherPathName === name ||\n      dropPathSegmentQuotes(otherPathName) === dropPathSegmentQuotes(name);\n  };\n};\n\n/**\n * @callback PathDoesNotBeginWith\n * @param {string} name\n * @param {string} otherPathName\n * @returns {boolean}\n */\n\n/** @type {PathDoesNotBeginWith} */\nconst pathDoesNotBeginWith = (name, otherPathName) => {\n  return !name.startsWith(otherPathName) &&\n    !dropPathSegmentQuotes(name).startsWith(dropPathSegmentQuotes(otherPathName));\n};\n\n/**\n * @param {string} regexString\n * @param {string} [requiredFlags]\n * @returns {RegExp}\n */\nconst getRegexFromString = (regexString, requiredFlags) => {\n  const match = regexString.match(/^\\/(.*)\\/([gimyvus]*)$/vs);\n  let flags = 'v';\n  let regex = regexString;\n  if (match) {\n    [\n      , regex,\n      flags,\n    ] = match;\n    if (!flags) {\n      flags = 'v';\n    }\n  }\n\n  const uniqueFlags = [\n    ...new Set(flags + (requiredFlags || '')),\n  ];\n  flags = uniqueFlags.join('');\n\n  return new RegExp(regex, flags);\n};\n\nexport {\n  comparePaths,\n  dropPathSegmentQuotes,\n  enforcedContexts,\n  exemptSpeciaMethods,\n  filterTags,\n  flattenRoots,\n  forEachPreferredTag,\n  getAllTags,\n  getContextObject,\n  getFunctionParameterNames,\n  getIndent,\n  getJsdocTagsDeep,\n  getPreferredTagName,\n  getPreferredTagNameSimple,\n  getRegexFromString,\n  getTagDescription,\n  getTags,\n  getTagsByType,\n  getTagStructureForMode,\n  hasATag,\n  hasParams,\n\n  hasTag,\n  hasThrowValue,\n\n  hasYieldValue,\n  isConstructor,\n  isGetter,\n  isNamepathDefiningTag,\n  isNamepathOrUrlReferencingTag,\n  isNamepathReferencingTag,\n  isSetter,\n  isValidTag,\n  mayBeUndefinedTypeTag,\n  overrideTagStructure,\n  parseClosureTemplateTag,\n  pathDoesNotBeginWith,\n  setTagStructure,\n  tagMightHaveEitherTypeOrNamePosition,\n  tagMightHaveNamepath,\n  tagMightHaveNamePosition,\n  tagMightHaveTypePosition,\n  tagMissingRequiredTypeOrNamepath,\n  tagMustHaveNamePosition,\n  tagMustHaveTypePosition,\n};\nexport {\n  hasReturnValue,\n  hasValueOrExecutorHasNonEmptyResolveValue,\n} from './utils/hasReturnValue.js';\n"],"mappings":"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"}

package/dist/plugin.cjs

@@ -0,0 +1,427 @@
+const require_getJsdocProcessorPlugin = require('./getJsdocProcessorPlugin.cjs');
+const require_checkAccess = require('./rules/checkAccess.cjs');
+const require_checkAlignment = require('./rules/checkAlignment.cjs');
+const require_checkExamples = require('./rules/checkExamples.cjs');
+const require_checkIndentation = require('./rules/checkIndentation.cjs');
+const require_checkLineAlignment = require('./rules/checkLineAlignment.cjs');
+const require_checkParamNames = require('./rules/checkParamNames.cjs');
+const require_checkPropertyNames = require('./rules/checkPropertyNames.cjs');
+const require_checkSyntax = require('./rules/checkSyntax.cjs');
+const require_checkTagNames = require('./rules/checkTagNames.cjs');
+const require_checkTemplateNames = require('./rules/checkTemplateNames.cjs');
+const require_checkTypes = require('./rules/checkTypes.cjs');
+const require_checkValues = require('./rules/checkValues.cjs');
+const require_convertToJsdocComments = require('./rules/convertToJsdocComments.cjs');
+const require_emptyTags = require('./rules/emptyTags.cjs');
+const require_implementsOnClasses = require('./rules/implementsOnClasses.cjs');
+const require_importsAsDependencies = require('./rules/importsAsDependencies.cjs');
+const require_informativeDocs = require('./rules/informativeDocs.cjs');
+const require_linesBeforeBlock = require('./rules/linesBeforeBlock.cjs');
+const require_matchDescription = require('./rules/matchDescription.cjs');
+const require_matchName = require('./rules/matchName.cjs');
+const require_multilineBlocks = require('./rules/multilineBlocks.cjs');
+const require_noBadBlocks = require('./rules/noBadBlocks.cjs');
+const require_noBlankBlockDescriptions = require('./rules/noBlankBlockDescriptions.cjs');
+const require_noBlankBlocks = require('./rules/noBlankBlocks.cjs');
+const require_noDefaults = require('./rules/noDefaults.cjs');
+const require_noMissingSyntax = require('./rules/noMissingSyntax.cjs');
+const require_noMultiAsterisks = require('./rules/noMultiAsterisks.cjs');
+const require_noRestrictedSyntax = require('./rules/noRestrictedSyntax.cjs');
+const require_noTypes = require('./rules/noTypes.cjs');
+const require_noUndefinedTypes = require('./rules/noUndefinedTypes.cjs');
+const require_requireAsteriskPrefix = require('./rules/requireAsteriskPrefix.cjs');
+const require_requireDescription = require('./rules/requireDescription.cjs');
+const require_requireDescriptionCompleteSentence = require('./rules/requireDescriptionCompleteSentence.cjs');
+const require_requireExample = require('./rules/requireExample.cjs');
+const require_requireFileOverview = require('./rules/requireFileOverview.cjs');
+const require_requireHyphenBeforeParamDescription = require('./rules/requireHyphenBeforeParamDescription.cjs');
+const require_requireJsdoc = require('./rules/requireJsdoc.cjs');
+const require_requireParam = require('./rules/requireParam.cjs');
+const require_requireParamDescription = require('./rules/requireParamDescription.cjs');
+const require_requireParamName = require('./rules/requireParamName.cjs');
+const require_requireParamType = require('./rules/requireParamType.cjs');
+const require_requireProperty = require('./rules/requireProperty.cjs');
+const require_requirePropertyDescription = require('./rules/requirePropertyDescription.cjs');
+const require_requirePropertyName = require('./rules/requirePropertyName.cjs');
+const require_requirePropertyType = require('./rules/requirePropertyType.cjs');
+const require_requireReturns = require('./rules/requireReturns.cjs');
+const require_requireReturnsCheck = require('./rules/requireReturnsCheck.cjs');
+const require_requireReturnsDescription = require('./rules/requireReturnsDescription.cjs');
+const require_requireReturnsType = require('./rules/requireReturnsType.cjs');
+const require_requireTemplate = require('./rules/requireTemplate.cjs');
+const require_requireThrows = require('./rules/requireThrows.cjs');
+const require_requireYields = require('./rules/requireYields.cjs');
+const require_requireYieldsCheck = require('./rules/requireYieldsCheck.cjs');
+const require_sortTags = require('./rules/sortTags.cjs');
+const require_tagLines = require('./rules/tagLines.cjs');
+const require_textEscaping = require('./rules/textEscaping.cjs');
+const require_validTypes = require('./rules/validTypes.cjs');
+
+//#region src/plugin.js
+/**
+* @typedef {"recommended" | "stylistic" | "contents" | "logical" | "requirements"} ConfigGroups
+* @typedef {"" | "-typescript" | "-typescript-flavor"} ConfigVariants
+* @typedef {"" | "-error"} ErrorLevelVariants
+*/
+/**
+* @type {import('eslint').ESLint.Plugin & {
+*   configs: Record<`flat/${ConfigGroups}${ConfigVariants}${ErrorLevelVariants}`,
+*   import('eslint').Linter.Config>
+* }}
+*/
+const plugin = {
+	configs: {},
+	rules: {
+		"check-access": require_checkAccess.default,
+		"check-alignment": require_checkAlignment.default,
+		"check-examples": require_checkExamples.default,
+		"check-indentation": require_checkIndentation.default,
+		"check-line-alignment": require_checkLineAlignment.default,
+		"check-param-names": require_checkParamNames.default,
+		"check-property-names": require_checkPropertyNames.default,
+		"check-syntax": require_checkSyntax.default,
+		"check-tag-names": require_checkTagNames.default,
+		"check-template-names": require_checkTemplateNames.default,
+		"check-types": require_checkTypes.default,
+		"check-values": require_checkValues.default,
+		"convert-to-jsdoc-comments": require_convertToJsdocComments.default,
+		"empty-tags": require_emptyTags.default,
+		"implements-on-classes": require_implementsOnClasses.default,
+		"imports-as-dependencies": require_importsAsDependencies.default,
+		"informative-docs": require_informativeDocs.default,
+		"lines-before-block": require_linesBeforeBlock.default,
+		"match-description": require_matchDescription.default,
+		"match-name": require_matchName.default,
+		"multiline-blocks": require_multilineBlocks.default,
+		"no-bad-blocks": require_noBadBlocks.default,
+		"no-blank-block-descriptions": require_noBlankBlockDescriptions.default,
+		"no-blank-blocks": require_noBlankBlocks.default,
+		"no-defaults": require_noDefaults.default,
+		"no-missing-syntax": require_noMissingSyntax.default,
+		"no-multi-asterisks": require_noMultiAsterisks.default,
+		"no-restricted-syntax": require_noRestrictedSyntax.default,
+		"no-types": require_noTypes.default,
+		"no-undefined-types": require_noUndefinedTypes.default,
+		"require-asterisk-prefix": require_requireAsteriskPrefix.default,
+		"require-description": require_requireDescription.default,
+		"require-description-complete-sentence": require_requireDescriptionCompleteSentence.default,
+		"require-example": require_requireExample.default,
+		"require-file-overview": require_requireFileOverview.default,
+		"require-hyphen-before-param-description": require_requireHyphenBeforeParamDescription.default,
+		"require-jsdoc": require_requireJsdoc.default,
+		"require-param": require_requireParam.default,
+		"require-param-description": require_requireParamDescription.default,
+		"require-param-name": require_requireParamName.default,
+		"require-param-type": require_requireParamType.default,
+		"require-property": require_requireProperty.default,
+		"require-property-description": require_requirePropertyDescription.default,
+		"require-property-name": require_requirePropertyName.default,
+		"require-property-type": require_requirePropertyType.default,
+		"require-returns": require_requireReturns.default,
+		"require-returns-check": require_requireReturnsCheck.default,
+		"require-returns-description": require_requireReturnsDescription.default,
+		"require-returns-type": require_requireReturnsType.default,
+		"require-template": require_requireTemplate.default,
+		"require-throws": require_requireThrows.default,
+		"require-yields": require_requireYields.default,
+		"require-yields-check": require_requireYieldsCheck.default,
+		"sort-tags": require_sortTags.default,
+		"tag-lines": require_tagLines.default,
+		"text-escaping": require_textEscaping.default,
+		"valid-types": require_validTypes.default
+	}
+};
+/**
+* @param {"warn"|"error"} warnOrError
+* @param {string} [flatName]
+* @returns {import('eslint').Linter.FlatConfig}
+*/
+const createRecommendedRuleset = (warnOrError, flatName) => {
+	return {
+		...flatName ? { name: "jsdoc/" + flatName } : {},
+		plugins: flatName ? { jsdoc: plugin } : ["jsdoc"],
+		rules: {
+			"jsdoc/check-access": warnOrError,
+			"jsdoc/check-alignment": warnOrError,
+			"jsdoc/check-examples": "off",
+			"jsdoc/check-indentation": "off",
+			"jsdoc/check-line-alignment": "off",
+			"jsdoc/check-param-names": warnOrError,
+			"jsdoc/check-property-names": warnOrError,
+			"jsdoc/check-syntax": "off",
+			"jsdoc/check-tag-names": warnOrError,
+			"jsdoc/check-template-names": "off",
+			"jsdoc/check-types": warnOrError,
+			"jsdoc/check-values": warnOrError,
+			"jsdoc/convert-to-jsdoc-comments": "off",
+			"jsdoc/empty-tags": warnOrError,
+			"jsdoc/implements-on-classes": warnOrError,
+			"jsdoc/imports-as-dependencies": "off",
+			"jsdoc/informative-docs": "off",
+			"jsdoc/lines-before-block": "off",
+			"jsdoc/match-description": "off",
+			"jsdoc/match-name": "off",
+			"jsdoc/multiline-blocks": warnOrError,
+			"jsdoc/no-bad-blocks": "off",
+			"jsdoc/no-blank-block-descriptions": "off",
+			"jsdoc/no-blank-blocks": "off",
+			"jsdoc/no-defaults": warnOrError,
+			"jsdoc/no-missing-syntax": "off",
+			"jsdoc/no-multi-asterisks": warnOrError,
+			"jsdoc/no-restricted-syntax": "off",
+			"jsdoc/no-types": "off",
+			"jsdoc/no-undefined-types": warnOrError,
+			"jsdoc/require-asterisk-prefix": "off",
+			"jsdoc/require-description": "off",
+			"jsdoc/require-description-complete-sentence": "off",
+			"jsdoc/require-example": "off",
+			"jsdoc/require-file-overview": "off",
+			"jsdoc/require-hyphen-before-param-description": "off",
+			"jsdoc/require-jsdoc": warnOrError,
+			"jsdoc/require-param": warnOrError,
+			"jsdoc/require-param-description": warnOrError,
+			"jsdoc/require-param-name": warnOrError,
+			"jsdoc/require-param-type": warnOrError,
+			"jsdoc/require-property": warnOrError,
+			"jsdoc/require-property-description": warnOrError,
+			"jsdoc/require-property-name": warnOrError,
+			"jsdoc/require-property-type": warnOrError,
+			"jsdoc/require-returns": warnOrError,
+			"jsdoc/require-returns-check": warnOrError,
+			"jsdoc/require-returns-description": warnOrError,
+			"jsdoc/require-returns-type": warnOrError,
+			"jsdoc/require-template": "off",
+			"jsdoc/require-throws": "off",
+			"jsdoc/require-yields": warnOrError,
+			"jsdoc/require-yields-check": warnOrError,
+			"jsdoc/sort-tags": "off",
+			"jsdoc/tag-lines": warnOrError,
+			"jsdoc/text-escaping": "off",
+			"jsdoc/valid-types": warnOrError
+		}
+	};
+};
+/**
+* @param {"warn"|"error"} warnOrError
+* @param {string} [flatName]
+* @returns {import('eslint').Linter.FlatConfig}
+*/
+const createRecommendedTypeScriptRuleset = (warnOrError, flatName) => {
+	const ruleset = createRecommendedRuleset(warnOrError, flatName);
+	return {
+		...ruleset,
+		rules: {
+			...ruleset.rules,
+			"jsdoc/check-tag-names": [warnOrError, { typed: true }],
+			"jsdoc/no-types": warnOrError,
+			"jsdoc/no-undefined-types": "off",
+			"jsdoc/require-param-type": "off",
+			"jsdoc/require-property-type": "off",
+			"jsdoc/require-returns-type": "off"
+		}
+	};
+};
+/**
+* @param {"warn"|"error"} warnOrError
+* @param {string} [flatName]
+* @returns {import('eslint').Linter.FlatConfig}
+*/
+const createRecommendedTypeScriptFlavorRuleset = (warnOrError, flatName) => {
+	const ruleset = createRecommendedRuleset(warnOrError, flatName);
+	return {
+		...ruleset,
+		rules: {
+			...ruleset.rules,
+			"jsdoc/no-undefined-types": "off"
+		}
+	};
+};
+/**
+* @param {(string | unknown[])[]} ruleNames
+*/
+const createStandaloneRulesetFactory = (ruleNames) => {
+	/**
+	* @param {"warn"|"error"} warnOrError
+	* @param {string} [flatName]
+	* @returns {import('eslint').Linter.FlatConfig}
+	*/
+	return (warnOrError, flatName) => {
+		return {
+			name: "jsdoc/" + flatName,
+			plugins: { jsdoc: plugin },
+			rules: Object.fromEntries(ruleNames.map((ruleName) => {
+				return typeof ruleName === "string" ? [ruleName, warnOrError] : [ruleName[0], [warnOrError, ...ruleName.slice(1)]];
+			}))
+		};
+	};
+};
+const contentsRules = [
+	"jsdoc/informative-docs",
+	"jsdoc/match-description",
+	"jsdoc/no-blank-block-descriptions",
+	"jsdoc/no-blank-blocks",
+	["jsdoc/text-escaping", { escapeHTML: true }]
+];
+const createContentsTypescriptRuleset = createStandaloneRulesetFactory(contentsRules);
+const createContentsTypescriptFlavorRuleset = createStandaloneRulesetFactory(contentsRules);
+const logicalRules = [
+	"jsdoc/check-access",
+	"jsdoc/check-param-names",
+	"jsdoc/check-property-names",
+	"jsdoc/check-syntax",
+	"jsdoc/check-tag-names",
+	"jsdoc/check-template-names",
+	"jsdoc/check-types",
+	"jsdoc/check-values",
+	"jsdoc/empty-tags",
+	"jsdoc/implements-on-classes",
+	"jsdoc/require-returns-check",
+	"jsdoc/require-yields-check",
+	"jsdoc/no-bad-blocks",
+	"jsdoc/no-defaults",
+	"jsdoc/no-types",
+	"jsdoc/no-undefined-types",
+	"jsdoc/valid-types"
+];
+const createLogicalTypescriptRuleset = createStandaloneRulesetFactory(logicalRules);
+const createLogicalTypescriptFlavorRuleset = createStandaloneRulesetFactory(logicalRules);
+const requirementsRules = [
+	"jsdoc/require-example",
+	"jsdoc/require-jsdoc",
+	"jsdoc/require-param",
+	"jsdoc/require-param-description",
+	"jsdoc/require-param-name",
+	"jsdoc/require-property",
+	"jsdoc/require-property-description",
+	"jsdoc/require-property-name",
+	"jsdoc/require-returns",
+	"jsdoc/require-returns-description",
+	"jsdoc/require-yields"
+];
+const createRequirementsTypeScriptRuleset = createStandaloneRulesetFactory(requirementsRules);
+const createRequirementsTypeScriptFlavorRuleset = createStandaloneRulesetFactory([
+	...requirementsRules,
+	"jsdoc/require-param-type",
+	"jsdoc/require-property-type",
+	"jsdoc/require-returns-type",
+	"jsdoc/require-template"
+]);
+const stylisticRules = [
+	"jsdoc/check-alignment",
+	"jsdoc/check-line-alignment",
+	"jsdoc/lines-before-block",
+	"jsdoc/multiline-blocks",
+	"jsdoc/no-multi-asterisks",
+	"jsdoc/require-asterisk-prefix",
+	["jsdoc/require-hyphen-before-param-description", "never"],
+	"jsdoc/tag-lines"
+];
+const createStylisticTypeScriptRuleset = createStandaloneRulesetFactory(stylisticRules);
+const createStylisticTypeScriptFlavorRuleset = createStandaloneRulesetFactory(stylisticRules);
+/* c8 ignore next 3 -- TS */
+if (!plugin.configs) throw new Error("TypeScript guard");
+plugin.configs.recommended = createRecommendedRuleset("warn");
+plugin.configs["recommended-error"] = createRecommendedRuleset("error");
+plugin.configs["recommended-typescript"] = createRecommendedTypeScriptRuleset("warn");
+plugin.configs["recommended-typescript-error"] = createRecommendedTypeScriptRuleset("error");
+plugin.configs["recommended-typescript-flavor"] = createRecommendedTypeScriptFlavorRuleset("warn");
+plugin.configs["recommended-typescript-flavor-error"] = createRecommendedTypeScriptFlavorRuleset("error");
+plugin.configs["flat/recommended"] = createRecommendedRuleset("warn", "flat/recommended");
+plugin.configs["flat/recommended-error"] = createRecommendedRuleset("error", "flat/recommended-error");
+plugin.configs["flat/recommended-typescript"] = createRecommendedTypeScriptRuleset("warn", "flat/recommended-typescript");
+plugin.configs["flat/recommended-typescript-error"] = createRecommendedTypeScriptRuleset("error", "flat/recommended-typescript-error");
+plugin.configs["flat/recommended-typescript-flavor"] = createRecommendedTypeScriptFlavorRuleset("warn", "flat/recommended-typescript-flavor");
+plugin.configs["flat/recommended-typescript-flavor-error"] = createRecommendedTypeScriptFlavorRuleset("error", "flat/recommended-typescript-flavor-error");
+plugin.configs["flat/contents-typescript"] = createContentsTypescriptRuleset("warn", "flat/contents-typescript");
+plugin.configs["flat/contents-typescript-error"] = createContentsTypescriptRuleset("error", "flat/contents-typescript-error");
+plugin.configs["flat/contents-typescript-flavor"] = createContentsTypescriptFlavorRuleset("warn", "flat/contents-typescript-flavor");
+plugin.configs["flat/contents-typescript-flavor-error"] = createContentsTypescriptFlavorRuleset("error", "flat/contents-typescript-error-flavor");
+plugin.configs["flat/logical-typescript"] = createLogicalTypescriptRuleset("warn", "flat/logical-typescript");
+plugin.configs["flat/logical-typescript-error"] = createLogicalTypescriptRuleset("error", "flat/logical-typescript-error");
+plugin.configs["flat/logical-typescript-flavor"] = createLogicalTypescriptFlavorRuleset("warn", "flat/logical-typescript-flavor");
+plugin.configs["flat/logical-typescript-flavor-error"] = createLogicalTypescriptFlavorRuleset("error", "flat/logical-typescript-error-flavor");
+plugin.configs["flat/requirements-typescript"] = createRequirementsTypeScriptRuleset("warn", "flat/requirements-typescript");
+plugin.configs["flat/requirements-typescript-error"] = createRequirementsTypeScriptRuleset("error", "flat/requirements-typescript-error");
+plugin.configs["flat/requirements-typescript-flavor"] = createRequirementsTypeScriptFlavorRuleset("warn", "flat/requirements-typescript-flavor");
+plugin.configs["flat/requirements-typescript-flavor-error"] = createRequirementsTypeScriptFlavorRuleset("error", "flat/requirements-typescript-error-flavor");
+plugin.configs["flat/stylistic-typescript"] = createStylisticTypeScriptRuleset("warn", "flat/stylistic-typescript");
+plugin.configs["flat/stylistic-typescript-error"] = createStylisticTypeScriptRuleset("error", "flat/stylistic-typescript-error");
+plugin.configs["flat/stylistic-typescript-flavor"] = createStylisticTypeScriptFlavorRuleset("warn", "flat/stylistic-typescript-flavor");
+plugin.configs["flat/stylistic-typescript-flavor-error"] = createStylisticTypeScriptFlavorRuleset("error", "flat/stylistic-typescript-error-flavor");
+plugin.configs.examples = [{
+	files: ["**/*.js"],
+	name: "jsdoc/examples/processor",
+	plugins: { examples: require_getJsdocProcessorPlugin.getJsdocProcessorPlugin() },
+	processor: "examples/examples"
+}, {
+	files: ["**/*.md/*.js"],
+	name: "jsdoc/examples/rules",
+	rules: {
+		"eol-last": 0,
+		"import/no-unresolved": 0,
+		"import/unambiguous": 0,
+		"jsdoc/require-file-overview": 0,
+		"jsdoc/require-jsdoc": 0,
+		"no-console": 0,
+		"no-multiple-empty-lines": 0,
+		"no-undef": 0,
+		"no-unused-vars": 0,
+		"node/no-missing-import": 0,
+		"node/no-missing-require": 0,
+		"padded-blocks": 0
+	}
+}];
+plugin.configs["default-expressions"] = [{
+	files: ["**/*.js"],
+	name: "jsdoc/default-expressions/processor",
+	plugins: { examples: require_getJsdocProcessorPlugin.getJsdocProcessorPlugin({
+		checkDefaults: true,
+		checkParams: true,
+		checkProperties: true
+	}) },
+	processor: "examples/examples"
+}, {
+	files: [
+		"**/*.jsdoc-defaults",
+		"**/*.jsdoc-params",
+		"**/*.jsdoc-properties"
+	],
+	name: "jsdoc/default-expressions/rules",
+	rules: {
+		...plugin.configs.examples[1].rules,
+		"chai-friendly/no-unused-expressions": 0,
+		"no-empty-function": 0,
+		"no-new": 0,
+		"no-unused-expressions": 0,
+		quotes: ["error", "double"],
+		semi: ["error", "never"],
+		strict: 0
+	}
+}];
+plugin.configs["examples-and-default-expressions"] = [
+	{
+		name: "jsdoc/examples-and-default-expressions",
+		plugins: { examples: require_getJsdocProcessorPlugin.getJsdocProcessorPlugin({
+			checkDefaults: true,
+			checkParams: true,
+			checkProperties: true
+		}) }
+	},
+	...plugin.configs.examples.map((config) => {
+		return {
+			...config,
+			plugins: {}
+		};
+	}),
+	...plugin.configs["default-expressions"].map((config) => {
+		return {
+			...config,
+			plugins: {}
+		};
+	})
+];
+var plugin_default = plugin;
+
+//#endregion
+exports.default = plugin_default;
+//# sourceMappingURL=plugin.cjs.map