eslint-markdown 0.18.1 → 0.19.1

package/README.md

@@ -1,21 +1,53 @@
-# eslint-markdown
+<!-- eslint-disable markdown/no-html -->
 
-[![ci](https://img.shields.io/github/actions/workflow/status/eslint-markdown/eslint-markdown/ci.yml?label=ci&color=6358d4&labelColor=333333&logo=github)](https://github.com/eslint-markdown/eslint-markdown/actions/workflows/ci.yml)
-[![test](https://img.shields.io/github/actions/workflow/status/eslint-markdown/eslint-markdown/test.yml?label=test&color=6358d4&labelColor=333333&logo=github)](https://github.com/eslint-markdown/eslint-markdown/actions/workflows/test.yml)
-[![codecov](https://img.shields.io/codecov/c/gh/eslint-markdown/eslint-markdown?token=LJMUst9eR3&label=Codecov&color=6358d4&labelColor=333333&logo=codecov)](https://codecov.io/gh/eslint-markdown/eslint-markdown)
-![Node Current](https://img.shields.io/node/v/eslint-markdown?color=6358d4&labelColor=333333&logo=node.js)
+<p align="center">
+  <img alt="ESLint Markdown Logo" src="https://eslint-markdown.lumir.page/logo.svg" width="150">
+</p>
 
-[![npm package eslint-markdown latest version](https://img.shields.io/npm/v/eslint-markdown?label=eslint-markdown@latest&color=6358d4&labelColor=333333&logo=npm)](https://www.npmjs.com/package/eslint-markdown)
-[![npm package eslint-markdown next version](https://img.shields.io/npm/v/eslint-markdown/next?label=eslint-markdown@next&color=6358d4&labelColor=333333&logo=npm)](https://www.npmjs.com/package/eslint-markdown)
-[![npm package eslint-markdown downloads per month](https://img.shields.io/npm/dm/eslint-markdown?label=downloads&color=6358d4&labelColor=333333&logo=npm)](https://www.npmjs.com/package/eslint-markdown)
+<h1 align="center">ESLint Markdown</h1>
+
+<p align="center">
+  <a href="https://eslint-markdown.lumir.page">Documentation</a> |
+  <a href="https://eslint-markdown.lumir.page/docs/rules/">Rules</a> |
+  <a href="https://eslint-markdown.lumir.page/docs/get-started/configurations">Configurations</a> |
+  <a href="https://eslint-markdown.lumir.page/docs/get-started/migration">Migration</a> |
+  <a href="https://eslint-markdown.lumir.page/docs/packages">Packages</a> |
+  <a href="https://github.com/eslint-markdown/eslint-markdown">Repository</a> |
+  <a href="https://github.com/eslint-markdown/eslint-markdown/discussions">Discussions</a>
+</p>
+
+<p align="center">
+  Community-Maintained ESLint Tools, Rules, and Configurations for High-Quality and Performant Markdown Linting.
+</p>
+
+<p align="center">
+  <a href="https://github.com/eslint-markdown/eslint-markdown/actions/workflows/ci.yml"><img alt="ci" src="https://img.shields.io/github/actions/workflow/status/eslint-markdown/eslint-markdown/ci.yml?label=ci&color=341bab&labelColor=1a1a1a&logo=github"></a>
+  <a href="https://github.com/eslint-markdown/eslint-markdown/actions/workflows/test.yml"><img alt="test" src="https://img.shields.io/github/actions/workflow/status/eslint-markdown/eslint-markdown/test.yml?label=test&color=341bab&labelColor=1a1a1a&logo=github"></a>
+  <a href="https://codecov.io/gh/eslint-markdown/eslint-markdown"><img alt="codecov" src="https://img.shields.io/codecov/c/gh/eslint-markdown/eslint-markdown?token=LJMUst9eR3&label=Codecov&color=341bab&labelColor=1a1a1a&logo=codecov"></a>
+  <img alt="Node Current" src="https://img.shields.io/node/v/eslint-markdown?color=341bab&labelColor=1a1a1a&logo=node.js">
+</p>
+
+<!-- eslint-enable markdown/no-html -->
 
 > [!IMPORTANT]
 >
 > If you like this package, please give it a star on [GitHub](https://github.com/eslint-markdown/eslint-markdown)!⭐<br/>
 > Your support helps us improve and maintain the project.
 
+## `eslint-markdown`
+
+[![npm package eslint-markdown latest version](https://img.shields.io/npm/v/eslint-markdown?label=eslint-markdown@latest&color=341bab&labelColor=1a1a1a&logo=npm)](https://www.npmjs.com/package/eslint-markdown)
+[![npm package eslint-markdown next version](https://img.shields.io/npm/v/eslint-markdown/next?label=eslint-markdown@next&color=341bab&labelColor=1a1a1a&logo=npm)](https://www.npmjs.com/package/eslint-markdown)
+[![npm package eslint-markdown downloads per month](https://img.shields.io/npm/dm/eslint-markdown?label=downloads&color=341bab&labelColor=1a1a1a&logo=npm)](https://www.npmjs.com/package/eslint-markdown)
+
 Lint your Markdown with ESLint. Additional rules for use with `@eslint/markdown`.🛠️
 
+> [!IMPORTANT]
+>
+> **Compatibility**: This [`eslint-markdown`](https://github.com/eslint-markdown/eslint-markdown#readme) plugin does not include any rules that overlap with ESLint's built-in Markdown rules provided by [`@eslint/markdown`](https://github.com/eslint/markdown#readme).
+>
+> So, we **highly recommend** using the `eslint-markdown` plugin alongside ESLint's built-in Markdown support, `@eslint/markdown`.
+
 ## Documentation
 
 For full documentation, see the [official documentation of the `eslint-markdown`](https://eslint-markdown.lumir.page).
@@ -23,30 +55,14 @@ For full documentation, see the [official documentation of the `eslint-markdown`
 - [Installation](https://eslint-markdown.lumir.page/docs/get-started/installation)
 - [Configurations](https://eslint-markdown.lumir.page/docs/get-started/configurations)
 - [Migration Guide](https://eslint-markdown.lumir.page/docs/get-started/migration)
+  - [Migrating from `markdownlint`](https://eslint-markdown.lumir.page/docs/get-started/migration#migrating-from-markdownlint)
+  - [Migrating from `remark-lint`](https://eslint-markdown.lumir.page/docs/get-started/migration#migrating-from-remark-lint)
+  - [Migrating from `textlint`](https://eslint-markdown.lumir.page/docs/get-started/migration#migrating-from-textlint)
 - [Rules](https://eslint-markdown.lumir.page/docs/rules)
-
-## Compatibility
-
-This [`eslint-markdown`](https://github.com/eslint-markdown/eslint-markdown#readme) plugin does not include any rules that overlap with ESLint's built-in Markdown rules provided by [`@eslint/markdown`](https://github.com/eslint/markdown#readme).
-
-So, we **highly recommend** using the `eslint-markdown` plugin alongside ESLint's built-in Markdown support, `@eslint/markdown`.
-
-## Code of Conduct
-
-See [Code of Conduct](https://github.com/eslint-markdown/eslint-markdown/blob/main/CODE_OF_CONDUCT.md).
-
-## Change Log
-
-See [Change Log](https://github.com/eslint-markdown/eslint-markdown/blob/main/CHANGELOG.md).
-
-## Versioning
-
-See [Versioning](https://eslint-markdown.lumir.page/docs/get-started/versioning).
-
-## Security
-
-See [Security](https://github.com/eslint-markdown/eslint-markdown/blob/main/SECURITY.md).
+- [Packages](https://eslint-markdown.lumir.page/docs/packages)
+  - [`eslint-markdown`](https://eslint-markdown.lumir.page/docs/packages/eslint-markdown)
+  - [`eslint-lumir`](https://eslint-markdown.lumir.page/docs/packages/eslint-lumir)
 
 ## License
 
-[MIT](https://github.com/eslint-markdown/eslint-markdown/blob/main/LICENSE.md)
+[MIT](https://github.com/eslint-markdown/eslint-markdown/blob/main/packages/eslint-markdown/LICENSE.md)

package/build/configs/all.d.ts

@@ -25,6 +25,7 @@ export default function all(plugin: ESLint.Plugin): {
         readonly 'md/consistent-emphasis-style': "error";
         readonly 'md/consistent-heading-style': "error";
         readonly 'md/consistent-inline-code-style': "error";
+        readonly 'md/consistent-ordered-list-style': "error";
         readonly 'md/consistent-strong-style': "error";
         readonly 'md/consistent-thematic-break-style': "error";
         readonly 'md/consistent-unordered-list-style': "error";

package/build/configs/all.js

@@ -33,6 +33,7 @@ export default function all(plugin) {
             'md/consistent-emphasis-style': 'error',
             'md/consistent-heading-style': 'error',
             'md/consistent-inline-code-style': 'error',
+            'md/consistent-ordered-list-style': 'error',
             'md/consistent-strong-style': 'error',
             'md/consistent-thematic-break-style': 'error',
             'md/consistent-unordered-list-style': 'error',

package/build/configs/stylistic.d.ts

@@ -21,6 +21,7 @@ export default function stylistic(plugin: ESLint.Plugin): {
         readonly 'md/consistent-emphasis-style': "error";
         readonly 'md/consistent-heading-style': "error";
         readonly 'md/consistent-inline-code-style': "error";
+        readonly 'md/consistent-ordered-list-style': "error";
         readonly 'md/consistent-strong-style': "error";
         readonly 'md/consistent-thematic-break-style': "error";
         readonly 'md/consistent-unordered-list-style': "error";

package/build/configs/stylistic.js

@@ -29,6 +29,7 @@ export default function stylistic(plugin) {
             'md/consistent-emphasis-style': 'error',
             'md/consistent-heading-style': 'error',
             'md/consistent-inline-code-style': 'error',
+            'md/consistent-ordered-list-style': 'error',
             'md/consistent-strong-style': 'error',
             'md/consistent-thematic-break-style': 'error',
             'md/consistent-unordered-list-style': 'error',

package/build/core/constants.d.ts

@@ -30,6 +30,11 @@ export declare const punctuation: readonly [".", ",", ";", ":", "!", "。", "，
  * @see https://github.com/remarkjs/remark-lint/tree/main/packages/remark-lint-no-heading-punctuation#parameters
  */
 export declare const punctuationWithQuestionMark: readonly [".", ",", ";", ":", "!", "?", "。", "，", "；", "：", "！", "？"];
+/**
+ * Matches a single ASCII punctuation character as defined by CommonMark.
+ * @see https://spec.commonmark.org/0.31.2/#ascii-punctuation-character
+ */
+export declare const asciiPunctuationRegex: RegExp;
 /**
  * Regular expression for identifying an odd-length run of backslashes at the end of a string.
  */

package/build/core/constants.js

@@ -49,6 +49,11 @@ export const punctuationWithQuestionMark = [
 // --------------------------------------------------------------------------------
 // --------------------------------------------------------------------------------
 // #region regex
+/**
+ * Matches a single ASCII punctuation character as defined by CommonMark.
+ * @see https://spec.commonmark.org/0.31.2/#ascii-punctuation-character
+ */
+export const asciiPunctuationRegex = /^[\x21-\x2F\x3A-\x40\x5B-\x60\x7B-\x7E]$/;
 /**
  * Regular expression for identifying an odd-length run of backslashes at the end of a string.
  */

package/build/core/utils/html.d.ts

@@ -1,7 +1,7 @@
 /**
  * @fileoverview HTML AST utilities.
  */
-import type { DefaultTreeAdapterTypes } from 'parse5';
+import { type DefaultTreeAdapterTypes } from 'parse5';
 /**
  * Mimics the behavior of `getElementsByTagName` in the DOM API.
  * @param html The HTML string to parse.

package/build/rules/consistent-code-style.js

@@ -103,28 +103,30 @@ export default {
                 const currentCodeStyle = getCodeStyle(currentCodeFenceChar);
                 const nodeStartLineIndex = start.line - 1;
                 const nodeEndLineIndex = end.line - 1;
+                const nodeStartLineText = lines[nodeStartLineIndex];
+                const nodeEndLineText = lines[nodeEndLineIndex];
+                const leadingCodeFenceLoc = {
+                    start,
+                    end: {
+                        line: start.line,
+                        column: (() => {
+                            if (currentCodeStyle === 'indent') {
+                                return nodeStartLineText.length + 1;
+                            }
+                            let { column } = start;
+                            while (nodeStartLineText[column - 1] === currentCodeFenceChar) {
+                                column++;
+                            }
+                            return column;
+                        })(),
+                    },
+                };
                 if (codeStyle === null) {
                     codeStyle = currentCodeStyle;
                 }
                 if (codeStyle !== currentCodeStyle) {
                     context.report({
-                        loc: {
-                            start,
-                            end: {
-                                line: start.line,
-                                column: (() => {
-                                    const nodeStartLineText = lines[nodeStartLineIndex];
-                                    if (currentCodeStyle === 'indent') {
-                                        return nodeStartLineText.length + 1;
-                                    }
-                                    let { column } = start;
-                                    while (nodeStartLineText[column - 1] === currentCodeFenceChar) {
-                                        column++;
-                                    }
-                                    return column;
-                                })(),
-                            },
-                        },
+                        loc: leadingCodeFenceLoc,
                         messageId: 'style',
                         data: {
                             style: codeStyle,
@@ -150,7 +152,7 @@ export default {
                             continue;
                         }
                         context.report({
-                            node,
+                            loc: leadingCodeFenceLoc,
                             messageId: 'blankLineAbove',
                             data: {
                                 blankLineAbove,
@@ -179,7 +181,18 @@ export default {
                             continue;
                         }
                         context.report({
-                            node,
+                            // Report the last line of the code block, as highlighting only the trailing
+                            // code fence characters involves many edge cases that cannot be handled reliably.
+                            loc: {
+                                start: {
+                                    line: end.line,
+                                    column: 1,
+                                },
+                                end: {
+                                    line: end.line,
+                                    column: nodeEndLineText.length + 1,
+                                },
+                            },
                             messageId: 'blankLineBelow',
                             data: {
                                 blankLineBelow,

package/build/rules/consistent-ordered-list-style.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @fileoverview Rule to enforce consistent ordered list style.
+ * @author Ga eun Lee(tooth-is-silver)
+ */
+import type { ListItem } from 'mdast';
+type OrderedListStyle = (typeof ORDERED_LIST_STYLE)[number];
+/**
+ * Options for the `consistent-ordered-list-style` rule.
+ */
+type RuleOptions = [
+    {
+        /**
+         * When `style` is set to `'one-or-ordered'`, the rule allows either the `'one'` or `'ordered'` style based on the first two list item prefixes.
+         *
+         * When `style` is set to `'one'`, the rule requires every prefix to be `1`.
+         *
+         * When `style` is set to `'ordered'`, the rule requires prefixes to increase sequentially, starting from `1` or from `0` when the list has two or more items.
+         *
+         * When `style` is set to `'zero'`, the rule requires every prefix to be `0`.
+         * @default 'one-or-ordered'
+         */
+        style: 'one-or-ordered' | OrderedListStyle;
+    }
+];
+declare const ORDERED_LIST_STYLE: readonly ["one", "ordered", "zero"];
+declare const _default: {
+    readonly meta: {
+        readonly type: "layout";
+        readonly docs: {
+            readonly description: "Enforce consistent ordered list style";
+            readonly url: string;
+            readonly recommended: false;
+            readonly stylistic: true;
+        };
+        readonly schema: [{
+            readonly type: "object";
+            readonly properties: {
+                readonly style: {
+                    readonly enum: ["one-or-ordered", "one", "ordered", "zero"];
+                };
+            };
+            readonly additionalProperties: false;
+        }];
+        readonly defaultOptions: [{
+            readonly style: "one-or-ordered";
+        }];
+        readonly messages: {
+            readonly style: "Ordered list style should be `{{ style }}`.";
+        };
+        readonly language: "markdown";
+        readonly dialects: ["commonmark", "gfm"];
+    };
+    readonly create: (context: import("../core/types.js").RuleContext<{
+        RuleOptions: RuleOptions;
+        MessageIds: "style";
+    }>) => {
+        'list[ordered=true]'(): void;
+        'list[ordered=true] > listItem'(node: ListItem): void;
+        'list[ordered=true]:exit'(): void;
+    };
+};
+export default _default;

package/build/rules/consistent-ordered-list-style.js

@@ -0,0 +1,108 @@
+/**
+ * @fileoverview Rule to enforce consistent ordered list style.
+ * @author Ga eun Lee(tooth-is-silver)
+ */
+import { URL_RULE_DOCS } from '../core/constants.js';
+// --------------------------------------------------------------------------------
+// Helper
+// --------------------------------------------------------------------------------
+const ORDERED_LIST_STYLE = ['one', 'ordered', 'zero'];
+/**
+ * Ordered list start numbers must be nine digits or less.
+ * @see https://spec.commonmark.org/0.31.2/#example-265
+ */
+const orderedListPrefixRegex = /^\d{1,9}/u;
+// --------------------------------------------------------------------------------
+// Rule Definition
+// --------------------------------------------------------------------------------
+export default {
+    meta: {
+        type: 'layout',
+        docs: {
+            description: 'Enforce consistent ordered list style',
+            url: URL_RULE_DOCS('consistent-ordered-list-style'),
+            recommended: false,
+            stylistic: true,
+        },
+        schema: [
+            {
+                type: 'object',
+                properties: {
+                    style: {
+                        enum: ['one-or-ordered', ...ORDERED_LIST_STYLE],
+                    },
+                },
+                additionalProperties: false,
+            },
+        ],
+        defaultOptions: [
+            {
+                style: 'one-or-ordered',
+            },
+        ],
+        messages: {
+            style: 'Ordered list style should be `{{ style }}`.',
+        },
+        language: 'markdown',
+        dialects: ['commonmark', 'gfm'],
+    },
+    create(context) {
+        const { sourceCode } = context;
+        const [{ style }] = context.options;
+        const orderedListPrefixesStack = [];
+        return {
+            'list[ordered=true]'() {
+                orderedListPrefixesStack.push([]);
+            },
+            'list[ordered=true] > listItem'(node) {
+                const [nodeStartOffset] = sourceCode.getRange(node);
+                // `match` is never `null` because this visitor only runs for
+                // ordered list items, whose source text starts with a numeric marker.
+                const match = orderedListPrefixRegex.exec(sourceCode.getText(node));
+                const orderedListPrefix = match[0];
+                orderedListPrefixesStack[orderedListPrefixesStack.length - 1].push({
+                    startOffset: nodeStartOffset,
+                    endOffset: nodeStartOffset + orderedListPrefix.length,
+                    number: Number(orderedListPrefix),
+                });
+            },
+            'list[ordered=true]:exit'() {
+                // Can never be `undefined` because `list[ordered=true]` always pushes to the stack before exiting.
+                const orderedListPrefixes = orderedListPrefixesStack.pop();
+                const [firstOrderedListPrefix, secondOrderedListPrefix] = orderedListPrefixes;
+                const hasMultipleItems = orderedListPrefixes.length > 1;
+                let orderedListStyle = style;
+                if (orderedListStyle === 'one-or-ordered') {
+                    orderedListStyle =
+                        hasMultipleItems &&
+                            (firstOrderedListPrefix.number === 0 || secondOrderedListPrefix.number !== 1)
+                            ? 'ordered'
+                            : 'one';
+                }
+                let expectedOrderedListPrefixNumber = orderedListStyle === 'zero' ||
+                    (orderedListStyle === 'ordered' &&
+                        hasMultipleItems &&
+                        firstOrderedListPrefix.number === 0)
+                    ? 0
+                    : 1;
+                for (const { startOffset, endOffset, number } of orderedListPrefixes) {
+                    if (number !== expectedOrderedListPrefixNumber) {
+                        context.report({
+                            loc: {
+                                start: sourceCode.getLocFromIndex(startOffset),
+                                end: sourceCode.getLocFromIndex(endOffset),
+                            },
+                            messageId: 'style',
+                            data: {
+                                style: orderedListStyle,
+                            },
+                        });
+                    }
+                    if (orderedListStyle === 'ordered') {
+                        expectedOrderedListPrefixNumber++;
+                    }
+                }
+            },
+        };
+    },
+};

package/build/rules/en-capitalization.js

@@ -11,7 +11,7 @@ const lowercaseRegex = /^[a-z]/u;
  * Traverses the Markdown AST using a DFS pre-order approach to find the first text node.
  * @param node The node to start searching from.
  * @returns The first text node, if present.
- */ // eslint-disable-next-line @typescript-eslint/no-explicit-any -- TODO: This rule is not fully migrated to TypeScript yet.
+ */ // eslint-disable-next-line typescript/no-explicit-any -- TODO: This rule is not fully migrated to TypeScript yet.
 function findFirstLeafTextNode(node) {
     // Base case: if this is a text node, return it
     if (node.type === 'text')

package/build/rules/index.d.ts

@@ -632,6 +632,44 @@ declare const _default: {
             inlineCode(node: import("mdast").InlineCode): void;
         };
     };
+    'consistent-ordered-list-style': {
+        readonly meta: {
+            readonly type: "layout";
+            readonly docs: {
+                readonly description: "Enforce consistent ordered list style";
+                readonly url: string;
+                readonly recommended: false;
+                readonly stylistic: true;
+            };
+            readonly schema: [{
+                readonly type: "object";
+                readonly properties: {
+                    readonly style: {
+                        readonly enum: ["one-or-ordered", "one", "ordered", "zero"];
+                    };
+                };
+                readonly additionalProperties: false;
+            }];
+            readonly defaultOptions: [{
+                readonly style: "one-or-ordered";
+            }];
+            readonly messages: {
+                readonly style: "Ordered list style should be `{{ style }}`.";
+            };
+            readonly language: "markdown";
+            readonly dialects: ["commonmark", "gfm"];
+        };
+        readonly create: (context: import("../core/types.js").RuleContext<{
+            RuleOptions: [{
+                style: "one-or-ordered" | ("one" | "ordered" | "zero");
+            }];
+            MessageIds: "style";
+        }>) => {
+            'list[ordered=true]'(): void;
+            'list[ordered=true] > listItem'(node: import("mdast").ListItem): void;
+            'list[ordered=true]:exit'(): void;
+        };
+    };
     'consistent-strong-style': {
         readonly meta: {
             readonly type: "layout";
@@ -838,6 +876,12 @@ declare const _default: {
                     readonly skipInlineCode: {
                         readonly type: "boolean";
                     };
+                    readonly skipMath: {
+                        readonly type: "boolean";
+                    };
+                    readonly skipInlineMath: {
+                        readonly type: "boolean";
+                    };
                 };
                 readonly additionalProperties: false;
             }];
@@ -845,6 +889,8 @@ declare const _default: {
                 readonly allow: [];
                 readonly skipCode: true;
                 readonly skipInlineCode: true;
+                readonly skipMath: false;
+                readonly skipInlineMath: false;
             }];
             readonly messages: {
                 readonly noControlCharacter: "Control character `{{ controlCharacter }}` is not allowed.";
@@ -858,11 +904,15 @@ declare const _default: {
                 allow: string[];
                 skipCode: boolean | string[];
                 skipInlineCode: boolean;
+                skipMath: boolean;
+                skipInlineMath: boolean;
             }];
             MessageIds: "noControlCharacter" | "suggestRemove";
         }>) => {
             code(node: import("mdast").Code): void;
             inlineCode(node: import("mdast").InlineCode): void;
+            math(node: import("mdast-util-math").Math): void;
+            inlineMath(node: import("mdast-util-math").InlineMath): void;
             'root:exit'(): void;
         };
     };

package/build/rules/index.js

@@ -9,6 +9,7 @@ import consistentDeleteStyle from './consistent-delete-style.js';
 import consistentEmphasisStyle from './consistent-emphasis-style.js';
 import consistentHeadingStyle from './consistent-heading-style.js';
 import consistentInlineCodeStyle from './consistent-inline-code-style.js';
+import consistentOrderedListStyle from './consistent-ordered-list-style.js';
 import consistentStrongStyle from './consistent-strong-style.js';
 import consistentThematicBreakStyle from './consistent-thematic-break-style.js';
 import consistentUnorderedListStyle from './consistent-unordered-list-style.js';
@@ -40,6 +41,7 @@ export default {
     'consistent-emphasis-style': consistentEmphasisStyle,
     'consistent-heading-style': consistentHeadingStyle,
     'consistent-inline-code-style': consistentInlineCodeStyle,
+    'consistent-ordered-list-style': consistentOrderedListStyle,
     'consistent-strong-style': consistentStrongStyle,
     'consistent-thematic-break-style': consistentThematicBreakStyle,
     'consistent-unordered-list-style': consistentUnorderedListStyle,

package/build/rules/no-control-character.d.ts

@@ -24,6 +24,16 @@ type RuleOptions = [
          * @default true
          */
         skipInlineCode: boolean;
+        /**
+         * `true` allows control characters in all math blocks.
+         * @default false
+         */
+        skipMath: boolean;
+        /**
+         * `true` allows control characters in all inline math.
+         * @default false
+         */
+        skipInlineMath: boolean;
     }
 ];
 type MessageIds = 'noControlCharacter' | 'suggestRemove';
@@ -61,6 +71,12 @@ declare const _default: {
                 readonly skipInlineCode: {
                     readonly type: "boolean";
                 };
+                readonly skipMath: {
+                    readonly type: "boolean";
+                };
+                readonly skipInlineMath: {
+                    readonly type: "boolean";
+                };
             };
             readonly additionalProperties: false;
         }];
@@ -68,6 +84,8 @@ declare const _default: {
             readonly allow: [];
             readonly skipCode: true;
             readonly skipInlineCode: true;
+            readonly skipMath: false;
+            readonly skipInlineMath: false;
         }];
         readonly messages: {
             readonly noControlCharacter: "Control character `{{ controlCharacter }}` is not allowed.";
@@ -82,6 +100,8 @@ declare const _default: {
     }>) => {
         code(node: import("mdast").Code): void;
         inlineCode(node: import("mdast").InlineCode): void;
+        math(node: import("mdast-util-math").Math): void;
+        inlineMath(node: import("mdast-util-math").InlineMath): void;
         'root:exit'(): void;
     };
 };

package/build/rules/no-control-character.js

@@ -53,6 +53,12 @@ export default {
                     skipInlineCode: {
                         type: 'boolean',
                     },
+                    skipMath: {
+                        type: 'boolean',
+                    },
+                    skipInlineMath: {
+                        type: 'boolean',
+                    },
                 },
                 additionalProperties: false,
             },
@@ -62,6 +68,8 @@ export default {
                 allow: [],
                 skipCode: true,
                 skipInlineCode: true,
+                skipMath: false,
+                skipInlineMath: false,
             },
         ],
         messages: {
@@ -73,7 +81,7 @@ export default {
     },
     create(context) {
         const { sourceCode } = context;
-        const [{ allow, skipCode, skipInlineCode }] = context.options;
+        const [{ allow, skipCode, skipInlineCode, skipMath, skipInlineMath }] = context.options;
         const skipRanges = new SkipRanges();
         return {
             code(node) {
@@ -84,6 +92,14 @@ export default {
                 if (skipInlineCode)
                     skipRanges.push(sourceCode.getRange(node)); // Store range information of `InlineCode`.
             },
+            math(node) {
+                if (skipMath)
+                    skipRanges.push(sourceCode.getRange(node)); // Store range information of `Math`.
+            },
+            inlineMath(node) {
+                if (skipInlineMath)
+                    skipRanges.push(sourceCode.getRange(node)); // Store range information of `InlineMath`.
+            },
             'root:exit'() {
                 const matches = sourceCode.text.matchAll(controlCharacterRegex);
                 for (const match of matches) {

package/build/rules/no-trailing-heading-punctuation.js

@@ -6,7 +6,7 @@
 // Import
 // --------------------------------------------------------------------------------
 import { escapeStringRegexp } from '../core/utils/index.js';
-import { URL_RULE_DOCS, punctuation as defaultPunctuation, escapedTrailingBackslashRegex, gemojiRegex, htmlEntityRegex, } from '../core/constants.js';
+import { URL_RULE_DOCS, punctuation as defaultPunctuation, asciiPunctuationRegex, escapedTrailingBackslashRegex, gemojiRegex, htmlEntityRegex, } from '../core/constants.js';
 // --------------------------------------------------------------------------------
 // Helper
 // --------------------------------------------------------------------------------
@@ -174,6 +174,8 @@ export default {
                                 Number(
                                 // When `leadingSpaces` is `''` (empty string), check for an escaped trailing backslash.
                                 !leadingSpaces &&
+                                    // The preceding backslash is an escape only when the punctuation is escapable.
+                                    asciiPunctuationRegex.test(trailingPunctuation[0]) &&
                                     escapedTrailingBackslashRegex.test(lastChildText.slice(0, -trailingPunctuation.length))),
                             endOffset,
                         ]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-markdown",
-  "version": "0.18.1",
+  "version": "0.19.1",
   "type": "module",
   "sideEffects": false,
   "description": "Lint your Markdown with ESLint. Additional rules for use with `@eslint/markdown`.🛠️",
@@ -57,7 +57,7 @@
   },
   "scripts": {
     "prepublishOnly": "npm run build",
-    "build": "tsc -b tsconfig.build.json && node ../../scripts/build-config.js && tsc -b tsconfig.build.json && node ../../scripts/cp.js ../../LICENSE.md LICENSE.md ../../README.md README.md",
+    "build": "tsc -b tsconfig.build.json && node ../../scripts/build-config.js && tsc -b tsconfig.build.json",
     "test": "npm run test:types && npm run test:unit",
     "test:types": "tsc -b ./tsconfig.test-d.json",
     "test:unit": "vitest run"
@@ -79,7 +79,7 @@
     "@eslint/markdown": "^8.0.3",
     "@types/mdast": "^4.0.4",
     "@types/unist": "^3.0.3",
-    "eslint": "^9.39.5",
+    "eslint": "^10.13.0",
     "vitest": "^4.1.9"
   }
 }

package/build/rules/endline-punctuation.d.ts

@@ -1 +0,0 @@
-export {};

package/build/rules/endline-punctuation.js

@@ -1,2 +0,0 @@
-export {};
-// TODO

package/build/rules/glossary.d.ts

@@ -1 +0,0 @@
-export {};

package/build/rules/glossary.js

@@ -1,7 +0,0 @@
-export {};
-// TODO
-// - string: string
-// - string: RegExp
-// - string: string[]
-// - string: RegExp[]
-// - string: { src: string | RegExp | string[] | RegExp[] }

package/build/rules/no-unmatched-pair.d.ts

@@ -1 +0,0 @@
-export {};

package/build/rules/no-unmatched-pair.js

@@ -1,2 +0,0 @@
-export {};
-// TODO