@kdcloudjs/shoelace 1.0.48 → 1.0.49

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

@@ -2,6 +2,33 @@
   "$schema": "https://raw.githubusercontent.com/microsoft/vscode-html-languageservice/main/docs/customData.schema.json",
   "version": 1.1,
   "tags": [
+    {
+      "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-alert",
       "description": "Alerts are used to display important messages inline or as toast notifications.\n---\n\n\n### **Events:**\n - **sl-show** - Emitted when the alert opens.\n- **sl-after-show** - Emitted after the alert opens and all animations are complete.\n- **sl-hide** - Emitted when the alert closes.\n- **sl-after-hide** - Emitted after the alert closes and all animations are complete.\n\n### **Methods:**\n - **show()** - Shows the alert.\n- **hide()** - Hides the alert\n- **toast()** - Displays the alert as a toast notification. This will move the alert out of its position in the DOM and, when\ndismissed, it will be removed from the DOM completely. By storing a reference to the alert, you can reuse it by\ncalling this method again. The returned promise will resolve after the alert is hidden.\n\n### **Slots:**\n - _default_ - The alert's main content.\n- **icon** - An icon to show in the alert. Works best with `<sl-icon>`.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **icon** - The container that wraps the optional icon.\n- **message** - The container that wraps the alert's main content.\n- **close-button** - The close button, an `<sl-icon-button>`.\n- **close-button__base** - The close button's exported `base` part.",
@@ -46,29 +73,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.",
+      "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": "src",
-          "description": "The path to the image to load.",
+          "name": "image",
+          "description": "The image source to use for the avatar.",
           "values": []
         },
         {
-          "name": "alt",
-          "description": "A description of the image used by assistive devices.",
+          "name": "label",
+          "description": "A label to use to describe the avatar to assistive devices.",
           "values": []
         },
         {
-          "name": "play",
-          "description": "Plays the animation. When this attribute is remove, the animation will pause.",
+          "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/animated-image"
+          "url": "https://shoelace.style/components/avatar"
         }
       ]
     },
@@ -140,76 +181,19 @@
       ]
     },
     {
-      "name": "sl-badge",
-      "description": "Badges are used to draw attention and display statuses or counts.\n---\n\n\n### **Slots:**\n - _default_ - The badge's content.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
-      "attributes": [
-        {
-          "name": "variant",
-          "description": "The badge's theme variant.",
-          "values": [
-            { "name": "primary" },
-            { "name": "success" },
-            { "name": "neutral" },
-            { "name": "warning" },
-            { "name": "danger" }
-          ]
-        },
-        {
-          "name": "pill",
-          "description": "Draws a pill-style badge with rounded edges.",
-          "values": []
-        },
-        {
-          "name": "pulse",
-          "description": "Makes the badge pulsate to draw attention.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/badge"
-        }
-      ]
-    },
-    {
-      "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.",
+      "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.",
       "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).",
+          "description": "The label to use for the breadcrumb control. This will not be shown on the screen, but it will be announced by\nscreen readers and other assistive devices to provide more context for users.",
           "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"
+          "url": "https://shoelace.style/components/breadcrumb"
         }
       ]
     },
@@ -246,36 +230,35 @@
       ]
     },
     {
-      "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.",
+      "name": "sl-badge",
+      "description": "Badges are used to draw attention and display statuses or counts.\n---\n\n\n### **Slots:**\n - _default_ - The badge's content.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
       "attributes": [
         {
-          "name": "label",
-          "description": "The label to use for the breadcrumb control. This will not be shown on the screen, but it will be announced by\nscreen readers and other assistive devices to provide more context for users.",
-          "values": []
-        }
-      ],
-      "references": [
+          "name": "variant",
+          "description": "The badge's theme variant.",
+          "values": [
+            { "name": "primary" },
+            { "name": "success" },
+            { "name": "neutral" },
+            { "name": "warning" },
+            { "name": "danger" }
+          ]
+        },
         {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/breadcrumb"
-        }
-      ]
-    },
-    {
-      "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": "pill",
+          "description": "Draws a pill-style badge with rounded edges.",
+          "values": []
+        },
         {
-          "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.",
+          "name": "pulse",
+          "description": "Makes the badge pulsate to draw attention.",
           "values": []
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/button-group"
+          "url": "https://shoelace.style/components/badge"
         }
       ]
     },
@@ -427,6 +410,23 @@
         }
       ]
     },
+    {
+      "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-calendar",
       "description": "日历组件，用于按日历形式展示数据，支持全屏和卡片模式\n---\n\n\n### **Events:**\n - **sl-panel-change** - 当面板切换时触发\n- **sl-calendar-change** - 当日期发生变化时触发\n- **sl-calendar-select** - 当日期被选中时触发，包含来源信息\n\n### **CSS Properties:**\n - **--sl-calendar-item-active-bg** - Background color of selected date _(default: undefined)_\n- **--sl-calendar-full-bg** - Background color of full calendar _(default: undefined)_\n- **--sl-calendar-full-panel-bg** - Background color of calendar panel _(default: undefined)_\n- **--sl-calendar-mini-content-height** - Height of mini calendar content _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **header** - The calendar header.\n- **header-left** - The header left section (year/month selects).\n- **header-right** - The header right section (mode switch).\n- **body** - The calendar body.\n- **table** - The calendar table.\n- **cell** - Individual calendar cells.\n- **cell-inner** - Inner content of calendar cells.\n- **date-value** - The date number display.\n- **date-content** - The custom content area in cells.",
@@ -661,6 +661,68 @@
         }
       ]
     },
+    {
+      "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-col",
       "description": "Col component for grid layout system.\n---\n\n\n### **Slots:**\n - _default_ - The default slot for content.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -734,79 +796,17 @@
       ]
     },
     {
-      "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.",
+      "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.",
       "attributes": [
-        { "name": "title", "values": [] },
         {
-          "name": "name",
-          "description": "The name of the checkbox, submitted as a name/value pair with form data.",
+          "name": "value",
+          "description": "The current value of the color picker. The value's format will vary based the `format` attribute. To get the value\nin a specific format, use the `getFormattedValue()` method. The value is submitted as a name/value pair with form\ndata.",
           "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.",
-      "attributes": [
-        {
-          "name": "value",
-          "description": "The current value of the color picker. The value's format will vary based the `format` attribute. To get the value\nin a specific format, use the `getFormattedValue()` method. The value is submitted as a name/value pair with form\ndata.",
-          "values": []
-        },
-        {
-          "name": "label",
-          "description": "The color picker's label. This will not be displayed, but it will be announced by assistive devices. If you need to\ndisplay HTML, you can use the `label` slot` instead.",
+          "name": "label",
+          "description": "The color picker's label. This will not be displayed, but it will be announced by assistive devices. If you need to\ndisplay HTML, you can use the `label` slot` instead.",
           "values": []
         },
         {
@@ -948,6 +948,31 @@
         }
       ]
     },
+    {
+      "name": "sl-date-panel",
+      "description": "\n---\n\n\n### **Events:**\n - **sl-cancel**\n- **sl-clear**\n- **sl-confirm**\n- **sl-date-change**",
+      "attributes": [
+        { "name": "open", "values": [] },
+        { "name": "value", "values": [] },
+        {
+          "name": "type",
+          "values": [
+            { "name": "date" },
+            { "name": "datetime" },
+            { "name": "time" }
+          ]
+        },
+        { "name": "min", "values": [] },
+        { "name": "max", "values": [] },
+        { "name": "format", "values": [] }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/date-panel"
+        }
+      ]
+    },
     {
       "name": "sl-datepicker",
       "description": "Datepickers allow users to select a date using a calendar interface.\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- **sl-clear** - Emitted when the clear button is activated.",
@@ -1150,23 +1175,6 @@
         }
       ]
     },
