@kdcloudjs/shoelace 1.0.33 → 1.0.34

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

@@ -73,35 +73,43 @@
       ]
     },
     {
-      "name": "sl-badge",
-      "description": "Badges are used to draw attention and display statuses or counts.\n---\n\n\n### **Slots:**\n - _default_ - The badge's content.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+      "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": "variant",
-          "description": "The badge's theme variant.",
-          "values": [
-            { "name": "primary" },
-            { "name": "success" },
-            { "name": "neutral" },
-            { "name": "warning" },
-            { "name": "danger" }
-          ]
+          "name": "image",
+          "description": "The image source to use for the avatar.",
+          "values": []
         },
         {
-          "name": "pill",
-          "description": "Draws a pill-style badge with rounded edges.",
+          "name": "label",
+          "description": "A label to use to describe the avatar to assistive devices.",
           "values": []
         },
         {
-          "name": "pulse",
-          "description": "Makes the badge pulsate to draw attention.",
+          "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/badge"
+          "url": "https://shoelace.style/components/avatar"
         }
       ]
     },
@@ -173,43 +181,52 @@
       ]
     },
     {
-      "name": "sl-avatar",
-      "description": "Avatars are used to represent a person or object.\n---\n\n\n### **Events:**\n - **sl-error** - The image could not be loaded. This may because of an invalid URL, a temporary network condition, or some unknown cause.\n\n### **Slots:**\n - **icon** - The default icon to use when no image or initials are present. Works best with `<sl-icon>`.\n\n### **CSS Properties:**\n - **--size** - The size of the avatar. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **icon** - The container that wraps the avatar's icon.\n- **initials** - The container that wraps the avatar's initials.\n- **image** - The avatar image. Only shown when the `image` attribute is set.",
+      "name": "sl-badge",
+      "description": "Badges are used to draw attention and display statuses or counts.\n---\n\n\n### **Slots:**\n - _default_ - The badge's content.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
       "attributes": [
         {
-          "name": "image",
-          "description": "The image source to use for the avatar.",
-          "values": []
+          "name": "variant",
+          "description": "The badge's theme variant.",
+          "values": [
+            { "name": "primary" },
+            { "name": "success" },
+            { "name": "neutral" },
+            { "name": "warning" },
+            { "name": "danger" }
+          ]
         },
         {
-          "name": "label",
-          "description": "A label to use to describe the avatar to assistive devices.",
+          "name": "pill",
+          "description": "Draws a pill-style badge with rounded edges.",
           "values": []
         },
         {
-          "name": "initials",
-          "description": "Initials to use as a fallback when no image is available (1-2 characters max recommended).",
+          "name": "pulse",
+          "description": "Makes the badge pulsate to draw attention.",
           "values": []
-        },
+        }
+      ],
+      "references": [
         {
-          "name": "loading",
-          "description": "Indicates how the browser should load the image.",
-          "values": [{ "name": "eager" }, { "name": "lazy" }]
-        },
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/badge"
+        }
+      ]
+    },
+    {
+      "name": "sl-breadcrumb",
+      "description": "Breadcrumbs provide a group of links so users can easily navigate a website's hierarchy.\n---\n\n\n### **Slots:**\n - _default_ - One or more breadcrumb items to display.\n- **separator** - The separator to use between breadcrumb items. Works best with `<sl-icon>`.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+      "attributes": [
         {
-          "name": "shape",
-          "description": "The shape of the avatar.",
-          "values": [
-            { "name": "circle" },
-            { "name": "square" },
-            { "name": "rounded" }
-          ]
+          "name": "label",
+          "description": "The label to use for the breadcrumb control. This will not be shown on the screen, but it will be announced by\nscreen readers and other assistive devices to provide more context for users.",
+          "values": []
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/avatar"
+          "url": "https://shoelace.style/components/breadcrumb"
         }
       ]
     },
@@ -245,23 +262,6 @@
         }
       ]
     },
-    {
-      "name": "sl-breadcrumb",
-      "description": "Breadcrumbs provide a group of links so users can easily navigate a website's hierarchy.\n---\n\n\n### **Slots:**\n - _default_ - One or more breadcrumb items to display.\n- **separator** - The separator to use between breadcrumb items. Works best with `<sl-icon>`.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
-      "attributes": [
-        {
-          "name": "label",
-          "description": "The label to use for the breadcrumb control. This will not be shown on the screen, but it will be announced by\nscreen readers and other assistive devices to provide more context for users.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/breadcrumb"
-        }
-      ]
-    },
     {
       "name": "sl-button",
       "description": "Buttons represent actions that are available to the user.\n---\n\n\n### **Events:**\n - **sl-blur** - Emitted when the button loses focus.\n- **sl-focus** - Emitted when the button gains focus.\n- **sl-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **click()** - Simulates a click on the button.\n- **focus(options: _FocusOptions_)** - Sets focus on the button.\n- **blur()** - Removes focus from the button.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - _default_ - The button's label.\n- **prefix** - A presentational prefix icon or similar element.\n- **suffix** - A presentational suffix icon or similar element.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **prefix** - The container that wraps the prefix.\n- **label** - The button's label.\n- **suffix** - The container that wraps the suffix.\n- **caret** - The button's caret icon, an `<sl-icon>` element.\n- **spinner** - The spinner that shows when the button is in the loading state.",
@@ -410,6 +410,45 @@
         }
       ]
     },
+    {
+      "name": "sl-button-group",
+      "description": "Button groups can be used to group related buttons into sections.\n---\n\n\n### **Slots:**\n - _default_ - One or more `<sl-button>` elements to display in the button group.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+      "attributes": [
+        {
+          "name": "label",
+          "description": "A label to use for the button group. This won't be displayed on the screen, but it will be announced by assistive\ndevices when interacting with the control and is strongly recommended.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/button-group"
+        }
+      ]
+    },
+    {
+      "name": "sl-card",
+      "description": "Cards can be used to group related subjects in a container.\n---\n\n\n### **Slots:**\n - _default_ - The card's main content.\n- **header** - An optional header for the card.\n- **footer** - An optional footer for the card.\n- **image** - An optional image to render at the start of the card.\n\n### **CSS Properties:**\n - **--border-color** - The card's border color, including borders that occur inside the card. _(default: undefined)_\n- **--border-radius** - The border radius for the card's edges. _(default: undefined)_\n- **--border-width** - The width of the card's borders. _(default: undefined)_\n- **--padding** - The padding to use for the card's sections. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **image** - The container that wraps the card's image.\n- **header** - The container that wraps the card's header.\n- **body** - The container that wraps the card's main content.\n- **footer** - The container that wraps the card's footer.",
+      "attributes": [],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/card"
+        }
+      ]
+    },
+    {
+      "name": "sl-carousel-item",
+      "description": "A carousel item represent a slide within a [carousel](/components/carousel).\n---\n\n\n### **Slots:**\n - _default_ - The carousel item's content..\n\n### **CSS Properties:**\n - **--aspect-ratio** - The slide's aspect ratio. Inherited from the carousel by default. _(default: undefined)_",
+      "attributes": [],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/carousel-item"
+        }
+      ]
+    },
     {
       "name": "sl-carousel",
       "description": "Carousels display an arbitrary number of content slides along a horizontal or vertical axis.\n---\n\n\n### **Events:**\n - **sl-slide-change** - Emitted when the active slide changes.\n\n### **Methods:**\n - **previous(behavior: _ScrollBehavior_)** - Move the carousel backward by `slides-per-move` slides.\n- **next(behavior: _ScrollBehavior_)** - Move the carousel forward by `slides-per-move` slides.\n- **goToSlide(index: _number_, behavior: _ScrollBehavior_)** - Scrolls the carousel to the slide specified by `index`.\n\n### **Slots:**\n - _default_ - The carousel's main content, one or more `<sl-carousel-item>` elements.\n- **next-icon** - Optional next icon to use instead of the default. Works best with `<sl-icon>`.\n- **previous-icon** - Optional previous icon to use instead of the default. Works best with `<sl-icon>`.\n\n### **CSS Properties:**\n - **--slide-gap** - The space between each slide. _(default: undefined)_\n- **--aspect-ratio** - The aspect ratio of each slide. _(default: 16/9)_\n- **--scroll-hint** - The amount of padding to apply to the scroll area, allowing adjacent slides to become partially visible as a scroll hint. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The carousel's internal wrapper.\n- **scroll-container** - The scroll container that wraps the slides.\n- **pagination** - The pagination indicators wrapper.\n- **pagination-item** - The pagination indicator.\n- **pagination-item--active** - Applied when the item is active.\n- **navigation** - The navigation wrapper.\n- **navigation-button** - The navigation button.\n- **navigation-button--previous** - Applied to the previous button.\n- **navigation-button--next** - Applied to the next button.",
@@ -467,45 +506,6 @@
         }
       ]
     },
