@kdcloudjs/shoelace 1.0.24 → 1.0.26

package/dist/types/vue/index.d.ts

@@ -1,30 +1,30 @@
 import type { DefineComponent } from "vue";
 
 import type { SlAlert } from "../../components/alert/alert.component.js";
-import type { SlAvatar } from "../../components/avatar/avatar.component.js";
+import type { SlAnimatedImage } from "../../components/animated-image/animated-image.component.js";
 import type { SlAnimation } from "../../components/animation/animation.component.js";
+import type { SlAvatar } from "../../components/avatar/avatar.component.js";
 import type { SlBadge } from "../../components/badge/badge.component.js";
 import type { SlBreadcrumb } from "../../components/breadcrumb/breadcrumb.component.js";
-import type { SlAnimatedImage } from "../../components/animated-image/animated-image.component.js";
 import type { SlBreadcrumbItem } from "../../components/breadcrumb-item/breadcrumb-item.component.js";
 import type { SlButton } from "../../components/button/button.component.js";
 import type { SlButtonGroup } from "../../components/button-group/button-group.component.js";
-import type { SlCard } from "../../components/card/card.component.js";
 import type { SlCarousel } from "../../components/carousel/carousel.component.js";
+import type { SlCard } from "../../components/card/card.component.js";
 import type { SlCarouselItem } from "../../components/carousel-item/carousel-item.component.js";
-import type { SlCol } from "../../components/col/col.component.js";
 import type { SlCheckbox } from "../../components/checkbox/checkbox.component.js";
+import type { SlCol } from "../../components/col/col.component.js";
 import type { SlColorPicker } from "../../components/color-picker/color-picker.component.js";
 import type { SlCopyButton } from "../../components/copy-button/copy-button.component.js";
 import type { SlDatePanel, CustomEvent } from "../../components/date-panel/date-panel.component.js";
 import type { SlDatepicker } from "../../components/datepicker/datepicker.component.js";
-import type { SlDaterange } from "../../components/daterange/daterange.component.js";
+import type { SlDaterangepicker } from "../../components/daterangepicker/daterangepicker.component.js";
 import type { SlDetails } from "../../components/details/details.component.js";
 import type { SlDialog } from "../../components/dialog/dialog.component.js";
 import type { SlDivider } from "../../components/divider/divider.component.js";
 import type { SlDrawer } from "../../components/drawer/drawer.component.js";
-import type { SlFormatBytes } from "../../components/format-bytes/format-bytes.component.js";
 import type { SlDropdown } from "../../components/dropdown/dropdown.component.js";
+import type { SlFormatBytes } from "../../components/format-bytes/format-bytes.component.js";
 import type { SlFormatDate } from "../../components/format-date/format-date.component.js";
 import type { SlFormatNumber } from "../../components/format-number/format-number.component.js";
 import type { SlIcon } from "../../components/icon/icon.component.js";
@@ -52,8 +52,8 @@ import type { SlRadioGroup } from "../../components/radio-group/radio-group.comp
 import type { SlRange } from "../../components/range/range.component.js";
 import type { SlRating } from "../../components/rating/rating.component.js";
 import type { SlRelativeTime } from "../../components/relative-time/relative-time.component.js";
-import type { SlRow } from "../../components/row/row.component.js";
 import type { SlResizeObserver } from "../../components/resize-observer/resize-observer.component.js";
+import type { SlRow } from "../../components/row/row.component.js";
 import type { SlScreen } from "../../components/screen/screen.component.js";
 import type { SlSelect } from "../../components/select/select.component.js";
 import type { SlSkeleton } from "../../components/skeleton/skeleton.component.js";
@@ -65,8 +65,8 @@ import type { SlTabGroup } from "../../components/tab-group/tab-group.component.
 import type { SlTabPanel } from "../../components/tab-panel/tab-panel.component.js";
 import type { SlTable, CustomEvent } from "../../components/table/table.component.js";
 import type { SlTag } from "../../components/tag/tag.component.js";
-import type { SlThink } from "../../components/think/think.component.js";
 import type { SlTextarea } from "../../components/textarea/textarea.component.js";
+import type { SlThink } from "../../components/think/think.component.js";
 import type { SlThoughtChain } from "../../components/thought-chain/thought-chain.component.js";
 import type { SlThoughtChainItem } from "../../components/thought-chain-item/thought-chain-item.component.js";
 import type { SlThoughtChainNode } from "../../components/thought-chain-node/thought-chain-node.component.js";
@@ -105,19 +105,22 @@ Typically used to indicate the remaining time before a whole app refresh. */
   "onsl-after-hide"?: (e: CustomEvent<never>) => void;
 };
 