-    {
-      "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)_",
-      "attributes": [
-        {
-          "name": "vertical",
-          "description": "Draws the divider in a vertical orientation.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/divider"
-        }
-      ]
-    },
     {
       "name": "sl-drawer",
       "description": "Drawers slide in from a container to expose additional options and information.\n---\n\n\n### **Events:**\n - **sl-show** - Emitted when the drawer opens.\n- **sl-after-show** - Emitted after the drawer opens and all animations are complete.\n- **sl-hide** - Emitted when the drawer closes.\n- **sl-after-hide** - Emitted after the drawer closes and all animations are complete.\n- **sl-initial-focus** - Emitted when the drawer 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 drawer by clicking the close button, clicking the overlay, or pressing escape. Calling `event.preventDefault()` will keep the drawer open. Avoid using this unless closing the drawer will result in destructive behavior such as data loss.\n\n### **Methods:**\n - **show()** - Shows the drawer.\n- **hide()** - Hides the drawer\n\n### **Slots:**\n - _default_ - The drawer's main content.\n- **label** - The drawer'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 drawer's footer, usually one or more buttons representing various options.\n\n### **CSS Properties:**\n - **--size** - The preferred size of the drawer. This will be applied to the drawer's width or height depending on its `placement`. Note that the drawer 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 drawer.\n- **panel** - The drawer's panel (where the drawer and its content are rendered).\n- **header** - The drawer'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 drawer'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 drawer's body.\n- **footer** - The drawer's footer.",
@@ -1210,27 +1218,19 @@
       ]
     },
     {
-      "name": "sl-date-panel",
-      "description": "\n---\n\n\n### **Events:**\n - **sl-cancel**\n- **sl-clear**\n- **sl-confirm**\n- **sl-date-change**",
+      "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)_",
       "attributes": [
-        { "name": "open", "values": [] },
-        { "name": "value", "values": [] },
         {
-          "name": "type",
-          "values": [
-            { "name": "date" },
-            { "name": "datetime" },
-            { "name": "time" }
-          ]
-        },
-        { "name": "min", "values": [] },
-        { "name": "max", "values": [] },
-        { "name": "format", "values": [] }
+          "name": "vertical",
+          "description": "Draws the divider in a vertical orientation.",
+          "values": []
+        }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/date-panel"
+          "url": "https://shoelace.style/components/divider"
         }
       ]
     },
@@ -1370,6 +1370,43 @@
         }
       ]
     },
+    {
+      "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",
+          "description": "Whether the menu is open (controlled mode, use with trigger).",
+          "values": []
+        },
+        {
+          "name": "placement",
+          "description": "The direction the menu items expand.",
+          "values": [
+            { "name": "top" },
+            { "name": "right" },
+            { "name": "bottom" },
+            { "name": "left" }
+          ]
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/float-button-group"
+        }
+      ]
+    },
     {
       "name": "sl-format-bytes",
       "description": "Formats a number as a human readable bytes value.\n---\n",
@@ -1487,43 +1524,6 @@
         }
       ]
     },
-    {
-      "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",
-          "description": "Whether the menu is open (controlled mode, use with trigger).",
-          "values": []
-        },
-        {
-          "name": "placement",
-          "description": "The direction the menu items expand.",
-          "values": [
-            { "name": "top" },
-            { "name": "right" },
-            { "name": "bottom" },
-            { "name": "left" }
-          ]
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/float-button-group"
-        }
-      ]
-    },
     {
       "name": "sl-format-number",
       "description": "Formats a number using the specified locale and options.\n---\n",
@@ -1595,6 +1595,38 @@
         }
       ]
     },
+    {
+      "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-icon-button",
       "description": "Icons buttons are simple, icon-only buttons that can be used for actions and in toolbars.\n---\n\n\n### **Events:**\n - **sl-blur** - Emitted when the icon button loses focus.\n- **sl-focus** - Emitted when the icon button gains focus.\n\n### **Methods:**\n - **click()** - Simulates a click on the icon button.\n- **focus(options: _FocusOptions_)** - Sets focus on the icon button.\n- **blur()** - Removes focus from the icon button.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -1653,71 +1685,83 @@
       ]
     },
     {
-      "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",
+      "description": "图片组件，支持预览、缩放、旋转、翻转等功能。\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": "name",
-          "description": "The name of the icon to draw. Available names depend on the icon library being used.",
+          "name": "fallback",
+          "description": "加载失败时的回退图片地址",
           "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.",
+          "name": "placeholder",
+          "description": "加载占位图；设为 true 显示默认占位符，设为字符串则作为占位图片 src",
           "values": []
         },
