@kdcloudjs/shoelace 1.0.35 → 1.0.38

package/cdn/vscode.html-custom-data.json

@@ -46,96 +46,43 @@
       ]
     },
     {
-      "name": "sl-animated-image",
-      "description": "A component for displaying animated GIFs and WEBPs that play and pause on interaction.\n---\n\n\n### **Events:**\n - **sl-load** - Emitted when the image loads successfully.\n- **sl-error** - Emitted when the image fails to load.\n\n### **Slots:**\n - **play-icon** - Optional play icon to use instead of the default. Works best with `<sl-icon>`.\n- **pause-icon** - Optional pause icon to use instead of the default. Works best with `<sl-icon>`.\n\n### **CSS Properties:**\n - **--control-box-size** - The size of the icon box. _(default: undefined)_\n- **--icon-size** - The size of the play/pause icons. _(default: undefined)_\n\n### **CSS Parts:**\n - **control-box** - The container that surrounds the pause/play icons and provides their background.",
-      "attributes": [
-        {
-          "name": "src",
-          "description": "The path to the image to load.",
-          "values": []
-        },
-        {
-          "name": "alt",
-          "description": "A description of the image used by assistive devices.",
-          "values": []
-        },
-        {
-          "name": "play",
-          "description": "Plays the animation. When this attribute is remove, the animation will pause.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/animated-image"
-        }
-      ]
-    },
-    {
-      "name": "sl-animation",
-      "description": "Animate elements declaratively with nearly 100 baked-in presets, or roll your own with custom keyframes. Powered by the [Web Animations API](https://developer.mozilla.org/en-US/docs/Web/API/Web_Animations_API).\n---\n\n\n### **Events:**\n - **sl-cancel** - Emitted when the animation is canceled.\n- **sl-finish** - Emitted when the animation finishes.\n- **sl-start** - Emitted when the animation starts or restarts.\n\n### **Methods:**\n - **cancel()** - Clears all keyframe effects caused by this animation and aborts its playback.\n- **finish()** - Sets the playback time to the end of the animation corresponding to the current playback direction.\n\n### **Slots:**\n - _default_ - The element to animate. Avoid slotting in more than one element, as subsequent ones will be ignored. To animate multiple elements, either wrap them in a single container or use multiple `<sl-animation>` elements.",
+      "name": "sl-avatar",
+      "description": "Avatars are used to represent a person or object.\n---\n\n\n### **Events:**\n - **sl-error** - The image could not be loaded. This may because of an invalid URL, a temporary network condition, or some unknown cause.\n\n### **Slots:**\n - **icon** - The default icon to use when no image or initials are present. Works best with `<sl-icon>`.\n\n### **CSS Properties:**\n - **--size** - The size of the avatar. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **icon** - The container that wraps the avatar's icon.\n- **initials** - The container that wraps the avatar's initials.\n- **image** - The avatar image. Only shown when the `image` attribute is set.",
       "attributes": [
         {
-          "name": "name",
-          "description": "The name of the built-in animation to use. For custom animations, use the `keyframes` prop.",
-          "values": []
-        },
-        {
-          "name": "play",
-          "description": "Plays the animation. When omitted, the animation will be paused. This attribute will be automatically removed when\nthe animation finishes or gets canceled.",
-          "values": []
-        },
-        {
-          "name": "delay",
-          "description": "The number of milliseconds to delay the start of the animation.",
-          "values": []
-        },
-        {
-          "name": "direction",
-          "description": "Determines the direction of playback as well as the behavior when reaching the end of an iteration.\n[Learn more](https://developer.mozilla.org/en-US/docs/Web/CSS/animation-direction)",
-          "values": [{ "name": "PlaybackDirection" }]
-        },
-        {
-          "name": "duration",
-          "description": "The number of milliseconds each iteration of the animation takes to complete.",
-          "values": []
-        },
-        {
-          "name": "easing",
-          "description": "The easing function to use for the animation. This can be a Shoelace easing function or a custom easing function\nsuch as `cubic-bezier(0, 1, .76, 1.14)`.",
+          "name": "image",
+          "description": "The image source to use for the avatar.",
           "values": []
         },
         {
-          "name": "end-delay",
-          "description": "The number of milliseconds to delay after the active period of an animation sequence.",
+          "name": "label",
+          "description": "A label to use to describe the avatar to assistive devices.",
           "values": []
         },
         {
-          "name": "fill",
-          "description": "Sets how the animation applies styles to its target before and after its execution.",
-          "values": [{ "name": "FillMode" }]
-        },
-        {
-          "name": "iterations",
-          "description": "The number of iterations to run before the animation completes. Defaults to `Infinity`, which loops.",
+          "name": "initials",
+          "description": "Initials to use as a fallback when no image is available (1-2 characters max recommended).",
           "values": []
         },
         {
-          "name": "iteration-start",
-          "description": "The offset at which to start the animation, usually between 0 (start) and 1 (end).",
-          "values": []
+          "name": "loading",
+          "description": "Indicates how the browser should load the image.",
+          "values": [{ "name": "eager" }, { "name": "lazy" }]
         },
         {
-          "name": "playback-rate",
-          "description": "Sets the animation's playback rate. The default is `1`, which plays the animation at a normal speed. Setting this\nto `2`, for example, will double the animation's speed. A negative value can be used to reverse the animation. This\nvalue can be changed without causing the animation to restart.",
-          "values": []
+          "name": "shape",
+          "description": "The shape of the avatar.",
+          "values": [
+            { "name": "circle" },
+            { "name": "square" },
+            { "name": "rounded" }
+          ]
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/animation"
+          "url": "https://shoelace.style/components/avatar"
         }
       ]
     },
@@ -172,47 +119,6 @@
         }
       ]
     },
-    {
-      "name": "sl-avatar",
-      "description": "Avatars are used to represent a person or object.\n---\n\n\n### **Events:**\n - **sl-error** - The image could not be loaded. This may because of an invalid URL, a temporary network condition, or some unknown cause.\n\n### **Slots:**\n - **icon** - The default icon to use when no image or initials are present. Works best with `<sl-icon>`.\n\n### **CSS Properties:**\n - **--size** - The size of the avatar. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **icon** - The container that wraps the avatar's icon.\n- **initials** - The container that wraps the avatar's initials.\n- **image** - The avatar image. Only shown when the `image` attribute is set.",
-      "attributes": [
-        {
-          "name": "image",
-          "description": "The image source to use for the avatar.",
-          "values": []
-        },
-        {
-          "name": "label",
-          "description": "A label to use to describe the avatar to assistive devices.",
-          "values": []
-        },
-        {
-          "name": "initials",
-          "description": "Initials to use as a fallback when no image is available (1-2 characters max recommended).",
-          "values": []
-        },
-        {
-          "name": "loading",
-          "description": "Indicates how the browser should load the image.",
-          "values": [{ "name": "eager" }, { "name": "lazy" }]
-        },
-        {
-          "name": "shape",
-          "description": "The shape of the avatar.",
-          "values": [
-            { "name": "circle" },
-            { "name": "square" },
-            { "name": "rounded" }
-          ]
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/avatar"
-        }
-      ]
-    },
     {
       "name": "sl-breadcrumb",
       "description": "Breadcrumbs provide a group of links so users can easily navigate a website's hierarchy.\n---\n\n\n### **Slots:**\n - _default_ - One or more breadcrumb items to display.\n- **separator** - The separator to use between breadcrumb items. Works best with `<sl-icon>`.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -262,6 +168,100 @@
         }
       ]
     },
+    {
+      "name": "sl-animated-image",
+      "description": "A component for displaying animated GIFs and WEBPs that play and pause on interaction.\n---\n\n\n### **Events:**\n - **sl-load** - Emitted when the image loads successfully.\n- **sl-error** - Emitted when the image fails to load.\n\n### **Slots:**\n - **play-icon** - Optional play icon to use instead of the default. Works best with `<sl-icon>`.\n- **pause-icon** - Optional pause icon to use instead of the default. Works best with `<sl-icon>`.\n\n### **CSS Properties:**\n - **--control-box-size** - The size of the icon box. _(default: undefined)_\n- **--icon-size** - The size of the play/pause icons. _(default: undefined)_\n\n### **CSS Parts:**\n - **control-box** - The container that surrounds the pause/play icons and provides their background.",
+      "attributes": [
+        {
+          "name": "src",
+          "description": "The path to the image to load.",
+          "values": []
+        },
+        {
+          "name": "alt",
+          "description": "A description of the image used by assistive devices.",
+          "values": []
+        },
+        {
+          "name": "play",
+          "description": "Plays the animation. When this attribute is remove, the animation will pause.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/animated-image"
+        }
+      ]
+    },
+    {
+      "name": "sl-animation",
+      "description": "Animate elements declaratively with nearly 100 baked-in presets, or roll your own with custom keyframes. Powered by the [Web Animations API](https://developer.mozilla.org/en-US/docs/Web/API/Web_Animations_API).\n---\n\n\n### **Events:**\n - **sl-cancel** - Emitted when the animation is canceled.\n- **sl-finish** - Emitted when the animation finishes.\n- **sl-start** - Emitted when the animation starts or restarts.\n\n### **Methods:**\n - **cancel()** - Clears all keyframe effects caused by this animation and aborts its playback.\n- **finish()** - Sets the playback time to the end of the animation corresponding to the current playback direction.\n\n### **Slots:**\n - _default_ - The element to animate. Avoid slotting in more than one element, as subsequent ones will be ignored. To animate multiple elements, either wrap them in a single container or use multiple `<sl-animation>` elements.",
+      "attributes": [
+        {
+          "name": "name",
+          "description": "The name of the built-in animation to use. For custom animations, use the `keyframes` prop.",
+          "values": []
+        },
+        {
+          "name": "play",
+          "description": "Plays the animation. When omitted, the animation will be paused. This attribute will be automatically removed when\nthe animation finishes or gets canceled.",
+          "values": []
+        },
+        {
+          "name": "delay",
+          "description": "The number of milliseconds to delay the start of the animation.",
+          "values": []
+        },
+        {
+          "name": "direction",
+          "description": "Determines the direction of playback as well as the behavior when reaching the end of an iteration.\n[Learn more](https://developer.mozilla.org/en-US/docs/Web/CSS/animation-direction)",
+          "values": [{ "name": "PlaybackDirection" }]
+        },
+        {
+          "name": "duration",
+          "description": "The number of milliseconds each iteration of the animation takes to complete.",
+          "values": []
+        },
+        {
+          "name": "easing",
+          "description": "The easing function to use for the animation. This can be a Shoelace easing function or a custom easing function\nsuch as `cubic-bezier(0, 1, .76, 1.14)`.",
+          "values": []
+        },
+        {
+          "name": "end-delay",
+          "description": "The number of milliseconds to delay after the active period of an animation sequence.",
+          "values": []
+        },
+        {
+          "name": "fill",
+          "description": "Sets how the animation applies styles to its target before and after its execution.",
+          "values": [{ "name": "FillMode" }]
+        },
+        {
+          "name": "iterations",
+          "description": "The number of iterations to run before the animation completes. Defaults to `Infinity`, which loops.",
+          "values": []
+        },
+        {
+          "name": "iteration-start",
+          "description": "The offset at which to start the animation, usually between 0 (start) and 1 (end).",
+          "values": []
+        },
+        {
+          "name": "playback-rate",
+          "description": "Sets the animation's playback rate. The default is `1`, which plays the animation at a normal speed. Setting this\nto `2`, for example, will double the animation's speed. A negative value can be used to reverse the animation. This\nvalue can be changed without causing the animation to restart.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/animation"
+        }
+      ]
+    },
     {
       "name": "sl-button",
       "description": "Buttons represent actions that are available to the user.\n---\n\n\n### **Events:**\n - **sl-blur** - Emitted when the button loses focus.\n- **sl-focus** - Emitted when the button gains focus.\n- **sl-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **click()** - Simulates a click on the button.\n- **focus(options: _FocusOptions_)** - Sets focus on the button.\n- **blur()** - Removes focus from the button.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - _default_ - The button's label.\n- **prefix** - A presentational prefix icon or similar element.\n- **suffix** - A presentational suffix icon or similar element.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **prefix** - The container that wraps the prefix.\n- **label** - The button's label.\n- **suffix** - The container that wraps the suffix.\n- **caret** - The button's caret icon, an `<sl-icon>` element.\n- **spinner** - The spinner that shows when the button is in the loading state.",
@@ -410,23 +410,6 @@
         }
       ]
     },
-    {
-      "name": "sl-button-group",
-      "description": "Button groups can be used to group related buttons into sections.\n---\n\n\n### **Slots:**\n - _default_ - One or more `<sl-button>` elements to display in the button group.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
-      "attributes": [
-        {
-          "name": "label",
-          "description": "A label to use for the button group. This won't be displayed on the screen, but it will be announced by assistive\ndevices when interacting with the control and is strongly recommended.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/button-group"
-        }
-      ]
-    },
     {
       "name": "sl-card",
       "description": "Cards can be used to group related subjects in a container.\n---\n\n\n### **Slots:**\n - _default_ - The card's main content.\n- **header** - An optional header for the card.\n- **footer** - An optional footer for the card.\n- **image** - An optional image to render at the start of the card.\n\n### **CSS Properties:**\n - **--border-color** - The card's border color, including borders that occur inside the card. _(default: undefined)_\n- **--border-radius** - The border radius for the card's edges. _(default: undefined)_\n- **--border-width** - The width of the card's borders. _(default: undefined)_\n- **--padding** - The padding to use for the card's sections. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **image** - The container that wraps the card's image.\n- **header** - The container that wraps the card's header.\n- **body** - The container that wraps the card's main content.\n- **footer** - The container that wraps the card's footer.",
@@ -496,13 +479,81 @@
       ]
     },
     {
-      "name": "sl-carousel-item",
-      "description": "A carousel item represent a slide within a [carousel](/components/carousel).\n---\n\n\n### **Slots:**\n - _default_ - The carousel item's content..\n\n### **CSS Properties:**\n - **--aspect-ratio** - The slide's aspect ratio. Inherited from the carousel by default. _(default: undefined)_",
-      "attributes": [],
+      "name": "sl-button-group",
+      "description": "Button groups can be used to group related buttons into sections.\n---\n\n\n### **Slots:**\n - _default_ - One or more `<sl-button>` elements to display in the button group.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+      "attributes": [
+        {
+          "name": "label",
+          "description": "A label to use for the button group. This won't be displayed on the screen, but it will be announced by assistive\ndevices when interacting with the control and is strongly recommended.",
+          "values": []
+        }
+      ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/carousel-item"
+          "url": "https://shoelace.style/components/button-group"
+        }
+      ]
+    },
+    {
+      "name": "sl-checkbox",
+      "description": "Checkboxes allow the user to toggle an option on or off.\n---\n\n\n### **Events:**\n - **sl-blur** - Emitted when the checkbox loses focus.\n- **sl-change** - Emitted when the checked state changes.\n- **sl-focus** - Emitted when the checkbox gains focus.\n- **sl-input** - Emitted when the checkbox receives input.\n- **sl-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **click()** - Simulates a click on the checkbox.\n- **focus(options: _FocusOptions_)** - Sets focus on the checkbox.\n- **blur()** - Removes focus from the checkbox.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. The value provided will be shown to the user when the form is submitted. To clear\nthe custom validation message, call this method with an empty string.\n\n### **Slots:**\n - _default_ - The checkbox's label.\n- **help-text** - Text that describes how to use the checkbox. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **control** - The square container that wraps the checkbox's checked state.\n- **control--checked** - Matches the control part when the checkbox is checked.\n- **control--indeterminate** - Matches the control part when the checkbox is indeterminate.\n- **checked-icon** - The checked icon, an `<sl-icon>` element.\n- **indeterminate-icon** - The indeterminate icon, an `<sl-icon>` element.\n- **label** - The container that wraps the checkbox's label.\n- **form-control-help-text** - The help text's wrapper.",
+      "attributes": [
+        { "name": "title", "values": [] },
+        {
+          "name": "name",
+          "description": "The name of the checkbox, submitted as a name/value pair with form data.",
+          "values": []
+        },
+        {
+          "name": "value",
+          "description": "The current value of the checkbox, submitted as a name/value pair with form data.",
+          "values": []
+        },
+        {
+          "name": "size",
+          "description": "The checkbox's size.",
+          "values": [
+            { "name": "small" },
+            { "name": "medium" },
+            { "name": "large" }
+          ]
+        },
+        {
+          "name": "disabled",
+          "description": "Disables the checkbox.",
+          "values": []
+        },
+        {
+          "name": "checked",
+          "description": "Draws the checkbox in a checked state.",
+          "values": []
+        },
+        {
+          "name": "indeterminate",
+          "description": "Draws the checkbox in an indeterminate state. This is usually applied to checkboxes that represents a \"select\nall/none\" behavior when associated checkboxes have a mix of checked and unchecked states.",
+          "values": []
+        },
+        {
+          "name": "form",
+          "description": "By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.",
+          "values": []
+        },
+        {
+          "name": "required",
+          "description": "Makes the checkbox a required field.",
+          "values": []
+        },
+        {
+          "name": "help-text",
+          "description": "The checkbox's help text. If you need to display HTML, use the `help-text` slot instead.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/checkbox"
         }
       ]
     },
