From 8edea27a362e30fe0c0f90d0ed7deeeaca37bf8a Mon Sep 17 00:00:00 2001
From: dopamine <coderzyou@gmail.com>
Date: Tue, 6 May 2025 09:42:40 +0800
Subject: [PATCH] build: rollup dts (#20586)

* build: rollup dts

* update

* update
---
 internal/build/package.json                   |   1 +
 internal/build/src/tasks/types-definitions.ts |  72 +++++-
 package.json                                  |   3 +
 .../src/collapse-transition.vue               |   2 +-
 .../components/collection/src/collection.ts   |   3 +-
 packages/components/radio/src/radio-group.ts  |   2 +-
 .../virtual-list/__tests__/scrollbar.test.ts  |   2 +-
 packages/element-plus/make-installer.ts       |   2 +-
 pnpm-lock.yaml                                | 234 +++++++++++++++++-
 typings/env.d.ts                              |   2 +-
 10 files changed, 298 insertions(+), 25 deletions(-)

diff --git a/internal/build/package.json b/internal/build/package.json
index cbbd6375e5..174c443ee7 100644
--- a/internal/build/package.json
+++ b/internal/build/package.json
@@ -16,6 +16,7 @@
   },
   "dependencies": {
     "@element-plus/build-constants": "workspace:*",
+    "@microsoft/api-extractor": "^7.52.5",
     "@pnpm/find-workspace-packages": "^4.0.16",
     "@pnpm/logger": "^4.0.0",
     "@rollup/plugin-commonjs": "^22.0.1",
diff --git a/internal/build/src/tasks/types-definitions.ts b/internal/build/src/tasks/types-definitions.ts
index 4930d51399..d354bdb11a 100644
--- a/internal/build/src/tasks/types-definitions.ts
+++ b/internal/build/src/tasks/types-definitions.ts
@@ -1,15 +1,77 @@
 import path from 'path'
 import { readFile, writeFile } from 'fs/promises'
+import ts from 'typescript'
 import glob from 'fast-glob'
 import { copy, remove } from 'fs-extra'
-import { buildOutput } from '@element-plus/build-utils'
+import { Extractor, ExtractorConfig } from '@microsoft/api-extractor'
+import { buildOutput, epRoot, projRoot } from '@element-plus/build-utils'
 import { pathRewriter, run } from '../utils'
 
 export const generateTypesDefinitions = async () => {
+  const typesDir = path.join(buildOutput, 'types', 'packages')
+  const entryDir = path.join(typesDir, 'element-plus')
+  const entryFilePath = path.join(entryDir, 'index.d.ts')
+  const tsDir = path.join(projRoot, 'node_modules', 'typescript')
+  const tsConfigPath = path.join(projRoot, 'tsconfig.web.json')
+  const tsConfig = ts.readConfigFile(tsConfigPath, ts.sys.readFile)
+
+  // Generate .d.ts files
   await run(
     'npx vue-tsc -p tsconfig.web.json --declaration --emitDeclarationOnly --declarationDir dist/types'
   )
-  const typesDir = path.join(buildOutput, 'types', 'packages')
+
+  // Rollup all .d.ts files into index.d.ts
+  const extractorConfig = ExtractorConfig.prepare({
+    configObject: {
+      projectFolder: typesDir,
+      mainEntryPointFilePath: entryFilePath,
+      apiReport: {
+        enabled: false,
+      },
+      docModel: {
+        enabled: false,
+      },
+      tsdocMetadata: {
+        enabled: false,
+      },
+      dtsRollup: {
+        enabled: true,
+        untrimmedFilePath: entryFilePath,
+      },
+      compiler: {
+        overrideTsconfig: {
+          compilerOptions: {
+            lib: tsConfig.config.compilerOptions.lib,
+            paths: {
+              'element-plus': [entryFilePath],
+              '@element-plus/*': [`${typesDir}/*`],
+            },
+            skipLibCheck: true,
+          },
+          include: [typesDir],
+        },
+      },
+    },
+    configObjectFullPath: undefined,
+    packageJsonFullPath: path.join(epRoot, 'package.json'),
+  })
+
+  Extractor.invoke(extractorConfig, { typescriptCompilerFolder: tsDir })
+
+  // Format the bundle file
+  const fileContent = await readFile(entryFilePath, 'utf8')
+  const sourceFile = ts.createSourceFile(
+    entryFilePath,
+    fileContent,
+    tsConfig.config.compilerOptions.target
+  )
+
+  const printer = ts.createPrinter({ newLine: ts.NewLineKind.LineFeed })
+  const formattedText = printer.printFile(sourceFile)
+
+  await writeFile(entryFilePath, formattedText, 'utf8')
+
+  // "@element-plus" should be replaced with "element-plus"
   const filePaths = await glob(`**/*.d.ts`, {
     cwd: typesDir,
     absolute: true,
@@ -19,7 +81,7 @@ export const generateTypesDefinitions = async () => {
     await writeFile(filePath, pathRewriter('esm')(content), 'utf8')
   })
   await Promise.all(rewriteTasks)
-  const sourceDir = path.join(typesDir, 'element-plus')
-  await copy(sourceDir, typesDir)
-  await remove(sourceDir)
+
+  await copy(entryDir, typesDir)
+  await remove(entryDir)
 }
diff --git a/package.json b/package.json
index f70b282b71..7c94003a22 100644
--- a/package.json
+++ b/package.json
@@ -134,6 +134,9 @@
     },
     "patchedDependencies": {
       "async-validator@4.2.5": "patches/async-validator@4.2.5.patch"
+    },
+    "overrides": {
+      "typescript": "$typescript"
     }
   },
   "lint-staged": {
diff --git a/packages/components/collapse-transition/src/collapse-transition.vue b/packages/components/collapse-transition/src/collapse-transition.vue
index 37dc1ee49e..dc9daa295f 100644
--- a/packages/components/collapse-transition/src/collapse-transition.vue
+++ b/packages/components/collapse-transition/src/collapse-transition.vue
@@ -6,7 +6,7 @@
 
 <script lang="ts" setup>
 import { useNamespace } from '@element-plus/hooks'
-import type { RendererElement } from '@vue/runtime-core'
+import type { RendererElement } from 'vue'
 
 defineOptions({
   name: 'ElCollapseTransition',
diff --git a/packages/components/collection/src/collection.ts b/packages/components/collection/src/collection.ts
index 6289dde237..2419484d07 100644
--- a/packages/components/collection/src/collection.ts
+++ b/packages/components/collection/src/collection.ts
@@ -2,8 +2,7 @@ import { inject, onBeforeUnmount, onMounted, provide, ref, unref } from 'vue'
 import Collection from './collection.vue'
 import CollectionItem from './collection-item.vue'
 
-import type { InjectionKey } from 'vue'
-import type { SetupContext } from '@vue/runtime-core'
+import type { InjectionKey, SetupContext } from 'vue'
 import type {
   ElCollectionInjectionContext,
   ElCollectionItemInjectionContext,
diff --git a/packages/components/radio/src/radio-group.ts b/packages/components/radio/src/radio-group.ts
index 09528cb45e..275b31e6c3 100644
--- a/packages/components/radio/src/radio-group.ts
+++ b/packages/components/radio/src/radio-group.ts
@@ -1,7 +1,7 @@
 import { buildProps } from '@element-plus/utils'
 import { useAriaProps, useSizeProp } from '@element-plus/hooks'
 import { radioEmits } from './radio'
-import type { ExtractPropTypes } from '@vue/runtime-core'
+import type { ExtractPropTypes } from 'vue'
 import type RadioGroup from './radio-group.vue'
 
 export const radioGroupProps = buildProps({
diff --git a/packages/components/virtual-list/__tests__/scrollbar.test.ts b/packages/components/virtual-list/__tests__/scrollbar.test.ts
index ef0a0c0cd2..d21e11dcd9 100644
--- a/packages/components/virtual-list/__tests__/scrollbar.test.ts
+++ b/packages/components/virtual-list/__tests__/scrollbar.test.ts
@@ -1,5 +1,5 @@
 // @ts-nocheck
-import { nextTick } from '@vue/runtime-core'
+import { nextTick } from 'vue'
 import { mount } from '@vue/test-utils'
 import { describe, expect, it } from 'vitest'
 import Scrollbar from '../src/components/scrollbar'
diff --git a/packages/element-plus/make-installer.ts b/packages/element-plus/make-installer.ts
index 2d7abd54da..255eff4d6f 100644
--- a/packages/element-plus/make-installer.ts
+++ b/packages/element-plus/make-installer.ts
@@ -2,7 +2,7 @@ import { provideGlobalConfig } from '@element-plus/components/config-provider'
 import { INSTALLED_KEY } from '@element-plus/constants'
 import { version } from './version'
 
-import type { App, Plugin } from '@vue/runtime-core'
+import type { App, Plugin } from 'vue'
 import type { ConfigProviderContext } from '@element-plus/components/config-provider'
 
 export const makeInstaller = (components: Plugin[] = []) => {
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index eade55def8..cdd3e09320 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -4,6 +4,9 @@ settings:
   autoInstallPeers: true
   excludeLinksFromLockfile: false
 
+overrides:
+  typescript: ~5.5.4
+
 patchedDependencies:
   async-validator@4.2.5:
     hash: wdmp4xlpil2odxo3rasjmxbdfm
@@ -124,7 +127,7 @@ importers:
         version: 1.3.10
       '@vitest/coverage-v8':
         specifier: ^2.0.5
-        version: 2.0.5(vitest@2.0.5(@types/node@22.9.0)(@vitest/ui@2.0.5)(happy-dom@17.4.4)(jsdom@16.4.0)(sass@1.79.3)(terser@5.36.0))
+        version: 2.0.5(vitest@2.0.5)
       '@vitest/ui':
         specifier: ^2.0.5
         version: 2.0.5(vitest@2.0.5)
@@ -318,6 +321,9 @@ importers:
       '@element-plus/build-constants':
         specifier: workspace:*
         version: link:../build-constants
+      '@microsoft/api-extractor':
+        specifier: ^7.52.5
+        version: 7.52.5(@types/node@22.9.0)
       '@pnpm/find-workspace-packages':
         specifier: ^4.0.16
         version: 4.0.16(@pnpm/logger@4.0.0)
@@ -1780,6 +1786,19 @@ packages:
   '@mdit-vue/types@2.1.0':
     resolution: {integrity: sha512-TMBB/BQWVvwtpBdWD75rkZx4ZphQ6MN0O4QB2Bc0oI5PC2uE57QerhNxdRZ7cvBHE2iY2C+BUNUziCfJbjIRRA==}
 
+  '@microsoft/api-extractor-model@7.30.5':
+    resolution: {integrity: sha512-0ic4rcbcDZHz833RaTZWTGu+NpNgrxVNjVaor0ZDUymfDFzjA/Uuk8hYziIUIOEOSTfmIQqyzVwlzxZxPe7tOA==}
+
+  '@microsoft/api-extractor@7.52.5':
+    resolution: {integrity: sha512-6WWgjjg6FkoDWpF/O3sjB05OkszpI5wtKJqd8fUIR/JJUv8IqNCGr1lJUZJnc1HegcT9gAvyf98KfH0wFncU0w==}
+    hasBin: true
+
+  '@microsoft/tsdoc-config@0.17.1':
+    resolution: {integrity: sha512-UtjIFe0C6oYgTnad4q1QP4qXwLhe6tIpNTRStJ2RZEPIkqQPREAwE5spzVxsdn9UaEMUqhh0AqSx3X4nWAKXWw==}
+
+  '@microsoft/tsdoc@0.15.1':
+    resolution: {integrity: sha512-4aErSrCR/On/e5G2hDP0wjooqDdauzEbIq8hIkIe5pXV0rtWJZvdCEKL0ykZxex+IxIwBp0eGeV48hQN07dXtw==}
+
   '@nodelib/fs.scandir@2.1.5':
     resolution: {integrity: sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==}
     engines: {node: '>= 8'}
@@ -2336,6 +2355,28 @@ packages:
     cpu: [x64]
     os: [win32]
 
+  '@rushstack/node-core-library@5.13.0':
+    resolution: {integrity: sha512-IGVhy+JgUacAdCGXKUrRhwHMTzqhWwZUI+qEPcdzsb80heOw0QPbhhoVsoiMF7Klp8eYsp7hzpScMXmOa3Uhfg==}
+    peerDependencies:
+      '@types/node': '*'
+    peerDependenciesMeta:
+      '@types/node':
+        optional: true
+
+  '@rushstack/rig-package@0.5.3':
+    resolution: {integrity: sha512-olzSSjYrvCNxUFZowevC3uz8gvKr3WTpHQ7BkpjtRpA3wK+T0ybep/SRUMfr195gBzJm5gaXw0ZMgjIyHqJUow==}
+
+  '@rushstack/terminal@0.15.2':
+    resolution: {integrity: sha512-7Hmc0ysK5077R/IkLS9hYu0QuNafm+TbZbtYVzCMbeOdMjaRboLKrhryjwZSRJGJzu+TV1ON7qZHeqf58XfLpA==}
+    peerDependencies:
+      '@types/node': '*'
+    peerDependenciesMeta:
+      '@types/node':
+        optional: true
+
+  '@rushstack/ts-command-line@5.0.0':
+    resolution: {integrity: sha512-SW6nqZVxH26Rxz25+lJQRlnXI/YCrNH7NfDEWPPm9i0rwkSE6Rgtmzw96cuZgQjacOh0sw77d6V4SvgarAfr8g==}
+
   '@shikijs/core@1.10.1':
     resolution: {integrity: sha512-qdiJS5a/QGCff7VUFIqd0hDdWly9rDp8lhVmXVrS11aazX8LOTRLHAXkkEeONNsS43EcCd7gax9LLoOz4vlFQA==}
 
@@ -2353,6 +2394,9 @@ packages:
     resolution: {integrity: sha512-L7z9BgrNEcYyUYtF+HaEfiS5ebkh9jXqbszz7pC0hRBPaatV0XjSD3+eHrpqFemQfgwiFF0QPIarnIihIDn7OA==}
     engines: {node: '>=10.13.0'}
 
+  '@types/argparse@1.0.38':
+    resolution: {integrity: sha512-ebDJ9b0e702Yr7pWgB0jzm+CX4Srzz8RcXtLJDJB+BSccqMa36uyH/zUsSYao5+BD1ytv3k3rPYCq4mAE1hsXA==}
+
   '@types/aws-lambda@8.10.98':
     resolution: {integrity: sha512-dJ/R9qamtI2nNpxhNwPBTwsfYwbcCWsYBJxhpgGyMLCD0HxKpORcMpPpSrFP/FIceNEYfnS3R5EfjSZJmX2oJg==}
 
@@ -2971,7 +3015,7 @@ packages:
   '@vue/language-core@2.0.28':
     resolution: {integrity: sha512-0z4tyCCaqqPbdyz0T4yTFQeLpCo4TOM/ZHAC3geGLHeCiFAjVbROB9PiEtrXR1AoLObqUPFHSmKZeWtEMssSqw==}
     peerDependencies:
-      typescript: '*'
+      typescript: ~5.5.4
     peerDependenciesMeta:
       typescript:
         optional: true
@@ -2979,7 +3023,7 @@ packages:
   '@vue/language-core@2.1.6':
     resolution: {integrity: sha512-MW569cSky9R/ooKMh6xa2g1D0AtRKbL56k83dzus/bx//RDJk24RHWkMzbAlXjMdDNyxAaagKPRquBIxkxlCkg==}
     peerDependencies:
-      typescript: '*'
+      typescript: ~5.5.4
     peerDependenciesMeta:
       typescript:
         optional: true
@@ -3158,9 +3202,31 @@ packages:
     resolution: {integrity: sha512-4I7Td01quW/RpocfNayFdFVk1qSuoh0E7JrbRJ16nH01HhKFQ88INq9Sd+nd72zqRySlr9BmDA8xlEJ6vJMrYA==}
     engines: {node: '>=8'}
 
+  ajv-draft-04@1.0.0:
+    resolution: {integrity: sha512-mv00Te6nmYbRp5DCwclxtt7yV/joXJPGS7nM+97GdxvuttCOfgI3K4U25zboyeX0O+myI8ERluxQe5wljMmVIw==}
+    peerDependencies:
+      ajv: ^8.5.0
+    peerDependenciesMeta:
+      ajv:
+        optional: true
+
+  ajv-formats@3.0.1:
+    resolution: {integrity: sha512-8iUql50EUR+uUcdRQ3HDqa6EVyo3docL8g5WJ3FNcWmu62IbkGUue/pEyLBW8VGKKucTPgqeks4fIU1DA4yowQ==}
+    peerDependencies:
+      ajv: ^8.0.0
+    peerDependenciesMeta:
+      ajv:
+        optional: true
+
   ajv@6.12.6:
     resolution: {integrity: sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==}
 
+  ajv@8.12.0:
+    resolution: {integrity: sha512-sRu1kpcO9yLtYxBKvqfTeh9KzZEwO3STyX1HT+4CaDzC6HpTGYhIhPIzj9XuKU7KYDwnaeh5hcOwjy1QuJzBPA==}
+
+  ajv@8.13.0:
+    resolution: {integrity: sha512-PRA911Blj99jR5RMeTunVbNXMF6Lp4vZXnk5GQjcnUWUTsrXtekg/pnmFFI2u/I36Y/2bITGS30GZCXei6uNkA==}
+
   ajv@8.17.1:
     resolution: {integrity: sha512-B/gBuNg5SiMTrPkC+A2+cW0RszwxYmn6VYxB/inlBStS5nx6xHIt/ehKRhIMhqusl7a8LjQoZnjCs5vhwxOQ1g==}
 
@@ -3245,6 +3311,9 @@ packages:
   archy@1.0.0:
     resolution: {integrity: sha512-Xg+9RwCg/0p32teKdGMPTPnVXKD0w3DfHnFTficozsAgsvq2XenPJq/MYpzzQ/v8zrOyJn6Ds39VA4JIDwFfqw==}
 
+  argparse@1.0.10:
+    resolution: {integrity: sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==}
+
   argparse@2.0.1:
     resolution: {integrity: sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==}
 
@@ -3821,13 +3890,13 @@ packages:
     peerDependencies:
       '@types/node': '*'
       cosmiconfig: '>=9'
-      typescript: '>=5'
+      typescript: ~5.5.4
 
   cosmiconfig@9.0.0:
     resolution: {integrity: sha512-itvL5h8RETACmOTFc4UfIyB2RfEHi71Ax6E/PivVxq9NseKbOWpeyHEOIbmAw1rs8Ak0VursQNww7lf7YtUwzg==}
     engines: {node: '>=14'}
     peerDependencies:
-      typescript: '>=4.9.5'
+      typescript: ~5.5.4
     peerDependenciesMeta:
       typescript:
         optional: true
@@ -4799,6 +4868,10 @@ packages:
     resolution: {integrity: sha512-PmDi3uwK5nFuXh7XDTlVnS17xJS7vW36is2+w3xcv8SVxiB4NyATf4ctkVY5bkSjX0Y4nbvZCq1/EjtEyr9ktw==}
     engines: {node: '>=14.14'}
 
+  fs-extra@11.3.0:
+    resolution: {integrity: sha512-Z4XaCL6dUDHfP/jT25jJKMmtxvuwbkrD1vNSMFlo9lNLY2c5FHYSQgHPRZUjAB26TpDEoW9HCOgplrdbaPV/ew==}
+    engines: {node: '>=14.14'}
+
   fs-minipass@2.1.0:
     resolution: {integrity: sha512-V/JgOLFCS+R6Vcq0slCuaeWEdNC3ouDlJMNIsacH2VtALiu9mV4LPrHc5cDl8k5aw6J8jwgWWpiTo5RYhmIzvg==}
     engines: {node: '>= 8'}
@@ -5149,6 +5222,10 @@ packages:
     resolution: {integrity: sha512-veYYhQa+D1QBKznvhUHxb8faxlrwUnxseDAbAp457E0wLNio2bOSKnjYDhMj+YiAq61xrMGhQk9iXVk5FzgQMw==}
     engines: {node: '>=6'}
 
+  import-lazy@4.0.0:
+    resolution: {integrity: sha512-rKtvo6a868b5Hu3heneU+L4yEQ4jYKLtjpnPeUdK7h0yzXGmyBTypknlkCvHFBqfX9YlorEiMM6Dnq/5atfHkw==}
+    engines: {node: '>=8'}
+
   import-meta-resolve@4.1.0:
     resolution: {integrity: sha512-I6fiaX09Xivtk+THaMfAwnA3MVA5Big1WHF1Dfx9hFuvNIWpXnorlkzhcQf6ehrqQiiZECRt1poOAkPmer3ruw==}
 
@@ -5504,6 +5581,9 @@ packages:
     resolution: {integrity: sha512-rg9zJN+G4n2nfJl5MW3BMygZX56zKPNVEYYqq7adpmMh4Jn2QNEwhvQlFy6jPVdcod7txZtKHWnyZiA3a0zP7A==}
     hasBin: true
 
+  jju@1.4.0:
+    resolution: {integrity: sha512-8wb9Yw966OSxApiCt0K3yNJL8pnNeIv+OEq2YMidz4FKP6nonSRoOXc80iXY4JaN2FC11B9qsNmDsm+ZOfMROA==}
+
   joycon@3.1.1:
     resolution: {integrity: sha512-34wB/Y7MW7bzjKRjUKTa46I2Z7eV62Rkhva+KkopW7Qvv/OSWBqvkSY7vusOPrNuZcUG3tApvdVgNB8POj3SPw==}
     engines: {node: '>=10'}
@@ -5954,6 +6034,9 @@ packages:
     resolution: {integrity: sha512-I9jwMn07Sy/IwOj3zVkVik2JTvgpaykDZEigL6Rx6N9LbMywwUSMtxET+7lVoDLLd3O3IXwJwvuuns8UB/HeAg==}
     engines: {node: '>=4'}
 
+  minimatch@3.0.8:
+    resolution: {integrity: sha512-6FsRAQsxQ61mw+qP1ZzbL9Bc78x2p5OqNgNpnoAFLTrX8n5Kxph0CsnhmKKNXTWjXqU5L0pGPR7hYk+XWZr60Q==}
+
   minimatch@3.1.2:
     resolution: {integrity: sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==}
 
@@ -6010,7 +6093,7 @@ packages:
     hasBin: true
     peerDependencies:
       sass: ^1.77.6
-      typescript: '>=5.4.5'
+      typescript: ~5.5.4
       vue-tsc: ^1.8.27 || ^2.0.21
     peerDependenciesMeta:
       sass:
@@ -7137,7 +7220,7 @@ packages:
     engines: {node: '>=16'}
     peerDependencies:
       rollup: ^3.29.4 || ^4
-      typescript: ^4.5 || ^5.0
+      typescript: ~5.5.4
 
   rollup-plugin-esbuild@4.9.1:
     resolution: {integrity: sha512-qn/x7Wz9p3Xnva99qcb+nopH0d2VJwVnsxJTGEg+Sh2Z3tqQl33MhOwzekVo1YTKgv+yAmosjcBRJygMfGrtLw==}
@@ -7230,6 +7313,11 @@ packages:
     engines: {node: '>=10'}
     hasBin: true
 
+  semver@7.5.4:
+    resolution: {integrity: sha512-1bCSESV6Pv+i21Hvpxp3Dx+pSD8lIPt8uVjRrxAUt/nbswYc+tK6Y2btiULjd4+fnq15PX+nqQDC7Oft7WkwcA==}
+    engines: {node: '>=10'}
+    hasBin: true
+
   semver@7.6.2:
     resolution: {integrity: sha512-FNAIBWCx9qcRhoHcgcJ0gvU7SN1lYU2ZXuSfl04bSC5OpvDHFyJCjdNHomPXxjQlCBU67YW64PzY7/VIEH7F2w==}
     engines: {node: '>=10'}
@@ -7392,6 +7480,9 @@ packages:
     resolution: {integrity: sha512-UcjcJOWknrNkF6PLX83qcHM6KHgVKNkV62Y8a5uYDVv9ydGQVwAHMKqHdJje1VTWpljG0WYpCDhrCdAOYH4TWg==}
     engines: {node: '>= 10.x'}
 
+  sprintf-js@1.0.3:
+    resolution: {integrity: sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g==}
+
   sshpk@1.17.0:
     resolution: {integrity: sha512-/9HIEs1ZXGhSPE8X6Ccm7Nam1z8KcoCqPdI7ecm1N33EzAetWahvQWVqLZtaZQ+IDKX4IyA2o0gBzqIMkAagHQ==}
     engines: {node: '>=0.10.0'}
@@ -7675,7 +7766,7 @@ packages:
     resolution: {integrity: sha512-UQMIo7pb8WRomKR1/+MFVLTroIvDVtMX3K6OUir8ynLyzB8Jeriont2bTAtmNPa1ekAgN7YPDyf6V+ygrdU+eQ==}
     engines: {node: '>=16'}
     peerDependencies:
-      typescript: '>=4.2.0'
+      typescript: ~5.5.4
 
   tsconfig-paths@3.14.1:
     resolution: {integrity: sha512-fxDhWnFSLt3VuTwtvJt5fpwxBHg5AdKWMsgcPOOIilyjymcYVZoCQF8fvFRezCNfblEXmi+PcM1eYHeOAgXCOQ==}
@@ -7753,7 +7844,7 @@ packages:
     resolution: {integrity: sha512-JWCUYx3Oxdzvw2J9kTAp+DKE8df/BnH/JTSj6JyA4SH40ECdFu7FoJJcrm8G92B7TjofQ6GZGjJs50TRxoH6Wg==}
     hasBin: true
     peerDependencies:
-      typescript: ^5.1.6
+      typescript: ~5.5.4
     peerDependenciesMeta:
       typescript:
         optional: true
@@ -8192,13 +8283,13 @@ packages:
     resolution: {integrity: sha512-PQ/OFDM3NtQVMThaVlQf8plyL0j7UGdak4lb1KkUOSL0uyx/F9Liu6aOclgHiMMBKNGIjJWoiFh3HjIdV6DS/Q==}
     hasBin: true
     peerDependencies:
-      typescript: '>=5.0.0'
+      typescript: ~5.5.4
 
   vue-tsc@2.1.6:
     resolution: {integrity: sha512-f98dyZp5FOukcYmbFpuSCJ4Z0vHSOSmxGttZJCsFeX0M4w/Rsq0s4uKXjcSRsZqsRgQa6z7SfuO+y0HVICE57Q==}
     hasBin: true
     peerDependencies:
-      typescript: '>=5.0.0'
+      typescript: ~5.5.4
 
   vue@3.2.37:
     resolution: {integrity: sha512-bOKEZxrm8Eh+fveCqS1/NkG/n6aMidsI6hahas7pa0w/l7jkbssJVsRhVDs07IdDq7h9KHswZOgItnwJAgtVtQ==}
@@ -8206,7 +8297,7 @@ packages:
   vue@3.4.31:
     resolution: {integrity: sha512-njqRrOy7W3YLAlVqSKpBebtZpDVg21FPoaq1I7f/+qqBThK9ChAIjkRWgeP6Eat+8C+iia4P3OYqpATP21BCoQ==}
     peerDependencies:
-      typescript: '*'
+      typescript: ~5.5.4
     peerDependenciesMeta:
       typescript:
         optional: true
@@ -9653,6 +9744,41 @@ snapshots:
 
   '@mdit-vue/types@2.1.0': {}
 
+  '@microsoft/api-extractor-model@7.30.5(@types/node@22.9.0)':
+    dependencies:
+      '@microsoft/tsdoc': 0.15.1
+      '@microsoft/tsdoc-config': 0.17.1
+      '@rushstack/node-core-library': 5.13.0(@types/node@22.9.0)
+    transitivePeerDependencies:
+      - '@types/node'
+
+  '@microsoft/api-extractor@7.52.5(@types/node@22.9.0)':
+    dependencies:
+      '@microsoft/api-extractor-model': 7.30.5(@types/node@22.9.0)
+      '@microsoft/tsdoc': 0.15.1
+      '@microsoft/tsdoc-config': 0.17.1
+      '@rushstack/node-core-library': 5.13.0(@types/node@22.9.0)
+      '@rushstack/rig-package': 0.5.3
+      '@rushstack/terminal': 0.15.2(@types/node@22.9.0)
+      '@rushstack/ts-command-line': 5.0.0(@types/node@22.9.0)
+      lodash: 4.17.21
+      minimatch: 3.0.8
+      resolve: 1.22.8
+      semver: 7.5.4
+      source-map: 0.6.1
+      typescript: 5.5.4
+    transitivePeerDependencies:
+      - '@types/node'
+
+  '@microsoft/tsdoc-config@0.17.1':
+    dependencies:
+      '@microsoft/tsdoc': 0.15.1
+      ajv: 8.12.0
+      jju: 1.4.0
+      resolve: 1.22.8
+
+  '@microsoft/tsdoc@0.15.1': {}
+
   '@nodelib/fs.scandir@2.1.5':
     dependencies:
       '@nodelib/fs.stat': 2.0.5
@@ -10342,6 +10468,40 @@ snapshots:
   '@rollup/rollup-win32-x64-msvc@4.24.4':
     optional: true
 
+  '@rushstack/node-core-library@5.13.0(@types/node@22.9.0)':
+    dependencies:
+      ajv: 8.13.0
+      ajv-draft-04: 1.0.0(ajv@8.13.0)
+      ajv-formats: 3.0.1(ajv@8.13.0)
+      fs-extra: 11.3.0
+      import-lazy: 4.0.0
+      jju: 1.4.0
+      resolve: 1.22.8
+      semver: 7.5.4
+    optionalDependencies:
+      '@types/node': 22.9.0
+
+  '@rushstack/rig-package@0.5.3':
+    dependencies:
+      resolve: 1.22.8
+      strip-json-comments: 3.1.1
+
+  '@rushstack/terminal@0.15.2(@types/node@22.9.0)':
+    dependencies:
+      '@rushstack/node-core-library': 5.13.0(@types/node@22.9.0)
+      supports-color: 8.1.1
+    optionalDependencies:
+      '@types/node': 22.9.0
+
+  '@rushstack/ts-command-line@5.0.0(@types/node@22.9.0)':
+    dependencies:
+      '@rushstack/terminal': 0.15.2(@types/node@22.9.0)
+      '@types/argparse': 1.0.38
+      argparse: 1.0.10
+      string-argv: 0.3.2
+    transitivePeerDependencies:
+      - '@types/node'
+
   '@shikijs/core@1.10.1': {}
 
   '@shikijs/transformers@1.10.1':
@@ -10354,6 +10514,8 @@ snapshots:
 
   '@trysound/sax@0.2.0': {}
 
+  '@types/argparse@1.0.38': {}
+
   '@types/aws-lambda@8.10.98': {}
 
   '@types/btoa-lite@1.0.0': {}
@@ -10770,7 +10932,7 @@ snapshots:
       vite: 5.4.10(@types/node@22.9.0)(sass@1.79.3)(terser@5.36.0)
       vue: 3.2.37
 
-  '@vitest/coverage-v8@2.0.5(vitest@2.0.5(@types/node@22.9.0)(@vitest/ui@2.0.5)(happy-dom@17.4.4)(jsdom@16.4.0)(sass@1.79.3)(terser@5.36.0))':
+  '@vitest/coverage-v8@2.0.5(vitest@2.0.5)':
     dependencies:
       '@ampproject/remapping': 2.3.0
       '@bcoe/v8-coverage': 0.2.3
@@ -11593,6 +11755,14 @@ snapshots:
       clean-stack: 2.2.0
       indent-string: 4.0.0
 
+  ajv-draft-04@1.0.0(ajv@8.13.0):
+    optionalDependencies:
+      ajv: 8.13.0
+
+  ajv-formats@3.0.1(ajv@8.13.0):
+    optionalDependencies:
+      ajv: 8.13.0
+
   ajv@6.12.6:
     dependencies:
       fast-deep-equal: 3.1.3
@@ -11600,6 +11770,20 @@ snapshots:
       json-schema-traverse: 0.4.1
       uri-js: 4.4.1
 
+  ajv@8.12.0:
+    dependencies:
+      fast-deep-equal: 3.1.3
+      json-schema-traverse: 1.0.0
+      require-from-string: 2.0.2
+      uri-js: 4.4.1
+
+  ajv@8.13.0:
+    dependencies:
+      fast-deep-equal: 3.1.3
+      json-schema-traverse: 1.0.0
+      require-from-string: 2.0.2
+      uri-js: 4.4.1
+
   ajv@8.17.1:
     dependencies:
       fast-deep-equal: 3.1.3
@@ -11711,6 +11895,10 @@ snapshots:
 
   archy@1.0.0: {}
 
+  argparse@1.0.10:
+    dependencies:
+      sprintf-js: 1.0.3
+
   argparse@2.0.1: {}
 
   arr-diff@4.0.0: {}
@@ -13505,6 +13693,12 @@ snapshots:
       jsonfile: 6.1.0
       universalify: 2.0.1
 
+  fs-extra@11.3.0:
+    dependencies:
+      graceful-fs: 4.2.11
+      jsonfile: 6.1.0
+      universalify: 2.0.1
+
   fs-minipass@2.1.0:
     dependencies:
       minipass: 3.3.6
@@ -13900,6 +14094,8 @@ snapshots:
       parent-module: 1.0.1
       resolve-from: 4.0.0
 
+  import-lazy@4.0.0: {}
+
   import-meta-resolve@4.1.0: {}
 
   imurmurhash@0.1.4: {}
@@ -14201,6 +14397,8 @@ snapshots:
 
   jiti@2.4.2: {}
 
+  jju@1.4.0: {}
+
   joycon@3.1.1: {}
 
   js-tokens@4.0.0: {}
@@ -14694,6 +14892,10 @@ snapshots:
 
   min-indent@1.0.1: {}
 
+  minimatch@3.0.8:
+    dependencies:
+      brace-expansion: 1.1.11
+
   minimatch@3.1.2:
     dependencies:
       brace-expansion: 1.1.11
@@ -15974,6 +16176,10 @@ snapshots:
     dependencies:
       lru-cache: 6.0.0
 
+  semver@7.5.4:
+    dependencies:
+      lru-cache: 6.0.0
+
   semver@7.6.2: {}
 
   semver@7.6.3: {}
@@ -16137,6 +16343,8 @@ snapshots:
 
   split2@4.2.0: {}
 
+  sprintf-js@1.0.3: {}
+
   sshpk@1.17.0:
     dependencies:
       asn1: 0.2.6
diff --git a/typings/env.d.ts b/typings/env.d.ts
index b7bdd529b5..f47f9bc26b 100644
--- a/typings/env.d.ts
+++ b/typings/env.d.ts
@@ -16,7 +16,7 @@ declare global {
   }
 }
 
-declare module '@vue/runtime-core' {
+declare module 'vue' {
   export interface App {
     [INSTALLED_KEY]?: boolean
   }