From 0db1ae698cd114d4467f372db20ea5b608bad6d1 Mon Sep 17 00:00:00 2001
From: snowbitx <109521682+snowbitx@users.noreply.github.com>
Date: Mon, 26 Jan 2026 10:35:38 +0800
Subject: [PATCH] refactor(components): [config-provider] improve ConfigContext
 types (#23528)

* refactor(components): [config-provider] align shadow type

* refactor(components): [config-provider] align button/link  context type

* Update button.vue

* Change link type from 'primary' to 'success'
---
 docs/examples/config-provider/button.vue               |  4 +++-
 docs/examples/config-provider/card.vue                 |  4 +++-
 docs/examples/config-provider/link.vue                 |  4 +++-
 packages/components/button/src/button.ts               | 10 +++++-----
 packages/components/card/src/card.ts                   |  2 +-
 .../config-provider/__tests__/config-provider.test.tsx |  6 +++---
 packages/components/link/src/link.ts                   |  4 ++--
 7 files changed, 20 insertions(+), 14 deletions(-)

diff --git a/docs/examples/config-provider/button.vue b/docs/examples/config-provider/button.vue
index f039c6790d..da3bdf7320 100644
--- a/docs/examples/config-provider/button.vue
+++ b/docs/examples/config-provider/button.vue
@@ -26,7 +26,9 @@
 import { reactive } from 'vue'
 import { buttonTypes } from 'element-plus'
 
-const config = reactive({
+import type { ButtonConfigContext } from 'element-plus'
+
+const config = reactive<ButtonConfigContext>({
   autoInsertSpace: true,
   type: 'default',
   plain: true,
diff --git a/docs/examples/config-provider/card.vue b/docs/examples/config-provider/card.vue
index 89dee3e052..95fa01fc72 100644
--- a/docs/examples/config-provider/card.vue
+++ b/docs/examples/config-provider/card.vue
@@ -1,7 +1,9 @@
 <script lang="ts" setup>
 import { reactive } from 'vue'
 
-const config = reactive({
+import type { CardConfigContext } from 'element-plus'
+
+const config = reactive<CardConfigContext>({
   shadow: 'always',
 })
 </script>
diff --git a/docs/examples/config-provider/link.vue b/docs/examples/config-provider/link.vue
index 1a9472f114..1f43e40dfa 100644
--- a/docs/examples/config-provider/link.vue
+++ b/docs/examples/config-provider/link.vue
@@ -28,10 +28,12 @@
 <script lang="ts" setup>
 import { reactive } from 'vue'
 
+import type { LinkConfigContext } from 'element-plus'
+
 const linkTypes = ['primary', 'success', 'warning', 'info', 'danger', 'default']
 const underlineOptions = ['always', 'never', 'hover']
 
-const config = reactive({
+const config = reactive<LinkConfigContext>({
   type: 'success',
   underline: 'always',
 })
diff --git a/packages/components/button/src/button.ts b/packages/components/button/src/button.ts
index a41aa134ea..97c34ac237 100644
--- a/packages/components/button/src/button.ts
+++ b/packages/components/button/src/button.ts
@@ -218,9 +218,9 @@ export type ButtonPropsPublic = ExtractPublicPropTypes<typeof buttonProps>
 export type ButtonEmits = typeof buttonEmits
 
 export interface ButtonConfigContext {
-  type?: string
-  plain?: boolean
-  text?: boolean
-  round?: boolean
-  autoInsertSpace?: boolean
+  type?: ButtonProps['type']
+  plain?: ButtonProps['plain']
+  text?: ButtonProps['text']
+  round?: ButtonProps['round']
+  autoInsertSpace?: ButtonProps['autoInsertSpace']
 }
diff --git a/packages/components/card/src/card.ts b/packages/components/card/src/card.ts
index 8136732981..9dfd7292dc 100644
--- a/packages/components/card/src/card.ts
+++ b/packages/components/card/src/card.ts
@@ -81,7 +81,7 @@ export const cardProps = buildProps({
 } as const)
 export type CardPropsPublic = ExtractPublicPropTypes<typeof cardProps>
 export interface CardConfigContext {
-  shadow?: string
+  shadow?: CardProps['shadow']
 }
 
 export const cardContextKey: InjectionKey<CardConfigContext> =
diff --git a/packages/components/config-provider/__tests__/config-provider.test.tsx b/packages/components/config-provider/__tests__/config-provider.test.tsx
index 58ac5927ee..bb2fbff43d 100644
--- a/packages/components/config-provider/__tests__/config-provider.test.tsx
+++ b/packages/components/config-provider/__tests__/config-provider.test.tsx
@@ -140,7 +140,7 @@ describe('config-provider', () => {
         round: true,
         autoInsertSpace: true,
         text: true,
-      })
+      } as const)
 
       const wrapper = mount(() => (
         <ConfigProvider button={config}>
@@ -162,7 +162,7 @@ describe('config-provider', () => {
     it('should have shadow="hover" instead of \'always\'', async () => {
       const config = reactive({
         shadow: 'hover',
-      })
+      } as const)
       const overrideShadow = ref('')
 
       const wrapper = mount(() => (
@@ -183,7 +183,7 @@ describe('config-provider', () => {
       const config = reactive({
         type: 'success',
         underline: 'always',
-      })
+      } as const)
 
       const wrapper = mount(() => (
         <ConfigProvider link={config}>
diff --git a/packages/components/link/src/link.ts b/packages/components/link/src/link.ts
index a88fc3935f..65d79bc149 100644
--- a/packages/components/link/src/link.ts
+++ b/packages/components/link/src/link.ts
@@ -92,6 +92,6 @@ export type LinkEmits = typeof linkEmits
 
 export type LinkInstance = InstanceType<typeof Link> & unknown
 export interface LinkConfigContext {
-  type?: string
-  underline?: string | boolean
+  type?: LinkProps['type']
+  underline?: LinkProps['underline']
 }