eslint-markdown 0.11.1 → 0.12.1

package/build/configs/all.d.ts

@@ -16,6 +16,7 @@ export default function all(plugin: ESLint.Plugin): {
     };
     readonly language: "markdown/gfm";
     readonly rules: {
+        readonly 'md/allow-heading': "error";
         readonly 'md/allow-image-url': "error";
         readonly 'md/allow-link-url': "error";
         readonly 'md/code-lang-shorthand': "error";

package/build/configs/all.js

@@ -24,6 +24,7 @@ export default function all(plugin) {
         },
         language: 'markdown/gfm',
         rules: {
+            'md/allow-heading': 'error',
             'md/allow-image-url': 'error',
             'md/allow-link-url': 'error',
             'md/code-lang-shorthand': 'error',

package/build/core/{ast → utils}/index.d.ts

@@ -2,4 +2,5 @@ import escapeStringRegexp from './escape-string-regexp.js';
 import getElementsByTagName from './html.js';
 import isBlankLine from './is-blank-line.js';
 import SkipRanges from './skip-ranges.js';
-export { escapeStringRegexp, getElementsByTagName, isBlankLine, SkipRanges };
+import testRegexStateless from './test-regex-stateless.js';
+export { escapeStringRegexp, getElementsByTagName, isBlankLine, SkipRanges, testRegexStateless, };

package/build/core/{ast → utils}/index.js

@@ -2,4 +2,5 @@ import escapeStringRegexp from './escape-string-regexp.js';
 import getElementsByTagName from './html.js';
 import isBlankLine from './is-blank-line.js';
 import SkipRanges from './skip-ranges.js';
-export { escapeStringRegexp, getElementsByTagName, isBlankLine, SkipRanges };
+import testRegexStateless from './test-regex-stateless.js';
+export { escapeStringRegexp, getElementsByTagName, isBlankLine, SkipRanges, testRegexStateless, };

package/build/core/utils/test-regex-stateless.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Utility to test a regular expression without mutating its state.
+ */
+/**
+ * Tests a regex without mutating the state stored in its `lastIndex`.
+ * @param regex Regex to test.
+ * @param text Text to test.
+ * @returns Whether the regex matches the text.
+ */
+export default function testRegexStateless(regex: RegExp, text: string): boolean;

package/build/core/utils/test-regex-stateless.js

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Utility to test a regular expression without mutating its state.
+ */
+// --------------------------------------------------------------------------------
+// Helper
+// --------------------------------------------------------------------------------
+const statefulRegexFlagRegex = /[gy]/u;
+// --------------------------------------------------------------------------------
+// Export
+// --------------------------------------------------------------------------------
+/**
+ * Tests a regex without mutating the state stored in its `lastIndex`.
+ * @param regex Regex to test.
+ * @param text Text to test.
+ * @returns Whether the regex matches the text.
+ */
+export default function testRegexStateless(regex, text) {
+    return statefulRegexFlagRegex.test(regex.flags)
+        ? new RegExp(regex).test(text)
+        : regex.test(text);
+}

package/build/index.d.ts

@@ -8,6 +8,184 @@ declare const plugin: {
         readonly version: string;
     };
     readonly rules: {
+        'allow-heading': {
+            readonly meta: {
+                readonly type: "problem";
+                readonly docs: {
+                    readonly description: "Enforce the use of allowed or disallowed headings";
+                    readonly url: string;
+                    readonly recommended: false;
+                    readonly stylistic: false;
+                };
+                readonly schema: [{
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly h1: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly allow: {
+                                    readonly type: "array";
+                                    readonly items: {
+                                        readonly type: "object";
+                                    };
+                                    readonly uniqueItems: true;
+                                };
+                                readonly disallow: {
+                                    readonly type: "array";
+                                    readonly items: {
+                                        readonly type: "object";
+                                    };
+                                    readonly uniqueItems: true;
+                                };
+                            };
+                            readonly additionalProperties: false;
+                        };
+                        readonly h2: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly allow: {
+                                    readonly type: "array";
+                                    readonly items: {
+                                        readonly type: "object";
+                                    };
+                                    readonly uniqueItems: true;
+                                };
+                                readonly disallow: {
+                                    readonly type: "array";
+                                    readonly items: {
+                                        readonly type: "object";
+                                    };
+                                    readonly uniqueItems: true;
+                                };
+                            };
+                            readonly additionalProperties: false;
+                        };
+                        readonly h3: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly allow: {
+                                    readonly type: "array";
+                                    readonly items: {
+                                        readonly type: "object";
+                                    };
+                                    readonly uniqueItems: true;
+                                };
+                                readonly disallow: {
+                                    readonly type: "array";
+                                    readonly items: {
+                                        readonly type: "object";
+                                    };
+                                    readonly uniqueItems: true;
+                                };
+                            };
+                            readonly additionalProperties: false;
+                        };
+                        readonly h4: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly allow: {
+                                    readonly type: "array";
+                                    readonly items: {
+                                        readonly type: "object";
+                                    };
+                                    readonly uniqueItems: true;
+                                };
+                                readonly disallow: {
+                                    readonly type: "array";
+                                    readonly items: {
+                                        readonly type: "object";
+                                    };
+                                    readonly uniqueItems: true;
+                                };
+                            };
+                            readonly additionalProperties: false;
+                        };
+                        readonly h5: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly allow: {
+                                    readonly type: "array";
+                                    readonly items: {
+                                        readonly type: "object";
+                                    };
+                                    readonly uniqueItems: true;
+                                };
+                                readonly disallow: {
+                                    readonly type: "array";
+                                    readonly items: {
+                                        readonly type: "object";
+                                    };
+                                    readonly uniqueItems: true;
+                                };
+                            };
+                            readonly additionalProperties: false;
+                        };
+                        readonly h6: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly allow: {
+                                    readonly type: "array";
+                                    readonly items: {
+                                        readonly type: "object";
+                                    };
+                                    readonly uniqueItems: true;
+                                };
+                                readonly disallow: {
+                                    readonly type: "array";
+                                    readonly items: {
+                                        readonly type: "object";
+                                    };
+                                    readonly uniqueItems: true;
+                                };
+                            };
+                            readonly additionalProperties: false;
+                        };
+                    };
+                    readonly additionalProperties: false;
+                }];
+                readonly defaultOptions: [{
+                    readonly h1: {
+                        readonly allow: [RegExp];
+                        readonly disallow: [];
+                    };
+                    readonly h2: {
+                        readonly allow: [RegExp];
+                        readonly disallow: [];
+                    };
+                    readonly h3: {
+                        readonly allow: [RegExp];
+                        readonly disallow: [];
+                    };
+                    readonly h4: {
+                        readonly allow: [RegExp];
+                        readonly disallow: [];
+                    };
+                    readonly h5: {
+                        readonly allow: [RegExp];
+                        readonly disallow: [];
+                    };
+                    readonly h6: {
+                        readonly allow: [RegExp];
+                        readonly disallow: [];
+                    };
+                }];
+                readonly messages: {
+                    readonly allowHeading: "The level {{ depth }} heading `{{ heading }}` is not in the list of allowed headings. (Allow: {{ allow }}).";
+                    readonly disallowHeading: "The level {{ depth }} heading `{{ heading }}` is in the list of disallowed headings. (Disallow: {{ disallow }}).";
+                };
+                readonly language: "markdown";
+                readonly dialects: ["commonmark", "gfm"];
+            };
+            readonly create: (context: import("@eslint/core").RuleContext<{
+                LangOptions: import("@eslint/markdown").MarkdownLanguageOptions;
+                Code: import("@eslint/markdown").MarkdownSourceCode;
+                RuleOptions: [Record<"h1" | "h2" | "h3" | "h4" | "h5" | "h6", import("./rules/allow-heading.js").HeadingOptions>];
+                Node: import("mdast").Node;
+                MessageIds: "allowHeading" | "disallowHeading";
+            }>) => {
+                heading(node: import("mdast").Heading): void;
+            };
+        };
         'allow-image-url': {
             readonly meta: {
                 readonly type: "problem";

package/build/rules/allow-heading.d.ts

@@ -1,14 +1,19 @@
 /**
- * @fileoverview Rule to enforce the use of allowed text for headings.
+ * @fileoverview Rule to enforce the use of allowed or disallowed headings.
  * @author lumir(lumirlumir)
  */
-type RuleOptions = [Record<'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6', false | string[]>];
-type MessageIds = 'allowHeading' | 'allowHeadingDepth';
+import type { Heading } from 'mdast';
+export interface HeadingOptions {
+    allow: RegExp[];
+    disallow: RegExp[];
+}
+type RuleOptions = [Record<`h${Heading['depth']}`, HeadingOptions>];
+type MessageIds = 'allowHeading' | 'disallowHeading';
 declare const _default: {
     readonly meta: {
         readonly type: "problem";
         readonly docs: {
-            readonly description: "Enforce the use of allowed text for headings";
+            readonly description: "Enforce the use of allowed or disallowed headings";
             readonly url: string;
             readonly recommended: false;
             readonly stylistic: false;
@@ -17,85 +22,157 @@ declare const _default: {
             readonly type: "object";
             readonly properties: {
                 readonly h1: {
-                    readonly oneOf: [{
-                        readonly enum: [false];
-                    }, {
-                        readonly type: "array";
-                        readonly items: {
-                            readonly type: "string";
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly allow: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "object";
+                            };
+                            readonly uniqueItems: true;
                         };
-                        readonly uniqueItems: true;
-                    }];
+                        readonly disallow: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "object";
+                            };
+                            readonly uniqueItems: true;
+                        };
+                    };
+                    readonly additionalProperties: false;
                 };
                 readonly h2: {
-                    readonly oneOf: [{
-                        readonly enum: [false];
-                    }, {
-                        readonly type: "array";
-                        readonly items: {
-                            readonly type: "string";
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly allow: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "object";
+                            };
+                            readonly uniqueItems: true;
+                        };
+                        readonly disallow: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "object";
+                            };
+                            readonly uniqueItems: true;
                         };
-                        readonly uniqueItems: true;
-                    }];
+                    };
+                    readonly additionalProperties: false;
                 };
                 readonly h3: {
-                    readonly oneOf: [{
-                        readonly enum: [false];
-                    }, {
-                        readonly type: "array";
-                        readonly items: {
-                            readonly type: "string";
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly allow: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "object";
+                            };
+                            readonly uniqueItems: true;
+                        };
+                        readonly disallow: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "object";
+                            };
+                            readonly uniqueItems: true;
                         };