+        { "name": "no-preview", "description": "是否禁用预览", "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": "preview",
+          "description": "预览配置",
+          "values": [{ "name": "SlImagePreviewConfig" }]
         },
         {
-          "name": "library",
-          "description": "The name of a registered custom icon library.",
-          "values": []
+          "name": "in-group",
+          "description": "是否在 group 中（由 sl-image-preview-group 自动设置）",
+          "values": []
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/icon"
+          "url": "https://shoelace.style/components/image"
         }
       ]
     },
     {
-      "name": "sl-image",
-      "description": "图片组件，支持预览、缩放、旋转、翻转等功能。\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** - 预览关闭按钮",
+      "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": "src", "description": "图片地址", "values": [] },
-        { "name": "alt", "description": "图片替代文本", "values": [] },
-        { "name": "width", "description": "图片宽度", "values": [] },
-        { "name": "height", "description": "图片高度", "values": [] },
         {
-          "name": "fallback",
-          "description": "加载失败时的回退图片地址",
+          "name": "position",
+          "description": "The position of the divider as a percentage.",
           "values": []
-        },
+        }
+      ],
+      "references": [
         {
-          "name": "placeholder",
-          "description": "加载占位图；设为 true 显示默认占位符，设为字符串则作为占位图片 src",
-          "values": []
-        },
-        { "name": "no-preview", "description": "是否禁用预览", "values": [] },
+          "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": "预览配置",
-          "values": [{ "name": "SlImagePreviewConfig" }]
+          "description": "预览配置，为 false 时禁用预览",
+          "values": [{ "name": "false" }, { "name": "SlPreviewGroupConfig" }]
         },
         {
-          "name": "in-group",
-          "description": "是否在 group 中（由 sl-image-preview-group 自动设置）",
+          "name": "items",
+          "description": "预览数组，支持字符串或 { src, alt, crossOrigin } 对象",
+          "values": [{ "name": "SlPreviewGroupItem[]" }]
+        },
+        {
+          "name": "fallback",
+          "description": "加载失败容错地址（组件级）",
           "values": []
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/image"
+          "url": "https://shoelace.style/components/image-preview-group"
         }
       ]
     },
@@ -1753,29 +1797,13 @@
       ]
     },
     {
-      "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": []
-        }
-      ],
+      "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/image-preview-group"
+          "url": "https://shoelace.style/components/menu"
         }
       ]
     },
@@ -1999,19 +2027,13 @@
       ]
     },
     {
-      "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": []
-        }
-      ],
+      "name": "sl-menu-label",
+      "description": "Menu labels are used to describe a group of menu items.\n---\n\n\n### **Slots:**\n - _default_ - The menu label's content.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+      "attributes": [],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/image-comparer"
+          "url": "https://shoelace.style/components/menu-label"
         }
       ]
     },
@@ -2052,28 +2074,6 @@
         }
       ]
     },
-    {
-      "name": "sl-menu-label",
-      "description": "Menu labels are used to describe a group of menu items.\n---\n\n\n### **Slots:**\n - _default_ - The menu label's content.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
-      "attributes": [],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/menu-label"
-        }
-      ]
-    },
-    {
-      "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.",
@@ -2143,78 +2143,69 @@
       ]
     },
     {
-      "name": "sl-nav-submenu",
-      "description": "Nav submenus are used to group related nav items in a hierarchical structure.\n---\n\n\n### **Events:**\n - **sl-show** - Emitted when the submenu opens.\n- **sl-after-show** - Emitted after the submenu opens and all animations are complete.\n- **sl-hide** - Emitted when the submenu closes.\n- **sl-after-hide** - Emitted after the submenu closes and all animations are complete.\n\n### **Methods:**\n - **show(source: _'api' | 'nav' | 'user'_)** - Shows the submenu.\n- **hide(source: _'api' | 'nav' | 'user'_)** - Hides the submenu.\n\n### **Slots:**\n - _default_ - The nav items within the submenu.\n- **title** - The nav submenu's title.\n- **prefix** - Used to prepend an icon or similar element to the nav submenu.\n- **suffix** - Used to append an icon or similar element to the nav submenu.\n- **expand-icon** - Optional expand icon to use instead of the default. Works best with `<sl-icon>`.\n- **collapse-icon** - Optional collapse icon to use instead of the default. Works best with `<sl-icon>`.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **header** - The header that wraps the title, prefix, suffix and expand/collapse icon.\n- **prefix** - The prefix container.\n- **label** - The nav submenu label.\n- **suffix** - The suffix container.\n- **expand-icon** - The container that wraps the expand/collapse icons.\n- **content** - The nav submenu content.\n- **popup** - The popup that wraps the content in horizontal mode.",
+      "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.",
       "attributes": [
         {
-          "name": "key",
-          "description": "A stable key used by `sl-nav` to track open state.",
-          "values": []
+          "name": "mode",
+          "description": "Matches Antd's `mode` API.",
+          "values": [{ "name": "SlNavMode" }]
         },
         {
-          "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.",
+          "name": "multiple",
+          "description": "Matches Antd's `multiple` API.",
           "values": []
         },
         {
-          "name": "open",
-          "description": "Indicates whether or not the submenu is open.",
+          "name": "selectable",
+          "description": "Matches Antd's `selectable` API.",
           "values": []
         },
         {
-          "name": "nested",
-          "description": "Indicates if this submenu is nested within another submenu.",
+          "name": "inline-collapsed",
+          "description": "Matches Antd's `inlineCollapsed` API.",
           "values": []
         },
         {
-          "name": "title",
-          "description": "The summary to show in the header. If you need to display HTML, use the `title` slot instead.",
+          "name": "inline-indent",
+          "description": "Matches Antd's `inlineIndent` API.",
           "values": []
         },
         {
-          "name": "theme",
-          "description": "Matches Antd's `theme` field.",
-          "values": [{ "name": "light" }, { "name": "dark" }]
-        },
-        {
-          "name": "popup-class-name",
-          "description": "Matches Antd's `popupClassName` field.",
+          "name": "sub-menu-open-delay",
+          "description": "Matches Antd's `subMenuOpenDelay` API, in seconds.",
           "values": []
         },
         {
-          "name": "disabled",
-          "description": "Draws the submenu in a disabled state.",
+          "name": "sub-menu-close-delay",
+          "description": "Matches Antd's `subMenuCloseDelay` API, in seconds.",
           "values": []
         },
         {
-          "name": "active",
-          "description": "Draws the submenu in an active (selected) state.",
-          "values": []
+          "name": "trigger-sub-menu-action",
+          "description": "Matches Antd's `triggerSubMenuAction` API.",
+          "values": [{ "name": "SlNavTriggerSubMenuAction" }]
         },
         {
-          "name": "mode",
-          "description": "The mode of navigation.",
-          "values": [
-            { "name": "horizontal" },
-            { "name": "inline" },
-            { "name": "vertical" }
-          ]
+          "name": "theme",
+          "description": "Matches Antd's `theme` API. Present for compatibility and future styling.",
+          "values": [{ "name": "SlNavTheme" }]
         },
         {
-          "name": "collapsed",
-          "description": "Whether the parent nav is in inline-collapsed mode.",
+          "name": "force-sub-menu-render",
+          "description": "Matches Antd's `forceSubMenuRender` API.",
           "values": []
         },
         {
-          "name": "divider",
-          "description": "Shows a divider line above this submenu.",
+          "name": "disabled-overflow",
+          "description": "Matches Antd's `disabledOverflow` API. Present for compatibility.",
           "values": []
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/nav-submenu"
+          "url": "https://shoelace.style/components/nav"
         }
       ]
     },
@@ -2304,6 +2295,82 @@
         }
       ]
     },
