@kdcloudjs/shoelace 1.0.42 → 1.0.44

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

@@ -46,29 +46,43 @@
       ]
     },
     {
-      "name": "sl-animated-image",
-      "description": "A component for displaying animated GIFs and WEBPs that play and pause on interaction.\n---\n\n\n### **Events:**\n - **sl-load** - Emitted when the image loads successfully.\n- **sl-error** - Emitted when the image fails to load.\n\n### **Slots:**\n - **play-icon** - Optional play icon to use instead of the default. Works best with `<sl-icon>`.\n- **pause-icon** - Optional pause icon to use instead of the default. Works best with `<sl-icon>`.\n\n### **CSS Properties:**\n - **--control-box-size** - The size of the icon box. _(default: undefined)_\n- **--icon-size** - The size of the play/pause icons. _(default: undefined)_\n\n### **CSS Parts:**\n - **control-box** - The container that surrounds the pause/play icons and provides their background.",
+      "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"
         }
       ]
     },
@@ -105,6 +119,33 @@
         }
       ]
     },
+    {
+      "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-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.",
@@ -221,47 +262,6 @@
         }
       ]
     },
-    {
-      "name": "sl-avatar",
-      "description": "Avatars are used to represent a person or object.\n---\n\n\n### **Events:**\n - **sl-error** - The image could not be loaded. This may because of an invalid URL, a temporary network condition, or some unknown cause.\n\n### **Slots:**\n - **icon** - The default icon to use when no image or initials are present. Works best with `<sl-icon>`.\n\n### **CSS Properties:**\n - **--size** - The size of the avatar. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **icon** - The container that wraps the avatar's icon.\n- **initials** - The container that wraps the avatar's initials.\n- **image** - The avatar image. Only shown when the `image` attribute is set.",
-      "attributes": [
-        {
-          "name": "image",
-          "description": "The image source to use for the avatar.",
-          "values": []
-        },
-        {
-          "name": "label",
-          "description": "A label to use to describe the avatar to assistive devices.",
-          "values": []
-        },
-        {
-          "name": "initials",
-          "description": "Initials to use as a fallback when no image is available (1-2 characters max recommended).",
-          "values": []
-        },
-        {
-          "name": "loading",
-          "description": "Indicates how the browser should load the image.",
-          "values": [{ "name": "eager" }, { "name": "lazy" }]
-        },
-        {
-          "name": "shape",
-          "description": "The shape of the avatar.",
-          "values": [
-            { "name": "circle" },
-            { "name": "square" },
-            { "name": "rounded" }
-          ]
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/avatar"
-        }
-      ]
-    },
     {
       "name": "sl-button",
       "description": "Buttons represent actions that are available to the user.\n---\n\n\n### **Events:**\n - **sl-blur** - Emitted when the button loses focus.\n- **sl-focus** - Emitted when the button gains focus.\n- **sl-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **click()** - Simulates a click on the button.\n- **focus(options: _FocusOptions_)** - Sets focus on the button.\n- **blur()** - Removes focus from the button.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - _default_ - The button's label.\n- **prefix** - A presentational prefix icon or similar element.\n- **suffix** - A presentational suffix icon or similar element.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **prefix** - The container that wraps the prefix.\n- **label** - The button's label.\n- **suffix** - The container that wraps the suffix.\n- **caret** - The button's caret icon, an `<sl-icon>` element.\n- **spinner** - The spinner that shows when the button is in the loading state.",
@@ -528,6 +528,139 @@
         }
       ]
     },
+    {
+      "name": "sl-cascader",
+      "description": "Cascader is a cascade selection component that allows users to select from a set of hierarchical options.\n---\n\n\n### **Events:**\n - **sl-change** - Emitted when the control's value changes.\n- **sl-clear** - Emitted when the control's value is cleared.\n- **sl-input** - Emitted when the control receives input.\n- **sl-focus** - Emitted when the control gains focus.\n- **sl-blur** - Emitted when the control loses focus.\n- **sl-show** - Emitted when the cascader's menu opens.\n- **sl-after-show** - Emitted after the cascader's menu opens and all animations are complete.\n- **sl-hide** - Emitted when the cascader's menu closes.\n- **sl-after-hide** - Emitted after the cascader's menu closes and all animations are complete.\n\n### **Slots:**\n - **label** - The input's label. Alternatively, you can use the `label` attribute.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n- **prefix** - Used to prepend a presentational icon or similar element to the combobox.\n- **suffix** - Used to append a presentational icon or similar element to the combobox.\n- **clear-icon** - An icon to use in lieu of the default clear icon.\n- **expand-icon** - The icon to show when the control is expanded and collapsed.\n\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 cascader's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **combobox** - The container that wraps the prefix, suffix, combobox, clear icon, and expand button.\n- **prefix** - The container that wraps the prefix slot.\n- **suffix** - The container that wraps the suffix slot.\n- **display-input** - The element that displays the selected option's label.\n- **menu** - The cascader menu container.\n- **menu-column** - Each column in the cascader menu.\n- **menu-item** - Each item in the cascader menu.\n- **tags** - The container that houses option tags when `multiple` is used.\n- **tag** - The individual tags that represent each selected option.\n- **clear-button** - The clear button.\n- **expand-icon** - The container that wraps the expand icon.",
+      "attributes": [
+        {
+          "name": "name",
+          "description": "The name of the cascader, submitted as a name/value pair with form data.",
+          "values": []
+        },
+        {
+          "name": "value",
+          "description": "The default value of the form control.",
+          "values": [{ "name": "string[]" }]
+        },
+        {
+          "name": "size",
+          "description": "The cascader's size.",
+          "values": [
+            { "name": "small" },
+            { "name": "medium" },
+            { "name": "large" }
+          ]
+        },
+        {
+          "name": "placeholder",
+          "description": "Placeholder text to show as a hint when the cascader is empty.",
+          "values": []
+        },
+        {
+          "name": "multiple",
+          "description": "Allows more than one option to be selected.",
+          "values": []
+        },
+        {
+          "name": "disabled",
+          "description": "Disables the cascader control.",
+          "values": []
+        },
+        {
+          "name": "clearable",
+          "description": "Adds a clear button when the cascader is not empty.",
+          "values": []
+        },
+        {
+          "name": "open",
+          "description": "Indicates whether or not the cascader is open.",
+          "values": []
+        },
+        {
+          "name": "hoist",
+          "description": "Enable this option to prevent the menu from being clipped when the component is placed inside a container with `overflow: auto|scroll`.",
+          "values": []
+        },
+        {
+          "name": "filled",
+          "description": "Draws a filled cascader.",
+          "values": []
+        },
+        {
+          "name": "pill",
+          "description": "Draws a pill-style cascader with rounded edges.",
+          "values": []
+        },
+        {
+          "name": "label",
+          "description": "The cascader's label. If you need to display HTML, use the `label` slot instead.",
+          "values": []
+        },
+        {
+          "name": "placement",
+          "description": "The preferred placement of the cascader's menu.",
+          "values": [
+            { "name": "top-start" },
+            { "name": "top" },
+            { "name": "top-end" },
+            { "name": "bottom-start" },
+            { "name": "bottom" },
+            { "name": "bottom-end" }
+          ]
+        },
+        {
+          "name": "help-text",
+          "description": "The cascader's help text. If you need to display HTML, use the `help-text` slot instead.",
+          "values": []
+        },
+        {
+          "name": "form",
+          "description": "By default, form controls are associated with the nearest containing `<form>` element.",
+          "values": []
+        },
+        {
+          "name": "required",
+          "description": "The cascader's required attribute.",
+          "values": []
+        },
+        {
+          "name": "options",
+          "description": "The options to display in the cascader.",
+          "values": [{ "name": "CascaderOption[]" }]
+        },
+        {
+          "name": "fieldNames",
+          "description": "Custom field names for the options.",
+          "values": [{ "name": "FieldNames" }]
+        },
+        {
+          "name": "separator",
+          "description": "Separator used to join the selected path labels.",
+          "values": []
+        },
+        {
+          "name": "expand-trigger",
+          "description": "Whether to expand on click or hover.",
+          "values": [{ "name": "click" }, { "name": "hover" }]
+        },
+        {
+          "name": "change-on-select",
+          "description": "Whether to change selection on select.",
+          "values": []
+        },
+        {
+          "name": "show-full-path",
+          "description": "Whether to show the full path in the input.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/cascader"
+        }
+      ]
+    },
     {
       "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.",
@@ -754,108 +887,182 @@
       ]
     },
     {
-      "name": "sl-copy-button",
-      "description": "Copies text data to the clipboard when the user clicks the trigger.\n---\n\n\n### **Events:**\n - **sl-copy** - Emitted when the data has been copied.\n- **sl-error** - Emitted when the data could not be copied.\n\n### **Slots:**\n - **copy-icon** - The icon to show in the default copy state. Works best with `<sl-icon>`.\n- **success-icon** - The icon to show when the content is copied. Works best with `<sl-icon>`.\n- **error-icon** - The icon to show when a copy error occurs. Works best with `<sl-icon>`.\n\n### **CSS Properties:**\n - **--success-color** - The color to use for success feedback. _(default: undefined)_\n- **--error-color** - The color to use for error feedback. _(default: undefined)_\n\n### **CSS Parts:**\n - **button** - The internal `<button>` element.\n- **copy-icon** - The container that holds the copy icon.\n- **success-icon** - The container that holds the success icon.\n- **error-icon** - The container that holds the error icon.\n- **tooltip__base** - The tooltip's exported `base` part.\n- **tooltip__base__popup** - The tooltip's exported `popup` part.\n- **tooltip__base__arrow** - The tooltip's exported `arrow` part.\n- **tooltip__body** - The tooltip's exported `body` part.",
+      "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": "value",
-          "description": "The text value to copy.",
-          "values": []
-        },
-        {
-          "name": "from",
-          "description": "An id that references an element in the same document from which data will be copied. If both this and `value` are\npresent, this value will take precedence. By default, the target element's `textContent` will be copied. To copy an\nattribute, append the attribute name wrapped in square brackets, e.g. `from=\"el[value]\"`. To copy a property,\nappend a dot and the property name, e.g. `from=\"el.value\"`.",
-          "values": []
+          "name": "type",
+          "values": [
+            { "name": "date" },
+            { "name": "datetime" },
+            { "name": "time" }
+          ]
         },