-type SlAvatarProps = {
-  /** The image source to use for the avatar. */
-  image?: SlAvatar["image"];
-  /** A label to use to describe the avatar to assistive devices. */
-  label?: SlAvatar["label"];
-  /** Initials to use as a fallback when no image is available (1-2 characters max recommended). */
-  initials?: SlAvatar["initials"];
-  /** Indicates how the browser should load the image. */
-  loading?: SlAvatar["loading"];
-  /** The shape of the avatar. */
-  shape?: SlAvatar["shape"];
-
-  /** The image could not be loaded. This may because of an invalid URL, a temporary network condition, or some unknown cause. */
+type SlAnimatedImageProps = {
+  /** The path to the image to load. */
+  src?: SlAnimatedImage["src"];
+  /** A description of the image used by assistive devices. */
+  alt?: SlAnimatedImage["alt"];
+  /** Plays the animation. When this attribute is remove, the animation will pause. */
+  play?: SlAnimatedImage["play"];
+  /**  */
+  animatedImage?: SlAnimatedImage["animatedImage"];
+  /**  */
+  frozenFrame?: SlAnimatedImage["frozenFrame"];
+  /**  */
+  isLoaded?: SlAnimatedImage["isLoaded"];
+  /** Emitted when the image loads successfully. */
+  "onsl-load"?: (e: CustomEvent<never>) => void;
+  /** Emitted when the image fails to load. */
   "onsl-error"?: (e: CustomEvent<never>) => void;
 };
 
@@ -163,6 +166,22 @@ value can be changed without causing the animation to restart. */
   "onsl-start"?: (e: CustomEvent<never>) => void;
 };
 
+type SlAvatarProps = {
+  /** The image source to use for the avatar. */
+  image?: SlAvatar["image"];
+  /** A label to use to describe the avatar to assistive devices. */
+  label?: SlAvatar["label"];
+  /** Initials to use as a fallback when no image is available (1-2 characters max recommended). */
+  initials?: SlAvatar["initials"];
+  /** Indicates how the browser should load the image. */
+  loading?: SlAvatar["loading"];
+  /** The shape of the avatar. */
+  shape?: SlAvatar["shape"];
+
+  /** The image could not be loaded. This may because of an invalid URL, a temporary network condition, or some unknown cause. */
+  "onsl-error"?: (e: CustomEvent<never>) => void;
+};
+
 type SlBadgeProps = {
   /** The badge's theme variant. */
   variant?: SlBadge["variant"];
@@ -182,25 +201,6 @@ screen readers and other assistive devices to provide more context for users. */
   separatorSlot?: SlBreadcrumb["separatorSlot"];
 };
 
-type SlAnimatedImageProps = {
-  /** The path to the image to load. */
-  src?: SlAnimatedImage["src"];
-  /** A description of the image used by assistive devices. */
-  alt?: SlAnimatedImage["alt"];
-  /** Plays the animation. When this attribute is remove, the animation will pause. */
-  play?: SlAnimatedImage["play"];
-  /**  */
-  animatedImage?: SlAnimatedImage["animatedImage"];
-  /**  */
-  frozenFrame?: SlAnimatedImage["frozenFrame"];
-  /**  */
-  isLoaded?: SlAnimatedImage["isLoaded"];
-  /** Emitted when the image loads successfully. */
-  "onsl-load"?: (e: CustomEvent<never>) => void;
-  /** Emitted when the image fails to load. */
-  "onsl-error"?: (e: CustomEvent<never>) => void;
-};
-
 type SlBreadcrumbItemProps = {
   /** Optional URL to direct the user to when the breadcrumb item is activated. When set, a link will be rendered
 internally. When unset, a button will be rendered instead. */
@@ -292,8 +292,6 @@ devices when interacting with the control and is strongly recommended. */
   disableRole?: SlButtonGroup["disableRole"];
 };
 
-type SlCardProps = {};
-
 type SlCarouselProps = {
   /** When set, allows the user to navigate the carousel in the same direction indefinitely. */
   loop?: SlCarousel["loop"];
@@ -328,36 +326,9 @@ greater than one. It can't be higher than `slides-per-page`. */
   "onsl-slide-change"?: (e: CustomEvent<{ index: number; slide: SlCarouselItem }>) => void;
 };
 
-type SlCarouselItemProps = {};
+type SlCardProps = {};
 
-type SlColProps = {
-  /** Number of cells to span (out of 24) */
-  span?: SlCol["span"];
-  /** Number of cells to offset from the left */
-  offset?: SlCol["offset"];
-  /** Order of the column */
-  order?: SlCol["order"];
-  /** Number of cells to push from the left */
-  push?: SlCol["push"];
-  /** Number of cells to pull from the right */
-  pull?: SlCol["pull"];
-  /** Flex layout style */
-  flex?: SlCol["flex"];
-  /** Responsive config for xs screens (< 576px) */
-  xs?: SlCol["xs"];
-  /** Responsive config for sm screens (≥ 576px) */
-  sm?: SlCol["sm"];
-  /** Responsive config for md screens (≥ 768px) */
-  md?: SlCol["md"];
-  /** Responsive config for lg screens (≥ 992px) */
-  lg?: SlCol["lg"];
-  /** Responsive config for xl screens (≥ 1200px) */
-  xl?: SlCol["xl"];
-  /** Responsive config for xxl screens (≥ 1600px) */
-  xxl?: SlCol["xxl"];
-  /**  */
-  rowContext?: SlCol["rowContext"];
-};
+type SlCarouselItemProps = {};
 
 type SlCheckboxProps = {
   /**  */
@@ -403,6 +374,35 @@ the same document or shadow root for this to work. */
   "onsl-invalid"?: (e: CustomEvent<never>) => void;
 };
 