+    {
+      "name": "sl-nav-submenu",
+      "description": "Nav submenus are used to group related nav items in a hierarchical structure.\n---\n\n\n### **Events:**\n - **sl-show** - Emitted when the submenu opens.\n- **sl-after-show** - Emitted after the submenu opens and all animations are complete.\n- **sl-hide** - Emitted when the submenu closes.\n- **sl-after-hide** - Emitted after the submenu closes and all animations are complete.\n\n### **Methods:**\n - **show(source: _'api' | 'nav' | 'user'_)** - Shows the submenu.\n- **hide(source: _'api' | 'nav' | 'user'_)** - Hides the submenu.\n\n### **Slots:**\n - _default_ - The nav items within the submenu.\n- **title** - The nav submenu's title.\n- **prefix** - Used to prepend an icon or similar element to the nav submenu.\n- **suffix** - Used to append an icon or similar element to the nav submenu.\n- **expand-icon** - Optional expand icon to use instead of the default. Works best with `<sl-icon>`.\n- **collapse-icon** - Optional collapse icon to use instead of the default. Works best with `<sl-icon>`.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **header** - The header that wraps the title, prefix, suffix and expand/collapse icon.\n- **prefix** - The prefix container.\n- **label** - The nav submenu label.\n- **suffix** - The suffix container.\n- **expand-icon** - The container that wraps the expand/collapse icons.\n- **content** - The nav submenu content.\n- **popup** - The popup that wraps the content in horizontal mode.",
+      "attributes": [
+        {
+          "name": "key",
+          "description": "A stable key used by `sl-nav` to track open state.",
+          "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": "open",
+          "description": "Indicates whether or not the submenu is open.",
+          "values": []
+        },
+        {
+          "name": "nested",
+          "description": "Indicates if this submenu is nested within another submenu.",
+          "values": []
+        },
+        {
+          "name": "title",
+          "description": "The summary to show in the header. If you need to display HTML, use the `title` slot instead.",
+          "values": []
+        },
+        {
+          "name": "theme",
+          "description": "Matches Antd's `theme` field.",
+          "values": [{ "name": "light" }, { "name": "dark" }]
+        },
+        {
+          "name": "popup-class-name",
+          "description": "Matches Antd's `popupClassName` field.",
+          "values": []
+        },
+        {
+          "name": "disabled",
+          "description": "Draws the submenu in a disabled state.",
+          "values": []
+        },
+        {
+          "name": "active",
+          "description": "Draws the submenu in an active (selected) state.",
+          "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": []
+        },
+        {
+          "name": "divider",
+          "description": "Shows a divider line above this submenu.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/nav-submenu"
+        }
+      ]
+    },
     {
       "name": "sl-notification",
       "description": "Notifications are used to display global messages as feedback in response to user actions.\n---\n\n\n### **Events:**\n - **sl-show** - Emitted when the notification opens.\n- **sl-after-show** - Emitted after the notification opens and all animations are complete.\n- **sl-hide** - Emitted when the notification closes.\n- **sl-after-hide** - Emitted after the notification closes and all animations are complete.\n\n### **Methods:**\n - **open(config: _NotificationConfig_): _SlNotification_** - Open a notification with the given configuration.\n- **success(config: _Omit<NotificationConfig, 'type'> | string_): _SlNotification_** - Shorthand for opening a success notification.\n- **info(config: _Omit<NotificationConfig, 'type'> | string_): _SlNotification_** - Shorthand for opening an info notification.\n- **warning(config: _Omit<NotificationConfig, 'type'> | string_): _SlNotification_** - Shorthand for opening a warning notification.\n- **error(config: _Omit<NotificationConfig, 'type'> | string_): _SlNotification_** - Shorthand for opening an error notification.\n- **destroy(key: _string_)** - Destroy a notification by key.\n- **updateContainerPositions()** - Update container positions when global config changes.\n- **config(config: _NotificationGlobalConfig_)** - Configure global notification settings.\n- **show()** - Shows the notification.\n- **hide()** - Hides the notification.\n\n### **Slots:**\n - _default_ - The notification's main content (description).\n- **title** - The notification's title.\n- **icon** - An icon to show in the notification.\n- **actions** - Actions/buttons to show in the notification.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **icon** - The container that wraps the optional icon.\n- **content** - The container that wraps the notification's content.\n- **title** - The notification's title.\n- **description** - The notification's description.\n- **actions** - The container that wraps the actions.\n- **close-button** - The close button.\n- **progress** - The progress bar container.\n- **progress-bar** - The progress bar.",
@@ -2383,73 +2450,6 @@
         }
       ]
     },
-    {
-      "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.",
-      "attributes": [
-        {
-          "name": "mode",
-          "description": "Matches Antd's `mode` API.",
-          "values": [{ "name": "SlNavMode" }]
-        },
-        {
-          "name": "multiple",
-          "description": "Matches Antd's `multiple` API.",
-          "values": []
-        },
-        {
-          "name": "selectable",
-          "description": "Matches Antd's `selectable` API.",
-          "values": []
-        },
-        {
-          "name": "inline-collapsed",
-          "description": "Matches Antd's `inlineCollapsed` API.",
-          "values": []
-        },
-        {
-          "name": "inline-indent",
-          "description": "Matches Antd's `inlineIndent` API.",
-          "values": []
-        },
-        {
-          "name": "sub-menu-open-delay",
-          "description": "Matches Antd's `subMenuOpenDelay` API, in seconds.",
-          "values": []
-        },
-        {
-          "name": "sub-menu-close-delay",
-          "description": "Matches Antd's `subMenuCloseDelay` API, in seconds.",
-          "values": []
-        },
-        {
-          "name": "trigger-sub-menu-action",
-          "description": "Matches Antd's `triggerSubMenuAction` API.",
-          "values": [{ "name": "SlNavTriggerSubMenuAction" }]
-        },
-        {
-          "name": "theme",
-          "description": "Matches Antd's `theme` API. Present for compatibility and future styling.",
-          "values": [{ "name": "SlNavTheme" }]
-        },
-        {
-          "name": "force-sub-menu-render",
-          "description": "Matches Antd's `forceSubMenuRender` API.",
-          "values": []
-        },
-        {
-          "name": "disabled-overflow",
-          "description": "Matches Antd's `disabledOverflow` API. Present for compatibility.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/nav"
-        }
-      ]
-    },
     {
       "name": "sl-pagination",
       "description": "\n---\n",
@@ -2474,6 +2474,44 @@
         }
       ]
     },