+        { "name": "min", "values": [] },
+        { "name": "max", "values": [] },
+        { "name": "format", "values": [] }
+      ],
+      "references": [
         {
-          "name": "disabled",
-          "description": "Disables the copy button.",
-          "values": []
-        },
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/date-panel"
+        }
+      ]
+    },
+    {
+      "name": "sl-details",
+      "description": "Details show a brief summary and expand to show additional content.\n---\n\n\n### **Events:**\n - **sl-show** - Emitted when the details opens.\n- **sl-after-show** - Emitted after the details opens and all animations are complete.\n- **sl-hide** - Emitted when the details closes.\n- **sl-after-hide** - Emitted after the details closes and all animations are complete.\n\n### **Methods:**\n - **show()** - Shows the details.\n- **hide()** - Hides the details\n\n### **Slots:**\n - _default_ - The details' main content.\n- **summary** - The details' summary. Alternatively, you can use the `summary` attribute.\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 both the summary and the expand/collapse icon.\n- **summary** - The container that wraps the summary.\n- **summary-icon** - The container that wraps the expand/collapse icons.\n- **content** - The details content.",
+      "attributes": [
         {
-          "name": "copy-label",
-          "description": "A custom label to show in the tooltip.",
+          "name": "open",
+          "description": "Indicates whether or not the details is open. You can toggle this attribute to show and hide the details, or you\ncan use the `show()` and `hide()` methods and this attribute will reflect the details' open state.",
           "values": []
         },
         {
-          "name": "success-label",
-          "description": "A custom label to show in the tooltip after copying.",
+          "name": "summary",
+          "description": "The summary to show in the header. If you need to display HTML, use the `summary` slot instead.",
           "values": []
         },
         {
-          "name": "error-label",
-          "description": "A custom label to show in the tooltip when a copy error occurs.",
+          "name": "disabled",
+          "description": "Disables the details so it can't be toggled.",
           "values": []
-        },
+        }
+      ],
+      "references": [
         {
-          "name": "feedback-duration",
-          "description": "The length of time to show feedback before restoring the default trigger.",
-          "values": []
-        },
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/details"
+        }
+      ]
+    },
+    {
+      "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.",
+      "attributes": [
         {
-          "name": "tooltip-placement",
-          "description": "The preferred placement of the tooltip.",
-          "values": [
-            { "name": "top" },
-            { "name": "right" },
-            { "name": "bottom" },
-            { "name": "left" }
-          ]
+          "name": "type",
+          "values": [{ "name": "date" }, { "name": "datetime" }]
         },
         {
-          "name": "hoist",
-          "description": "Enable this option to prevent the tooltip from being clipped when the component is placed inside a container with\n`overflow: auto|hidden|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all,\nscenarios.",
-          "values": []
-        }
+          "name": "format",
+          "description": "日期格式化字符串，支持以下占位符（与 dayjs/Ant Design 一致）：\n- YYYY: 4位数年份\n- MM: 2位数月份\n- DD: 2位数日期\n- HH: 24小时制小时\n- mm: 分钟\n- ss: 秒\n- hh: 12小时制小时\n- A: AM/PM\n也支持传入数组，允许输入框接受多种格式。\n默认值：type='date' 时为 'YYYY-MM-DD'，type='datetime' 时为 'YYYY-MM-DD HH:mm:ss'",
+          "values": [{ "name": "string[]" }]
+        },
+        { "name": "pattern", "values": [] },
+        { "name": "min", "values": [] },
+        { "name": "max", "values": [] }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/copy-button"
+          "url": "https://shoelace.style/components/datepicker"
         }
       ]
     },
     {
-      "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-dialog",
+      "description": "Dialogs, sometimes called \"modals\", appear above the page and require the user's immediate attention.\n---\n\n\n### **Events:**\n - **sl-show** - Emitted when the dialog opens.\n- **sl-after-show** - Emitted after the dialog opens and all animations are complete.\n- **sl-hide** - Emitted when the dialog closes.\n- **sl-after-hide** - Emitted after the dialog closes and all animations are complete.\n- **sl-initial-focus** - Emitted when the dialog opens and is ready to receive focus. Calling `event.preventDefault()` will prevent focusing and allow you to set it on a different element, such as an input.\n- **sl-request-close** - Emitted when the user attempts to close the dialog by clicking the close button, clicking the overlay, or pressing escape. Calling `event.preventDefault()` will keep the dialog open. Avoid using this unless closing the dialog will result in destructive behavior such as data loss.\n\n### **Methods:**\n - **show()** - Shows the dialog.\n- **hide()** - Hides the dialog\n\n### **Slots:**\n - _default_ - The dialog's main content.\n- **label** - The dialog's label. Alternatively, you can use the `label` attribute.\n- **header-actions** - Optional actions to add to the header. Works best with `<sl-icon-button>`.\n- **footer** - The dialog's footer, usually one or more buttons representing various options.\n\n### **CSS Properties:**\n - **--width** - The preferred width of the dialog. Note that the dialog will shrink to accommodate smaller screens. _(default: undefined)_\n- **--header-spacing** - The amount of padding to use for the header. _(default: undefined)_\n- **--body-spacing** - The amount of padding to use for the body. _(default: undefined)_\n- **--footer-spacing** - The amount of padding to use for the footer. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **overlay** - The overlay that covers the screen behind the dialog.\n- **panel** - The dialog's panel (where the dialog and its content are rendered).\n- **header** - The dialog's header. This element wraps the title and header actions.\n- **header-actions** - Optional actions to add to the header. Works best with `<sl-icon-button>`.\n- **title** - The dialog's title.\n- **close-button** - The close button, an `<sl-icon-button>`.\n- **close-button__base** - The close button's exported `base` part.\n- **body** - The dialog's body.\n- **footer** - The dialog's footer.",
       "attributes": [
-        { "name": "open", "values": [] },
-        { "name": "value", "values": [] },
         {
-          "name": "type",
-          "values": [
-            { "name": "date" },
-            { "name": "datetime" },
-            { "name": "time" }
-          ]
+          "name": "resize",
+          "description": "Indicates whether or not the dialog is resizable. When true, the user can resize the dialog by dragging the\nbottom-right corner, and double-clicking the header will toggle fullscreen mode.",
+          "values": []
         },
-        { "name": "min", "values": [] },
-        { "name": "max", "values": [] },
-        { "name": "format", "values": [] }
+        {
+          "name": "fullscreen",
+          "description": "Indicates whether or not the dialog is in fullscreen mode.",
+          "values": []
+        },
+        {
+          "name": "open",
+          "description": "Indicates whether or not the dialog is open. You can toggle this attribute to show and hide the dialog, or you can\nuse the `show()` and `hide()` methods and this attribute will reflect the dialog's open state.",
+          "values": []
+        },
+        {
+          "name": "label",
+          "description": "The dialog's label as displayed in the header. You should always include a relevant label even when using\n`no-header`, as it is required for proper accessibility. If you need to display HTML, use the `label` slot instead.",
+          "values": []
+        },
+        {
+          "name": "no-header",
+          "description": "Disables the header. This will also remove the default close button, so please ensure you provide an easy,\naccessible way for users to dismiss the dialog.",
+          "values": []
+        },
+        {
+          "name": "mask-closable",
+          "description": "Indicates whether or not the dialog can be closed by clicking the overlay. When set to false, clicking the overlay\nwill not close the dialog.",
+          "values": []
+        }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/date-panel"
+          "url": "https://shoelace.style/components/dialog"
         }
       ]
     },
     {
-      "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.",
+      "name": "sl-copy-button",
+      "description": "Copies text data to the clipboard when the user clicks the trigger.\n---\n\n\n### **Events:**\n - **sl-copy** - Emitted when the data has been copied.\n- **sl-error** - Emitted when the data could not be copied.\n\n### **Slots:**\n - **copy-icon** - The icon to show in the default copy state. Works best with `<sl-icon>`.\n- **success-icon** - The icon to show when the content is copied. Works best with `<sl-icon>`.\n- **error-icon** - The icon to show when a copy error occurs. Works best with `<sl-icon>`.\n\n### **CSS Properties:**\n - **--success-color** - The color to use for success feedback. _(default: undefined)_\n- **--error-color** - The color to use for error feedback. _(default: undefined)_\n\n### **CSS Parts:**\n - **button** - The internal `<button>` element.\n- **copy-icon** - The container that holds the copy icon.\n- **success-icon** - The container that holds the success icon.\n- **error-icon** - The container that holds the error icon.\n- **tooltip__base** - The tooltip's exported `base` part.\n- **tooltip__base__popup** - The tooltip's exported `popup` part.\n- **tooltip__base__arrow** - The tooltip's exported `arrow` part.\n- **tooltip__body** - The tooltip's exported `body` part.",
       "attributes": [
         {
-          "name": "type",
-          "values": [{ "name": "date" }, { "name": "datetime" }]
+          "name": "value",
+          "description": "The text value to copy.",
+          "values": []
         },
-        { "name": "pattern", "values": [] },
-        { "name": "min", "values": [] },
-        { "name": "max", "values": [] }
+        {
+          "name": "from",
+          "description": "An id that references an element in the same document from which data will be copied. If both this and `value` are\npresent, this value will take precedence. By default, the target element's `textContent` will be copied. To copy an\nattribute, append the attribute name wrapped in square brackets, e.g. `from=\"el[value]\"`. To copy a property,\nappend a dot and the property name, e.g. `from=\"el.value\"`.",
+          "values": []
+        },
+        {
+          "name": "disabled",
+          "description": "Disables the copy button.",
+          "values": []
+        },
+        {
+          "name": "copy-label",
+          "description": "A custom label to show in the tooltip.",
+          "values": []
+        },
+        {
+          "name": "success-label",
+          "description": "A custom label to show in the tooltip after copying.",
+          "values": []
+        },
+        {
+          "name": "error-label",
+          "description": "A custom label to show in the tooltip when a copy error occurs.",
+          "values": []
+        },
+        {
+          "name": "feedback-duration",
+          "description": "The length of time to show feedback before restoring the default trigger.",
+          "values": []
+        },
+        {
+          "name": "tooltip-placement",
+          "description": "The preferred placement of the tooltip.",
+          "values": [
+            { "name": "top" },
+            { "name": "right" },
+            { "name": "bottom" },
+            { "name": "left" }
+          ]
+        },
+        {
+          "name": "hoist",
+          "description": "Enable this option to prevent the tooltip from being clipped when the component is placed inside a container with\n`overflow: auto|hidden|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all,\nscenarios.",
+          "values": []
+        }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/datepicker"
+          "url": "https://shoelace.style/components/copy-button"
         }
       ]
     },