+type SlColProps = {
+  /** Number of cells to span (out of 24) */
+  span?: SlCol["span"];
+  /** Number of cells to offset from the left */
+  offset?: SlCol["offset"];
+  /** Order of the column */
+  order?: SlCol["order"];
+  /** Number of cells to push from the left */
+  push?: SlCol["push"];
+  /** Number of cells to pull from the right */
+  pull?: SlCol["pull"];
+  /** Flex layout style */
+  flex?: SlCol["flex"];
+  /** Responsive config for xs screens (< 576px) */
+  xs?: SlCol["xs"];
+  /** Responsive config for sm screens (≥ 576px) */
+  sm?: SlCol["sm"];
+  /** Responsive config for md screens (≥ 768px) */
+  md?: SlCol["md"];
+  /** Responsive config for lg screens (≥ 992px) */
+  lg?: SlCol["lg"];
+  /** Responsive config for xl screens (≥ 1200px) */
+  xl?: SlCol["xl"];
+  /** Responsive config for xxl screens (≥ 1600px) */
+  xxl?: SlCol["xxl"];
+  /**  */
+  rowContext?: SlCol["rowContext"];
+};
+
 type SlColorPickerProps = {
   /** The current value of the color picker. The value's format will vary based the `format` attribute. To get the value
 in a specific format, use the `getFormattedValue()` method. The value is submitted as a name/value pair with form
@@ -559,64 +559,64 @@ type SlDatepickerProps = {
   calendar?: SlDatepicker["calendar"];
 };
 
-type SlDaterangeProps = {
+type SlDaterangepickerProps = {
   /** The name of the input, submitted as a name/value pair with form data. */
-  name?: SlDaterange["name"];
+  name?: SlDaterangepicker["name"];
   /** The current value of the input, submitted as a name/value pair with form data. */
-  value?: SlDaterange["value"];
+  value?: SlDaterangepicker["value"];
   /** The input's size. */
-  size?: SlDaterange["size"];
+  size?: SlDaterangepicker["size"];
   /** Draws a filled input. */
-  filled?: SlDaterange["filled"];
+  filled?: SlDaterangepicker["filled"];
   /** Draws a pill-style input with rounded edges. */
-  pill?: SlDaterange["pill"];
+  pill?: SlDaterangepicker["pill"];
   /** The input's label. If you need to display HTML, use the `label` slot instead. */
-  label?: SlDaterange["label"];
+  label?: SlDaterangepicker["label"];
   /** The input's help text. If you need to display HTML, use the `help-text` slot instead. */
-  "help-text"?: SlDaterange["helpText"];
+  "help-text"?: SlDaterangepicker["helpText"];
   /** Adds a clear button when the input is not empty. */
-  clearable?: SlDaterange["clearable"];
+  clearable?: SlDaterangepicker["clearable"];
   /** Disables the input. */
-  disabled?: SlDaterange["disabled"];
+  disabled?: SlDaterangepicker["disabled"];
   /** Placeholder text for the two inputs. Accepts a string in the format "startPlaceholder,endPlaceholder"
 as an HTML attribute, or a [startPlaceholder, endPlaceholder] tuple when set via JavaScript. */
-  placeholder?: SlDaterange["placeholder"];
+  placeholder?: SlDaterangepicker["placeholder"];
   /** Makes the input readonly. */
-  readonly?: SlDaterange["readonly"];
+  readonly?: SlDaterangepicker["readonly"];
   /** Makes the input a required field. */
-  required?: SlDaterange["required"];
+  required?: SlDaterangepicker["required"];
   /**  */
-  type?: SlDaterange["type"];
+  type?: SlDaterangepicker["type"];
   /** The minimum allowed date (in YYYY-MM-DD format). */
-  min?: SlDaterange["min"];
+  min?: SlDaterangepicker["min"];
   /** The maximum allowed date (in YYYY-MM-DD format). */
-  max?: SlDaterange["max"];
+  max?: SlDaterangepicker["max"];
   /** The date format to use. Defaults to YYYY-MM-DD. */
-  format?: SlDaterange["format"];
+  format?: SlDaterangepicker["format"];
   /**  */
-  startInput?: SlDaterange["startInput"];
+  startInput?: SlDaterangepicker["startInput"];
   /**  */
-  endInput?: SlDaterange["endInput"];
+  endInput?: SlDaterangepicker["endInput"];
   /**  */
-  popup?: SlDaterange["popup"];
+  popup?: SlDaterangepicker["popup"];
   /**  */
-  inputContainer?: SlDaterange["inputContainer"];
+  inputContainer?: SlDaterangepicker["inputContainer"];
   /**  */
-  calendars?: SlDaterange["calendars"];
+  calendars?: SlDaterangepicker["calendars"];
   /** The default value of the form control. Primarily used for resetting the form control. */
-  defaultValue?: SlDaterange["defaultValue"];
+  defaultValue?: SlDaterangepicker["defaultValue"];
   /**  */
-  startPlaceholder?: SlDaterange["startPlaceholder"];
+  startPlaceholder?: SlDaterangepicker["startPlaceholder"];
   /**  */
-  endPlaceholder?: SlDaterange["endPlaceholder"];
+  endPlaceholder?: SlDaterangepicker["endPlaceholder"];
   /** The start date value. */
-  startDate?: SlDaterange["startDate"];
+  startDate?: SlDaterangepicker["startDate"];
   /** The end date value. */
-  endDate?: SlDaterange["endDate"];
+  endDate?: SlDaterangepicker["endDate"];
   /** Gets the validity state object */
-  validity?: SlDaterange["validity"];
+  validity?: SlDaterangepicker["validity"];
   /** Gets the validation message */
-  validationMessage?: SlDaterange["validationMessage"];
+  validationMessage?: SlDaterangepicker["validationMessage"];
 };
 
 type SlDetailsProps = {
@@ -726,15 +726,6 @@ accessible way for users to dismiss the drawer. */
   "onsl-request-close"?: (e: CustomEvent<{ source: "close-button" | "keyboard" | "overlay" }>) => void;
 };
 