-                        readonly uniqueItems: true;
-                    }];
+                    };
+                    readonly additionalProperties: false;
                 };
                 readonly h4: {
-                    readonly oneOf: [{
-                        readonly enum: [false];
-                    }, {
-                        readonly type: "array";
-                        readonly items: {
-                            readonly type: "string";
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly allow: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "object";
+                            };
+                            readonly uniqueItems: true;
                         };
-                        readonly uniqueItems: true;
-                    }];
+                        readonly disallow: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "object";
+                            };
+                            readonly uniqueItems: true;
+                        };
+                    };
+                    readonly additionalProperties: false;
                 };
                 readonly h5: {
-                    readonly oneOf: [{
-                        readonly enum: [false];
-                    }, {
-                        readonly type: "array";
-                        readonly items: {
-                            readonly type: "string";
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly allow: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "object";
+                            };
+                            readonly uniqueItems: true;
+                        };
+                        readonly disallow: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "object";
+                            };
+                            readonly uniqueItems: true;
                         };
-                        readonly uniqueItems: true;
-                    }];
+                    };
+                    readonly additionalProperties: false;
                 };
                 readonly h6: {
-                    readonly oneOf: [{
-                        readonly enum: [false];
-                    }, {
-                        readonly type: "array";
-                        readonly items: {
-                            readonly type: "string";
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly allow: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "object";
+                            };
+                            readonly uniqueItems: true;
+                        };
+                        readonly disallow: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "object";
+                            };
+                            readonly uniqueItems: true;
                         };