@@ -578,68 +629,6 @@
         }
       ]
     },
-    {
-      "name": "sl-checkbox",
-      "description": "Checkboxes allow the user to toggle an option on or off.\n---\n\n\n### **Events:**\n - **sl-blur** - Emitted when the checkbox loses focus.\n- **sl-change** - Emitted when the checked state changes.\n- **sl-focus** - Emitted when the checkbox gains focus.\n- **sl-input** - Emitted when the checkbox receives input.\n- **sl-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **click()** - Simulates a click on the checkbox.\n- **focus(options: _FocusOptions_)** - Sets focus on the checkbox.\n- **blur()** - Removes focus from the checkbox.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. The value provided will be shown to the user when the form is submitted. To clear\nthe custom validation message, call this method with an empty string.\n\n### **Slots:**\n - _default_ - The checkbox's label.\n- **help-text** - Text that describes how to use the checkbox. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **control** - The square container that wraps the checkbox's checked state.\n- **control--checked** - Matches the control part when the checkbox is checked.\n- **control--indeterminate** - Matches the control part when the checkbox is indeterminate.\n- **checked-icon** - The checked icon, an `<sl-icon>` element.\n- **indeterminate-icon** - The indeterminate icon, an `<sl-icon>` element.\n- **label** - The container that wraps the checkbox's label.\n- **form-control-help-text** - The help text's wrapper.",
-      "attributes": [
-        { "name": "title", "values": [] },
-        {
-          "name": "name",
-          "description": "The name of the checkbox, submitted as a name/value pair with form data.",
-          "values": []
-        },
-        {
-          "name": "value",
-          "description": "The current value of the checkbox, submitted as a name/value pair with form data.",
-          "values": []
-        },
-        {
-          "name": "size",
-          "description": "The checkbox's size.",
-          "values": [
-            { "name": "small" },
-            { "name": "medium" },
-            { "name": "large" }
-          ]
-        },
-        {
-          "name": "disabled",
-          "description": "Disables the checkbox.",
-          "values": []
-        },
-        {
-          "name": "checked",
-          "description": "Draws the checkbox in a checked state.",
-          "values": []
-        },
-        {
-          "name": "indeterminate",
-          "description": "Draws the checkbox in an indeterminate state. This is usually applied to checkboxes that represents a \"select\nall/none\" behavior when associated checkboxes have a mix of checked and unchecked states.",
-          "values": []
-        },
-        {
-          "name": "form",
-          "description": "By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.",
-          "values": []
-        },
-        {
-          "name": "required",
-          "description": "Makes the checkbox a required field.",
-          "values": []
-        },
-        {
-          "name": "help-text",
-          "description": "The checkbox's help text. If you need to display HTML, use the `help-text` slot instead.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/checkbox"
-        }
-      ]
-    },
     {
       "name": "sl-color-picker",
       "description": "Color pickers allow the user to select a color.\n---\n\n\n### **Events:**\n - **sl-blur** - Emitted when the color picker loses focus.\n- **sl-change** - Emitted when the color picker's value changes.\n- **sl-focus** - Emitted when the color picker receives focus.\n- **sl-input** - Emitted when the color picker receives input.\n- **sl-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the color picker.\n- **blur()** - Removes focus from the color picker.\n- **getFormattedValue(format: _'hex' | 'hexa' | 'rgb' | 'rgba' | 'hsl' | 'hsla' | 'hsv' | 'hsva'_)** - Returns the current value as a string in the specified format.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - **label** - The color picker's form label. Alternatively, you can use the `label` attribute.\n\n### **CSS Properties:**\n - **--grid-width** - The width of the color grid. _(default: undefined)_\n- **--grid-height** - The height of the color grid. _(default: undefined)_\n- **--grid-handle-size** - The size of the color grid's handle. _(default: undefined)_\n- **--slider-height** - The height of the hue and alpha sliders. _(default: undefined)_\n- **--slider-handle-size** - The diameter of the slider's handle. _(default: undefined)_\n- **--swatch-size** - The size of each predefined color swatch. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **trigger** - The color picker's dropdown trigger.\n- **swatches** - The container that holds the swatches.\n- **swatch** - Each individual swatch.\n- **grid** - The color grid.\n- **grid-handle** - The color grid's handle.\n- **slider** - Hue and opacity sliders.\n- **slider-handle** - Hue and opacity slider handles.\n- **hue-slider** - The hue slider.\n- **hue-slider-handle** - The hue slider's handle.\n- **opacity-slider** - The opacity slider.\n- **opacity-slider-handle** - The opacity slider's handle.\n- **preview** - The preview color.\n- **input** - The text input.\n- **eye-dropper-button** - The eye dropper button.\n- **eye-dropper-button__base** - The eye dropper button's exported `button` part.\n- **eye-dropper-button__prefix** - The eye dropper button's exported `prefix` part.\n- **eye-dropper-button__label** - The eye dropper button's exported `label` part.\n- **eye-dropper-button__suffix** - The eye dropper button's exported `suffix` part.\n- **eye-dropper-button__caret** - The eye dropper button's exported `caret` part.\n- **format-button** - The format button.\n- **format-button__base** - The format button's exported `button` part.\n- **format-button__prefix** - The format button's exported `prefix` part.\n- **format-button__label** - The format button's exported `label` part.\n- **format-button__suffix** - The format button's exported `suffix` part.\n- **format-button__caret** - The format button's exported `caret` part.",
@@ -731,6 +720,17 @@
         }
       ]
     },
+    {
+      "name": "sl-carousel-item",
+      "description": "A carousel item represent a slide within a [carousel](/components/carousel).\n---\n\n\n### **Slots:**\n - _default_ - The carousel item's content..\n\n### **CSS Properties:**\n - **--aspect-ratio** - The slide's aspect ratio. Inherited from the carousel by default. _(default: undefined)_",
+      "attributes": [],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/carousel-item"
+        }
+      ]
+    },
     {
       "name": "sl-copy-button",
       "description": "Copies text data to the clipboard when the user clicks the trigger.\n---\n\n\n### **Events:**\n - **sl-copy** - Emitted when the data has been copied.\n- **sl-error** - Emitted when the data could not be copied.\n\n### **Slots:**\n - **copy-icon** - The icon to show in the default copy state. Works best with `<sl-icon>`.\n- **success-icon** - The icon to show when the content is copied. Works best with `<sl-icon>`.\n- **error-icon** - The icon to show when a copy error occurs. Works best with `<sl-icon>`.\n\n### **CSS Properties:**\n - **--success-color** - The color to use for success feedback. _(default: undefined)_\n- **--error-color** - The color to use for error feedback. _(default: undefined)_\n\n### **CSS Parts:**\n - **button** - The internal `<button>` element.\n- **copy-icon** - The container that holds the copy icon.\n- **success-icon** - The container that holds the success icon.\n- **error-icon** - The container that holds the error icon.\n- **tooltip__base** - The tooltip's exported `base` part.\n- **tooltip__base__popup** - The tooltip's exported `popup` part.\n- **tooltip__base__arrow** - The tooltip's exported `arrow` part.\n- **tooltip__body** - The tooltip's exported `body` part.",
@@ -963,43 +963,6 @@
         }
       ]
     },
-    {
-      "name": "sl-dialog",
-      "description": "Dialogs, sometimes called \"modals\", appear above the page and require the user's immediate attention.\n---\n\n\n### **Events:**\n - **sl-show** - Emitted when the dialog opens.\n- **sl-after-show** - Emitted after the dialog opens and all animations are complete.\n- **sl-hide** - Emitted when the dialog closes.\n- **sl-after-hide** - Emitted after the dialog closes and all animations are complete.\n- **sl-initial-focus** - Emitted when the dialog opens and is ready to receive focus. Calling `event.preventDefault()` will prevent focusing and allow you to set it on a different element, such as an input.\n- **sl-request-close** - Emitted when the user attempts to close the dialog by clicking the close button, clicking the overlay, or pressing escape. Calling `event.preventDefault()` will keep the dialog open. Avoid using this unless closing the dialog will result in destructive behavior such as data loss.\n\n### **Methods:**\n - **show()** - Shows the dialog.\n- **hide()** - Hides the dialog\n\n### **Slots:**\n - _default_ - The dialog's main content.\n- **label** - The dialog's label. Alternatively, you can use the `label` attribute.\n- **header-actions** - Optional actions to add to the header. Works best with `<sl-icon-button>`.\n- **footer** - The dialog's footer, usually one or more buttons representing various options.\n\n### **CSS Properties:**\n - **--width** - The preferred width of the dialog. Note that the dialog will shrink to accommodate smaller screens. _(default: undefined)_\n- **--header-spacing** - The amount of padding to use for the header. _(default: undefined)_\n- **--body-spacing** - The amount of padding to use for the body. _(default: undefined)_\n- **--footer-spacing** - The amount of padding to use for the footer. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **overlay** - The overlay that covers the screen behind the dialog.\n- **panel** - The dialog's panel (where the dialog and its content are rendered).\n- **header** - The dialog's header. This element wraps the title and header actions.\n- **header-actions** - Optional actions to add to the header. Works best with `<sl-icon-button>`.\n- **title** - The dialog's title.\n- **close-button** - The close button, an `<sl-icon-button>`.\n- **close-button__base** - The close button's exported `base` part.\n- **body** - The dialog's body.\n- **footer** - The dialog's footer.",
-      "attributes": [
-        {
-          "name": "resize",
-          "description": "Indicates whether or not the dialog is resizable. When true, the user can resize the dialog by dragging the\nbottom-right corner, and double-clicking the header will toggle fullscreen mode.",
-          "values": []
-        },
-        {
-          "name": "fullscreen",
-          "description": "Indicates whether or not the dialog is in fullscreen mode.",
-          "values": []
-        },
-        {
-          "name": "open",
-          "description": "Indicates whether or not the dialog is open. You can toggle this attribute to show and hide the dialog, or you can\nuse the `show()` and `hide()` methods and this attribute will reflect the dialog's open state.",
-          "values": []
-        },
-        {
-          "name": "label",
-          "description": "The dialog's label as displayed in the header. You should always include a relevant label even when using\n`no-header`, as it is required for proper accessibility. If you need to display HTML, use the `label` slot instead.",
-          "values": []
-        },
-        {
-          "name": "no-header",
-          "description": "Disables the header. This will also remove the default close button, so please ensure you provide an easy,\naccessible way for users to dismiss the dialog.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/dialog"
-        }
-      ]
-    },
     {
       "name": "sl-divider",
       "description": "Dividers are used to visually separate or group elements.\n---\n\n\n### **CSS Properties:**\n - **--color** - The color of the divider. _(default: undefined)_\n- **--width** - The width of the divider. _(default: undefined)_\n- **--spacing** - The spacing of the divider. _(default: undefined)_",
@@ -1059,76 +1022,6 @@
         }
       ]
     },