@@ -947,8 +1154,8 @@
         },
         {
           "name": "format",
-          "description": "The date format to use. Defaults to YYYY-MM-DD.",
-          "values": []
+          "description": "日期格式化字符串，支持以下占位符（与 dayjs/Ant Design 一致）：\n- YYYY: 4位数年份\n- MM: 2位数月份\n- DD: 2位数日期\n- HH: 24小时制小时\n- mm: 分钟\n- ss: 秒\n- hh: 12小时制小时\n- A: AM/PM\n也支持传入数组，允许输入框接受多种格式。\n默认值：type='date' 时为 'YYYY-MM-DD'，type='datetime' 时为 'YYYY-MM-DD HH:mm:ss'",
+          "values": [{ "name": "string[]" }]
         }
       ],
       "references": [
@@ -958,33 +1165,6 @@
         }
       ]
     },
-    {
-      "name": "sl-details",
-      "description": "Details show a brief summary and expand to show additional content.\n---\n\n\n### **Events:**\n - **sl-show** - Emitted when the details opens.\n- **sl-after-show** - Emitted after the details opens and all animations are complete.\n- **sl-hide** - Emitted when the details closes.\n- **sl-after-hide** - Emitted after the details closes and all animations are complete.\n\n### **Methods:**\n - **show()** - Shows the details.\n- **hide()** - Hides the details\n\n### **Slots:**\n - _default_ - The details' main content.\n- **summary** - The details' summary. Alternatively, you can use the `summary` attribute.\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 both the summary and the expand/collapse icon.\n- **summary** - The container that wraps the summary.\n- **summary-icon** - The container that wraps the expand/collapse icons.\n- **content** - The details content.",
-      "attributes": [
-        {
-          "name": "open",
-          "description": "Indicates whether or not the details is open. You can toggle this attribute to show and hide the details, or you\ncan use the `show()` and `hide()` methods and this attribute will reflect the details' open state.",
-          "values": []
-        },
-        {
-          "name": "summary",
-          "description": "The summary to show in the header. If you need to display HTML, use the `summary` slot instead.",
-          "values": []
-        },
-        {
-          "name": "disabled",
-          "description": "Disables the details so it can't be toggled.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/details"
-        }
-      ]
-    },
     {
       "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.",
@@ -1027,48 +1207,6 @@
         }
       ]
     },
-    {
-      "name": "sl-dialog",
-      "description": "Dialogs, sometimes called \"modals\", appear above the page and require the user's immediate attention.\n---\n\n\n### **Events:**\n - **sl-show** - Emitted when the dialog opens.\n- **sl-after-show** - Emitted after the dialog opens and all animations are complete.\n- **sl-hide** - Emitted when the dialog closes.\n- **sl-after-hide** - Emitted after the dialog closes and all animations are complete.\n- **sl-initial-focus** - Emitted when the dialog opens and is ready to receive focus. Calling `event.preventDefault()` will prevent focusing and allow you to set it on a different element, such as an input.\n- **sl-request-close** - Emitted when the user attempts to close the dialog by clicking the close button, clicking the overlay, or pressing escape. Calling `event.preventDefault()` will keep the dialog open. Avoid using this unless closing the dialog will result in destructive behavior such as data loss.\n\n### **Methods:**\n - **show()** - Shows the dialog.\n- **hide()** - Hides the dialog\n\n### **Slots:**\n - _default_ - The dialog's main content.\n- **label** - The dialog's label. Alternatively, you can use the `label` attribute.\n- **header-actions** - Optional actions to add to the header. Works best with `<sl-icon-button>`.\n- **footer** - The dialog's footer, usually one or more buttons representing various options.\n\n### **CSS Properties:**\n - **--width** - The preferred width of the dialog. Note that the dialog will shrink to accommodate smaller screens. _(default: undefined)_\n- **--header-spacing** - The amount of padding to use for the header. _(default: undefined)_\n- **--body-spacing** - The amount of padding to use for the body. _(default: undefined)_\n- **--footer-spacing** - The amount of padding to use for the footer. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **overlay** - The overlay that covers the screen behind the dialog.\n- **panel** - The dialog's panel (where the dialog and its content are rendered).\n- **header** - The dialog's header. This element wraps the title and header actions.\n- **header-actions** - Optional actions to add to the header. Works best with `<sl-icon-button>`.\n- **title** - The dialog's title.\n- **close-button** - The close button, an `<sl-icon-button>`.\n- **close-button__base** - The close button's exported `base` part.\n- **body** - The dialog's body.\n- **footer** - The dialog's footer.",
-      "attributes": [
-        {
-          "name": "resize",
-          "description": "Indicates whether or not the dialog is resizable. When true, the user can resize the dialog by dragging the\nbottom-right corner, and double-clicking the header will toggle fullscreen mode.",
-          "values": []
-        },
-        {
-          "name": "fullscreen",
-          "description": "Indicates whether or not the dialog is in fullscreen mode.",
-          "values": []
-        },
-        {
-          "name": "open",
-          "description": "Indicates whether or not the dialog is open. You can toggle this attribute to show and hide the dialog, or you can\nuse the `show()` and `hide()` methods and this attribute will reflect the dialog's open state.",
-          "values": []
-        },
-        {
-          "name": "label",
-          "description": "The dialog's label as displayed in the header. You should always include a relevant label even when using\n`no-header`, as it is required for proper accessibility. If you need to display HTML, use the `label` slot instead.",
-          "values": []
-        },
-        {
-          "name": "no-header",
-          "description": "Disables the header. This will also remove the default close button, so please ensure you provide an easy,\naccessible way for users to dismiss the dialog.",
-          "values": []
-        },
-        {
-          "name": "mask-closable",
-          "description": "Indicates whether or not the dialog can be closed by clicking the overlay. When set to false, clicking the overlay\nwill not close the dialog.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/dialog"
-        }
-      ]
-    },
     {
       "name": "sl-float-button",
       "description": "A floating action button that stays fixed on the page.\n---\n\n\n### **Events:**\n - **sl-click** - Emitted when the button is clicked.\n\n### **Slots:**\n - _default_ - The button's icon content.\n- **content** - Optional text content (only visible when shape is square).\n\n### **CSS Parts:**\n - **base** - The button's base wrapper.\n- **icon** - The icon container.\n- **content** - The text content container.",
@@ -1172,6 +1310,76 @@
         }
       ]
     },
+    {
+      "name": "sl-dropdown",
+      "description": "Dropdowns expose additional content that \"drops down\" in a panel.\n---\n\n\n### **Events:**\n - **sl-show** - Emitted when the dropdown opens.\n- **sl-after-show** - Emitted after the dropdown opens and all animations are complete.\n- **sl-hide** - Emitted when the dropdown closes.\n- **sl-after-hide** - Emitted after the dropdown closes and all animations are complete.\n\n### **Methods:**\n - **show()** - Shows the dropdown panel.\n- **hide()** - Hides the dropdown panel\n- **reposition()** - Instructs the dropdown menu to reposition. Useful when the position or size of the trigger changes when the menu\nis activated.\n\n### **Slots:**\n - _default_ - The dropdown's main content.\n- **trigger** - The dropdown's trigger, usually a `<sl-button>` element.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper, an `<sl-popup>` element.\n- **base__popup** - The popup's exported `popup` part. Use this to target the tooltip's popup container.\n- **trigger** - The container that wraps the trigger.\n- **panel** - The panel that gets shown when the dropdown is open.",
+      "attributes": [
+        {
+          "name": "open",
+          "description": "Indicates whether or not the dropdown is open. You can toggle this attribute to show and hide the dropdown, or you\ncan use the `show()` and `hide()` methods and this attribute will reflect the dropdown's open state.",
+          "values": []
+        },
+        {
+          "name": "placement",
+          "description": "The preferred placement of the dropdown panel. Note that the actual placement may vary as needed to keep the panel\ninside of the viewport.",
+          "values": [
+            { "name": "" },
+            { "name": "top" },
+            { "name": "top-start" },
+            { "name": "top-end" },
+            { "name": "bottom" },
+            { "name": "bottom-start" },
+            { "name": "bottom-end" },
+            { "name": "right" },
+            { "name": "right-start" },
+            { "name": "right-end" },
+            { "name": "left" },
+            { "name": "left-start" },
+            { "name": "left-end" }
+          ]
+        },
+        {
+          "name": "disabled",
+          "description": "Disables the dropdown so the panel will not open.",
+          "values": []
+        },
+        {
+          "name": "stay-open-on-select",
+          "description": "By default, the dropdown is closed when an item is selected. This attribute will keep it open instead. Useful for\ndropdowns that allow for multiple interactions.",
+          "values": []
+        },
+        {
+          "name": "distance",
+          "description": "The distance in pixels from which to offset the panel away from its trigger.",
+          "values": []
+        },
+        {
+          "name": "skidding",
+          "description": "The distance in pixels from which to offset the panel along its trigger.",
+          "values": []
+        },
+        {
+          "name": "hoist",
+          "description": "Enable this option to prevent the panel from being clipped when the component is placed inside a container with\n`overflow: auto|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all, scenarios.",
+          "values": []
+        },
+        {
+          "name": "sync",
+          "description": "Syncs the popup width or height to that of the trigger element.",
+          "values": [
+            { "name": "width" },
+            { "name": "height" },
+            { "name": "both" }
+          ]
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/dropdown"
+        }
+      ]
+    },
     {
       "name": "sl-format-date",
       "description": "Formats a date/time using the specified locale and options.\n---\n",
@@ -1258,6 +1466,23 @@
         }
       ]
     },