-                        readonly uniqueItems: true;
-                    }];
+                    };
+                    readonly additionalProperties: false;
                 };
             };
             readonly additionalProperties: false;
         }];
         readonly defaultOptions: [{
-            readonly h1: false;
-            readonly h2: false;
-            readonly h3: false;
-            readonly h4: false;
-            readonly h5: false;
-            readonly h6: false;
+            readonly h1: {
+                readonly allow: [RegExp];
+                readonly disallow: [];
+            };
+            readonly h2: {
+                readonly allow: [RegExp];
+                readonly disallow: [];
+            };
+            readonly h3: {
+                readonly allow: [RegExp];
+                readonly disallow: [];
+            };
+            readonly h4: {
+                readonly allow: [RegExp];
+                readonly disallow: [];
+            };
+            readonly h5: {
+                readonly allow: [RegExp];
+                readonly disallow: [];
+            };
+            readonly h6: {
+                readonly allow: [RegExp];
+                readonly disallow: [];
+            };
         }];
         readonly messages: {
-            readonly allowHeading: "The heading text `{{ heading }}` is not allowed. Please use one of the following text: {{ allow }}.";
-            readonly allowHeadingDepth: "The heading depth `h{{ depth }}` is not allowed.";
+            readonly allowHeading: "The level {{ depth }} heading `{{ heading }}` is not in the list of allowed headings. (Allow: {{ allow }}).";
+            readonly disallowHeading: "The level {{ depth }} heading `{{ heading }}` is in the list of disallowed headings. (Disallow: {{ disallow }}).";
         };
         readonly language: "markdown";
         readonly dialects: ["commonmark", "gfm"];
