@bfra.me/eslint-config 0.39.1 → 0.41.0

package/lib/index.d.ts

@@ -1047,6 +1047,11 @@ interface Rules {
    * @see https://typescript-eslint.io/rules/no-unused-expressions
    */
   '@typescript-eslint/no-unused-expressions'?: Linter.RuleEntry<TypescriptEslintNoUnusedExpressions>
+  /**
+   * Disallow unused private class members
+   * @see https://typescript-eslint.io/rules/no-unused-private-class-members
+   */
+  '@typescript-eslint/no-unused-private-class-members'?: Linter.RuleEntry<[]>
   /**
    * Disallow unused variables
    * @see https://typescript-eslint.io/rules/no-unused-vars
@@ -9895,6 +9900,8 @@ type JsdocCheckExamples = []|[{
 // ----- jsdoc/check-indentation -----
 type JsdocCheckIndentation = []|[{
   
+  allowIndentedSections?: boolean
+  
   excludeTags?: string[]
 }]
 // ----- jsdoc/check-line-alignment -----
@@ -16477,9 +16484,12 @@ type ConfigNames =
   | '@bfra.me/jsonc'
   | '@bfra.me/markdown/plugin'
   | '@bfra.me/markdown/processor'
-  | '@bfra.me/markdown/code-blocks'
+  | '@bfra.me/markdown/parser'
   | '@bfra.me/markdown/disabled'
   | '@bfra.me/markdown/overrides'
+  | '@bfra.me/markdown/code-blocks/typescript-javascript'
+  | '@bfra.me/markdown/code-blocks/json'
+  | '@bfra.me/markdown/code-blocks/yaml'
   | '@bfra.me/nextjs/setup'
   | '@bfra.me/nextjs/rules'
   | '@bfra.me/node'
@@ -16657,13 +16667,156 @@ type JsoncOptions = Flatten<OptionsFiles & OptionsOverrides & OptionsStylistic>;
 declare function jsonc(options?: JsoncOptions): Promise<Config[]>;
 
 /**
- * Represents the options for configuring Markdown files in the ESLint configuration.
+ * Markdown language mode for parsing.
+ *
+ * - `commonmark`: Standard CommonMark - strict, portable, widely compatible
+ * - `gfm`: GitHub Flavored Markdown - adds tables, task lists, strikethrough, autolinks
+ *
+ * @example
+ * ```typescript
+ * // Use CommonMark for maximum portability
+ * defineConfig({ markdown: { language: 'commonmark' } })
+ *
+ * // Use GFM for documentation sites
+ * defineConfig({ markdown: { language: 'gfm' } })
+ * ```
+ *
+ * @see {@link https://commonmark.org/ | CommonMark Specification}
+ * @see {@link https://github.github.com/gfm/ | GitHub Flavored Markdown Specification}
  */
-type MarkdownOptions = Flatten<OptionsFiles & OptionsOverrides>;
+type MarkdownLanguage = 'commonmark' | 'gfm';
 /**
- * Configures the ESLint rules for Markdown files.
- * @param options - The configuration options for Markdown files.
- * @see https://eslint.github.io/eslint-plugin-markdown/
+ * Frontmatter format options for Markdown files.
+ *
+ * Frontmatter is metadata at the beginning of a file, commonly used in static site generators.
+ * When enabled, the parser extracts and validates the frontmatter block.
+ *
+ * @example
+ * ```typescript
+ * // YAML frontmatter (most common)
+ * defineConfig({ markdown: { frontmatter: 'yaml' } })
+ *
+ * // TOML frontmatter
+ * defineConfig({ markdown: { frontmatter: 'toml' } })
+ *
+ * // Disable frontmatter parsing
+ * defineConfig({ markdown: { frontmatter: false } })
+ * ```
+ */
+type MarkdownFrontmatterOptions = false | 'yaml' | 'toml' | 'json';
+/**
+ * Code block processing configuration for Markdown files.
+ *
+ * Configure which languages are extracted and linted from code blocks,
+ * including TypeScript, JavaScript, JSX, TSX, JSON, and YAML.
+ *
+ * @example
+ * ```typescript
+ * defineConfig({
+ *   markdown: {
+ *     codeBlocks: { typescript: true, javascript: true }
+ *   }
+ * })
+ * ```
+ */
+interface MarkdownCodeBlockOptions {
+    /**
+     * Enable TypeScript code block processing.
+     *
+     * @default true
+     */
+    typescript?: boolean;
+    /**
+     * Enable JavaScript code block processing.
+     *
+     * @default true
+     */
+    javascript?: boolean;
+    /**
+     * Enable JSX code block processing.
+     *
+     * @default true
+     */
+    jsx?: boolean;
+    /**
+     * Enable JSON code block processing.
+     *
+     * @default true
+     */
+    json?: boolean;
+    /**
+     * Enable YAML code block processing.
+     *
+     * @default true
+     */
+    yaml?: boolean;
+}
+/**
+ * Configuration options for Markdown linting.
+ *
+ * Provides control over Markdown parsing, frontmatter handling, code block extraction,
+ * and rule configuration. Supports CommonMark and GitHub Flavored Markdown with optional
+ * TypeScript-ESLint integration for code blocks.
+ *
+ * @example
+ * ```typescript
+ * // Documentation site with GFM and YAML frontmatter
+ * defineConfig({
+ *   markdown: {
+ *     language: 'gfm',
+ *     frontmatter: 'yaml',
+ *     codeBlocks: { typescript: true, javascript: true }
+ *   }
+ * })
+ *
+ * // Simple README files
+ * defineConfig({
+ *   markdown: {
+ *     language: 'commonmark',
+ *     frontmatter: false,
+ *     files: ['README.md']
+ *   }
+ * })
+ * ```
+ *
+ * @see {@link https://github.com/eslint/markdown | @eslint/markdown}
+ */
+interface MarkdownOptions extends Flatten<OptionsFiles & OptionsOverrides> {
+    /**
+     * Markdown language mode.
+     *
+     * Choose between CommonMark (standard) and GitHub Flavored Markdown (GFM).
+     * GFM adds tables, task lists, strikethrough, and autolinks.
+     *
+     * @default 'gfm'
+     */
+    language?: MarkdownLanguage;
+    /**
+     * Frontmatter format to parse from Markdown files.
+     *
+     * Frontmatter is metadata at the beginning of a file, commonly used in static site generators.
+     * Set to `false` to disable frontmatter parsing.
+     *
+     * @default 'yaml'
+     */
+    frontmatter?: MarkdownFrontmatterOptions;
+    /**
+     * Code block processing configuration.
+     *
+     * Configure which languages are extracted and linted from code blocks.
+     *
+     * @default true (enables all supported languages)
+     */
+    codeBlocks?: boolean | MarkdownCodeBlockOptions;
+}
+/**
+ * Configures ESLint rules for Markdown files with support for CommonMark/GFM,
+ * frontmatter parsing, and optional code block extraction.
+ *
+ * @param options - Configuration options for Markdown linting
+ * @returns ESLint configuration array
+ *
+ * @see {@link https://github.com/eslint/markdown | @eslint/markdown}
  */
 declare function markdown(options?: MarkdownOptions): Promise<Config[]>;
 
@@ -17094,8 +17247,29 @@ type Options = Flatten<{
     jsx?: boolean;
     /**
      * Options to override the behavior of linting Markdown files.
+     *
+     * @remarks
+     * Enable comprehensive Markdown linting with support for CommonMark and GitHub Flavored Markdown,
+     * frontmatter parsing, and code block extraction.
+     *
+     * @example
+     * ```typescript
+     * // Enable with defaults
+     * const config = defineConfig({ markdown: true });
+     *
+     * // Documentation site configuration
+     * const config = defineConfig({
+     *   markdown: {
+     *     language: 'gfm',
+     *     frontmatter: 'yaml',
+     *     processor: { enabled: true, extractCodeBlocks: true }
+     *   }
+     * });
+     * ```
+     *
+     * @default true
      */
-    markdown?: boolean | OptionsOverrides;
+    markdown?: boolean | MarkdownOptions;
     /**
      * Enable Next.js support.
      *
@@ -17232,9 +17406,10 @@ declare const isInEditor: boolean;
 
 declare const GLOB_SRC_EXT = "?([cm])[jt]s?(x)";
 declare const GLOB_SRC = "**/*.?([cm])[jt]s?(x)";
+declare const GLOB_JS = "**/*.?([cm])js";
 declare const GLOB_JSX = "**/*.?([cm])jsx";
 declare const GLOB_TS = "**/*.?([cm])ts";
-declare const GLOB_TSX = "**/*.tsx";
+declare const GLOB_TSX = "**/*.?([cm])tsx";
 declare const GLOB_JSON = "**/*.json";
 declare const GLOB_JSON5 = "**/*.json5";
 declare const GLOB_JSONC = "**/*.jsonc";
@@ -17259,4 +17434,4 @@ declare const GLOB_EXCLUDE: string[];
 
 declare const config: eslint_flat_config_utils.FlatConfigComposer<Config, ConfigNames>;
 
-export { type AstroOptions, type Config, type ConfigNames, type FallbackOptions, type Flatten, GLOB_ASTRO, GLOB_ASTRO_TS, GLOB_CODE_IN_MARKDOWN_FILES, GLOB_EXCLUDE, GLOB_EXT_IN_MARKDOWN_FILES, GLOB_JSON, GLOB_JSON5, GLOB_JSONC, GLOB_JSON_FILES, GLOB_JSX, GLOB_MARKDOWN, GLOB_MARKDOWN_CODE, GLOB_MARKDOWN_FILES, GLOB_MARKDOWN_IN_MARKDOWN, GLOB_PACKAGE_JSON_FILES, GLOB_RENOVATE_CONFIG, GLOB_SRC, GLOB_SRC_EXT, GLOB_TESTS, GLOB_TOML, GLOB_TOML_FILES, GLOB_TS, GLOB_TSX, GLOB_TS_CONFIG, GLOB_YAML, GLOB_YAML_FILES, type ImportsOptions, type JSDocOptions, type JavaScriptOptions, type JsoncOptions, type MarkdownOptions, type NextjsOptions, type Options, type OptionsFiles, type OptionsIsInEditor, type OptionsOverrides, type OptionsPerfectionist, type OptionsStylistic, type OptionsTypeScript, type OptionsTypeScriptErasableSyntaxOnly, type OptionsTypeScriptParserOptions, type OptionsTypeScriptWithTypes, type PackageJsonOptions, type PerfectionistOptions, type PrettierOptions, type ReactOptions, type RegexpOptions, type Rules, type StylisticConfig, type StylisticOptions, type TomlOptions, type TypeScriptOptions, type UnicornOptions, type VitestOptions, type YamlOptions, astro, command, composeConfig, config, config as default, defineConfig, epilogue, eslintComments, fallback, gitignore, ignores, imports, isInEditor, isInGitLifecycle, javascript, jsdoc, jsonc, markdown, nextjs, node, packageJson, perfectionist, pnpm, prettier, react, regexp, sortPackageJson, sortRenovateConfig, sortTsconfig, stylistic, toml, typescript, unicorn, vitest, yaml };
+export { type AstroOptions, type Config, type ConfigNames, type FallbackOptions, type Flatten, GLOB_ASTRO, GLOB_ASTRO_TS, GLOB_CODE_IN_MARKDOWN_FILES, GLOB_EXCLUDE, GLOB_EXT_IN_MARKDOWN_FILES, GLOB_JS, GLOB_JSON, GLOB_JSON5, GLOB_JSONC, GLOB_JSON_FILES, GLOB_JSX, GLOB_MARKDOWN, GLOB_MARKDOWN_CODE, GLOB_MARKDOWN_FILES, GLOB_MARKDOWN_IN_MARKDOWN, GLOB_PACKAGE_JSON_FILES, GLOB_RENOVATE_CONFIG, GLOB_SRC, GLOB_SRC_EXT, GLOB_TESTS, GLOB_TOML, GLOB_TOML_FILES, GLOB_TS, GLOB_TSX, GLOB_TS_CONFIG, GLOB_YAML, GLOB_YAML_FILES, type ImportsOptions, type JSDocOptions, type JavaScriptOptions, type JsoncOptions, type MarkdownCodeBlockOptions, type MarkdownFrontmatterOptions, type MarkdownLanguage, type MarkdownOptions, type NextjsOptions, type Options, type OptionsFiles, type OptionsIsInEditor, type OptionsOverrides, type OptionsPerfectionist, type OptionsStylistic, type OptionsTypeScript, type OptionsTypeScriptErasableSyntaxOnly, type OptionsTypeScriptParserOptions, type OptionsTypeScriptWithTypes, type PackageJsonOptions, type PerfectionistOptions, type PrettierOptions, type ReactOptions, type RegexpOptions, type Rules, type StylisticConfig, type StylisticOptions, type TomlOptions, type TypeScriptOptions, type UnicornOptions, type VitestOptions, type YamlOptions, astro, command, composeConfig, config, config as default, defineConfig, epilogue, eslintComments, fallback, gitignore, ignores, imports, isInEditor, isInGitLifecycle, javascript, jsdoc, jsonc, markdown, nextjs, node, packageJson, perfectionist, pnpm, prettier, react, regexp, sortPackageJson, sortRenovateConfig, sortTsconfig, stylistic, toml, typescript, unicorn, vitest, yaml };

package/lib/index.js

@@ -8,9 +8,10 @@ var composeConfig = (...configs) => composer(...configs);
 // src/globs.ts
 var GLOB_SRC_EXT = "?([cm])[jt]s?(x)";
 var GLOB_SRC = "**/*.?([cm])[jt]s?(x)";
+var GLOB_JS = "**/*.?([cm])js";
 var GLOB_JSX = "**/*.?([cm])jsx";
 var GLOB_TS = "**/*.?([cm])ts";
-var GLOB_TSX = "**/*.tsx";
+var GLOB_TSX = "**/*.?([cm])tsx";
 var GLOB_JSON = "**/*.json";
 var GLOB_JSON5 = "**/*.json5";
 var GLOB_JSONC = "**/*.jsonc";
@@ -30,7 +31,13 @@ var GLOB_CODE_IN_MARKDOWN_FILES = GLOB_MARKDOWN_FILES.flatMap((p) => [
   `${p}/*.ts`,
   `${p}/*.tsx`,
   `${p}/*.cts`,
-  `${p}/*.mts`
+  `${p}/*.mts`,
+  `${p}/*.json`,
+  `${p}/*.json5`,
+  `${p}/*.jsonc`,
+  `${p}/*.yaml`,
+  `${p}/*.yml`,
+  `${p}/*.toml`
 ]);
 var GLOB_EXT_IN_MARKDOWN_FILES = [
   ...GLOB_CODE_IN_MARKDOWN_FILES,
@@ -105,7 +112,7 @@ var GLOB_EXCLUDE = [
 import { fileURLToPath } from "url";
 
 // package.json
-var version = "0.39.1";
+var version = "0.41.0";
 
 // src/parsers/any-parser.ts
 var lineBreakPattern = /\r\n|[\n\r\u2028\u2029]/u;
@@ -164,7 +171,7 @@ async function interopDefault(m) {
 
 // src/configs/fallback.ts
 async function fallback(missingList = [], options) {
-  const rules = await interopDefault(import("./missing-module-for-config-DNGJUDHU.js"));
+  const rules = await interopDefault(import("./missing-module-for-config-QFYTX2KG.js"));
   const pluginName = `@bfra.me${missingList.length > 0 ? `/missing-modules-${missingList.map((m) => m.replaceAll(/[^a-z0-9]/gi, "-").toLowerCase()).join("-")}` : ""}`;
   return [
     {
@@ -789,88 +796,196 @@ var plainParser = {
 
 // src/configs/markdown.ts
 async function markdown(options = {}) {
-  const { files = [GLOB_MARKDOWN], overrides = {} } = options;
-  return requireOf(
-    ["@eslint/markdown"],
-    async () => {
-      const markdown2 = await interopDefault(import("@eslint/markdown"));
-      return [
-        {
-          name: "@bfra.me/markdown/plugin",
-          plugins: {
-            markdown: markdown2
-          }
-        },
-        {
-          name: "@bfra.me/markdown/processor",
-          files,
-          ignores: [GLOB_MARKDOWN_IN_MARKDOWN],
-          // `eslint-plugin-markdown` only creates virtual files for code blocks,
-          // but not the markdown file itself. We use `eslint-merge-processors` to
-          // add a pass-through processor for the markdown file itself.
-          processor: mergeProcessors([markdown2.processors.markdown, processorPassThrough])
-        },
-        {
-          name: "@bfra.me/markdown/code-blocks",
-          files,
-          languageOptions: {
-            parser: plainParser
-          }
-        },
-        {
-          name: "@bfra.me/markdown/disabled",
-          files,
-          rules: {
-            "unicorn/filename-case": "off"
-          }
-        },
-        {
-          name: "@bfra.me/markdown/overrides",
-          files: [GLOB_MARKDOWN_CODE],
-          languageOptions: {
-            parserOptions: {
-              ecmaFeatures: {
-                impliedStrict: true
-              }
-            }
+  const {
+    codeBlocks = true,
+    files = [GLOB_MARKDOWN],
+    frontmatter = "yaml",
+    language = "gfm",
+    overrides = {}
+  } = options;
+  const markdown2 = await interopDefault(import("@eslint/markdown"));
+  const configs = [
+    {
+      name: "@bfra.me/markdown/plugin",
+      plugins: {
+        markdown: markdown2
+      }
+    },
+    {
+      name: "@bfra.me/markdown/processor",
+      files,
+      ignores: [GLOB_MARKDOWN_IN_MARKDOWN],
+      language: `markdown/${language}`,
+      processor: mergeProcessors([markdown2.processors.markdown, processorPassThrough]),
+      ...frontmatter !== false && {
+        languageOptions: { frontmatter }
+      }
+    },
+    {
+      name: "@bfra.me/markdown/parser",
+      files,
+      languageOptions: {
+        parser: plainParser
+      }
+    },
+    // Disable rules incompatible with Markdown processor's virtual files
+    // The @eslint/markdown processor creates virtual files that lack complete ESLint SourceCode API
+    // (getAllComments, getTokenBefore, etc.) and TypeScript parser services (esTreeNodeToTSNodeMap).
+    // This causes failures in plugins that depend on these features.
+    {
+      name: "@bfra.me/markdown/disabled",
+      files,
+      rules: {
+        "jsdoc/check-property-names": "off",
+        "jsdoc/require-property-name": "off",
+        "unicorn/filename-case": "off",
+        "command/command": "off",
+        "jsdoc/check-access": "off",
+        "jsdoc/check-types": "off",
+        "jsdoc/empty-tags": "off",
+        "jsdoc/no-multi-asterisks": "off",
+        "jsdoc/require-property": "off",
+        "jsdoc/require-property-description": "off",
+        "no-irregular-whitespace": "off",
+        "perfectionist/sort-exports": "off",
+        "perfectionist/sort-imports": "off",
+        "regexp/no-legacy-features": "off",
+        "regexp/no-missing-g-flag": "off",
+        "regexp/no-useless-dollar-replacements": "off",
+        "regexp/no-useless-flag": "off"
+      }
+    },
+    {
+      name: "@bfra.me/markdown/overrides",
+      files,
+      rules: {
+        "markdown/fenced-code-language": "warn",
+        "markdown/heading-increment": "error",
+        "markdown/no-duplicate-definitions": "error",
+        "markdown/no-empty-definitions": "error",
+        "markdown/no-empty-images": "error",
+        "markdown/no-empty-links": "error",
+        "markdown/no-invalid-label-refs": "error",
+        "markdown/no-missing-atx-heading-space": "error",
+        "markdown/no-missing-label-refs": "error",
+        "markdown/no-missing-link-fragments": "error",
+        "markdown/no-multiple-h1": "error",
+        "markdown/no-reference-like-urls": "error",
+        "markdown/no-reversed-media-syntax": "error",
+        "markdown/no-space-in-emphasis": "error",
+        "markdown/no-unused-definitions": "error",
+        "markdown/require-alt-text": "error",
+        "markdown/table-column-count": "error",
+        ...overrides
+      }
+    }
+  ];
+  if (codeBlocks === false) {
+    return configs;
+  }
+  const {
+    javascript: javascript2 = true,
+    json = true,
+    jsx = true,
+    typescript: typescript2 = true,
+    yaml: yaml2 = true
+  } = codeBlocks === true ? {} : codeBlocks;
+  if (typescript2 || javascript2 || jsx) {
+    const tselint = await interopDefault(import("typescript-eslint"));
+    const tsJsFiles = [];
+    if (typescript2) {
+      tsJsFiles.push(...GLOB_MARKDOWN_FILES.map((p) => `${p}/${GLOB_TS}`));
+    }
+    if (typescript2 || jsx) {
+      tsJsFiles.push(...GLOB_MARKDOWN_FILES.map((p) => `${p}/${GLOB_TSX}`));
+    }
+    if (javascript2) {
+      tsJsFiles.push(...GLOB_MARKDOWN_FILES.map((p) => `${p}/${GLOB_JS}`));
+    }
+    if (javascript2 || jsx) {
+      tsJsFiles.push(...GLOB_MARKDOWN_FILES.map((p) => `${p}/${GLOB_JSX}`));
+    }
+    configs.push({
+      name: "@bfra.me/markdown/code-blocks/typescript-javascript",
+      files: tsJsFiles,
+      languageOptions: {
+        parser: tselint.parser,
+        parserOptions: {
+          ecmaFeatures: {
+            impliedStrict: true,
+            jsx: jsx || javascript2
           },
-          rules: {
-            // Only disable non-type-aware rules we want to skip for markdown code blocks
-            "@typescript-eslint/no-namespace": "off",
-            "@stylistic/comma-dangle": "off",
-            "@stylistic/eol-last": "off",
-            "@stylistic/padding-line-between-statements": "off",
-            "@typescript-eslint/consistent-type-imports": "off",
-            "@typescript-eslint/explicit-function-return-type": "off",
-            "@typescript-eslint/no-redeclare": "off",
-            "@typescript-eslint/no-require-imports": "off",
-            "@typescript-eslint/no-unused-expressions": "off",
-            "@typescript-eslint/no-unused-vars": "off",
-            "@typescript-eslint/no-use-before-define": "off",
-            "@typescript-eslint/no-var-requires": "off",
-            "import-x/newline-after-import": "off",
-            "jsdoc/require-returns-check": "off",
-            "no-alert": "off",
-            "no-console": "off",
-            "no-labels": "off",
-            "no-lone-blocks": "off",
-            "no-restricted-imports": "off",
-            "no-restricted-syntax": "off",
-            "no-undef": "off",
-            "no-unused-expressions": "off",
-            "no-unused-labels": "off",
-            "no-unused-vars": "off",
-            "node/prefer-global/process": "off",
-            "unicode-bom": "off",
-            "unused-imports/no-unused-imports": "off",
-            "unused-imports/no-unused-vars": "off",
-            ...overrides
-          }
+          ecmaVersion: "latest",
+          // Type-aware rules disabled: documentation snippets lack tsconfig context
+          project: null,
+          sourceType: "module"
         }
-      ];
-    },
-    fallback
-  );
+      },
+      rules: {
+        // Only disable non-type-aware rules we want to skip for markdown code blocks
+        "@typescript-eslint/no-namespace": "off",
+        "@stylistic/comma-dangle": "off",
+        "@stylistic/eol-last": "off",
+        "@stylistic/padding-line-between-statements": "off",
+        "@typescript-eslint/consistent-type-imports": "off",
+        "@typescript-eslint/explicit-function-return-type": "off",
+        "@typescript-eslint/no-redeclare": "off",
+        "@typescript-eslint/no-require-imports": "off",
+        "@typescript-eslint/no-unused-expressions": "off",
+        "@typescript-eslint/no-unused-vars": "off",
+        "@typescript-eslint/no-use-before-define": "off",
+        "@typescript-eslint/no-var-requires": "off",
+        "import-x/newline-after-import": "off",
+        "jsdoc/require-returns-check": "off",
+        "no-alert": "off",
+        "no-console": "off",
+        "no-labels": "off",
+        "no-lone-blocks": "off",
+        "no-restricted-imports": "off",
+        "no-restricted-syntax": "off",
+        "no-undef": "off",
+        "no-unused-expressions": "off",
+        "no-unused-labels": "off",
+        "no-unused-vars": "off",
+        "node/prefer-global/process": "off",
+        "unicode-bom": "off",
+        "unused-imports/no-unused-imports": "off",
+        "unused-imports/no-unused-vars": "off"
+      }
+    });
+  }
+  if (json) {
+    const pluginJsonc = await interopDefault(import("eslint-plugin-jsonc"));
+    const baseConfigs = pluginJsonc.configs["flat/base"];
+    configs.push({
+      name: "@bfra.me/markdown/code-blocks/json",
+      files: GLOB_MARKDOWN_FILES.flatMap((p) => [
+        `${p}/${GLOB_JSON}`,
+        `${p}/${GLOB_JSON5}`,
+        `${p}/${GLOB_JSONC}`
+      ]),
+      languageOptions: baseConfigs[1]?.languageOptions ?? {},
+      rules: {
+        // Examples may show JSON with trailing commas or explanatory comments
+        "jsonc/comma-dangle": "off",
+        "jsonc/no-comments": "off"
+      }
+    });
+  }
+  if (yaml2) {
+    const pluginYaml = await interopDefault(import("eslint-plugin-yml"));
+    const standardConfigs = pluginYaml.configs["flat/standard"];
+    configs.push({
+      name: "@bfra.me/markdown/code-blocks/yaml",
+      files: GLOB_MARKDOWN_FILES.map((p) => `${p}/${GLOB_YAML}`),
+      languageOptions: standardConfigs[1]?.languageOptions ?? {},
+      rules: {
+        // Examples may show incomplete YAML mappings to focus on specific concepts
+        "yml/no-empty-mapping-value": "off"
+      }
+    });
+  }
+  return configs;
 }
 
 // src/configs/nextjs.ts
@@ -2279,6 +2394,7 @@ async function defineConfig(options = {}, ...userConfigs) {
   if (options.markdown ?? true) {
     configs.push(
       markdown({
+        ...resolveSubOptions(options, "markdown"),
         overrides: getOverrides(options, "markdown")
       })
     );
@@ -2321,6 +2437,7 @@ export {
   GLOB_CODE_IN_MARKDOWN_FILES,
   GLOB_EXCLUDE,
   GLOB_EXT_IN_MARKDOWN_FILES,
+  GLOB_JS,
   GLOB_JSON,
   GLOB_JSON5,
   GLOB_JSONC,

package/lib/{missing-module-for-config-DNGJUDHU.js → missing-module-for-config-QFYTX2KG.js}

@@ -126,11 +126,11 @@ function create(context) {
   for (const module of modules) {
     let output = "";
     if (shouldFix) {
-      const result = tryInstall(module, context.filename || context.getFilename()) ?? "";
+      const result = tryInstall(module, context.filename) ?? "";
       output = result ? `
 ${result}` : "";
     }
-    const command = getPackageInstallCommand(module, context.filename || context.getFilename()) ?? "";
+    const command = getPackageInstallCommand(module, context.filename) ?? "";
     context.report({
       loc: { column: 0, line: 1 },
       message: `Missing module for config: ${module}. Run: \`${command || `npm i -D ${module}`}\`${output}`
@@ -142,4 +142,4 @@ export {
   create,
   meta
 };
-//# sourceMappingURL=missing-module-for-config-DNGJUDHU.js.map
+//# sourceMappingURL=missing-module-for-config-QFYTX2KG.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bfra.me/eslint-config",
-  "version": "0.39.1",
+  "version": "0.41.0",
   "description": "Shared ESLint configuration for bfra.me",
   "keywords": [
     "bfra.me",
@@ -39,13 +39,13 @@
   "dependencies": {
     "@eslint-community/eslint-plugin-eslint-comments": "4.5.0",
     "@eslint/markdown": "7.5.1",
-    "@stylistic/eslint-plugin": "5.5.0",
+    "@stylistic/eslint-plugin": "5.6.1",
     "eslint-config-flat-gitignore": "2.1.0",
     "eslint-flat-config-utils": "2.1.4",
     "eslint-merge-processors": "2.0.0",
     "eslint-plugin-command": "3.3.1",
     "eslint-plugin-import-x": "4.16.1",
-    "eslint-plugin-jsdoc": "61.2.1",
+    "eslint-plugin-jsdoc": "61.3.0",
     "eslint-plugin-json-schema-validator": "5.5.0",
     "eslint-plugin-jsonc": "2.21.0",
     "eslint-plugin-n": "17.23.1",
@@ -61,32 +61,29 @@
     "package-directory": "8.1.0",
     "package-manager-detector": "1.5.0",
     "sort-package-json": "3.4.0",
-    "typescript-eslint": "8.46.4"
+    "typescript-eslint": "8.47.0"
   },
   "devDependencies": {
     "@eslint-react/eslint-plugin": "2.3.5",
-    "@eslint/config-inspector": "1.3.0",
-    "@eslint/core": "0.17.0",
+    "@eslint/config-inspector": "1.4.2",
+    "@eslint/core": "1.0.0",
     "@next/eslint-plugin-next": "16.0.3",
     "@types/eslint-config-prettier": "6.11.3",
-    "@typescript-eslint/types": "8.46.4",
-    "@vitest/eslint-plugin": "1.4.2",
+    "@typescript-eslint/types": "8.47.0",
+    "@vitest/eslint-plugin": "1.4.3",
     "astro-eslint-parser": "1.2.2",
     "eslint": "9.39.1",
     "eslint-config-prettier": "10.1.8",
     "eslint-plugin-astro": "1.5.0",
     "eslint-plugin-erasable-syntax-only": "0.4.0",
-    "eslint-plugin-node-dependencies": "1.2.0",
+    "eslint-plugin-node-dependencies": "1.3.0",
     "eslint-plugin-pnpm": "1.3.0",
     "eslint-plugin-prettier": "5.5.4",
     "eslint-plugin-react-hooks": "7.0.1",
     "eslint-plugin-react-refresh": "0.4.24",
     "eslint-typegen": "2.3.0",
-    "tsx": "4.20.6",
-    "@bfra.me/eslint-config": "0.39.1",
-    "@bfra.me/prettier-config": "0.16.2",
-    "@bfra.me/tsconfig": "0.12.0",
-    "@bfra.me/works": "0.0.0-development"
+    "@bfra.me/works": "0.0.0-development",
+    "@bfra.me/prettier-config": "0.16.3"
   },
   "peerDependencies": {
     "@eslint-react/eslint-plugin": "^2.0.1",