+    {
+      "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-format-bytes",
       "description": "Formats a number as a human readable bytes value.\n---\n",
@@ -1290,178 +1515,128 @@
       ]
     },
     {
-      "name": "sl-dropdown",
-      "description": "Dropdowns expose additional content that \"drops down\" in a panel.\n---\n\n\n### **Events:**\n - **sl-show** - Emitted when the dropdown opens.\n- **sl-after-show** - Emitted after the dropdown opens and all animations are complete.\n- **sl-hide** - Emitted when the dropdown closes.\n- **sl-after-hide** - Emitted after the dropdown closes and all animations are complete.\n\n### **Methods:**\n - **show()** - Shows the dropdown panel.\n- **hide()** - Hides the dropdown panel\n- **reposition()** - Instructs the dropdown menu to reposition. Useful when the position or size of the trigger changes when the menu\nis activated.\n\n### **Slots:**\n - _default_ - The dropdown's main content.\n- **trigger** - The dropdown's trigger, usually a `<sl-button>` element.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper, an `<sl-popup>` element.\n- **base__popup** - The popup's exported `popup` part. Use this to target the tooltip's popup container.\n- **trigger** - The container that wraps the trigger.\n- **panel** - The panel that gets shown when the dropdown is open.",
+      "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.",
       "attributes": [
         {
-          "name": "open",
-          "description": "Indicates whether or not the dropdown is open. You can toggle this attribute to show and hide the dropdown, or you\ncan use the `show()` and `hide()` methods and this attribute will reflect the dropdown's open state.",
+          "name": "name",
+          "description": "The name of the icon to draw. Available names depend on the icon library being used.",
           "values": []
         },
         {
-          "name": "placement",
-          "description": "The preferred placement of the dropdown panel. Note that the actual placement may vary as needed to keep the panel\ninside of the viewport.",
-          "values": [
-            { "name": "" },
-            { "name": "top" },
-            { "name": "top-start" },
-            { "name": "top-end" },
-            { "name": "bottom" },
-            { "name": "bottom-start" },
-            { "name": "bottom-end" },
-            { "name": "right" },
-            { "name": "right-start" },
-            { "name": "right-end" },
-            { "name": "left" },
-            { "name": "left-start" },
-            { "name": "left-end" }
-          ]
+          "name": "library",
+          "description": "The name of a registered custom icon library.",
+          "values": []
         },
         {
-          "name": "disabled",
-          "description": "Disables the dropdown so the panel will not open.",
+          "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": "stay-open-on-select",
-          "description": "By default, the dropdown is closed when an item is selected. This attribute will keep it open instead. Useful for\ndropdowns that allow for multiple interactions.",
+          "name": "href",
+          "description": "When set, the underlying button will be rendered as an `<a>` with this `href` instead of a `<button>`.",
           "values": []
         },
         {
-          "name": "distance",
-          "description": "The distance in pixels from which to offset the panel away from its trigger.",
-          "values": []
+          "name": "target",
+          "description": "Tells the browser where to open the link. Only used when `href` is set.",
+          "values": [
+            { "name": "_blank" },
+            { "name": "_parent" },
+            { "name": "_self" },
+            { "name": "_top" }
+          ]
         },
         {
-          "name": "skidding",
-          "description": "The distance in pixels from which to offset the panel along its trigger.",
+          "name": "download",
+          "description": "Tells the browser to download the linked file as this filename. Only used when `href` is set.",
           "values": []
         },
         {
-          "name": "hoist",
-          "description": "Enable this option to prevent the panel from being clipped when the component is placed inside a container with\n`overflow: auto|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all, scenarios.",
+          "name": "label",
+          "description": "A description that gets read by assistive devices. For optimal accessibility, you should always include a label\nthat describes what the icon button does.",
           "values": []
         },
         {
-          "name": "sync",
-          "description": "Syncs the popup width or height to that of the trigger element.",
-          "values": [
-            { "name": "width" },
-            { "name": "height" },
-            { "name": "both" }
-          ]
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/dropdown"
-        }
-      ]
-    },
-    {
-      "name": "sl-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.",
+          "name": "disabled",
+          "description": "Disables the button.",
           "values": []
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/divider"
+          "url": "https://shoelace.style/components/icon-button"
         }
       ]
     },
     {
-      "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.",
+        {
+          "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-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.",
+      "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": "library",
-          "description": "The name of a registered custom icon library.",
-          "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": "href",
-          "description": "When set, the underlying button will be rendered as an `<a>` with this `href` instead of a `<button>`.",
-          "values": []
-        },
-        {
-          "name": "target",
-          "description": "Tells the browser where to open the link. Only used when `href` is set.",
-          "values": [
-            { "name": "_blank" },
-            { "name": "_parent" },
-            { "name": "_self" },
-            { "name": "_top" }
-          ]
-        },
-        {
-          "name": "download",
-          "description": "Tells the browser to download the linked file as this filename. Only used when `href` is set.",
-          "values": []
-        },
         {
           "name": "label",
-          "description": "A description that gets read by assistive devices. For optimal accessibility, you should always include a label\nthat describes what the icon button does.",
+          "description": "An alternate description to use for assistive devices. If omitted, the icon will be considered presentational and\nignored by assistive devices.",
           "values": []
         },
         {
-          "name": "disabled",
-          "description": "Disables the button.",
+          "name": "library",
+          "description": "The name of a registered custom icon library.",
           "values": []
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/icon-button"
+          "url": "https://shoelace.style/components/icon"
         }
       ]
     },
@@ -1509,6 +1684,37 @@
         }
       ]
     },
+    {
+      "name": "sl-include",
+      "description": "Includes give you the power to embed external HTML files into the page.\n---\n\n\n### **Events:**\n - **sl-load** - Emitted when the included file is loaded.\n- **sl-error** - Emitted when the included file fails to load due to an error.",
+      "attributes": [
+        {
+          "name": "src",
+          "description": "The location of the HTML file to include. Be sure you trust the content you are including as it will be executed as\ncode and can result in XSS attacks.",
+          "values": []
+        },
+        {
+          "name": "mode",
+          "description": "The fetch mode to use.",
+          "values": [
+            { "name": "cors" },
+            { "name": "no-cors" },
+            { "name": "same-origin" }
+          ]
+        },
+        {
+          "name": "allow-scripts",
+          "description": "Allows included scripts to be executed. Be sure you trust the content you are including as it will be executed as\ncode and can result in XSS attacks.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/include"
+        }
+      ]
+    },
     {
       "name": "sl-format-number",
       "description": "Formats a number using the specified locale and options.\n---\n",
@@ -1580,85 +1786,6 @@
         }
       ]
     },
-    {
-      "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": "fallback",
-          "description": "加载失败时的回退图片地址",
-          "values": []
-        },
-        {
-          "name": "placeholder",
-          "description": "加载占位图；设为 true 显示默认占位符，设为字符串则作为占位图片 src",
-          "values": []
-        },
-        { "name": "no-preview", "description": "是否禁用预览", "values": [] },
-        {
-          "name": "preview",
-          "description": "预览配置",
-          "values": [{ "name": "SlImagePreviewConfig" }]
-        },
-        {
-          "name": "in-group",
-          "description": "是否在 group 中（由 sl-image-preview-group 自动设置）",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/image"
-        }
-      ]
-    },
-    {
-      "name": "sl-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-include",
-      "description": "Includes give you the power to embed external HTML files into the page.\n---\n\n\n### **Events:**\n - **sl-load** - Emitted when the included file is loaded.\n- **sl-error** - Emitted when the included file fails to load due to an error.",
-      "attributes": [
-        {
-          "name": "src",
-          "description": "The location of the HTML file to include. Be sure you trust the content you are including as it will be executed as\ncode and can result in XSS attacks.",
-          "values": []
-        },
-        {
-          "name": "mode",
-          "description": "The fetch mode to use.",
-          "values": [
-            { "name": "cors" },
-            { "name": "no-cors" },
-            { "name": "same-origin" }
-          ]
-        },
-        {
-          "name": "allow-scripts",
-          "description": "Allows included scripts to be executed. Be sure you trust the content you are including as it will be executed as\ncode and can result in XSS attacks.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/include"
-        }
-      ]
-    },
     {
       "name": "sl-input",
       "description": "Inputs collect data from the user.\n---\n\n\n### **Events:**\n - **sl-blur** - Emitted when the control loses focus.\n- **sl-change** - Emitted when an alteration to the control's value is committed by the user.\n- **sl-clear** - Emitted when the clear button is activated.\n- **sl-focus** - Emitted when the control gains focus.\n- **sl-input** - Emitted when the control receives input.\n- **sl-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the input.\n- **blur()** - Removes focus from the input.\n- **select()** - Selects all the text in the input.\n- **setSelectionRange(selectionStart: _number_, selectionEnd: _number_, selectionDirection: _'forward' | 'backward' | 'none'_)** - Sets the start and end positions of the text selection (0-based).\n- **setRangeText(replacement: _string_, start: _number_, end: _number_, selectMode: _'select' | 'start' | 'end' | 'preserve'_)** - Replaces a range of text with a new string.\n- **showPicker()** - Displays the browser picker for an input element (only works if the browser supports it for the input type).\n- **stepUp()** - Increments the value of a numeric input type by the value of the step attribute.\n- **stepDown()** - Decrements the value of a numeric input type by the value of the step attribute.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - **label** - The input's label. Alternatively, you can use the `label` attribute.\n- **prefix** - Used to prepend a presentational icon or similar element to the input.\n- **suffix** - Used to append a presentational icon or similar element to the input.\n- **clear-icon** - An icon to use in lieu of the default clear icon.\n- **show-password-icon** - An icon to use in lieu of the default show password icon.\n- **hide-password-icon** - An icon to use in lieu of the default hide password icon.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The input's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **base** - The component's base wrapper.\n- **input** - The internal `<input>` control.\n- **prefix** - The container that wraps the prefix.\n- **clear-button** - The clear button.\n- **password-toggle-button** - The password toggle button.\n- **suffix** - The container that wraps the suffix.",
@@ -1868,6 +1995,17 @@
         }
       ]
     },
