eslint-plugin-jsdoc 63.0.0 → 63.0.1

package/dist/rules/requireReturnsDescription.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"requireReturnsDescription.cjs","names":["_iterateJsdoc","_interopRequireDefault","require","e","__esModule","default","_default","exports","iterateJsdoc","report","utils","forEachPreferredTag","jsdocTag","targetTagName","type","trim","includes","description","contextDefaults","meta","docs","url","schema","additionalProperties","properties","contexts","items","anyOf","comment","context","module"],"sources":["../../src/rules/requireReturnsDescription.js"],"sourcesContent":["import iterateJsdoc from '../iterateJsdoc.js';\n\nexport default iterateJsdoc(({\n  report,\n  utils,\n}) => {\n  utils.forEachPreferredTag('returns', (jsdocTag, targetTagName) => {\n    const type = jsdocTag.type && jsdocTag.type.trim();\n\n    if ([\n      'Promise<undefined>', 'Promise<void>', 'undefined', 'void',\n    ].includes(type)) {\n      return;\n    }\n\n    if (!jsdocTag.description.trim()) {\n      report(`Missing JSDoc @${targetTagName} description.`, null, jsdocTag);\n    }\n  });\n}, {\n  contextDefaults: true,\n  meta: {\n    docs: {\n      description: 'Requires that the `@returns` tag has a `description` value (not including `void`/`undefined` type returns).',\n      url: 'https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/require-returns-description.md#repos-sticky-header',\n    },\n    schema: [\n      {\n        additionalProperties: false,\n        properties: {\n          contexts: {\n            description: `Set this to an array of strings representing the AST context (or an object with\noptional \\`context\\` and \\`comment\\` properties) where you wish the rule to be applied.\n\n\\`context\\` defaults to \\`any\\` and \\`comment\\` defaults to no specific comment context.\n\nOverrides the default contexts (\\`ArrowFunctionExpression\\`, \\`FunctionDeclaration\\`,\n\\`FunctionExpression\\`). Set to \\`\"any\"\\` if you want\nthe rule to apply to any JSDoc block throughout your files (as is necessary\nfor finding function blocks not attached to a function declaration or\nexpression, i.e., \\`@callback\\` or \\`@function\\` (or its aliases \\`@func\\` or\n\\`@method\\`) (including those associated with an \\`@interface\\`).\n\nSee the [\"AST and Selectors\"](../#advanced-ast-and-selectors)\nsection of our Advanced docs for more on the expected format.`,\n            items: {\n              anyOf: [\n                {\n                  type: 'string',\n                },\n                {\n                  additionalProperties: false,\n                  properties: {\n                    comment: {\n                      type: 'string',\n                    },\n                    context: {\n                      type: 'string',\n                    },\n                  },\n                  type: 'object',\n                },\n              ],\n            },\n            type: 'array',\n          },\n        },\n        type: 'object',\n      },\n    ],\n    type: 'suggestion',\n  },\n});\n"],"mappings":";;;;;;AAAA,IAAAA,aAAA,GAAAC,sBAAA,CAAAC,OAAA;AAA8C,SAAAD,uBAAAE,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAAA,IAAAG,QAAA,GAAAC,OAAA,CAAAF,OAAA,GAE/B,IAAAG,qBAAY,EAAC,CAAC;EAC3BC,MAAM;EACNC;AACF,CAAC,KAAK;EACJA,KAAK,CAACC,mBAAmB,CAAC,SAAS,EAAE,CAACC,QAAQ,EAAEC,aAAa,KAAK;IAChE,MAAMC,IAAI,GAAGF,QAAQ,CAACE,IAAI,IAAIF,QAAQ,CAACE,IAAI,CAACC,IAAI,CAAC,CAAC;IAElD,IAAI,CACF,oBAAoB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,CAC3D,CAACC,QAAQ,CAACF,IAAI,CAAC,EAAE;MAChB;IACF;IAEA,IAAI,CAACF,QAAQ,CAACK,WAAW,CAACF,IAAI,CAAC,CAAC,EAAE;MAChCN,MAAM,CAAC,kBAAkBI,aAAa,eAAe,EAAE,IAAI,EAAED,QAAQ,CAAC;IACxE;EACF,CAAC,CAAC;AACJ,CAAC,EAAE;EACDM,eAAe,EAAE,IAAI;EACrBC,IAAI,EAAE;IACJC,IAAI,EAAE;MACJH,WAAW,EAAE,6GAA6G;MAC1HI,GAAG,EAAE;IACP,CAAC;IACDC,MAAM,EAAE,CACN;MACEC,oBAAoB,EAAE,KAAK;MAC3BC,UAAU,EAAE;QACVC,QAAQ,EAAE;UACRR,WAAW,EAAE;AACzB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,8DAA8D;UAClDS,KAAK,EAAE;YACLC,KAAK,EAAE,CACL;cACEb,IAAI,EAAE;YACR,CAAC,EACD;cACES,oBAAoB,EAAE,KAAK;cAC3BC,UAAU,EAAE;gBACVI,OAAO,EAAE;kBACPd,IAAI,EAAE;gBACR,CAAC;gBACDe,OAAO,EAAE;kBACPf,IAAI,EAAE;gBACR;cACF,CAAC;cACDA,IAAI,EAAE;YACR,CAAC;UAEL,CAAC;UACDA,IAAI,EAAE;QACR;MACF,CAAC;MACDA,IAAI,EAAE;IACR,CAAC,CACF;IACDA,IAAI,EAAE;EACR;AACF,CAAC,CAAC;AAAAgB,MAAA,CAAAvB,OAAA,GAAAA,OAAA,CAAAF,OAAA","ignoreList":[]}
+{"version":3,"file":"requireReturnsDescription.cjs","names":["_iterateJsdoc","_interopRequireDefault","require","e","__esModule","default","_default","exports","iterateJsdoc","report","utils","forEachPreferredTag","jsdocTag","targetTagName","type","trim","includes","description","contextDefaults","meta","docs","url","schema","additionalProperties","properties","contexts","items","anyOf","comment","context","module"],"sources":["../../src/rules/requireReturnsDescription.js"],"sourcesContent":["import iterateJsdoc from '../iterateJsdoc.js';\n\nexport default iterateJsdoc(({\n  report,\n  utils,\n}) => {\n  utils.forEachPreferredTag('returns', (jsdocTag, targetTagName) => {\n    const type = jsdocTag.type && jsdocTag.type.trim();\n\n    if ([\n      'Promise<undefined>', 'Promise<void>', 'undefined', 'void',\n    ].includes(type)) {\n      return;\n    }\n\n    if (!jsdocTag.description.trim()) {\n      report(`Missing JSDoc @${targetTagName} description.`, null, jsdocTag);\n    }\n  });\n}, {\n  contextDefaults: true,\n  meta: {\n    docs: {\n      description: 'Requires that the `@returns` tag has a `description` value (not including `void`/`undefined` type returns).',\n      url: 'https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/require-returns-description.md#repos-sticky-header',\n    },\n    schema: [\n      {\n        additionalProperties: false,\n        properties: {\n          contexts: {\n            description: `Set this to an array of strings representing the AST context (or an object with\noptional \\`context\\` and \\`comment\\` properties) where you wish the rule to be applied.\n\n\\`context\\` defaults to \\`any\\` and \\`comment\\` defaults to no specific comment context.\n\nOverrides the default contexts (\\`ArrowFunctionExpression\\`, \\`FunctionDeclaration\\`,\n\\`FunctionExpression\\`). Set to \\`\"any\"\\` if you want\nthe rule to apply to any JSDoc block throughout your files (as is necessary\nfor finding function blocks not attached to a function declaration or\nexpression, i.e., \\`@callback\\` or \\`@function\\` (or its aliases \\`@func\\` or\n\\`@method\\`) (including those associated with an \\`@interface\\`).\n\nSee the [\"AST and Selectors\"](../advanced.md#ast-and-selectors)\nsection of our Advanced docs for more on the expected format.`,\n            items: {\n              anyOf: [\n                {\n                  type: 'string',\n                },\n                {\n                  additionalProperties: false,\n                  properties: {\n                    comment: {\n                      type: 'string',\n                    },\n                    context: {\n                      type: 'string',\n                    },\n                  },\n                  type: 'object',\n                },\n              ],\n            },\n            type: 'array',\n          },\n        },\n        type: 'object',\n      },\n    ],\n    type: 'suggestion',\n  },\n});\n"],"mappings":";;;;;;AAAA,IAAAA,aAAA,GAAAC,sBAAA,CAAAC,OAAA;AAA8C,SAAAD,uBAAAE,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAAA,IAAAG,QAAA,GAAAC,OAAA,CAAAF,OAAA,GAE/B,IAAAG,qBAAY,EAAC,CAAC;EAC3BC,MAAM;EACNC;AACF,CAAC,KAAK;EACJA,KAAK,CAACC,mBAAmB,CAAC,SAAS,EAAE,CAACC,QAAQ,EAAEC,aAAa,KAAK;IAChE,MAAMC,IAAI,GAAGF,QAAQ,CAACE,IAAI,IAAIF,QAAQ,CAACE,IAAI,CAACC,IAAI,CAAC,CAAC;IAElD,IAAI,CACF,oBAAoB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,CAC3D,CAACC,QAAQ,CAACF,IAAI,CAAC,EAAE;MAChB;IACF;IAEA,IAAI,CAACF,QAAQ,CAACK,WAAW,CAACF,IAAI,CAAC,CAAC,EAAE;MAChCN,MAAM,CAAC,kBAAkBI,aAAa,eAAe,EAAE,IAAI,EAAED,QAAQ,CAAC;IACxE;EACF,CAAC,CAAC;AACJ,CAAC,EAAE;EACDM,eAAe,EAAE,IAAI;EACrBC,IAAI,EAAE;IACJC,IAAI,EAAE;MACJH,WAAW,EAAE,6GAA6G;MAC1HI,GAAG,EAAE;IACP,CAAC;IACDC,MAAM,EAAE,CACN;MACEC,oBAAoB,EAAE,KAAK;MAC3BC,UAAU,EAAE;QACVC,QAAQ,EAAE;UACRR,WAAW,EAAE;AACzB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,8DAA8D;UAClDS,KAAK,EAAE;YACLC,KAAK,EAAE,CACL;cACEb,IAAI,EAAE;YACR,CAAC,EACD;cACES,oBAAoB,EAAE,KAAK;cAC3BC,UAAU,EAAE;gBACVI,OAAO,EAAE;kBACPd,IAAI,EAAE;gBACR,CAAC;gBACDe,OAAO,EAAE;kBACPf,IAAI,EAAE;gBACR;cACF,CAAC;cACDA,IAAI,EAAE;YACR,CAAC;UAEL,CAAC;UACDA,IAAI,EAAE;QACR;MACF,CAAC;MACDA,IAAI,EAAE;IACR,CAAC,CACF;IACDA,IAAI,EAAE;EACR;AACF,CAAC,CAAC;AAAAgB,MAAA,CAAAvB,OAAA,GAAAA,OAAA,CAAAF,OAAA","ignoreList":[]}