-    {
-      "name": "sl-button-group",
-      "description": "Button groups can be used to group related buttons into sections.\n---\n\n\n### **Slots:**\n - _default_ - One or more `<sl-button>` elements to display in the button group.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
-      "attributes": [
-        {
-          "name": "label",
-          "description": "A label to use for the button group. This won't be displayed on the screen, but it will be announced by assistive\ndevices when interacting with the control and is strongly recommended.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/button-group"
-        }
-      ]
-    },
-    {
-      "name": "sl-card",
-      "description": "Cards can be used to group related subjects in a container.\n---\n\n\n### **Slots:**\n - _default_ - The card's main content.\n- **header** - An optional header for the card.\n- **footer** - An optional footer for the card.\n- **image** - An optional image to render at the start of the card.\n\n### **CSS Properties:**\n - **--border-color** - The card's border color, including borders that occur inside the card. _(default: undefined)_\n- **--border-radius** - The border radius for the card's edges. _(default: undefined)_\n- **--border-width** - The width of the card's borders. _(default: undefined)_\n- **--padding** - The padding to use for the card's sections. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **image** - The container that wraps the card's image.\n- **header** - The container that wraps the card's header.\n- **body** - The container that wraps the card's main content.\n- **footer** - The container that wraps the card's footer.",
-      "attributes": [],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/card"
-        }
-      ]
-    },
-    {
-      "name": "sl-carousel-item",
-      "description": "A carousel item represent a slide within a [carousel](/components/carousel).\n---\n\n\n### **Slots:**\n - _default_ - The carousel item's content..\n\n### **CSS Properties:**\n - **--aspect-ratio** - The slide's aspect ratio. Inherited from the carousel by default. _(default: undefined)_",
-      "attributes": [],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/carousel-item"
-        }
-      ]
-    },
     {
       "name": "sl-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.",
@@ -1130,44 +1130,116 @@
       ]
     },
     {
-      "name": "sl-format-bytes",
-      "description": "Formats a number as a human readable bytes value.\n---\n",
+      "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.",
       "attributes": [
         {
-          "name": "value",
-          "description": "The number to format in bytes.",
+          "name": "type",
+          "description": "The button's type.",
+          "values": [{ "name": "default" }, { "name": "primary" }]
+        },
+        {
+          "name": "shape",
+          "description": "The button's shape.",
+          "values": [{ "name": "circle" }, { "name": "square" }]
+        },
+        {
+          "name": "size",
+          "description": "The button's size.",
+          "values": [
+            { "name": "small" },
+            { "name": "medium" },
+            { "name": "large" }
+          ]
+        },
+        {
+          "name": "icon",
+          "description": "The name of the icon to display (from the registered icon library).",
           "values": []
         },
         {
-          "name": "unit",
-          "description": "The type of unit to display.",
-          "values": [{ "name": "byte" }, { "name": "bit" }]
+          "name": "tooltip",
+          "description": "Tooltip text shown on hover.",
+          "values": []
         },
         {
-          "name": "display",
-          "description": "Determines how to display the result, e.g. \"100 bytes\", \"100 b\", or \"100b\".",
+          "name": "tooltip-placement",
+          "description": "Tooltip placement.",
           "values": [
-            { "name": "long" },
-            { "name": "short" },
-            { "name": "narrow" }
+            { "name": "top" },
+            { "name": "right" },
+            { "name": "bottom" },
+            { "name": "left" }
           ]
+        },
+        {
+          "name": "disabled",
+          "description": "Disables the button.",
+          "values": []
+        },
+        {
+          "name": "href",
+          "description": "When set, the button will render as an anchor tag with this URL.",
+          "values": []
+        },
+        {
+          "name": "target",
+          "description": "Where to display the linked URL (only used when href is set).",
+          "values": []
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/format-bytes"
+          "url": "https://shoelace.style/components/float-button"
         }
       ]
     },
     {
-      "name": "sl-format-date",
-      "description": "Formats a date/time using the specified locale and options.\n---\n",
+      "name": "sl-float-button-group",
+      "description": "Groups multiple float buttons together, with optional menu trigger.\n---\n\n\n### **Events:**\n - **sl-show** - Emitted when the menu opens (menu mode only).\n- **sl-hide** - Emitted when the menu closes (menu mode only).\n\n### **Slots:**\n - _default_ - The float buttons to display.\n- **trigger-icon** - Custom icon for the trigger button.\n- **close-icon** - Custom icon shown when the menu is open.\n\n### **CSS Parts:**\n - **base** - The group's base wrapper.\n- **list** - The container for the float button items.\n- **trigger** - The trigger button (menu mode only).\n- **trigger-icon** - The trigger button's icon.",
       "attributes": [
         {
-          "name": "date",
-          "description": "The date/time to format. If not set, the current date and time will be used. When passing a string, it's strongly\nrecommended to use the ISO 8601 format to ensure timezones are handled correctly. To convert a date to this format\nin JavaScript, use [`date.toISOString()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString).",
-          "values": [{ "name": "Date" }]
+          "name": "shape",
+          "description": "The shape applied to all child float buttons.",
+          "values": [{ "name": "circle" }, { "name": "square" }]
+        },
+        {
+          "name": "trigger",
+          "description": "The trigger mode for menu. When set, shows a trigger button that toggles the menu.",
+          "values": [{ "name": "click" }, { "name": "hover" }, { "name": "''" }]
+        },
+        {
+          "name": "open",
+          "description": "Whether the menu is open (controlled mode, use with trigger).",
+          "values": []
+        },
+        {
+          "name": "placement",
+          "description": "The direction the menu items expand.",
+          "values": [
+            { "name": "top" },
+            { "name": "right" },
+            { "name": "bottom" },
+            { "name": "left" }
+          ]
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/float-button-group"
+        }
+      ]
+    },
+    {
+      "name": "sl-format-date",
+      "description": "Formats a date/time using the specified locale and options.\n---\n",
+      "attributes": [
+        {
+          "name": "date",
+          "description": "The date/time to format. If not set, the current date and time will be used. When passing a string, it's strongly\nrecommended to use the ISO 8601 format to ensure timezones are handled correctly. To convert a date to this format\nin JavaScript, use [`date.toISOString()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString).",
+          "values": [{ "name": "Date" }]
         },
         {
           "name": "weekday",
@@ -1246,6 +1318,37 @@
         }
       ]
     },
+    {
+      "name": "sl-format-bytes",
+      "description": "Formats a number as a human readable bytes value.\n---\n",
+      "attributes": [
+        {
+          "name": "value",
+          "description": "The number to format in bytes.",
+          "values": []
+        },
+        {
+          "name": "unit",
+          "description": "The type of unit to display.",
+          "values": [{ "name": "byte" }, { "name": "bit" }]
+        },
+        {
+          "name": "display",
+          "description": "Determines how to display the result, e.g. \"100 bytes\", \"100 b\", or \"100b\".",
+          "values": [
+            { "name": "long" },
+            { "name": "short" },
+            { "name": "narrow" }
+          ]
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/format-bytes"
+        }
+      ]
+    },
     {
       "name": "sl-format-number",
       "description": "Formats a number using the specified locale and options.\n---\n",
@@ -1350,105 +1453,19 @@
       ]
     },
     {
-      "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.",
-      "attributes": [
-        {
-          "name": "type",
-          "description": "The button's type.",
-          "values": [{ "name": "default" }, { "name": "primary" }]
-        },
-        {
-          "name": "shape",
-          "description": "The button's shape.",
-          "values": [{ "name": "circle" }, { "name": "square" }]
-        },
-        {
-          "name": "size",
-          "description": "The button's size.",
-          "values": [
-            { "name": "small" },
-            { "name": "medium" },
-            { "name": "large" }
-          ]
-        },
-        {
-          "name": "icon",
-          "description": "The name of the icon to display (from the registered icon library).",
-          "values": []
-        },
-        {
-          "name": "tooltip",
-          "description": "Tooltip text shown on hover.",
-          "values": []
-        },
-        {
-          "name": "tooltip-placement",
-          "description": "Tooltip placement.",
-          "values": [
-            { "name": "top" },
-            { "name": "right" },
-            { "name": "bottom" },
-            { "name": "left" }
-          ]
-        },
-        {
-          "name": "disabled",
-          "description": "Disables the button.",
-          "values": []
-        },
-        {
-          "name": "href",
-          "description": "When set, the button will render as an anchor tag with this URL.",
-          "values": []
-        },
-        {
-          "name": "target",
-          "description": "Where to display the linked URL (only used when href is set).",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/float-button"
-        }
-      ]
-    },
-    {
-      "name": "sl-float-button-group",
-      "description": "Groups multiple float buttons together, with optional menu trigger.\n---\n\n\n### **Events:**\n - **sl-show** - Emitted when the menu opens (menu mode only).\n- **sl-hide** - Emitted when the menu closes (menu mode only).\n\n### **Slots:**\n - _default_ - The float buttons to display.\n- **trigger-icon** - Custom icon for the trigger button.\n- **close-icon** - Custom icon shown when the menu is open.\n\n### **CSS Parts:**\n - **base** - The group's base wrapper.\n- **list** - The container for the float button items.\n- **trigger** - The trigger button (menu mode only).\n- **trigger-icon** - The trigger button's icon.",
+      "name": "sl-image-comparer",
+      "description": "Compare visual differences between similar photos with a sliding panel.\n---\n\n\n### **Events:**\n - **sl-change** - Emitted when the position changes.\n\n### **Slots:**\n - **before** - The before image, an `<img>` or `<svg>` element.\n- **after** - The after image, an `<img>` or `<svg>` element.\n- **handle** - The icon used inside the handle.\n\n### **CSS Properties:**\n - **--divider-width** - The width of the dividing line. _(default: undefined)_\n- **--handle-size** - The size of the compare handle. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **before** - The container that wraps the before image.\n- **after** - The container that wraps the after image.\n- **divider** - The divider that separates the images.\n- **handle** - The handle that the user drags to expose the after image.",
       "attributes": [
         {
-          "name": "shape",
-          "description": "The shape applied to all child float buttons.",
-          "values": [{ "name": "circle" }, { "name": "square" }]
-        },
-        {
-          "name": "trigger",
-          "description": "The trigger mode for menu. When set, shows a trigger button that toggles the menu.",
-          "values": [{ "name": "click" }, { "name": "hover" }, { "name": "''" }]
-        },
-        {
-          "name": "open",
-          "description": "Whether the menu is open (controlled mode, use with trigger).",
+          "name": "position",
+          "description": "The position of the divider as a percentage.",
           "values": []
-        },
-        {
-          "name": "placement",
-          "description": "The direction the menu items expand.",
-          "values": [
-            { "name": "top" },
-            { "name": "right" },
-            { "name": "bottom" },
-            { "name": "left" }
-          ]
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/float-button-group"
+          "url": "https://shoelace.style/components/image-comparer"
         }
       ]
     },