-    {
-      "name": "sl-dropdown",
-      "description": "Dropdowns expose additional content that \"drops down\" in a panel.\n---\n\n\n### **Events:**\n - **sl-show** - Emitted when the dropdown opens.\n- **sl-after-show** - Emitted after the dropdown opens and all animations are complete.\n- **sl-hide** - Emitted when the dropdown closes.\n- **sl-after-hide** - Emitted after the dropdown closes and all animations are complete.\n\n### **Methods:**\n - **show()** - Shows the dropdown panel.\n- **hide()** - Hides the dropdown panel\n- **reposition()** - Instructs the dropdown menu to reposition. Useful when the position or size of the trigger changes when the menu\nis activated.\n\n### **Slots:**\n - _default_ - The dropdown's main content.\n- **trigger** - The dropdown's trigger, usually a `<sl-button>` element.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper, an `<sl-popup>` element.\n- **base__popup** - The popup's exported `popup` part. Use this to target the tooltip's popup container.\n- **trigger** - The container that wraps the trigger.\n- **panel** - The panel that gets shown when the dropdown is open.",
-      "attributes": [
-        {
-          "name": "open",
-          "description": "Indicates whether or not the dropdown is open. You can toggle this attribute to show and hide the dropdown, or you\ncan use the `show()` and `hide()` methods and this attribute will reflect the dropdown's open state.",
-          "values": []
-        },
-        {
-          "name": "placement",
-          "description": "The preferred placement of the dropdown panel. Note that the actual placement may vary as needed to keep the panel\ninside of the viewport.",
-          "values": [
-            { "name": "" },
-            { "name": "top" },
-            { "name": "top-start" },
-            { "name": "top-end" },
-            { "name": "bottom" },
-            { "name": "bottom-start" },
-            { "name": "bottom-end" },
-            { "name": "right" },
-            { "name": "right-start" },
-            { "name": "right-end" },
-            { "name": "left" },
-            { "name": "left-start" },
-            { "name": "left-end" }
-          ]
-        },
-        {
-          "name": "disabled",
-          "description": "Disables the dropdown so the panel will not open.",
-          "values": []
-        },
-        {
-          "name": "stay-open-on-select",
-          "description": "By default, the dropdown is closed when an item is selected. This attribute will keep it open instead. Useful for\ndropdowns that allow for multiple interactions.",
-          "values": []
-        },
-        {
-          "name": "distance",
-          "description": "The distance in pixels from which to offset the panel away from its trigger.",
-          "values": []
-        },
-        {
-          "name": "skidding",
-          "description": "The distance in pixels from which to offset the panel along its trigger.",
-          "values": []
-        },
-        {
-          "name": "hoist",
-          "description": "Enable this option to prevent the panel from being clipped when the component is placed inside a container with\n`overflow: auto|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all, scenarios.",
-          "values": []
-        },
-        {
-          "name": "sync",
-          "description": "Syncs the popup width or height to that of the trigger element.",
-          "values": [
-            { "name": "width" },
-            { "name": "height" },
-            { "name": "both" }
-          ]
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/dropdown"
-        }
-      ]
-    },
     {
       "name": "sl-float-button",
       "description": "A floating action button that stays fixed on the page.\n---\n\n\n### **Events:**\n - **sl-click** - Emitted when the button is clicked.\n\n### **Slots:**\n - _default_ - The button's icon content.\n- **content** - Optional text content (only visible when shape is square).\n\n### **CSS Parts:**\n - **base** - The button's base wrapper.\n- **icon** - The icon container.\n- **content** - The text content container.",
@@ -1196,18 +1089,55 @@
       ]
     },
     {
-      "name": "sl-float-button-group",
-      "description": "Groups multiple float buttons together, with optional menu trigger.\n---\n\n\n### **Events:**\n - **sl-show** - Emitted when the menu opens (menu mode only).\n- **sl-hide** - Emitted when the menu closes (menu mode only).\n\n### **Slots:**\n - _default_ - The float buttons to display.\n- **trigger-icon** - Custom icon for the trigger button.\n- **close-icon** - Custom icon shown when the menu is open.\n\n### **CSS Parts:**\n - **base** - The group's base wrapper.\n- **list** - The container for the float button items.\n- **trigger** - The trigger button (menu mode only).\n- **trigger-icon** - The trigger button's icon.",
+      "name": "sl-dialog",
+      "description": "Dialogs, sometimes called \"modals\", appear above the page and require the user's immediate attention.\n---\n\n\n### **Events:**\n - **sl-show** - Emitted when the dialog opens.\n- **sl-after-show** - Emitted after the dialog opens and all animations are complete.\n- **sl-hide** - Emitted when the dialog closes.\n- **sl-after-hide** - Emitted after the dialog closes and all animations are complete.\n- **sl-initial-focus** - Emitted when the dialog opens and is ready to receive focus. Calling `event.preventDefault()` will prevent focusing and allow you to set it on a different element, such as an input.\n- **sl-request-close** - Emitted when the user attempts to close the dialog by clicking the close button, clicking the overlay, or pressing escape. Calling `event.preventDefault()` will keep the dialog open. Avoid using this unless closing the dialog will result in destructive behavior such as data loss.\n\n### **Methods:**\n - **show()** - Shows the dialog.\n- **hide()** - Hides the dialog\n\n### **Slots:**\n - _default_ - The dialog's main content.\n- **label** - The dialog's label. Alternatively, you can use the `label` attribute.\n- **header-actions** - Optional actions to add to the header. Works best with `<sl-icon-button>`.\n- **footer** - The dialog's footer, usually one or more buttons representing various options.\n\n### **CSS Properties:**\n - **--width** - The preferred width of the dialog. Note that the dialog will shrink to accommodate smaller screens. _(default: undefined)_\n- **--header-spacing** - The amount of padding to use for the header. _(default: undefined)_\n- **--body-spacing** - The amount of padding to use for the body. _(default: undefined)_\n- **--footer-spacing** - The amount of padding to use for the footer. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **overlay** - The overlay that covers the screen behind the dialog.\n- **panel** - The dialog's panel (where the dialog and its content are rendered).\n- **header** - The dialog's header. This element wraps the title and header actions.\n- **header-actions** - Optional actions to add to the header. Works best with `<sl-icon-button>`.\n- **title** - The dialog's title.\n- **close-button** - The close button, an `<sl-icon-button>`.\n- **close-button__base** - The close button's exported `base` part.\n- **body** - The dialog's body.\n- **footer** - The dialog's footer.",
       "attributes": [
         {
-          "name": "shape",
-          "description": "The shape applied to all child float buttons.",
-          "values": [{ "name": "circle" }, { "name": "square" }]
+          "name": "resize",
+          "description": "Indicates whether or not the dialog is resizable. When true, the user can resize the dialog by dragging the\nbottom-right corner, and double-clicking the header will toggle fullscreen mode.",
+          "values": []
         },
         {
-          "name": "trigger",
-          "description": "The trigger mode for menu. When set, shows a trigger button that toggles the menu.",
-          "values": [{ "name": "click" }, { "name": "hover" }, { "name": "''" }]
+          "name": "fullscreen",
+          "description": "Indicates whether or not the dialog is in fullscreen mode.",
+          "values": []
+        },
+        {
+          "name": "open",
+          "description": "Indicates whether or not the dialog is open. You can toggle this attribute to show and hide the dialog, or you can\nuse the `show()` and `hide()` methods and this attribute will reflect the dialog's open state.",
+          "values": []
+        },
+        {
+          "name": "label",
+          "description": "The dialog's label as displayed in the header. You should always include a relevant label even when using\n`no-header`, as it is required for proper accessibility. If you need to display HTML, use the `label` slot instead.",
+          "values": []
+        },
+        {
+          "name": "no-header",
+          "description": "Disables the header. This will also remove the default close button, so please ensure you provide an easy,\naccessible way for users to dismiss the dialog.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/dialog"
+        }
+      ]
+    },
+    {
+      "name": "sl-float-button-group",
+      "description": "Groups multiple float buttons together, with optional menu trigger.\n---\n\n\n### **Events:**\n - **sl-show** - Emitted when the menu opens (menu mode only).\n- **sl-hide** - Emitted when the menu closes (menu mode only).\n\n### **Slots:**\n - _default_ - The float buttons to display.\n- **trigger-icon** - Custom icon for the trigger button.\n- **close-icon** - Custom icon shown when the menu is open.\n\n### **CSS Parts:**\n - **base** - The group's base wrapper.\n- **list** - The container for the float button items.\n- **trigger** - The trigger button (menu mode only).\n- **trigger-icon** - The trigger button's icon.",
+      "attributes": [
+        {
+          "name": "shape",
+          "description": "The shape applied to all child float buttons.",
+          "values": [{ "name": "circle" }, { "name": "square" }]
+        },
+        {
+          "name": "trigger",
+          "description": "The trigger mode for menu. When set, shows a trigger button that toggles the menu.",
+          "values": [{ "name": "click" }, { "name": "hover" }, { "name": "''" }]
         },
         {
           "name": "open",
@@ -1233,33 +1163,72 @@
       ]
     },
     {
-      "name": "sl-format-bytes",
-      "description": "Formats a number as a human readable bytes value.\n---\n",
+      "name": "sl-dropdown",
+      "description": "Dropdowns expose additional content that \"drops down\" in a panel.\n---\n\n\n### **Events:**\n - **sl-show** - Emitted when the dropdown opens.\n- **sl-after-show** - Emitted after the dropdown opens and all animations are complete.\n- **sl-hide** - Emitted when the dropdown closes.\n- **sl-after-hide** - Emitted after the dropdown closes and all animations are complete.\n\n### **Methods:**\n - **show()** - Shows the dropdown panel.\n- **hide()** - Hides the dropdown panel\n- **reposition()** - Instructs the dropdown menu to reposition. Useful when the position or size of the trigger changes when the menu\nis activated.\n\n### **Slots:**\n - _default_ - The dropdown's main content.\n- **trigger** - The dropdown's trigger, usually a `<sl-button>` element.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper, an `<sl-popup>` element.\n- **base__popup** - The popup's exported `popup` part. Use this to target the tooltip's popup container.\n- **trigger** - The container that wraps the trigger.\n- **panel** - The panel that gets shown when the dropdown is open.",
       "attributes": [
         {
-          "name": "value",
-          "description": "The number to format in bytes.",
+          "name": "open",
+          "description": "Indicates whether or not the dropdown is open. You can toggle this attribute to show and hide the dropdown, or you\ncan use the `show()` and `hide()` methods and this attribute will reflect the dropdown's open state.",
           "values": []
         },
         {
-          "name": "unit",
-          "description": "The type of unit to display.",
-          "values": [{ "name": "byte" }, { "name": "bit" }]
+          "name": "placement",
+          "description": "The preferred placement of the dropdown panel. Note that the actual placement may vary as needed to keep the panel\ninside of the viewport.",
+          "values": [
+            { "name": "" },
+            { "name": "top" },
+            { "name": "top-start" },
+            { "name": "top-end" },
+            { "name": "bottom" },
+            { "name": "bottom-start" },
+            { "name": "bottom-end" },
+            { "name": "right" },
+            { "name": "right-start" },
+            { "name": "right-end" },
+            { "name": "left" },
+            { "name": "left-start" },
+            { "name": "left-end" }
+          ]
         },
         {
-          "name": "display",
-          "description": "Determines how to display the result, e.g. \"100 bytes\", \"100 b\", or \"100b\".",
+          "name": "disabled",
+          "description": "Disables the dropdown so the panel will not open.",
+          "values": []
+        },
+        {
+          "name": "stay-open-on-select",
+          "description": "By default, the dropdown is closed when an item is selected. This attribute will keep it open instead. Useful for\ndropdowns that allow for multiple interactions.",
+          "values": []
+        },
+        {
+          "name": "distance",
+          "description": "The distance in pixels from which to offset the panel away from its trigger.",
+          "values": []
+        },
+        {
+          "name": "skidding",
+          "description": "The distance in pixels from which to offset the panel along its trigger.",
+          "values": []
+        },
+        {
+          "name": "hoist",
+          "description": "Enable this option to prevent the panel from being clipped when the component is placed inside a container with\n`overflow: auto|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all, scenarios.",
+          "values": []
+        },
+        {
+          "name": "sync",
+          "description": "Syncs the popup width or height to that of the trigger element.",
           "values": [
-            { "name": "long" },
-            { "name": "short" },
-            { "name": "narrow" }
+            { "name": "width" },
+            { "name": "height" },
+            { "name": "both" }
           ]
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/format-bytes"
+          "url": "https://shoelace.style/components/dropdown"
         }
       ]
     },
@@ -1349,6 +1318,106 @@
         }
       ]
     },
+    {
+      "name": "sl-format-bytes",
+      "description": "Formats a number as a human readable bytes value.\n---\n",
+      "attributes": [
+        {
+          "name": "value",
+          "description": "The number to format in bytes.",
+          "values": []
+        },
+        {
+          "name": "unit",
+          "description": "The type of unit to display.",
+          "values": [{ "name": "byte" }, { "name": "bit" }]
+        },
+        {
+          "name": "display",
+          "description": "Determines how to display the result, e.g. \"100 bytes\", \"100 b\", or \"100b\".",
+          "values": [
+            { "name": "long" },
+            { "name": "short" },
+            { "name": "narrow" }
+          ]
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/format-bytes"
+        }
+      ]
+    },
+    {
+      "name": "sl-icon",
+      "description": "Icons are symbols that can be used to represent various options within an application.\n---\n\n\n### **Events:**\n - **sl-load** - Emitted when the icon has loaded. When using `spriteSheet: true` this will not emit.\n- **sl-error** - Emitted when the icon fails to load due to an error. When using `spriteSheet: true` this will not emit.\n\n### **CSS Parts:**\n - **svg** - The internal SVG element.\n- **use** - The <use> element generated when using `spriteSheet: true`",
+      "attributes": [
+        {
+          "name": "name",
+          "description": "The name of the icon to draw. Available names depend on the icon library being used.",
+          "values": []
+        },
+        {
+          "name": "src",
+          "description": "An external URL of an SVG file. Be sure you trust the content you are including, as it will be executed as code and\ncan result in XSS attacks.",
+          "values": []
+        },
+        {
+          "name": "label",
+          "description": "An alternate description to use for assistive devices. If omitted, the icon will be considered presentational and\nignored by assistive devices.",
+          "values": []
+        },
+        {
+          "name": "library",
+          "description": "The name of a registered custom icon library.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/icon"
+        }
+      ]
+    },
+    {
+      "name": "sl-image",
+      "description": "图片组件，支持预览、缩放、旋转、翻转等功能。1:1 复刻 Ant Design Image 组件。\n---\n\n\n### **Events:**\n - **sl-image-click** - 在 group 模式下点击图片时触发\n- **sl-preview-open** - 预览打开时触发\n- **sl-preview-close** - 预览关闭时触发\n- **sl-error** - 图片加载失败时触发\n- **sl-load** - 图片加载成功时触发\n\n### **Slots:**\n - **cover** - 自定义遮罩层内容\n- **placeholder** - 自定义加载占位内容\n\n### **CSS Parts:**\n - **base** - 组件根容器\n- **img** - 图片元素\n- **cover** - 遮罩层\n- **preview-mask** - 预览遮罩背景\n- **preview-body** - 预览主体\n- **preview-img** - 预览图片\n- **preview-actions** - 预览工具栏\n- **preview-close** - 预览关闭按钮",
+      "attributes": [
+        { "name": "src", "description": "图片地址", "values": [] },
+        { "name": "alt", "description": "图片替代文本", "values": [] },
+        { "name": "width", "description": "图片宽度", "values": [] },
+        { "name": "height", "description": "图片高度", "values": [] },
+        {
+          "name": "fallback",
+          "description": "加载失败时的回退图片地址",
+          "values": []
+        },
+        {
+          "name": "placeholder",
+          "description": "加载占位图；设为 true 显示默认占位符，设为字符串则作为占位图片 src",
+          "values": []
+        },
+        { "name": "no-preview", "description": "是否禁用预览", "values": [] },
+        {
+          "name": "preview",
+          "description": "预览配置",
+          "values": [{ "name": "SlImagePreviewConfig" }]
+        },
+        {
+          "name": "in-group",
+          "description": "是否在 group 中（由 sl-image-preview-group 自动设置）",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/image"
+        }
+      ]
+    },
     {
       "name": "sl-format-number",
       "description": "Formats a number using the specified locale and options.\n---\n",
@@ -1421,34 +1490,77 @@
       ]
     },
     {
-      "name": "sl-icon",
-      "description": "Icons are symbols that can be used to represent various options within an application.\n---\n\n\n### **Events:**\n - **sl-load** - Emitted when the icon has loaded. When using `spriteSheet: true` this will not emit.\n- **sl-error** - Emitted when the icon fails to load due to an error. When using `spriteSheet: true` this will not emit.\n\n### **CSS Parts:**\n - **svg** - The internal SVG element.\n- **use** - The <use> element generated when using `spriteSheet: true`",
+      "name": "sl-image-comparer",
+      "description": "Compare visual differences between similar photos with a sliding panel.\n---\n\n\n### **Events:**\n - **sl-change** - Emitted when the position changes.\n\n### **Slots:**\n - **before** - The before image, an `<img>` or `<svg>` element.\n- **after** - The after image, an `<img>` or `<svg>` element.\n- **handle** - The icon used inside the handle.\n\n### **CSS Properties:**\n - **--divider-width** - The width of the dividing line. _(default: undefined)_\n- **--handle-size** - The size of the compare handle. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **before** - The container that wraps the before image.\n- **after** - The container that wraps the after image.\n- **divider** - The divider that separates the images.\n- **handle** - The handle that the user drags to expose the after image.",
       "attributes": [
         {
-          "name": "name",
-          "description": "The name of the icon to draw. Available names depend on the icon library being used.",
+          "name": "position",
+          "description": "The position of the divider as a percentage.",
           "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/image-comparer"
+        }
+      ]
+    },
+    {
+      "name": "sl-image-preview-group",
+      "description": "图片预览组，支持多张图片切换预览。对齐 Ant Design Image.PreviewGroup API。\n---\n\n\n### **Events:**\n - **sl-preview-open** - 预览打开时触发\n- **sl-preview-close** - 预览关闭时触发\n- **sl-preview-change** - 预览图片切换时触发，detail 包含 { current, prev }\n\n### **Slots:**\n - _default_ - 默认插槽，放置 sl-image 组件\n\n### **CSS Parts:**\n - **preview-mask** - 预览遮罩背景\n- **preview-body** - 预览主体\n- **preview-img** - 预览图片\n- **preview-actions** - 预览工具栏\n- **preview-close** - 预览关闭按钮\n- **preview-counter** - 预览计数器",
+      "attributes": [
+        {
+          "name": "preview",
+          "description": "预览配置，为 false 时禁用预览",
+          "values": [{ "name": "false" }, { "name": "SlPreviewGroupConfig" }]
         },
+        {
+          "name": "items",
+          "description": "预览数组，支持字符串或 { src, alt, crossOrigin } 对象",
+          "values": [{ "name": "SlPreviewGroupItem[]" }]
+        },
+        {
+          "name": "fallback",
+          "description": "加载失败容错地址（组件级）",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/image-preview-group"
+        }
+      ]
+    },
+    {
+      "name": "sl-include",
+      "description": "Includes give you the power to embed external HTML files into the page.\n---\n\n\n### **Events:**\n - **sl-load** - Emitted when the included file is loaded.\n- **sl-error** - Emitted when the included file fails to load due to an error.",
+      "attributes": [
         {
           "name": "src",
-          "description": "An external URL of an SVG file. Be sure you trust the content you are including, as it will be executed as code and\ncan result in XSS attacks.",
+          "description": "The location of the HTML file to include. Be sure you trust the content you are including as it will be executed as\ncode and can result in XSS attacks.",
           "values": []
         },
         {
-          "name": "label",
-          "description": "An alternate description to use for assistive devices. If omitted, the icon will be considered presentational and\nignored by assistive devices.",
-          "values": []
+          "name": "mode",
+          "description": "The fetch mode to use.",
+          "values": [
+            { "name": "cors" },
+            { "name": "no-cors" },
+            { "name": "same-origin" }
+          ]
         },
         {
-          "name": "library",
-          "description": "The name of a registered custom icon library.",
+          "name": "allow-scripts",
+          "description": "Allows included scripts to be executed. Be sure you trust the content you are including as it will be executed as\ncode and can result in XSS attacks.",
           "values": []
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/icon"
+          "url": "https://shoelace.style/components/include"
         }
       ]
     },
@@ -1509,54 +1621,6 @@
         }
       ]
     },