+    {
+      "name": "sl-menu",
+      "description": "Menus provide a list of options for the user to choose from.\n---\n\n\n### **Events:**\n - **sl-select** - Emitted when a menu item is selected.\n\n### **Slots:**\n - _default_ - The menu's content, including menu items, menu labels, and dividers.",
+      "attributes": [],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/menu"
+        }
+      ]
+    },
     {
       "name": "sl-menu-item",
       "description": "Menu items provide options for the user to pick from in a menu.\n---\n\n\n### **Methods:**\n - **getTextLabel()** - Returns a text label based on the contents of the menu item's default slot.\n\n### **Slots:**\n - _default_ - The menu item's label.\n- **prefix** - Used to prepend an icon or similar element to the menu item.\n- **suffix** - Used to append an icon or similar element to the menu item.\n- **submenu** - Used to denote a nested menu.\n\n### **CSS Properties:**\n - **--submenu-offset** - The distance submenus shift to overlap the parent menu. _(default: -2px)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **checked-icon** - The checked icon, which is only visible when the menu item is checked.\n- **prefix** - The prefix container.\n- **label** - The menu item label.\n- **suffix** - The suffix container.\n- **spinner** - The spinner that shows when the menu item is in the loading state.\n- **spinner__base** - The spinner's base part.\n- **submenu-icon** - The submenu icon, visible only when the menu item has a submenu (not yet implemented).",
@@ -1917,137 +2055,111 @@
       ]
     },
     {
-      "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.",
+      "name": "sl-mutation-observer",
+      "description": "The Mutation Observer component offers a thin, declarative interface to the [`MutationObserver API`](https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver).\n---\n\n\n### **Events:**\n - **sl-mutation** - Emitted when a mutation occurs.\n\n### **Slots:**\n - _default_ - The content to watch for mutations.",
       "attributes": [
         {
-          "name": "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.",
+          "name": "attr",
+          "description": "Watches for changes to attributes. To watch only specific attributes, separate them by a space, e.g.\n`attr=\"class id title\"`. To watch all attributes, use `*`.",
           "values": []
         },
         {
-          "name": "inline-indent",
-          "description": "Matches Antd's `inlineIndent` API.",
+          "name": "attr-old-value",
+          "description": "Indicates whether or not the attribute's previous value should be recorded when monitoring changes.",
           "values": []
         },
         {
-          "name": "sub-menu-open-delay",
-          "description": "Matches Antd's `subMenuOpenDelay` API, in seconds.",
+          "name": "char-data",
+          "description": "Watches for changes to the character data contained within the node.",
           "values": []
         },
         {
-          "name": "sub-menu-close-delay",
-          "description": "Matches Antd's `subMenuCloseDelay` API, in seconds.",
+          "name": "char-data-old-value",
+          "description": "Indicates whether or not the previous value of the node's text should be recorded.",
           "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.",
+          "name": "child-list",
+          "description": "Watches for the addition or removal of new child nodes.",
           "values": []
         },
         {
-          "name": "disabled-overflow",
-          "description": "Matches Antd's `disabledOverflow` API. Present for compatibility.",
+          "name": "disabled",
+          "description": "Disables the observer.",
           "values": []
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/nav"
+          "url": "https://shoelace.style/components/mutation-observer"
         }
       ]
     },
     {
-      "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.",
+      "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": "attr",
-          "description": "Watches for changes to attributes. To watch only specific attributes, separate them by a space, e.g.\n`attr=\"class id title\"`. To watch all attributes, use `*`.",
+          "name": "mode",
+          "description": "Matches Antd's `mode` API.",
+          "values": [{ "name": "SlNavMode" }]
+        },
+        {
+          "name": "multiple",
+          "description": "Matches Antd's `multiple` API.",
           "values": []
         },
         {
-          "name": "attr-old-value",
-          "description": "Indicates whether or not the attribute's previous value should be recorded when monitoring changes.",
+          "name": "selectable",
+          "description": "Matches Antd's `selectable` API.",
           "values": []
         },
         {
-          "name": "char-data",
-          "description": "Watches for changes to the character data contained within the node.",
+          "name": "inline-collapsed",
+          "description": "Matches Antd's `inlineCollapsed` API.",
           "values": []
         },
         {
-          "name": "char-data-old-value",
-          "description": "Indicates whether or not the previous value of the node's text should be recorded.",
+          "name": "inline-indent",
+          "description": "Matches Antd's `inlineIndent` API.",
           "values": []
         },
         {
-          "name": "child-list",
-          "description": "Watches for the addition or removal of new child nodes.",
+          "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": "disabled",
-          "description": "Disables the observer.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/mutation-observer"
-        }
-      ]
-    },
-    {
-      "name": "sl-nav-group",
-      "description": "Nav groups are used to group related nav items.\n---\n\n\n### **Slots:**\n - _default_ - The nav items within the group.\n- **title** - The nav group's title.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **title** - The nav group title.\n- **body** - The nav group body.",
-      "attributes": [
+          "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": "active",
-          "description": "Draws the nav group in an active (selected) state.",
+          "name": "force-sub-menu-render",
+          "description": "Matches Antd's `forceSubMenuRender` API.",
           "values": []
         },
         {
-          "name": "mode",
-          "description": "The mode of navigation.",
-          "values": [
-            { "name": "horizontal" },
-            { "name": "inline" },
-            { "name": "vertical" }
-          ]
+          "name": "disabled-overflow",
+          "description": "Matches Antd's `disabledOverflow` API. Present for compatibility.",
+          "values": []
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/nav-group"
+          "url": "https://shoelace.style/components/nav"
         }
       ]
     },
@@ -2137,6 +2249,32 @@
         }
       ]
     },
+    {
+      "name": "sl-nav-group",
+      "description": "Nav groups are used to group related nav items.\n---\n\n\n### **Slots:**\n - _default_ - The nav items within the group.\n- **title** - The nav group's title.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **title** - The nav group title.\n- **body** - The nav group body.",
+      "attributes": [
+        {
+          "name": "active",
+          "description": "Draws the nav group in an active (selected) state.",
+          "values": []
+        },
+        {
+          "name": "mode",
+          "description": "The mode of navigation.",
+          "values": [
+            { "name": "horizontal" },
+            { "name": "inline" },
+            { "name": "vertical" }
+          ]
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/nav-group"
+        }
+      ]
+    },
     {
       "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.",
@@ -2214,24 +2352,59 @@
       ]
     },
     {
-      "name": "sl-option",
-      "description": "Options define the selectable items within various form controls such as [select](/components/select).\n---\n\n\n### **Methods:**\n - **getTextLabel()** - Returns a plain text label based on the option's content.\n\n### **Slots:**\n - _default_ - The option's label.\n- **prefix** - Used to prepend an icon or similar element to the menu item.\n- **suffix** - Used to append an icon or similar element to the menu item.\n\n### **CSS Parts:**\n - **checked-icon** - The checked icon, an `<sl-icon>` element.\n- **base** - The component's base wrapper.\n- **label** - The option's label.\n- **prefix** - The container that wraps the prefix.\n- **suffix** - The container that wraps the suffix.",
+      "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.",
       "attributes": [
         {
-          "name": "value",
-          "description": "The option's value. When selected, the containing form control will receive this value. The value must be unique\nfrom other options in the same group. Values may not contain spaces, as spaces are used as delimiters when listing\nmultiple values.",
+          "name": "open",
+          "description": "Indicates whether or not the notification is open.",
           "values": []
         },
         {
-          "name": "disabled",
-          "description": "Draws the option in a disabled state, preventing selection.",
+          "name": "closable",
+          "description": "Enables a close button that allows the user to dismiss the notification.",
+          "values": []
+        },
+        {
+          "name": "close-icon",
+          "description": "Custom close icon name. Set to null or false to hide the close button.",
+          "values": [{ "name": "false" }]
+        },
+        {
+          "name": "type",
+          "description": "The notification's type variant.",
+          "values": [{ "name": "NotificationType" }]
+        },
+        {
+          "name": "duration",
+          "description": "The length of time, in milliseconds, the notification will show before closing itself. Set to false or 0 to disable.",
+          "values": [{ "name": "false" }]
+        },
+        {
+          "name": "placement",
+          "description": "The placement of the notification.",
+          "values": [{ "name": "NotificationPlacement" }]
+        },
+        {
+          "name": "show-progress",
+          "description": "Whether to show the progress bar.",
+          "values": []
+        },
+        {
+          "name": "pause-on-hover",
+          "description": "Whether to pause the auto-hide timer when hovering.",
+          "values": []
+        },
+        {
+          "name": "key",
+          "description": "A unique key for the notification.",
           "values": []
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/option"
+          "url": "https://shoelace.style/components/notification"
         }
       ]
     },
@@ -2385,6 +2558,28 @@
         }
       ]
     },