@@ -1509,23 +1526,6 @@
         }
       ]
     },
-    {
-      "name": "sl-image-comparer",
-      "description": "Compare visual differences between similar photos with a sliding panel.\n---\n\n\n### **Events:**\n - **sl-change** - Emitted when the position changes.\n\n### **Slots:**\n - **before** - The before image, an `<img>` or `<svg>` element.\n- **after** - The after image, an `<img>` or `<svg>` element.\n- **handle** - The icon used inside the handle.\n\n### **CSS Properties:**\n - **--divider-width** - The width of the dividing line. _(default: undefined)_\n- **--handle-size** - The size of the compare handle. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **before** - The container that wraps the before image.\n- **after** - The container that wraps the after image.\n- **divider** - The divider that separates the images.\n- **handle** - The handle that the user drags to expose the after image.",
-      "attributes": [
-        {
-          "name": "position",
-          "description": "The position of the divider as a percentage.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/image-comparer"
-        }
-      ]
-    },
     {
       "name": "sl-include",
       "description": "Includes give you the power to embed external HTML files into the page.\n---\n\n\n### **Events:**\n - **sl-load** - Emitted when the included file is loaded.\n- **sl-error** - Emitted when the included file fails to load due to an error.",
@@ -1557,6 +1557,54 @@
         }
       ]
     },
+    {
+      "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).",
+      "attributes": [
+        {
+          "name": "type",
+          "description": "The type of menu item to render. To use `checked`, this value must be set to `checkbox`.",
+          "values": [{ "name": "normal" }, { "name": "checkbox" }]
+        },
+        {
+          "name": "checked",
+          "description": "Draws the item in a checked state.",
+          "values": []
+        },
+        {
+          "name": "value",
+          "description": "A unique value to store in the menu item. This can be used as a way to identify menu items when selected.",
+          "values": []
+        },
+        {
+          "name": "loading",
+          "description": "Draws the menu item in a loading state.",
+          "values": []
+        },
+        {
+          "name": "disabled",
+          "description": "Draws the menu item in a disabled state, preventing selection.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/menu-item"
+        }
+      ]
+    },
     {
       "name": "sl-input",
       "description": "Inputs collect data from the user.\n---\n\n\n### **Events:**\n - **sl-blur** - Emitted when the control loses focus.\n- **sl-change** - Emitted when an alteration to the control's value is committed by the user.\n- **sl-clear** - Emitted when the clear button is activated.\n- **sl-focus** - Emitted when the control gains focus.\n- **sl-input** - Emitted when the control receives input.\n- **sl-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the input.\n- **blur()** - Removes focus from the input.\n- **select()** - Selects all the text in the input.\n- **setSelectionRange(selectionStart: _number_, selectionEnd: _number_, selectionDirection: _'forward' | 'backward' | 'none'_)** - Sets the start and end positions of the text selection (0-based).\n- **setRangeText(replacement: _string_, start: _number_, end: _number_, selectMode: _'select' | 'start' | 'end' | 'preserve'_)** - Replaces a range of text with a new string.\n- **showPicker()** - Displays the browser picker for an input element (only works if the browser supports it for the input type).\n- **stepUp()** - Increments the value of a numeric input type by the value of the step attribute.\n- **stepDown()** - Decrements the value of a numeric input type by the value of the step attribute.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - **label** - The input's label. Alternatively, you can use the `label` attribute.\n- **prefix** - Used to prepend a presentational icon or similar element to the input.\n- **suffix** - Used to append a presentational icon or similar element to the input.\n- **clear-icon** - An icon to use in lieu of the default clear icon.\n- **show-password-icon** - An icon to use in lieu of the default show password icon.\n- **hide-password-icon** - An icon to use in lieu of the default hide password icon.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The input's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **base** - The component's base wrapper.\n- **input** - The internal `<input>` control.\n- **prefix** - The container that wraps the prefix.\n- **clear-button** - The clear button.\n- **password-toggle-button** - The password toggle button.\n- **suffix** - The container that wraps the suffix.",
@@ -1766,54 +1814,6 @@
         }
       ]
     },
-    {
-      "name": "sl-menu",
-      "description": "Menus provide a list of options for the user to choose from.\n---\n\n\n### **Events:**\n - **sl-select** - Emitted when a menu item is selected.\n\n### **Slots:**\n - _default_ - The menu's content, including menu items, menu labels, and dividers.",
-      "attributes": [],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/menu"
-        }
-      ]
-    },
-    {
-      "name": "sl-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).",
-      "attributes": [
-        {
-          "name": "type",
-          "description": "The type of menu item to render. To use `checked`, this value must be set to `checkbox`.",
-          "values": [{ "name": "normal" }, { "name": "checkbox" }]
-        },
-        {
-          "name": "checked",
-          "description": "Draws the item in a checked state.",
-          "values": []
-        },
-        {
-          "name": "value",
-          "description": "A unique value to store in the menu item. This can be used as a way to identify menu items when selected.",
-          "values": []
-        },
-        {
-          "name": "loading",
-          "description": "Draws the menu item in a loading state.",
-          "values": []
-        },
-        {
-          "name": "disabled",
-          "description": "Draws the menu item in a disabled state, preventing selection.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/menu-item"
-        }
-      ]
-    },
     {
       "name": "sl-menu-label",
       "description": "Menu labels are used to describe a group of menu items.\n---\n\n\n### **Slots:**\n - _default_ - The menu label's content.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -1960,6 +1960,77 @@
         }
       ]
     },
