docs: validate that the docs can be parsed by mdx

Although our documentation is rendered for the "in the box" docs by
cmark-gfm, the upstream docs site (docs.npmjs.com) uses mdx, which is
a much stricter parser.  Update our docs generator site to ensure that
mdx can parse our documentation as well, to ensure that we get fast
feedback when it would fail.

PR-URL: https://github.com/npm/cli/pull/2711
Credit: @ethomson
Close: #2711
Reviewed-by: @darcyclarke

1 files changed, 83 insertions, 0 deletions

diff --git a/node_modules/.gitignore b/node_modules/.gitignore
index 02d92c067..df322e6a0 100644
--- a/node_modules/.gitignore
+++ b/node_modules/.gitignore
@@ -2,19 +2,38 @@
 /.package-lock.json
 package-lock.json
 /@babel/code-frame
+/@babel/core
 /@babel/generator
 /@babel/helper-function-name
 /@babel/helper-get-function-arity
+/@babel/helper-member-expression-to-functions
+/@babel/helper-module-imports
+/@babel/helper-module-transforms
+/@babel/helper-optimise-call-expression
+/@babel/helper-plugin-utils
+/@babel/helper-replace-supers
+/@babel/helper-simple-access
 /@babel/helper-split-export-declaration
 /@babel/helper-validator-identifier
+/@babel/helpers
 /@babel/highlight
 /@babel/parser
+/@babel/plugin-proposal-object-rest-spread
+/@babel/plugin-syntax-jsx
+/@babel/plugin-syntax-object-rest-spread
+/@babel/plugin-transform-parameters
 /@babel/template
 /@babel/traverse
 /@babel/types
 /@blueoak/list
 /@eslint/eslintrc
+/@mdx-js/mdx
+/@mdx-js/util
+/@types/hast
 /@types/json5
+/@types/mdast
+/@types/parse5
+/@types/unist
 /abab
 /acorn
 /acorn-globals
@@ -30,6 +49,9 @@ package-lock.json
 /array.prototype.flat
 /astral-regex
 /async-hook-domain
+/babel-plugin-apply-mdx-type-prop
+/babel-plugin-extract-import-names
+/bail
 /base64-js
 /bind-obj-methods
 /bindings
@@ -43,10 +65,17 @@ package-lock.json
 /caller
 /callsites
 /camelcase
+/camelcase-css
+/ccount
+/character-entities
+/character-entities-legacy
+/character-reference-invalid
 /chokidar
 /cliui
 /cmark-gfm
+/collapse-white-space
 /color-support
+/comma-separated-tokens
 /commondir
 /contains-path
 /convert-source-map
@@ -64,6 +93,7 @@ package-lock.json
 /deep-is
 /default-require-extensions
 /define-properties
+/detab
 /detect-libc
 /diff-frag
 /docopt
@@ -115,6 +145,7 @@ package-lock.json
 /fsevents
 /function-loop
 /functional-red-black-tree
+/gensync
 /get-caller-file
 /get-intrinsic
 /github-from-package
@@ -122,24 +153,40 @@ package-lock.json
 /globals
 /has-symbols
 /hasha
+/hast-to-hyperscript
+/hast-util-from-parse5
+/hast-util-parse-selector
+/hast-util-raw
+/hast-util-to-parse5
+/hastscript
 /html-encoding-sniffer
 /html-escaper
+/html-void-elements
 /ieee754
 /ignore
 /import-fresh
+/inline-style-parser
+/is-alphabetical
+/is-alphanumerical
 /is-arrayish
 /is-binary-path
+/is-buffer
 /is-callable
 /is-date-object
+/is-decimal
 /is-extglob
 /is-glob
+/is-hexadecimal
 /is-negative-zero
 /is-number
+/is-plain-obj
 /is-potential-custom-element-name
 /is-regex
 /is-stream
 /is-string
 /is-symbol
+/is-whitespace-character
+/is-word-character
 /istanbul-lib-coverage
 /istanbul-lib-hook
 /istanbul-lib-instrument
@@ -164,12 +211,18 @@ package-lock.json
 /lodash
 /lodash.flattendeep
 /lodash.sortby
+/lodash.uniq
 /log-driver
 /loose-envify
 /make-dir
 /make-error
+/markdown-escapes
 /marked
 /marked-man
+/mdast-squeeze-paragraphs
+/mdast-util-definitions
+/mdast-util-to-hast
+/mdurl
 /merge-source-map
 /mimic-response
 /minimist
@@ -201,6 +254,7 @@ package-lock.json
 /p-try
 /package-hash
 /parent-module
+/parse-entities
 /parse-json
 /parse5
 /path-exists
@@ -214,6 +268,7 @@ package-lock.json
 /prelude-ls
 /progress
 /prop-types
+/property-information
 /pseudomap
 /pump
 /queue-microtask
@@ -226,6 +281,11 @@ package-lock.json
 /readdirp
 /regexpp
 /release-zalgo
+/remark-footnotes
+/remark-mdx
+/remark-parse
+/remark-squeeze-paragraphs
+/repeat-string
 /request-promise-core
 /request-promise-native
 /require-directory
@@ -242,6 +302,7 @@ package-lock.json
 /slice-ansi
 /source-map
 /source-map-support
+/space-separated-tokens
 /spawn-wrap
 /spdx-compare
 /spdx-expression-validate
@@ -250,11 +311,13 @@ package-lock.json
 /spdx-whitelisted
 /sprintf-js
 /stack-utils
+/state-toggle
 /stealthy-require
 /string.prototype.trimend
 /string.prototype.trimstart
 /strip-bom
 /strip-json-comments
+/style-to-object
 /symbol-tree
 /table
 /tap
@@ -269,18 +332,36 @@ package-lock.json
 /to-regex-range
 /tough-cookie
 /tr46
+/trim
+/trim-trailing-lines
 /trivial-deferred
+/trough
 /ts-node
 /tsconfig-paths
 /type-check
 /type-fest
 /typescript
+/unherit
 /unicode-length
+/unified
+/unist-builder
+/unist-util-generated
+/unist-util-is
+/unist-util-position
+/unist-util-remove
+/unist-util-remove-position
+/unist-util-stringify-position
+/unist-util-visit
+/unist-util-visit-parents
 /util-promisify
 /v8-compile-cache
+/vfile
+/vfile-location
+/vfile-message
 /vlq
 /w3c-hr-time
 /w3c-xmlserializer
+/web-namespaces
 /webidl-conversions
 /whatwg-encoding
 /whatwg-mimetype
@@ -292,9 +373,11 @@ package-lock.json
 /ws
 /xml-name-validator
 /xmlchars
+/xtend
 /y18n
 /yaml
 /yapool
 /yargs
 /yargs-parser
 /yn
+/zwitch