+    {
+      "name": "sl-option",
+      "description": "Options define the selectable items within various form controls such as [select](/components/select).\n---\n\n\n### **Methods:**\n - **getTextLabel()** - Returns a plain text label based on the option's content.\n\n### **Slots:**\n - _default_ - The option's label.\n- **prefix** - Used to prepend an icon or similar element to the menu item.\n- **suffix** - Used to append an icon or similar element to the menu item.\n\n### **CSS Parts:**\n - **checked-icon** - The checked icon, an `<sl-icon>` element.\n- **base** - The component's base wrapper.\n- **label** - The option's label.\n- **prefix** - The container that wraps the prefix.\n- **suffix** - The container that wraps the suffix.",
+      "attributes": [
+        {
+          "name": "value",
+          "description": "The option's value. When selected, the containing form control will receive this value. The value must be unique\nfrom other options in the same group. Values may not contain spaces, as spaces are used as delimiters when listing\nmultiple values.",
+          "values": []
+        },
+        {
+          "name": "disabled",
+          "description": "Draws the option in a disabled state, preventing selection.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/option"
+        }
+      ]
+    },
     {
       "name": "sl-pagination",
       "description": "\n---\n",
@@ -2436,63 +2631,6 @@
         }
       ]
     },
-    {
-      "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.",
-      "attributes": [
-        {
-          "name": "open",
-          "description": "Indicates whether or not the notification is open.",
-          "values": []
-        },
-        {
-          "name": "closable",
-          "description": "Enables a close button that allows the user to dismiss the notification.",
-          "values": []
-        },
-        {
-          "name": "close-icon",
-          "description": "Custom close icon name. Set to null or false to hide the close button.",
-          "values": [{ "name": "false" }]
-        },
-        {
-          "name": "type",
-          "description": "The notification's type variant.",
-          "values": [{ "name": "NotificationType" }]
-        },
-        {
-          "name": "duration",
-          "description": "The length of time, in milliseconds, the notification will show before closing itself. Set to false or 0 to disable.",
-          "values": [{ "name": "false" }]
-        },
-        {
-          "name": "placement",
-          "description": "The placement of the notification.",
-          "values": [{ "name": "NotificationPlacement" }]
-        },
-        {
-          "name": "show-progress",
-          "description": "Whether to show the progress bar.",
-          "values": []
-        },
-        {
-          "name": "pause-on-hover",
-          "description": "Whether to pause the auto-hide timer when hovering.",
-          "values": []
-        },
-        {
-          "name": "key",
-          "description": "A unique key for the notification.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/notification"
-        }
-      ]
-    },
     {
       "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.",
@@ -2567,37 +2705,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-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).",
@@ -2690,34 +2797,70 @@
           "values": []
         },
         {
-          "name": "max",
-          "description": "The maximum acceptable value of the range.",
+          "name": "max",
+          "description": "The maximum acceptable value of the range.",
+          "values": []
+        },
+        {
+          "name": "step",
+          "description": "The interval at which the range will increase and decrease.",
+          "values": []
+        },
+        {
+          "name": "tooltip",
+          "description": "The preferred placement of the range's tooltip.",
+          "values": [
+            { "name": "top" },
+            { "name": "bottom" },
+            { "name": "none" }
+          ]
+        },
+        {
+          "name": "form",
+          "description": "By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/range"
+        }
+      ]
+    },
+    {
+      "name": "sl-radio-button",
+      "description": "Radios buttons allow the user to select a single option from a group using a button-like control.\n---\n\n\n### **Events:**\n - **sl-blur** - Emitted when the button loses focus.\n- **sl-focus** - Emitted when the button gains focus.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the radio button.\n- **blur()** - Removes focus from the radio button.\n\n### **Slots:**\n - _default_ - The radio button's label.\n- **prefix** - A presentational prefix icon or similar element.\n- **suffix** - A presentational suffix icon or similar element.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **button** - The internal `<button>` element.\n- **button--checked** - The internal button element when the radio button is checked.\n- **prefix** - The container that wraps the prefix.\n- **label** - The container that wraps the radio button's label.\n- **suffix** - The container that wraps the suffix.",
+      "attributes": [
+        {
+          "name": "value",
+          "description": "The radio's value. When selected, the radio group will receive this value.",
           "values": []
         },
         {
-          "name": "step",
-          "description": "The interval at which the range will increase and decrease.",
+          "name": "disabled",
+          "description": "Disables the radio button.",
           "values": []
         },
         {
-          "name": "tooltip",
-          "description": "The preferred placement of the range's tooltip.",
+          "name": "size",
+          "description": "The radio button's size. When used inside a radio group, the size will be determined by the radio group's size so\nthis attribute can typically be omitted.",
           "values": [
-            { "name": "top" },
-            { "name": "bottom" },
-            { "name": "none" }
+            { "name": "small" },
+            { "name": "medium" },
+            { "name": "large" }
           ]
         },
         {
-          "name": "form",
-          "description": "By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.",
+          "name": "pill",
+          "description": "Draws a pill-style radio button with rounded edges.",
           "values": []
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/range"
+          "url": "https://shoelace.style/components/radio-button"
         }
       ]
     },
@@ -2764,6 +2907,37 @@
         }
       ]
     },
+    {
+      "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-relative-time",
       "description": "Outputs a localized time phrase relative to the current date and time.\n---\n",
@@ -2801,55 +2975,51 @@
       ]
     },
     {
-      "name": "sl-radio-button",
-      "description": "Radios buttons allow the user to select a single option from a group using a button-like control.\n---\n\n\n### **Events:**\n - **sl-blur** - Emitted when the button loses focus.\n- **sl-focus** - Emitted when the button gains focus.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the radio button.\n- **blur()** - Removes focus from the radio button.\n\n### **Slots:**\n - _default_ - The radio button's label.\n- **prefix** - A presentational prefix icon or similar element.\n- **suffix** - A presentational suffix icon or similar element.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **button** - The internal `<button>` element.\n- **button--checked** - The internal button element when the radio button is checked.\n- **prefix** - The container that wraps the prefix.\n- **label** - The container that wraps the radio button's label.\n- **suffix** - The container that wraps the suffix.",
+      "name": "sl-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": "value",
-          "description": "The radio's value. When selected, the radio group will receive this value.",
-          "values": []
-        },
         {
           "name": "disabled",
-          "description": "Disables the radio button.",
-          "values": []
-        },
-        {
-          "name": "size",
-          "description": "The radio button's size. When used inside a radio group, the size will be determined by the radio group's size so\nthis attribute can typically be omitted.",
-          "values": [
-            { "name": "small" },
-            { "name": "medium" },
-            { "name": "large" }
-          ]
-        },
-        {
-          "name": "pill",
-          "description": "Draws a pill-style radio button with rounded edges.",
+          "description": "Disables the observer.",
           "values": []
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/radio-button"
+          "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"
         }
       ]
     },
@@ -2891,34 +3061,47 @@
       ]
     },
     {
-      "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-segmented",
+      "description": "\n---\n",
       "attributes": [
         {
-          "name": "gutter",
-          "description": "Spacing between columns, can be a number or responsive object",
-          "values": [{ "name": "Gutter" }, { "name": "[Gutter, Gutter]" }]
+          "name": "options",
+          "values": [{ "name": "(string" }, { "name": "SegmentedItem)[]" }]
         },
+        { "name": "value", "values": [{ "name": "SegmentedValue" }] },
         {
-          "name": "align",
-          "description": "Vertical alignment of columns",
-          "values": [{ "name": "RowAlign" }]
+          "name": "defaultValue",
+          "description": "非受控模式下的默认选中值",
+          "values": [{ "name": "SegmentedValue" }]
         },
+        { "name": "disabled", "values": [] },
         {
-          "name": "justify",
-          "description": "Horizontal arrangement of columns",
-          "values": [{ "name": "RowJustify" }]
+          "name": "orientation",
+          "values": [{ "name": "horizontal" }, { "name": "vertical" }]
         },
         {
-          "name": "wrap",
-          "description": "Whether to wrap columns",
+          "name": "shape",
+          "values": [{ "name": "default" }, { "name": "round" }]
+        },
+        {
+          "name": "size",
+          "values": [
+            { "name": "large" },
+            { "name": "medium" },
+            { "name": "small" }
+          ]
+        },
+        { "name": "block", "values": [] },
+        {
+          "name": "name",
+          "description": "分组名称，用于原生 radio 归组和键盘导航",
           "values": []
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/row"
+          "url": "https://shoelace.style/components/segmented"
         }
       ]
     },
@@ -3118,85 +3301,6 @@
         }
       ]
     },
-    {
-      "name": "sl-sender-header",
-      "description": "A collapsible header panel for the Sender component.\n---\n\n\n### **Events:**\n - **sl-open-change** - Emitted when the open state changes. `event.detail.open` indicates the new state.\n\n### **Slots:**\n - _default_ - The panel content (children).\n- **title** - The header title content. Alternatively use the `title` attribute for plain text.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **header** - The header bar containing title and close button.\n- **title** - The title wrapper inside the header.\n- **content** - The collapsible content area.",
-      "attributes": [
-        {
-          "name": "open",
-          "description": "Whether the panel content is expanded.",
-          "values": []
-        },
-        {
-          "name": "closable",
-          "description": "Whether the close/toggle button is shown.",
-          "values": []
-        },
-        {
-          "name": "title",
-          "description": "Plain-text title. Use the `title` slot for rich content.",
-          "values": []
-        },
-        {
-          "name": "force-render",
-          "description": "When true, the content DOM is always rendered even when collapsed.\nUseful when you need refs to inner elements on initial mount.\nWhen false (default), content is removed from the DOM when closed.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/sender-header"
-        }
-      ]
-    },
-    {
-      "name": "sl-segmented",
-      "description": "\n---\n",
-      "attributes": [
-        {
-          "name": "options",
-          "description": "选项列表，支持字符串、数字或对象数组",
-          "values": [{ "name": "(string" }, { "name": "SegmentedItem)[]" }]
-        },
-        {
-          "name": "value",
-          "description": "当前选中值",
-          "values": [{ "name": "SegmentedValue" }]
-        },
-        { "name": "disabled", "description": "是否禁用整个组件", "values": [] },
-        {
-          "name": "orientation",
-          "description": "排列方向",
-          "values": [{ "name": "horizontal" }, { "name": "vertical" }]
-        },
-        {
-          "name": "shape",
-          "description": "形状样式",
-          "values": [{ "name": "default" }, { "name": "round" }]
-        },
-        {
-          "name": "size",
-          "description": "尺寸",
-          "values": [
-            { "name": "large" },
-            { "name": "medium" },
-            { "name": "small" }
-          ]
-        },
-        {
-          "name": "block",
-          "description": "是否撑满父容器，选项平分宽度",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/segmented"
-        }
-      ]
-    },
     {
       "name": "sl-sender-switch",
       "description": "A toggle switch button for the Sender component, supporting checked/unchecked states\nwith optional distinct content for each state.\n---\n\n\n### **Events:**\n - **sl-change** - Emitted when the switch's checked state changes. Read `el.checked` for the new state.\n\n### **Slots:**\n - _default_ - The switch's default content (always shown).\n- **icon** - The switch's icon.\n- **checked** - Content shown only when checked.\n- **unchecked** - Content shown only when unchecked.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper (the button element).",
@@ -3229,27 +3333,6 @@
         }
       ]
     },