+    {
+      "name": "sl-nav-submenu",
+      "description": "Nav submenus are used to group related nav items in a hierarchical structure.\n---\n\n\n### **Events:**\n - **sl-show** - Emitted when the submenu opens.\n- **sl-after-show** - Emitted after the submenu opens and all animations are complete.\n- **sl-hide** - Emitted when the submenu closes.\n- **sl-after-hide** - Emitted after the submenu closes and all animations are complete.\n\n### **Methods:**\n - **show(source: _'api' | 'nav' | 'user'_)** - Shows the submenu.\n- **hide(source: _'api' | 'nav' | 'user'_)** - Hides the submenu.\n\n### **Slots:**\n - _default_ - The nav items within the submenu.\n- **title** - The nav submenu's title.\n- **prefix** - Used to prepend an icon or similar element to the nav submenu.\n- **suffix** - Used to append an icon or similar element to the nav submenu.\n- **expand-icon** - Optional expand icon to use instead of the default. Works best with `<sl-icon>`.\n- **collapse-icon** - Optional collapse icon to use instead of the default. Works best with `<sl-icon>`.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **header** - The header that wraps the title, prefix, suffix and expand/collapse icon.\n- **prefix** - The prefix container.\n- **label** - The nav submenu label.\n- **suffix** - The suffix container.\n- **expand-icon** - The container that wraps the expand/collapse icons.\n- **content** - The nav submenu content.\n- **popup** - The popup that wraps the content in horizontal mode.",
+      "attributes": [
+        {
+          "name": "key",
+          "description": "A stable key used by `sl-nav` to track open state.",
+          "values": []
+        },
+        {
+          "name": "item-key",
+          "description": "React-safe alias for `key`.\n\nReact reserves `key` and won't forward it to custom elements, so wrapper users can pass `itemKey` instead.",
+          "values": []
+        },
+        {
+          "name": "open",
+          "description": "Indicates whether or not the submenu is open.",
+          "values": []
+        },
+        {
+          "name": "nested",
+          "description": "Indicates if this submenu is nested within another submenu.",
+          "values": []
+        },
+        {
+          "name": "title",
+          "description": "The summary to show in the header. If you need to display HTML, use the `title` slot instead.",
+          "values": []
+        },
+        {
+          "name": "theme",
+          "description": "Matches Antd's `theme` field.",
+          "values": [{ "name": "light" }, { "name": "dark" }]
+        },
+        {
+          "name": "popup-class-name",
+          "description": "Matches Antd's `popupClassName` field.",
+          "values": []
+        },
+        {
+          "name": "disabled",
+          "description": "Draws the submenu in a disabled state.",
+          "values": []
+        },
+        {
+          "name": "active",
+          "description": "Draws the submenu in an active (selected) state.",
+          "values": []
+        },
+        {
+          "name": "mode",
+          "description": "The mode of navigation.",
+          "values": [
+            { "name": "horizontal" },
+            { "name": "inline" },
+            { "name": "vertical" }
+          ]
+        },
+        {
+          "name": "collapsed",
+          "description": "Whether the parent nav is in inline-collapsed mode.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/nav-submenu"
+        }
+      ]
+    },
     {
       "name": "sl-nav-item",
       "description": "Nav items are the individual links or buttons within a navigation menu.\n---\n\n\n### **Events:**\n - **sl-nav-select** - Emitted when a nav item is selected.\n\n### **Slots:**\n - _default_ - The nav item's label.\n- **prefix** - Used to prepend an icon or similar element to the nav item.\n- **suffix** - Used to append an icon or similar element to the nav item.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **prefix** - The prefix container.\n- **label** - The nav item label.\n- **suffix** - The suffix container.",
@@ -2042,73 +2113,51 @@
       ]
     },
     {
-      "name": "sl-nav-submenu",
-      "description": "Nav submenus are used to group related nav items in a hierarchical structure.\n---\n\n\n### **Events:**\n - **sl-show** - Emitted when the submenu opens.\n- **sl-after-show** - Emitted after the submenu opens and all animations are complete.\n- **sl-hide** - Emitted when the submenu closes.\n- **sl-after-hide** - Emitted after the submenu closes and all animations are complete.\n\n### **Methods:**\n - **show(source: _'api' | 'nav' | 'user'_)** - Shows the submenu.\n- **hide(source: _'api' | 'nav' | 'user'_)** - Hides the submenu.\n\n### **Slots:**\n - _default_ - The nav items within the submenu.\n- **title** - The nav submenu's title.\n- **prefix** - Used to prepend an icon or similar element to the nav submenu.\n- **suffix** - Used to append an icon or similar element to the nav submenu.\n- **expand-icon** - Optional expand icon to use instead of the default. Works best with `<sl-icon>`.\n- **collapse-icon** - Optional collapse icon to use instead of the default. Works best with `<sl-icon>`.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **header** - The header that wraps the title, prefix, suffix and expand/collapse icon.\n- **prefix** - The prefix container.\n- **label** - The nav submenu label.\n- **suffix** - The suffix container.\n- **expand-icon** - The container that wraps the expand/collapse icons.\n- **content** - The nav submenu content.\n- **popup** - The popup that wraps the content in horizontal mode.",
+      "name": "sl-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": "key",
-          "description": "A stable key used by `sl-nav` to track open state.",
-          "values": []
-        },
-        {
-          "name": "item-key",
-          "description": "React-safe alias for `key`.\n\nReact reserves `key` and won't forward it to custom elements, so wrapper users can pass `itemKey` instead.",
-          "values": []
-        },
-        {
-          "name": "open",
-          "description": "Indicates whether or not the submenu is open.",
-          "values": []
-        },
-        {
-          "name": "nested",
-          "description": "Indicates if this submenu is nested within another submenu.",
-          "values": []
-        },
-        {
-          "name": "title",
-          "description": "The summary to show in the header. If you need to display HTML, use the `title` slot instead.",
-          "values": []
-        },
-        {
-          "name": "theme",
-          "description": "Matches Antd's `theme` field.",
-          "values": [{ "name": "light" }, { "name": "dark" }]
-        },
-        {
-          "name": "popup-class-name",
-          "description": "Matches Antd's `popupClassName` field.",
+          "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 submenu in a disabled state.",
+          "description": "Draws the option in a disabled state, preventing selection.",
           "values": []
-        },
+        }
+      ],
+      "references": [
         {
-          "name": "active",
-          "description": "Draws the submenu in an active (selected) state.",
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/option"
+        }
+      ]
+    },
+    {
+      "name": "sl-progress-bar",
+      "description": "Progress bars are used to show the status of an ongoing operation.\n---\n\n\n### **Slots:**\n - _default_ - A label to show inside the progress indicator.\n\n### **CSS Properties:**\n - **--height** - The progress bar's height. _(default: undefined)_\n- **--track-color** - The color of the track. _(default: undefined)_\n- **--indicator-color** - The color of the indicator. _(default: undefined)_\n- **--label-color** - The color of the label. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **indicator** - The progress bar's indicator.\n- **label** - The progress bar's label.",
+      "attributes": [
+        {
+          "name": "value",
+          "description": "The current progress as a percentage, 0 to 100.",
           "values": []
         },
         {
-          "name": "mode",
-          "description": "The mode of navigation.",
-          "values": [
-            { "name": "horizontal" },
-            { "name": "inline" },
-            { "name": "vertical" }
-          ]
+          "name": "indeterminate",
+          "description": "When true, percentage is ignored, the label is hidden, and the progress bar is drawn in an indeterminate state.",
+          "values": []
         },
         {
-          "name": "collapsed",
-          "description": "Whether the parent nav is in inline-collapsed mode.",
+          "name": "label",
+          "description": "A custom label for assistive devices.",
           "values": []
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/nav-submenu"
+          "url": "https://shoelace.style/components/progress-bar"
         }
       ]
     },
@@ -2136,28 +2185,6 @@
         }
       ]
     },
-    {
-      "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-popup",
       "description": "Popup is a utility that lets you declaratively anchor \"popup\" containers to another element.\n---\n\n\n### **Events:**\n - **sl-reposition** - Emitted when the popup is repositioned. This event can fire a lot, so avoid putting expensive operations in your listener or consider debouncing it.\n\n### **Methods:**\n - **reposition()** - Forces the popup to recalculate and reposition itself.\n\n### **Slots:**\n - _default_ - The popup's content.\n- **anchor** - The element the popup will be anchored to. If the anchor lives outside of the popup, you can use the `anchor` attribute or property instead.\n\n### **CSS Properties:**\n - **--arrow-size** - The size of the arrow. Note that an arrow won't be shown unless the `arrow` attribute is used. _(default: 6px)_\n- **--arrow-color** - The color of the arrow. _(default: var(--sl-color-neutral-0))_\n- **--auto-size-available-width** - A read-only custom property that determines the amount of width the popup can be before overflowing. Useful for positioning child elements that need to overflow. This property is only available when using `auto-size`. _(default: undefined)_\n- **--auto-size-available-height** - A read-only custom property that determines the amount of height the popup can be before overflowing. Useful for positioning child elements that need to overflow. This property is only available when using `auto-size`. _(default: undefined)_\n\n### **CSS Parts:**\n - **arrow** - The arrow's container. Avoid setting `top|bottom|left|right` properties, as these values are assigned dynamically as the popup moves. This is most useful for applying a background color to match the popup, and maybe a border or box shadow.\n- **popup** - The popup's container. Useful for setting a background color, box shadow, etc.\n- **hover-bridge** - The hover bridge element. Only available when the `hover-bridge` option is enabled.",
@@ -2329,33 +2356,6 @@
         }
       ]
     },
