ci: fix docusaurus-mdx-checker installation (#2913)

* ci: fix broken docusaurus checker

* better comment

* rm trigger

Author: anakin87

.github/workflows/CI_check_api_ref.yml

@@ -109,6 +109,11 @@ jobs:
         if: steps.changed.outputs.integrations != '[]'
         working-directory: website
         run: |
+          # docusaurus-mdx-checker is a package that is not frequently updated. Its dependency katex sometimes ships a 
+          # broken ESM build, where a __VERSION__ placeholder is left unresolved, causing a ReferenceError at import time.
+          # Node 22+ prefers ESM when available. We force CJS (CommonJS) resolution to use the working katex build.
+          # This should be safe because docusaurus-mdx-checker and its dependencies provide CJS builds.
+          export NODE_OPTIONS="--conditions=require"
           npx docusaurus-mdx-checker -v || {
               echo ""
               echo "For common MDX problems, see https://docusaurus.io/blog/preparing-your-site-for-docusaurus-v3#common-mdx-problems"