-    {
-      "name": "sl-skeleton",
-      "description": "Skeletons are used to provide a visual representation of where content will eventually be drawn.\n---\n\n\n### **CSS Properties:**\n - **--border-radius** - The skeleton's border radius. _(default: undefined)_\n- **--color** - The color of the skeleton. _(default: undefined)_\n- **--sheen-color** - The sheen color when the skeleton is in its loading state. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **indicator** - The skeleton's indicator which is responsible for its color and animation.",
-      "attributes": [
-        {
-          "name": "effect",
-          "description": "Determines which effect the skeleton will use.",
-          "values": [
-            { "name": "pulse" },
-            { "name": "sheen" },
-            { "name": "none" }
-          ]
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/skeleton"
-        }
-      ]
-    },
     {
       "name": "sl-space",
       "description": "Space 组件用于设置组件之间的间距。\n---\n\n\n### **Slots:**\n - _default_ - 需要添加间距的子元素。\n\n### **CSS Properties:**\n - **--gap** - 自定义间距大小。 _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - 组件的基础容器。\n- **item** - 每个子元素的包装容器。\n- **separator** - 分隔符容器。",
@@ -3287,7 +3370,39 @@
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/space"
+          "url": "https://shoelace.style/components/space"
+        }
+      ]
+    },
+    {
+      "name": "sl-skeleton",
+      "description": "Skeletons are used to provide a visual representation of where content will eventually be drawn.\n---\n\n\n### **CSS Properties:**\n - **--border-radius** - The skeleton's border radius. _(default: undefined)_\n- **--color** - The color of the skeleton. _(default: undefined)_\n- **--sheen-color** - The sheen color when the skeleton is in its loading state. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **indicator** - The skeleton's indicator which is responsible for its color and animation.",
+      "attributes": [
+        {
+          "name": "effect",
+          "description": "Determines which effect the skeleton will use.",
+          "values": [
+            { "name": "pulse" },
+            { "name": "sheen" },
+            { "name": "none" }
+          ]
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/skeleton"
+        }
+      ]
+    },
+    {
+      "name": "sl-spinner",
+      "description": "Spinners are used to show the progress of an indeterminate operation.\n---\n\n\n### **CSS Properties:**\n - **--track-width** - The width of the track. _(default: undefined)_\n- **--track-color** - The color of the track. _(default: undefined)_\n- **--indicator-color** - The color of the spinner's indicator. _(default: undefined)_\n- **--speed** - The time it takes for the spinner to complete one animation cycle. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+      "attributes": [],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/spinner"
         }
       ]
     },
@@ -3406,13 +3521,34 @@
       ]
     },
     {
-      "name": "sl-spinner",
-      "description": "Spinners are used to show the progress of an indeterminate operation.\n---\n\n\n### **CSS Properties:**\n - **--track-width** - The width of the track. _(default: undefined)_\n- **--track-color** - The color of the track. _(default: undefined)_\n- **--indicator-color** - The color of the spinner's indicator. _(default: undefined)_\n- **--speed** - The time it takes for the spinner to complete one animation cycle. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
-      "attributes": [],
+      "name": "sl-sender-header",
+      "description": "A collapsible header panel for the Sender component.\n---\n\n\n### **Events:**\n - **sl-open-change** - Emitted when the open state changes. `event.detail.open` indicates the new state.\n\n### **Slots:**\n - _default_ - The panel content (children).\n- **title** - The header title content. Alternatively use the `title` attribute for plain text.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **header** - The header bar containing title and close button.\n- **title** - The title wrapper inside the header.\n- **content** - The collapsible content area.",
+      "attributes": [
+        {
+          "name": "open",
+          "description": "Whether the panel content is expanded.",
+          "values": []
+        },
+        {
+          "name": "closable",
+          "description": "Whether the close/toggle button is shown.",
+          "values": []
+        },
+        {
+          "name": "title",
+          "description": "Plain-text title. Use the `title` slot for rich content.",
+          "values": []
+        },
+        {
+          "name": "force-render",
+          "description": "When true, the content DOM is always rendered even when collapsed.\nUseful when you need refs to inner elements on initial mount.\nWhen false (default), content is removed from the DOM when closed.",
+          "values": []
+        }
+      ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/spinner"
+          "url": "https://shoelace.style/components/sender-header"
         }
       ]
     },
@@ -3505,43 +3641,6 @@
         }
       ]
     },
-    {
-      "name": "sl-tab-group",
-      "description": "Tab groups organize content into a container that shows one section at a time.\n---\n\n\n### **Events:**\n - **sl-tab-show** - Emitted when a tab is shown.\n- **sl-tab-hide** - Emitted when a tab is hidden.\n\n### **Methods:**\n - **show(panel: _string_)** - Shows the specified tab panel.\n\n### **Slots:**\n - _default_ - Used for grouping tab panels in the tab group. Must be `<sl-tab-panel>` elements.\n- **nav** - Used for grouping tabs in the tab group. Must be `<sl-tab>` elements.\n\n### **CSS Properties:**\n - **--indicator-color** - The color of the active tab indicator. _(default: undefined)_\n- **--track-color** - The color of the indicator's track (the line that separates tabs from panels). _(default: undefined)_\n- **--track-width** - The width of the indicator's track (the line that separates tabs from panels). _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **nav** - The tab group's navigation container where tabs are slotted in.\n- **tabs** - The container that wraps the tabs.\n- **active-tab-indicator** - The line that highlights the currently selected tab.\n- **body** - The tab group's body where tab panels are slotted in.\n- **scroll-button** - The previous/next scroll buttons that show when tabs are scrollable, an `<sl-icon-button>`.\n- **scroll-button--start** - The starting scroll button.\n- **scroll-button--end** - The ending scroll button.\n- **scroll-button__base** - The scroll button's exported `base` part.",
-      "attributes": [
-        {
-          "name": "placement",
-          "description": "The placement of the tabs.",
-          "values": [
-            { "name": "top" },
-            { "name": "bottom" },
-            { "name": "start" },
-            { "name": "end" }
-          ]
-        },
-        {
-          "name": "activation",
-          "description": "When set to auto, navigating tabs with the arrow keys will instantly show the corresponding tab panel. When set to\nmanual, the tab will receive focus but will not show until the user presses spacebar or enter.",
-          "values": [{ "name": "auto" }, { "name": "manual" }]
-        },
-        {
-          "name": "no-scroll-controls",
-          "description": "Disables the scroll arrows that appear when tabs overflow.",
-          "values": []
-        },
-        {
-          "name": "fixed-scroll-controls",
-          "description": "Prevent scroll buttons from being hidden when inactive.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/tab-group"
-        }
-      ]
-    },
     {
       "name": "sl-tab-panel",
       "description": "Tab panels are used inside [tab groups](/components/tab-group) to display tabbed content.\n---\n\n\n### **Slots:**\n - _default_ - The tab panel's content.\n\n### **CSS Properties:**\n - **--padding** - The tab panel's padding. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -3660,49 +3759,6 @@
         }
       ]
     },
-    {
-      "name": "sl-tag",
-      "description": "Tags are used as labels to organize things or to indicate a selection.\n---\n\n\n### **Events:**\n - **sl-remove** - Emitted when the remove button is activated.\n\n### **Slots:**\n - _default_ - The tag's content.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **content** - The tag's content.\n- **remove-button** - The tag's remove button, an `<sl-icon-button>`.\n- **remove-button__base** - The remove button's exported `base` part.",
-      "attributes": [
-        {
-          "name": "variant",
-          "description": "The tag's theme variant.",
-          "values": [
-            { "name": "primary" },
-            { "name": "success" },
-            { "name": "neutral" },
-            { "name": "warning" },
-            { "name": "danger" },
-            { "name": "text" }
-          ]
-        },
-        {
-          "name": "size",
-          "description": "The tag's size.",
-          "values": [
-            { "name": "small" },
-            { "name": "medium" },
-            { "name": "large" }
-          ]
-        },
-        {
-          "name": "pill",
-          "description": "Draws a pill-style tag with rounded edges.",
-          "values": []
-        },
-        {
-          "name": "removable",
-          "description": "Makes the tag removable and shows a remove button.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/tag"
-        }
-      ]
-    },
     {
       "name": "sl-textarea",
       "description": "Textareas collect data from the user and allow multiple lines of text.\n---\n\n\n### **Events:**\n - **sl-blur** - Emitted when the control loses focus.\n- **sl-change** - Emitted when an alteration to the control's value is committed by the user.\n- **sl-focus** - Emitted when the control gains focus.\n- **sl-input** - Emitted when the control receives input.\n- **sl-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the textarea.\n- **blur()** - Removes focus from the textarea.\n- **select()** - Selects all the text in the textarea.\n- **scrollPosition(position: _{ top?: number; left?: number }_): _{ top: number; left: number } | undefined_** - Gets or sets the textarea's scroll position.\n- **setSelectionRange(selectionStart: _number_, selectionEnd: _number_, selectionDirection: _'forward' | 'backward' | 'none'_)** - Sets the start and end positions of the text selection (0-based).\n- **setRangeText(replacement: _string_, start: _number_, end: _number_, selectMode: _'select' | 'start' | 'end' | 'preserve'_)** - Replaces a range of text with a new string.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - **label** - The textarea's label. Alternatively, you can use the `label` attribute.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The input's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **base** - The component's base wrapper.\n- **textarea** - The internal `<textarea>` control.",
@@ -3858,6 +3914,43 @@
         }
       ]
     },