-    {
-      "name": "sl-progress-bar",
-      "description": "Progress bars are used to show the status of an ongoing operation.\n---\n\n\n### **Slots:**\n - _default_ - A label to show inside the progress indicator.\n\n### **CSS Properties:**\n - **--height** - The progress bar's height. _(default: undefined)_\n- **--track-color** - The color of the track. _(default: undefined)_\n- **--indicator-color** - The color of the indicator. _(default: undefined)_\n- **--label-color** - The color of the label. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **indicator** - The progress bar's indicator.\n- **label** - The progress bar's label.",
-      "attributes": [
-        {
-          "name": "value",
-          "description": "The current progress as a percentage, 0 to 100.",
-          "values": []
-        },
-        {
-          "name": "indeterminate",
-          "description": "When true, percentage is ignored, the label is hidden, and the progress bar is drawn in an indeterminate state.",
-          "values": []
-        },
-        {
-          "name": "label",
-          "description": "A custom label for assistive devices.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/progress-bar"
-        }
-      ]
-    },
     {
       "name": "sl-qr-code",
       "description": "Generates a [QR code](https://www.qrcode.com/) and renders it using the [Canvas API](https://developer.mozilla.org/en-US/docs/Web/API/Canvas_API).\n---\n\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -2869,38 +2869,83 @@
     },
     {
       "name": "sl-sender",
-      "description": "Senders are used to send messages.\n---\n\n\n### **Events:**\n - **sl-change** - Emitted when the sender's value changes.\n- **sl-submit** - Emitted when the sender's submit button is clicked.\n- **sl-clear** - Emitted when the sender's clear button is clicked.\n- **sl-speech-toggle** - Emitted when the sender's speech button is clicked.\n- **sl-focus** - Emitted when the sender's input area gains focus.\n- **sl-blur** - Emitted when the sender's input area loses focus.\n\n### **Methods:**\n - **focus(options: _SenderFocusOptions_)** - 聚焦输入区域，支持 cursor 选项控制光标位置。\n- 'end'（默认）：光标移到内容末尾\n- 'start'：光标移到内容开头\n- 'all'：全选内容\n- 'slot'：聚焦第一个 slot input，若不存在则等同 'end'\n- **blur()** - 移除输入区域焦点\n- **clear()** - 清空输入内容，slot 模式下同时重置 slotValues\n- **getValue(): _{ value: string; slotConfig: SlotConfigType[]; skill?: SkillType }_** - 获取当前输入值，slot 模式下返回完整的 { value, slotConfig, skill }\n- **insert(slotConfig: _SlotConfigType[]_, position: _InsertPosition_, _replaceCharacters: _string_, preventScroll: _boolean_)** - 插入文本或 slot 配置项到输入区域\nslot 模式下将 slotConfig 项渲染为 DOM 节点插入到 slot-area\n普通模式下将各项文本拼接后插入到 textarea",
+      "description": "Senders are used to send messages. They support plain text input, structured slot-based input, speech recognition, skill tagging, and customizable header/footer/prefix/suffix areas.\n---\n\n\n### **Events:**\n - **sl-change** - Emitted when the sender's value changes. The event detail includes `{ value, slotConfig, skill }`.\n- **sl-submit** - Emitted when the sender's submit button is clicked or Enter is pressed. The event detail includes `{ value }` or `{ value, slotConfig, skill }` in slot mode.\n- **sl-clear** - Emitted when the sender's content is cleared.\n- **sl-speech-toggle** - Emitted when the sender's speech button is clicked.\n- **sl-focus** - Emitted when the sender's input area gains focus.\n- **sl-blur** - Emitted when the sender's input area loses focus.\n- **sl-paste** - Emitted when content is pasted into the sender. The event detail includes `{ event }`.\n- **sl-paste-file** - Emitted when files are pasted into the sender. The event detail includes `{ files }`.\n\n### **Methods:**\n - **focus(options: _SenderFocusOptions_)** - 聚焦输入区域，支持 cursor 选项控制光标位置。\n- 'end'（默认）：光标移到内容末尾\n- 'start'：光标移到内容开头\n- 'all'：全选内容\n- 'slot'：聚焦第一个 slot input，若不存在则等同 'end'\n- **blur()** - 移除输入区域焦点\n- **clear()** - 清空输入内容，slot 模式下同时重置 slotValues\n- **getValue(): _{ value: string; slotConfig: SlotConfigType[]; skill?: SkillType }_** - 获取当前输入值，slot 模式下返回完整的 { value, slotConfig, skill }\n- **insert(slotConfig: _SlotConfigType[]_, position: _InsertPosition_, _replaceCharacters: _string_, preventScroll: _boolean_)** - 插入文本或 slot 配置项到输入区域\nslot 模式下将 slotConfig 项渲染为 DOM 节点插入到 slot-area\n普通模式下将各项文本拼接后插入到 textarea\n\n### **Slots:**\n - **prefix** - Used to prepend content to the input area.\n- **suffix** - Used to append action buttons or content to the input area. Defaults to the speech button and send button.\n- **header** - Used to add content above the input area.\n- **footer** - Used to add content below the input area, such as toolbar actions.\n\n### **CSS Properties:**\n - **--sl-sender-border-width** - The border width of the sender container. _(default: undefined)_\n- **--sl-sender-border-color** - The border color of the sender container. _(default: undefined)_\n- **--sl-sender-border-color-hover** - The border color when hovered. _(default: undefined)_\n- **--sl-sender-border-color-focus** - The border color when focused. _(default: undefined)_\n- **--sl-sender-border-color-disabled** - The border color when disabled. _(default: undefined)_\n- **--sl-sender-background-color** - The background color of the sender container. _(default: undefined)_\n- **--sl-sender-background-color-disabled** - The background color when disabled. _(default: undefined)_\n- **--sl-sender-shadow** - The box shadow of the sender container. _(default: undefined)_\n- **--sl-sender-shadow-focus** - The box shadow when focused. _(default: undefined)_\n- **--sl-sender-input-color** - The text color of the input area. _(default: undefined)_\n- **--sl-sender-input-color-disabled** - The text color when disabled. _(default: undefined)_\n- **--sl-sender-input-placeholder-color** - The placeholder text color. _(default: undefined)_\n- **--sl-sender-input-placeholder-color-disabled** - The placeholder text color when disabled. _(default: undefined)_\n- **--sl-sender-action-color** - The color of action buttons. _(default: undefined)_\n- **--sl-sender-action-color-hover** - The color of action buttons when hovered. _(default: undefined)_\n- **--sl-sender-action-color-active** - The color of action buttons when active. _(default: undefined)_\n- **--sl-sender-action-color-disabled** - The color of action buttons when disabled. _(default: undefined)_\n- **--sl-sender-action-background-hover** - The background color of action buttons when hovered. _(default: undefined)_\n- **--sl-sender-action-background-active** - The background color of action buttons when active. _(default: undefined)_\n- **--sl-sender-action-border-radius** - The border radius of action buttons. _(default: undefined)_\n- **--sl-sender-submit-color** - The color of the submit button. _(default: undefined)_\n- **--sl-sender-submit-color-active** - The color of the submit button when active. _(default: undefined)_\n- **--sl-sender-submit-background** - The background color of the submit button. _(default: undefined)_\n- **--sl-sender-submit-background-hover** - The background color of the submit button when hovered. _(default: undefined)_\n- **--sl-sender-submit-background-active** - The background color of the submit button when active. _(default: undefined)_\n- **--sl-sender-submit-background-disabled** - The background color of the submit button when disabled. _(default: undefined)_\n- **--sl-sender-submit-border-radius** - The border radius of the submit button. _(default: undefined)_\n- **--sl-sender-voice-recording-background** - The background color of the recording button. _(default: undefined)_\n- **--sl-sender-voice-waveform-color** - The color of the voice waveform bars during recording. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **input** - The internal `<sl-textarea>` control (plain text mode).\n- **slot-area** - The slot-based input area container (slot mode).\n- **skill** - The skill tag element.\n- **header** - The header area wrapper.\n- **footer** - The footer area wrapper.\n- **actions** - The action buttons container in the suffix area.",
       "attributes": [
-        { "name": "value", "values": [] },
-        { "name": "placeholder", "values": [] },
-        { "name": "loading", "values": [] },
-        { "name": "disabled", "values": [] },
-        { "name": "read-only", "values": [] },
-        { "name": "rows", "values": [] },
+        {
+          "name": "value",
+          "description": "The current value of the sender, submitted as part of the event detail on submit.",
+          "values": []
+        },
+        {
+          "name": "placeholder",
+          "description": "Placeholder text to show as a hint when the input is empty.",
+          "values": []
+        },
+        {
+          "name": "loading",
+          "description": "Draws the sender in a loading state, typically used while waiting for a response.",
+          "values": []
+        },
+        {
+          "name": "disabled",
+          "description": "Disables the sender.",
+          "values": []
+        },
+        {
+          "name": "read-only",
+          "description": "Makes the sender readonly.",
+          "values": []
+        },
+        {
+          "name": "rows",
+          "description": "The number of rows to display for the textarea. Only applies in plain text mode.",
+          "values": []
+        },
         {
           "name": "submit-type",
+          "description": "Determines how the Enter key behaves. When set to `enter`, pressing Enter submits. When set to `shift-enter`, pressing Shift+Enter submits.",
           "values": [{ "name": "enter" }, { "name": "shift-enter" }]
         },
-        { "name": "slotConfig", "values": [{ "name": "SlotConfigType[]" }] },
-        { "name": "skill", "values": [{ "name": "SkillType" }] },
+        {
+          "name": "slotConfig",
+          "description": "An array of slot configuration items for structured input mode. Supports `text`, `input`, `select`, `tag`, `content`, and `custom` types.",
+          "values": [{ "name": "SlotConfigType[]" }]
+        },
+        {
+          "name": "skill",
+          "description": "The skill tag to display in the slot input area. Includes `value`, optional `title`, and optional `closable` configuration.",
+          "values": [{ "name": "SkillType" }]
+        },
         {
           "name": "footer",
+          "description": "Custom footer content or render function. Set to `false` to hide the footer.",
           "values": [{ "name": "BaseNode" }, { "name": "NodeRender" }]
         },
         {
           "name": "header",
+          "description": "Custom header content or render function. Set to `false` to hide the header.",
           "values": [{ "name": "BaseNode" }, { "name": "NodeRender" }]
         },
         {
           "name": "prefixContent",
+          "description": "Custom prefix content or render function. Set to `false` to hide the prefix.",
           "values": [{ "name": "BaseNode" }, { "name": "NodeRender" }]
         },
         {
           "name": "suffixContent",
+          "description": "Custom suffix content or render function. Set to `false` to hide the suffix (action buttons).",
           "values": [{ "name": "BaseNode" }, { "name": "NodeRender" }]
         },
-        { "name": "allow-speech", "values": [{ "name": "AllowSpeech" }] },
-        { "name": "speech-recording", "values": [] }
+        {
+          "name": "allow-speech",
+          "description": "Enables speech recognition input. Set to `true` for uncontrolled mode, or pass a `ControlledSpeechConfig` object for controlled mode.",
+          "values": [{ "name": "AllowSpeech" }]
+        },
+        {
+          "name": "speech-recording",
+          "description": "Whether speech recognition is currently recording. Only applies in uncontrolled speech mode.",
+          "values": []
+        }
       ],
       "references": [
         {
@@ -2941,38 +2986,6 @@
         }
       ]
     },