+    {
+      "name": "sl-popconfirm",
+      "description": "气泡确认框，在目标元素附近弹出轻量级确认浮层。\n---\n\n\n### **Slots:**\n - _default_ - 触发元素\n- **icon** - 自定义图标",
+      "attributes": [
+        { "name": "title", "description": "确认框标题", "values": [] },
+        { "name": "description", "description": "确认框描述", "values": [] },
+        { "name": "ok-text", "description": "确认按钮文字", "values": [] },
+        { "name": "cancel-text", "description": "取消按钮文字", "values": [] },
+        {
+          "name": "placement",
+          "description": "弹出位置",
+          "values": [{ "name": "PopconfirmPlacement" }]
+        },
+        { "name": "open", "description": "是否显示", "values": [] },
+        { "name": "disabled", "description": "是否禁用", "values": [] },
+        { "name": "icon", "description": "图标名称", "values": [] },
+        {
+          "name": "arrow",
+          "description": "是否显示箭头，支持设置箭头是否精准指向目标元素的物理中心",
+          "values": [{ "name": "PopconfirmArrow" }]
+        },
+        {
+          "name": "ok-type",
+          "description": "确认按钮类型",
+          "values": [
+            { "name": "primary" },
+            { "name": "danger" },
+            { "name": "default" }
+          ]
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/popconfirm"
+        }
+      ]
+    },
     {
       "name": "sl-popup",
       "description": "Popup is a utility that lets you declaratively anchor \"popup\" containers to another element.\n---\n\n\n### **Events:**\n - **sl-reposition** - Emitted when the popup is repositioned. This event can fire a lot, so avoid putting expensive operations in your listener or consider debouncing it.\n\n### **Methods:**\n - **reposition()** - Forces the popup to recalculate and reposition itself.\n\n### **Slots:**\n - _default_ - The popup's content.\n- **anchor** - The element the popup will be anchored to. If the anchor lives outside of the popup, you can use the `anchor` attribute or property instead.\n\n### **CSS Properties:**\n - **--arrow-size** - The size of the arrow. Note that an arrow won't be shown unless the `arrow` attribute is used. _(default: 6px)_\n- **--arrow-color** - The color of the arrow. _(default: var(--sl-color-neutral-0))_\n- **--auto-size-available-width** - A read-only custom property that determines the amount of width the popup can be before overflowing. Useful for positioning child elements that need to overflow. This property is only available when using `auto-size`. _(default: undefined)_\n- **--auto-size-available-height** - A read-only custom property that determines the amount of height the popup can be before overflowing. Useful for positioning child elements that need to overflow. This property is only available when using `auto-size`. _(default: undefined)_\n\n### **CSS Parts:**\n - **arrow** - The arrow's container. Avoid setting `top|bottom|left|right` properties, as these values are assigned dynamically as the popup moves. This is most useful for applying a background color to match the popup, and maybe a border or box shadow.\n- **popup** - The popup's container. Useful for setting a background color, box shadow, etc.\n- **hover-bridge** - The hover bridge element. Only available when the `hover-bridge` option is enabled.",
@@ -2624,6 +2662,33 @@
         }
       ]
     },
+    {
+      "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.",
@@ -2698,37 +2763,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-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.",
@@ -2765,17 +2799,6 @@
         }
       ]
     },
-    {
-      "name": "sl-popconfirm",
-      "description": "\n---\n",
-      "attributes": [],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/popconfirm"
-        }
-      ]
-    },
     {
       "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.\n- **radios** - The container that wraps the radio elements (only when not using radio buttons).",
@@ -2832,33 +2855,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-range",
       "description": "Ranges allow the user to select a single value within a given range using a slider.\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 range.\n- **blur()** - Removes focus from the range.\n- **stepUp()** - Increments the value of the range by the value of the step attribute.\n- **stepDown()** - Decrements the value of the range 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 range'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 Properties:**\n - **--thumb-size** - The size of the thumb. _(default: undefined)_\n- **--tooltip-offset** - The vertical distance the tooltip is offset from the track. _(default: undefined)_\n- **--track-color-active** - The color of the portion of the track that represents the current value. _(default: undefined)_\n- **--track-color-inactive** - The of the portion of the track that represents the remaining value. _(default: undefined)_\n- **--track-height** - The height of the track. _(default: undefined)_\n- **--track-active-offset** - The point of origin of the active track. _(default: undefined)_\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 range's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **base** - The component's base wrapper.\n- **input** - The internal `<input>` element.\n- **tooltip** - The range's tooltip.",
@@ -2926,6 +2922,49 @@
         }
       ]
     },
