fix(docs): use dynamic import for globby ESM module

[blackgirlbytes]

Summary

globby v13+ is ESM-only and cannot be imported with require() in CommonJS files. This causes npm run build to fail with:

TypeError: globby is not a function

Root Cause

• CI uses Node 20 where ESM interop still allows this to partially work
• Local development with Node 22+ (e.g., Node 25) is stricter about ESM/CJS boundaries and throws the error

Fix

Use dynamic import instead of require():

const globby = (await import('globby')).default;

Files Changed

• documentation/scripts/generate-docs-map.js
• documentation/plugins/markdown-export.cjs

Testing

• npm run build now succeeds on Node 25

[Copilot]

Pull request overview

This PR updates the documentation build tooling to correctly load the ESM-only globby package from CommonJS contexts, fixing npm run build failures on newer Node versions.

Changes:

• Replace CommonJS require('globby') usage in generate-docs-map.js with an async dynamic import('globby') to access the default export.
• Update the Docusaurus markdown-export plugin to dynamically import globby within the async postBuild hook.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File	Description
documentation/scripts/generate-docs-map.js	Switches to const globby = (await import('globby')).default; inside main() so the docs map generator works with globby’s ESM-only export on modern Node.
documentation/plugins/markdown-export.cjs	Uses dynamic import inside the async postBuild hook to obtain globby’s default export before globbing markdown files for export.

[github-actions]

PR Preview Action v1.6.3
Preview removed because the pull request was closed.
2026-01-22 16:38 UTC