-    {
-      "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).",
-      "attributes": [
-        {
-          "name": "checked",
-          "description": "Whether the switch is in the checked (active) state.",
-          "values": []
-        },
-        {
-          "name": "default-checked",
-          "description": "The initial checked state when uncontrolled. Only used on first render.",
-          "values": []
-        },
-        {
-          "name": "disabled",
-          "description": "Disables the switch.",
-          "values": []
-        },
-        {
-          "name": "loading",
-          "description": "Shows a loading spinner on the switch.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/sender-switch"
-        }
-      ]
-    },
     {
       "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.",
@@ -3035,6 +3048,38 @@
         }
       ]
     },
+    {
+      "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).",
+      "attributes": [
+        {
+          "name": "checked",
+          "description": "Whether the switch is in the checked (active) state.",
+          "values": []
+        },
+        {
+          "name": "default-checked",
+          "description": "The initial checked state when uncontrolled. Only used on first render.",
+          "values": []
+        },
+        {
+          "name": "disabled",
+          "description": "Disables the switch.",
+          "values": []
+        },
+        {
+          "name": "loading",
+          "description": "Shows a loading spinner on the switch.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/sender-switch"
+        }
+      ]
+    },
     {
       "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.",
@@ -3156,131 +3201,66 @@
       "attributes": [
         {
           "name": "panel",
-          "description": "The name of the tab panel this tab is associated with. The panel must be located in the same tab group.",
-          "values": []
-        },
-        {
-          "name": "active",
-          "description": "Draws the tab in an active state.",
-          "values": []
-        },
-        {
-          "name": "closable",
-          "description": "Makes the tab closable and shows a close button.",
-          "values": []
-        },
-        {
-          "name": "disabled",
-          "description": "Disables the tab and prevents selection.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/tab"
-        }
-      ]
-    },
-    {
-      "name": "sl-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.",
-      "attributes": [
-        {
-          "name": "name",
-          "description": "The tab panel's name.",
+          "description": "The name of the tab panel this tab is associated with. The panel must be located in the same tab group.",
           "values": []
         },
         {
           "name": "active",
-          "description": "When true, the tab panel will be shown.",
+          "description": "Draws the tab in an active state.",
+          "values": []
+        },
+        {
+          "name": "closable",
+          "description": "Makes the tab closable and shows a close button.",
+          "values": []
+        },
+        {
+          "name": "disabled",
+          "description": "Disables the tab and prevents selection.",
           "values": []
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/tab-panel"
+          "url": "https://shoelace.style/components/tab"
         }
       ]
     },
     {
-      "name": "sl-tag",
-      "description": "Tags are used as labels to organize things or to indicate a selection.\n---\n\n\n### **Events:**\n - **sl-remove** - Emitted when the remove button is activated.\n\n### **Slots:**\n - _default_ - The tag's content.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **content** - The tag's content.\n- **remove-button** - The tag's remove button, an `<sl-icon-button>`.\n- **remove-button__base** - The remove button's exported `base` part.",
+      "name": "sl-tab-group",
+      "description": "Tab groups organize content into a container that shows one section at a time.\n---\n\n\n### **Events:**\n - **sl-tab-show** - Emitted when a tab is shown.\n- **sl-tab-hide** - Emitted when a tab is hidden.\n\n### **Methods:**\n - **show(panel: _string_)** - Shows the specified tab panel.\n\n### **Slots:**\n - _default_ - Used for grouping tab panels in the tab group. Must be `<sl-tab-panel>` elements.\n- **nav** - Used for grouping tabs in the tab group. Must be `<sl-tab>` elements.\n\n### **CSS Properties:**\n - **--indicator-color** - The color of the active tab indicator. _(default: undefined)_\n- **--track-color** - The color of the indicator's track (the line that separates tabs from panels). _(default: undefined)_\n- **--track-width** - The width of the indicator's track (the line that separates tabs from panels). _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **nav** - The tab group's navigation container where tabs are slotted in.\n- **tabs** - The container that wraps the tabs.\n- **active-tab-indicator** - The line that highlights the currently selected tab.\n- **body** - The tab group's body where tab panels are slotted in.\n- **scroll-button** - The previous/next scroll buttons that show when tabs are scrollable, an `<sl-icon-button>`.\n- **scroll-button--start** - The starting scroll button.\n- **scroll-button--end** - The ending scroll button.\n- **scroll-button__base** - The scroll button's exported `base` part.",
       "attributes": [
         {
-          "name": "variant",
-          "description": "The tag's theme variant.",
+          "name": "placement",
+          "description": "The placement of the tabs.",
           "values": [
-            { "name": "primary" },
-            { "name": "success" },
-            { "name": "neutral" },
-            { "name": "warning" },
-            { "name": "danger" },
-            { "name": "text" }
+            { "name": "top" },
+            { "name": "bottom" },
+            { "name": "start" },
+            { "name": "end" }
           ]
         },
         {
-          "name": "size",
-          "description": "The tag's size.",
-          "values": [
-            { "name": "small" },
-            { "name": "medium" },
-            { "name": "large" }
-          ]
+          "name": "activation",
+          "description": "When set to auto, navigating tabs with the arrow keys will instantly show the corresponding tab panel. When set to\nmanual, the tab will receive focus but will not show until the user presses spacebar or enter.",
+          "values": [{ "name": "auto" }, { "name": "manual" }]
         },
         {
-          "name": "pill",
-          "description": "Draws a pill-style tag with rounded edges.",
+          "name": "no-scroll-controls",
+          "description": "Disables the scroll arrows that appear when tabs overflow.",
           "values": []
         },
         {
-          "name": "removable",
-          "description": "Makes the tag removable and shows a remove button.",
+          "name": "fixed-scroll-controls",
+          "description": "Prevent scroll buttons from being hidden when inactive.",
           "values": []
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/tag"
+          "url": "https://shoelace.style/components/tab-group"
         }
       ]
     },
@@ -3375,6 +3355,108 @@
         }
       ]
     },