+    {
+      "name": "sl-rating",
+      "description": "Ratings give users a way to quickly view and provide feedback.\n---\n\n\n### **Events:**\n - **sl-change** - Emitted when the rating's value changes.\n- **sl-hover** - Emitted when the user hovers over a value. The `phase` property indicates when hovering starts, moves to a new value, or ends. The `value` property tells what the rating's value would be if the user were to commit to the hovered value.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the rating.\n- **blur()** - Removes focus from the rating.\n\n### **CSS Properties:**\n - **--symbol-color** - The inactive color for symbols. _(default: undefined)_\n- **--symbol-color-active** - The active color for symbols. _(default: undefined)_\n- **--symbol-size** - The size of symbols. _(default: undefined)_\n- **--symbol-spacing** - The spacing to use around symbols. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+      "attributes": [
+        {
+          "name": "label",
+          "description": "A label that describes the rating to assistive devices.",
+          "values": []
+        },
+        { "name": "value", "description": "The current rating.", "values": [] },
+        {
+          "name": "max",
+          "description": "The highest rating to show.",
+          "values": []
+        },
+        {
+          "name": "precision",
+          "description": "The precision at which the rating will increase and decrease. For example, to allow half-star ratings, set this\nattribute to `0.5`.",
+          "values": []
+        },
+        {
+          "name": "readonly",
+          "description": "Makes the rating readonly.",
+          "values": []
+        },
+        {
+          "name": "disabled",
+          "description": "Disables the rating.",
+          "values": []
+        },
+        {
+          "name": "getSymbol",
+          "description": "A function that customizes the symbol to be rendered. The first and only argument is the rating's current value.\nThe function should return a string containing trusted HTML of the symbol to render at the specified value. Works\nwell with `<sl-icon>` elements.",
+          "values": [{ "name": "(value: number) => string" }]
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/rating"
+        }
+      ]
+    },
     {
       "name": "sl-relative-time",
       "description": "Outputs a localized time phrase relative to the current date and time.\n---\n",
@@ -2963,62 +3002,51 @@
       ]
     },
     {
-      "name": "sl-rating",
-      "description": "Ratings give users a way to quickly view and provide feedback.\n---\n\n\n### **Events:**\n - **sl-change** - Emitted when the rating's value changes.\n- **sl-hover** - Emitted when the user hovers over a value. The `phase` property indicates when hovering starts, moves to a new value, or ends. The `value` property tells what the rating's value would be if the user were to commit to the hovered value.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the rating.\n- **blur()** - Removes focus from the rating.\n\n### **CSS Properties:**\n - **--symbol-color** - The inactive color for symbols. _(default: undefined)_\n- **--symbol-color-active** - The active color for symbols. _(default: undefined)_\n- **--symbol-size** - The size of symbols. _(default: undefined)_\n- **--symbol-spacing** - The spacing to use around symbols. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+      "name": "sl-resize-observer",
+      "description": "The Resize Observer component offers a thin, declarative interface to the [`ResizeObserver API`](https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver).\n---\n\n\n### **Events:**\n - **sl-resize** - Emitted when the element is resized.\n\n### **Slots:**\n - _default_ - One or more elements to watch for resizing.",
       "attributes": [
-        {
-          "name": "label",
-          "description": "A label that describes the rating to assistive devices.",
-          "values": []
-        },
-        { "name": "value", "description": "The current rating.", "values": [] },
-        {
-          "name": "max",
-          "description": "The highest rating to show.",
-          "values": []
-        },
-        {
-          "name": "precision",
-          "description": "The precision at which the rating will increase and decrease. For example, to allow half-star ratings, set this\nattribute to `0.5`.",
-          "values": []
-        },
-        {
-          "name": "readonly",
-          "description": "Makes the rating readonly.",
-          "values": []
-        },
         {
           "name": "disabled",
-          "description": "Disables the rating.",
+          "description": "Disables the observer.",
           "values": []
-        },
-        {
-          "name": "getSymbol",
-          "description": "A function that customizes the symbol to be rendered. The first and only argument is the rating's current value.\nThe function should return a string containing trusted HTML of the symbol to render at the specified value. Works\nwell with `<sl-icon>` elements.",
-          "values": [{ "name": "(value: number) => string" }]
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/rating"
+          "url": "https://shoelace.style/components/resize-observer"
         }
       ]
     },
     {
-      "name": "sl-resize-observer",
-      "description": "The Resize Observer component offers a thin, declarative interface to the [`ResizeObserver API`](https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver).\n---\n\n\n### **Events:**\n - **sl-resize** - Emitted when the element is resized.\n\n### **Slots:**\n - _default_ - One or more elements to watch for resizing.",
+      "name": "sl-row",
+      "description": "Row component for grid layout system.\n---\n\n\n### **Slots:**\n - _default_ - The default slot for Col components.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
       "attributes": [
         {
-          "name": "disabled",
-          "description": "Disables the observer.",
+          "name": "gutter",
+          "description": "Spacing between columns, can be a number or responsive object",
+          "values": [{ "name": "Gutter" }, { "name": "[Gutter, Gutter]" }]
+        },
+        {
+          "name": "align",
+          "description": "Vertical alignment of columns",
+          "values": [{ "name": "RowAlign" }]
+        },
+        {
+          "name": "justify",
+          "description": "Horizontal arrangement of columns",
+          "values": [{ "name": "RowJustify" }]
+        },
+        {
+          "name": "wrap",
+          "description": "Whether to wrap columns",
           "values": []
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/resize-observer"
+          "url": "https://shoelace.style/components/row"
         }
       ]
     },
@@ -3105,34 +3133,33 @@
       ]
     },
     {
-      "name": "sl-row",
-      "description": "Row component for grid layout system.\n---\n\n\n### **Slots:**\n - _default_ - The default slot for Col components.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+      "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": "gutter",
-          "description": "Spacing between columns, can be a number or responsive object",
-          "values": [{ "name": "Gutter" }, { "name": "[Gutter, Gutter]" }]
-        },
-        {
-          "name": "align",
-          "description": "Vertical alignment of columns",
-          "values": [{ "name": "RowAlign" }]
+          "name": "value",
+          "description": "The radio's value. When selected, the radio group will receive this value.",
+          "values": []
         },
         {
-          "name": "justify",
-          "description": "Horizontal arrangement of columns",
-          "values": [{ "name": "RowJustify" }]
+          "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": "wrap",
-          "description": "Whether to wrap columns",
+          "name": "disabled",
+          "description": "Disables the radio.",
           "values": []
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/row"
+          "url": "https://shoelace.style/components/radio"
         }
       ]
     },
@@ -3469,6 +3496,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",
@@ -3598,77 +3672,30 @@
       "description": "Tabs are used inside [tab groups](/components/tab-group) to represent and activate [tab panels](/components/tab-panel).\n---\n\n\n### **Events:**\n - **sl-close** - Emitted when the tab is closable and the close button is activated.\n\n### **Slots:**\n - _default_ - The tab's label.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **close-button** - The close button, an `<sl-icon-button>`.\n- **close-button__base** - The close button's exported `base` part.",
       "attributes": [
         {
-          "name": "panel",
-          "description": "The name of the tab panel this tab is associated with. The panel must be located in the same tab group.",
-          "values": []
-        },
-        {
-          "name": "active",
-          "description": "Draws the tab in an active state.",
-          "values": []
-        },
-        {
-          "name": "closable",
-          "description": "Makes the tab closable and shows a close button.",
-          "values": []
-        },
-        {
-          "name": "disabled",
-          "description": "Disables the tab and prevents selection.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/tab"
-        }
-      ]
-    },
-    {
-      "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.",
+          "name": "panel",
+          "description": "The name of the tab panel this tab is associated with. The panel must be located in the same tab group.",
           "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": "active",
+          "description": "Draws the tab in an active state.",
+          "values": []
         },
         {
-          "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": "closable",
+          "description": "Makes the tab closable and shows a close button.",
+          "values": []
         },
         {
-          "name": "snap-threshold",
-          "description": "How close the divider must be to a snap point until snapping occurs.",
+          "name": "disabled",
+          "description": "Disables the tab and prevents selection.",
           "values": []
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/split-panel"
+          "url": "https://shoelace.style/components/tab"
         }
       ]
     },
@@ -3709,6 +3736,28 @@
         }
       ]
     },
+    {
+      "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.",
+      "attributes": [
+        {
+          "name": "name",
+          "description": "The tab panel's name.",
+          "values": []
+        },
+        {
+          "name": "active",
+          "description": "When true, the tab panel will be shown.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/tab-panel"
+        }
+      ]
+    },
     {
       "name": "sl-table",
       "description": "\n---\n\n\n### **Events:**\n - **change**",
@@ -3805,28 +3854,6 @@
         }
       ]
     },
-    {
-      "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.",
-      "attributes": [
-        {
-          "name": "name",
-          "description": "The tab panel's name.",
-          "values": []
-        },
-        {
-          "name": "active",
-          "description": "When true, the tab panel will be shown.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/tab-panel"
-        }
-      ]
-    },
     {
       "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.",
@@ -4202,6 +4229,66 @@
         }
       ]
     },
