From df88ec60ec11ded1226748753ba202bf9d08c41e Mon Sep 17 00:00:00 2001
From: Zhong <cszhjh@gmail.com>
Date: Tue, 2 Sep 2025 09:02:00 +0800
Subject: [PATCH] chore(components): improve types and JSDoc for better code
 hints (#21998)

---
 packages/components/cascader/src/cascader.ts   | 2 +-
 packages/components/image/src/image.ts         | 2 +-
 packages/components/input-tag/src/input-tag.ts | 2 +-
 packages/components/input/src/input.ts         | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/components/cascader/src/cascader.ts b/packages/components/cascader/src/cascader.ts
index 79cd36754f..5e38b51487 100644
--- a/packages/components/cascader/src/cascader.ts
+++ b/packages/components/cascader/src/cascader.ts
@@ -83,7 +83,7 @@ export const cascaderProps = buildProps({
     default: 1,
   },
   /**
-   * @description native input id
+   * @description whether show all selected tags when mouse hover text of collapse-tags. To use this, collapse-tags must be true
    */
   collapseTagsTooltip: Boolean,
   /**
diff --git a/packages/components/image/src/image.ts b/packages/components/image/src/image.ts
index ee42864a91..9f37ffce06 100644
--- a/packages/components/image/src/image.ts
+++ b/packages/components/image/src/image.ts
@@ -29,7 +29,7 @@ export const imageProps = buildProps({
     default: '',
   },
   /**
-   * @description Indicates how the browser should load the image, same as [native](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/img#attr-loading)
+   * @description Indicates how the browser should load the image, same as [native](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/img#loading)
    */
   loading: {
     type: String,
diff --git a/packages/components/input-tag/src/input-tag.ts b/packages/components/input-tag/src/input-tag.ts
index bc8ba544cb..9d3408a014 100644
--- a/packages/components/input-tag/src/input-tag.ts
+++ b/packages/components/input-tag/src/input-tag.ts
@@ -126,7 +126,7 @@ export const inputTagProps = buildProps({
    * @description native input autocomplete
    */
   autocomplete: {
-    type: String,
+    type: definePropType<HTMLInputElement['autocomplete']>(String),
     default: 'off',
   },
   /**
diff --git a/packages/components/input/src/input.ts b/packages/components/input/src/input.ts
index 7a4dfa6dfb..131a43911f 100644
--- a/packages/components/input/src/input.ts
+++ b/packages/components/input/src/input.ts
@@ -82,7 +82,7 @@ export const inputProps = buildProps({
    * @description native input autocomplete
    */
   autocomplete: {
-    type: String,
+    type: definePropType<HTMLInputElement['autocomplete']>(String),
     default: 'off',
   },
   /**