+    {
+      "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-tab-panel",
+      "description": "Tab panels are used inside [tab groups](/components/tab-group) to display tabbed content.\n---\n\n\n### **Slots:**\n - _default_ - The tab panel's content.\n\n### **CSS Properties:**\n - **--padding** - The tab panel's padding. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+      "attributes": [
+        {
+          "name": "name",
+          "description": "The tab panel's name.",
+          "values": []
+        },
+        {
+          "name": "active",
+          "description": "When true, the tab panel will be shown.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/tab-panel"
+        }
+      ]
+    },
+    {
+      "name": "sl-think",
+      "description": "Think is used to display an AI model's thinking process with expandable/collapsible content.\n---\n\n\n### **Events:**\n - **sl-expand** - Emitted when the think block starts expanding (before animation). Equivalent to React's `onExpand(true)`.\n- **sl-collapse** - Emitted when the think block starts collapsing (before animation). Equivalent to React's `onExpand(false)`.\n\n### **Methods:**\n - **handleExpandedChange()** - Runs AFTER the first render whenever `expanded` changes.\nEmits the appropriate event immediately (matching React's `onExpand` timing,\nwhich fires before the animation), then plays the expand/collapse animation.\n\n### **Slots:**\n - _default_ - The thinking content body.\n- **title** - Rich HTML content for the status bar title. Overrides the `title` attribute.\n- **icon** - A custom icon displayed in the status bar when not loading. Defaults to the Think icon.\n- **loading-icon** - A custom icon displayed when `loading` is true. Overrides the default spinner. This is the web-component equivalent of passing a ReactNode to the React `loading` prop.\n\n### **CSS Properties:**\n - **--sl-c-think-TitleTextBlink-color-default** - Base text color shown during the blink/shimmer animation. Equivalent to React's `colorTextBlinkDefault` (`colorTextDescription`) design token. Defaults to `var(--sl-color-neutral-600)`. _(default: undefined)_\n- **--sl-c-think-TitleTextBlink-color** - Highlight (shine) color of the blink shimmer beam. Equivalent to React's `colorTextBlink` (`colorTextBase`) design token. Defaults to `var(--sl-color-neutral-900)`. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper (maps to React's `root` semantic DOM).\n- **status** - The clickable status bar: icon + title + chevron (maps to React's `status` semantic DOM).\n- **status-icon** - The icon container within the status bar.\n- **status-text** - The title text area within the status bar.\n- **chevron** - The expand/collapse chevron indicator.\n- **body** - The collapsible body container.\n- **content** - The content area inside the body (maps to React's `content` semantic DOM).",
+      "attributes": [
+        {
+          "name": "title",
+          "description": "The title text shown in the status bar. Accepts plain text.\nFor rich HTML content, use the `title` slot instead.\nMaps to React's `title: React.ReactNode` prop.",
+          "values": []
+        },
+        {
+          "name": "loading",
+          "description": "When true, the status icon is replaced by a loading spinner\n(or the content of the `loading-icon` slot for a custom indicator).\nMaps to React's `loading: boolean | React.ReactNode` prop:\n  - `loading` (boolean) → boolean attribute\n  - `loading` (ReactNode) → use the `loading-icon` slot",
+          "values": []
+        },
+        {
+          "name": "expanded",
+          "description": "Whether the content body is expanded.\nWhen used without `default-expanded`, this acts as a controlled prop\n(the parent is responsible for updating it).\nWhen neither this nor `default-expanded` is set on the element,\nthe component defaults to expanded (equivalent to React's `defaultExpanded = true`).\nMaps to React's `expanded: boolean` prop.",
+          "values": []
+        },
+        {
+          "name": "default-expanded",
+          "description": "The initial expanded state when the component is first rendered.\nOnly applies if `expanded` is not set as an attribute on the element.\nMaps to React's `defaultExpanded: boolean` prop (default: `true`).\n\nBecause Lit's `type: Boolean` treats attribute *presence* as `true`,\nsetting `default-expanded=\"false\"` in HTML does NOT work — this is\nconsistent with all other Shoelace boolean attributes.\nTo start collapsed, set the property via JS: `el.defaultExpanded = false`.",
+          "values": []
+        },
+        {
+          "name": "blink",
+          "description": "When true, applies a blinking animation to the title text to signal ongoing activity.\nMaps to React's `blink: boolean` prop.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/think"
+        }
+      ]
+    },
     {
       "name": "sl-textarea",
       "description": "Textareas collect data from the user and allow multiple lines of text.\n---\n\n\n### **Events:**\n - **sl-blur** - Emitted when the control loses focus.\n- **sl-change** - Emitted when an alteration to the control's value is committed by the user.\n- **sl-focus** - Emitted when the control gains focus.\n- **sl-input** - Emitted when the control receives input.\n- **sl-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the textarea.\n- **blur()** - Removes focus from the textarea.\n- **select()** - Selects all the text in the textarea.\n- **scrollPosition(position: _{ top?: number; left?: number }_): _{ top: number; left: number } | undefined_** - Gets or sets the textarea's scroll position.\n- **setSelectionRange(selectionStart: _number_, selectionEnd: _number_, selectionDirection: _'forward' | 'backward' | 'none'_)** - Sets the start and end positions of the text selection (0-based).\n- **setRangeText(replacement: _string_, start: _number_, end: _number_, selectMode: _'select' | 'start' | 'end' | 'preserve'_)** - Replaces a range of text with a new string.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - **label** - The textarea's label. Alternatively, you can use the `label` attribute.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The input's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **base** - The component's base wrapper.\n- **textarea** - The internal `<textarea>` control.",
@@ -3530,43 +3612,6 @@
         }
       ]
     },
-    {
-      "name": "sl-think",
-      "description": "Think is used to display an AI model's thinking process with expandable/collapsible content.\n---\n\n\n### **Events:**\n - **sl-expand** - Emitted when the think block starts expanding (before animation). Equivalent to React's `onExpand(true)`.\n- **sl-collapse** - Emitted when the think block starts collapsing (before animation). Equivalent to React's `onExpand(false)`.\n\n### **Methods:**\n - **handleExpandedChange()** - Runs AFTER the first render whenever `expanded` changes.\nEmits the appropriate event immediately (matching React's `onExpand` timing,\nwhich fires before the animation), then plays the expand/collapse animation.\n\n### **Slots:**\n - _default_ - The thinking content body.\n- **title** - Rich HTML content for the status bar title. Overrides the `title` attribute.\n- **icon** - A custom icon displayed in the status bar when not loading. Defaults to the Think icon.\n- **loading-icon** - A custom icon displayed when `loading` is true. Overrides the default spinner. This is the web-component equivalent of passing a ReactNode to the React `loading` prop.\n\n### **CSS Properties:**\n - **--sl-c-think-TitleTextBlink-color-default** - Base text color shown during the blink/shimmer animation. Equivalent to React's `colorTextBlinkDefault` (`colorTextDescription`) design token. Defaults to `var(--sl-color-neutral-600)`. _(default: undefined)_\n- **--sl-c-think-TitleTextBlink-color** - Highlight (shine) color of the blink shimmer beam. Equivalent to React's `colorTextBlink` (`colorTextBase`) design token. Defaults to `var(--sl-color-neutral-900)`. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper (maps to React's `root` semantic DOM).\n- **status** - The clickable status bar: icon + title + chevron (maps to React's `status` semantic DOM).\n- **status-icon** - The icon container within the status bar.\n- **status-text** - The title text area within the status bar.\n- **chevron** - The expand/collapse chevron indicator.\n- **body** - The collapsible body container.\n- **content** - The content area inside the body (maps to React's `content` semantic DOM).",
-      "attributes": [
-        {
-          "name": "title",
-          "description": "The title text shown in the status bar. Accepts plain text.\nFor rich HTML content, use the `title` slot instead.\nMaps to React's `title: React.ReactNode` prop.",
-          "values": []
-        },
-        {
-          "name": "loading",
-          "description": "When true, the status icon is replaced by a loading spinner\n(or the content of the `loading-icon` slot for a custom indicator).\nMaps to React's `loading: boolean | React.ReactNode` prop:\n  - `loading` (boolean) → boolean attribute\n  - `loading` (ReactNode) → use the `loading-icon` slot",
-          "values": []
-        },
-        {
-          "name": "expanded",
-          "description": "Whether the content body is expanded.\nWhen used without `default-expanded`, this acts as a controlled prop\n(the parent is responsible for updating it).\nWhen neither this nor `default-expanded` is set on the element,\nthe component defaults to expanded (equivalent to React's `defaultExpanded = true`).\nMaps to React's `expanded: boolean` prop.",
-          "values": []
-        },
-        {
-          "name": "default-expanded",
-          "description": "The initial expanded state when the component is first rendered.\nOnly applies if `expanded` is not set as an attribute on the element.\nMaps to React's `defaultExpanded: boolean` prop (default: `true`).\n\nBecause Lit's `type: Boolean` treats attribute *presence* as `true`,\nsetting `default-expanded=\"false\"` in HTML does NOT work — this is\nconsistent with all other Shoelace boolean attributes.\nTo start collapsed, set the property via JS: `el.defaultExpanded = false`.",
-          "values": []
-        },
-        {
-          "name": "blink",
-          "description": "When true, applies a blinking animation to the title text to signal ongoing activity.\nMaps to React's `blink: boolean` prop.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/think"
-        }
-      ]
-    },
     {
       "name": "sl-thought-chain",
       "description": "ThoughtChain visualizes and tracks an Agent's call chain of Actions and Tools.\nIt renders a vertical list of nodes, each optionally with an icon, title, description,\ncollapsible content, footer, and status indicator. Nodes are connected by a vertical line.\n---\n\n\n### **Events:**\n - **sl-expand** - Emitted when a collapsible node is expanded or collapsed. `event.detail` contains `{ key: string, expandedKeys: string[] }`.\n\n### **Methods:**\n - **getExpandedKeys(): _string[]_** - Get the effective expanded keys\n- **handleItemExpand(key: _string_)** - Handle expand/collapse toggle from child node\n\n### **Slots:**\n - _default_ - Default slot for `<sl-thought-chain-node>` elements (declarative usage).\n\n### **CSS Properties:**\n - **--sl-thought-chain-gap** - Gap between the icon and the node body. Defaults to `var(--sl-spacing-small)`. _(default: undefined)_\n- **--sl-thought-chain-connector-color** - Color of the vertical connector line. Defaults to `var(--sl-color-neutral-300)`. _(default: undefined)_\n- **--sl-thought-chain-icon-size** - Size of the node icon. Defaults to `var(--sl-font-size-medium)`. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -3707,27 +3752,6 @@
         }
       ]
     },