+    {
+      "name": "sl-transfer",
+      "description": "Transfer 穿梭框组件，用于在两个列表之间移动数据。\n---\n\n\n### **Events:**\n - **sl-transfer-change** - 当数据穿梭完成时触发，返回目标键、方向和移动的键。\n- **sl-transfer-select-change** - 当选中项变化时触发。\n- **sl-transfer-search** - 当搜索时触发。\n- **sl-transfer-scroll** - 当列表滚动时触发。\n\n### **Methods:**\n - **moveToTarget()** - 移动选中项到目标列表\n- **moveToSource()** - 移动选中项到源列表\n- **setSourceSelectedKeys(keys: _string[]_)** - 设置源列表选中项（供外部调用，用于 source-item-list 自定义列表场景）\n- **setTargetSelectedKeys(keys: _string[]_)** - 设置目标列表选中项（供外部调用）\n\n### **Slots:**\n - **move-to-target** - 自定义\"移动到目标列表\"按钮内容。\n- **move-to-source** - 自定义\"移动到源列表\"按钮内容。\n- **operation** - 完全自定义操作区域内容，替换默认的穿梭按钮。\n- **source-empty** - 自定义源列表空提示内容。\n- **target-empty** - 自定义目标列表空提示内容。\n- **source-item-list** - 自定义源列表内容区域，替换默认列表渲染。\n- **target-item-list** - 自定义目标列表内容区域，替换默认列表渲染。\n- **source-footer** - 自定义源列表底部内容，位于分页上方。\n- **target-footer** - 自定义目标列表底部内容，位于分页上方。\n\n### **CSS Properties:**\n - **--transfer-width** - 单个面板的宽度。 _(default: undefined)_\n- **--transfer-height** - 单个面板的高度。 _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - 组件的基础容器。\n- **source-panel** - 源列表面板。\n- **target-panel** - 目标列表面板。\n- **panel-header** - 面板头部。\n- **panel-list** - 面板列表。\n- **operation** - 操作按钮区域。\n- **search-input** - 搜索输入框。",
+      "attributes": [
+        {
+          "name": "dataSource",
+          "description": "数据源",
+          "values": [{ "name": "TransferItem[]" }]
+        },
+        {
+          "name": "target-keys",
+          "description": "目标列表的 key 集合",
+          "values": [{ "name": "string[]" }]
+        },
+        { "name": "disabled", "description": "是否禁用", "values": [] },
+        { "name": "pagination", "description": "是否显示分页", "values": [] },
+        { "name": "page-size", "description": "每页显示条数", "values": [] },
+        {
+          "name": "show-search",
+          "description": "是否显示搜索框",
+          "values": []
+        },
+        {
+          "name": "show-select-all",
+          "description": "是否显示全选",
+          "values": []
+        },
+        { "name": "one-way", "description": "是否单向穿梭", "values": [] },
+        {
+          "name": "titles",
+          "description": "两个列表的标题，格式为 ['sourceTitle', 'targetTitle']",
+          "values": [{ "name": "string[]" }]
+        },
+        {
+          "name": "status",
+          "description": "组件状态",
+          "values": [
+            { "name": "normal" },
+            { "name": "success" },
+            { "name": "error" }
+          ]
+        },
+        {
+          "name": "search-placeholder",
+          "description": "搜索框占位符",
+          "values": []
+        },
+        {
+          "name": "selected-keys",
+          "description": "受控模式下的选中项 key 集合，传入后由外部完全控制选中状态",
+          "values": [{ "name": "string[]" }]
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/transfer"
+        }
+      ]
+    },
     {
       "name": "sl-tooltip",
       "description": "Tooltips display additional information based on a specific action.\n---\n\n\n### **Events:**\n - **sl-show** - Emitted when the tooltip begins to show.\n- **sl-after-show** - Emitted after the tooltip has shown and all animations are complete.\n- **sl-hide** - Emitted when the tooltip begins to hide.\n- **sl-after-hide** - Emitted after the tooltip has hidden and all animations are complete.\n\n### **Methods:**\n - **show()** - Shows the tooltip.\n- **hide()** - Hides the tooltip\n\n### **Slots:**\n - _default_ - The tooltip's target element. Avoid slotting in more than one element, as subsequent ones will be ignored.\n- **content** - The content to render in the tooltip. Alternatively, you can use the `content` attribute.\n\n### **CSS Properties:**\n - **--max-width** - The maximum width of the tooltip before its content will wrap. _(default: undefined)_\n- **--hide-delay** - The amount of time to wait before hiding the tooltip when hovering. _(default: undefined)_\n- **--show-delay** - The amount of time to wait before showing the tooltip when hovering. _(default: undefined)_\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- **base__arrow** - The popup's exported `arrow` part. Use this to target the tooltip's arrow.\n- **body** - The tooltip's body where its content is rendered.",
@@ -4268,66 +4355,6 @@
         }
       ]
     },