-    {
-      "name": "sl-image-comparer",
-      "description": "Compare visual differences between similar photos with a sliding panel.\n---\n\n\n### **Events:**\n - **sl-change** - Emitted when the position changes.\n\n### **Slots:**\n - **before** - The before image, an `<img>` or `<svg>` element.\n- **after** - The after image, an `<img>` or `<svg>` element.\n- **handle** - The icon used inside the handle.\n\n### **CSS Properties:**\n - **--divider-width** - The width of the dividing line. _(default: undefined)_\n- **--handle-size** - The size of the compare handle. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **before** - The container that wraps the before image.\n- **after** - The container that wraps the after image.\n- **divider** - The divider that separates the images.\n- **handle** - The handle that the user drags to expose the after image.",
-      "attributes": [
-        {
-          "name": "position",
-          "description": "The position of the divider as a percentage.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/image-comparer"
-        }
-      ]
-    },
-    {
-      "name": "sl-include",
-      "description": "Includes give you the power to embed external HTML files into the page.\n---\n\n\n### **Events:**\n - **sl-load** - Emitted when the included file is loaded.\n- **sl-error** - Emitted when the included file fails to load due to an error.",
-      "attributes": [
-        {
-          "name": "src",
-          "description": "The location of the HTML file to include. Be sure you trust the content you are including as it will be executed as\ncode and can result in XSS attacks.",
-          "values": []
-        },
-        {
-          "name": "mode",
-          "description": "The fetch mode to use.",
-          "values": [
-            { "name": "cors" },
-            { "name": "no-cors" },
-            { "name": "same-origin" }
-          ]
-        },
-        {
-          "name": "allow-scripts",
-          "description": "Allows included scripts to be executed. Be sure you trust the content you are including as it will be executed as\ncode and can result in XSS attacks.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/include"
-        }
-      ]
-    },
     {
       "name": "sl-input",
       "description": "Inputs collect data from the user.\n---\n\n\n### **Events:**\n - **sl-blur** - Emitted when the control loses focus.\n- **sl-change** - Emitted when an alteration to the control's value is committed by the user.\n- **sl-clear** - Emitted when the clear button is activated.\n- **sl-focus** - Emitted when the control gains focus.\n- **sl-input** - Emitted when the control receives input.\n- **sl-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the input.\n- **blur()** - Removes focus from the input.\n- **select()** - Selects all the text in the input.\n- **setSelectionRange(selectionStart: _number_, selectionEnd: _number_, selectionDirection: _'forward' | 'backward' | 'none'_)** - Sets the start and end positions of the text selection (0-based).\n- **setRangeText(replacement: _string_, start: _number_, end: _number_, selectMode: _'select' | 'start' | 'end' | 'preserve'_)** - Replaces a range of text with a new string.\n- **showPicker()** - Displays the browser picker for an input element (only works if the browser supports it for the input type).\n- **stepUp()** - Increments the value of a numeric input type by the value of the step attribute.\n- **stepDown()** - Decrements the value of a numeric input type by the value of the step attribute.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - **label** - The input's label. Alternatively, you can use the `label` attribute.\n- **prefix** - Used to prepend a presentational icon or similar element to the input.\n- **suffix** - Used to append a presentational icon or similar element to the input.\n- **clear-icon** - An icon to use in lieu of the default clear icon.\n- **show-password-icon** - An icon to use in lieu of the default show password icon.\n- **hide-password-icon** - An icon to use in lieu of the default hide password icon.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The input's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **base** - The component's base wrapper.\n- **input** - The internal `<input>` control.\n- **prefix** - The container that wraps the prefix.\n- **clear-button** - The clear button.\n- **password-toggle-button** - The password toggle button.\n- **suffix** - The container that wraps the suffix.",
@@ -1766,6 +1830,17 @@
         }
       ]
     },
+    {
+      "name": "sl-menu",
+      "description": "Menus provide a list of options for the user to choose from.\n---\n\n\n### **Events:**\n - **sl-select** - Emitted when a menu item is selected.\n\n### **Slots:**\n - _default_ - The menu's content, including menu items, menu labels, and dividers.",
+      "attributes": [],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/menu"
+        }
+      ]
+    },
     {
       "name": "sl-menu-item",
       "description": "Menu items provide options for the user to pick from in a menu.\n---\n\n\n### **Methods:**\n - **getTextLabel()** - Returns a text label based on the contents of the menu item's default slot.\n\n### **Slots:**\n - _default_ - The menu item's label.\n- **prefix** - Used to prepend an icon or similar element to the menu item.\n- **suffix** - Used to append an icon or similar element to the menu item.\n- **submenu** - Used to denote a nested menu.\n\n### **CSS Properties:**\n - **--submenu-offset** - The distance submenus shift to overlap the parent menu. _(default: -2px)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **checked-icon** - The checked icon, which is only visible when the menu item is checked.\n- **prefix** - The prefix container.\n- **label** - The menu item label.\n- **suffix** - The suffix container.\n- **spinner** - The spinner that shows when the menu item is in the loading state.\n- **spinner__base** - The spinner's base part.\n- **submenu-icon** - The submenu icon, visible only when the menu item has a submenu (not yet implemented).",
@@ -1814,59 +1889,6 @@
         }
       ]
     },
-    {
-      "name": "sl-menu",
-      "description": "Menus provide a list of options for the user to choose from.\n---\n\n\n### **Events:**\n - **sl-select** - Emitted when a menu item is selected.\n\n### **Slots:**\n - _default_ - The menu's content, including menu items, menu labels, and dividers.",
-      "attributes": [],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/menu"
-        }
-      ]
-    },
-    {
-      "name": "sl-mutation-observer",
-      "description": "The Mutation Observer component offers a thin, declarative interface to the [`MutationObserver API`](https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver).\n---\n\n\n### **Events:**\n - **sl-mutation** - Emitted when a mutation occurs.\n\n### **Slots:**\n - _default_ - The content to watch for mutations.",
-      "attributes": [
-        {
-          "name": "attr",
-          "description": "Watches for changes to attributes. To watch only specific attributes, separate them by a space, e.g.\n`attr=\"class id title\"`. To watch all attributes, use `*`.",
-          "values": []
-        },
-        {
-          "name": "attr-old-value",
-          "description": "Indicates whether or not the attribute's previous value should be recorded when monitoring changes.",
-          "values": []
-        },
-        {
-          "name": "char-data",
-          "description": "Watches for changes to the character data contained within the node.",
-          "values": []
-        },
-        {
-          "name": "char-data-old-value",
-          "description": "Indicates whether or not the previous value of the node's text should be recorded.",
-          "values": []
-        },
-        {
-          "name": "child-list",
-          "description": "Watches for the addition or removal of new child nodes.",
-          "values": []
-        },
-        {
-          "name": "disabled",
-          "description": "Disables the observer.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/mutation-observer"
-        }
-      ]
-    },
     {
       "name": "sl-nav",
       "description": "Navs are used to create navigation menus, including top bars and sidebars.\n---\n\n\n### **Events:**\n - **sl-change** - Emitted when the selected nav item changes.\n- **sl-nav-open-change** - Emitted when the open submenu keys change.\n- **sl-nav-select** - Emitted when a nav item is selected.\n\n### **Slots:**\n - _default_ - The nav items.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -1961,83 +1983,44 @@
       ]
     },
     {
-      "name": "sl-nav-item",
-      "description": "Nav items are the individual links or buttons within a navigation menu.\n---\n\n\n### **Events:**\n - **sl-nav-select** - Emitted when a nav item is selected.\n\n### **Slots:**\n - _default_ - The nav item's label.\n- **prefix** - Used to prepend an icon or similar element to the nav item.\n- **suffix** - Used to append an icon or similar element to the nav item.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **prefix** - The prefix container.\n- **label** - The nav item label.\n- **suffix** - The suffix container.",
+      "name": "sl-mutation-observer",
+      "description": "The Mutation Observer component offers a thin, declarative interface to the [`MutationObserver API`](https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver).\n---\n\n\n### **Events:**\n - **sl-mutation** - Emitted when a mutation occurs.\n\n### **Slots:**\n - _default_ - The content to watch for mutations.",
       "attributes": [
         {
-          "name": "key",
-          "description": "A stable key used by `sl-nav` to track selection.",
-          "values": []
-        },
-        {
-          "name": "item-key",
-          "description": "React-safe alias for `key`.\n\nReact reserves `key` and won't forward it to custom elements, so wrapper users can pass `itemKey` instead.",
-          "values": []
-        },
-        {
-          "name": "danger",
-          "description": "Matches Antd's `danger` item flag.",
-          "values": []
-        },
-        {
-          "name": "title",
-          "description": "Tooltip text, primarily used when the menu is collapsed.",
-          "values": []
-        },
-        {
-          "name": "disabled",
-          "description": "Draws the nav item in a disabled state.",
-          "values": []
-        },
-        {
-          "name": "active",
-          "description": "Draws the nav item in an active (selected) state.",
-          "values": []
-        },
-        {
-          "name": "href",
-          "description": "The URL to link to. If set, the nav item will render as an anchor tag.",
+          "name": "attr",
+          "description": "Watches for changes to attributes. To watch only specific attributes, separate them by a space, e.g.\n`attr=\"class id title\"`. To watch all attributes, use `*`.",
           "values": []
         },
         {
-          "name": "target",
-          "description": "The target attribute for the anchor tag.",
-          "values": [
-            { "name": "_blank" },
-            { "name": "_parent" },
-            { "name": "_self" },
-            { "name": "_top" }
-          ]
+          "name": "attr-old-value",
+          "description": "Indicates whether or not the attribute's previous value should be recorded when monitoring changes.",
+          "values": []
         },
         {
-          "name": "download",
-          "description": "The download attribute for the anchor tag.",
+          "name": "char-data",
+          "description": "Watches for changes to the character data contained within the node.",
           "values": []
         },
         {
-          "name": "rel",
-          "description": "The rel attribute for the anchor tag.",
+          "name": "char-data-old-value",
+          "description": "Indicates whether or not the previous value of the node's text should be recorded.",
           "values": []
         },
         {
-          "name": "mode",
-          "description": "The mode of navigation.",
-          "values": [
-            { "name": "horizontal" },
-            { "name": "inline" },
-            { "name": "vertical" }
-          ]
+          "name": "child-list",
+          "description": "Watches for the addition or removal of new child nodes.",
+          "values": []
         },
         {
-          "name": "collapsed",
-          "description": "Whether the parent nav is in inline-collapsed mode.",
+          "name": "disabled",
+          "description": "Disables the observer.",
           "values": []
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/nav-item"
+          "url": "https://shoelace.style/components/mutation-observer"
         }
       ]
     },
@@ -2191,6 +2174,87 @@
         }
       ]
     },
+    {
+      "name": "sl-nav-item",
+      "description": "Nav items are the individual links or buttons within a navigation menu.\n---\n\n\n### **Events:**\n - **sl-nav-select** - Emitted when a nav item is selected.\n\n### **Slots:**\n - _default_ - The nav item's label.\n- **prefix** - Used to prepend an icon or similar element to the nav item.\n- **suffix** - Used to append an icon or similar element to the nav item.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **prefix** - The prefix container.\n- **label** - The nav item label.\n- **suffix** - The suffix container.",
+      "attributes": [
+        {
+          "name": "key",
+          "description": "A stable key used by `sl-nav` to track selection.",
+          "values": []
+        },
+        {
+          "name": "item-key",
+          "description": "React-safe alias for `key`.\n\nReact reserves `key` and won't forward it to custom elements, so wrapper users can pass `itemKey` instead.",
+          "values": []
+        },
+        {
+          "name": "danger",
+          "description": "Matches Antd's `danger` item flag.",
+          "values": []
+        },
+        {
+          "name": "title",
+          "description": "Tooltip text, primarily used when the menu is collapsed.",
+          "values": []
+        },
+        {
+          "name": "disabled",
+          "description": "Draws the nav item in a disabled state.",
+          "values": []
+        },
+        {
+          "name": "active",
+          "description": "Draws the nav item in an active (selected) state.",
+          "values": []
+        },
+        {
+          "name": "href",
+          "description": "The URL to link to. If set, the nav item will render as an anchor tag.",
+          "values": []
+        },
+        {
+          "name": "target",
+          "description": "The target attribute for the anchor tag.",
+          "values": [
+            { "name": "_blank" },
+            { "name": "_parent" },
+            { "name": "_self" },
+            { "name": "_top" }
+          ]
+        },
+        {
+          "name": "download",
+          "description": "The download attribute for the anchor tag.",
+          "values": []
+        },
+        {
+          "name": "rel",
+          "description": "The rel attribute for the anchor tag.",
+          "values": []
+        },
+        {
+          "name": "mode",
+          "description": "The mode of navigation.",
+          "values": [
+            { "name": "horizontal" },
+            { "name": "inline" },
+            { "name": "vertical" }
+          ]
+        },
+        {
+          "name": "collapsed",
+          "description": "Whether the parent nav is in inline-collapsed mode.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/nav-item"
+        }
+      ]
+    },
     {
       "name": "sl-pagination",
       "description": "\n---\n",
@@ -2364,33 +2428,6 @@
         }
       ]
     },
-    {
-      "name": "sl-progress-bar",
-      "description": "Progress bars are used to show the status of an ongoing operation.\n---\n\n\n### **Slots:**\n - _default_ - A label to show inside the progress indicator.\n\n### **CSS Properties:**\n - **--height** - The progress bar's height. _(default: undefined)_\n- **--track-color** - The color of the track. _(default: undefined)_\n- **--indicator-color** - The color of the indicator. _(default: undefined)_\n- **--label-color** - The color of the label. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **indicator** - The progress bar's indicator.\n- **label** - The progress bar's label.",
-      "attributes": [
-        {
-          "name": "value",
-          "description": "The current progress as a percentage, 0 to 100.",
-          "values": []
-        },
-        {
-          "name": "indeterminate",
-          "description": "When true, percentage is ignored, the label is hidden, and the progress bar is drawn in an indeterminate state.",
-          "values": []
-        },
-        {
-          "name": "label",
-          "description": "A custom label for assistive devices.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/progress-bar"
-        }
-      ]
-    },
     {
       "name": "sl-progress-ring",
       "description": "Progress rings are used to show the progress of a determinate operation in a circular fashion.\n---\n\n\n### **Slots:**\n - _default_ - A label to show inside the ring.\n\n### **CSS Properties:**\n - **--size** - The diameter of the progress ring (cannot be a percentage). _(default: undefined)_\n- **--track-width** - The width of the track. _(default: undefined)_\n- **--track-color** - The color of the track. _(default: undefined)_\n- **--indicator-width** - The width of the indicator. Defaults to the track width. _(default: undefined)_\n- **--indicator-color** - The color of the indicator. _(default: undefined)_\n- **--indicator-transition-duration** - The duration of the indicator's transition when the value changes. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **label** - The progress ring label.",
@@ -2413,37 +2450,6 @@
         }
       ]
     },
