ensure code blocks doesn't contains validation errrors / fix hydration errors on some of graphql-js pages

.eslintrc.cjs

@@ -1,21 +1,20 @@
 /* eslint-env node */
 
+const CODE_EXT = "js,jsx,cjs,mjs,ts,tsx,cts,mts"
+
+const MARKDOWN_EXT = "md,mdx"
+
 module.exports = {
   root: true,
   overrides: [
     {
-      files: ["**/*.{js,jsx,cjs,mjs,ts,tsx,cts,mts}"],
+      files: [`**/*.{${CODE_EXT}}`],
       extends: [
         "eslint:recommended",
         "plugin:@typescript-eslint/recommended",
         "plugin:tailwindcss/recommended",
         "prettier",
       ],
-      parser: "@typescript-eslint/parser",
-      parserOptions: {
-        sourceType: "module",
-        ecmaVersion: "latest",
-      },
       rules: {
         "tailwindcss/classnames-order": "off",
         "@typescript-eslint/no-restricted-imports": [
@@ -48,5 +47,28 @@ module.exports = {
         },
       },
     },
+    {
+      files: [`**/*.{${MARKDOWN_EXT}}`],
+      parser: "eslint-mdx",
+      processor: "mdx/remark",
+      plugins: ["mdx"],
+      parserOptions: {
+        ecmaVersion: 13,
+        sourceType: "module",
+      },
+      settings: {
+        "mdx/code-blocks": true,
+      },
+    },
+    {
+      files: [`**/*.{${MARKDOWN_EXT}}/*.{${CODE_EXT}}`],
+      rules: {
+        "no-unused-labels": "off",
+        "no-undef": "off",
+        "no-redeclare": "off",
+        "no-import-assign": "off",
+        "no-prototype-builtins": "off",
+      },
+    },
   ],
 }

package.json

@@ -69,6 +69,7 @@
     "@typescript-eslint/parser": "7.4.0",
     "eslint": "8.57.0",
     "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-mdx": "^3.1.5",
     "eslint-plugin-tailwindcss": "3.15.1",
     "prettier": "3.2.5",
     "typescript": "^5.4.3"