feat: add ignoreLabels option to no-missing-label-refs

Author: jaymarvelz

docs/rules/no-missing-label-refs.md

@@ -30,6 +30,24 @@ Examples of **incorrect** code for this rule:
 [eslint]
 ```
 
+## Options
+
+The following options are available on this rule:
+
+* `ignoreLabels: Array<string>` - labels to ignore when checking for missing references. (default: `[]`)
+
+Examples of **correct** code when configured as `"no-missing-label-refs": ["error", { ignoreLabels: ["eslint"] }]`:
+
+```markdown
+<!-- eslint markdown/no-missing-label-refs: ["error", { ignoreLabels: ["eslint"] }] -->
+
+[ESLint][eslint]
+
+[eslint][]
+
+[eslint]
+```
+
 ## When Not to Use It
 
 If you aren't concerned with missing label references, you can safely disable this rule.

src/rules/no-missing-label-refs.js

@@ -18,7 +18,7 @@ import { findOffsets, illegalShorthandTailPattern } from "../util.js";
  * @import { Text } from "mdast";
  * @import { MarkdownRuleDefinition } from "../types.js";
  * @typedef {"notFound"} NoMissingLabelRefsMessageIds
- * @typedef {[]} NoMissingLabelRefsOptions
+ * @typedef {[{ ignoreLabels?: string[] }]} NoMissingLabelRefsOptions
  * @typedef {MarkdownRuleDefinition<{ RuleOptions: NoMissingLabelRefsOptions, MessageIds: NoMissingLabelRefsMessageIds }>} NoMissingLabelRefsRuleDefinition
  */
 
@@ -118,13 +118,36 @@ export default {
 			url: "https://github.com/eslint/markdown/blob/main/docs/rules/no-missing-label-refs.md",
 		},
 
+		schema: [
+			{
+				type: "object",
+				properties: {
+					ignoreLabels: {
+						type: "array",
+						items: {
+							type: "string",
+						},
+						uniqueItems: true,
+					},
+				},
+				additionalProperties: false,
+			},
+		],
+
+		defaultOptions: [
+			{
+				ignoreLabels: [],
+			},
+		],
+
 		messages: {
 			notFound: "Label reference '{{label}}' not found.",
 		},
 	},
 
 	create(context) {
 		const { sourceCode } = context;
+		const ignoreLabels = new Set(context.options[0].ignoreLabels);
 
 		/** @type {Array<{label:string,position:Position}>} */
 		let allMissingReferences = [];
@@ -143,9 +166,16 @@ export default {
 			},
 
 			text(node) {
-				allMissingReferences.push(
-					...findMissingReferences(node, sourceCode.getText(node)),
+				const missingReferences = findMissingReferences(
+					node,
+					sourceCode.getText(node),
 				);
+
+				for (const missingReference of missingReferences) {
+					if (!ignoreLabels.has(missingReference.label)) {
+						allMissingReferences.push(missingReference);
+					}
+				}
 			},
 
 			definition(node) {

tests/rules/no-missing-label-refs.test.js

@@ -55,6 +55,38 @@ ruleTester.run("no-missing-label-refs", rule, {
 		"[escaped\\]\\[escaped\\]",
 		"\\[escaped]\\[escaped]",
 		"[escaped\\][escaped\\]",
+		{
+			code: "[foo][bar]",
+			options: [{ ignoreLabels: ["bar"] }],
+		},
+		{
+			code: "![foo][bar]",
+			options: [{ ignoreLabels: ["bar"] }],
+		},
+		{
+			code: "[foo][]",
+			options: [{ ignoreLabels: ["foo"] }],
+		},
+		{
+			code: "![foo][]",
+			options: [{ ignoreLabels: ["foo"] }],
+		},
+		{
+			code: "[foo]",
+			options: [{ ignoreLabels: ["foo"] }],
+		},
+		{
+			code: "![foo]",
+			options: [{ ignoreLabels: ["foo"] }],
+		},
+		{
+			code: "[foo]\n[bar]",
+			options: [{ ignoreLabels: ["foo", "bar"] }],
+		},
+		{
+			code: "[Foo][]\n[Bar][]",
+			options: [{ ignoreLabels: ["Foo", "Bar"] }],
+		},
 	],
 	invalid: [
 		{
@@ -381,6 +413,90 @@ ruleTester.run("no-missing-label-refs", rule, {
 				},
 			],
 		},
+		{
+			code: "[foo][bar]",
+			options: [{ ignoreLabels: ["baz"] }],
+			errors: [
+				{
+					messageId: "notFound",
+					data: { label: "bar" },
+					line: 1,
+					column: 7,
+					endLine: 1,
+					endColumn: 10,
+				},
+			],
+		},
+		{
+			code: "![foo][bar]",
+			options: [{ ignoreLabels: ["foo"] }],
+			errors: [
+				{
+					messageId: "notFound",
+					data: { label: "bar" },
+					line: 1,
+					column: 8,
+					endLine: 1,
+					endColumn: 11,
+				},
+			],
+		},
+		{
+			code: "[foo][]",
+			options: [{ ignoreLabels: ["bar"] }],
+			errors: [
+				{
+					messageId: "notFound",
+					data: { label: "foo" },
+					line: 1,
+					column: 2,
+					endLine: 1,
+					endColumn: 5,
+				},
+			],
+		},
+		{
+			code: "[foo]\n[bar]",
+			options: [{ ignoreLabels: ["foo"] }],
+			errors: [
+				{
+					messageId: "notFound",
+					data: { label: "bar" },
+					line: 2,
+					column: 2,
+					endLine: 2,
+					endColumn: 5,
+				},
+			],
+		},
+		{
+			code: "[Foo][]",
+			options: [{ ignoreLabels: ["foo"] }],
+			errors: [
+				{
+					messageId: "notFound",
+					data: { label: "Foo" },
+					line: 1,
+					column: 2,
+					endLine: 1,
+					endColumn: 5,
+				},
+			],
+		},
+		{
+			code: "[Foo][foo]\n[Bar][]",
+			options: [{ ignoreLabels: ["Bar"] }],
+			errors: [
+				{
+					messageId: "notFound",
+					data: { label: "foo" },
+					line: 1,
+					column: 7,
+					endLine: 1,
+					endColumn: 10,
+				},
+			],
+		},
 	],
 });