-type SlFormatBytesProps = {
-  /** The number to format in bytes. */
-  value?: SlFormatBytes["value"];
-  /** The type of unit to display. */
-  unit?: SlFormatBytes["unit"];
-  /** Determines how to display the result, e.g. "100 bytes", "100 b", or "100b". */
-  display?: SlFormatBytes["display"];
-};
-
 type SlDropdownProps = {
   /** Indicates whether or not the dropdown is open. You can toggle this attribute to show and hide the dropdown, or you
 can use the `show()` and `hide()` methods and this attribute will reflect the dropdown's open state. */
@@ -775,6 +766,15 @@ components that use a dropdown internally. */
   "onsl-after-hide"?: (e: CustomEvent<never>) => void;
 };
 
+type SlFormatBytesProps = {
+  /** The number to format in bytes. */
+  value?: SlFormatBytes["value"];
+  /** The type of unit to display. */
+  unit?: SlFormatBytes["unit"];
+  /** Determines how to display the result, e.g. "100 bytes", "100 b", or "100b". */
+  display?: SlFormatBytes["display"];
+};
+
 type SlFormatDateProps = {
   /** The date/time to format. If not set, the current date and time will be used. When passing a string, it's strongly
 recommended to use the ISO 8601 format to ensure timezones are handled correctly. To convert a date to this format
@@ -1132,6 +1132,8 @@ React reserves `key` and won't forward it to custom elements, so wrapper users c
   rel?: SlNavItem["rel"];
   /** The mode of navigation. */
   mode?: SlNavItem["mode"];
+  /** Whether the parent nav is in inline-collapsed mode. */
+  collapsed?: SlNavItem["collapsed"];
   /** Alternate label content when using Antd-style `items` configuration. */
   label?: SlNavItem["label"];
   /** Alternate icon content when using Antd-style `items` configuration. */
@@ -1165,6 +1167,8 @@ React reserves `key` and won't forward it to custom elements, so wrapper users c
   active?: SlNavSubmenu["active"];
   /** The mode of navigation. */
   mode?: SlNavSubmenu["mode"];
+  /** Whether the parent nav is in inline-collapsed mode. */
+  collapsed?: SlNavSubmenu["collapsed"];
   /**  */
   header?: SlNavSubmenu["header"];
   /**  */
@@ -1222,6 +1226,8 @@ type SlPaginationProps = {
   /**  */
   simpleMode?: SlPagination["simpleMode"];
   /**  */
+  direction?: SlPagination["direction"];
+  /**  */
   defaultCurrentPage?: SlPagination["defaultCurrentPage"];
 };
 
@@ -1501,6 +1507,14 @@ a date to this format in JavaScript, use [`date.toISOString()`](https://develope
   sync?: SlRelativeTime["sync"];
 };
 
+type SlResizeObserverProps = {
+  /** Disables the observer. */
+  disabled?: SlResizeObserver["disabled"];
+
+  /** Emitted when the element is resized. */
+  "onsl-resize"?: (e: CustomEvent<{ entries: ResizeObserverEntry[] }>) => void;
+};
+
 type SlRowProps = {
   /** Spacing between columns, can be a number or responsive object */
   gutter?: SlRow["gutter"];
@@ -1512,14 +1526,6 @@ type SlRowProps = {
   wrap?: SlRow["wrap"];
 };
 
-type SlResizeObserverProps = {
-  /** Disables the observer. */
-  disabled?: SlResizeObserver["disabled"];
-
-  /** Emitted when the element is resized. */
-  "onsl-resize"?: (e: CustomEvent<{ entries: ResizeObserverEntry[] }>) => void;
-};
-
 type SlScreenProps = {
   /** The options for the GridStack instance. */
   options?: SlScreen["options"];
@@ -1842,44 +1848,6 @@ type SlTagProps = {
   "onsl-remove"?: (e: CustomEvent<never>) => void;
 };
 
-type SlThinkProps = {
-  /** The title text shown in the status bar. Accepts plain text.
-For rich HTML content, use the `title` slot instead.
-Maps to React's `title: React.ReactNode` prop. */
-  title?: SlThink["title"];
-  /** When true, the status icon is replaced by a loading spinner
-(or the content of the `loading-icon` slot for a custom indicator).
-Maps to React's `loading: boolean | React.ReactNode` prop:
-  - `loading` (boolean) → boolean attribute
-  - `loading` (ReactNode) → use the `loading-icon` slot */
-  loading?: SlThink["loading"];
-  /** Whether the content body is expanded.
-When used without `default-expanded`, this acts as a controlled prop
-(the parent is responsible for updating it).
-When neither this nor `default-expanded` is set on the element,
-the component defaults to expanded (equivalent to React's `defaultExpanded = true`).
-Maps to React's `expanded: boolean` prop. */
-  expanded?: SlThink["expanded"];
-  /** The initial expanded state when the component is first rendered.
-Only applies if `expanded` is not set as an attribute on the element.
-Maps to React's `defaultExpanded: boolean` prop (default: `true`).
-
-Because Lit's `type: Boolean` treats attribute *presence* as `true`,
-setting `default-expanded="false"` in HTML does NOT work — this is
-consistent with all other Shoelace boolean attributes.
-To start collapsed, set the property via JS: `el.defaultExpanded = false`. */
-  "default-expanded"?: SlThink["defaultExpanded"];
-  /** When true, applies a blinking animation to the title text to signal ongoing activity.
-Maps to React's `blink: boolean` prop. */
-  blink?: SlThink["blink"];
-  /**  */
-  body?: SlThink["body"];
-  /** Emitted when the think block starts expanding (before animation). Equivalent to React's `onExpand(true)`. */
-  "onsl-expand"?: (e: CustomEvent<never>) => void;
-  /** Emitted when the think block starts collapsing (before animation). Equivalent to React's `onExpand(false)`. */
-  "onsl-collapse"?: (e: CustomEvent<never>) => void;
-};
-
 type SlTextareaProps = {
   /**  */
   title?: SlTextarea["title"];
@@ -1953,6 +1921,44 @@ keyboard on supportive devices. */
   "onsl-invalid"?: (e: CustomEvent<never>) => void;
 };
 
+type SlThinkProps = {
+  /** The title text shown in the status bar. Accepts plain text.
+For rich HTML content, use the `title` slot instead.
+Maps to React's `title: React.ReactNode` prop. */
+  title?: SlThink["title"];
+  /** When true, the status icon is replaced by a loading spinner
+(or the content of the `loading-icon` slot for a custom indicator).
+Maps to React's `loading: boolean | React.ReactNode` prop:
+  - `loading` (boolean) → boolean attribute
+  - `loading` (ReactNode) → use the `loading-icon` slot */
+  loading?: SlThink["loading"];
+  /** Whether the content body is expanded.
+When used without `default-expanded`, this acts as a controlled prop
+(the parent is responsible for updating it).
+When neither this nor `default-expanded` is set on the element,
+the component defaults to expanded (equivalent to React's `defaultExpanded = true`).
+Maps to React's `expanded: boolean` prop. */
+  expanded?: SlThink["expanded"];
+  /** The initial expanded state when the component is first rendered.
+Only applies if `expanded` is not set as an attribute on the element.
+Maps to React's `defaultExpanded: boolean` prop (default: `true`).
+
+Because Lit's `type: Boolean` treats attribute *presence* as `true`,
+setting `default-expanded="false"` in HTML does NOT work — this is
+consistent with all other Shoelace boolean attributes.
+To start collapsed, set the property via JS: `el.defaultExpanded = false`. */
+  "default-expanded"?: SlThink["defaultExpanded"];
+  /** When true, applies a blinking animation to the title text to signal ongoing activity.
+Maps to React's `blink: boolean` prop. */
+  blink?: SlThink["blink"];
+  /**  */
+  body?: SlThink["body"];
+  /** Emitted when the think block starts expanding (before animation). Equivalent to React's `onExpand(true)`. */
+  "onsl-expand"?: (e: CustomEvent<never>) => void;
+  /** Emitted when the think block starts collapsing (before animation). Equivalent to React's `onExpand(false)`. */
+  "onsl-collapse"?: (e: CustomEvent<never>) => void;
+};
+
 type SlThoughtChainProps = {
   /** Size of the thought chain nodes.
 - `'small'`: compact layout
@@ -2169,26 +2175,26 @@ export type CustomElements = {
   "sl-alert": DefineComponent<SlAlertProps>;
 
   /**
-   * Avatars are used to represent a person or object.
+   * A component for displaying animated GIFs and WEBPs that play and pause on interaction.
    * ---
    *
    *
    * ### **Events:**
-   *  - **sl-error** - The image could not be loaded. This may because of an invalid URL, a temporary network condition, or some unknown cause.
+   *  - **sl-load** - Emitted when the image loads successfully.
+   * - **sl-error** - Emitted when the image fails to load.
    *
    * ### **Slots:**
-   *  - **icon** - The default icon to use when no image or initials are present. Works best with `<sl-icon>`.
+   *  - **play-icon** - Optional play icon to use instead of the default. Works best with `<sl-icon>`.
+   * - **pause-icon** - Optional pause icon to use instead of the default. Works best with `<sl-icon>`.
    *
    * ### **CSS Properties:**
-   *  - **--size** - The size of the avatar. _(default: undefined)_
+   *  - **--control-box-size** - The size of the icon box. _(default: undefined)_
+   * - **--icon-size** - The size of the play/pause icons. _(default: undefined)_
    *
    * ### **CSS Parts:**
-   *  - **base** - The component's base wrapper.
-   * - **icon** - The container that wraps the avatar's icon.
-   * - **initials** - The container that wraps the avatar's initials.
-   * - **image** - The avatar image. Only shown when the `image` attribute is set.
+   *  - **control-box** - The container that surrounds the pause/play icons and provides their background.
    */
-  "sl-avatar": DefineComponent<SlAvatarProps>;
+  "sl-animated-image": DefineComponent<SlAnimatedImageProps>;
 
   /**
    * Animate elements declaratively with nearly 100 baked-in presets, or roll your own with custom keyframes. Powered by the [Web Animations API](https://developer.mozilla.org/en-US/docs/Web/API/Web_Animations_API).
@@ -2210,53 +2216,53 @@ export type CustomElements = {
   "sl-animation": DefineComponent<SlAnimationProps>;
 
   /**
-   * Badges are used to draw attention and display statuses or counts.
+   * Avatars are used to represent a person or object.
    * ---
    *
    *
+   * ### **Events:**
+   *  - **sl-error** - The image could not be loaded. This may because of an invalid URL, a temporary network condition, or some unknown cause.
+   *
    * ### **Slots:**
-   *  - _default_ - The badge's content.
+   *  - **icon** - The default icon to use when no image or initials are present. Works best with `<sl-icon>`.
+   *
+   * ### **CSS Properties:**
+   *  - **--size** - The size of the avatar. _(default: undefined)_
    *
    * ### **CSS Parts:**
    *  - **base** - The component's base wrapper.
+   * - **icon** - The container that wraps the avatar's icon.
+   * - **initials** - The container that wraps the avatar's initials.
+   * - **image** - The avatar image. Only shown when the `image` attribute is set.
    */
-  "sl-badge": DefineComponent<SlBadgeProps>;
+  "sl-avatar": DefineComponent<SlAvatarProps>;
 
   /**
-   * Breadcrumbs provide a group of links so users can easily navigate a website's hierarchy.
+   * Badges are used to draw attention and display statuses or counts.
    * ---
    *
    *
    * ### **Slots:**
-   *  - _default_ - One or more breadcrumb items to display.
-   * - **separator** - The separator to use between breadcrumb items. Works best with `<sl-icon>`.
+   *  - _default_ - The badge's content.
    *
    * ### **CSS Parts:**
    *  - **base** - The component's base wrapper.
    */
-  "sl-breadcrumb": DefineComponent<SlBreadcrumbProps>;
+  "sl-badge": DefineComponent<SlBadgeProps>;
 
   /**
-   * A component for displaying animated GIFs and WEBPs that play and pause on interaction.
+   * Breadcrumbs provide a group of links so users can easily navigate a website's hierarchy.
    * ---
    *
    *
-   * ### **Events:**
-   *  - **sl-load** - Emitted when the image loads successfully.
-   * - **sl-error** - Emitted when the image fails to load.
-   *
    * ### **Slots:**
-   *  - **play-icon** - Optional play icon to use instead of the default. Works best with `<sl-icon>`.
-   * - **pause-icon** - Optional pause icon to use instead of the default. Works best with `<sl-icon>`.
-   *
-   * ### **CSS Properties:**
-   *  - **--control-box-size** - The size of the icon box. _(default: undefined)_
-   * - **--icon-size** - The size of the play/pause icons. _(default: undefined)_
+   *  - _default_ - One or more breadcrumb items to display.
+   * - **separator** - The separator to use between breadcrumb items. Works best with `<sl-icon>`.
    *
    * ### **CSS Parts:**
-   *  - **control-box** - The container that surrounds the pause/play icons and provides their background.
+   *  - **base** - The component's base wrapper.
    */
-  "sl-animated-image": DefineComponent<SlAnimatedImageProps>;
+  "sl-breadcrumb": DefineComponent<SlBreadcrumbProps>;
 
   /**
    * Breadcrumb Items are used inside [breadcrumbs](/components/breadcrumb) to represent different links.
@@ -2325,32 +2331,6 @@ export type CustomElements = {
    */
   "sl-button-group": DefineComponent<SlButtonGroupProps>;
 
-  /**
-   * Cards can be used to group related subjects in a container.
-   * ---
-   *
-   *
-   * ### **Slots:**
-   *  - _default_ - The card's main content.
-   * - **header** - An optional header for the card.
-   * - **footer** - An optional footer for the card.
-   * - **image** - An optional image to render at the start of the card.
-   *
-   * ### **CSS Properties:**
-   *  - **--border-color** - The card's border color, including borders that occur inside the card. _(default: undefined)_
-   * - **--border-radius** - The border radius for the card's edges. _(default: undefined)_
-   * - **--border-width** - The width of the card's borders. _(default: undefined)_
-   * - **--padding** - The padding to use for the card's sections. _(default: undefined)_
-   *
-   * ### **CSS Parts:**
-   *  - **base** - The component's base wrapper.
-   * - **image** - The container that wraps the card's image.
-   * - **header** - The container that wraps the card's header.
-   * - **body** - The container that wraps the card's main content.
-   * - **footer** - The container that wraps the card's footer.
-   */
-  "sl-card": DefineComponent<SlCardProps>;
-
   /**
    * Carousels display an arbitrary number of content slides along a horizontal or vertical axis.
    * ---
@@ -2388,30 +2368,43 @@ export type CustomElements = {
   "sl-carousel": DefineComponent<SlCarouselProps>;
 
   /**
-   * A carousel item represent a slide within a [carousel](/components/carousel).
+   * Cards can be used to group related subjects in a container.
    * ---
    *
    *
    * ### **Slots:**
-   *  - _default_ - The carousel item's content..
+   *  - _default_ - The card's main content.
+   * - **header** - An optional header for the card.
+   * - **footer** - An optional footer for the card.
+   * - **image** - An optional image to render at the start of the card.
    *
    * ### **CSS Properties:**
-   *  - **--aspect-ratio** - The slide's aspect ratio. Inherited from the carousel by default. _(default: undefined)_
+   *  - **--border-color** - The card's border color, including borders that occur inside the card. _(default: undefined)_
+   * - **--border-radius** - The border radius for the card's edges. _(default: undefined)_
+   * - **--border-width** - The width of the card's borders. _(default: undefined)_
+   * - **--padding** - The padding to use for the card's sections. _(default: undefined)_
+   *
+   * ### **CSS Parts:**
+   *  - **base** - The component's base wrapper.
+   * - **image** - The container that wraps the card's image.
+   * - **header** - The container that wraps the card's header.
+   * - **body** - The container that wraps the card's main content.
+   * - **footer** - The container that wraps the card's footer.
    */
-  "sl-carousel-item": DefineComponent<SlCarouselItemProps>;
+  "sl-card": DefineComponent<SlCardProps>;
 
   /**
-   * Col component for grid layout system.
+   * A carousel item represent a slide within a [carousel](/components/carousel).
    * ---
    *
    *
    * ### **Slots:**
-   *  - _default_ - The default slot for content.
+   *  - _default_ - The carousel item's content..
    *
-   * ### **CSS Parts:**
-   *  - **base** - The component's base wrapper.
+   * ### **CSS Properties:**
+   *  - **--aspect-ratio** - The slide's aspect ratio. Inherited from the carousel by default. _(default: undefined)_
    */
-  "sl-col": DefineComponent<SlColProps>;
+  "sl-carousel-item": DefineComponent<SlCarouselItemProps>;
 
   /**
    * Checkboxes allow the user to toggle an option on or off.
@@ -2451,6 +2444,19 @@ export type CustomElements = {
    */
   "sl-checkbox": DefineComponent<SlCheckboxProps>;
 
+  /**
+   * Col component for grid layout system.
+   * ---
+   *
+   *
+   * ### **Slots:**
+   *  - _default_ - The default slot for content.
+   *
+   * ### **CSS Parts:**
+   *  - **base** - The component's base wrapper.
+   */
+  "sl-col": DefineComponent<SlColProps>;
+
   /**
    * Color pickers allow the user to select a color.
    * ---
@@ -2574,7 +2580,7 @@ export type CustomElements = {
    * - **reportValidity()** - 检查有效性并显示浏览器原生的有效性提示
    * - **setCustomValidity(message: _string_)** - 设置自定义有效性消息
    */
-  "sl-daterange": DefineComponent<SlDaterangeProps>;
+  "sl-daterangepicker": DefineComponent<SlDaterangepickerProps>;
 
   /**
    * Details show a brief summary and expand to show additional content.
@@ -2704,13 +2710,6 @@ export type CustomElements = {
    */
   "sl-drawer": DefineComponent<SlDrawerProps>;
 
-  /**
-   * Formats a number as a human readable bytes value.
-   * ---
-   *
-   */
-  "sl-format-bytes": DefineComponent<SlFormatBytesProps>;
-
   /**
    * Dropdowns expose additional content that "drops down" in a panel.
    * ---
@@ -2740,6 +2739,13 @@ export type CustomElements = {
    */
   "sl-dropdown": DefineComponent<SlDropdownProps>;
 
+  /**
+   * Formats a number as a human readable bytes value.
+   * ---
+   *
+   */
+  "sl-format-bytes": DefineComponent<SlFormatBytesProps>;
+
   /**
    * Formats a date/time using the specified locale and options.
    * ---
@@ -3301,30 +3307,30 @@ export type CustomElements = {
   "sl-relative-time": DefineComponent<SlRelativeTimeProps>;
 
   /**
-   * Row component for grid layout system.
+   * The Resize Observer component offers a thin, declarative interface to the [`ResizeObserver API`](https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver).
    * ---
    *
    *
-   * ### **Slots:**
-   *  - _default_ - The default slot for Col components.
+   * ### **Events:**
+   *  - **sl-resize** - Emitted when the element is resized.
    *
-   * ### **CSS Parts:**
-   *  - **base** - The component's base wrapper.
+   * ### **Slots:**
+   *  - _default_ - One or more elements to watch for resizing.
    */
-  "sl-row": DefineComponent<SlRowProps>;
+  "sl-resize-observer": DefineComponent<SlResizeObserverProps>;
 
   /**
-   * The Resize Observer component offers a thin, declarative interface to the [`ResizeObserver API`](https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver).
+   * Row component for grid layout system.
    * ---
    *
    *
-   * ### **Events:**
-   *  - **sl-resize** - Emitted when the element is resized.
-   *
    * ### **Slots:**
-   *  - _default_ - One or more elements to watch for resizing.
+   *  - _default_ - The default slot for Col components.
+   *
+   * ### **CSS Parts:**
+   *  - **base** - The component's base wrapper.
    */
-  "sl-resize-observer": DefineComponent<SlResizeObserverProps>;
+  "sl-row": DefineComponent<SlRowProps>;
 
   /**
    * Screen is a grid layout component based on gridstack.js and Shoelace.
@@ -3592,41 +3598,6 @@ export type CustomElements = {
    */
   "sl-tag": DefineComponent<SlTagProps>;
 
-  /**
-   * Think is used to display an AI model's thinking process with expandable/collapsible content.
-   * ---
-   *
-   *
-   * ### **Events:**
-   *  - **sl-expand** - Emitted when the think block starts expanding (before animation). Equivalent to React's `onExpand(true)`.
-   * - **sl-collapse** - Emitted when the think block starts collapsing (before animation). Equivalent to React's `onExpand(false)`.
-   *
-   * ### **Methods:**
-   *  - **handleExpandedChange()** - Runs AFTER the first render whenever `expanded` changes.
-   * Emits the appropriate event immediately (matching React's `onExpand` timing,
-   * which fires before the animation), then plays the expand/collapse animation.
-   *
-   * ### **Slots:**
-   *  - _default_ - The thinking content body.
-   * - **title** - Rich HTML content for the status bar title. Overrides the `title` attribute.
-   * - **icon** - A custom icon displayed in the status bar when not loading. Defaults to the Think icon.
-   * - **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.
-   *
-   * ### **CSS Properties:**
-   *  - **--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)_
-   * - **--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)_
-   *
-   * ### **CSS Parts:**
-   *  - **base** - The component's base wrapper (maps to React's `root` semantic DOM).
-   * - **status** - The clickable status bar: icon + title + chevron (maps to React's `status` semantic DOM).
-   * - **status-icon** - The icon container within the status bar.
-   * - **status-text** - The title text area within the status bar.
-   * - **chevron** - The expand/collapse chevron indicator.
-   * - **body** - The collapsible body container.
-   * - **content** - The content area inside the body (maps to React's `content` semantic DOM).
-   */
-  "sl-think": DefineComponent<SlThinkProps>;
-
   /**
    * Textareas collect data from the user and allow multiple lines of text.
    * ---
@@ -3665,6 +3636,41 @@ export type CustomElements = {
    */
   "sl-textarea": DefineComponent<SlTextareaProps>;
 
+  /**
+   * Think is used to display an AI model's thinking process with expandable/collapsible content.
+   * ---
+   *
+   *
+   * ### **Events:**
+   *  - **sl-expand** - Emitted when the think block starts expanding (before animation). Equivalent to React's `onExpand(true)`.
+   * - **sl-collapse** - Emitted when the think block starts collapsing (before animation). Equivalent to React's `onExpand(false)`.
+   *
+   * ### **Methods:**
+   *  - **handleExpandedChange()** - Runs AFTER the first render whenever `expanded` changes.
+   * Emits the appropriate event immediately (matching React's `onExpand` timing,
+   * which fires before the animation), then plays the expand/collapse animation.
+   *
+   * ### **Slots:**
+   *  - _default_ - The thinking content body.
+   * - **title** - Rich HTML content for the status bar title. Overrides the `title` attribute.
+   * - **icon** - A custom icon displayed in the status bar when not loading. Defaults to the Think icon.
+   * - **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.
+   *
+   * ### **CSS Properties:**
+   *  - **--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)_
+   * - **--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)_
+   *
+   * ### **CSS Parts:**
+   *  - **base** - The component's base wrapper (maps to React's `root` semantic DOM).
+   * - **status** - The clickable status bar: icon + title + chevron (maps to React's `status` semantic DOM).
+   * - **status-icon** - The icon container within the status bar.
+   * - **status-text** - The title text area within the status bar.
+   * - **chevron** - The expand/collapse chevron indicator.
+   * - **body** - The collapsible body container.
+   * - **content** - The content area inside the body (maps to React's `content` semantic DOM).
+   */
+  "sl-think": DefineComponent<SlThinkProps>;
+
   /**
    * ThoughtChain visualizes and tracks an Agent's call chain of Actions and Tools.
    * It renders a vertical list of nodes, each optionally with an icon, title, description,