+    {
+      "name": "sl-tab-group",
+      "description": "Tab groups organize content into a container that shows one section at a time.\n---\n\n\n### **Events:**\n - **sl-tab-show** - Emitted when a tab is shown.\n- **sl-tab-hide** - Emitted when a tab is hidden.\n\n### **Methods:**\n - **show(panel: _string_)** - Shows the specified tab panel.\n\n### **Slots:**\n - _default_ - Used for grouping tab panels in the tab group. Must be `<sl-tab-panel>` elements.\n- **nav** - Used for grouping tabs in the tab group. Must be `<sl-tab>` elements.\n\n### **CSS Properties:**\n - **--indicator-color** - The color of the active tab indicator. _(default: undefined)_\n- **--track-color** - The color of the indicator's track (the line that separates tabs from panels). _(default: undefined)_\n- **--track-width** - The width of the indicator's track (the line that separates tabs from panels). _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **nav** - The tab group's navigation container where tabs are slotted in.\n- **tabs** - The container that wraps the tabs.\n- **active-tab-indicator** - The line that highlights the currently selected tab.\n- **body** - The tab group's body where tab panels are slotted in.\n- **scroll-button** - The previous/next scroll buttons that show when tabs are scrollable, an `<sl-icon-button>`.\n- **scroll-button--start** - The starting scroll button.\n- **scroll-button--end** - The ending scroll button.\n- **scroll-button__base** - The scroll button's exported `base` part.",
+      "attributes": [
+        {
+          "name": "placement",
+          "description": "The placement of the tabs.",
+          "values": [
+            { "name": "top" },
+            { "name": "bottom" },
+            { "name": "start" },
+            { "name": "end" }
+          ]
+        },
+        {
+          "name": "activation",
+          "description": "When set to auto, navigating tabs with the arrow keys will instantly show the corresponding tab panel. When set to\nmanual, the tab will receive focus but will not show until the user presses spacebar or enter.",
+          "values": [{ "name": "auto" }, { "name": "manual" }]
+        },
+        {
+          "name": "no-scroll-controls",
+          "description": "Disables the scroll arrows that appear when tabs overflow.",
+          "values": []
+        },
+        {
+          "name": "fixed-scroll-controls",
+          "description": "Prevent scroll buttons from being hidden when inactive.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/tab-group"
+        }
+      ]
+    },
     {
       "name": "sl-think",
       "description": "Think is used to display an AI model's thinking process with expandable/collapsible content.\n---\n\n\n### **Events:**\n - **sl-expand** - Emitted when the think block starts expanding (before animation). Equivalent to React's `onExpand(true)`.\n- **sl-collapse** - Emitted when the think block starts collapsing (before animation). Equivalent to React's `onExpand(false)`.\n\n### **Methods:**\n - **handleExpandedChange()** - Runs AFTER the first render whenever `expanded` changes.\nEmits the appropriate event immediately (matching React's `onExpand` timing,\nwhich fires before the animation), then plays the expand/collapse animation.\n\n### **Slots:**\n - _default_ - The thinking content body.\n- **title** - Rich HTML content for the status bar title. Overrides the `title` attribute.\n- **icon** - A custom icon displayed in the status bar when not loading. Defaults to the Think icon.\n- **loading-icon** - A custom icon displayed when `loading` is true. Overrides the default spinner. This is the web-component equivalent of passing a ReactNode to the React `loading` prop.\n\n### **CSS Properties:**\n - **--sl-c-think-TitleTextBlink-color-default** - Base text color shown during the blink/shimmer animation. Equivalent to React's `colorTextBlinkDefault` (`colorTextDescription`) design token. Defaults to `var(--sl-color-neutral-600)`. _(default: undefined)_\n- **--sl-c-think-TitleTextBlink-color** - Highlight (shine) color of the blink shimmer beam. Equivalent to React's `colorTextBlink` (`colorTextBase`) design token. Defaults to `var(--sl-color-neutral-900)`. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper (maps to React's `root` semantic DOM).\n- **status** - The clickable status bar: icon + title + chevron (maps to React's `status` semantic DOM).\n- **status-icon** - The icon container within the status bar.\n- **status-text** - The title text area within the status bar.\n- **chevron** - The expand/collapse chevron indicator.\n- **body** - The collapsible body container.\n- **content** - The content area inside the body (maps to React's `content` semantic DOM).",
@@ -3974,6 +4067,49 @@
         }
       ]
     },
+    {
+      "name": "sl-tag",
+      "description": "Tags are used as labels to organize things or to indicate a selection.\n---\n\n\n### **Events:**\n - **sl-remove** - Emitted when the remove button is activated.\n\n### **Slots:**\n - _default_ - The tag's content.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **content** - The tag's content.\n- **remove-button** - The tag's remove button, an `<sl-icon-button>`.\n- **remove-button__base** - The remove button's exported `base` part.",
+      "attributes": [
+        {
+          "name": "variant",
+          "description": "The tag's theme variant.",
+          "values": [
+            { "name": "primary" },
+            { "name": "success" },
+            { "name": "neutral" },
+            { "name": "warning" },
+            { "name": "danger" },
+            { "name": "text" }
+          ]
+        },
+        {
+          "name": "size",
+          "description": "The tag's size.",
+          "values": [
+            { "name": "small" },
+            { "name": "medium" },
+            { "name": "large" }
+          ]
+        },
+        {
+          "name": "pill",
+          "description": "Draws a pill-style tag with rounded edges.",
+          "values": []
+        },
+        {
+          "name": "removable",
+          "description": "Makes the tag removable and shows a remove button.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/tag"
+        }
+      ]
+    },
     {
       "name": "sl-thought-chain-node",
       "description": "A single node in a thought chain. Used as a child of `<sl-thought-chain>`.\nEach node represents one step/action in the chain with an icon, title, description,\ncollapsible content, and footer.\n---\n\n\n### **Slots:**\n - _default_ - The node's main content (shown in the collapsible area).\n- **icon** - Custom icon to display instead of the default numbered circle or status icon.\n- **title** - The node's title. Alternatively, use the `title` attribute.\n- **description** - The node's description text.\n- **footer** - Footer content displayed below the content area.\n\n### **CSS Parts:**\n - **base** - The node's base wrapper.\n- **icon** - The icon container.\n- **header** - The header section (title + description).\n- **title** - The title area (clickable when collapsible).\n- **description** - The description area.\n- **content** - The collapsible content wrapper.\n- **content-inner** - The inner content wrapper.\n- **footer** - The footer area.\n- **collapse-icon** - The chevron expand/collapse indicator.",
@@ -4313,6 +4449,94 @@
         }
       ]
     },
+    {
+      "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** - 上传中项目的进度条容器。",
+      "attributes": [
+        {
+          "name": "action",
+          "description": "上传文件的目标 URL。",
+          "values": []
+        },
+        {
+          "name": "method",
+          "description": "上传请求的 HTTP 方法。",
+          "values": [{ "name": "POST" }, { "name": "PUT" }, { "name": "PATCH" }]
+        },
+        {
+          "name": "name",
+          "description": "文件输入的 name 属性（用作 FormData 的键名）。",
+          "values": []
+        },
+        {
+          "name": "accept",
+          "description": "接受的文件类型（与原生 input 的 accept 属性相同）。",
+          "values": []
+        },
+        {
+          "name": "multiple",
+          "description": "是否允许选择多个文件。",
+          "values": []
+        },
+        {
+          "name": "directory",
+          "description": "是否支持目录上传。",
+          "values": []
+        },
+        { "name": "disabled", "description": "是否禁用上传。", "values": [] },
+        {
+          "name": "type",
+          "description": "上传类型：'select' 为点击选择，'drag' 为拖放上传。",
+          "values": [{ "name": "UploadType" }]
+        },
+        {
+          "name": "list-type",
+          "description": "文件列表的展示类型。",
+          "values": [{ "name": "UploadListType" }]
+        },
+        {
+          "name": "max-count",
+          "description": "允许上传的最大文件数。设置为 1 时，新文件将替换旧文件。",
+          "values": []
+        },
+        {
+          "name": "show-upload-list",
+          "description": "是否显示上传列表，或传入对象来配置显示的图标。\n设为 `false` 时隐藏文件列表。\n设为 `true`（默认）时，所有图标使用默认行为。\n设为对象时，可单独控制 `showPreviewIcon`、`showRemoveIcon` 和 `showDownloadIcon`。\n作为 HTML 属性使用时为 `show-upload-list`（布尔值）。对象配置需通过 JavaScript 属性设置。",
+          "values": [{ "name": "ShowUploadListInterface" }]
+        },
+        {
+          "name": "open-file-dialog-on-click",
+          "description": "是否点击触发区域时打开文件选择对话框。",
+          "values": []
+        },
+        {
+          "name": "pastable",
+          "description": "是否支持粘贴上传文件。启用后会监听 document 的 paste 事件。",
+          "values": []
+        },
+        {
+          "name": "with-credentials",
+          "description": "上传请求是否携带 Cookie。",
+          "values": []
+        },
+        {
+          "name": "headers",
+          "description": "上传请求的额外请求头。",
+          "values": [{ "name": "Record<string" }, { "name": "string>" }]
+        },
+        {
+          "name": "data",
+          "description": "上传请求附带的额外数据。",
+          "values": [{ "name": "Record<string" }, { "name": "unknown>" }]
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/upload"
+        }
+      ]
+    },
     {
       "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.",