package/dist/rules/requireReturnsType.cjs

@@ -38,7 +38,7 @@ for finding function blocks not attached to a function declaration or
 expression, i.e., \`@callback\` or \`@function\` (or its aliases \`@func\` or
 \`@method\`) (including those associated with an \`@interface\`).
 
-See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
 section of our Advanced docs for more on the expected format.`,
           items: {
             anyOf: [{

package/dist/rules/requireReturnsType.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"requireReturnsType.cjs","names":["_iterateJsdoc","_interopRequireDefault","require","e","__esModule","default","_default","exports","iterateJsdoc","report","utils","forEachPreferredTag","jsdocTag","targetTagName","type","contextDefaults","meta","docs","description","url","schema","additionalProperties","properties","contexts","items","anyOf","comment","context","module"],"sources":["../../src/rules/requireReturnsType.js"],"sourcesContent":["import iterateJsdoc from '../iterateJsdoc.js';\n\nexport default iterateJsdoc(({\n  report,\n  utils,\n}) => {\n  utils.forEachPreferredTag('returns', (jsdocTag, targetTagName) => {\n    if (!jsdocTag.type) {\n      report(`Missing JSDoc @${targetTagName} type.`, null, jsdocTag);\n    }\n  });\n}, {\n  contextDefaults: true,\n  meta: {\n    docs: {\n      description: 'Requires that `@returns` tag has type value (in curly brackets).',\n      url: 'https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/require-returns-type.md#repos-sticky-header',\n    },\n    schema: [\n      {\n        additionalProperties: false,\n        properties: {\n          contexts: {\n            description: `Set this to an array of strings representing the AST context (or an object with\noptional \\`context\\` and \\`comment\\` properties) where you wish the rule to be applied.\n\n\\`context\\` defaults to \\`any\\` and \\`comment\\` defaults to no specific comment context.\n\nOverrides the default contexts (\\`ArrowFunctionExpression\\`, \\`FunctionDeclaration\\`,\n\\`FunctionExpression\\`). Set to \\`\"any\"\\` if you want\nthe rule to apply to any JSDoc block throughout your files (as is necessary\nfor finding function blocks not attached to a function declaration or\nexpression, i.e., \\`@callback\\` or \\`@function\\` (or its aliases \\`@func\\` or\n\\`@method\\`) (including those associated with an \\`@interface\\`).\n\nSee the [\"AST and Selectors\"](../#advanced-ast-and-selectors)\nsection of our Advanced docs for more on the expected format.`,\n            items: {\n              anyOf: [\n                {\n                  type: 'string',\n                },\n                {\n                  additionalProperties: false,\n                  properties: {\n                    comment: {\n                      type: 'string',\n                    },\n                    context: {\n                      type: 'string',\n                    },\n                  },\n                  type: 'object',\n                },\n              ],\n            },\n            type: 'array',\n          },\n        },\n        type: 'object',\n      },\n    ],\n    type: 'suggestion',\n  },\n});\n"],"mappings":";;;;;;AAAA,IAAAA,aAAA,GAAAC,sBAAA,CAAAC,OAAA;AAA8C,SAAAD,uBAAAE,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAAA,IAAAG,QAAA,GAAAC,OAAA,CAAAF,OAAA,GAE/B,IAAAG,qBAAY,EAAC,CAAC;EAC3BC,MAAM;EACNC;AACF,CAAC,KAAK;EACJA,KAAK,CAACC,mBAAmB,CAAC,SAAS,EAAE,CAACC,QAAQ,EAAEC,aAAa,KAAK;IAChE,IAAI,CAACD,QAAQ,CAACE,IAAI,EAAE;MAClBL,MAAM,CAAC,kBAAkBI,aAAa,QAAQ,EAAE,IAAI,EAAED,QAAQ,CAAC;IACjE;EACF,CAAC,CAAC;AACJ,CAAC,EAAE;EACDG,eAAe,EAAE,IAAI;EACrBC,IAAI,EAAE;IACJC,IAAI,EAAE;MACJC,WAAW,EAAE,kEAAkE;MAC/EC,GAAG,EAAE;IACP,CAAC;IACDC,MAAM,EAAE,CACN;MACEC,oBAAoB,EAAE,KAAK;MAC3BC,UAAU,EAAE;QACVC,QAAQ,EAAE;UACRL,WAAW,EAAE;AACzB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,8DAA8D;UAClDM,KAAK,EAAE;YACLC,KAAK,EAAE,CACL;cACEX,IAAI,EAAE;YACR,CAAC,EACD;cACEO,oBAAoB,EAAE,KAAK;cAC3BC,UAAU,EAAE;gBACVI,OAAO,EAAE;kBACPZ,IAAI,EAAE;gBACR,CAAC;gBACDa,OAAO,EAAE;kBACPb,IAAI,EAAE;gBACR;cACF,CAAC;cACDA,IAAI,EAAE;YACR,CAAC;UAEL,CAAC;UACDA,IAAI,EAAE;QACR;MACF,CAAC;MACDA,IAAI,EAAE;IACR,CAAC,CACF;IACDA,IAAI,EAAE;EACR;AACF,CAAC,CAAC;AAAAc,MAAA,CAAArB,OAAA,GAAAA,OAAA,CAAAF,OAAA","ignoreList":[]}
+{"version":3,"file":"requireReturnsType.cjs","names":["_iterateJsdoc","_interopRequireDefault","require","e","__esModule","default","_default","exports","iterateJsdoc","report","utils","forEachPreferredTag","jsdocTag","targetTagName","type","contextDefaults","meta","docs","description","url","schema","additionalProperties","properties","contexts","items","anyOf","comment","context","module"],"sources":["../../src/rules/requireReturnsType.js"],"sourcesContent":["import iterateJsdoc from '../iterateJsdoc.js';\n\nexport default iterateJsdoc(({\n  report,\n  utils,\n}) => {\n  utils.forEachPreferredTag('returns', (jsdocTag, targetTagName) => {\n    if (!jsdocTag.type) {\n      report(`Missing JSDoc @${targetTagName} type.`, null, jsdocTag);\n    }\n  });\n}, {\n  contextDefaults: true,\n  meta: {\n    docs: {\n      description: 'Requires that `@returns` tag has type value (in curly brackets).',\n      url: 'https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/require-returns-type.md#repos-sticky-header',\n    },\n    schema: [\n      {\n        additionalProperties: false,\n        properties: {\n          contexts: {\n            description: `Set this to an array of strings representing the AST context (or an object with\noptional \\`context\\` and \\`comment\\` properties) where you wish the rule to be applied.\n\n\\`context\\` defaults to \\`any\\` and \\`comment\\` defaults to no specific comment context.\n\nOverrides the default contexts (\\`ArrowFunctionExpression\\`, \\`FunctionDeclaration\\`,\n\\`FunctionExpression\\`). Set to \\`\"any\"\\` if you want\nthe rule to apply to any JSDoc block throughout your files (as is necessary\nfor finding function blocks not attached to a function declaration or\nexpression, i.e., \\`@callback\\` or \\`@function\\` (or its aliases \\`@func\\` or\n\\`@method\\`) (including those associated with an \\`@interface\\`).\n\nSee the [\"AST and Selectors\"](../advanced.md#ast-and-selectors)\nsection of our Advanced docs for more on the expected format.`,\n            items: {\n              anyOf: [\n                {\n                  type: 'string',\n                },\n                {\n                  additionalProperties: false,\n                  properties: {\n                    comment: {\n                      type: 'string',\n                    },\n                    context: {\n                      type: 'string',\n                    },\n                  },\n                  type: 'object',\n                },\n              ],\n            },\n            type: 'array',\n          },\n        },\n        type: 'object',\n      },\n    ],\n    type: 'suggestion',\n  },\n});\n"],"mappings":";;;;;;AAAA,IAAAA,aAAA,GAAAC,sBAAA,CAAAC,OAAA;AAA8C,SAAAD,uBAAAE,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAAA,IAAAG,QAAA,GAAAC,OAAA,CAAAF,OAAA,GAE/B,IAAAG,qBAAY,EAAC,CAAC;EAC3BC,MAAM;EACNC;AACF,CAAC,KAAK;EACJA,KAAK,CAACC,mBAAmB,CAAC,SAAS,EAAE,CAACC,QAAQ,EAAEC,aAAa,KAAK;IAChE,IAAI,CAACD,QAAQ,CAACE,IAAI,EAAE;MAClBL,MAAM,CAAC,kBAAkBI,aAAa,QAAQ,EAAE,IAAI,EAAED,QAAQ,CAAC;IACjE;EACF,CAAC,CAAC;AACJ,CAAC,EAAE;EACDG,eAAe,EAAE,IAAI;EACrBC,IAAI,EAAE;IACJC,IAAI,EAAE;MACJC,WAAW,EAAE,kEAAkE;MAC/EC,GAAG,EAAE;IACP,CAAC;IACDC,MAAM,EAAE,CACN;MACEC,oBAAoB,EAAE,KAAK;MAC3BC,UAAU,EAAE;QACVC,QAAQ,EAAE;UACRL,WAAW,EAAE;AACzB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,8DAA8D;UAClDM,KAAK,EAAE;YACLC,KAAK,EAAE,CACL;cACEX,IAAI,EAAE;YACR,CAAC,EACD;cACEO,oBAAoB,EAAE,KAAK;cAC3BC,UAAU,EAAE;gBACVI,OAAO,EAAE;kBACPZ,IAAI,EAAE;gBACR,CAAC;gBACDa,OAAO,EAAE;kBACPb,IAAI,EAAE;gBACR;cACF,CAAC;cACDA,IAAI,EAAE;YACR,CAAC;UAEL,CAAC;UACDA,IAAI,EAAE;QACR;MACF,CAAC;MACDA,IAAI,EAAE;IACR,CAAC,CACF;IACDA,IAAI,EAAE;EACR;AACF,CAAC,CAAC;AAAAc,MAAA,CAAArB,OAAA,GAAAA,OAAA,CAAAF,OAAA","ignoreList":[]}

package/dist/rules.d.ts

@@ -575,7 +575,7 @@ export interface Rules {
            * expression, i.e., `@callback` or `@function` (or its aliases `@func` or
            * `@method`) (including those associated with an `@interface`).
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts?: (
@@ -705,7 +705,7 @@ export interface Rules {
            * `FunctionExpression`). Set to `"any"` if you want the rule to apply to any
            * JSDoc block throughout your files.
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts?: (
@@ -900,7 +900,7 @@ export interface Rules {
             /**
              * AST to confine the allowing or disallowing to JSDoc blocks
              * associated with a particular context. See the
-             * ["AST and Selectors"](../#advanced-ast-and-selectors)
+             * ["AST and Selectors"](../advanced.md#ast-and-selectors)
              * section of our Advanced docs for more on the expected format.
              */
             context?: string;
@@ -1087,7 +1087,7 @@ export interface Rules {
            * expression, i.e., `@callback` or `@function` (or its aliases `@func` or
            * `@method`) (including those associated with an `@interface`).
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts?: (
@@ -1133,7 +1133,7 @@ export interface Rules {
            * function declaration or expression, i.e., `@callback` or `@function` (or its
            * aliases `@func` or `@method`) (including those associated with an `@interface`).
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts?: (
@@ -1215,7 +1215,7 @@ export interface Rules {
            * function declaration or expression, i.e., `@callback` or `@function` (or its
            * aliases `@func` or `@method`) (including those associated with an `@interface`).
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts: (
@@ -1248,7 +1248,7 @@ export interface Rules {
            * expression, i.e., `@callback` or `@function` (or its aliases `@func` or
            * `@method`) (including those associated with an `@interface`).
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts?: (
@@ -1396,7 +1396,7 @@ export interface Rules {
            * expression, i.e., `@callback` or `@function` (or its aliases `@func` or
            * `@method`) (including those associated with an `@interface`).
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts?: (
@@ -1495,7 +1495,7 @@ export interface Rules {
            * `FunctionExpression`). Set to `"any"` if you want the rule to apply to any
            * JSDoc block throughout your files.
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts?: (
@@ -1681,7 +1681,7 @@ export interface Rules {
            * Note that you may need to disable `require` items (e.g., `MethodDefinition`)
            * if you are specifying a more precise form in `contexts` (e.g., `MethodDefinition:not([accessibility="private"] > FunctionExpression`).
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts?: (
@@ -1938,7 +1938,7 @@ export interface Rules {
            * `TSMethodSignature` in TypeScript or restricting the contexts
            * which are checked.
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts?: (
@@ -2090,7 +2090,7 @@ export interface Rules {
            * expression, i.e., `@callback` or `@function` (or its aliases `@func` or
            * `@method`) (including those associated with an `@interface`).
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts?: (
@@ -2134,7 +2134,7 @@ export interface Rules {
            * expression, i.e., `@callback` or `@function` (or its aliases `@func` or
            * `@method`) (including those associated with an `@interface`).
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts?: (
@@ -2165,7 +2165,7 @@ export interface Rules {
            * expression, i.e., `@callback` or `@function` (or its aliases `@func` or
            * `@method`) (including those associated with an `@interface`).
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts?: (
@@ -2394,7 +2394,7 @@ export interface Rules {
            * expression, i.e., `@callback` or `@function` (or its aliases `@func` or
            * `@method`) (including those associated with an `@interface`).
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts?: (
@@ -2425,7 +2425,7 @@ export interface Rules {
            * expression, i.e., `@callback` or `@function` (or its aliases `@func` or
            * `@method`) (including those associated with an `@interface`).
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts?: (

package/package.json

@@ -5,18 +5,18 @@
     "url": "http://gajus.com"
   },
   "dependencies": {
-    "@es-joy/jsdoccomment": "~0.86.0",
+    "@es-joy/jsdoccomment": "~0.87.0",
     "@es-joy/resolve.exports": "1.2.0",
     "are-docs-informative": "^0.0.2",
-    "comment-parser": "1.4.6",
+    "comment-parser": "1.4.7",
     "debug": "^4.4.3",
     "escape-string-regexp": "^4.0.0",
     "espree": "^11.2.0",
     "esquery": "^1.7.0",
     "html-entities": "^2.6.0",
-    "object-deep-merge": "^2.0.0",
+    "object-deep-merge": "^2.0.1",
     "parse-imports-exports": "^0.2.4",
-    "semver": "^7.8.0",
+    "semver": "^7.8.1",
     "spdx-expression-parse": "^4.0.0",
     "to-valid-identifier": "^1.0.0"
   },
@@ -42,7 +42,7 @@
     "@types/estree": "^1.0.9",
     "@types/json-schema": "^7.0.15",
     "@types/mocha": "^10.0.10",
-    "@types/node": "^25.9.0",
+    "@types/node": "^25.9.1",
     "@types/semver": "^7.7.1",
     "@types/spdx-expression-parse": "^4.0.0",
     "@typescript-eslint/types": "8.59.4",
@@ -63,7 +63,7 @@
     "json-schema": "^0.4.0",
     "json-schema-to-typescript": "^15.0.4",
     "lint-staged": "^17.0.5",
-    "mocha": "^11.7.5",
+    "mocha": "^11.7.6",
     "open-editor": "^6.0.0",
     "playwright": "^1.60.0",
     "replace": "^1.2.2",
@@ -179,5 +179,5 @@
     "test-cov": "TIMING=1 c8 --reporter text pnpm run test-no-cov",
     "test-index": "pnpm run test-no-cov test/rules/index.js"
   },
-  "version": "63.0.0"
+  "version": "63.0.1"
 }

package/src/rules/emptyTags.js

@@ -55,6 +55,14 @@ export default iterateJsdoc(({
       // Allow for JSDoc-block final asterisks
       key !== emptyTags.length - 1 || !(/^\s*\*+$/v).test(content)
     )) {
+      const {
+        tokens: {
+          delimiter,
+          end,
+          postName,
+          start,
+        },
+      } = tag.source[0];
       const fix = () => {
         // By time of call in fixer, `tag` will have `line` added
         utils.setTag(
@@ -63,6 +71,12 @@ export default iterateJsdoc(({
            *   line: import('../iterateJsdoc.js').Integer
            * }}
            */ (tag),
+          {
+            delimiter,
+            end,
+            postName: end ? postName : '',
+            start,
+          },
         );
       };
 

package/src/rules/implementsOnClasses.js

@@ -46,7 +46,7 @@ for finding function blocks not attached to a function declaration or
 expression, i.e., \`@callback\` or \`@function\` (or its aliases \`@func\` or
 \`@method\`) (including those associated with an \`@interface\`).
 
-See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
 section of our Advanced docs for more on the expected format.`,
             items: {
               anyOf: [

package/src/rules/matchDescription.js

@@ -183,7 +183,7 @@ Overrides the default contexts (\`ArrowFunctionExpression\`, \`FunctionDeclarati
 \`FunctionExpression\`). Set to \`"any"\` if you want the rule to apply to any
 JSDoc block throughout your files.
 
-See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
 section of our Advanced docs for more on the expected format.`,
             items: {
               anyOf: [

package/src/rules/matchName.js

@@ -135,7 +135,7 @@ Accepts a string regular expression (optionally wrapped between two
                 context: {
                   description: `AST to confine the allowing or disallowing to JSDoc blocks
 associated with a particular context. See the
-["AST and Selectors"](../#advanced-ast-and-selectors)
+["AST and Selectors"](../advanced.md#ast-and-selectors)
 section of our Advanced docs for more on the expected format.`,
                   type: 'string',
                 },

package/src/rules/noDefaults.js

@@ -64,7 +64,7 @@ for finding function blocks not attached to a function declaration or
 expression, i.e., \`@callback\` or \`@function\` (or its aliases \`@func\` or
 \`@method\`) (including those associated with an \`@interface\`).
 
-See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
 section of our Advanced docs for more on the expected format.`,
             items: {
               anyOf: [

package/src/rules/noMissingSyntax.js

@@ -177,7 +177,7 @@ your files (as is necessary for finding function blocks not attached to a
 function declaration or expression, i.e., \`@callback\` or \`@function\` (or its
 aliases \`@func\` or \`@method\`) (including those associated with an \`@interface\`).
 
-See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
 section of our Advanced docs for more on the expected format.`,
             items: {
               anyOf: [

package/src/rules/noRestrictedSyntax.js

@@ -35,7 +35,7 @@ your files (as is necessary for finding function blocks not attached to a
 function declaration or expression, i.e., \`@callback\` or \`@function\` (or its
 aliases \`@func\` or \`@method\`) (including those associated with an \`@interface\`).
 
-See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
 section of our Advanced docs for more on the expected format.`,
           items: {
             anyOf: [

package/src/rules/noTypes.js

@@ -76,7 +76,7 @@ for finding function blocks not attached to a function declaration or
 expression, i.e., \`@callback\` or \`@function\` (or its aliases \`@func\` or
 \`@method\`) (including those associated with an \`@interface\`).
 
-See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
 section of our Advanced docs for more on the expected format.`,
             items: {
               anyOf: [

package/src/rules/requireDescription.js

@@ -138,7 +138,7 @@ for finding function blocks not attached to a function declaration or
 expression, i.e., \`@callback\` or \`@function\` (or its aliases \`@func\` or
 \`@method\`) (including those associated with an \`@interface\`).
 
-See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
 section of our Advanced docs for more on the expected format.`,
             items: {
               anyOf: [

package/src/rules/requireExample.js

@@ -88,7 +88,7 @@ Overrides the default contexts (\`ArrowFunctionExpression\`, \`FunctionDeclarati
 \`FunctionExpression\`). Set to \`"any"\` if you want the rule to apply to any
 JSDoc block throughout your files.
 
-See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
 section of our Advanced docs for more on the expected format.`,
             items: {
               anyOf: [

package/src/rules/requireJsdoc.js

@@ -102,7 +102,7 @@ for it to require documentation.
 Note that you may need to disable \`require\` items (e.g., \`MethodDefinition\`)
 if you are specifying a more precise form in \`contexts\` (e.g., \`MethodDefinition:not([accessibility="private"] > FunctionExpression\`).
 
-See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
 section of our Advanced docs for more on the expected format.`,
       items: {
         anyOf: [

package/src/rules/requireParam.js

@@ -684,7 +684,7 @@ Overrides the default contexts (\`ArrowFunctionExpression\`, \`FunctionDeclarati
 \`TSMethodSignature\` in TypeScript or restricting the contexts
 which are checked.
 
-See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
 section of our Advanced docs for more on the expected format.`,
             items: {
               anyOf: [

package/src/rules/requireParamDescription.js

@@ -65,7 +65,7 @@ for finding function blocks not attached to a function declaration or
 expression, i.e., \`@callback\` or \`@function\` (or its aliases \`@func\` or
 \`@method\`) (including those associated with an \`@interface\`).
 
-See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
 section of our Advanced docs for more on the expected format.`,
             items: {
               anyOf: [

package/src/rules/requireParamName.js

@@ -37,7 +37,7 @@ for finding function blocks not attached to a function declaration or
 expression, i.e., \`@callback\` or \`@function\` (or its aliases \`@func\` or
 \`@method\`) (including those associated with an \`@interface\`).
 
-See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
 section of our Advanced docs for more on the expected format.`,
             items: {
               anyOf: [

package/src/rules/requireParamType.js

@@ -65,7 +65,7 @@ for finding function blocks not attached to a function declaration or
 expression, i.e., \`@callback\` or \`@function\` (or its aliases \`@func\` or
 \`@method\`) (including those associated with an \`@interface\`).
 
-See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
 section of our Advanced docs for more on the expected format.`,
             items: {
               anyOf: [

package/src/rules/requireReturnsDescription.js

@@ -41,7 +41,7 @@ for finding function blocks not attached to a function declaration or
 expression, i.e., \`@callback\` or \`@function\` (or its aliases \`@func\` or
 \`@method\`) (including those associated with an \`@interface\`).
 
-See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
 section of our Advanced docs for more on the expected format.`,
             items: {
               anyOf: [

package/src/rules/requireReturnsType.js

@@ -33,7 +33,7 @@ for finding function blocks not attached to a function declaration or
 expression, i.e., \`@callback\` or \`@function\` (or its aliases \`@func\` or
 \`@method\`) (including those associated with an \`@interface\`).
 
-See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
 section of our Advanced docs for more on the expected format.`,
             items: {
               anyOf: [

package/src/rules.d.ts

@@ -575,7 +575,7 @@ export interface Rules {
            * expression, i.e., `@callback` or `@function` (or its aliases `@func` or
            * `@method`) (including those associated with an `@interface`).
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts?: (
@@ -705,7 +705,7 @@ export interface Rules {
            * `FunctionExpression`). Set to `"any"` if you want the rule to apply to any
            * JSDoc block throughout your files.
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts?: (
@@ -900,7 +900,7 @@ export interface Rules {
             /**
              * AST to confine the allowing or disallowing to JSDoc blocks
              * associated with a particular context. See the
-             * ["AST and Selectors"](../#advanced-ast-and-selectors)
+             * ["AST and Selectors"](../advanced.md#ast-and-selectors)
              * section of our Advanced docs for more on the expected format.
              */
             context?: string;
@@ -1087,7 +1087,7 @@ export interface Rules {
            * expression, i.e., `@callback` or `@function` (or its aliases `@func` or
            * `@method`) (including those associated with an `@interface`).
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts?: (
@@ -1133,7 +1133,7 @@ export interface Rules {
            * function declaration or expression, i.e., `@callback` or `@function` (or its
            * aliases `@func` or `@method`) (including those associated with an `@interface`).
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts?: (
@@ -1215,7 +1215,7 @@ export interface Rules {
            * function declaration or expression, i.e., `@callback` or `@function` (or its
            * aliases `@func` or `@method`) (including those associated with an `@interface`).
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts: (
@@ -1248,7 +1248,7 @@ export interface Rules {
            * expression, i.e., `@callback` or `@function` (or its aliases `@func` or
            * `@method`) (including those associated with an `@interface`).
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts?: (
@@ -1396,7 +1396,7 @@ export interface Rules {
            * expression, i.e., `@callback` or `@function` (or its aliases `@func` or
            * `@method`) (including those associated with an `@interface`).
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts?: (
@@ -1495,7 +1495,7 @@ export interface Rules {
            * `FunctionExpression`). Set to `"any"` if you want the rule to apply to any
            * JSDoc block throughout your files.
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts?: (
@@ -1681,7 +1681,7 @@ export interface Rules {
            * Note that you may need to disable `require` items (e.g., `MethodDefinition`)
            * if you are specifying a more precise form in `contexts` (e.g., `MethodDefinition:not([accessibility="private"] > FunctionExpression`).
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts?: (
@@ -1938,7 +1938,7 @@ export interface Rules {
            * `TSMethodSignature` in TypeScript or restricting the contexts
            * which are checked.
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts?: (
@@ -2090,7 +2090,7 @@ export interface Rules {
            * expression, i.e., `@callback` or `@function` (or its aliases `@func` or
            * `@method`) (including those associated with an `@interface`).
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts?: (
@@ -2134,7 +2134,7 @@ export interface Rules {
            * expression, i.e., `@callback` or `@function` (or its aliases `@func` or
            * `@method`) (including those associated with an `@interface`).
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts?: (
@@ -2165,7 +2165,7 @@ export interface Rules {
            * expression, i.e., `@callback` or `@function` (or its aliases `@func` or
            * `@method`) (including those associated with an `@interface`).
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts?: (
@@ -2394,7 +2394,7 @@ export interface Rules {
            * expression, i.e., `@callback` or `@function` (or its aliases `@func` or
            * `@method`) (including those associated with an `@interface`).
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts?: (
@@ -2425,7 +2425,7 @@ export interface Rules {
            * expression, i.e., `@callback` or `@function` (or its aliases `@func` or
            * `@method`) (including those associated with an `@interface`).
            *
-           * See the ["AST and Selectors"](../#advanced-ast-and-selectors)
+           * See the ["AST and Selectors"](../advanced.md#ast-and-selectors)
            * section of our Advanced docs for more on the expected format.
            */
           contexts?: (