Merge branch 'main' into fix-false-negatives-no-reversed-media-syntax

Author: lumirlumir

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "7.0.0"
+  ".": "7.1.0"
 }

CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## [7.1.0](https://github.com/eslint/markdown/compare/v7.0.0...v7.1.0) (2025-07-22)
+
+
+### Features
+
+* add checkMissingCells option to table-column-count ([#434](https://github.com/eslint/markdown/issues/434)) ([bf3f39b](https://github.com/eslint/markdown/commit/bf3f39be366f6dec6ad6a8d26751c06d04988e3f))
+
+
+### Bug Fixes
+
+* bump `plugin-kit` to latest to resolve security vulnerabilities ([#485](https://github.com/eslint/markdown/issues/485)) ([c5398ca](https://github.com/eslint/markdown/commit/c5398caac221daa147a2993cc945e42e374a6c5d))
+* case-insensitive attribute checks in `no-missing-link-fragment` ([#465](https://github.com/eslint/markdown/issues/465)) ([094a59d](https://github.com/eslint/markdown/commit/094a59d13b294f62c45693f41e921e08d15f0ccb))
+* case-insensitive checks for HTML attributes in `no-missing-link-fragment` ([094a59d](https://github.com/eslint/markdown/commit/094a59d13b294f62c45693f41e921e08d15f0ccb))
+* no-reversed-media-syntax add missing offset for code spans ([#460](https://github.com/eslint/markdown/issues/460)) ([af7736c](https://github.com/eslint/markdown/commit/af7736c51d2ad6d065d12b5b92ff01aff8d58a4a))
+* potential super-linear regular expressions ([#463](https://github.com/eslint/markdown/issues/463)) ([bc82567](https://github.com/eslint/markdown/commit/bc82567458f8fc41b36cbcb2c67aac746078e044))
+* remove unused types from `types.ts` ([#462](https://github.com/eslint/markdown/issues/462)) ([466f80e](https://github.com/eslint/markdown/commit/466f80e1b66e4894853ed26e7475fdab944a33ce))
+
 ## [7.0.0](https://github.com/eslint/markdown/compare/v6.6.0...v7.0.0) (2025-07-11)
 
 

docs/rules/heading-increment.md

@@ -25,6 +25,68 @@ Goodbye World!
 #EEE Goodbye World!
 ```
 
+## Options
+
+The following options are available on this rule:
+
+* `frontmatterTitle: string` - A regex pattern to match title fields in front matter. Front matter titles matching this pattern are treated as level 1 headings. The default pattern matches YAML (`title:`), TOML (`title =`), and JSON (`"title":`) formats. Set to an empty string to disable front matter title checking.
+
+Examples of **incorrect** code for this rule:
+
+```markdown
+<!-- eslint markdown/heading-increment: "error" -->
+
+---
+title: My Title
+---
+
+### Heading 3 with YAML front matter
+```
+
+```markdown
+<!-- eslint markdown/heading-increment: "error" -->
+
++++
+title = "My Title"
++++
+
+### Heading 3 with TOML front matter
+```
+
+```markdown
+<!-- eslint markdown/heading-increment: "error" -->
+
+---
+{ "title": "My Title" }
+---
+
+### Heading 3 with JSON front matter
+```
+
+Examples of **incorrect** code when configured as `"heading-increment": ["error", { frontmatterTitle: "\\s*heading\\s*[:=]" }]`:
+
+```markdown
+<!-- eslint markdown/heading-increment: ["error", { frontmatterTitle: "\\s*heading\\s*[:=]" }] -->
+
+---
+heading: My Title
+---
+
+### Heading 3
+```
+
+Examples of **correct** code when configured as `"heading-increment": ["error", { frontmatterTitle: "" }]`:
+
+```markdown
+<!-- eslint markdown/heading-increment: ["error", { frontmatterTitle: "" }] -->
+
+---
+title: My Title
+---
+
+### Heading 3
+```
+
 ## When Not to Use It
 
 If you aren't concerned with enforcing heading levels increment by one, you can safely disable this rule.

jsr.json

@@ -1,6 +1,6 @@
 {
   "name": "@eslint/markdown",
-  "version": "7.0.0",
+  "version": "7.1.0",
   "exports": "./dist/esm/index.js",
   "publish": {
     "include": [

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eslint/markdown",
-  "version": "7.0.0",
+  "version": "7.1.0",
   "description": "The official ESLint language plugin for Markdown",
   "license": "MIT",
   "author": {
@@ -73,10 +73,10 @@
     "test:types": "tsc -p tests/types/tsconfig.json"
   },
   "devDependencies": {
-    "@eslint/js": "^9.4.0",
+    "@eslint/js": "^9.31.0",
     "c8": "^10.1.2",
     "dedent": "^1.5.3",
-    "eslint": "^9.28.0",
+    "eslint": "^9.31.0",
     "eslint-config-eslint": "^11.0.0",
     "eslint-plugin-eslint-plugin": "^6.3.2",
     "globals": "^15.1.0",
@@ -88,12 +88,12 @@
     "yorkie": "^2.0.0"
   },
   "dependencies": {
-    "@eslint/core": "^0.15.0",
-    "@eslint/plugin-kit": "^0.3.1",
+    "@eslint/core": "^0.15.1",
+    "@eslint/plugin-kit": "^0.3.4",
     "github-slugger": "^2.0.0",
     "mdast-util-from-markdown": "^2.0.2",
     "mdast-util-frontmatter": "^2.0.1",
-    "mdast-util-gfm": "^3.0.0",
+    "mdast-util-gfm": "^3.1.0",
     "micromark-extension-frontmatter": "^2.0.0",
     "micromark-extension-gfm": "^3.0.0"
   },

src/index.js

@@ -54,7 +54,7 @@ let recommendedPlugins, processorPlugins;
 const plugin = {
 	meta: {
 		name: "@eslint/markdown",
-		version: "7.0.0", // x-release-please-version
+		version: "7.1.0", // x-release-please-version
 	},
 	processors: {
 		markdown: processor,

src/processor.js

@@ -466,7 +466,7 @@ function postprocess(messages, filename) {
 export const processor = {
 	meta: {
 		name: "@eslint/markdown/markdown",
-		version: "7.0.0", // x-release-please-version
+		version: "7.1.0", // x-release-please-version
 	},
 	preprocess,
 	postprocess,

src/rules/heading-increment.js

@@ -3,14 +3,20 @@
  * @author Nicholas C. Zakas
  */
 
+//-----------------------------------------------------------------------------
+// Imports
+//-----------------------------------------------------------------------------
+
+import { frontmatterHasTitle } from "../util.js";
+
 //-----------------------------------------------------------------------------
 // Type Definitions
 //-----------------------------------------------------------------------------
 
 /**
  * @import { MarkdownRuleDefinition } from "../types.js";
  * @typedef {"skippedHeading"} HeadingIncrementMessageIds
- * @typedef {[]} HeadingIncrementOptions
+ * @typedef {[{ frontmatterTitle?: string }]} HeadingIncrementOptions
  * @typedef {MarkdownRuleDefinition<{ RuleOptions: HeadingIncrementOptions, MessageIds: HeadingIncrementMessageIds }>} HeadingIncrementRuleDefinition
  */
 
@@ -33,12 +39,52 @@ export default {
 			skippedHeading:
 				"Heading level skipped from {{fromLevel}} to {{toLevel}}.",
 		},
+
+		schema: [
+			{
+				type: "object",
+				properties: {
+					frontmatterTitle: {
+						type: "string",
+					},
+				},
+				additionalProperties: false,
+			},
+		],
+
+		defaultOptions: [
+			{
+				frontmatterTitle:
+					"^(?!\\s*['\"]title[:=]['\"])\\s*\\{?\\s*['\"]?title['\"]?\\s*[:=]",
+			},
+		],
 	},
 
 	create(context) {
+		const [{ frontmatterTitle }] = context.options;
+		const titlePattern =
+			frontmatterTitle === "" ? null : new RegExp(frontmatterTitle, "iu");
 		let lastHeadingDepth = 0;
 
 		return {
+			yaml(node) {
+				if (frontmatterHasTitle(node.value, titlePattern)) {
+					lastHeadingDepth = 1;
+				}
+			},
+
+			toml(node) {
+				if (frontmatterHasTitle(node.value, titlePattern)) {
+					lastHeadingDepth = 1;
+				}
+			},
+
+			json(node) {
+				if (frontmatterHasTitle(node.value, titlePattern)) {
+					lastHeadingDepth = 1;
+				}
+			},
+
 			heading(node) {
 				if (lastHeadingDepth > 0 && node.depth > lastHeadingDepth + 1) {
 					context.report({

src/rules/no-multiple-h1.js

@@ -7,7 +7,7 @@
 // Imports
 //-----------------------------------------------------------------------------
 
-import { findOffsets } from "../util.js";
+import { findOffsets, frontmatterHasTitle } from "../util.js";
 
 //-----------------------------------------------------------------------------
 // Type Definitions
@@ -26,25 +26,6 @@ import { findOffsets } from "../util.js";
 
 const h1TagPattern = /(?<!<!--[\s\S]*?)<h1[^>]*>[\s\S]*?<\/h1>/giu;
 
-/**
- * Checks if a frontmatter block contains a title matching the given pattern
- * @param {string} value The frontmatter content
- * @param {RegExp|null} pattern The pattern to match against
- * @returns {boolean} Whether a title was found
- */
-function frontmatterHasTitle(value, pattern) {
-	if (!pattern) {
-		return false;
-	}
-	const lines = value.split("\n");
-	for (const line of lines) {
-		if (pattern.test(line)) {
-			return true;
-		}
-	}
-	return false;
-}
-
 //-----------------------------------------------------------------------------
 // Rule Definition
 //-----------------------------------------------------------------------------

src/util.js

@@ -37,3 +37,22 @@ export function findOffsets(text, offset) {
 		columnOffset,
 	};
 }
+
+/**
+ * Checks if a frontmatter block contains a title matching the given pattern
+ * @param {string} value The frontmatter content
+ * @param {RegExp|null} pattern The pattern to match against
+ * @returns {boolean} Whether a title was found
+ */
+export function frontmatterHasTitle(value, pattern) {
+	if (!pattern) {
+		return false;
+	}
+	const lines = value.split("\n");
+	for (const line of lines) {
+		if (pattern.test(line)) {
+			return true;
+		}
+	}
+	return false;
+}