-    {
-      "name": "sl-radio",
-      "description": "Radios allow the user to select a single option from a group.\n---\n\n\n### **Events:**\n - **sl-blur** - Emitted when the control loses focus.\n- **sl-focus** - Emitted when the control gains focus.\n\n### **Slots:**\n - _default_ - The radio's label.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **control** - The circular container that wraps the radio's checked state.\n- **control--checked** - The radio control when the radio is checked.\n- **checked-icon** - The checked icon, an `<sl-icon>` element.\n- **label** - The container that wraps the radio's label.",
-      "attributes": [
-        {
-          "name": "value",
-          "description": "The radio's value. When selected, the radio group will receive this value.",
-          "values": []
-        },
-        {
-          "name": "size",
-          "description": "The radio's size. When used inside a radio group, the size will be determined by the radio group's size so this\nattribute can typically be omitted.",
-          "values": [
-            { "name": "small" },
-            { "name": "medium" },
-            { "name": "large" }
-          ]
-        },
-        {
-          "name": "disabled",
-          "description": "Disables the radio.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/radio"
-        }
-      ]
-    },
     {
       "name": "sl-qr-code",
       "description": "Generates a [QR code](https://www.qrcode.com/) and renders it using the [Canvas API](https://developer.mozilla.org/en-US/docs/Web/API/Canvas_API).\n---\n\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -2497,22 +2503,17 @@
       ]
     },
     {
-      "name": "sl-radio-button",
-      "description": "Radios buttons allow the user to select a single option from a group using a button-like control.\n---\n\n\n### **Events:**\n - **sl-blur** - Emitted when the button loses focus.\n- **sl-focus** - Emitted when the button gains focus.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the radio button.\n- **blur()** - Removes focus from the radio button.\n\n### **Slots:**\n - _default_ - The radio button's label.\n- **prefix** - A presentational prefix icon or similar element.\n- **suffix** - A presentational suffix icon or similar element.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **button** - The internal `<button>` element.\n- **button--checked** - The internal button element when the radio button is checked.\n- **prefix** - The container that wraps the prefix.\n- **label** - The container that wraps the radio button's label.\n- **suffix** - The container that wraps the suffix.",
+      "name": "sl-radio",
+      "description": "Radios allow the user to select a single option from a group.\n---\n\n\n### **Events:**\n - **sl-blur** - Emitted when the control loses focus.\n- **sl-focus** - Emitted when the control gains focus.\n\n### **Slots:**\n - _default_ - The radio's label.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **control** - The circular container that wraps the radio's checked state.\n- **control--checked** - The radio control when the radio is checked.\n- **checked-icon** - The checked icon, an `<sl-icon>` element.\n- **label** - The container that wraps the radio's label.",
       "attributes": [
         {
           "name": "value",
           "description": "The radio's value. When selected, the radio group will receive this value.",
           "values": []
         },
-        {
-          "name": "disabled",
-          "description": "Disables the radio button.",
-          "values": []
-        },
         {
           "name": "size",
-          "description": "The radio button's size. When used inside a radio group, the size will be determined by the radio group's size so\nthis attribute can typically be omitted.",
+          "description": "The radio's size. When used inside a radio group, the size will be determined by the radio group's size so this\nattribute can typically be omitted.",
           "values": [
             { "name": "small" },
             { "name": "medium" },
@@ -2520,21 +2521,21 @@
           ]
         },
         {
-          "name": "pill",
-          "description": "Draws a pill-style radio button with rounded edges.",
+          "name": "disabled",
+          "description": "Disables the radio.",
           "values": []
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/radio-button"
+          "url": "https://shoelace.style/components/radio"
         }
       ]
     },
     {
       "name": "sl-radio-group",
-      "description": "Radio groups are used to group multiple [radios](/components/radio) or [radio buttons](/components/radio-button) so they function as a single form control.\n---\n\n\n### **Events:**\n - **sl-change** - Emitted when the radio group's selected value changes.\n- **sl-input** - Emitted when the radio group receives user input.\n- **sl-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity(): _boolean_** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message)** - Sets a custom validation message. Pass an empty string to restore validity.\n- **focus(options: _FocusOptions_)** - Sets focus on the radio-group.\n\n### **Slots:**\n - _default_ - The default slot where `<sl-radio>` or `<sl-radio-button>` elements are placed.\n- **label** - The radio group's label. Required for proper accessibility. Alternatively, you can use the `label` attribute.\n- **help-text** - Text that describes how to use the radio group. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The input's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **button-group** - The button group that wraps radio buttons.\n- **button-group__base** - The button group's `base` part.",
+      "description": "Radio groups are used to group multiple [radios](/components/radio) or [radio buttons](/components/radio-button) so they function as a single form control.\n---\n\n\n### **Events:**\n - **sl-change** - Emitted when the radio group's selected value changes.\n- **sl-input** - Emitted when the radio group receives user input.\n- **sl-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity(): _boolean_** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message)** - Sets a custom validation message. Pass an empty string to restore validity.\n- **focus(options: _FocusOptions_)** - Sets focus on the radio-group.\n\n### **Slots:**\n - _default_ - The default slot where `<sl-radio>` or `<sl-radio-button>` elements are placed.\n- **label** - The radio group's label. Required for proper accessibility. Alternatively, you can use the `label` attribute.\n- **help-text** - Text that describes how to use the radio group. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The input's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **button-group** - The button group that wraps radio buttons.\n- **button-group__base** - The button group's `base` part.\n- **radios** - The container that wraps the radio elements (only when not using radio buttons).",
       "attributes": [
         {
           "name": "label",
@@ -2565,6 +2566,11 @@
             { "name": "large" }
           ]
         },
+        {
+          "name": "layout",
+          "description": "The layout direction of the radio group.",
+          "values": [{ "name": "horizontal" }, { "name": "vertical" }]
+        },
         {
           "name": "form",
           "description": "By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.",
@@ -2629,24 +2635,87 @@
           "values": []
         },
         {
-          "name": "tooltip",
-          "description": "The preferred placement of the range's tooltip.",
+          "name": "tooltip",
+          "description": "The preferred placement of the range's tooltip.",
+          "values": [
+            { "name": "top" },
+            { "name": "bottom" },
+            { "name": "none" }
+          ]
+        },
+        {
+          "name": "form",
+          "description": "By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/range"
+        }
+      ]
+    },
+    {
+      "name": "sl-progress-bar",
+      "description": "Progress bars are used to show the status of an ongoing operation.\n---\n\n\n### **Slots:**\n - _default_ - A label to show inside the progress indicator.\n\n### **CSS Properties:**\n - **--height** - The progress bar's height. _(default: undefined)_\n- **--track-color** - The color of the track. _(default: undefined)_\n- **--indicator-color** - The color of the indicator. _(default: undefined)_\n- **--label-color** - The color of the label. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **indicator** - The progress bar's indicator.\n- **label** - The progress bar's label.",
+      "attributes": [
+        {
+          "name": "value",
+          "description": "The current progress as a percentage, 0 to 100.",
+          "values": []
+        },
+        {
+          "name": "indeterminate",
+          "description": "When true, percentage is ignored, the label is hidden, and the progress bar is drawn in an indeterminate state.",
+          "values": []
+        },
+        {
+          "name": "label",
+          "description": "A custom label for assistive devices.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/progress-bar"
+        }
+      ]
+    },
+    {
+      "name": "sl-radio-button",
+      "description": "Radios buttons allow the user to select a single option from a group using a button-like control.\n---\n\n\n### **Events:**\n - **sl-blur** - Emitted when the button loses focus.\n- **sl-focus** - Emitted when the button gains focus.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the radio button.\n- **blur()** - Removes focus from the radio button.\n\n### **Slots:**\n - _default_ - The radio button's label.\n- **prefix** - A presentational prefix icon or similar element.\n- **suffix** - A presentational suffix icon or similar element.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **button** - The internal `<button>` element.\n- **button--checked** - The internal button element when the radio button is checked.\n- **prefix** - The container that wraps the prefix.\n- **label** - The container that wraps the radio button's label.\n- **suffix** - The container that wraps the suffix.",
+      "attributes": [
+        {
+          "name": "value",
+          "description": "The radio's value. When selected, the radio group will receive this value.",
+          "values": []
+        },
+        {
+          "name": "disabled",
+          "description": "Disables the radio button.",
+          "values": []
+        },
+        {
+          "name": "size",
+          "description": "The radio button's size. When used inside a radio group, the size will be determined by the radio group's size so\nthis attribute can typically be omitted.",
           "values": [
-            { "name": "top" },
-            { "name": "bottom" },
-            { "name": "none" }
+            { "name": "small" },
+            { "name": "medium" },
+            { "name": "large" }
           ]
         },
         {
-          "name": "form",
-          "description": "By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.",
+          "name": "pill",
+          "description": "Draws a pill-style radio button with rounded edges.",
           "values": []
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/range"
+          "url": "https://shoelace.style/components/radio-button"
         }
       ]
     },
@@ -2778,6 +2847,93 @@
         }
       ]
     },
