Repository: mdx-js/mdx-analyzer (js)

Issue:
TypeScript error since 1.8.0
### Initial checklist

- [X] I read the [support docs](https://mdxjs.com/community/support/)
- [X] I read the [contributing guide](https://mdxjs.com/community/contribute/)
- [X] I agree to follow the [code of conduct](https://github.com/mdx-js/.github/blob/HEAD/code-of-conduct.md)
- [X] I searched [issues](https://github.com/search?q=user%3Amdx-js&type=Issues) and couldn’t find anything (or linked relevant results below)

### Affected packages and versions

1.8.0

### Link to runnable example

_No response_

### Steps to reproduce

Since installing 1.8.0, I see the following TypeScript error when editing an `.mdx` file in my Astro project. I'm in the text area after the frontmatter. My project builds: if there is an actual TS error, I am unaware of it.

```
'_components' is declared but its value is never read. ts-plugin (6133)
The signature '(props: { readonly components?: {} | undefined; 3): any' of ' _createMdxContent' is deprecated. ts-plugin (6387)
22.00.0030-play-site-shutdown.mdx (18, 4): The declaration was marked as deprecated here.
```

Downgrading to 1.7.3 confirms that this is a new issue.

### Expected behavior

No error is shown.

### Actual behavior

An error is shown.

### Runtime

Node v20

### Package manager

npm v10

### OS

macOS

### Build and bundle tools

Vite, Other (please specify in steps to reproduce)

Pull request description:
Use @internal to mark internal APIs
### Initial checklist

*   [x] I read the support docs <!-- https://github.com/unifiedjs/.github/blob/main/support.md -->
*   [x] I read the contributing guide <!-- https://github.com/unifiedjs/.github/blob/main/contributing.md -->
*   [x] I agree to follow the code of conduct <!-- https://github.com/unifiedjs/.github/blob/main/code-of-conduct.md -->
*   [x] I searched issues and couldn’t find anything (or linked relevant results below) <!-- https://github.com/search?q=user%3Aunifiedjs&type=Issues -->
*   [x] If applicable, I’ve added docs and tests

### Description of changes

Before `@deprecated` was used. This is technically incorrect. Internal APIs should not be used, but they aren’t deprecated either. The problem is `@deprecated` generates diagnostics the user shouldn’t see.

Closes #408

<!--do not edit: pr-->


Patch:
diff --git a/.changeset/afraid-snakes-agree.md b/.changeset/afraid-snakes-agree.md
new file mode 100644
index 0000000..fceeb86
--- /dev/null
+++ b/.changeset/afraid-snakes-agree.md
@@ -0,0 +1,5 @@
+---
+"@mdx-js/language-service": patch
+---
+
+Mark MDX internals with `@internal`, not `@deprecated`.
diff --git a/.changeset/proud-trains-prove.md b/.changeset/proud-trains-prove.md
new file mode 100644
index 0000000..67ba2eb
--- /dev/null
+++ b/.changeset/proud-trains-prove.md
@@ -0,0 +1,5 @@
+---
+"@mdx-js/language-service": patch
+---
+
+Always mark the internal variable `_components` as used.
diff --git a/packages/language-service/lib/virtual-code.js b/packages/language-service/lib/virtual-code.js
index d3f7d3e..acedfc3 100644
--- a/packages/language-service/lib/virtual-code.js
+++ b/packages/language-service/lib/virtual-code.js
@@ -57,8 +57,8 @@ const layoutJsDoc = (propsName) => `
  */
 const componentStart = (isAsync, variables) => `
 /**
- * @deprecated
- *   Do not use.
+ * @internal
+ *   **Do not use.** This function is generated by MDX for internal use.
  *
  * @param {{readonly [K in keyof MDXContentProps]: MDXContentProps[K]}} props
  *   The [props](https://mdxjs.com/docs/using-mdx/#props) that have been passed to the MDX component.
@@ -66,7 +66,7 @@ const componentStart = (isAsync, variables) => `
 ${isAsync ? 'async ' : ''}function _createMdxContent(props) {
   /**
    * @internal
-   *   **Do not use.** This is an MDX internal.
+   *   **Do not use.** This variable is generated by MDX for internal use.
    */
   const _components = {
     // @ts-ignore


Test patch:
diff --git a/packages/language-service/test/language-module.js b/packages/language-service/test/language-module.js
index 33649c8..d445c4f 100644
--- a/packages/language-service/test/language-module.js
+++ b/packages/language-service/test/language-module.js
@@ -64,8 +64,8 @@ test('create virtual code w/ mdxjsEsm', () => {
         '',
         '',
         '/**',
-        ' * @deprecated',
-        ' *   Do not use.',
+        ' * @internal',
+        ' *   **Do not use.** This function is generated by MDX for internal use.',
         ' *',
         ' * @param {{readonly [K in keyof MDXContentProps]: MDXContentProps[K]}} props',
         ' *   The [props](https://mdxjs.com/docs/using-mdx/#props) that have been passed to the MDX component.',
@@ -73,7 +73,7 @@ test('create virtual code w/ mdxjsEsm', () => {
         'function _createMdxContent(props) {',
         '  /**',
         '   * @internal',
-        '   *   **Do not use.** This is an MDX internal.',
+        '   *   **Do not use.** This variable is generated by MDX for internal use.',
         '   */',
         '  const _components = {',
         '    // @ts-ignore',
@@ -180,8 +180,8 @@ test('create virtual code w/o MDX layout in case of named re-export', () => {
         '',
         '',
         '/**',
-        ' * @deprecated',
-        ' *   Do not use.',
+        ' * @internal',
+        ' *   **Do not use.** This function is generated by MDX for internal use.',
         ' *',
         ' * @param {{readonly [K in keyof MDXContentProps]: MDXContentProps[K]}} props',
         ' *   The [props](https://mdxjs.com/docs/using-mdx/#props) that have been passed to the MDX component.',
@@ -189,7 +189,7 @@ test('create virtual code w/o MDX layout in case of named re-export', () => {
         'function _createMdxContent(props) {',
         '  /**',
         '   * @internal',
-        '   *   **Do not use.** This is an MDX internal.',
+        '   *   **Do not use.** This variable is generated by MDX for internal use.',
         '   */',
         '  const _components = {',
         '    // @ts-ignore',
@@ -295,8 +295,8 @@ test('create virtual code w/ MDX layout in case of default re-export', () => {
         'import {default as MDXLayout} from "./Layout.js"',
         '',
         '/**',
-        ' * @deprecated',
-        ' *   Do not use.',
+        ' * @internal',
+        ' *   **Do not use.** This function is generated by MDX for internal use.',
         ' *',
         ' * @param {{readonly [K in keyof MDXContentProps]: MDXContentProps[K]}} props',
         ' *   The [props](https://mdxjs.com/docs/using-mdx/#props) that have been passed to the MDX component.',
@@ -304,7 +304,7 @@ test('create virtual code w/ MDX layout in case of default re-export', () => {
         'function _createMdxContent(props) {',
         '  /**',
         '   * @internal',
-        '   *   **Do not use.** This is an MDX internal.',
+        '   *   **Do not use.** This variable is generated by MDX for internal use.',
         '   */',
         '  const _components = {',
         '    // @ts-ignore',
@@ -413,8 +413,8 @@ test('create virtual code w/ MDX layout in case of named and default re-export',
         'import {default as MDXLayout} from "./Layout.js"',
         '',
         '/**',
-        ' * @deprecated',
-        ' *   Do not use.',
+        ' * @internal',
+        ' *   **Do not use.** This function is generated by MDX for internal use.',
         ' *',
         ' * @param {{readonly [K in keyof MDXContentProps]: MDXContentProps[K]}} props',
         ' *   The [props](https://mdxjs.com/docs/using-mdx/#props) that have been passed to the MDX component.',
@@ -422,7 +422,7 @@ test('create virtual code w/ MDX layout in case of named and default re-export',
         'function _createMdxContent(props) {',
         '  /**',
         '   * @internal',
-        '   *   **Do not use.** This is an MDX internal.',
+        '   *   **Do not use.** This variable is generated by MDX for internal use.',
         '   */',
         '  const _components = {',
         '    // @ts-ignore',
@@ -531,8 +531,8 @@ test('create virtual code w/ MDX layout in case of default and named re-export',
         'import {default as MDXLayout} from "./Layout.js"',
         '',
         '/**',
-        ' * @deprecated',
-        ' *   Do not use.',
+        ' * @internal',
+        ' *   **Do not use.** This function is generated by MDX for internal use.',
         ' *',
         ' * @param {{readonly [K in keyof MDXContentProps]: MDXContentProps[K]}} props',
         ' *   The [props](https://mdxjs.com/docs/using-mdx/#props) that have been passed to the MDX component.',
@@ -540,7 +540,7 @@ test('create virtual code w/ MDX layout in case of default and named re-export',
         'function _createMdxContent(props) {',
         '  /**',
         '   * @internal',
-        '   *   **Do not use.** This is an MDX internal.',
+        '   *   **Do not use.** This variable is generated by MDX for internal use.',
         '   */',
         '  const _components = {',
         '    // @ts-ignore',
@@ -659,8 +659,8 @@ test('create virtual code w/ MDX layout in case of a default exported arrow func
         '',
         '',
         '/**',
-        ' * @deprecated',
-        ' *   Do not use.',
+        ' * @internal',
+        ' *   **Do not use.** This function is generated by MDX for internal use.',
         ' *',
         ' * @param {{readonly [K in keyof MDXContentProps]: MDXContentProps[K]}} props',
         ' *   The [props](https://mdxjs.com/docs/using-mdx/#props) that have been passed to the MDX component.',
@@ -668,7 +668,7 @@ test('create virtual code w/ MDX layout in case of a default exported arrow func
         'function _createMdxContent(props) {',
         '  /**',
         '   * @internal',
-        '   *   **Do not use.** This is an MDX internal.',
+        '   *   **Do not use.** This variable is generated by MDX for internal use.',
         '   */',
         '  const _components = {',
         '    // @ts-ignore',
@@ -790,8 +790,8 @@ test('create virtual code w/ MDX layout in case of a default exported function d
         '',
         '',
         '/**',
-        ' * @deprecated',
-        ' *   Do not use.',
+        ' * @internal',
+        ' *   **Do not use.** This function is generated by MDX for internal use.',
         ' *',
         ' * @param {{readonly [K in keyof MDXContentProps]: MDXContentProps[K]}} props',
         ' *   The [props](https://mdxjs.com/docs/using-mdx/#props) that have been passed to the MDX component.',
@@ -799,7 +799,7 @@ test('create virtual code w/ MDX layout in case of a default exported function d
         'function _createMdxContent(props) {',
         '  /**',
         '   * @internal',
-        '   *   **Do not use.** This is an MDX internal.',
+        '   *   **Do not use.** This variable is generated by MDX for internal use.',
         '   */',
         '  const _components = {',
         '    // @ts-ignore',
@@ -907,8 +907,8 @@ test('create virtual code w/ MDX layout in case of a default exported constant',
         '',
         '',
         '/**',
-        ' * @deprecated',
-        ' *   Do not use.',
+        ' * @internal',
+        ' *   **Do not use.** This function is generated by MDX for internal use.',
         ' *',
         ' * @param {{readonly [K in keyof MDXContentProps]: MDXContentProps[K]}} props',
         ' *   The [props](https://mdxjs.com/docs/using-mdx/#props) that have been passed to the MDX component.',
@@ -916,7 +916,7 @@ test('create virtual code w/ MDX layout in case of a default exported constant',
         'function _createMdxContent(props) {',
         '  /**',
         '   * @internal',
-        '   *   **Do not use.** This is an MDX internal.',
+        '   *   **Do not use.** This variable is generated by MDX for internal use.',
         '   */',
         '  const _components = {',
         '    // @ts-ignore',
@@ -1038,8 +1038,8 @@ test('create virtual code w/ MDX layout and matching argument name', () => {
         '',
         '',
         '/**',
-        ' * @deprecated',
-        ' *   Do not use.',
+        ' * @internal',
+        ' *   **Do not use.** This function is generated by MDX for internal use.',
         ' *',
         ' * @param {{readonly [K in keyof MDXContentProps]: MDXContentProps[K]}} props',
         ' *   The [props](https://mdxjs.com/docs/using-mdx/#props) that have been passed to the MDX component.',
@@ -1047,7 +1047,7 @@ test('create virtual code w/ MDX layout and matching argument name', () => {
         'function _createMdxContent(props) {',
         '  /**',
         '   * @internal',
-        '   *   **Do not use.** This is an MDX internal.',
+        '   *   **Do not use.** This variable is generated by MDX for internal use.',
         '   */',
         '  const _components = {',
         '    // @ts-ignore',
@@ -1173,8 +1173,8 @@ test('create virtual code w/ MDX layout in case of a default export followed by
         '',
         '',
         '/**',
-        ' * @deprecated',
-        ' *   Do not use.',
+        ' * @internal',
+        ' *   **Do not use.** This function is generated by MDX for internal use.',
         ' *',
         ' * @param {{readonly [K in keyof MDXContentProps]: MDXContentProps[K]}} props',
         ' *   The [props](https://mdxjs.com/docs/using-mdx/#props) that have been passed to the MDX component.',
@@ -1182,7 +1182,7 @@ test('create virtual code w/ MDX layout in case of a default export followed by
         'function _createMdxContent(props) {',
         '  /**',
         '   * @internal',
-        '   *   **Do not use.** This is an MDX internal.',
+        '   *   **Do not use.** This variable is generated by MDX for internal use.',
         '   */',
         '  const _components = {',
         '    // @ts-ignore',
@@ -1310,8 +1310,8 @@ test('create virtual code w/ MDX layout in case of a default export preceded by
         '',
         '',
         '/**',
-        ' * @deprecated',
-        ' *   Do not use.',
+        ' * @internal',
+        ' *   **Do not use.** This function is generated by MDX for internal use.',
         ' *',
         ' * @param {{readonly [K in keyof MDXContentProps]: MDXContentProps[K]}} props',
         ' *   The [props](https://mdxjs.com/docs/using-mdx/#props) that have been passed to the MDX component.',
@@ -1319,7 +1319,7 @@ test('create virtual code w/ MDX layout in case of a default export preceded by
         'function _createMdxContent(props) {',
         '  /**',
         '   * @internal',
-        '   *   **Do not use.** This is an MDX internal.',
+        '   *   **Do not use.** This variable is generated by MDX for internal use.',
         '   */',
         '  const _components = {',
         '    // @ts-ignore',
@@ -1409,7 +1409,7 @@ test('create virtual code w/ mdxFlowExpression', () => {
       mappings: [
         {
           sourceOffsets: [0],
-          generatedOffsets: [698],
+          generatedOffsets: [779],
           lengths: [9],
           data: {
             completion: true,
@@ -1426,8 +1426,8 @@ test('create virtual code w/ mdxFlowExpression', () => {
         '@jsxImportSource react */',
         '',
         '/**',
-        ' * @deprecated',
-        ' *   Do not use.',
+        ' * @internal',
+        ' *   **Do not use.** This function is generated by MDX for internal use.',
         ' *',
         ' * @param {{readonly [K in keyof MDXContentProps]: MDXContentProps[K]}} props',
         ' *   The [props](https://mdxjs.com/docs/using-mdx/#props) that have been passed to the MDX component.',
@@ -1435,7 +1435,7 @@ test('create virtual code w/ mdxFlowExpression', () => {
         'function _createMdxContent(props) {',
         '  /**',
         '   * @internal',
-        '   *   **Do not use.** This is an MDX internal.',
+        '   *   **Do not use.** This variable is generated by MDX for internal use.',
         '   */',
         '  const _components = {',
         '    // @ts-ignore',
@@ -1544,7 +1544,7 @@ test('create virtual code w/ prefixed JSX expressions for mdxFlowExpression', ()
         },
         {
           sourceOffsets: [28, 38, 56, 58, 71, 73, 88, 99, 111],
-          generatedOffsets: [762, 776, 798, 812, 829, 843, 870, 885, 901],
+          generatedOffsets: [843, 857, 879, 893, 910, 924, 951, 966, 982],
           lengths: [9, 17, 2, 12, 2, 15, 10, 11, 21],
           data: {
             completion: true,
@@ -1563,8 +1563,8 @@ test('create virtual code w/ prefixed JSX expressions for mdxFlowExpression', ()
         '',
         '',
         '/**',
-        ' * @deprecated',
-        ' *   Do not use.',
+        ' * @internal',
+        ' *   **Do not use.** This function is generated by MDX for internal use.',
         ' *',
         ' * @param {{readonly [K in keyof MDXContentProps]: MDXContentProps[K]}} props',
         ' *   The [props](https://mdxjs.com/docs/using-mdx/#props) that have been passed to the MDX component.',
@@ -1572,7 +1572,7 @@ test('create virtual code w/ prefixed JSX expressions for mdxFlowExpression', ()
         'function _createMdxContent(props) {',
         '  /**',
         '   * @internal',
-        '   *   **Do not use.** This is an MDX internal.',
+        '   *   **Do not use.** This variable is generated by MDX for internal use.',
         '   */',
         '  const _components = {',
         '    // @ts-ignore',
@@ -1696,7 +1696,7 @@ test('create virtual code w/ prefixed JSX expressions in attributes', () => {
         },
         {
           sourceOffsets: [28, 62, 103, 149, 166, 214],
-          generatedOffsets: [762, 808, 852, 910, 939, 1003],
+          generatedOffsets: [843, 889, 933, 991, 1020, 1084],
           lengths: [34, 39, 46, 17, 35, 6],
           data: {
             completion: true,
@@ -1715,8 +1715,8 @@ test('create virtual code w/ prefixed JSX expressions in attributes', () => {
         '',
         '',
         '/**',
-        ' * @deprecated',
-        ' *   Do not use.',
+        ' * @internal',
+        ' *   **Do not use.** This function is generated by MDX for internal use.',
         ' *',
         ' * @param {{readonly [K in keyof MDXContentProps]: MDXContentProps[K]}} props',
         ' *   The [props](https://mdxjs.com/docs/using-mdx/#props) that have been passed to the MDX component.',
@@ -1724,7 +1724,7 @@ test('create virtual code w/ prefixed JSX expressions in attributes', () => {
         'function _createMdxContent(props) {',
         '  /**',
         '   * @internal',
-        '   *   **Do not use.** This is an MDX internal.',
+        '   *   **Do not use.** This variable is generated by MDX for internal use.',
         '   */',
         '  const _components = {',
         '    // @ts-ignore',
@@ -1858,7 +1858,7 @@ test('create virtual code w/ mdxJsxFlowElement w/ children', () => {
         },
         {
           sourceOffsets: [28, 87, 94, 95, 158, 160, 170, 231],
-          generatedOffsets: [762, 796, 807, 820, 858, 872, 886, 922],
+          generatedOffsets: [843, 877, 888, 901, 939, 953, 967, 1003],
           lengths: [5, 6, 1, 9, 2, 9, 7, 8],
           data: {
             completion: true,
@@ -1877,8 +1877,8 @@ test('create virtual code w/ mdxJsxFlowElement w/ children', () => {
         '',
         '',
         '/**',
-        ' * @deprecated',
-        ' *   Do not use.',
+        ' * @internal',
+        ' *   **Do not use.** This function is generated by MDX for internal use.',
         ' *',
         ' * @param {{readonly [K in keyof MDXContentProps]: MDXContentProps[K]}} props',
         ' *   The [props](https://mdxjs.com/docs/using-mdx/#props) that have been passed to the MDX component.',
@@ -1886,7 +1886,7 @@ test('create virtual code w/ mdxJsxFlowElement w/ children', () => {
         'function _createMdxContent(props) {',
         '  /**',
         '   * @internal',
-        '   *   **Do not use.** This is an MDX internal.',
+        '   *   **Do not use.** This variable is generated by MDX for internal use.',
         '   */',
         '  const _components = {',
         '    // @ts-ignore',
@@ -2028,7 +2028,7 @@ test('create virtual code w/ mdxJsxFlowElement w/o children', () => {
         },
         {
           sourceOffsets: [28, 36, 37, 49],
-          generatedOffsets: [762, 774, 787, 803],
+          generatedOffsets: [843, 855, 868, 884],
           lengths: [7, 1, 11, 9],
           data: {
             completion: true,
@@ -2047,8 +2047,8 @@ test('create virtual code w/ mdxJsxFlowElement w/o children', () => {
         '',
         '',
         '/**',
-        ' * @deprecated',
-        ' *   Do not use.',
+        ' * @internal',
+        ' *   **Do not use.** This function is generated by MDX for internal use.',
         ' *',
         ' * @param {{readonly [K in keyof MDXContentProps]: MDXContentProps[K]}} props',
         ' *   The [props](https://mdxjs.com/docs/using-mdx/#props) that have been passed to the MDX component.',
@@ -2056,7 +2056,7 @@ test('create virtual code w/ mdxJsxFlowElement w/o children', () => {
         'function _createMdxContent(props) {',
         '  /**',
         '   * @internal',
-        '   *   **Do not use.** This is an MDX internal.',
+        '   *   **Do not use.** This variable is generated by MDX for internal use.',
         '   */',
         '  const _components = {',
         '    // @ts-ignore',
@@ -2167,7 +2167,7 @@ test('create virtual code w/ mdxJsxTextElement', () => {
         },
         {
           sourceOffsets: [30, 41, 42, 56],
-          generatedOffsets: [778, 799, 812, 837],
+          generatedOffsets: [859, 880, 893, 918],
           lengths: [7, 1, 11, 9],
           data: {
             completion: true,
@@ -2186,8 +2186,8 @@ test('create virtual code w/ mdxJsxTextElement', () => {
         '',
         '',
         '/**',
-        ' * @deprecated',
-        ' *   Do not use.',
+        ' * @internal',
+        ' *   **Do not use.** This function is generated by MDX for internal use.',
         ' *',
         ' * @param {{readonly [K in keyof MDXContentProps]: MDXContentProps[K]}} props',
         ' *   The [props](https://mdxjs.com/docs/using-mdx/#props) that have been passed to the MDX component.',
@@ -2195,7 +2195,7 @@ test('create virtual code w/ mdxJsxTextElement', () => {
         'function _createMdxContent(props) {',
         '  /**',
         '   * @internal',
-        '   *   **Do not use.** This is an MDX internal.',
+        '   *   **Do not use.** This variable is generated by MDX for internal use.',
         '   */',
         '  const _components = {',
         '    // @ts-ignore',
@@ -2297,7 +2297,7 @@ test('create virtual code w/ mdxTextExpression', () => {
       languageId: 'javascriptreact',
       mappings: [
         {
-          generatedOffsets: [714],
+          generatedOffsets: [795],
           sourceOffsets: [4],
           lengths: [9],
           data: {
@@ -2315,8 +2315,8 @@ test('create virtual code w/ mdxTextExpression', () => {
         '@jsxImportSource react */',
         '',
         '/**',
-        ' * @deprecated',
-        ' *   Do not use.',
+        ' * @internal',
+        ' *   **Do not use.** This function is generated by MDX for internal use.',
         ' *',
         ' * @param {{readonly [K in keyof MDXContentProps]: MDXContentProps[K]}} props',
         ' *   The [props](https://mdxjs.com/docs/using-mdx/#props) that have been passed to the MDX component.',
@@ -2324,7 +2324,7 @@ test('create virtual code w/ mdxTextExpression', () => {
         'function _createMdxContent(props) {',
         '  /**',
         '   * @internal',
-        '   *   **Do not use.** This is an MDX internal.',
+        '   *   **Do not use.** This variable is generated by MDX for internal use.',
         '   */',
         '  const _components = {',
         '    // @ts-ignore',
@@ -2417,7 +2417,7 @@ test('create virtual code w/ async mdxTextExpression', () => {
       languageId: 'javascriptreact',
       mappings: [
         {
-          generatedOffsets: [720],
+          generatedOffsets: [801],
           sourceOffsets: [4],
           lengths: [32],
           data: {
@@ -2435,8 +2435,8 @@ test('create virtual code w/ async mdxTextExpression', () => {
         '@jsxImportSource react */',
         '',
         '/**',
-        ' * @deprecated',
-        ' *   Do not use.',
+        ' * @internal',
+        ' *   **Do not use.** This function is generated by MDX for internal use.',
         ' *',
         ' * @param {{readonly [K in keyof MDXContentProps]: MDXContentProps[K]}} props',
         ' *   The [props](https://mdxjs.com/docs/using-mdx/#props) that have been passed to the MDX component.',
@@ -2444,7 +2444,7 @@ test('create virtual code w/ async mdxTextExpression', () => {
         'async function _createMdxContent(props) {',
         '  /**',
         '   * @internal',
-        '   *   **Do not use.** This is an MDX internal.',
+        '   *   **Do not use.** This variable is generated by MDX for internal use.',
         '   */',
         '  const _components = {',
         '    // @ts-ignore',
@@ -2544,8 +2544,8 @@ test('create virtual code w/ dedented markdown content', () => {
         '@jsxImportSource react */',
         '',
         '/**',
-        ' * @deprecated',
-        ' *   Do not use.',
+        ' * @internal',
+        ' *   **Do not use.** This function is generated by MDX for internal use.',
         ' *',
         ' * @param {{readonly [K in keyof MDXContentProps]: MDXContentProps[K]}} props',
         ' *   The [props](https://mdxjs.com/docs/using-mdx/#props) that have been passed to the MDX component.',
@@ -2553,7 +2553,7 @@ test('create virtual code w/ dedented markdown content', () => {
         'function _createMdxContent(props) {',
         '  /**',
         '   * @internal',
-        '   *   **Do not use.** This is an MDX internal.',
+        '   *   **Do not use.** This variable is generated by MDX for internal use.',
         '   */',
         '  const _components = {',
         '    // @ts-ignore',
@@ -2651,8 +2651,8 @@ test('create virtual code w/ syntax error', () => {
         '@jsxImportSource react */',
         '',
         '/**',
-        ' * @deprecated',
-        ' *   Do not use.',
+        ' * @internal',
+        ' *   **Do not use.** This function is generated by MDX for internal use.',
         ' *',
         ' * @param {{readonly [K in keyof MDXContentProps]: MDXContentProps[K]}} props',
         ' *   The [props](https://mdxjs.com/docs/using-mdx/#props) that have been passed to the MDX component.',
@@ -2660,7 +2660,7 @@ test('create virtual code w/ syntax error', () => {
         'function _createMdxContent(props) {',
         '  /**',
         '   * @internal',
-        '   *   **Do not use.** This is an MDX internal.',
+        '   *   **Do not use.** This variable is generated by MDX for internal use.',
         '   */',
         '  const _components = {',
         '    // @ts-ignore',
@@ -2735,8 +2735,8 @@ test('create virtual code w/ yaml frontmatter', () => {
         '@jsxImportSource react */',
         '',
         '/**',
-        ' * @deprecated',
-        ' *   Do not use.',
+        ' * @internal',
+        ' *   **Do not use.** This function is generated by MDX for internal use.',
         ' *',
         ' * @param {{readonly [K in keyof MDXContentProps]: MDXContentProps[K]}} props',
         ' *   The [props](https://mdxjs.com/docs/using-mdx/#props) that have been passed to the MDX component.',
@@ -2744,7 +2744,7 @@ test('create virtual code w/ yaml frontmatter', () => {
         'function _createMdxContent(props) {',
         '  /**',
         '   * @internal',
-        '   *   **Do not use.** This is an MDX internal.',
+        '   *   **Do not use.** This variable is generated by MDX for internal use.',
         '   */',
         '  const _components = {',
         '    // @ts-ignore',
@@ -2859,8 +2859,8 @@ test('update virtual code', () => {
         '@jsxImportSource react */',
         '',
         '/**',
-        ' * @deprecated',
-        ' *   Do not use.',
+        ' * @internal',
+        ' *   **Do not use.** This function is generated by MDX for internal use.',
         ' *',
         ' * @param {{readonly [K in keyof MDXContentProps]: MDXContentProps[K]}} props',
         ' *   The [props](https://mdxjs.com/docs/using-mdx/#props) that have been passed to the MDX component.',
@@ -2868,7 +2868,7 @@ test('update virtual code', () => {
         'function _createMdxContent(props) {',
         '  /**',
         '   * @internal',
-        '   *   **Do not use.** This is an MDX internal.',
+        '   *   **Do not use.** This variable is generated by MDX for internal use.',
         '   */',
         '  const _components = {',
         '    // @ts-ignore',
@@ -3001,8 +3001,8 @@ test('support checkMdx', () => {
         '@jsxImportSource react */',
         '',
         '/**',
-        ' * @deprecated',
-        ' *   Do not use.',
+        ' * @internal',
+        ' *   **Do not use.** This function is generated by MDX for internal use.',
         ' *',
         ' * @param {{readonly [K in keyof MDXContentProps]: MDXContentProps[K]}} props',
         ' *   The [props](https://mdxjs.com/docs/using-mdx/#props) that have been passed to the MDX component.',
@@ -3010,7 +3010,7 @@ test('support checkMdx', () => {
         'function _createMdxContent(props) {',
         '  /**',
         '   * @internal',
-        '   *   **Do not use.** This is an MDX internal.',
+        '   *   **Do not use.** This variable is generated by MDX for internal use.',
         '   */',
         '  const _components = {',
         '    // @ts-ignore',
@@ -3099,8 +3099,8 @@ test('support custom jsxImportSource', () => {
         '@jsxImportSource preact */',
         '',
         '/**',
-        ' * @deprecated',
-        ' *   Do not use.',
+        ' * @internal',
+        ' *   **Do not use.** This function is generated by MDX for internal use.',
         ' *',
         ' * @param {{readonly [K in keyof MDXContentProps]: MDXContentProps[K]}} props',
         ' *   The [props](https://mdxjs.com/docs/using-mdx/#props) that have been passed to the MDX component.',
@@ -3108,7 +3108,7 @@ test('support custom jsxImportSource', () => {
         'function _createMdxContent(props) {',
         '  /**',
         '   * @internal',
-        '   *   **Do not use.** This is an MDX internal.',
+        '   *   **Do not use.** This variable is generated by MDX for internal use.',
         '   */',
         '  const _components = {',
         '    // @ts-ignore',