-    {
-      "name": "sl-tree",
-      "description": "Trees allow you to display a hierarchical list of selectable [tree items](/components/tree-item). Items with children can be expanded and collapsed as desired by the user.\n---\n\n\n### **Events:**\n - **sl-selection-change** - Emitted when a tree item is selected or deselected.\n\n### **Slots:**\n - _default_ - The default slot.\n- **expand-icon** - The icon to show when the tree item is expanded. Works best with `<sl-icon>`.\n- **collapse-icon** - The icon to show when the tree item is collapsed. Works best with `<sl-icon>`.\n\n### **CSS Properties:**\n - **--indent-size** - The size of the indentation for nested items. _(default: var(--sl-spacing-medium))_\n- **--indent-guide-color** - The color of the indentation line. _(default: var(--sl-color-neutral-200))_\n- **--indent-guide-offset** - The amount of vertical spacing to leave between the top and bottom of the indentation line's starting position. _(default: 0)_\n- **--indent-guide-style** - The style of the indentation line, e.g. solid, dotted, dashed. _(default: solid)_\n- **--indent-guide-width** - The width of the indentation line. _(default: 0)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
-      "attributes": [
-        {
-          "name": "selection",
-          "description": "The selection behavior of the tree. Single selection allows only one node to be selected at a time. Multiple\ndisplays checkboxes and allows more than one node to be selected. Leaf allows only leaf nodes to be selected.",
-          "values": [
-            { "name": "single" },
-            { "name": "multiple" },
-            { "name": "leaf" }
-          ]
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/tree"
-        }
-      ]
-    },
     {
       "name": "sl-tooltip",
       "description": "Tooltips display additional information based on a specific action.\n---\n\n\n### **Events:**\n - **sl-show** - Emitted when the tooltip begins to show.\n- **sl-after-show** - Emitted after the tooltip has shown and all animations are complete.\n- **sl-hide** - Emitted when the tooltip begins to hide.\n- **sl-after-hide** - Emitted after the tooltip has hidden and all animations are complete.\n\n### **Methods:**\n - **show()** - Shows the tooltip.\n- **hide()** - Hides the tooltip\n\n### **Slots:**\n - _default_ - The tooltip's target element. Avoid slotting in more than one element, as subsequent ones will be ignored.\n- **content** - The content to render in the tooltip. Alternatively, you can use the `content` attribute.\n\n### **CSS Properties:**\n - **--max-width** - The maximum width of the tooltip before its content will wrap. _(default: undefined)_\n- **--hide-delay** - The amount of time to wait before hiding the tooltip when hovering. _(default: undefined)_\n- **--show-delay** - The amount of time to wait before showing the tooltip when hovering. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper, an `<sl-popup>` element.\n- **base__popup** - The popup's exported `popup` part. Use this to target the tooltip's popup container.\n- **base__arrow** - The popup's exported `arrow` part. Use this to target the tooltip's arrow.\n- **body** - The tooltip's body where its content is rendered.",
@@ -3794,6 +3818,27 @@
         }
       ]
     },
+    {
+      "name": "sl-tree",
+      "description": "Trees allow you to display a hierarchical list of selectable [tree items](/components/tree-item). Items with children can be expanded and collapsed as desired by the user.\n---\n\n\n### **Events:**\n - **sl-selection-change** - Emitted when a tree item is selected or deselected.\n\n### **Slots:**\n - _default_ - The default slot.\n- **expand-icon** - The icon to show when the tree item is expanded. Works best with `<sl-icon>`.\n- **collapse-icon** - The icon to show when the tree item is collapsed. Works best with `<sl-icon>`.\n\n### **CSS Properties:**\n - **--indent-size** - The size of the indentation for nested items. _(default: var(--sl-spacing-medium))_\n- **--indent-guide-color** - The color of the indentation line. _(default: var(--sl-color-neutral-200))_\n- **--indent-guide-offset** - The amount of vertical spacing to leave between the top and bottom of the indentation line's starting position. _(default: 0)_\n- **--indent-guide-style** - The style of the indentation line, e.g. solid, dotted, dashed. _(default: solid)_\n- **--indent-guide-width** - The width of the indentation line. _(default: 0)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+      "attributes": [
+        {
+          "name": "selection",
+          "description": "The selection behavior of the tree. Single selection allows only one node to be selected at a time. Multiple\ndisplays checkboxes and allows more than one node to be selected. Leaf allows only leaf nodes to be selected.",
+          "values": [
+            { "name": "single" },
+            { "name": "multiple" },
+            { "name": "leaf" }
+          ]
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/tree"
+        }
+      ]
+    },
     {
       "name": "sl-tree-item",
       "description": "A tree item serves as a hierarchical node that lives inside a [tree](/components/tree).\n---\n\n\n### **Events:**\n - **sl-expand** - Emitted when the tree item expands.\n- **sl-after-expand** - Emitted after the tree item expands and all animations are complete.\n- **sl-collapse** - Emitted when the tree item collapses.\n- **sl-after-collapse** - Emitted after the tree item collapses and all animations are complete.\n- **sl-lazy-change** - Emitted when the tree item's lazy state changes.\n- **sl-lazy-load** - Emitted when a lazy item is selected. Use this event to asynchronously load data and append items to the tree before expanding. After appending new items, remove the `lazy` attribute to remove the loading state and update the tree.\n\n### **Methods:**\n - **getChildrenItems({ includeDisabled = true }: _{ includeDisabled?: boolean }_): _SlTreeItem[]_** - Gets all the nested tree items in this node.\n\n### **Slots:**\n - _default_ - The default slot.\n- **expand-icon** - The icon to show when the tree item is expanded.\n- **collapse-icon** - The icon to show when the tree item is collapsed.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **item** - The tree item's container. This element wraps everything except slotted tree item children.\n- **item--disabled** - Applied when the tree item is disabled.\n- **item--expanded** - Applied when the tree item is expanded.\n- **item--indeterminate** - Applied when the selection is indeterminate.\n- **item--selected** - Applied when the tree item is selected.\n- **indentation** - The tree item's indentation container.\n- **expand-button** - The container that wraps the tree item's expand button and spinner.\n- **spinner** - The spinner that shows when a lazy tree item is in the loading state.\n- **spinner__base** - The spinner's base part.\n- **label** - The tree item's label.\n- **children** - The container that wraps the tree item's nested children.\n- **checkbox** - The checkbox that shows when using multiselect.\n- **checkbox__base** - The checkbox's exported `base` part.\n- **checkbox__control** - The checkbox's exported `control` part.\n- **checkbox__control--checked** - The checkbox's exported `control--checked` part.\n- **checkbox__control--indeterminate** - The checkbox's exported `control--indeterminate` part.\n- **checkbox__checked-icon** - The checkbox's exported `checked-icon` part.\n- **checkbox__indeterminate-icon** - The checkbox's exported `indeterminate-icon` part.\n- **checkbox__label** - The checkbox's exported `label` part.",
@@ -3826,17 +3871,6 @@
         }
       ]
     },
-    {
-      "name": "sl-visually-hidden",
-      "description": "The visually hidden utility makes content accessible to assistive devices without displaying it on the screen.\n---\n\n\n### **Slots:**\n - _default_ - The content to be visually hidden.",
-      "attributes": [],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/visually-hidden"
-        }
-      ]
-    },
     {
       "name": "sl-x-markdown",
       "description": "Render markdown content with streaming support and custom node mapping.\n---\n\n\n### **Slots:**\n - _default_ - Not used. Content is rendered from the `content` property only.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **body** - The markdown body container.\n- **paragraph** - Paragraph content.\n- **heading** - Heading elements.\n- **link** - Link elements.\n- **blockquote** - Blockquotes and chat enhanced containers.\n- **list** - List containers.\n- **list-item** - List items.\n- **table** - Table elements.\n- **table-head** - Table header section.\n- **table-body** - Table body section.\n- **table-row** - Table rows.\n- **table-cell** - Table header/data cells.\n- **code-inline** - Inline code nodes.\n- **code-block** - Code block wrapper.\n- **code-block-header** - Code block language header.\n- **code-block-body** - Code block body.\n- **tail** - Streaming tail indicator.\n- **incomplete** - Incomplete markdown placeholder nodes.",
@@ -3873,6 +3907,17 @@
           "url": "https://shoelace.style/components/x-markdown"
         }
       ]
+    },
+    {
+      "name": "sl-visually-hidden",
+      "description": "The visually hidden utility makes content accessible to assistive devices without displaying it on the screen.\n---\n\n\n### **Slots:**\n - _default_ - The content to be visually hidden.",
+      "attributes": [],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/visually-hidden"
+        }
+      ]
     }
   ]
 }