+    {
+      "name": "sl-sender",
+      "description": "Senders are used to send messages. They support plain text input, structured slot-based input, speech recognition, skill tagging, and customizable header/footer/prefix/suffix areas.\n---\n\n\n### **Events:**\n - **sl-change** - Emitted when the sender's value changes. The event detail includes `{ value, slotConfig, skill }`.\n- **sl-submit** - Emitted when the sender's submit button is clicked or Enter is pressed. The event detail includes `{ value }` or `{ value, slotConfig, skill }` in slot mode.\n- **sl-clear** - Emitted when the sender's content is cleared.\n- **sl-speech-toggle** - Emitted when the sender's speech button is clicked.\n- **sl-focus** - Emitted when the sender's input area gains focus.\n- **sl-blur** - Emitted when the sender's input area loses focus.\n- **sl-paste** - Emitted when content is pasted into the sender. The event detail includes `{ event }`.\n- **sl-paste-file** - Emitted when files are pasted into the sender. The event detail includes `{ files }`.\n\n### **Methods:**\n - **focus(options: _SenderFocusOptions_)** - 聚焦输入区域，支持 cursor 选项控制光标位置。\n- 'end'（默认）：光标移到内容末尾\n- 'start'：光标移到内容开头\n- 'all'：全选内容\n- 'slot'：聚焦第一个 slot input，若不存在则等同 'end'\n- **blur()** - 移除输入区域焦点\n- **clear()** - 清空输入内容，slot 模式下同时重置 slotValues\n- **getValue(): _{ value: string; slotConfig: SlotConfigType[]; skill?: SkillType }_** - 获取当前输入值，slot 模式下返回完整的 { value, slotConfig, skill }\n- **insert(slotConfig: _SlotConfigType[]_, position: _InsertPosition_, _replaceCharacters: _string_, preventScroll: _boolean_)** - 插入文本或 slot 配置项到输入区域\nslot 模式下将 slotConfig 项渲染为 DOM 节点插入到 slot-area\n普通模式下将各项文本拼接后插入到 textarea\n\n### **Slots:**\n - **prefix** - Used to prepend content to the input area.\n- **suffix** - Used to append action buttons or content to the input area. Defaults to the speech button and send button.\n- **header** - Used to add content above the input area.\n- **footer** - Used to add content below the input area, such as toolbar actions.\n\n### **CSS Properties:**\n - **--sl-sender-border-width** - The border width of the sender container. _(default: undefined)_\n- **--sl-sender-border-color** - The border color of the sender container. _(default: undefined)_\n- **--sl-sender-border-color-hover** - The border color when hovered. _(default: undefined)_\n- **--sl-sender-border-color-focus** - The border color when focused. _(default: undefined)_\n- **--sl-sender-border-color-disabled** - The border color when disabled. _(default: undefined)_\n- **--sl-sender-background-color** - The background color of the sender container. _(default: undefined)_\n- **--sl-sender-background-color-disabled** - The background color when disabled. _(default: undefined)_\n- **--sl-sender-shadow** - The box shadow of the sender container. _(default: undefined)_\n- **--sl-sender-shadow-focus** - The box shadow when focused. _(default: undefined)_\n- **--sl-sender-input-color** - The text color of the input area. _(default: undefined)_\n- **--sl-sender-input-color-disabled** - The text color when disabled. _(default: undefined)_\n- **--sl-sender-input-placeholder-color** - The placeholder text color. _(default: undefined)_\n- **--sl-sender-input-placeholder-color-disabled** - The placeholder text color when disabled. _(default: undefined)_\n- **--sl-sender-action-color** - The color of action buttons. _(default: undefined)_\n- **--sl-sender-action-color-hover** - The color of action buttons when hovered. _(default: undefined)_\n- **--sl-sender-action-color-active** - The color of action buttons when active. _(default: undefined)_\n- **--sl-sender-action-color-disabled** - The color of action buttons when disabled. _(default: undefined)_\n- **--sl-sender-action-background-hover** - The background color of action buttons when hovered. _(default: undefined)_\n- **--sl-sender-action-background-active** - The background color of action buttons when active. _(default: undefined)_\n- **--sl-sender-action-border-radius** - The border radius of action buttons. _(default: undefined)_\n- **--sl-sender-submit-color** - The color of the submit button. _(default: undefined)_\n- **--sl-sender-submit-color-active** - The color of the submit button when active. _(default: undefined)_\n- **--sl-sender-submit-background** - The background color of the submit button. _(default: undefined)_\n- **--sl-sender-submit-background-hover** - The background color of the submit button when hovered. _(default: undefined)_\n- **--sl-sender-submit-background-active** - The background color of the submit button when active. _(default: undefined)_\n- **--sl-sender-submit-background-disabled** - The background color of the submit button when disabled. _(default: undefined)_\n- **--sl-sender-submit-border-radius** - The border radius of the submit button. _(default: undefined)_\n- **--sl-sender-voice-recording-background** - The background color of the recording button. _(default: undefined)_\n- **--sl-sender-voice-waveform-color** - The color of the voice waveform bars during recording. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **input** - The internal `<sl-textarea>` control (plain text mode).\n- **slot-area** - The slot-based input area container (slot mode).\n- **skill** - The skill tag element.\n- **header** - The header area wrapper.\n- **footer** - The footer area wrapper.\n- **actions** - The action buttons container in the suffix area.",
+      "attributes": [
+        {
+          "name": "value",
+          "description": "The current value of the sender, submitted as part of the event detail on submit.",
+          "values": []
+        },
+        {
+          "name": "placeholder",
+          "description": "Placeholder text to show as a hint when the input is empty.",
+          "values": []
+        },
+        {
+          "name": "loading",
+          "description": "Draws the sender in a loading state, typically used while waiting for a response.",
+          "values": []
+        },
+        {
+          "name": "disabled",
+          "description": "Disables the sender.",
+          "values": []
+        },
+        {
+          "name": "read-only",
+          "description": "Makes the sender readonly.",
+          "values": []
+        },
+        {
+          "name": "rows",
+          "description": "The number of rows to display for the textarea. Only applies in plain text mode.",
+          "values": []
+        },
+        {
+          "name": "submit-type",
+          "description": "Determines how the Enter key behaves. When set to `enter`, pressing Enter submits. When set to `shift-enter`, pressing Shift+Enter submits.",
+          "values": [{ "name": "enter" }, { "name": "shift-enter" }]
+        },
+        {
+          "name": "slotConfig",
+          "description": "An array of slot configuration items for structured input mode. Supports `text`, `input`, `select`, `tag`, `content`, and `custom` types.",
+          "values": [{ "name": "SlotConfigType[]" }]
+        },
+        {
+          "name": "skill",
+          "description": "The skill tag to display in the slot input area. Includes `value`, optional `title`, and optional `closable` configuration.",
+          "values": [{ "name": "SkillType" }]
+        },
+        {
+          "name": "footer",
+          "description": "Custom footer content or render function. Set to `false` to hide the footer.",
+          "values": [{ "name": "BaseNode" }, { "name": "NodeRender" }]
+        },
+        {
+          "name": "header",
+          "description": "Custom header content or render function. Set to `false` to hide the header.",
+          "values": [{ "name": "BaseNode" }, { "name": "NodeRender" }]
+        },
+        {
+          "name": "prefixContent",
+          "description": "Custom prefix content or render function. Set to `false` to hide the prefix.",
+          "values": [{ "name": "BaseNode" }, { "name": "NodeRender" }]
+        },
+        {
+          "name": "suffixContent",
+          "description": "Custom suffix content or render function. Set to `false` to hide the suffix (action buttons).",
+          "values": [{ "name": "BaseNode" }, { "name": "NodeRender" }]
+        },
+        {
+          "name": "allow-speech",
+          "description": "Enables speech recognition input. Set to `true` for uncontrolled mode, or pass a `ControlledSpeechConfig` object for controlled mode.",
+          "values": [{ "name": "AllowSpeech" }]
+        },
+        {
+          "name": "speech-recording",
+          "description": "Whether speech recognition is currently recording. Only applies in uncontrolled speech mode.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/sender"
+        }
+      ]
+    },
     {
       "name": "sl-screen",
       "description": "Screen is a grid layout component based on gridstack.js and Shoelace.\n---\n\n\n### **Methods:**\n - **getGridData(): __** - 获取 GridStack 实例的序列化数据\n- **getInstance(): __** - 获取 GridStack 实例的序列化数据\n\n### **CSS Parts:**\n - **base** - The grid layout content.",
@@ -2925,121 +3081,43 @@
       ]
     },
     {
-      "name": "sl-sender-header",
-      "description": "A collapsible header panel for the Sender component.\n---\n\n\n### **Events:**\n - **sl-open-change** - Emitted when the open state changes. `event.detail.open` indicates the new state.\n\n### **Slots:**\n - _default_ - The panel content (children).\n- **title** - The header title content. Alternatively use the `title` attribute for plain text.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **header** - The header bar containing title and close button.\n- **title** - The title wrapper inside the header.\n- **content** - The collapsible content area.",
-      "attributes": [
-        {
-          "name": "open",
-          "description": "Whether the panel content is expanded.",
-          "values": []
-        },
-        {
-          "name": "closable",
-          "description": "Whether the close/toggle button is shown.",
-          "values": []
-        },
-        {
-          "name": "title",
-          "description": "Plain-text title. Use the `title` slot for rich content.",
-          "values": []
-        },
-        {
-          "name": "force-render",
-          "description": "When true, the content DOM is always rendered even when collapsed.\nUseful when you need refs to inner elements on initial mount.\nWhen false (default), content is removed from the DOM when closed.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/sender-header"
-        }
-      ]
-    },
-    {
-      "name": "sl-sender",
-      "description": "Senders are used to send messages. They support plain text input, structured slot-based input, speech recognition, skill tagging, and customizable header/footer/prefix/suffix areas.\n---\n\n\n### **Events:**\n - **sl-change** - Emitted when the sender's value changes. The event detail includes `{ value, slotConfig, skill }`.\n- **sl-submit** - Emitted when the sender's submit button is clicked or Enter is pressed. The event detail includes `{ value }` or `{ value, slotConfig, skill }` in slot mode.\n- **sl-clear** - Emitted when the sender's content is cleared.\n- **sl-speech-toggle** - Emitted when the sender's speech button is clicked.\n- **sl-focus** - Emitted when the sender's input area gains focus.\n- **sl-blur** - Emitted when the sender's input area loses focus.\n- **sl-paste** - Emitted when content is pasted into the sender. The event detail includes `{ event }`.\n- **sl-paste-file** - Emitted when files are pasted into the sender. The event detail includes `{ files }`.\n\n### **Methods:**\n - **focus(options: _SenderFocusOptions_)** - 聚焦输入区域，支持 cursor 选项控制光标位置。\n- 'end'（默认）：光标移到内容末尾\n- 'start'：光标移到内容开头\n- 'all'：全选内容\n- 'slot'：聚焦第一个 slot input，若不存在则等同 'end'\n- **blur()** - 移除输入区域焦点\n- **clear()** - 清空输入内容，slot 模式下同时重置 slotValues\n- **getValue(): _{ value: string; slotConfig: SlotConfigType[]; skill?: SkillType }_** - 获取当前输入值，slot 模式下返回完整的 { value, slotConfig, skill }\n- **insert(slotConfig: _SlotConfigType[]_, position: _InsertPosition_, _replaceCharacters: _string_, preventScroll: _boolean_)** - 插入文本或 slot 配置项到输入区域\nslot 模式下将 slotConfig 项渲染为 DOM 节点插入到 slot-area\n普通模式下将各项文本拼接后插入到 textarea\n\n### **Slots:**\n - **prefix** - Used to prepend content to the input area.\n- **suffix** - Used to append action buttons or content to the input area. Defaults to the speech button and send button.\n- **header** - Used to add content above the input area.\n- **footer** - Used to add content below the input area, such as toolbar actions.\n\n### **CSS Properties:**\n - **--sl-sender-border-width** - The border width of the sender container. _(default: undefined)_\n- **--sl-sender-border-color** - The border color of the sender container. _(default: undefined)_\n- **--sl-sender-border-color-hover** - The border color when hovered. _(default: undefined)_\n- **--sl-sender-border-color-focus** - The border color when focused. _(default: undefined)_\n- **--sl-sender-border-color-disabled** - The border color when disabled. _(default: undefined)_\n- **--sl-sender-background-color** - The background color of the sender container. _(default: undefined)_\n- **--sl-sender-background-color-disabled** - The background color when disabled. _(default: undefined)_\n- **--sl-sender-shadow** - The box shadow of the sender container. _(default: undefined)_\n- **--sl-sender-shadow-focus** - The box shadow when focused. _(default: undefined)_\n- **--sl-sender-input-color** - The text color of the input area. _(default: undefined)_\n- **--sl-sender-input-color-disabled** - The text color when disabled. _(default: undefined)_\n- **--sl-sender-input-placeholder-color** - The placeholder text color. _(default: undefined)_\n- **--sl-sender-input-placeholder-color-disabled** - The placeholder text color when disabled. _(default: undefined)_\n- **--sl-sender-action-color** - The color of action buttons. _(default: undefined)_\n- **--sl-sender-action-color-hover** - The color of action buttons when hovered. _(default: undefined)_\n- **--sl-sender-action-color-active** - The color of action buttons when active. _(default: undefined)_\n- **--sl-sender-action-color-disabled** - The color of action buttons when disabled. _(default: undefined)_\n- **--sl-sender-action-background-hover** - The background color of action buttons when hovered. _(default: undefined)_\n- **--sl-sender-action-background-active** - The background color of action buttons when active. _(default: undefined)_\n- **--sl-sender-action-border-radius** - The border radius of action buttons. _(default: undefined)_\n- **--sl-sender-submit-color** - The color of the submit button. _(default: undefined)_\n- **--sl-sender-submit-color-active** - The color of the submit button when active. _(default: undefined)_\n- **--sl-sender-submit-background** - The background color of the submit button. _(default: undefined)_\n- **--sl-sender-submit-background-hover** - The background color of the submit button when hovered. _(default: undefined)_\n- **--sl-sender-submit-background-active** - The background color of the submit button when active. _(default: undefined)_\n- **--sl-sender-submit-background-disabled** - The background color of the submit button when disabled. _(default: undefined)_\n- **--sl-sender-submit-border-radius** - The border radius of the submit button. _(default: undefined)_\n- **--sl-sender-voice-recording-background** - The background color of the recording button. _(default: undefined)_\n- **--sl-sender-voice-waveform-color** - The color of the voice waveform bars during recording. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **input** - The internal `<sl-textarea>` control (plain text mode).\n- **slot-area** - The slot-based input area container (slot mode).\n- **skill** - The skill tag element.\n- **header** - The header area wrapper.\n- **footer** - The footer area wrapper.\n- **actions** - The action buttons container in the suffix area.",
+      "name": "sl-space",
+      "description": "Space 组件用于设置组件之间的间距。\n---\n\n\n### **Slots:**\n - _default_ - 需要添加间距的子元素。\n\n### **CSS Properties:**\n - **--gap** - 自定义间距大小。 _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - 组件的基础容器。\n- **item** - 每个子元素的包装容器。\n- **separator** - 分隔符容器。",
       "attributes": [
         {
-          "name": "value",
-          "description": "The current value of the sender, submitted as part of the event detail on submit.",
-          "values": []
-        },
-        {
-          "name": "placeholder",
-          "description": "Placeholder text to show as a hint when the input is empty.",
-          "values": []
-        },
-        {
-          "name": "loading",
-          "description": "Draws the sender in a loading state, typically used while waiting for a response.",
-          "values": []
+          "name": "orientation",
+          "description": "间距方向，vertical 为垂直方向，horizontal 为水平方向",
+          "values": [{ "name": "horizontal" }, { "name": "vertical" }]
         },
         {
-          "name": "disabled",
-          "description": "Disables the sender.",
-          "values": []
+          "name": "size",
+          "description": "间距大小，可选 small、medium、large 或自定义数值（单位为 px）",
+          "values": [
+            { "name": "SpaceSize" },
+            { "name": "[SpaceSize, SpaceSize]" }
+          ]
         },
         {
-          "name": "read-only",
-          "description": "Makes the sender readonly.",
-          "values": []
+          "name": "align",
+          "description": "对齐方式",
+          "values": [
+            { "name": "start" },
+            { "name": "end" },
+            { "name": "center" },
+            { "name": "baseline" }
+          ]
         },
         {
-          "name": "rows",
-          "description": "The number of rows to display for the textarea. Only applies in plain text mode.",
+          "name": "wrap",
+          "description": "是否自动换行，仅在 horizontal 方向时有效",
           "values": []
         },
-        {
-          "name": "submit-type",
-          "description": "Determines how the Enter key behaves. When set to `enter`, pressing Enter submits. When set to `shift-enter`, pressing Shift+Enter submits.",
-          "values": [{ "name": "enter" }, { "name": "shift-enter" }]
-        },
-        {
-          "name": "slotConfig",
-          "description": "An array of slot configuration items for structured input mode. Supports `text`, `input`, `select`, `tag`, `content`, and `custom` types.",
-          "values": [{ "name": "SlotConfigType[]" }]
-        },
-        {
-          "name": "skill",
-          "description": "The skill tag to display in the slot input area. Includes `value`, optional `title`, and optional `closable` configuration.",
-          "values": [{ "name": "SkillType" }]
-        },
-        {
-          "name": "footer",
-          "description": "Custom footer content or render function. Set to `false` to hide the footer.",
-          "values": [{ "name": "BaseNode" }, { "name": "NodeRender" }]
-        },
-        {
-          "name": "header",
-          "description": "Custom header content or render function. Set to `false` to hide the header.",
-          "values": [{ "name": "BaseNode" }, { "name": "NodeRender" }]
-        },
-        {
-          "name": "prefixContent",
-          "description": "Custom prefix content or render function. Set to `false` to hide the prefix.",
-          "values": [{ "name": "BaseNode" }, { "name": "NodeRender" }]
-        },
-        {
-          "name": "suffixContent",
-          "description": "Custom suffix content or render function. Set to `false` to hide the suffix (action buttons).",
-          "values": [{ "name": "BaseNode" }, { "name": "NodeRender" }]
-        },
-        {
-          "name": "allow-speech",
-          "description": "Enables speech recognition input. Set to `true` for uncontrolled mode, or pass a `ControlledSpeechConfig` object for controlled mode.",
-          "values": [{ "name": "AllowSpeech" }]
-        },
-        {
-          "name": "speech-recording",
-          "description": "Whether speech recognition is currently recording. Only applies in uncontrolled speech mode.",
-          "values": []
-        }
+        { "name": "separator", "description": "分隔符内容", "values": [] }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/sender"
+          "url": "https://shoelace.style/components/space"
         }
       ]
     },
@@ -3097,43 +3175,34 @@
       ]
     },
     {
-      "name": "sl-space",
-      "description": "Space 组件用于设置组件之间的间距。\n---\n\n\n### **Slots:**\n - _default_ - 需要添加间距的子元素。\n\n### **CSS Properties:**\n - **--gap** - 自定义间距大小。 _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - 组件的基础容器。\n- **item** - 每个子元素的包装容器。\n- **separator** - 分隔符容器。",
+      "name": "sl-sender-header",
+      "description": "A collapsible header panel for the Sender component.\n---\n\n\n### **Events:**\n - **sl-open-change** - Emitted when the open state changes. `event.detail.open` indicates the new state.\n\n### **Slots:**\n - _default_ - The panel content (children).\n- **title** - The header title content. Alternatively use the `title` attribute for plain text.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **header** - The header bar containing title and close button.\n- **title** - The title wrapper inside the header.\n- **content** - The collapsible content area.",
       "attributes": [
         {
-          "name": "orientation",
-          "description": "间距方向，vertical 为垂直方向，horizontal 为水平方向",
-          "values": [{ "name": "horizontal" }, { "name": "vertical" }]
-        },
-        {
-          "name": "size",
-          "description": "间距大小，可选 small、medium、large 或自定义数值（单位为 px）",
-          "values": [
-            { "name": "SpaceSize" },
-            { "name": "[SpaceSize, SpaceSize]" }
-          ]
+          "name": "open",
+          "description": "Whether the panel content is expanded.",
+          "values": []
         },
         {
-          "name": "align",
-          "description": "对齐方式",
-          "values": [
-            { "name": "start" },
-            { "name": "end" },
-            { "name": "center" },
-            { "name": "baseline" }
-          ]
+          "name": "closable",
+          "description": "Whether the close/toggle button is shown.",
+          "values": []
         },
         {
-          "name": "wrap",
-          "description": "是否自动换行，仅在 horizontal 方向时有效",
+          "name": "title",
+          "description": "Plain-text title. Use the `title` slot for rich content.",
           "values": []
         },
-        { "name": "separator", "description": "分隔符内容", "values": [] }
+        {
+          "name": "force-render",
+          "description": "When true, the content DOM is always rendered even when collapsed.\nUseful when you need refs to inner elements on initial mount.\nWhen false (default), content is removed from the DOM when closed.",
+          "values": []
+        }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/space"
+          "url": "https://shoelace.style/components/sender-header"
         }
       ]
     },
@@ -3148,6 +3217,53 @@
         }
       ]
     },
+    {
+      "name": "sl-split-panel",
+      "description": "Split panels display two adjacent panels, allowing the user to reposition them.\n---\n\n\n### **Events:**\n - **sl-reposition** - Emitted when the divider's position changes.\n\n### **Slots:**\n - **start** - Content to place in the start panel.\n- **end** - Content to place in the end panel.\n- **divider** - The divider. Useful for slotting in a custom icon that renders as a handle.\n\n### **CSS Properties:**\n - **--divider-width** - The width of the visible divider. _(default: 4px)_\n- **--divider-hit-area** - The invisible region around the divider where dragging can occur. This is usually wider than the divider to facilitate easier dragging. _(default: 12px)_\n- **--min** - The minimum allowed size of the primary panel. _(default: 0)_\n- **--max** - The maximum allowed size of the primary panel. _(default: 100%)_\n\n### **CSS Parts:**\n - **start** - The start panel.\n- **end** - The end panel.\n- **panel** - Targets both the start and end panels.\n- **divider** - The divider that separates the start and end panels.",
+      "attributes": [
+        {
+          "name": "position",
+          "description": "The current position of the divider from the primary panel's edge as a percentage 0-100. Defaults to 50% of the\ncontainer's initial size.",
+          "values": []
+        },
+        {
+          "name": "position-in-pixels",
+          "description": "The current position of the divider from the primary panel's edge in pixels.",
+          "values": []
+        },
+        {
+          "name": "vertical",
+          "description": "Draws the split panel in a vertical orientation with the start and end panels stacked.",
+          "values": []
+        },
+        {
+          "name": "disabled",
+          "description": "Disables resizing. Note that the position may still change as a result of resizing the host element.",
+          "values": []
+        },
+        {
+          "name": "primary",
+          "description": "If no primary panel is designated, both panels will resize proportionally when the host element is resized. If a\nprimary panel is designated, it will maintain its size and the other panel will grow or shrink as needed when the\nhost element is resized.",
+          "values": [{ "name": "start" }, { "name": "end" }]
+        },
+        {
+          "name": "snap",
+          "description": "Either one or more space-separated values at which the divider should snap, in pixels, percentages, or repeat expressions e.g. `'100px 50% 500px' or `repeat(50%) 10px`,\nor a function which takes in a `SnapFunctionParams`, and returns a position to snap to, e.g. `({ pos }) => Math.round(pos / 8) * 8`.",
+          "values": [{ "name": "SnapFunction" }]
+        },
+        {
+          "name": "snap-threshold",
+          "description": "How close the divider must be to a snap point until snapping occurs.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/split-panel"
+        }
+      ]
+    },
     {
       "name": "sl-steps",
       "description": "\n---\n",
@@ -3180,65 +3296,38 @@
         {
           "name": "size",
           "description": "尺寸，default 或 small",
-          "values": [{ "name": "default" }, { "name": "small" }]
+          "values": [{ "name": "StepSize" }]
         },
         {
           "name": "type",
           "description": "类型",
           "values": [{ "name": "StepType" }]
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/steps"
-        }
-      ]
-    },
-    {
-      "name": "sl-split-panel",
-      "description": "Split panels display two adjacent panels, allowing the user to reposition them.\n---\n\n\n### **Events:**\n - **sl-reposition** - Emitted when the divider's position changes.\n\n### **Slots:**\n - **start** - Content to place in the start panel.\n- **end** - Content to place in the end panel.\n- **divider** - The divider. Useful for slotting in a custom icon that renders as a handle.\n\n### **CSS Properties:**\n - **--divider-width** - The width of the visible divider. _(default: 4px)_\n- **--divider-hit-area** - The invisible region around the divider where dragging can occur. This is usually wider than the divider to facilitate easier dragging. _(default: 12px)_\n- **--min** - The minimum allowed size of the primary panel. _(default: 0)_\n- **--max** - The maximum allowed size of the primary panel. _(default: 100%)_\n\n### **CSS Parts:**\n - **start** - The start panel.\n- **end** - The end panel.\n- **panel** - Targets both the start and end panels.\n- **divider** - The divider that separates the start and end panels.",
-      "attributes": [
-        {
-          "name": "position",
-          "description": "The current position of the divider from the primary panel's edge as a percentage 0-100. Defaults to 50% of the\ncontainer's initial size.",
-          "values": []
         },
         {
-          "name": "position-in-pixels",
-          "description": "The current position of the divider from the primary panel's edge in pixels.",
-          "values": []
+          "name": "variant",
+          "description": "样式变体：filled（填充）或 outlined（描边）",
+          "values": [{ "name": "StepVariant" }]
         },
         {
-          "name": "vertical",
-          "description": "Draws the split panel in a vertical orientation with the start and end panels stacked.",
-          "values": []
+          "name": "orientation",
+          "description": "方向：horizontal（水平）或 vertical（垂直）",
+          "values": [{ "name": "StepOrientation" }]
         },
         {
-          "name": "disabled",
-          "description": "Disables resizing. Note that the position may still change as a result of resizing the host element.",
+          "name": "responsive",
+          "description": "是否开启响应式（窄于 532px 自动切换为垂直模式）",
           "values": []
         },
         {
-          "name": "primary",
-          "description": "If no primary panel is designated, both panels will resize proportionally when the host element is resized. If a\nprimary panel is designated, it will maintain its size and the other panel will grow or shrink as needed when the\nhost element is resized.",
-          "values": [{ "name": "start" }, { "name": "end" }]
-        },
-        {
-          "name": "snap",
-          "description": "Either one or more space-separated values at which the divider should snap, in pixels, percentages, or repeat expressions e.g. `'100px 50% 500px' or `repeat(50%) 10px`,\nor a function which takes in a `SnapFunctionParams`, and returns a position to snap to, e.g. `({ pos }) => Math.round(pos / 8) * 8`.",
-          "values": [{ "name": "SnapFunction" }]
-        },
-        {
-          "name": "snap-threshold",
-          "description": "How close the divider must be to a snap point until snapping occurs.",
-          "values": []
+          "name": "titlePlacement",
+          "description": "标签位置：horizontal（图标右侧，默认）或 vertical（图标下方）",
+          "values": [{ "name": "StepTitlePlacement" }]
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/split-panel"
+          "url": "https://shoelace.style/components/steps"
         }
       ]
     },
