@revealui/core 0.0.1-pre.0

package/dist/core/gaurds/logger/logErrorHint/getErrorHint.spec.ts

@@ -0,0 +1,1057 @@
+import { describe, expect, it } from "vitest"
+import { getErrorHint } from "../logErrorHint"
+import { errror_cannot_use_import_outside_of_module } from "./errors"
+
+describe("getErrorHint()", () => {
+  ERR_MODULE_NOT_FOUND()
+  ERR_UNKNOWN_FILE_EXTENSION()
+  ERR_UNSUPPORTED_DIR_IMPORT()
+  cannot_read_property_of_undefined()
+  default_is_not()
+  ERR_REQUIRE_ESM()
+  cjs_named_export()
+  cannot_use_import_outside_of_module()
+  is_not_defined()
+  is_not_exported()
+  unexpected_token_export()
+  react_invalid_component()
+  react_invalid_hook_usage()
+  misc()
+})
+
+function createErr(errStr: string) {
+  return { stack: errStr }
+}
+
+// Classic: file extension missing in import path.
+function ERR_MODULE_NOT_FOUND() {
+  it("ERR_MODULE_NOT_FOUND / ERR_LOAD_URL", () => {
+    expect(
+      getErrorHint(
+        // https://github.com/aws-amplify/amplify-ui/issues/3155#issue-1488517976
+        createErr(`
+Error [ERR_MODULE_NOT_FOUND]: Cannot find module 'node_modules/lodash/debounce' imported from node_modules/@aws-amplify/ui-react/dist/primitives/Collection/Collection.js
+Did you mean to import lodash@4.17.21/node_modules/lodash/debounce.js?
+    at new NodeError (node:internal/errors:372:5)
+  code: 'ERR_MODULE_NOT_FOUND'
+}
+`)
+      )
+    ).toMatchInlineSnapshot(
+      `"The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"`
+    )
+
+    expect(
+      getErrorHint(
+        // https://github.com/revealjs/reveal/discussions/1084#discussion-5536319
+        createErr(`
+Error: Cannot find package '/test/node_modules/@mdxeditor/editor/dist/node_modules/react-diff-view/' imported from /test/node_modules/@mdxeditor/editor/dist/plugins/diff-source/DiffViewer.js
+    at legacyMainResolve (/test/node_modules/ts-node/dist-raw/node-internal-modules-esm-resolve.js:286:9)
+    at packageResolve (/test/node_modules/ts-node/dist-raw/node-internal-modules-esm-resolve.js:750:14)
+    at moduleResolve (/test/node_modules/ts-node/dist-raw/node-internal-modules-esm-resolve.js:798:18)
+    at Object.defaultResolve (/test/node_modules/ts-node/dist-raw/node-internal-modules-esm-resolve.js:912:11)
+    at /test/node_modules/ts-node/src/esm.ts:218:35
+    at entrypointFallback (/test/node_modules/ts-node/src/esm.ts:168:34)
+    at /test/node_modules/ts-node/src/esm.ts:217:14
+    at addShortCircuitFlag (/test/node_modules/ts-node/src/esm.ts:409:21)
+    at resolve (/test/node_modules/ts-node/src/esm.ts:197:12)
+    at resolve (/test/node_modules/ts-node/src/child/child-loader.ts:15:39)
+    at nextResolve (node:internal/modules/loader:163:28)
+    at ESMLoader.resolve (node:internal/modules/loader:838:30)
+    at ESMLoader.getModuleJob (node:internal/modules/loader:424:18)
+    at ModuleWrap.<anonymous> (node:internal/modules/module_job:77:40)
+    at link (node:internal/modules/module_job:76:36)
+`)
+      )
+    ).toMatchInlineSnapshot(
+      `"The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"`
+    )
+
+    expect(
+      getErrorHint(
+        /* node_modules/ land, wrong import path: missing file extension.
+         * - Error artificially created:
+         *   ```diff
+         *   // node_modules/reveal-react/dist/renderer/onRenderHtml.js:
+         *   - import { getPageElement } from './getPageElement.js';
+         *   + import { getPageElement } from './getPageElement';
+         *   ```
+         */
+        {
+          message:
+            "Cannot find module '/home/romu/code/reveal/node_modules/.pnpm/reveal-react@0.3.8_react-dom@18.2.0_react@18.2.0_reveal@reveal_vite@5.0.10/node_modules/reveal-react/dist/renderer/getPageElement' imported from /home/romu/code/reveal/node_modules/.pnpm/reveal-react@0.3.8_react-dom@18.2.0_react@18.2.0_reveal@reveal_vite@5.0.10/node_modules/reveal-react/dist/renderer/onRenderHtml.js",
+          code: "ERR_MODULE_NOT_FOUND",
+          stack: `
+Error: Cannot find module '/home/romu/code/reveal/node_modules/.pnpm/reveal-react@0.3.8_react-dom@18.2.0_react@18.2.0_reveal@reveal_vite@5.0.10/node_modules/reveal-react/dist/renderer/getPageElement' imported from /home/romu/code/reveal/node_modules/.pnpm/reveal-react@0.3.8_react-dom@18.2.0_react@18.2.0_reveal@reveal_vite@5.0.10/node_modules/reveal-react/dist/renderer/onRenderHtml.js
+    at new NodeError (node:internal/errors:399:5)
+    at finalizeResolution (node:internal/modules/resolve:326:11)
+    at moduleResolve (node:internal/modules/resolve:945:10)
+    at defaultResolve (node:internal/modules/resolve:1153:11)
+    at nextResolve (node:internal/modules/loader:163:28)
+    at ESMLoader.resolve (node:internal/modules/loader:838:30)
+    at ESMLoader.getModuleJob (node:internal/modules/loader:424:18)
+    at ModuleWrap.<anonymous> (node:internal/modules/module_job:77:40)
+    at link (node:internal/modules/module_job:76:36)
+`,
+        }
+      )
+    ).toMatchInlineSnapshot(
+      `"The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"`
+    )
+
+    expect(
+      getErrorHint(
+        // - User land, transpiled by Vite
+        // - Wrong import path (it should be `components/does-not-exist/Counter` instead of `components/does-not-exist/Counter`)
+        {
+          message:
+            "Failed to load url ../../components/does-not-exist/Counter (resolved id: ../../components/does-not-exist/Counter) in /home/romu/code/reveal/examples/react-full/pages/index/+Page.tsx. Does the file exist?",
+          code: "ERR_LOAD_URL",
+          stack: `
+Error: Failed to load url ../../components/does-not-exist/Counter (resolved id: ../../components/does-not-exist/Counter) in /home/romu/code/reveal/examples/react-full/pages/index/+Page.tsx. Does the file exist?
+    at loadAndTransform (file:///home/romu/code/reveal/node_modules/.pnpm/vite@5.0.10_@types+node@20.10.5/node_modules/vite/dist/node/chunks/dep-R0I0XnyH.js:49376:21)
+    at instantiateModule (file:///home/romu/code/reveal/node_modules/.pnpm/vite@5.0.10_@types+node@20.10.5/node_modules/vite/dist/node/chunks/dep-R0I0XnyH.js:50404:10)
+`,
+        }
+      )
+    ).toMatchInlineSnapshot(`null`)
+
+    expect(
+      getErrorHint(
+        // User land, executed directly by Node.js
+        {
+          message:
+            "Cannot find package 'some-not-installed-package' imported from /home/romu/code/reveal/boilerplates/boilerplate-react/server/index.js",
+          code: "ERR_MODULE_NOT_FOUND",
+          stack: `
+Cannot find package 'some-not-installed-package' imported from /home/romu/code/reveal/boilerplates/boilerplate-react/server/index.js
+    at new NodeError (node:internal/errors:399:5)
+    at packageResolve (node:internal/modules/resolve:889:9)
+    at moduleResolve (node:internal/modules/resolve:938:20)
+    at defaultResolve (node:internal/modules/resolve:1153:11)
+    at nextResolve (node:internal/modules/loader:163:28)
+    at ESMLoader.resolve (node:internal/modules/loader:838:30)
+    at ESMLoader.getModuleJob (node:internal/modules/loader:424:18)
+    at ModuleWrap.<anonymous> (node:internal/modules/module_job:77:40)
+    at link (node:internal/modules/module_job:76:36)
+`,
+        }
+      )
+    ).toMatchInlineSnapshot(`null`)
+
+    expect(
+      getErrorHint(
+        // User land, transpiled by Vite
+        {
+          message:
+            "Cannot find module 'some-not-installed-package' imported from '/home/romu/code/reveal/examples/react-full/pages/index/+Page.tsx'",
+          code: "ERR_MODULE_NOT_FOUND",
+          stack: `
+Error: Cannot find module 'some-not-installed-package' imported from '/home/romu/code/reveal/examples/react-full/pages/index/+Page.tsx'
+    at nodeImport (file:///home/romu/code/reveal/node_modules/.pnpm/vite@4.5.1_@types+node@20.10.4/node_modules/vite/dist/node/chunks/dep-68d1a114.js:56088:25)
+    at ssrImport (file:///home/romu/code/reveal/node_modules/.pnpm/vite@4.5.1_@types+node@20.10.4/node_modules/vite/dist/node/chunks/dep-68d1a114.js:55990:30)
+    at eval (/home/romu/code/reveal/examples/react-full/pages/index/+Page.tsx:7:37)
+    at instantiateModule (file:///home/romu/code/reveal/node_modules/.pnpm/vite@4.5.1_@types+node@20.10.4/node_modules/vite/dist/node/chunks/dep-68d1a114.js:56052:9)
+`,
+        }
+      )
+    )
+      // False positive, but it's okay.
+      .toMatchInlineSnapshot(
+        `"The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"`
+      )
+
+    expect(
+      getErrorHint({
+        // I guess it's an error generated by Vite, which seems redundant with the ERR_MODULE_NOT_FOUND error above. Let's ignore it since we already handle ERR_MODULE_NOT_FOUND errors.
+        message:
+          "Failed to load url some-not-installed-package (resolved id: some-not-installed-package) in /home/romu/code/reveal/examples/react-full/pages/index/+Page.tsx. Does the file exist?",
+        // See comment down below about ERR_LOAD_URL errors
+        code: "ERR_LOAD_URL",
+        stack: `
+Error: Failed to load url some-not-installed-package (resolved id: some-not-installed-package) in /home/romu/code/reveal/examples/react-full/pages/index/+Page.tsx. Does the file exist?
+    at loadAndTransform (file:///home/romu/code/reveal/node_modules/.pnpm/vite@4.5.1_@types+node@20.10.4/node_modules/vite/dist/node/chunks/dep-68d1a114.js:55015:21)
+`,
+      })
+    ).toMatchInlineSnapshot(`null`)
+
+    /* I don't remember when I stumbled upon this error, but it seems like it most likely won't occur again.
+    expect(
+      getErrorHint(
+        // Don't match if importer is @brillout/import
+        createErr(`
+Error: Cannot find module '/home/romu/code/reveal/node_modules/.pnpm/@brillout+import@0.2.3/node_modules/@brillout/import/dist/autoImporter' imported from /home/romu/code/reveal/node_modules/.pnpm/@brillout+import@0.2.3/node_modules/@brillout/import/dist/index.js
+    at new NodeError (node:internal/errors:399:5)
+    at finalizeResolution (node:internal/modules/resolve:326:11)
+    at moduleResolve (node:internal/modules/resolve:945:10)
+    at defaultResolve (node:internal/modules/resolve:1153:11)
+    at nextResolve (node:internal/modules/loader:163:28)
+    at ESMLoader.resolve (node:internal/modules/loader:838:30)
+    at ESMLoader.getModuleJob (node:internal/modules/loader:424:18)
+    at ESMLoader.import (node:internal/modules/loader:525:22)
+    at importModuleDynamically (node:internal/modules/cjs/loader:1186:29)
+    at importModuleDynamicallyWrapper (node:internal/vm/module:429:21) {
+  code: 'ERR_MODULE_NOT_FOUND'
+}
+`)
+      )
+    ).toMatchInlineSnapshot(`null`)
+    */
+  })
+}
+
+// Classic: server-side code importing CSS.
+function ERR_UNKNOWN_FILE_EXTENSION() {
+  it("ERR_UNKNOWN_FILE_EXTENSION", () => {
+    expect(
+      getErrorHint(
+        /* node_modules/ land
+         * - Error artificially created:
+         *   ```diff
+         *   // node_modules/reveal-react/dist/renderer/onRenderHtml.js:
+         *   + import './foo.css'
+         *   // node_modules/reveal-react/dist/renderer/foo.css
+         *   + body {
+         *   +   background-color: blue;
+         *   + }
+         *   ```
+         */
+        {
+          message:
+            'Unknown file extension ".css" for /home/romu/code/reveal/node_modules/.pnpm/reveal-react@0.3.8_react-dom@18.2.0_react@18.2.0_reveal@reveal_vite@5.0.10/node_modules/reveal-react/dist/renderer/foo.css',
+          code: "ERR_UNKNOWN_FILE_EXTENSION",
+          stack: `
+TypeError: Unknown file extension ".css" for /home/romu/code/reveal/node_modules/.pnpm/reveal-react@0.3.8_react-dom@18.2.0_react@18.2.0_reveal@reveal_vite@5.0.10/node_modules/reveal-react/dist/renderer/foo.css
+    at new NodeError (node:internal/errors:399:5)
+    at Object.getFileProtocolModuleFormat [as file:] (node:internal/modules/get_format:79:11)
+    at defaultGetFormat (node:internal/modules/get_format:121:38)
+    at defaultLoad (node:internal/modules/load:81:20)
+    at nextLoad (node:internal/modules/loader:163:28)
+    at ESMLoader.load (node:internal/modules/loader:605:26)
+    at ESMLoader.moduleProvider (node:internal/modules/loader:457:22)
+    at new ModuleJob (node:internal/modules/module_job:64:26)
+    at ESMLoader.#createModuleJob (node:internal/modules/loader:480:17)
+    at ESMLoader.getModuleJob (node:internal/modules/loader:434:34)
+`,
+        }
+      )
+    ).toMatchInlineSnapshot(
+      `"The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"`
+    )
+
+    expect(
+      getErrorHint(
+        // https://github.com/revealjs/reveal/discussions/682#discussion-4927859
+        createErr(`
+TypeError [ERR_UNKNOWN_FILE_EXTENSION]: Unknown file extension ".css" for /Users/xxx/Projects/xxx/xxx/node_modules/vuetify/lib/components/VGrid/VGrid.css
+    at new NodeError (node:internal/errors:387:5)
+    at Object.getFileProtocolModuleFormat [as file:] (node:internal/modules/get_format:76:11)
+    at defaultGetFormat (node:internal/modules/get_format:118:38)
+    at defaultLoad (node:internal/modules/load:81:20)
+    at nextLoad (node:internal/modules/loader:165:28)
+    at ESMLoader.load (node:internal/modules/loader:608:26)
+    at ESMLoader.moduleProvider (node:internal/modules/loader:464:22)
+    at new ModuleJob (node:internal/modules/module_job:63:26)
+    at ESMLoader.#createModuleJob (node:internal/modules/loader:483:17)
+    at ESMLoader.getModuleJob (node:internal/modules/loader:441:34)
+`)
+      )
+    ).toMatchInlineSnapshot(
+      `"The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"`
+    )
+
+    expect(
+      getErrorHint(
+        // https://github.com/revealjs/reveal/discussions/791#discussion-5101014
+        createErr(`
+Error: ERR_UNKNOWN_FILE_EXTENSION .css /home/stuart/tmp/vite-ssr-example/node_modules/.pnpm/@react-spectrum+actiongroup@3.8.2_@react-spectrum+provider@3.7.1_react-dom@18.2.0_react@18.2.0/node_modules/@react-spectrum/actiongroup/dist/main.css
+    at defaultGetFormat (/home/stuart/tmp/vite-ssr-example/node_modules/.pnpm/ts-node@10.9.1_@types+node@18.15.11_typescript@4.9.5/node_modules/ts-node/dist-raw/node-internal-modules-esm-get_format.js:93:15)
+    at defer (/home/stuart/tmp/vite-ssr-example/node_modules/.pnpm/ts-node@10.9.1_@types+node@18.15.11_typescript@4.9.5/node_modules/ts-node/src/esm.ts:296:7)
+    at entrypointFallback (/home/stuart/tmp/vite-ssr-example/node_modules/.pnpm/ts-node@10.9.1_@types+node@18.15.11_typescript@4.9.5/node_modules/ts-node/src/esm.ts:304:22)
+    at getFormat (/home/stuart/tmp/vite-ssr-example/node_modules/.pnpm/ts-node@10.9.1_@types+node@18.15.11_typescript@4.9.5/node_modules/ts-node/src/esm.ts:338:26)
+    at /home/stuart/tmp/vite-ssr-example/node_modules/.pnpm/ts-node@10.9.1_@types+node@18.15.11_typescript@4.9.5/node_modules/ts-node/src/esm.ts:245:17
+    at addShortCircuitFlag (/home/stuart/tmp/vite-ssr-example/node_modules/.pnpm/ts-node@10.9.1_@types+node@18.15.11_typescript@4.9.5/node_modules/ts-node/src/esm.ts:409:21)
+    at load (/home/stuart/tmp/vite-ssr-example/node_modules/.pnpm/ts-node@10.9.1_@types+node@18.15.11_typescript@4.9.5/node_modules/ts-node/src/esm.ts:239:12)
+    at load (/home/stuart/tmp/vite-ssr-example/node_modules/.pnpm/ts-node@10.9.1_@types+node@18.15.11_typescript@4.9.5/node_modules/ts-node/src/child/child-loader.ts:18:36)
+    at nextLoad (node:internal/modules/loader:163:28)
+    at ESMLoader.load (node:internal/modules/loader:605:26)
+`)
+      )
+    ).toMatchInlineSnapshot(
+      `"The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"`
+    )
+
+    expect(
+      getErrorHint(
+        // User land ESM error
+        createErr(`
+TypeError [ERR_UNKNOWN_FILE_EXTENSION]: Unknown file extension ".123" for /home/xxx/projects/reveal/xxx/server/root.123
+at new NodeError (node:internal/errors:399:5)
+at Object.getFileProtocolModuleFormat [as file:] (node:internal/modules/get_format:79:11)
+at defaultGetFormat (node:internal/modules/get_format:121:38)
+at defaultLoad (node:internal/modules/load:81:20)
+at nextLoad (node:internal/modules/loader:163:28)
+at ESMLoader.load (node:internal/modules/loader:605:26)
+at ESMLoader.moduleProvider (node:internal/modules/loader:457:22)
+at new ModuleJob (node:internal/modules/module_job:64:26)
+at #createModuleJob (node:internal/modules/loader:480:17)
+at ESMLoader.getModuleJob (node:internal/modules/loader:434:34) {
+code: 'ERR_UNKNOWN_FILE_EXTENSION'
+}
+`)
+      )
+    ).toMatchInlineSnapshot(`null`)
+
+    expect(
+      getErrorHint(
+        // https://github.com/revealjs/reveal/discussions/901#discussioncomment-6733600
+        // https://github.com/revealjs/reveal/discussions/1067
+        // https://github.com/revealjs/reveal/issues/877
+        createErr(
+          `TypeError [ERR_UNKNOWN_FILE_EXTENSION]: Unknown file extension ".ts" for /media/oem/MyFiles/8_DEVELOPMENT/vite-ssr-ts-project/server/index.ts`
+        )
+      )
+    ).toMatchInlineSnapshot(`null`)
+  })
+}
+
+// Classic: server-side code importing CSS.
+function ERR_UNSUPPORTED_DIR_IMPORT() {
+  it("ERR_UNSUPPORTED_DIR_IMPORT", () => {
+    expect(
+      getErrorHint(
+        // https://github.com/revealjs/reveal/discussions/934
+        createErr(`
+Error: ERR_UNSUPPORTED_DIR_IMPORT /Users/xxx/Documents/Github/xxx/node_modules/@aws-amplify/datastore/ssr /Users/xxx/Documents/Github/xxx/dist/server/renderer/default-page-server.js
+    at finalizeResolution (/Users/xxx/Documents/Github/xxx/node_modules/ts-node/dist-raw/node-internal-modules-esm-resolve.js:362:17)
+    at moduleResolve (/Users/xxx/Documents/Github/xxx/node_modules/ts-node/dist-raw/node-internal-modules-esm-resolve.js:801:10)
+    at Object.defaultResolve (/Users/xxx/Documents/Github/xxx/node_modules/ts-node/dist-raw/node-internal-modules-esm-resolve.js:912:11)
+    at /Users/xxx/Documents/Github/xxx/node_modules/ts-node/src/esm.ts:218:35
+    at entrypointFallback (/Users/xxx/Documents/Github/xxx/node_modules/ts-node/src/esm.ts:168:34)
+    at /Users/xxx/Documents/Github/xxx/node_modules/ts-node/src/esm.ts:217:14
+    at addShortCircuitFlag (/Users/xxx/Documents/Github/xxx/node_modules/ts-node/src/esm.ts:409:21)
+    at resolve (/Users/xxx/Documents/Github/xxx/node_modules/ts-node/src/esm.ts:197:12)
+    at resolve (/Users/xxx/Documents/Github/xxx/node_modules/ts-node/src/child/child-loader.ts:15:39)
+    at nextResolve (node:internal/modules/loader:165:28)
+`)
+      )
+    ).toMatchInlineSnapshot(
+      `"The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"`
+    )
+
+    expect(
+      getErrorHint(
+        // https://github.com/revealjs/reveal/discussions/700#discussioncomment-5283034
+        createErr(`
+Error: ERR_UNSUPPORTED_DIR_IMPORT ...\\vite-ssr-app\\node_modules\\@mui\\material\\styles from ...\\vite-ssr-app\\dist\\server\\renderer\\default-page-server.js
+    `)
+      )
+    ).toMatchInlineSnapshot(
+      `"The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"`
+    )
+
+    expect(
+      getErrorHint(
+        // User land ESM error
+        createErr(`
+Error [ERR_UNSUPPORTED_DIR_IMPORT]: Directory import '/Users/xxx/xxx/src/models' is not supported resolving ES modules imported from /Users/xxx/xxx/src/index.js
+  at finalizeResolution (internal/modules/resolve.js:272:17)
+  at moduleResolve (internal/modules/resolve.js:699:10)
+  at Loader.defaultResolve [as _resolve] (internal/modules/resolve.js:810:11)
+  at Loader.resolve (internal/modules/loader.js:85:40)
+  at Loader.getModuleJob (internal/modules/loader.js:229:28)
+  at ModuleWrap.<anonymous> (internal/modules/module_job.js:51:40)
+  at link (internal/modules/module_job.js:50:36) {
+code: 'ERR_UNSUPPORTED_DIR_IMPORT',
+url: 'file:///Users/xxx/xxx/src/models'
+}
+`)
+      )
+    ).toMatchInlineSnapshot(`null`)
+
+    // More similar errors:
+    //  - https://github.com/revealjs/reveal/discussions/571#discussioncomment-6145155
+  })
+}
+
+// Classic: reading the property of an import value that is undefined because of a CJS/ESM issue
+function cannot_read_property_of_undefined() {
+  it("TypeError: Cannot read properties of undefined", () => {
+    expect(
+      getErrorHint(
+        // true instead of 'reveal-react' because the problem is the importee and not the importer
+        /* node_modules/ land
+         * - Error artificially created:
+         *   ```diff
+         *   // node_modules/reveal-react/dist/renderer/onRenderHtml.js:
+         *   - import { PageContextProvider } from './PageContextProvider.js';
+         *   + const PageContextProvider = undefined
+         *   // ...
+         *   - React.createElement(PageContextProvider, { pageContext: pageContext },
+         *   + React.createElement(PageContextProvider.foo, { pageContext: pageContext },
+         *   ```
+         */
+        {
+          message: "Cannot read properties of undefined (reading 'foo')",
+          code: undefined,
+          stack: `
+TypeError: Cannot read properties of undefined (reading 'foo')
+    at onRenderHtml (file:///home/romu/code/reveal/node_modules/.pnpm/reveal-react@0.3.8_react-dom@18.2.0_react@18.2.0_reveal@reveal_vite@5.0.10/node_modules/reveal-react/dist/renderer/onRenderHtml.js:21:49)
+    at file:///home/romu/code/reveal/reveal/dist/node/runtime/renderPage/executeOnRenderHtmlHook.js:15:53
+    at file:///home/romu/code/reveal/reveal/dist/shared/hooks/executeHook.js:46:31
+    at executeHook (file:///home/romu/code/reveal/reveal/dist/shared/hooks/executeHook.js:55:7)
+    at executeOnRenderHtmlHook (file:///home/romu/code/reveal/reveal/dist/node/runtime/renderPage/executeOnRenderHtmlHook.js:15:35)
+    at renderPageAlreadyRouted (file:///home/romu/code/reveal/reveal/dist/node/runtime/renderPage/renderPageAlreadyRouted.js:57:36)
+    at renderPageNominal (file:///home/romu/code/reveal/reveal/dist/node/runtime/renderPage.js:266:36)
+    at renderPageAlreadyPrepared (file:///home/romu/code/reveal/reveal/dist/node/runtime/renderPage.js:121:45)
+    at renderPageAndPrepare (file:///home/romu/code/reveal/reveal/dist/node/runtime/renderPage.js:101:12)
+    at file:///home/romu/code/reveal/reveal/dist/node/plugin/shared/getHttpRequestAsyncStore.js:68:35
+`,
+        }
+      )
+    ).toMatchInlineSnapshot(
+      `"The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"`
+    )
+
+    expect(
+      getErrorHint(
+        // https://github.com/revealjs/reveal/discussions/1235#discussion-5806578
+        createErr(`
+TypeError: Cannot read properties of undefined (reading '__H')
+    at getHookState (/Users/xxx/Code/Repos/xxx/node_modules/preact/hooks/src/index.js:137:19)
+    at Object.h (/Users/xxx/Code/Repos/xxx/node_modules/preact/hooks/src/index.js:320:16)
+    at Object.call (/Users/xxx/Code/Repos/xxx/node_modules/react-redux/lib/components/Provider.js:26:30)
+    at renderFunctionComponent (file:///Users/xxx/Code/Repos/xxx/node_modules/preact-render-to-string/src/index.js:119:25)
+    at _renderToString (file:///Users/xxx/Code/Repos/xxx/node_modules/preact-render-to-string/src/index.js:282:16)
+    at _renderToString (file:///Users/xxx/Code/Repos/xxx/node_modules/preact-render-to-string/src/index.js:298:15)
+    at Proxy.S (file:///Users/xxx/Code/Repos/xxx/node_modules/preact-render-to-string/src/index.js:80:9)
+    at onRenderHtml (/Users/xxx/Code/Repos/xxx/renderer/+onRenderHtml.jsx:12:29)
+    at file:///Users/xxx/Code/Repos/xxx/node_modules/reveal/dist/node/runtime/renderPage/executeOnRenderHtmlHook.js:16:53
+    at file:///Users/xxx/Code/Repos/xxx/node_modules/reveal/dist/shared/hooks/executeHook.js:42:31
+    at executeHook (file:///Users/xxx/Code/Repos/xxx/node_modules/reveal/dist/shared/hooks/executeHook.js:51:7)
+    at executeOnRenderHtmlHook (file:///Users/xxx/Code/Repos/xxx/node_modules/reveal/dist/node/runtime/renderPage/executeOnRenderHtmlHook.js:16:35)
+    at renderPageAlreadyRouted (file:///Users/xxx/Code/Repos/xxx/node_modules/reveal/dist/node/runtime/renderPage/renderPageAlreadyRouted.js:56:36)
+    at processTicksAndRejections (node:internal/process/task_queues:95:5)
+    at renderPageNominal (file:///Users/xxx/Code/Repos/xxx/node_modules/reveal/dist/node/runtime/renderPage.js:257:36)
+    at renderPageAlreadyPrepared (file:///Users/xxx/Code/Repos/xxx/node_modules/reveal/dist/node/runtime/renderPage.js:113:45)
+    at renderPageAndPrepare (file:///Users/xxx/Code/Repos/xxx/node_modules/reveal/dist/node/runtime/renderPage.js:93:12)
+    at file:///Users/xxx/Code/Repos/xxx/node_modules/reveal/dist/node/plugin/shared/getHttpRequestAsyncStore.js:68:35
+    at renderPage (file:///Users/xxx/Code/Repos/xxx/node_modules/reveal/dist/node/runtime/renderPage.js:46:50)
+    at file:///Users/xxx/Code/Repos/xxx/node_modules/reveal/dist/node/plugin/shared/addSsrMiddleware.js:18:27
+`)
+      )
+    ).toMatchInlineSnapshot(
+      `"The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"`
+    )
+
+    expect(
+      getErrorHint(
+        // User land JavaScript error
+        createErr(`
+file:///home/xxx/projects/reveal/xxx/server/index.js:20
+  console.log(a.b);
+                ^
+
+TypeError: Cannot read properties of undefined (reading 'b')
+    at startServer (file:///home/xxx/projects/reveal/xxx/server/index.js:20:17)
+    at file:///home/xxx/projects/reveal/xxx/server/index.js:13:1
+    at ModuleJob.run (node:internal/modules/module_job:194:25)
+`)
+      )
+    ).toMatchInlineSnapshot(`null`)
+
+    expect(
+      getErrorHint(
+        // https://github.com/vitejs/vite/issues/11299#issue-1487867332
+        // Not much information => is this user land or node_modules/ land?
+        // But it mentions node_modules => I guess it's a library issue.
+        createErr(`
+TypeError: Cannot read properties of undefined (reading 'extendTheme')
+    at eval (/home/projects/llqijrlvr.github/src/entry.js:5:35)
+    at async instantiateModule (file://file:///home/projects/llqijrlvr.github/node_modules/.pnpm/vite@4.0.0/node_modules/vite/dist/node/chunks/dep-ed9cb113.js:53295:9)
+`)
+      )
+    ).toMatchInlineSnapshot(
+      `"The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"`
+    )
+  })
+}
+
+function default_is_not() {
+  it("TypeError: __vite_ssr_import_0__.default is not a function", () => {
+    expect(
+      getErrorHint({
+        // https://github.com/revealjs/reveal/discussions/1637#discussion-6646661
+        message: "__vite_ssr_import_0__.default is not a function",
+        code: undefined,
+        stack: `
+TypeError: __vite_ssr_import_0__.default is not a function
+    at /home/rom/tmp/reveal-react-native-web-bug/node_modules/.pnpm/react-native-web@0.19.11_react-dom@18.3.1_react@18.3.1/node_modules/react-native-web/dist/modules/prefixStyles/index.js:3:31
+    at instantiateModule (file:///home/rom/tmp/reveal-react-native-web-bug/node_modules/.pnpm/vite@5.2.11/node_modules/vite/dist/node/chunks/dep-cNe07EU9.js:55058:9)
+`,
+      })
+    ).toMatchInlineSnapshot(
+      `"The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"`
+    )
+  })
+}
+
+// Classic: using require() to load ESM modules
+function ERR_REQUIRE_ESM() {
+  it("ERR_REQUIRE_ESM", () => {
+    expect(
+      getErrorHint(
+        /* node_modules/ land
+         * - Error artificially created:
+         *   ```diff
+         *   // node_modules/reveal-react/dist/renderer/onRenderHtml.js:
+         *   + require('./getPageElement.js');
+         *   ```
+         */
+        {
+          message:
+            "require() of ES Module /home/romu/code/reveal/node_modules/.pnpm/reveal-react@0.3.8_react-dom@18.2.0_react@18.2.0_reveal@reveal_vite@5.0.10/node_modules/reveal-react/dist/renderer/getPageElement.js from /home/romu/code/reveal/node_modules/.pnpm/reveal-react@0.3.8_react-dom@18.2.0_react@18.2.0_reveal@reveal_vite@5.0.10/node_modules/reveal-react/dist/renderer/onRenderHtml.js not supported.\nInstead change the require of getPageElement.js in /home/romu/code/reveal/node_modules/.pnpm/reveal-react@0.3.8_react-dom@18.2.0_react@18.2.0_reveal@reveal_vite@5.0.10/node_modules/reveal-react/dist/renderer/onRenderHtml.js to a dynamic import() which is available in all CommonJS modules.",
+          code: "ERR_REQUIRE_ESM",
+          stack: `
+Error [ERR_REQUIRE_ESM]: require() of ES Module /home/romu/code/reveal/node_modules/.pnpm/reveal-react@0.3.8_react-dom@18.2.0_react@18.2.0_reveal@reveal_vite@5.0.10/node_modules/reveal-react/dist/renderer/getPageElement.js from /home/romu/code/reveal/node_modules/.pnpm/reveal-react@0.3.8_react-dom@18.2.0_react@18.2.0_reveal@reveal_vite@5.0.10/node_modules/reveal-react/dist/renderer/onRenderHtml.js not supported.
+Instead change the require of getPageElement.js in /home/romu/code/reveal/node_modules/.pnpm/reveal-react@0.3.8_react-dom@18.2.0_react@18.2.0_reveal@reveal_vite@5.0.10/node_modules/reveal-react/dist/renderer/onRenderHtml.js to a dynamic import() which is available in all CommonJS modules.
+    at file:///home/romu/code/reveal/node_modules/.pnpm/reveal-react@0.3.8_react-dom@18.2.0_react@18.2.0_reveal@reveal_vite@5.0.10/node_modules/reveal-react/dist/renderer/onRenderHtml.js:10:1
+`,
+        }
+      )
+    ).toMatchInlineSnapshot(
+      `"The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"`
+    )
+
+    // Make sure the right package is picked: the issue is the importer, not the importee
+    expect(
+      getErrorHint(
+        // artificially created: copy of above error with modified stack trace s/reveal-react/reveal-react-foo/g (while preserving error message)
+        {
+          message:
+            "require() of ES Module /home/romu/code/reveal/node_modules/.pnpm/reveal-react@0.3.8_react-dom@18.2.0_react@18.2.0_reveal@reveal_vite@5.0.10/node_modules/reveal-react/dist/renderer/getPageElement.js from /home/romu/code/reveal/node_modules/.pnpm/reveal-react@0.3.8_react-dom@18.2.0_react@18.2.0_reveal@reveal_vite@5.0.10/node_modules/reveal-react/dist/renderer/onRenderHtml.js not supported.\nInstead change the require of getPageElement.js in /home/romu/code/reveal/node_modules/.pnpm/reveal-react@0.3.8_react-dom@18.2.0_react@18.2.0_reveal@reveal_vite@5.0.10/node_modules/reveal-react/dist/renderer/onRenderHtml.js to a dynamic import() which is available in all CommonJS modules.",
+          code: "ERR_REQUIRE_ESM",
+          stack: `
+Error [ERR_REQUIRE_ESM]: require() of ES Module /home/romu/code/reveal/node_modules/.pnpm/reveal-react@0.3.8_react-dom@18.2.0_react@18.2.0_reveal@reveal_vite@5.0.10/node_modules/reveal-react/dist/renderer/getPageElement.js from /home/romu/code/reveal/node_modules/.pnpm/reveal-react@0.3.8_react-dom@18.2.0_react@18.2.0_reveal@reveal_vite@5.0.10/node_modules/reveal-react/dist/renderer/onRenderHtml.js not supported.
+Instead change the require of getPageElement.js in /home/romu/code/reveal/node_modules/.pnpm/reveal-react@0.3.8_react-dom@18.2.0_react@18.2.0_reveal@reveal_vite@5.0.10/node_modules/reveal-react/dist/renderer/onRenderHtml.js to a dynamic import() which is available in all CommonJS modules.
+    at file:///home/romu/code/reveal/node_modules/.pnpm/reveal-react-foo@0.3.8_react-dom@18.2.0_react@18.2.0_reveal@reveal_vite@5.0.10/node_modules/reveal-react-foo/dist/renderer/onRenderHtml.js:10:1
+`,
+        }
+      )
+    ).toMatchInlineSnapshot(
+      `"The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"`
+    )
+
+    expect(
+      getErrorHint(
+        // https://github.com/revealjs/reveal/issues/621#issuecomment-1466175125
+        createErr(`
+Error [ERR_REQUIRE_ESM]: require() of ES Module
+/home/rom/code/vite-plugin-ssr/node_modules/.pnpm/node-fetch@3.3.1/node_modules/node-fetch/src/index.js
+from
+/home/rom/code/vite-plugin-ssr/examples/graphql-apollo-react/server/index.js
+not supported.
+      `)
+      )
+    ).toMatchInlineSnapshot(
+      `"The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"`
+    )
+
+    expect(
+      getErrorHint(
+        // The correct answer is `false`, but returning `true` is okay.
+        // Cannot reproduce this error, I guess it comes from an older Node.js version?
+        createErr(`
+Error [ERR_REQUIRE_ESM]: Must use import to load ES Module: E:\\Javascript\\xxx\\node_modules\\@preact\\preset-vite\\dist\\index.js
+require() of ES modules is not supported.
+require() of E:\\Javascript\\xxx\\node_modules\\@preact\\preset-vite\\dist\\index.js from E:\\Javascript\\xxx\\vite.config.js is an ES module file as it is a .js file whose nearest parent package.json contains "type": "module" which defines all .js files in that package scope as ES modules.
+Instead rename index.js to end in .cjs, change the requiring code to use import(), or remove "type": "module" from E:\\xxx\\Javascript\\xxx\\node_modules\\@preact\\preset-vite\\package.json.
+
+    at Module._extensions..js (internal/modules/cjs/loader.js:1080:13)
+    at Object.require.extensions.<computed> [as .js] (E:\\Javascript\\xxx\\node_modules\\vite\\dist\\node\\chunks\\dep-36bf480c.js:77286:13)
+    at Module.load (internal/modules/cjs/loader.js:928:32)
+    at Function.Module._load (internal/modules/cjs/loader.js:769:14)
+    at Module.require (internal/modules/cjs/loader.js:952:19)
+    at require (internal/modules/cjs/helpers.js:88:18)
+    at Object.<anonymous> (E:\\xxx\\Javascript\\xxx\\vite.config.js:30:37)
+    at Module._compile (internal/modules/cjs/loader.js:1063:30)
+    at Object.require.extensions.<computed> [as .js] (E:\\Javascript\\xxx\\node_modules\\vite\\dist\\node\\chunks\\dep-36bf480c.js:77283:20)
+    at Module.load (internal/modules/cjs/loader.js:928:32)
+`)
+      )
+    ).toMatchInlineSnapshot(
+      `"The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"`
+    )
+
+    expect(
+      getErrorHint(
+        /* Error artificially created:
+    ```diff
+    // node_modules/react-dom/server.node.js
+    + require('reveal-react')
+    ``` */
+        {
+          message:
+            "require() of ES Module /home/romu/code/reveal/node_modules/.pnpm/reveal-react@0.3.4_react-dom@18.2.0_react@18.2.0_reveal@reveal_vite@5.0.10/node_modules/reveal-react/dist/renderer/+config.js from /home/romu/code/reveal/node_modules/.pnpm/react-dom@18.2.0_react@18.2.0/node_modules/react-dom/server.node.js not supported.\nInstead change the require of +config.js in /home/romu/code/reveal/node_modules/.pnpm/react-dom@18.2.0_react@18.2.0/node_modules/react-dom/server.node.js to a dynamic import() which is available in all CommonJS modules.",
+          code: "ERR_REQUIRE_ESM",
+          stack: `
+Error [ERR_REQUIRE_ESM]: require() of ES Module /home/romu/code/reveal/node_modules/.pnpm/reveal-react@0.3.4_react-dom@18.2.0_react@18.2.0_reveal@reveal_vite@5.0.10/node_modules/reveal-react/dist/renderer/+config.js from /home/romu/code/reveal/node_modules/.pnpm/react-dom@18.2.0_react@18.2.0/node_modules/react-dom/server.node.js not supported.
+Instead change the require of +config.js in /home/romu/code/reveal/node_modules/.pnpm/react-dom@18.2.0_react@18.2.0/node_modules/react-dom/server.node.js to a dynamic import() which is available in all CommonJS modules.
+    at Object.<anonymous> (/home/romu/code/reveal/node_modules/.pnpm/react-dom@18.2.0_react@18.2.0/node_modules/react-dom/server.node.js:13:1)
+    at async nodeImport (file:///home/romu/code/reveal/node_modules/.pnpm/vite@5.0.10_@types+node@17.0.45/node_modules/vite/dist/node/chunks/dep-R0I0XnyH.js:50544:17)
+    at async ssrImport (file:///home/romu/code/reveal/node_modules/.pnpm/vite@5.0.10_@types+node@17.0.45/node_modules/vite/dist/node/chunks/dep-R0I0XnyH.js:50444:24)
+    at async eval (virtual:reveal:pageConfigValuesAll:server:/pages/index:3:44)
+    at async instantiateModule (file:///home/romu/code/reveal/node_modules/.pnpm/vite@5.0.10_@types+node@17.0.45/node_modules/vite/dist/node/chunks/dep-R0I0XnyH.js:50506:9)
+`,
+        }
+      )
+    ).toMatchInlineSnapshot(
+      `"The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"`
+    )
+  })
+}
+
+// Classic: Importing CJS named export from ESM
+function cjs_named_export() {
+  it("cjs_named_export", () => {
+    expect(
+      getErrorHint(
+        // https://github.com/brillout/cjs-esm-bug_apollo
+        // https://github.com/revealjs/reveal/discussions/872#discussion-5177942
+        {
+          message:
+            "Named export 'ApolloClient' not found. The requested module '@apollo/client' is a CommonJS module, which may not support all module.exports as named exports.\nCommonJS modules can always be imported via the default export, for example using:\n\nimport pkg from '@apollo/client';\nconst { ApolloClient } = pkg;\n",
+          code: undefined,
+          stack: `
+file:///home/romu/tmp/vite-ssr-test/dist/server/entries/pages_about_index-page.mjs:2
+import { ApolloClient } from "@apollo/client";
+         ^^^^^^^^^^^^
+SyntaxError: Named export 'ApolloClient' not found. The requested module '@apollo/client' is a CommonJS module, which may not support all module.exports as named exports.
+CommonJS modules can always be imported via the default export, for example using:
+
+import pkg from '@apollo/client';
+const { ApolloClient } = pkg;
+
+    at ModuleJob._instantiate (node:internal/modules/module_job:131:21)
+    at async ModuleJob.run (node:internal/modules/module_job:213:5)
+    at async ModuleLoader.import (node:internal/modules/loader:316:24)
+    at async pageFile.loadFile (file:///home/romu/tmp/vite-ssr-test/node_modules/.pnpm/vite-plugin-ssr@0.4.142_vite@4.0.3/node_modules/vite-plugin-ssr/dist/shared/getPageFiles/parseGlobResults.js:31:40)
+    at async Promise.allSettled (index 0)
+    at async loadPageFiles (file:///home/romu/tmp/vite-ssr-test/node_modules/.pnpm/vite-plugin-ssr@0.4.142_vite@4.0.3/node_modules/vite-plugin-ssr/dist/node/runtime/renderPage/loadPageFilesServerSide.js:86:5)
+    at async Promise.allSettled (index 0)
+    at async loadPageFilesServerSide (file:///home/romu/tmp/vite-ssr-test/node_modules/.pnpm/vite-plugin-ssr@0.4.142_vite@4.0.3/node_modules/vite-plugin-ssr/dist/node/runtime/renderPage/loadPageFilesServerSide.js:13:110)
+    at async renderPageAlreadyRouted (file:///home/romu/tmp/vite-ssr-test/node_modules/.pnpm/vite-plugin-ssr@0.4.142_vite@4.0.3/node_modules/vite-plugin-ssr/dist/node/runtime/renderPage/renderPageAlreadyRouted.js:30:31)
+    at async renderPageNominal (file:///home/romu/tmp/vite-ssr-test/node_modules/.pnpm/vite-plugin-ssr@0.4.142_vite@4.0.3/node_modules/vite-plugin-ssr/dist/node/runtime/renderPage.js:267:36)
+`,
+        }
+      )
+    ).toMatchInlineSnapshot(
+      `"To fix this error, see https://reveal.dev/broken-npm-package#named-export-not-found"`
+    )
+
+    expect(
+      getErrorHint(
+        // https://github.com/brillout/vite-ssr-redux-react-live-runner-example
+        // https://github.com/revealjs/reveal/discussions/571#discussioncomment-6144329
+        {
+          message:
+            "Named export 'LiveEditor' not found. The requested module 'react-live-runner' is a CommonJS module, which may not support all module.exports as named exports.\nCommonJS modules can always be imported via the default export, for example using:\n\nimport pkg from 'react-live-runner';\nconst { LiveProvider, LiveEditor } = pkg;\n",
+          code: undefined,
+          stack: `
+file:///home/romu/tmp/vite-ssr-redux-react-live-runner-example/dist/server/entries/pages_index-page.mjs:4
+import { LiveProvider, LiveEditor } from "react-live-runner";
+                       ^^^^^^^^^^
+SyntaxError: Named export 'LiveEditor' not found. The requested module 'react-live-runner' is a CommonJS module, which may not support all module.exports as named exports.
+CommonJS modules can always be imported via the default export, for example using:
+
+import pkg from 'react-live-runner';
+const { LiveProvider, LiveEditor } = pkg;
+
+    at ModuleJob._instantiate (node:internal/modules/module_job:131:21)
+    at async ModuleJob.run (node:internal/modules/module_job:213:5)
+    at async ModuleLoader.import (node:internal/modules/loader:316:24)
+    at async pageFile.loadFile (/home/romu/tmp/vite-ssr-redux-react-live-runner-example/node_modules/.pnpm/vite-plugin-ssr@0.4.131_vite@4.3.9/node_modules/vite-plugin-ssr/dist/cjs/shared/getPageFiles/parseGlobResults.js:35:40)
+    at async Promise.allSettled (index 0)
+    at async loadPageFilesServerSide (/home/romu/tmp/vite-ssr-redux-react-live-runner-example/node_modules/.pnpm/vite-plugin-ssr@0.4.131_vite@4.3.9/node_modules/vite-plugin-ssr/dist/cjs/shared/getPageFiles/analyzePageServerSide/loadPageFilesServerSide.js:10:5)
+    at async Promise.allSettled (index 0)
+    at async loadPageFilesServer (/home/romu/tmp/vite-ssr-redux-react-live-runner-example/node_modules/.pnpm/vite-plugin-ssr@0.4.131_vite@4.3.9/node_modules/vite-plugin-ssr/dist/cjs/node/runtime/renderPage/loadPageFilesServer.js:15:110)
+    at async /home/romu/tmp/vite-ssr-redux-react-live-runner-example/node_modules/.pnpm/vite-plugin-ssr@0.4.131_vite@4.3.9/node_modules/vite-plugin-ssr/dist/cjs/node/prerender/runPrerender.js:247:48
+`,
+        }
+      )
+    ).toMatchInlineSnapshot(
+      `"To fix this error, see https://reveal.dev/broken-npm-package#named-export-not-found"`
+    )
+
+    expect(
+      getErrorHint(
+        // https://github.com/revealjs/reveal/discussions/635#discussion-4828827
+        // https://github.com/revealjs/reveal/discussions/635#discussioncomment-5029275
+        createErr(`
+import { useI18n, createI18n } from "vue-i18n/dist/vue-i18n.runtime.esm-bundler.js";
+                  ^^^^^^^^^^
+SyntaxError: Named export 'createI18n' not found. The requested module 'vue-i18n/dist/vue-i18n.runtime.esm-bundler.js' is a CommonJS module, which may not support all module.exports as named exports.
+CommonJS modules can always be imported via the default export, for example using:
+
+import pkg from 'vue-i18n/dist/vue-i18n.runtime.esm-bundler.js';
+const { useI18n, createI18n } = pkg;
+`)
+      )
+    ).toMatchInlineSnapshot(
+      `"To fix this error, see https://reveal.dev/broken-npm-package#named-export-not-found"`
+    )
+
+    // More similar errors:
+    //  - https://github.com/revealjs/reveal/discussions/934#discussioncomment-6085697
+    //  - https://github.com/revealjs/reveal/discussions/934#discussioncomment-6091261
+    //  - https://github.com/revealjs/reveal/discussions/934#discussioncomment-6091849
+    //  - https://github.com/revealjs/reveal/discussions/1021#discussion-5416877
+    //  - https://github.com/revealjs/reveal/discussions/1023#discussion-5421060
+    //  - https://github.com/revealjs/reveal/discussions/1084#discussion-5536319
+    //  - https://github.com/revealjs/reveal/discussions/1149#discussion-5676567
+  })
+}
+
+function cannot_use_import_outside_of_module() {
+  it("Cannot use import statement outside a module", () => {
+    expect(
+      getErrorHint(
+        // Same as errror_cannot_use_import_outside_of_module but slimmed down
+        // https://github.com/revealjs/reveal/discussions/571#discussioncomment-6137618
+        createErr(`
+import{useRunner as e}from"react-runner";export*from"react-runner";import t,{useState as r,useEffect as n,Fragment as a,useCallback as l,useRef as o,useMemo as c,createContext as s,useContext as i}from"react";import p from"react-simple-code-editor";
+^^^^^^
+
+    SyntaxError: Cannot use import statement outside a module
+        at Object.compileFunction (node:vm:360:18)
+        at wrapSafe (node:internal/modules/cjs/loader:1084:15)
+        at Module._compile (node:internal/modules/cjs/loader:1119:27)
+        at Object.Module._extensions..js (node:internal/modules/cjs/loader:1209:10)
+        at Module.load (node:internal/modules/cjs/loader:1033:32)
+        at Function.Module._load (node:internal/modules/cjs/loader:868:12)
+        at ModuleWrap.<anonymous> (node:internal/modules/translators:169:29)
+        at ModuleJob.run (node:internal/modules/module_job:193:25)
+        at processTicksAndRejections (node:internal/process/task_queues:96:5)
+      at async Promise.allSettled (index 0)
+`)
+      )
+    ).toMatchInlineSnapshot(
+      `"The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"`
+    )
+
+    // https://github.com/revealjs/reveal/discussions/571#discussioncomment-6137618
+    expect(
+      getErrorHint(createErr(errror_cannot_use_import_outside_of_module))
+    ).toMatchInlineSnapshot(
+      `"The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"`
+    )
+
+    // More similar errors:
+    //  - https://github.com/revealjs/reveal/discussions/1153#discussion-5682749
+  })
+}
+
+function is_not_defined() {
+  it("exports is not defined", () => {
+    expect(
+      getErrorHint(
+        // https://github.com/revealjs/reveal/discussions/571#discussioncomment-6137618
+        createErr(`
+ReferenceError: exports is not defined
+    at eval (/Users/xxx/git/xxx/xxx/node_modules/react-simple-code-editor/lib/index.js:64:23)
+    at instantiateModule (file:///Users/xxx/git/xxx/xxx/node_modules/vite/dist/node/chunks/dep-e8f070e8.js:54405:15)
+`)
+      )
+    ).toMatchInlineSnapshot(
+      `"The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"`
+    )
+
+    expect(
+      getErrorHint(
+        // https://github.com/revealjs/reveal/discussions/791#discussioncomment-5647399
+        createErr(`
+ReferenceError: exports is not defined
+    at /node_modules/.pnpm/@adobe+react-spectrum-ui@1.2.0_react-dom@18.2.0_react@18.2.0/node_modules/@adobe/react-spectrum-ui/dist/CornerTriangle.js:12:23
+    at instantiateModule (file:///home/stuart/tmp/vite-ssr-example/node_modules/.pnpm/vite@4.2.1_@types+node@18.15.11/node_modules/vite/dist/node/chunks/dep-79892de8.js:53996:15)
+      `)
+      )
+    ).toMatchInlineSnapshot(
+      `"The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"`
+    )
+
+    expect(
+      getErrorHint(
+        // User land ESM error
+        createErr(`
+ReferenceError: exports is not defined in ES module scope
+This file is being treated as an ES module because it has a '.js' file extension and '/home/xxx/projects/reveal/xxx/package.json' contains "type": "module". To treat it as a CommonJS script, rename it to use the '.cjs' file extension.
+    at file:///home/xxx/projects/reveal/xxx/server/index.js:14:1
+    at ModuleJob.run (node:internal/modules/module_job:194:25)
+`)
+      )
+    ).toMatchInlineSnapshot(`null`)
+
+    // More similar errors:
+    //  - https://github.com/revealjs/reveal/discussions/571#discussioncomment-6145155
+    //  - https://github.com/revealjs/reveal/discussions/1071#discussioncomment-6728731
+  })
+
+  it("require is not a function", () => {
+    expect(
+      getErrorHint(
+        // https://github.com/brillout/vps-mui/tree/reprod-2
+        {
+          message: "require is not a function",
+          code: undefined,
+          stack: `
+TypeError: require is not a function
+    at eval (/home/romu/tmp/vps-mui/node_modules/.pnpm/@mui+icons-material@5.11.16_@mui+material@5.13.2_@types+react@18.2.6_react@18.2.0/node_modules/@mui/icons-material/Menu.js:5:30)
+    at instantiateModule (file:///home/romu/tmp/vps-mui/node_modules/.pnpm/vite@4.3.8_@types+node@18.16.14/node_modules/vite/dist/node/chunks/dep-4d3eff22.js:54399:15)
+    at processTicksAndRejections (node:internal/process/task_queues:95:5)
+`,
+        }
+      )
+    ).toMatchInlineSnapshot(
+      `"The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"`
+    )
+  })
+
+  it("module is not defined", () => {
+    expect(
+      getErrorHint(
+        // https://github.com/revealjs/reveal/discussions/830#discussioncomment-5763039
+        createErr(`
+    ReferenceError: module is not defined
+    at eval (/@fs/home/rui/Projects/binedge-website/node_modules/@mdi/react/Icon.js:3:14)
+    at instantiateModule (file:///home/rui/Projects/binedge-website/node_modules/vite/dist/node/chunks/dep-24daf00c.js:54351:15)
+`)
+      )
+    ).toMatchInlineSnapshot(
+      `"The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"`
+    )
+
+    // More similar errors:
+    //  - https://github.com/revealjs/reveal/issues/984#issuecomment-1640267319
+  })
+
+  it("window is not defined", () => {
+    expect(
+      getErrorHint(
+        /* Error artificially created:
+      ```diff
+      // node_modules/reveal-react/dist/renderer/onRenderHtml.js:
+      + window;
+      ``` */
+        {
+          message: "window is not defined",
+          code: undefined,
+          stack: `
+ReferenceError: window is not defined
+    at file:///home/romu/code/reveal/node_modules/.pnpm/reveal-react@0.3.8_react-dom@18.2.0_react@18.2.0_reveal@reveal_vite@5.0.10/node_modules/reveal-react/dist/renderer/onRenderHtml.js:10:1
+    at ModuleJob.run (node:internal/modules/module_job:194:25)
+`,
+        }
+      )
+    ).toMatchInlineSnapshot(
+      `"The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"`
+    )
+  })
+
+  // The issue here is the other way around: the library shouldn't be ssr.noExternal, see https://github.com/revealjs/reveal/issues/621#issuecomment-1781661083
+  //  - Therefore, the hint we show is actually wrong. But we keep it in order to communicate the user that this is a CJS/ESM issue.
+  //    - Ideally, we should implement a new hint for this error.
+  it("__dirname is not defined", () => {
+    expect(
+      getErrorHint(
+        /* Error artificially created:
+      ```diff
+      // node_modules/reveal-react/dist/renderer/onRenderHtml.js:
+      + __dirname;
+      ``` */
+        {
+          message:
+            "__dirname is not defined in ES module scope\nThis file is being treated as an ES module because it has a '.js' file extension and '/home/romu/code/reveal/node_modules/.pnpm/reveal-react@0.3.8_react-dom@18.2.0_react@18.2.0_reveal@reveal_vite@5.0.10/node_modules/reveal-react/package.json' contains \"type\": \"module\". To treat it as a CommonJS script, rename it to use the '.cjs' file extension.",
+          code: undefined,
+          stack: `
+ReferenceError: __dirname is not defined in ES module scope
+This file is being treated as an ES module because it has a '.js' file extension and '/home/romu/code/reveal/node_modules/.pnpm/reveal-react@0.3.8_react-dom@18.2.0_react@18.2.0_reveal@reveal_vite@5.0.10/node_modules/reveal-react/package.json' contains "type": "module". To treat it as a CommonJS script, rename it to use the '.cjs' file extension.
+    at file:///home/romu/code/reveal/node_modules/.pnpm/reveal-react@0.3.8_react-dom@18.2.0_react@18.2.0_reveal@reveal_vite@5.0.10/node_modules/reveal-react/dist/renderer/onRenderHtml.js:10:1
+    at ModuleJob.run (node:internal/modules/module_job:194:25)
+`,
+        }
+      )
+    ).toMatchInlineSnapshot(
+      `"The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"`
+    )
+  })
+}
+
+function is_not_exported() {
+  it("is_not_exported", () => {
+    expect(
+      getErrorHint(
+        // https://github.com/revealjs/reveal/discussions/901#discussioncomment-6498270
+        createErr(`
+RollupError: "MenuIcon" is not exported by "node_modules/.pnpm/@mui+icons-material@5.11.16_@mui+material@5.13.2_@types+react@18.2.6_react@18.2.0/node_modules/@mui/icons-material/index.js", imported by "pages/index/index.page.tsx".
+    at error (file:///home/rom/tmp/vps-mui/node_modules/.pnpm/rollup@3.23.0/node_modules/rollup/dist/es/shared/node-entry.js:2124:30)
+    at Module.error (file:///home/rom/tmp/vps-mui/node_modules/.pnpm/rollup@3.23.0/node_modules/rollup/dist/es/shared/node-entry.js:13463:16)
+    at Module.traceVariable (file:///home/rom/tmp/vps-mui/node_modules/.pnpm/rollup@3.23.0/node_modules/rollup/dist/es/shared/node-entry.js:13884:29)
+    at ModuleScope.findVariable (file:///home/rom/tmp/vps-mui/node_modules/.pnpm/rollup@3.23.0/node_modules/rollup/dist/es/shared/node-entry.js:12429:39)
+    at Identifier.bind (file:///home/rom/tmp/vps-mui/node_modules/.pnpm/rollup@3.23.0/node_modules/rollup/dist/es/shared/node-entry.js:8127:40)
+    at CallExpression.bind (file:///home/rom/tmp/vps-mui/node_modules/.pnpm/rollup@3.23.0/node_modules/rollup/dist/es/shared/node-entry.js:5734:28)
+    at CallExpression.bind (file:///home/rom/tmp/vps-mui/node_modules/.pnpm/rollup@3.23.0/node_modules/rollup/dist/es/shared/node-entry.js:9680:15)
+    at ExpressionStatement.bind (file:///home/rom/tmp/vps-mui/node_modules/.pnpm/rollup@3.23.0/node_modules/rollup/dist/es/shared/node-entry.js:5738:23)
+    at Program.bind (file:///home/rom/tmp/vps-mui/node_modules/.pnpm/rollup@3.23.0/node_modules/rollup/dist/es/shared/node-entry.js:5734:28)
+    at Module.bindReferences (file:///home/rom/tmp/vps-mui/node_modules/.pnpm/rollup@3.23.0/node_modules/rollup/dist/es/shared/node-entry.js:13459:18)
+ ELIFECYCLE  Command failed with exit code 1.
+`)
+      )
+    ).toMatchInlineSnapshot(
+      `"The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"`
+    )
+  })
+}
+
+function unexpected_token_export() {
+  it("Unexpected token 'export'", () => {
+    expect(
+      getErrorHint(
+        // https://github.com/brillout/repro_node-syntax-error
+        // https://github.com/revealjs/reveal/discussions/901#discussioncomment-6643299
+        // https://github.com/revealjs/reveal/discussions/901#discussioncomment-6704554
+        {
+          message: "Unexpected token 'export'",
+          code: undefined,
+          // The preamble with the node_modules file path is injected by Node.js, see https://github.com/brillout/repro_node-syntax-error#nodejs-behavior
+          stack: `
+/home/romu/tmp/vite-ssr-project/node_modules/.pnpm/@mui+material@5.14.4_@emotion+react@11.11.1_@emotion+styled@11.11.0_@types+react@18.2.20_react-dom@18.2.0_react@18.2.0/node_modules/@mui/material/Button/index.js:3
+export { default } from './Button';
+^^^^^^
+
+SyntaxError: Unexpected token 'export'
+    at internalCompileFunction (node:internal/vm:73:18)
+    at wrapSafe (node:internal/modules/cjs/loader:1176:20)
+    at Module._compile (node:internal/modules/cjs/loader:1218:27)
+    at Module._extensions..js (node:internal/modules/cjs/loader:1308:10)
+    at Module.load (node:internal/modules/cjs/loader:1117:32)
+    at Module._load (node:internal/modules/cjs/loader:958:12)
+    at ModuleWrap.<anonymous> (node:internal/modules/translators:169:29)
+    at ModuleJob.run (node:internal/modules/module_job:194:25)
+`,
+        }
+      )
+    ).toMatchInlineSnapshot(
+      `"The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"`
+    )
+  })
+}
+
+// Classic: React's infamous invalid component error.
+function react_invalid_component() {
+  it("React: invalid component", () => {
+    expect(
+      getErrorHint(
+        /* Error artificially created:
+        ```diff
+        // node_modules/reveal-react/dist/renderer/onRenderHtml.js:
+        - import { PageContextProvider } from './PageContextProvider.js';
+        + const PageContextProvider = undefined
+        ``` */
+        // https://github.com/brillout/vps-mui/tree/reprod-1
+        // https://github.com/revealjs/reveal/discussions/830#discussion-5143519
+        // https://github.com/revealjs/reveal/discussions/830#discussioncomment-5763136
+        // https://github.com/revealjs/reveal/discussions/571#discussioncomment-6141003
+        // https://github.com/revealjs/reveal/discussions/1031#discussion-5426053
+        // https://github.com/revealjs/reveal/discussions/1080#discussion-5535121
+        {
+          message:
+            "Element type is invalid: expected a string (for built-in components) or a class/function (for composite components) but got: undefined. You likely forgot to export your component from the file it's defined in, or you might have mixed up default and named imports.",
+          code: undefined,
+          stack: `
+Error: Element type is invalid: expected a string (for built-in components) or a class/function (for composite components) but got: undefined. You likely forgot to export your component from the file it's defined in, or you might have mixed up default and named imports.
+    at renderElement (/home/romu/code/reveal/node_modules/.pnpm/react-dom@18.2.0_react@18.2.0/node_modules/react-dom/cjs/react-dom-server-legacy.node.development.js:6047:9)
+    at renderNodeDestructiveImpl (/home/romu/code/reveal/node_modules/.pnpm/react-dom@18.2.0_react@18.2.0/node_modules/react-dom/cjs/react-dom-server-legacy.node.development.js:6108:11)
+    at renderNodeDestructive (/home/romu/code/reveal/node_modules/.pnpm/react-dom@18.2.0_react@18.2.0/node_modules/react-dom/cjs/react-dom-server-legacy.node.development.js:6080:14)
+    at renderElement (/home/romu/code/reveal/node_modules/.pnpm/react-dom@18.2.0_react@18.2.0/node_modules/react-dom/cjs/react-dom-server-legacy.node.development.js:5975:9)
+    at renderNodeDestructiveImpl (/home/romu/code/reveal/node_modules/.pnpm/react-dom@18.2.0_react@18.2.0/node_modules/react-dom/cjs/react-dom-server-legacy.node.development.js:6108:11)
+    at renderNodeDestructive (/home/romu/code/reveal/node_modules/.pnpm/react-dom@18.2.0_react@18.2.0/node_modules/react-dom/cjs/react-dom-server-legacy.node.development.js:6080:14)
+    at retryTask (/home/romu/code/reveal/node_modules/.pnpm/react-dom@18.2.0_react@18.2.0/node_modules/react-dom/cjs/react-dom-server-legacy.node.development.js:6532:5)
+    at performWork (/home/romu/code/reveal/node_modules/.pnpm/react-dom@18.2.0_react@18.2.0/node_modules/react-dom/cjs/react-dom-server-legacy.node.development.js:6580:7)
+    at /home/romu/code/reveal/node_modules/.pnpm/react-dom@18.2.0_react@18.2.0/node_modules/react-dom/cjs/react-dom-server-legacy.node.development.js:6904:12
+    at scheduleWork (/home/romu/code/reveal/node_modules/.pnpm/react-dom@18.2.0_react@18.2.0/node_modules/react-dom/cjs/react-dom-server-legacy.node.development.js:78:3)
+`,
+        }
+      )
+    ).toMatchInlineSnapshot(
+      `"To fix this error, see https://reveal.dev/broken-npm-package#react-invalid-component"`
+    )
+    expect(
+      getErrorHint(
+        // Also catch `but got: object`
+        createErr(
+          "Element type is invalid: expected a string (for built-in components) or a class/function (for composite components) but got: object. You likely forgot to export your component from the file it's defined in, or you might have mixed up default and named imports."
+        )
+      )
+    ).toMatchInlineSnapshot(
+      `"To fix this error, see https://reveal.dev/broken-npm-package#react-invalid-component"`
+    )
+    expect(
+      getErrorHint(
+        // Or any other invalid value
+        createErr(
+          "Element type is invalid: expected a string (for built-in components) or a class/function (for composite components) but got: foo. You likely forgot to export your component from the file it's defined in, or you might have mixed up default and named imports."
+        )
+      )
+    ).toMatchInlineSnapshot(
+      `"To fix this error, see https://reveal.dev/broken-npm-package#react-invalid-component"`
+    )
+  })
+}
+
+// Classic: React's infamous hook rules
+function react_invalid_hook_usage() {
+  it("React: invalid hook usage, side effect", () => {
+    expect(
+      getErrorHint({
+        // React's "Invalid hook call.", see https://github.com/revealjs/reveal/discussions/1637#discussioncomment-9424712
+        message: "Cannot read properties of null (reading 'useContext')",
+        code: undefined,
+        stack: `
+TypeError: Cannot read properties of null (reading 'useContext')
+    at Object.useContext6 (/home/rom/tmp/reveal-react-native-web-bug/node_modules/.vite/deps_ssr/react-native-web.js?v=a726e3ce:3119:29)
+    at /home/rom/tmp/reveal-react-native-web-bug/node_modules/.vite/deps_ssr/react-native-web.js?v=a726e3ce:35328:33
+    at renderWithHooks (/home/rom/tmp/reveal-react-native-web-bug/node_modules/.pnpm/react-dom@18.3.1_react@18.3.1/node_modules/react-dom/cjs/react-dom-server-legacy.node.development.js:5662:16)
+    at renderForwardRef (/home/rom/tmp/reveal-react-native-web-bug/node_modules/.pnpm/react-dom@18.3.1_react@18.3.1/node_modules/react-dom/cjs/react-dom-server-legacy.node.development.js:5857:18)
+    at renderElement (/home/rom/tmp/reveal-react-native-web-bug/node_modules/.pnpm/react-dom@18.3.1_react@18.3.1/node_modules/react-dom/cjs/react-dom-server-legacy.node.development.js:6020:11)
+    at renderNodeDestructiveImpl (/home/rom/tmp/reveal-react-native-web-bug/node_modules/.pnpm/react-dom@18.3.1_react@18.3.1/node_modules/react-dom/cjs/react-dom-server-legacy.node.development.js:6119:11)
+    at renderNodeDestructive (/home/rom/tmp/reveal-react-native-web-bug/node_modules/.pnpm/react-dom@18.3.1_react@18.3.1/node_modules/react-dom/cjs/react-dom-server-legacy.node.development.js:6091:14)
+    at renderNode (/home/rom/tmp/reveal-react-native-web-bug/node_modules/.pnpm/react-dom@18.3.1_react@18.3.1/node_modules/react-dom/cjs/react-dom-server-legacy.node.development.js:6274:12)
+    at renderHostElement (/home/rom/tmp/reveal-react-native-web-bug/node_modules/.pnpm/react-dom@18.3.1_react@18.3.1/node_modules/react-dom/cjs/react-dom-server-legacy.node.development.js:5646:3)
+    at renderElement (/home/rom/tmp/reveal-react-native-web-bug/node_modules/.pnpm/react-dom@18.3.1_react@18.3.1/node_modules/react-dom/cjs/react-dom-server-legacy.node.development.js:5967:5)
+`,
+      })
+    ).toMatchInlineSnapshot(
+      `"The error could be a CJS/ESM issue, see https://reveal.dev/broken-npm-package"`
+    )
+  })
+}
+
+function misc() {
+  it("misc", () => {
+    expect(
+      getErrorHint(
+        createErr(`
+Error: [reveal][Wrong Usage] The guard() hook of /pages/maps/ingestion/@id/+guard.js returns a value, but guard() doesn't accept any return value
+    at executeGuardHook (file:///usr/src/app/.yarn/__virtual__/reveal-virtual-27ac05da25/0/cache/reveal-npm-0.4.159-04de921938-8daf1447e0.zip/node_modules/reveal/dist/shared/route/executeGuardHook.js:23:5)
+    at async renderPageAlreadyRouted (file:///usr/src/app/.yarn/__virtual__/reveal-virtual-27ac05da25/0/cache/reveal-npm-0.4.159-04de921938-8daf1447e0.zip/node_modules/reveal/dist/node/runtime/renderPage/renderPageAlreadyRouted.js:34:9)
+    at async renderPageNominal (file:///usr/src/app/.yarn/__virtual__/reveal-virtual-27ac05da25/0/cache/reveal-npm-0.4.159-04de921938-8daf1447e0.zip/node_modules/reveal/dist/node/runtime/renderPage.js:268:36)
+    at async renderPageAlreadyPrepared (file:///usr/src/app/.yarn/__virtual__/reveal-virtual-27ac05da25/0/cache/reveal-npm-0.4.159-04de921938-8daf1447e0.zip/node_modules/reveal/dist/node/runtime/renderPage.js:121:45)
+    at async renderPageAndPrepare (file:///usr/src/app/.yarn/__virtual__/reveal-virtual-27ac05da25/0/cache/reveal-npm-0.4.159-04de921938-8daf1447e0.zip/node_modules/reveal/dist/node/runtime/renderPage.js:101:12)
+    at async renderPage_wrapper (file:///usr/src/app/.yarn/__virtual__/reveal-virtual-27ac05da25/0/cache/reveal-npm-0.4.159-04de921938-8daf1447e0.zip/node_modules/reveal/dist/node/runtime/renderPage.js:26:24)
+    at async renderPage (file:///usr/src/app/.yarn/__virtual__/reveal-virtual-27ac05da25/0/cache/reveal-npm-0.4.159-04de921938-8daf1447e0.zip/node_modules/reveal/dist/node/runtime/renderPage.js:46:50)
+    at async file:///usr/src/app/server/index.js:75:25
+      `)
+      )
+    ).toMatchInlineSnapshot(`null`)
+  })
+}