@@ -107,7 +184,7 @@ declare const _default: {
         Node: import("mdast").Node;
         MessageIds: MessageIds;
     }>) => {
-        heading(node: import("mdast").Heading): void;
+        heading(node: Heading): void;
     };
 };
 export default _default;

package/build/rules/allow-heading.js

@@ -1,15 +1,32 @@
 /**
- * @fileoverview Rule to enforce the use of allowed text for headings.
+ * @fileoverview Rule to enforce the use of allowed or disallowed headings.
  * @author lumir(lumirlumir)
  */
-// --------------------------------------------------------------------------------
-// Import
-// --------------------------------------------------------------------------------
+import { testRegexStateless } from '../core/utils/index.js';
 import { URL_RULE_DOCS } from '../core/constants.js';
 // --------------------------------------------------------------------------------
-// Helpers
+// Helper
 // --------------------------------------------------------------------------------
-const headingRegex = /^#{1,6}\s+/u;
+const headingOptionsSchema = {
+    type: 'object',
+    properties: {
+        allow: {
+            type: 'array',
+            items: {
+                type: 'object',
+            },
+            uniqueItems: true,
+        },
+        disallow: {
+            type: 'array',
+            items: {
+                type: 'object',
+            },
+            uniqueItems: true,
+        },
+    },
+    additionalProperties: false,
+};
 // --------------------------------------------------------------------------------
 // Rule Definition
 // --------------------------------------------------------------------------------