@@ -3331,43 +3420,6 @@
         }
       ]
     },
-    {
-      "name": "sl-tab-group",
-      "description": "Tab groups organize content into a container that shows one section at a time.\n---\n\n\n### **Events:**\n - **sl-tab-show** - Emitted when a tab is shown.\n- **sl-tab-hide** - Emitted when a tab is hidden.\n\n### **Methods:**\n - **show(panel: _string_)** - Shows the specified tab panel.\n\n### **Slots:**\n - _default_ - Used for grouping tab panels in the tab group. Must be `<sl-tab-panel>` elements.\n- **nav** - Used for grouping tabs in the tab group. Must be `<sl-tab>` elements.\n\n### **CSS Properties:**\n - **--indicator-color** - The color of the active tab indicator. _(default: undefined)_\n- **--track-color** - The color of the indicator's track (the line that separates tabs from panels). _(default: undefined)_\n- **--track-width** - The width of the indicator's track (the line that separates tabs from panels). _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **nav** - The tab group's navigation container where tabs are slotted in.\n- **tabs** - The container that wraps the tabs.\n- **active-tab-indicator** - The line that highlights the currently selected tab.\n- **body** - The tab group's body where tab panels are slotted in.\n- **scroll-button** - The previous/next scroll buttons that show when tabs are scrollable, an `<sl-icon-button>`.\n- **scroll-button--start** - The starting scroll button.\n- **scroll-button--end** - The ending scroll button.\n- **scroll-button__base** - The scroll button's exported `base` part.",
-      "attributes": [
-        {
-          "name": "placement",
-          "description": "The placement of the tabs.",
-          "values": [
-            { "name": "top" },
-            { "name": "bottom" },
-            { "name": "start" },
-            { "name": "end" }
-          ]
-        },
-        {
-          "name": "activation",
-          "description": "When set to auto, navigating tabs with the arrow keys will instantly show the corresponding tab panel. When set to\nmanual, the tab will receive focus but will not show until the user presses spacebar or enter.",
-          "values": [{ "name": "auto" }, { "name": "manual" }]
-        },
-        {
-          "name": "no-scroll-controls",
-          "description": "Disables the scroll arrows that appear when tabs overflow.",
-          "values": []
-        },
-        {
-          "name": "fixed-scroll-controls",
-          "description": "Prevent scroll buttons from being hidden when inactive.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/tab-group"
-        }
-      ]
-    },
     {
       "name": "sl-tab-panel",
       "description": "Tab panels are used inside [tab groups](/components/tab-group) to display tabbed content.\n---\n\n\n### **Slots:**\n - _default_ - The tab panel's content.\n\n### **CSS Properties:**\n - **--padding** - The tab panel's padding. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -3391,45 +3443,39 @@
       ]
     },
     {
-      "name": "sl-tag",
-      "description": "Tags are used as labels to organize things or to indicate a selection.\n---\n\n\n### **Events:**\n - **sl-remove** - Emitted when the remove button is activated.\n\n### **Slots:**\n - _default_ - The tag's content.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **content** - The tag's content.\n- **remove-button** - The tag's remove button, an `<sl-icon-button>`.\n- **remove-button__base** - The remove button's exported `base` part.",
+      "name": "sl-tab-group",
+      "description": "Tab groups organize content into a container that shows one section at a time.\n---\n\n\n### **Events:**\n - **sl-tab-show** - Emitted when a tab is shown.\n- **sl-tab-hide** - Emitted when a tab is hidden.\n\n### **Methods:**\n - **show(panel: _string_)** - Shows the specified tab panel.\n\n### **Slots:**\n - _default_ - Used for grouping tab panels in the tab group. Must be `<sl-tab-panel>` elements.\n- **nav** - Used for grouping tabs in the tab group. Must be `<sl-tab>` elements.\n\n### **CSS Properties:**\n - **--indicator-color** - The color of the active tab indicator. _(default: undefined)_\n- **--track-color** - The color of the indicator's track (the line that separates tabs from panels). _(default: undefined)_\n- **--track-width** - The width of the indicator's track (the line that separates tabs from panels). _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **nav** - The tab group's navigation container where tabs are slotted in.\n- **tabs** - The container that wraps the tabs.\n- **active-tab-indicator** - The line that highlights the currently selected tab.\n- **body** - The tab group's body where tab panels are slotted in.\n- **scroll-button** - The previous/next scroll buttons that show when tabs are scrollable, an `<sl-icon-button>`.\n- **scroll-button--start** - The starting scroll button.\n- **scroll-button--end** - The ending scroll button.\n- **scroll-button__base** - The scroll button's exported `base` part.",
       "attributes": [
         {
-          "name": "variant",
-          "description": "The tag's theme variant.",
+          "name": "placement",
+          "description": "The placement of the tabs.",
           "values": [
-            { "name": "primary" },
-            { "name": "success" },
-            { "name": "neutral" },
-            { "name": "warning" },
-            { "name": "danger" },
-            { "name": "text" }
+            { "name": "top" },
+            { "name": "bottom" },
+            { "name": "start" },
+            { "name": "end" }
           ]
         },
         {
-          "name": "size",
-          "description": "The tag's size.",
-          "values": [
-            { "name": "small" },
-            { "name": "medium" },
-            { "name": "large" }
-          ]
+          "name": "activation",
+          "description": "When set to auto, navigating tabs with the arrow keys will instantly show the corresponding tab panel. When set to\nmanual, the tab will receive focus but will not show until the user presses spacebar or enter.",
+          "values": [{ "name": "auto" }, { "name": "manual" }]
         },
         {
-          "name": "pill",
-          "description": "Draws a pill-style tag with rounded edges.",
+          "name": "no-scroll-controls",
+          "description": "Disables the scroll arrows that appear when tabs overflow.",
           "values": []
         },
         {
-          "name": "removable",
-          "description": "Makes the tag removable and shows a remove button.",
+          "name": "fixed-scroll-controls",
+          "description": "Prevent scroll buttons from being hidden when inactive.",
           "values": []
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/tag"
+          "url": "https://shoelace.style/components/tab-group"
         }
       ]
     },
@@ -3524,43 +3570,6 @@
         }
       ]
     },
-    {
-      "name": "sl-think",
-      "description": "Think is used to display an AI model's thinking process with expandable/collapsible content.\n---\n\n\n### **Events:**\n - **sl-expand** - Emitted when the think block starts expanding (before animation). Equivalent to React's `onExpand(true)`.\n- **sl-collapse** - Emitted when the think block starts collapsing (before animation). Equivalent to React's `onExpand(false)`.\n\n### **Methods:**\n - **handleExpandedChange()** - Runs AFTER the first render whenever `expanded` changes.\nEmits the appropriate event immediately (matching React's `onExpand` timing,\nwhich fires before the animation), then plays the expand/collapse animation.\n\n### **Slots:**\n - _default_ - The thinking content body.\n- **title** - Rich HTML content for the status bar title. Overrides the `title` attribute.\n- **icon** - A custom icon displayed in the status bar when not loading. Defaults to the Think icon.\n- **loading-icon** - A custom icon displayed when `loading` is true. Overrides the default spinner. This is the web-component equivalent of passing a ReactNode to the React `loading` prop.\n\n### **CSS Properties:**\n - **--sl-c-think-TitleTextBlink-color-default** - Base text color shown during the blink/shimmer animation. Equivalent to React's `colorTextBlinkDefault` (`colorTextDescription`) design token. Defaults to `var(--sl-color-neutral-600)`. _(default: undefined)_\n- **--sl-c-think-TitleTextBlink-color** - Highlight (shine) color of the blink shimmer beam. Equivalent to React's `colorTextBlink` (`colorTextBase`) design token. Defaults to `var(--sl-color-neutral-900)`. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper (maps to React's `root` semantic DOM).\n- **status** - The clickable status bar: icon + title + chevron (maps to React's `status` semantic DOM).\n- **status-icon** - The icon container within the status bar.\n- **status-text** - The title text area within the status bar.\n- **chevron** - The expand/collapse chevron indicator.\n- **body** - The collapsible body container.\n- **content** - The content area inside the body (maps to React's `content` semantic DOM).",
-      "attributes": [
-        {
-          "name": "title",
-          "description": "The title text shown in the status bar. Accepts plain text.\nFor rich HTML content, use the `title` slot instead.\nMaps to React's `title: React.ReactNode` prop.",
-          "values": []
-        },
-        {
-          "name": "loading",
-          "description": "When true, the status icon is replaced by a loading spinner\n(or the content of the `loading-icon` slot for a custom indicator).\nMaps to React's `loading: boolean | React.ReactNode` prop:\n  - `loading` (boolean) → boolean attribute\n  - `loading` (ReactNode) → use the `loading-icon` slot",
-          "values": []
-        },
-        {
-          "name": "expanded",
-          "description": "Whether the content body is expanded.\nWhen used without `default-expanded`, this acts as a controlled prop\n(the parent is responsible for updating it).\nWhen neither this nor `default-expanded` is set on the element,\nthe component defaults to expanded (equivalent to React's `defaultExpanded = true`).\nMaps to React's `expanded: boolean` prop.",
-          "values": []
-        },
-        {
-          "name": "default-expanded",
-          "description": "The initial expanded state when the component is first rendered.\nOnly applies if `expanded` is not set as an attribute on the element.\nMaps to React's `defaultExpanded: boolean` prop (default: `true`).\n\nBecause Lit's `type: Boolean` treats attribute *presence* as `true`,\nsetting `default-expanded=\"false\"` in HTML does NOT work — this is\nconsistent with all other Shoelace boolean attributes.\nTo start collapsed, set the property via JS: `el.defaultExpanded = false`.",
-          "values": []
-        },
-        {
-          "name": "blink",
-          "description": "When true, applies a blinking animation to the title text to signal ongoing activity.\nMaps to React's `blink: boolean` prop.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/think"
-        }
-      ]
-    },
     {
       "name": "sl-textarea",
       "description": "Textareas collect data from the user and allow multiple lines of text.\n---\n\n\n### **Events:**\n - **sl-blur** - Emitted when the control loses focus.\n- **sl-change** - Emitted when an alteration to the control's value is committed by the user.\n- **sl-focus** - Emitted when the control gains focus.\n- **sl-input** - Emitted when the control receives input.\n- **sl-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the textarea.\n- **blur()** - Removes focus from the textarea.\n- **select()** - Selects all the text in the textarea.\n- **scrollPosition(position: _{ top?: number; left?: number }_): _{ top: number; left: number } | undefined_** - Gets or sets the textarea's scroll position.\n- **setSelectionRange(selectionStart: _number_, selectionEnd: _number_, selectionDirection: _'forward' | 'backward' | 'none'_)** - Sets the start and end positions of the text selection (0-based).\n- **setRangeText(replacement: _string_, start: _number_, end: _number_, selectMode: _'select' | 'start' | 'end' | 'preserve'_)** - Replaces a range of text with a new string.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - **label** - The textarea's label. Alternatively, you can use the `label` attribute.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The input's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **base** - The component's base wrapper.\n- **textarea** - The internal `<textarea>` control.",
@@ -3690,29 +3699,66 @@
           ]
         },
         {
-          "name": "spellcheck",
-          "description": "Enables spell checking on the textarea.",
+          "name": "spellcheck",
+          "description": "Enables spell checking on the textarea.",
+          "values": []
+        },
+        {
+          "name": "inputmode",
+          "description": "Tells the browser what type of data will be entered by the user, allowing it to display the appropriate virtual\nkeyboard on supportive devices.",
+          "values": [
+            { "name": "none" },
+            { "name": "text" },
+            { "name": "decimal" },
+            { "name": "numeric" },
+            { "name": "tel" },
+            { "name": "search" },
+            { "name": "email" },
+            { "name": "url" }
+          ]
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/textarea"
+        }
+      ]
+    },
+    {
+      "name": "sl-think",
+      "description": "Think is used to display an AI model's thinking process with expandable/collapsible content.\n---\n\n\n### **Events:**\n - **sl-expand** - Emitted when the think block starts expanding (before animation). Equivalent to React's `onExpand(true)`.\n- **sl-collapse** - Emitted when the think block starts collapsing (before animation). Equivalent to React's `onExpand(false)`.\n\n### **Methods:**\n - **handleExpandedChange()** - Runs AFTER the first render whenever `expanded` changes.\nEmits the appropriate event immediately (matching React's `onExpand` timing,\nwhich fires before the animation), then plays the expand/collapse animation.\n\n### **Slots:**\n - _default_ - The thinking content body.\n- **title** - Rich HTML content for the status bar title. Overrides the `title` attribute.\n- **icon** - A custom icon displayed in the status bar when not loading. Defaults to the Think icon.\n- **loading-icon** - A custom icon displayed when `loading` is true. Overrides the default spinner. This is the web-component equivalent of passing a ReactNode to the React `loading` prop.\n\n### **CSS Properties:**\n - **--sl-c-think-TitleTextBlink-color-default** - Base text color shown during the blink/shimmer animation. Equivalent to React's `colorTextBlinkDefault` (`colorTextDescription`) design token. Defaults to `var(--sl-color-neutral-600)`. _(default: undefined)_\n- **--sl-c-think-TitleTextBlink-color** - Highlight (shine) color of the blink shimmer beam. Equivalent to React's `colorTextBlink` (`colorTextBase`) design token. Defaults to `var(--sl-color-neutral-900)`. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper (maps to React's `root` semantic DOM).\n- **status** - The clickable status bar: icon + title + chevron (maps to React's `status` semantic DOM).\n- **status-icon** - The icon container within the status bar.\n- **status-text** - The title text area within the status bar.\n- **chevron** - The expand/collapse chevron indicator.\n- **body** - The collapsible body container.\n- **content** - The content area inside the body (maps to React's `content` semantic DOM).",
+      "attributes": [
+        {
+          "name": "title",
+          "description": "The title text shown in the status bar. Accepts plain text.\nFor rich HTML content, use the `title` slot instead.\nMaps to React's `title: React.ReactNode` prop.",
+          "values": []
+        },
+        {
+          "name": "loading",
+          "description": "When true, the status icon is replaced by a loading spinner\n(or the content of the `loading-icon` slot for a custom indicator).\nMaps to React's `loading: boolean | React.ReactNode` prop:\n  - `loading` (boolean) → boolean attribute\n  - `loading` (ReactNode) → use the `loading-icon` slot",
+          "values": []
+        },
+        {
+          "name": "expanded",
+          "description": "Whether the content body is expanded.\nWhen used without `default-expanded`, this acts as a controlled prop\n(the parent is responsible for updating it).\nWhen neither this nor `default-expanded` is set on the element,\nthe component defaults to expanded (equivalent to React's `defaultExpanded = true`).\nMaps to React's `expanded: boolean` prop.",
           "values": []
         },
         {
-          "name": "inputmode",
-          "description": "Tells the browser what type of data will be entered by the user, allowing it to display the appropriate virtual\nkeyboard on supportive devices.",
-          "values": [
-            { "name": "none" },
-            { "name": "text" },
-            { "name": "decimal" },
-            { "name": "numeric" },
-            { "name": "tel" },
-            { "name": "search" },
-            { "name": "email" },
-            { "name": "url" }
-          ]
+          "name": "default-expanded",
+          "description": "The initial expanded state when the component is first rendered.\nOnly applies if `expanded` is not set as an attribute on the element.\nMaps to React's `defaultExpanded: boolean` prop (default: `true`).\n\nBecause Lit's `type: Boolean` treats attribute *presence* as `true`,\nsetting `default-expanded=\"false\"` in HTML does NOT work — this is\nconsistent with all other Shoelace boolean attributes.\nTo start collapsed, set the property via JS: `el.defaultExpanded = false`.",
+          "values": []
+        },
+        {
+          "name": "blink",
+          "description": "When true, applies a blinking animation to the title text to signal ongoing activity.\nMaps to React's `blink: boolean` prop.",
+          "values": []
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/textarea"
+          "url": "https://shoelace.style/components/think"
         }
       ]
     },