-    {
-      "name": "sl-transfer",
-      "description": "Transfer 穿梭框组件，用于在两个列表之间移动数据。\n---\n\n\n### **Events:**\n - **sl-transfer-change** - 当数据穿梭完成时触发，返回目标键、方向和移动的键。\n- **sl-transfer-select-change** - 当选中项变化时触发。\n- **sl-transfer-search** - 当搜索时触发。\n- **sl-transfer-scroll** - 当列表滚动时触发。\n\n### **Methods:**\n - **moveToTarget()** - 移动选中项到目标列表\n- **moveToSource()** - 移动选中项到源列表\n- **setSourceSelectedKeys(keys: _string[]_)** - 设置源列表选中项（供外部调用，用于 source-item-list 自定义列表场景）\n- **setTargetSelectedKeys(keys: _string[]_)** - 设置目标列表选中项（供外部调用）\n\n### **Slots:**\n - **move-to-target** - 自定义\"移动到目标列表\"按钮内容。\n- **move-to-source** - 自定义\"移动到源列表\"按钮内容。\n- **operation** - 完全自定义操作区域内容，替换默认的穿梭按钮。\n- **source-empty** - 自定义源列表空提示内容。\n- **target-empty** - 自定义目标列表空提示内容。\n- **source-item-list** - 自定义源列表内容区域，替换默认列表渲染。\n- **target-item-list** - 自定义目标列表内容区域，替换默认列表渲染。\n- **source-footer** - 自定义源列表底部内容，位于分页上方。\n- **target-footer** - 自定义目标列表底部内容，位于分页上方。\n\n### **CSS Properties:**\n - **--transfer-width** - 单个面板的宽度。 _(default: undefined)_\n- **--transfer-height** - 单个面板的高度。 _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - 组件的基础容器。\n- **source-panel** - 源列表面板。\n- **target-panel** - 目标列表面板。\n- **panel-header** - 面板头部。\n- **panel-list** - 面板列表。\n- **operation** - 操作按钮区域。\n- **search-input** - 搜索输入框。",
-      "attributes": [
-        {
-          "name": "dataSource",
-          "description": "数据源",
-          "values": [{ "name": "TransferItem[]" }]
-        },
-        {
-          "name": "target-keys",
-          "description": "目标列表的 key 集合",
-          "values": [{ "name": "string[]" }]
-        },
-        { "name": "disabled", "description": "是否禁用", "values": [] },
-        { "name": "pagination", "description": "是否显示分页", "values": [] },
-        { "name": "page-size", "description": "每页显示条数", "values": [] },
-        {
-          "name": "show-search",
-          "description": "是否显示搜索框",
-          "values": []
-        },
-        {
-          "name": "show-select-all",
-          "description": "是否显示全选",
-          "values": []
-        },
-        { "name": "one-way", "description": "是否单向穿梭", "values": [] },
-        {
-          "name": "titles",
-          "description": "两个列表的标题，格式为 ['sourceTitle', 'targetTitle']",
-          "values": [{ "name": "string[]" }]
-        },
-        {
-          "name": "status",
-          "description": "组件状态",
-          "values": [
-            { "name": "normal" },
-            { "name": "success" },
-            { "name": "error" }
-          ]
-        },
-        {
-          "name": "search-placeholder",
-          "description": "搜索框占位符",
-          "values": []
-        },
-        {
-          "name": "selected-keys",
-          "description": "受控模式下的选中项 key 集合，传入后由外部完全控制选中状态",
-          "values": [{ "name": "string[]" }]
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/transfer"
-        }
-      ]
-    },
     {
       "name": "sl-tree",
       "description": "Trees allow you to display a hierarchical list of selectable [tree items](/components/tree-item). Items with children can be expanded and collapsed as desired by the user.\n---\n\n\n### **Events:**\n - **sl-selection-change** - Emitted when a tree item is selected or deselected.\n\n### **Slots:**\n - _default_ - The default slot.\n- **expand-icon** - The icon to show when the tree item is expanded. Works best with `<sl-icon>`.\n- **collapse-icon** - The icon to show when the tree item is collapsed. Works best with `<sl-icon>`.\n\n### **CSS Properties:**\n - **--indent-size** - The size of the indentation for nested items. _(default: var(--sl-spacing-medium))_\n- **--indent-guide-color** - The color of the indentation line. _(default: var(--sl-color-neutral-200))_\n- **--indent-guide-offset** - The amount of vertical spacing to leave between the top and bottom of the indentation line's starting position. _(default: 0)_\n- **--indent-guide-style** - The style of the indentation line, e.g. solid, dotted, dashed. _(default: solid)_\n- **--indent-guide-width** - The width of the indentation line. _(default: 0)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -4518,6 +4545,38 @@
         }
       ]
     },
+    {
+      "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"
+        }
+      ]
+    },
     {
       "name": "sl-upload",
       "description": "上传组件，支持文件选择、拖放上传、文件列表和图片卡片模式。\n---\n\n\n### **Events:**\n - **sl-change** - 文件列表变化时触发。`event.detail` 包含 `{ file, fileList, event? }`，其中 `event` 是可选的进度信息 `{ percent }`。\n- **sl-remove** - 文件被移除时触发。调用 `event.preventDefault()` 可取消移除。`event.detail` 包含 `{ file }`。\n- **sl-preview** - 请求预览文件时触发。`event.detail` 包含 `{ file }`。\n- **sl-download** - 请求下载文件时触发。调用 `event.preventDefault()` 可阻止默认打开 URL 行为。`event.detail` 包含 `{ file }`。\n- **sl-drop** - 拖放模式下放置文件时触发。`event.detail` 包含 `{ event }`，其中 `event` 是原生 `DragEvent`。\n- **sl-exceed** - 文件数量超过 maxCount 时触发。`event.detail` 包含 `{ files, maxCount }`。\n\n### **Methods:**\n - **openFileDialog()** - 以编程方式打开文件选择对话框。\n- **upload(file: _File_)** - 以编程方式触发文件上传。\n- **abort(uid: _string_)** - 根据 uid 中止指定文件的上传。\n\n### **Slots:**\n - _default_ - 选择模式的触发内容。对于 picture-card/picture-circle，这是上传按钮的内容。\n- **drag-icon** - 拖放区域显示的图标。\n- **drag-text** - 拖放区域显示的文本。\n- **drag-hint** - 拖放文本下方显示的提示文本。\n- **tip** - 上传触发区域下方显示的帮助文本。\n\n### **CSS Properties:**\n - **--sl-upload-progress-height** - 上传进度条的高度。默认值为 `2px`。 _(default: undefined)_\n- **--sl-upload-progress-track-color** - 上传进度条的轨道颜色。默认值为 `--sl-color-neutral-200`。 _(default: undefined)_\n- **--sl-upload-progress-indicator-color** - 上传进度条的指示器颜色。默认值为 `--sl-color-primary-600`。 _(default: undefined)_\n- **--sl-upload-progress-label-color** - 上传进度条的标签颜色。默认值为 `--sl-color-neutral-0`。 _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - 组件的基础包裹容器。\n- **trigger** - 上传触发区域。\n- **drag-area** - 拖放区域（仅拖放模式）。\n- **list** - 文件列表容器。\n- **list-item** - 单个文件列表项。\n- **list-item-name** - 列表项中的文件名。\n- **list-item-actions** - 列表项中的操作按钮容器。\n- **list-item-extra** - 文件名旁显示的额外信息。\n- **list-item-progress** - 上传中项目的进度条容器。",
@@ -4607,34 +4666,13 @@
       ]
     },
     {
-      "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": []
-        }
-      ],
+      "name": "sl-visually-hidden",
+      "description": "The visually hidden utility makes content accessible to assistive devices without displaying it on the screen.\n---\n\n\n### **Slots:**\n - _default_ - The content to be visually hidden.",
+      "attributes": [],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/tree-item"
+          "url": "https://shoelace.style/components/visually-hidden"
         }
       ]
     },
@@ -4674,17 +4712,6 @@
           "url": "https://shoelace.style/components/x-markdown"
         }
       ]
-    },
-    {
-      "name": "sl-visually-hidden",
-      "description": "The visually hidden utility makes content accessible to assistive devices without displaying it on the screen.\n---\n\n\n### **Slots:**\n - _default_ - The content to be visually hidden.",
-      "attributes": [],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/visually-hidden"
-        }
-      ]
     }
   ]
 }