@@ -17,7 +34,7 @@ export default {
     meta: {
         type: 'problem',
         docs: {
-            description: 'Enforce the use of allowed text for headings',
+            description: 'Enforce the use of allowed or disallowed headings',
             url: URL_RULE_DOCS('allow-heading'),
             recommended: false,
             stylistic: false,
@@ -26,100 +43,35 @@ export default {
             {
                 type: 'object',
                 properties: {
-                    h1: {
-                        oneOf: [
-                            {
-                                enum: [false],
-                            },
-                            {
-                                type: 'array',
-                                items: { type: 'string' },
-                                uniqueItems: true,
-                            },
-                        ],
-                    },
-                    h2: {
-                        oneOf: [
-                            {
-                                enum: [false],
-                            },
-                            {
-                                type: 'array',
-                                items: { type: 'string' },
-                                uniqueItems: true,
-                            },
-                        ],
-                    },
-                    h3: {
-                        oneOf: [
-                            {
-                                enum: [false],
-                            },
-                            {
-                                type: 'array',
-                                items: { type: 'string' },
-                                uniqueItems: true,
-                            },
-                        ],
-                    },
-                    h4: {
-                        oneOf: [
-                            {
-                                enum: [false],
-                            },
-                            {
-                                type: 'array',
-                                items: { type: 'string' },
-                                uniqueItems: true,
-                            },
-                        ],
-                    },
-                    h5: {
-                        oneOf: [
-                            {
-                                enum: [false],
-                            },
-                            {
-                                type: 'array',
-                                items: { type: 'string' },
-                                uniqueItems: true,
-                            },
-                        ],
-                    },
-                    h6: {
-                        oneOf: [
-                            {
-                                enum: [false],
-                            },
-                            {
-                                type: 'array',
-                                items: { type: 'string' },
-                                uniqueItems: true,
-                            },
-                        ],
-                    },
+                    h1: headingOptionsSchema,
+                    h2: headingOptionsSchema,
+                    h3: headingOptionsSchema,
+                    h4: headingOptionsSchema,
+                    h5: headingOptionsSchema,
+                    h6: headingOptionsSchema,
                 },
                 additionalProperties: false,
             },
         ],
         defaultOptions: [
             {
-                h1: false,
-                h2: false,
-                h3: false,
-                h4: false,
-                h5: false,
-                h6: false,
+                h1: { allow: [/.*/u], disallow: [] },
+                h2: { allow: [/.*/u], disallow: [] },
+                h3: { allow: [/.*/u], disallow: [] },
+                h4: { allow: [/.*/u], disallow: [] },
+                h5: { allow: [/.*/u], disallow: [] },
+                h6: { allow: [/.*/u], disallow: [] },
             },
         ],
         messages: {
-            allowHeading: 'The heading text `{{ heading }}` is not allowed. Please use one of the following text: {{ allow }}.',
-            allowHeadingDepth: 'The heading depth `h{{ depth }}` is not allowed.',
+            allowHeading: 'The level {{ depth }} heading `{{ heading }}` is not in the list of allowed headings. (Allow: {{ allow }}).',
+            disallowHeading: 'The level {{ depth }} heading `{{ heading }}` is in the list of disallowed headings. (Disallow: {{ disallow }}).',
         },
         language: 'markdown',
         dialects: ['commonmark', 'gfm'],
     },
     create(context) {
+        const { sourceCode } = context;
         const [{ h1, h2, h3, h4, h5, h6 }] = context.options;
         const headingMap = {
             1: h1,
@@ -131,28 +83,28 @@ export default {
         };
         return {
             heading(node) {
-                const actualHeadingText = context.sourceCode
-                    .getText(node)
-                    .replace(headingRegex, '');
-                const expectedHeadingTexts = headingMap[node.depth];
-                if (expectedHeadingTexts === false)
-                    return;
-                if (expectedHeadingTexts.length === 0) {
+                const { depth } = node;
+                const { allow, disallow } = headingMap[depth];
+                const headingText = sourceCode.getText(node);
+                if (!allow.some(regex => testRegexStateless(regex, headingText))) {
                     context.report({
                         node,
-                        messageId: 'allowHeadingDepth',
+                        messageId: 'allowHeading',
                         data: {
-                            depth: String(node.depth),
+                            depth,
+                            heading: headingText,
+                            allow: allow.map(regex => `\`${regex}\``).join(', '),
                         },
                     });
                 }
-                else if (!expectedHeadingTexts.includes(actualHeadingText)) {
+                if (disallow.some(regex => testRegexStateless(regex, headingText))) {
                     context.report({
                         node,
-                        messageId: 'allowHeading',
+                        messageId: 'disallowHeading',
                         data: {
-                            heading: actualHeadingText,
-                            allow: expectedHeadingTexts.map(text => `\`${text}\``).join(', '),
+                            depth,
+                            heading: headingText,
+                            disallow: disallow.map(regex => `\`${regex}\``).join(', '),
                         },
                     });
                 }

package/build/rules/allow-image-url.js

@@ -3,7 +3,7 @@
  * @author lumir(lumirlumir)
  */
 import { normalizeIdentifier } from 'micromark-util-normalize-identifier';
-import { getElementsByTagName } from '../core/ast/index.js';
+import { getElementsByTagName, testRegexStateless } from '../core/utils/index.js';
 import { URL_RULE_DOCS } from '../core/constants.js';
 // --------------------------------------------------------------------------------
 // Rule Definition
@@ -114,7 +114,7 @@ export default {
                  * Therefore, calling the `some` method on an empty array will always return `false`.
                  */
                 for (const { loc, url } of images) {
-                    if (!allowUrls.some(regex => regex.test(url))) {
+                    if (!allowUrls.some(regex => testRegexStateless(regex, url))) {
                         context.report({
                             loc,
                             messageId: 'allowImageUrl',
@@ -124,7 +124,7 @@ export default {
                             },
                         });
                     }
-                    if (disallowUrls.some(regex => regex.test(url))) {
+                    if (disallowUrls.some(regex => testRegexStateless(regex, url))) {
                         context.report({
                             loc,
                             messageId: 'disallowImageUrl',

package/build/rules/allow-link-url.js

@@ -3,7 +3,7 @@
  * @author lumir(lumirlumir)
  */
 import { normalizeIdentifier } from 'micromark-util-normalize-identifier';
-import { getElementsByTagName } from '../core/ast/index.js';
+import { getElementsByTagName, testRegexStateless } from '../core/utils/index.js';
 import { URL_RULE_DOCS } from '../core/constants.js';
 // --------------------------------------------------------------------------------
 // Rule Definition
@@ -114,7 +114,7 @@ export default {
                  * Therefore, calling the `some` method on an empty array will always return `false`.
                  */
                 for (const { loc, url } of links) {
-                    if (!allowUrls.some(regex => regex.test(url))) {
+                    if (!allowUrls.some(regex => testRegexStateless(regex, url))) {
                         context.report({
                             loc,
                             messageId: 'allowLinkUrl',
@@ -124,7 +124,7 @@ export default {
                             },
                         });
                     }
-                    if (disallowUrls.some(regex => regex.test(url))) {
+                    if (disallowUrls.some(regex => testRegexStateless(regex, url))) {
                         context.report({
                             loc,
                             messageId: 'disallowLinkUrl',

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

@@ -14,7 +14,7 @@
 // --------------------------------------------------------------------------------
 // Import
 // --------------------------------------------------------------------------------
-import { isBlankLine } from '../core/ast/index.js';
+import { isBlankLine } from '../core/utils/index.js';
 import { URL_RULE_DOCS } from '../core/constants.js';
 // --------------------------------------------------------------------------------
 // Helper

package/build/rules/index.d.ts

@@ -1,4 +1,182 @@
 declare const _default: {
+    'allow-heading': {
+        readonly meta: {
+            readonly type: "problem";
+            readonly docs: {
+                readonly description: "Enforce the use of allowed or disallowed headings";
+                readonly url: string;
+                readonly recommended: false;
+                readonly stylistic: false;
+            };
+            readonly schema: [{
+                readonly type: "object";
+                readonly properties: {
+                    readonly h1: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly allow: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                                readonly uniqueItems: true;
+                            };
+                            readonly disallow: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                                readonly uniqueItems: true;
+                            };
+                        };
+                        readonly additionalProperties: false;
+                    };
+                    readonly h2: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly allow: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                                readonly uniqueItems: true;
+                            };
+                            readonly disallow: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                                readonly uniqueItems: true;
+                            };
+                        };
+                        readonly additionalProperties: false;
+                    };
+                    readonly h3: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly allow: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                                readonly uniqueItems: true;
+                            };
+                            readonly disallow: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                                readonly uniqueItems: true;
+                            };
+                        };
+                        readonly additionalProperties: false;
+                    };
+                    readonly h4: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly allow: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                                readonly uniqueItems: true;
+                            };
+                            readonly disallow: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                                readonly uniqueItems: true;
+                            };
+                        };
+                        readonly additionalProperties: false;
+                    };
+                    readonly h5: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly allow: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                                readonly uniqueItems: true;
+                            };
+                            readonly disallow: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                                readonly uniqueItems: true;
+                            };
+                        };
+                        readonly additionalProperties: false;
+                    };
+                    readonly h6: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly allow: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                                readonly uniqueItems: true;
+                            };
+                            readonly disallow: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                                readonly uniqueItems: true;
+                            };
+                        };
+                        readonly additionalProperties: false;
+                    };
+                };
+                readonly additionalProperties: false;
+            }];
+            readonly defaultOptions: [{
+                readonly h1: {
+                    readonly allow: [RegExp];
+                    readonly disallow: [];
+                };
+                readonly h2: {
+                    readonly allow: [RegExp];
+                    readonly disallow: [];
+                };
+                readonly h3: {
+                    readonly allow: [RegExp];
+                    readonly disallow: [];
+                };
+                readonly h4: {
+                    readonly allow: [RegExp];
+                    readonly disallow: [];
+                };
+                readonly h5: {
+                    readonly allow: [RegExp];
+                    readonly disallow: [];
+                };
+                readonly h6: {
+                    readonly allow: [RegExp];
+                    readonly disallow: [];
+                };
+            }];
+            readonly messages: {
+                readonly allowHeading: "The level {{ depth }} heading `{{ heading }}` is not in the list of allowed headings. (Allow: {{ allow }}).";
+                readonly disallowHeading: "The level {{ depth }} heading `{{ heading }}` is in the list of disallowed headings. (Disallow: {{ disallow }}).";
+            };
+            readonly language: "markdown";
+            readonly dialects: ["commonmark", "gfm"];
+        };
+        readonly create: (context: import("@eslint/core").RuleContext<{
+            LangOptions: import("@eslint/markdown").MarkdownLanguageOptions;
+            Code: import("@eslint/markdown").MarkdownSourceCode;
+            RuleOptions: [Record<"h1" | "h2" | "h3" | "h4" | "h5" | "h6", import("./allow-heading.js").HeadingOptions>];
+            Node: import("mdast").Node;
+            MessageIds: "allowHeading" | "disallowHeading";
+        }>) => {
+            heading(node: import("mdast").Heading): void;
+        };
+    };
     'allow-image-url': {
         readonly meta: {
             readonly type: "problem";

package/build/rules/index.js

@@ -1,6 +1,6 @@
 /* eslint sort-imports: 'error', sort-keys: 'error' */
 // TODO: Re-enable the commented-out rules once they stabilize.
-// import allowHeading from './allow-heading.js';
+import allowHeading from './allow-heading.js';
 import allowImageUrl from './allow-image-url.js';
 import allowLinkUrl from './allow-link-url.js';
 import codeLangShorthand from './code-lang-shorthand.js';
@@ -28,7 +28,7 @@ import requireHeadingId from './require-heading-id.js';
 import requireImageTitle from './require-image-title.js';
 import requireLinkTitle from './require-link-title.js';
 export default {
-    // 'allow-heading': allowHeading,
+    'allow-heading': allowHeading,
     'allow-image-url': allowImageUrl,
     'allow-link-url': allowLinkUrl,
     'code-lang-shorthand': codeLangShorthand,

package/build/rules/no-consecutive-blank-line.js

@@ -6,7 +6,7 @@
 // --------------------------------------------------------------------------------
 // Import
 // --------------------------------------------------------------------------------
-import { isBlankLine, SkipRanges } from '../core/ast/index.js';
+import { isBlankLine, SkipRanges } from '../core/utils/index.js';
 import { URL_RULE_DOCS } from '../core/constants.js';
 // --------------------------------------------------------------------------------
 // Rule Definition

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

@@ -5,7 +5,7 @@
 // --------------------------------------------------------------------------------
 // Import
 // --------------------------------------------------------------------------------
-import { SkipRanges } from '../core/ast/index.js';
+import { SkipRanges } from '../core/utils/index.js';
 import { URL_RULE_DOCS } from '../core/constants.js';
 // --------------------------------------------------------------------------------
 // Helper

package/build/rules/no-git-conflict-marker.js

@@ -5,7 +5,7 @@
 // --------------------------------------------------------------------------------
 // Import
 // --------------------------------------------------------------------------------
-import { SkipRanges } from '../core/ast/index.js';
+import { SkipRanges } from '../core/utils/index.js';
 import { URL_RULE_DOCS } from '../core/constants.js';
 // --------------------------------------------------------------------------------
 // Helper

package/build/rules/no-irregular-dash.js

@@ -5,7 +5,7 @@
 // --------------------------------------------------------------------------------
 // Import
 // --------------------------------------------------------------------------------
-import { SkipRanges } from '../core/ast/index.js';
+import { SkipRanges } from '../core/utils/index.js';
 import { URL_RULE_DOCS } from '../core/constants.js';
 // --------------------------------------------------------------------------------
 // Helper

package/build/rules/no-irregular-whitespace.js

@@ -5,7 +5,7 @@
 // --------------------------------------------------------------------------------
 // Import
 // --------------------------------------------------------------------------------
-import { SkipRanges } from '../core/ast/index.js';
+import { SkipRanges } from '../core/utils/index.js';
 import { URL_RULE_DOCS } from '../core/constants.js';
 // --------------------------------------------------------------------------------
 // Helper

package/build/rules/no-tab.js

@@ -5,7 +5,7 @@
 // --------------------------------------------------------------------------------
 // Import
 // --------------------------------------------------------------------------------
-import { SkipRanges } from '../core/ast/index.js';
+import { SkipRanges } from '../core/utils/index.js';
 import { URL_RULE_DOCS } from '../core/constants.js';
 // --------------------------------------------------------------------------------
 // Helper

package/build/rules/no-url-trailing-slash.js

@@ -2,7 +2,7 @@
  * @fileoverview Rule to disallow URL trailing slash.
  * @author lumir(lumirlumir)
  */
-import { getElementsByTagName } from '../core/ast/index.js';
+import { getElementsByTagName } from '../core/utils/index.js';
 import { URL_RULE_DOCS } from '../core/constants.js';
 // --------------------------------------------------------------------------------
 // Helper

package/build/rules/require-heading-id.js

@@ -2,7 +2,7 @@
  * @fileoverview Rule to enforce the use of heading IDs.
  * @author lumir(lumirlumir)
  */
-import { escapeStringRegexp } from '../core/ast/index.js';
+import { escapeStringRegexp } from '../core/utils/index.js';
 import { URL_RULE_DOCS } from '../core/constants.js';
 // --------------------------------------------------------------------------------
 // Rule Definition

package/build/rules/require-image-title.js

@@ -3,7 +3,7 @@
  * @author lumir(lumirlumir)
  */
 import { normalizeIdentifier } from 'micromark-util-normalize-identifier';
-import { getElementsByTagName } from '../core/ast/index.js';
+import { getElementsByTagName } from '../core/utils/index.js';
 import { URL_RULE_DOCS } from '../core/constants.js';
 // --------------------------------------------------------------------------------
 // Rule Definition

package/build/rules/require-link-title.js

@@ -3,7 +3,7 @@
  * @author lumir(lumirlumir)
  */
 import { normalizeIdentifier } from 'micromark-util-normalize-identifier';
-import { getElementsByTagName } from '../core/ast/index.js';
+import { getElementsByTagName } from '../core/utils/index.js';
 import { URL_RULE_DOCS } from '../core/constants.js';
 // --------------------------------------------------------------------------------
 // Rule Definition

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-markdown",
-  "version": "0.11.1",
+  "version": "0.12.1",
   "type": "module",
   "sideEffects": false,
   "description": "Lint your Markdown with ESLint. Additional rules for use with `@eslint/markdown`.🛠️",