@@ -3842,6 +3888,49 @@
         }
       ]
     },
+    {
+      "name": "sl-tag",
+      "description": "Tags are used as labels to organize things or to indicate a selection.\n---\n\n\n### **Events:**\n - **sl-remove** - Emitted when the remove button is activated.\n\n### **Slots:**\n - _default_ - The tag's content.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **content** - The tag's content.\n- **remove-button** - The tag's remove button, an `<sl-icon-button>`.\n- **remove-button__base** - The remove button's exported `base` part.",
+      "attributes": [
+        {
+          "name": "variant",
+          "description": "The tag's theme variant.",
+          "values": [
+            { "name": "primary" },
+            { "name": "success" },
+            { "name": "neutral" },
+            { "name": "warning" },
+            { "name": "danger" },
+            { "name": "text" }
+          ]
+        },
+        {
+          "name": "size",
+          "description": "The tag's size.",
+          "values": [
+            { "name": "small" },
+            { "name": "medium" },
+            { "name": "large" }
+          ]
+        },
+        {
+          "name": "pill",
+          "description": "Draws a pill-style tag with rounded edges.",
+          "values": []
+        },
+        {
+          "name": "removable",
+          "description": "Makes the tag removable and shows a remove button.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/tag"
+        }
+      ]
+    },
     {
       "name": "sl-timepicker",
       "description": "A time picker component that provides a time selection interface.\n---\n\n\n### **Events:**\n - **sl-change** - Emitted when the control's value changes.\n- **sl-input** - Emitted when the control's value changes.\n- **sl-focus** - Emitted when the control gains focus.\n- **sl-blur** - Emitted when the control loses focus.\n- **sl-clear** - Emitted when the clear button is activated.\n- **sl-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Slots:**\n - **label** - The input's label. Alternatively, you can use the `label` attribute.\n- **prefix** - The input's prefix, to prepend to the input.\n- **suffix** - The input's suffix, to append to the input.\n- **clear-icon** - An icon to use in lieu of the default clear icon.\n- **help-text** - Help text that describes the input. Alternatively, you can use the `help-text` attribute.",
@@ -3934,44 +4023,17 @@
             { "name": "multiple" },
             { "name": "leaf" }
           ]
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/tree"
-        }
-      ]
-    },
-    {
-      "name": "sl-tree-item",
-      "description": "A tree item serves as a hierarchical node that lives inside a [tree](/components/tree).\n---\n\n\n### **Events:**\n - **sl-expand** - Emitted when the tree item expands.\n- **sl-after-expand** - Emitted after the tree item expands and all animations are complete.\n- **sl-collapse** - Emitted when the tree item collapses.\n- **sl-after-collapse** - Emitted after the tree item collapses and all animations are complete.\n- **sl-lazy-change** - Emitted when the tree item's lazy state changes.\n- **sl-lazy-load** - Emitted when a lazy item is selected. Use this event to asynchronously load data and append items to the tree before expanding. After appending new items, remove the `lazy` attribute to remove the loading state and update the tree.\n\n### **Methods:**\n - **getChildrenItems({ includeDisabled = true }: _{ includeDisabled?: boolean }_): _SlTreeItem[]_** - Gets all the nested tree items in this node.\n\n### **Slots:**\n - _default_ - The default slot.\n- **expand-icon** - The icon to show when the tree item is expanded.\n- **collapse-icon** - The icon to show when the tree item is collapsed.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **item** - The tree item's container. This element wraps everything except slotted tree item children.\n- **item--disabled** - Applied when the tree item is disabled.\n- **item--expanded** - Applied when the tree item is expanded.\n- **item--indeterminate** - Applied when the selection is indeterminate.\n- **item--selected** - Applied when the tree item is selected.\n- **indentation** - The tree item's indentation container.\n- **expand-button** - The container that wraps the tree item's expand button and spinner.\n- **spinner** - The spinner that shows when a lazy tree item is in the loading state.\n- **spinner__base** - The spinner's base part.\n- **label** - The tree item's label.\n- **children** - The container that wraps the tree item's nested children.\n- **checkbox** - The checkbox that shows when using multiselect.\n- **checkbox__base** - The checkbox's exported `base` part.\n- **checkbox__control** - The checkbox's exported `control` part.\n- **checkbox__control--checked** - The checkbox's exported `control--checked` part.\n- **checkbox__control--indeterminate** - The checkbox's exported `control--indeterminate` part.\n- **checkbox__checked-icon** - The checkbox's exported `checked-icon` part.\n- **checkbox__indeterminate-icon** - The checkbox's exported `indeterminate-icon` part.\n- **checkbox__label** - The checkbox's exported `label` part.",
-      "attributes": [
-        {
-          "name": "expanded",
-          "description": "Expands the tree item.",
-          "values": []
-        },
-        {
-          "name": "selected",
-          "description": "Draws the tree item in a selected state.",
-          "values": []
-        },
-        {
-          "name": "disabled",
-          "description": "Disables the tree item.",
-          "values": []
         },
         {
-          "name": "lazy",
-          "description": "Enables lazy loading behavior.",
+          "name": "show-line",
+          "description": "Whether to show connecting lines between tree nodes.",
           "values": []
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/tree-item"
+          "url": "https://shoelace.style/components/tree"
         }
       ]
     },
@@ -4022,6 +4084,192 @@
           "url": "https://shoelace.style/components/x-markdown"
         }
       ]
+    },
+    {
+      "name": "sl-tree-select",
+      "description": "TreeSelect combines a dropdown trigger with a tree structure, allowing users to select from hierarchical data.\n---\n\n\n### **Events:**\n - **sl-change** - Emitted when the control's value changes.\n- **sl-clear** - Emitted when the control's value is cleared.\n- **sl-input** - Emitted when the control receives input.\n- **sl-focus** - Emitted when the control gains focus.\n- **sl-blur** - Emitted when the control loses focus.\n- **sl-show** - Emitted when the dropdown opens.\n- **sl-after-show** - Emitted after the dropdown opens and all animations are complete.\n- **sl-hide** - Emitted when the dropdown closes.\n- **sl-after-hide** - Emitted after the dropdown closes and all animations are complete.\n- **sl-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n- **sl-search** - Emitted when the search value changes.\n- **sl-lazy-load** - Emitted when a lazy node is expanded and its children need to be loaded.\n\n### **Methods:**\n - **loadChildren(parentValue: _string_, children: _TreeSelectNodeData[]_)** - Load children for a lazy node. Call this from your `sl-lazy-load` event handler.\nIt updates the node's children in `treeData`, removes `lazy`, and expands the node.\n\n### **Slots:**\n - **label** - The input's label. Alternatively, you can use the `label` attribute.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n- **prefix** - Used to prepend a presentational icon or similar element to the combobox.\n- **suffix** - Used to append a presentational icon or similar element to the combobox.\n- **clear-icon** - An icon to use in lieu of the default clear icon.\n- **expand-icon** - The icon to show when the control is expanded and collapsed.\n- **tree-expand-icon** - The icon to show when a tree node is collapsed (click to expand). Forwarded to the tree's `expand-icon` slot.\n- **tree-collapse-icon** - The icon to show when a tree node is expanded (click to collapse). Forwarded to the tree's `collapse-icon` slot.\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The select's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **combobox** - The container that wraps the prefix, combobox, clear icon, and expand button.\n- **prefix** - The container that wraps the prefix slot.\n- **suffix** - The container that wraps the suffix slot.\n- **display-input** - The element that displays the selected option's label.\n- **tags** - The container that houses option tags when `multiple` is used.\n- **tag** - The individual tags that represent each selected option.\n- **clear-button** - The clear button.\n- **expand-icon** - The container that wraps the expand icon.\n- **dropdown** - The dropdown panel that contains the tree.\n- **tree** - The tree element inside the dropdown.",
+      "attributes": [
+        {
+          "name": "name",
+          "description": "The name of the control, submitted as a name/value pair with form data.",
+          "values": []
+        },
+        {
+          "name": "value",
+          "description": "The default value of the form control. Primarily used for resetting the form control.",
+          "values": [{ "name": "string[]" }]
+        },
+        {
+          "name": "size",
+          "description": "The select's size.",
+          "values": [
+            { "name": "small" },
+            { "name": "medium" },
+            { "name": "large" }
+          ]
+        },
+        {
+          "name": "placeholder",
+          "description": "Placeholder text to show as a hint when the select is empty.",
+          "values": []
+        },
+        {
+          "name": "multiple",
+          "description": "Allows more than one node to be selected. Renders checkboxes in the tree.",
+          "values": []
+        },
+        {
+          "name": "max-options-visible",
+          "description": "The maximum number of selected options to show when `multiple` is true.\nAfter the maximum, \"+n\" will be shown. Set to 0 to remove the limit.",
+          "values": []
+        },
+        {
+          "name": "disabled",
+          "description": "Disables the control.",
+          "values": []
+        },
+        {
+          "name": "clearable",
+          "description": "Adds a clear button when the input is not empty.",
+          "values": []
+        },
+        {
+          "name": "open",
+          "description": "Indicates whether or not the dropdown is open. You can toggle this attribute to show and hide the dropdown,\nor you can use the `show()` and `hide()` methods.",
+          "values": []
+        },
+        {
+          "name": "hoist",
+          "description": "Enable the use of `hoist` to position the dropdown panel using a fixed strategy,\nallowing it to break out of containers that have `overflow: hidden`.",
+          "values": []
+        },
+        {
+          "name": "filled",
+          "description": "Draws a filled select.",
+          "values": []
+        },
+        {
+          "name": "pill",
+          "description": "Draws a pill-style select with rounded edges.",
+          "values": []
+        },
+        {
+          "name": "label",
+          "description": "The input's label. If you need to display HTML, use the `label` slot instead.",
+          "values": []
+        },
+        {
+          "name": "placement",
+          "description": "The preferred placement of the dropdown panel. Note that the actual placement may vary\nto keep the panel inside of the viewport.",
+          "values": [
+            { "name": "" },
+            { "name": "top" },
+            { "name": "top-start" },
+            { "name": "top-end" },
+            { "name": "bottom" },
+            { "name": "bottom-start" },
+            { "name": "bottom-end" },
+            { "name": "right" },
+            { "name": "right-start" },
+            { "name": "right-end" },
+            { "name": "left" },
+            { "name": "left-start" },
+            { "name": "left-end" }
+          ]
+        },
+        {
+          "name": "help-text",
+          "description": "The input's help text.",
+          "values": []
+        },
+        {
+          "name": "required",
+          "description": "The input's required attribute.",
+          "values": []
+        },
+        {
+          "name": "form",
+          "description": "The associated form element.",
+          "values": []
+        },
+        {
+          "name": "show-search",
+          "description": "Whether to enable search in the combobox input. Can be a boolean or a config object.\nWhen `true`, enables search with default settings.\nWhen an object, enables search with the specified configuration:\n- `autoClearSearchValue`: auto clear search after selection (default: true)\n- `filterTreeNode`: filter function or boolean (default: true)\n- `searchValue`: controlled search value\n- `treeNodeFilterProp`: which node property to filter on (default: 'value')",
+          "values": [{ "name": "ShowSearchConfig" }]
+        },
+        {
+          "name": "tree-default-expand-all",
+          "description": "Whether parent nodes are selectable when `multiple` is false. Defaults to true.",
+          "values": []
+        },
+        {
+          "name": "tree-checkable",
+          "description": "Whether to check children when parent is checked (only for multiple mode).",
+          "values": []
+        },
+        {
+          "name": "show-checked-strategy",
+          "description": "Strategy for showing checked nodes: 'all' | 'parent' | 'child'. Defaults to 'all'.",
+          "values": [
+            { "name": "all" },
+            { "name": "parent" },
+            { "name": "child" }
+          ]
+        },
+        {
+          "name": "tree-line",
+          "description": "Whether to show connecting lines between parent nodes in the tree. Leaf nodes are excluded.",
+          "values": []
+        },
+        {
+          "name": "getTag",
+          "description": "A function that generates a custom tag for each selected option in multiple mode.\nThe function receives the node data and index, and should return a TemplateResult, string, or HTMLElement.",
+          "values": [
+            {
+              "name": "(node: TreeSelectNodeData, index: number) => TemplateResult"
+            },
+            { "name": "HTMLElement" }
+          ]
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/tree-select"
+        }
+      ]
+    },
+    {
+      "name": "sl-tree-item",
+      "description": "A tree item serves as a hierarchical node that lives inside a [tree](/components/tree).\n---\n\n\n### **Events:**\n - **sl-expand** - Emitted when the tree item expands.\n- **sl-after-expand** - Emitted after the tree item expands and all animations are complete.\n- **sl-collapse** - Emitted when the tree item collapses.\n- **sl-after-collapse** - Emitted after the tree item collapses and all animations are complete.\n- **sl-lazy-change** - Emitted when the tree item's lazy state changes.\n- **sl-lazy-load** - Emitted when a lazy item is selected. Use this event to asynchronously load data and append items to the tree before expanding. After appending new items, remove the `lazy` attribute to remove the loading state and update the tree.\n\n### **Methods:**\n - **getChildrenItems({ includeDisabled = true }: _{ includeDisabled?: boolean }_): _SlTreeItem[]_** - Gets all the nested tree items in this node.\n\n### **Slots:**\n - _default_ - The default slot.\n- **expand-icon** - The icon to show when the tree item is expanded.\n- **collapse-icon** - The icon to show when the tree item is collapsed.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **item** - The tree item's container. This element wraps everything except slotted tree item children.\n- **item--disabled** - Applied when the tree item is disabled.\n- **item--expanded** - Applied when the tree item is expanded.\n- **item--indeterminate** - Applied when the selection is indeterminate.\n- **item--selected** - Applied when the tree item is selected.\n- **indentation** - The tree item's indentation container.\n- **expand-button** - The container that wraps the tree item's expand button and spinner.\n- **spinner** - The spinner that shows when a lazy tree item is in the loading state.\n- **spinner__base** - The spinner's base part.\n- **label** - The tree item's label.\n- **children** - The container that wraps the tree item's nested children.\n- **checkbox** - The checkbox that shows when using multiselect.\n- **checkbox__base** - The checkbox's exported `base` part.\n- **checkbox__control** - The checkbox's exported `control` part.\n- **checkbox__control--checked** - The checkbox's exported `control--checked` part.\n- **checkbox__control--indeterminate** - The checkbox's exported `control--indeterminate` part.\n- **checkbox__checked-icon** - The checkbox's exported `checked-icon` part.\n- **checkbox__indeterminate-icon** - The checkbox's exported `indeterminate-icon` part.\n- **checkbox__label** - The checkbox's exported `label` part.",
+      "attributes": [
+        {
+          "name": "expanded",
+          "description": "Expands the tree item.",
+          "values": []
+        },
+        {
+          "name": "selected",
+          "description": "Draws the tree item in a selected state.",
+          "values": []
+        },
+        {
+          "name": "disabled",
+          "description": "Disables the tree item.",
+          "values": []
+        },
+        {
+          "name": "lazy",
+          "description": "Enables lazy loading behavior.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/tree-item"
+        }
+      ]
     }
   ]
 }