@kdcloudjs/shoelace 1.0.22 → 1.0.23

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

@@ -2,27 +2,27 @@ import type { DefineComponent } from "vue";
 
 import type { SlAlert } from "../../components/alert/alert.component.js";
 import type { SlAnimatedImage } from "../../components/animated-image/animated-image.component.js";
+import type { SlAvatar } from "../../components/avatar/avatar.component.js";
 import type { SlAnimation } from "../../components/animation/animation.component.js";
-import type { SlBreadcrumb } from "../../components/breadcrumb/breadcrumb.component.js";
 import type { SlBadge } from "../../components/badge/badge.component.js";
-import type { SlBreadcrumbItem } from "../../components/breadcrumb-item/breadcrumb-item.component.js";
-import type { SlAvatar } from "../../components/avatar/avatar.component.js";
+import type { SlBreadcrumb } from "../../components/breadcrumb/breadcrumb.component.js";
 import type { SlButton } from "../../components/button/button.component.js";
+import type { SlBreadcrumbItem } from "../../components/breadcrumb-item/breadcrumb-item.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 { SlColorPicker } from "../../components/color-picker/color-picker.component.js";
+import type { SlCard } from "../../components/card/card.component.js";
 import type { SlCheckbox } from "../../components/checkbox/checkbox.component.js";
 import type { SlCarouselItem } from "../../components/carousel-item/carousel-item.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 { 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 { SlDropdown } from "../../components/dropdown/dropdown.component.js";
-import type { SlDaterange } from "../../components/daterange/daterange.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";
@@ -56,8 +56,8 @@ 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";
 import type { SlSpinner } from "../../components/spinner/spinner.component.js";
-import type { SlSplitPanel } from "../../components/split-panel/split-panel.component.js";
 import type { SlSwitch } from "../../components/switch/switch.component.js";
+import type { SlSplitPanel } from "../../components/split-panel/split-panel.component.js";
 import type { SlTab } from "../../components/tab/tab.component.js";
 import type { SlTabGroup } from "../../components/tab-group/tab-group.component.js";
 import type { SlTabPanel } from "../../components/tab-panel/tab-panel.component.js";
@@ -118,6 +118,22 @@ type SlAnimatedImageProps = {
   "onsl-error"?: (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 SlAnimationProps = {
   /** The name of the built-in animation to use. For custom animations, use the `keyframes` prop. */
   name?: SlAnimation["name"];
@@ -160,16 +176,6 @@ value can be changed without causing the animation to restart. */
   "onsl-start"?: (e: CustomEvent<never>) => void;
 };
 
-type SlBreadcrumbProps = {
-  /** The label to use for the breadcrumb control. This will not be shown on the screen, but it will be announced by
-screen readers and other assistive devices to provide more context for users. */
-  label?: SlBreadcrumb["label"];
-  /**  */
-  defaultSlot?: SlBreadcrumb["defaultSlot"];
-  /**  */
-  separatorSlot?: SlBreadcrumb["separatorSlot"];
-};
-
 type SlBadgeProps = {
   /** The badge's theme variant. */
   variant?: SlBadge["variant"];
@@ -179,32 +185,14 @@ type SlBadgeProps = {
   pulse?: SlBadge["pulse"];
 };
 
-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. */
-  href?: SlBreadcrumbItem["href"];
-  /** Tells the browser where to open the link. Only used when `href` is set. */
-  target?: SlBreadcrumbItem["target"];
-  /** The `rel` attribute to use on the link. Only used when `href` is set. */
-  rel?: SlBreadcrumbItem["rel"];
+type SlBreadcrumbProps = {
+  /** The label to use for the breadcrumb control. This will not be shown on the screen, but it will be announced by
+screen readers and other assistive devices to provide more context for users. */
+  label?: SlBreadcrumb["label"];
   /**  */
-  defaultSlot?: SlBreadcrumbItem["defaultSlot"];
-};
-
-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;
+  defaultSlot?: SlBreadcrumb["defaultSlot"];
+  /**  */
+  separatorSlot?: SlBreadcrumb["separatorSlot"];
 };
 
 type SlButtonProps = {
@@ -276,6 +264,18 @@ value of this attribute must be an id of a form in the same document or shadow r
   "onsl-invalid"?: (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. */
+  href?: SlBreadcrumbItem["href"];
+  /** Tells the browser where to open the link. Only used when `href` is set. */
+  target?: SlBreadcrumbItem["target"];
+  /** The `rel` attribute to use on the link. Only used when `href` is set. */
+  rel?: SlBreadcrumbItem["rel"];
+  /**  */
+  defaultSlot?: SlBreadcrumbItem["defaultSlot"];
+};
+
 type SlButtonGroupProps = {
   /** A label to use for the button group. This won't be displayed on the screen, but it will be announced by assistive
 devices when interacting with the control and is strongly recommended. */
@@ -286,8 +286,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"];
@@ -322,6 +320,54 @@ greater than one. It can't be higher than `slides-per-page`. */
   "onsl-slide-change"?: (e: CustomEvent<{ index: number; slide: SlCarouselItem }>) => void;
 };
 
+type SlCardProps = {};
+
+type SlCheckboxProps = {
+  /**  */
+  title?: SlCheckbox["title"];
+  /** The name of the checkbox, submitted as a name/value pair with form data. */
+  name?: SlCheckbox["name"];
+  /** The current value of the checkbox, submitted as a name/value pair with form data. */
+  value?: SlCheckbox["value"];
+  /** The checkbox's size. */
+  size?: SlCheckbox["size"];
+  /** Disables the checkbox. */
+  disabled?: SlCheckbox["disabled"];
+  /** Draws the checkbox in a checked state. */
+  checked?: SlCheckbox["checked"];
+  /** Draws the checkbox in an indeterminate state. This is usually applied to checkboxes that represents a "select
+all/none" behavior when associated checkboxes have a mix of checked and unchecked states. */
+  indeterminate?: SlCheckbox["indeterminate"];
+  /** By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you
+to place the form control outside of a form and associate it with the form that has this `id`. The form must be in
+the same document or shadow root for this to work. */
+  form?: SlCheckbox["form"];
+  /** Makes the checkbox a required field. */
+  required?: SlCheckbox["required"];
+  /** The checkbox's help text. If you need to display HTML, use the `help-text` slot instead. */
+  "help-text"?: SlCheckbox["helpText"];
+  /**  */
+  input?: SlCheckbox["input"];
+  /** The default value of the form control. Primarily used for resetting the form control. */
+  defaultChecked?: SlCheckbox["defaultChecked"];
+  /** Gets the validity state object */
+  validity?: SlCheckbox["validity"];
+  /** Gets the validation message */
+  validationMessage?: SlCheckbox["validationMessage"];
+  /** Emitted when the checkbox loses focus. */
+  "onsl-blur"?: (e: CustomEvent<never>) => void;
+  /** Emitted when the checked state changes. */
+  "onsl-change"?: (e: CustomEvent<never>) => void;
+  /** Emitted when the checkbox gains focus. */
+  "onsl-focus"?: (e: CustomEvent<never>) => void;
+  /** Emitted when the checkbox receives input. */
+  "onsl-input"?: (e: CustomEvent<never>) => void;
+  /** Emitted when the form control has been checked for validity and its constraints aren't satisfied. */
+  "onsl-invalid"?: (e: CustomEvent<never>) => void;
+};
+
+type SlCarouselItemProps = {};
+
 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
@@ -388,52 +434,6 @@ the same document or shadow root for this to work. */
   "onsl-invalid"?: (e: CustomEvent<never>) => void;
 };
 
-type SlCheckboxProps = {
-  /**  */
-  title?: SlCheckbox["title"];
-  /** The name of the checkbox, submitted as a name/value pair with form data. */
-  name?: SlCheckbox["name"];
-  /** The current value of the checkbox, submitted as a name/value pair with form data. */
-  value?: SlCheckbox["value"];
-  /** The checkbox's size. */
-  size?: SlCheckbox["size"];
-  /** Disables the checkbox. */
-  disabled?: SlCheckbox["disabled"];
-  /** Draws the checkbox in a checked state. */
-  checked?: SlCheckbox["checked"];
-  /** Draws the checkbox in an indeterminate state. This is usually applied to checkboxes that represents a "select
-all/none" behavior when associated checkboxes have a mix of checked and unchecked states. */
-  indeterminate?: SlCheckbox["indeterminate"];
-  /** By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you
-to place the form control outside of a form and associate it with the form that has this `id`. The form must be in
-the same document or shadow root for this to work. */
-  form?: SlCheckbox["form"];
-  /** Makes the checkbox a required field. */
-  required?: SlCheckbox["required"];
-  /** The checkbox's help text. If you need to display HTML, use the `help-text` slot instead. */
-  "help-text"?: SlCheckbox["helpText"];
-  /**  */
-  input?: SlCheckbox["input"];
-  /** The default value of the form control. Primarily used for resetting the form control. */
-  defaultChecked?: SlCheckbox["defaultChecked"];
-  /** Gets the validity state object */
-  validity?: SlCheckbox["validity"];
-  /** Gets the validation message */
-  validationMessage?: SlCheckbox["validationMessage"];
-  /** Emitted when the checkbox loses focus. */
-  "onsl-blur"?: (e: CustomEvent<never>) => void;
-  /** Emitted when the checked state changes. */
-  "onsl-change"?: (e: CustomEvent<never>) => void;
-  /** Emitted when the checkbox gains focus. */
-  "onsl-focus"?: (e: CustomEvent<never>) => void;
-  /** Emitted when the checkbox receives input. */
-  "onsl-input"?: (e: CustomEvent<never>) => void;
-  /** Emitted when the form control has been checked for validity and its constraints aren't satisfied. */
-  "onsl-invalid"?: (e: CustomEvent<never>) => void;
-};
-
-type SlCarouselItemProps = {};
-
 type SlCopyButtonProps = {
   /** The text value to copy. */
   value?: SlCopyButton["value"];
@@ -524,6 +524,66 @@ type SlDatepickerProps = {
   calendar?: SlDatepicker["calendar"];
 };
 
+type SlDaterangeProps = {
+  /** The name of the input, submitted as a name/value pair with form data. */
+  name?: SlDaterange["name"];
+  /** The current value of the input, submitted as a name/value pair with form data. */
+  value?: SlDaterange["value"];
+  /** The input's size. */
+  size?: SlDaterange["size"];
+  /** Draws a filled input. */
+  filled?: SlDaterange["filled"];
+  /** Draws a pill-style input with rounded edges. */
+  pill?: SlDaterange["pill"];
+  /** The input's label. If you need to display HTML, use the `label` slot instead. */
+  label?: SlDaterange["label"];
+  /** The input's help text. If you need to display HTML, use the `help-text` slot instead. */
+  "help-text"?: SlDaterange["helpText"];
+  /** Adds a clear button when the input is not empty. */
+  clearable?: SlDaterange["clearable"];
+  /** Disables the input. */
+  disabled?: SlDaterange["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"];
+  /** Makes the input readonly. */
+  readonly?: SlDaterange["readonly"];
+  /** Makes the input a required field. */
+  required?: SlDaterange["required"];
+  /**  */
+  type?: SlDaterange["type"];
+  /** The minimum allowed date (in YYYY-MM-DD format). */
+  min?: SlDaterange["min"];
+  /** The maximum allowed date (in YYYY-MM-DD format). */
+  max?: SlDaterange["max"];
+  /** The date format to use. Defaults to YYYY-MM-DD. */
+  format?: SlDaterange["format"];
+  /**  */
+  startInput?: SlDaterange["startInput"];
+  /**  */
+  endInput?: SlDaterange["endInput"];
+  /**  */
+  popup?: SlDaterange["popup"];
+  /**  */
+  inputContainer?: SlDaterange["inputContainer"];
+  /**  */
+  calendars?: SlDaterange["calendars"];
+  /** The default value of the form control. Primarily used for resetting the form control. */
+  defaultValue?: SlDaterange["defaultValue"];
+  /**  */
+  startPlaceholder?: SlDaterange["startPlaceholder"];
+  /**  */
+  endPlaceholder?: SlDaterange["endPlaceholder"];
+  /** The start date value. */
+  startDate?: SlDaterange["startDate"];
+  /** The end date value. */
+  endDate?: SlDaterange["endDate"];
+  /** Gets the validity state object */
+  validity?: SlDaterange["validity"];
+  /** Gets the validation message */
+  validationMessage?: SlDaterange["validationMessage"];
+};
+
 type SlDetailsProps = {
   /** Indicates whether or not the details is open. You can toggle this attribute to show and hide the details, or you
 can use the `show()` and `hide()` methods and this attribute will reflect the details' open state. */
@@ -671,66 +731,6 @@ components that use a dropdown internally. */
   "onsl-after-hide"?: (e: CustomEvent<never>) => void;
 };
 
-type SlDaterangeProps = {
-  /** The name of the input, submitted as a name/value pair with form data. */
-  name?: SlDaterange["name"];
-  /** The current value of the input, submitted as a name/value pair with form data. */
-  value?: SlDaterange["value"];
-  /** The input's size. */
-  size?: SlDaterange["size"];
-  /** Draws a filled input. */
-  filled?: SlDaterange["filled"];
-  /** Draws a pill-style input with rounded edges. */
-  pill?: SlDaterange["pill"];
-  /** The input's label. If you need to display HTML, use the `label` slot instead. */
-  label?: SlDaterange["label"];
-  /** The input's help text. If you need to display HTML, use the `help-text` slot instead. */
-  "help-text"?: SlDaterange["helpText"];
-  /** Adds a clear button when the input is not empty. */
-  clearable?: SlDaterange["clearable"];
-  /** Disables the input. */
-  disabled?: SlDaterange["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"];
-  /** Makes the input readonly. */
-  readonly?: SlDaterange["readonly"];
-  /** Makes the input a required field. */
-  required?: SlDaterange["required"];
-  /**  */
-  type?: SlDaterange["type"];
-  /** The minimum allowed date (in YYYY-MM-DD format). */
-  min?: SlDaterange["min"];
-  /** The maximum allowed date (in YYYY-MM-DD format). */
-  max?: SlDaterange["max"];
-  /** The date format to use. Defaults to YYYY-MM-DD. */
-  format?: SlDaterange["format"];
-  /**  */
-  startInput?: SlDaterange["startInput"];
-  /**  */
-  endInput?: SlDaterange["endInput"];
-  /**  */
-  popup?: SlDaterange["popup"];
-  /**  */
-  inputContainer?: SlDaterange["inputContainer"];
-  /**  */
-  calendars?: SlDaterange["calendars"];
-  /** The default value of the form control. Primarily used for resetting the form control. */
-  defaultValue?: SlDaterange["defaultValue"];
-  /**  */
-  startPlaceholder?: SlDaterange["startPlaceholder"];
-  /**  */
-  endPlaceholder?: SlDaterange["endPlaceholder"];
-  /** The start date value. */
-  startDate?: SlDaterange["startDate"];
-  /** The end date value. */
-  endDate?: SlDaterange["endDate"];
-  /** Gets the validity state object */
-  validity?: SlDaterange["validity"];
-  /** Gets the validation message */
-  validationMessage?: SlDaterange["validationMessage"];
-};
-
 type SlFormatBytesProps = {
   /** The number to format in bytes. */
   value?: SlFormatBytes["value"];
@@ -1075,6 +1075,10 @@ type SlNavGroupProps = {
 type SlNavItemProps = {
   /** A stable key used by `sl-nav` to track selection. */
   key?: SlNavItem["key"];
+  /** React-safe alias for `key`.
+
+React reserves `key` and won't forward it to custom elements, so wrapper users can pass `itemKey` instead. */
+  "item-key"?: SlNavItem["itemKey"];
   /** Matches Antd's `danger` item flag. */
   danger?: SlNavItem["danger"];
   /** Tooltip text, primarily used when the menu is collapsed. */
@@ -1106,6 +1110,10 @@ type SlNavItemProps = {
 type SlNavSubmenuProps = {
   /** A stable key used by `sl-nav` to track open state. */
   key?: SlNavSubmenu["key"];
+  /** React-safe alias for `key`.
+
+React reserves `key` and won't forward it to custom elements, so wrapper users can pass `itemKey` instead. */
+  "item-key"?: SlNavSubmenu["itemKey"];
   /** Indicates whether or not the submenu is open. */
   open?: SlNavSubmenu["open"];
   /** Indicates if this submenu is nested within another submenu. */
@@ -1579,31 +1587,6 @@ type SlSkeletonProps = {
 
 type SlSpinnerProps = {};
 
-type SlSplitPanelProps = {
-  /** The current position of the divider from the primary panel's edge as a percentage 0-100. Defaults to 50% of the
-container's initial size. */
-  position?: SlSplitPanel["position"];
-  /** The current position of the divider from the primary panel's edge in pixels. */
-  "position-in-pixels"?: SlSplitPanel["positionInPixels"];
-  /** Draws the split panel in a vertical orientation with the start and end panels stacked. */
-  vertical?: SlSplitPanel["vertical"];
-  /** Disables resizing. Note that the position may still change as a result of resizing the host element. */
-  disabled?: SlSplitPanel["disabled"];
-  /** If no primary panel is designated, both panels will resize proportionally when the host element is resized. If a
-primary panel is designated, it will maintain its size and the other panel will grow or shrink as needed when the
-host element is resized. */
-  primary?: SlSplitPanel["primary"];
-  /** Either one or more space-separated values at which the divider should snap, in pixels, percentages, or repeat expressions e.g. `'100px 50% 500px' or `repeat(50%) 10px`,
-or a function which takes in a `SnapFunctionParams`, and returns a position to snap to, e.g. `({ pos }) => Math.round(pos / 8) * 8`. */
-  snap?: SlSplitPanel["snap"];
-  /** How close the divider must be to a snap point until snapping occurs. */
-  "snap-threshold"?: SlSplitPanel["snapThreshold"];
-  /**  */
-  divider?: SlSplitPanel["divider"];
-  /** Emitted when the divider's position changes. */
-  "onsl-reposition"?: (e: CustomEvent<never>) => void;
-};
-
 type SlSwitchProps = {
   /**  */
   title?: SlSwitch["title"];
@@ -1645,6 +1628,31 @@ the same document or shadow root for this to work. */
   "onsl-invalid"?: (e: CustomEvent<never>) => void;
 };
 
+type SlSplitPanelProps = {
+  /** The current position of the divider from the primary panel's edge as a percentage 0-100. Defaults to 50% of the
+container's initial size. */
+  position?: SlSplitPanel["position"];
+  /** The current position of the divider from the primary panel's edge in pixels. */
+  "position-in-pixels"?: SlSplitPanel["positionInPixels"];
+  /** Draws the split panel in a vertical orientation with the start and end panels stacked. */
+  vertical?: SlSplitPanel["vertical"];
+  /** Disables resizing. Note that the position may still change as a result of resizing the host element. */
+  disabled?: SlSplitPanel["disabled"];
+  /** If no primary panel is designated, both panels will resize proportionally when the host element is resized. If a
+primary panel is designated, it will maintain its size and the other panel will grow or shrink as needed when the
+host element is resized. */
+  primary?: SlSplitPanel["primary"];
+  /** Either one or more space-separated values at which the divider should snap, in pixels, percentages, or repeat expressions e.g. `'100px 50% 500px' or `repeat(50%) 10px`,
+or a function which takes in a `SnapFunctionParams`, and returns a position to snap to, e.g. `({ pos }) => Math.round(pos / 8) * 8`. */
+  snap?: SlSplitPanel["snap"];
+  /** How close the divider must be to a snap point until snapping occurs. */
+  "snap-threshold"?: SlSplitPanel["snapThreshold"];
+  /**  */
+  divider?: SlSplitPanel["divider"];
+  /** Emitted when the divider's position changes. */
+  "onsl-reposition"?: (e: CustomEvent<never>) => void;
+};
+
 type SlTabProps = {
   /** The name of the tab panel this tab is associated with. The panel must be located in the same tab group. */
   panel?: SlTab["panel"];
@@ -2029,6 +2037,28 @@ export type CustomElements = {
    */
   "sl-animated-image": DefineComponent<SlAnimatedImageProps>;
 
+  /**
+   * 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:**
+   *  - **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-avatar": DefineComponent<SlAvatarProps>;
+
   /**
    * 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).
    * ---
@@ -2048,20 +2078,6 @@ export type CustomElements = {
    */
   "sl-animation": DefineComponent<SlAnimationProps>;
 
-  /**
-   * Breadcrumbs provide a group of links so users can easily navigate a website's hierarchy.
-   * ---
-   *
-   *
-   * ### **Slots:**
-   *  - _default_ - One or more breadcrumb items to display.
-   * - **separator** - The separator to use between breadcrumb items. Works best with `<sl-icon>`.
-   *
-   * ### **CSS Parts:**
-   *  - **base** - The component's base wrapper.
-   */
-  "sl-breadcrumb": DefineComponent<SlBreadcrumbProps>;
-
   /**
    * Badges are used to draw attention and display statuses or counts.
    * ---
@@ -2073,49 +2089,21 @@ export type CustomElements = {
    * ### **CSS Parts:**
    *  - **base** - The component's base wrapper.
    */
-  "sl-badge": DefineComponent<SlBadgeProps>;
-
-  /**
-   * Breadcrumb Items are used inside [breadcrumbs](/components/breadcrumb) to represent different links.
-   * ---
-   *
-   *
-   * ### **Slots:**
-   *  - _default_ - The breadcrumb item's label.
-   * - **prefix** - An optional prefix, usually an icon or icon button.
-   * - **suffix** - An optional suffix, usually an icon or icon button.
-   * - **separator** - The separator to use for the breadcrumb item. This will only change the separator for this item. If you want to change it for all items in the group, set the separator on `<sl-breadcrumb>` instead.
-   *
-   * ### **CSS Parts:**
-   *  - **base** - The component's base wrapper.
-   * - **label** - The breadcrumb item's label.
-   * - **prefix** - The container that wraps the prefix.
-   * - **suffix** - The container that wraps the suffix.
-   * - **separator** - The container that wraps the separator.
-   */
-  "sl-breadcrumb-item": DefineComponent<SlBreadcrumbItemProps>;
+  "sl-badge": DefineComponent<SlBadgeProps>;
 
   /**
-   * Avatars are used to represent a person or object.
+   * Breadcrumbs provide a group of links so users can easily navigate a website's hierarchy.
    * ---
    *
    *
-   * ### **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:**
-   *  - **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)_
+   *  - _default_ - One or more breadcrumb items to display.
+   * - **separator** - The separator to use between breadcrumb items. Works best with `<sl-icon>`.
    *
    * ### **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-avatar": DefineComponent<SlAvatarProps>;
+  "sl-breadcrumb": DefineComponent<SlBreadcrumbProps>;
 
   /**
    * Buttons represent actions that are available to the user.
@@ -2152,43 +2140,37 @@ export type CustomElements = {
   "sl-button": DefineComponent<SlButtonProps>;
 
   /**
-   * Button groups can be used to group related buttons into sections.
+   * Breadcrumb Items are used inside [breadcrumbs](/components/breadcrumb) to represent different links.
    * ---
    *
    *
    * ### **Slots:**
-   *  - _default_ - One or more `<sl-button>` elements to display in the button group.
+   *  - _default_ - The breadcrumb item's label.
+   * - **prefix** - An optional prefix, usually an icon or icon button.
+   * - **suffix** - An optional suffix, usually an icon or icon button.
+   * - **separator** - The separator to use for the breadcrumb item. This will only change the separator for this item. If you want to change it for all items in the group, set the separator on `<sl-breadcrumb>` instead.
    *
    * ### **CSS Parts:**
    *  - **base** - The component's base wrapper.
+   * - **label** - The breadcrumb item's label.
+   * - **prefix** - The container that wraps the prefix.
+   * - **suffix** - The container that wraps the suffix.
+   * - **separator** - The container that wraps the separator.
    */
-  "sl-button-group": DefineComponent<SlButtonGroupProps>;
+  "sl-breadcrumb-item": DefineComponent<SlBreadcrumbItemProps>;
 
   /**
-   * Cards can be used to group related subjects in a container.
+   * Button groups can be used to group related buttons into sections.
    * ---
    *
    *
    * ### **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)_
+   *  - _default_ - One or more `<sl-button>` elements to display in the button group.
    *
    * ### **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>;
+  "sl-button-group": DefineComponent<SlButtonGroupProps>;
 
   /**
    * Carousels display an arbitrary number of content slides along a horizontal or vertical axis.
@@ -2227,66 +2209,30 @@ export type CustomElements = {
   "sl-carousel": DefineComponent<SlCarouselProps>;
 
   /**
-   * Color pickers allow the user to select a color.
+   * Cards can be used to group related subjects in a container.
    * ---
    *
    *
-   * ### **Events:**
-   *  - **sl-blur** - Emitted when the color picker loses focus.
-   * - **sl-change** - Emitted when the color picker's value changes.
-   * - **sl-focus** - Emitted when the color picker receives focus.
-   * - **sl-input** - Emitted when the color picker receives input.
-   * - **sl-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.
-   *
-   * ### **Methods:**
-   *  - **focus(options: _FocusOptions_)** - Sets focus on the color picker.
-   * - **blur()** - Removes focus from the color picker.
-   * - **getFormattedValue(format: _'hex' | 'hexa' | 'rgb' | 'rgba' | 'hsl' | 'hsla' | 'hsv' | 'hsva'_)** - Returns the current value as a string in the specified format.
-   * - **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.
-   * - **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.
-   * - **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.
-   * - **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.
-   *
    * ### **Slots:**
-   *  - **label** - The color picker's form label. Alternatively, you can use the `label` attribute.
+   *  - _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:**
-   *  - **--grid-width** - The width of the color grid. _(default: undefined)_
-   * - **--grid-height** - The height of the color grid. _(default: undefined)_
-   * - **--grid-handle-size** - The size of the color grid's handle. _(default: undefined)_
-   * - **--slider-height** - The height of the hue and alpha sliders. _(default: undefined)_
-   * - **--slider-handle-size** - The diameter of the slider's handle. _(default: undefined)_
-   * - **--swatch-size** - The size of each predefined color swatch. _(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.
-   * - **trigger** - The color picker's dropdown trigger.
-   * - **swatches** - The container that holds the swatches.
-   * - **swatch** - Each individual swatch.
-   * - **grid** - The color grid.
-   * - **grid-handle** - The color grid's handle.
-   * - **slider** - Hue and opacity sliders.
-   * - **slider-handle** - Hue and opacity slider handles.
-   * - **hue-slider** - The hue slider.
-   * - **hue-slider-handle** - The hue slider's handle.
-   * - **opacity-slider** - The opacity slider.
-   * - **opacity-slider-handle** - The opacity slider's handle.
-   * - **preview** - The preview color.
-   * - **input** - The text input.
-   * - **eye-dropper-button** - The eye dropper button.
-   * - **eye-dropper-button__base** - The eye dropper button's exported `button` part.
-   * - **eye-dropper-button__prefix** - The eye dropper button's exported `prefix` part.
-   * - **eye-dropper-button__label** - The eye dropper button's exported `label` part.
-   * - **eye-dropper-button__suffix** - The eye dropper button's exported `suffix` part.
-   * - **eye-dropper-button__caret** - The eye dropper button's exported `caret` part.
-   * - **format-button** - The format button.
-   * - **format-button__base** - The format button's exported `button` part.
-   * - **format-button__prefix** - The format button's exported `prefix` part.
-   * - **format-button__label** - The format button's exported `label` part.
-   * - **format-button__suffix** - The format button's exported `suffix` part.
-   * - **format-button__caret** - The format button's exported `caret` part.
+   * - **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-color-picker": DefineComponent<SlColorPickerProps>;
+  "sl-card": DefineComponent<SlCardProps>;
 
   /**
    * Checkboxes allow the user to toggle an option on or off.
@@ -2339,6 +2285,68 @@ export type CustomElements = {
    */
   "sl-carousel-item": DefineComponent<SlCarouselItemProps>;
 
+  /**
+   * Color pickers allow the user to select a color.
+   * ---
+   *
+   *
+   * ### **Events:**
+   *  - **sl-blur** - Emitted when the color picker loses focus.
+   * - **sl-change** - Emitted when the color picker's value changes.
+   * - **sl-focus** - Emitted when the color picker receives focus.
+   * - **sl-input** - Emitted when the color picker receives input.
+   * - **sl-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.
+   *
+   * ### **Methods:**
+   *  - **focus(options: _FocusOptions_)** - Sets focus on the color picker.
+   * - **blur()** - Removes focus from the color picker.
+   * - **getFormattedValue(format: _'hex' | 'hexa' | 'rgb' | 'rgba' | 'hsl' | 'hsla' | 'hsv' | 'hsva'_)** - Returns the current value as a string in the specified format.
+   * - **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.
+   * - **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.
+   * - **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.
+   * - **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.
+   *
+   * ### **Slots:**
+   *  - **label** - The color picker's form label. Alternatively, you can use the `label` attribute.
+   *
+   * ### **CSS Properties:**
+   *  - **--grid-width** - The width of the color grid. _(default: undefined)_
+   * - **--grid-height** - The height of the color grid. _(default: undefined)_
+   * - **--grid-handle-size** - The size of the color grid's handle. _(default: undefined)_
+   * - **--slider-height** - The height of the hue and alpha sliders. _(default: undefined)_
+   * - **--slider-handle-size** - The diameter of the slider's handle. _(default: undefined)_
+   * - **--swatch-size** - The size of each predefined color swatch. _(default: undefined)_
+   *
+   * ### **CSS Parts:**
+   *  - **base** - The component's base wrapper.
+   * - **trigger** - The color picker's dropdown trigger.
+   * - **swatches** - The container that holds the swatches.
+   * - **swatch** - Each individual swatch.
+   * - **grid** - The color grid.
+   * - **grid-handle** - The color grid's handle.
+   * - **slider** - Hue and opacity sliders.
+   * - **slider-handle** - Hue and opacity slider handles.
+   * - **hue-slider** - The hue slider.
+   * - **hue-slider-handle** - The hue slider's handle.
+   * - **opacity-slider** - The opacity slider.
+   * - **opacity-slider-handle** - The opacity slider's handle.
+   * - **preview** - The preview color.
+   * - **input** - The text input.
+   * - **eye-dropper-button** - The eye dropper button.
+   * - **eye-dropper-button__base** - The eye dropper button's exported `button` part.
+   * - **eye-dropper-button__prefix** - The eye dropper button's exported `prefix` part.
+   * - **eye-dropper-button__label** - The eye dropper button's exported `label` part.
+   * - **eye-dropper-button__suffix** - The eye dropper button's exported `suffix` part.
+   * - **eye-dropper-button__caret** - The eye dropper button's exported `caret` part.
+   * - **format-button** - The format button.
+   * - **format-button__base** - The format button's exported `button` part.
+   * - **format-button__prefix** - The format button's exported `prefix` part.
+   * - **format-button__label** - The format button's exported `label` part.
+   * - **format-button__suffix** - The format button's exported `suffix` part.
+   * - **format-button__caret** - The format button's exported `caret` part.
+   */
+  "sl-color-picker": DefineComponent<SlColorPickerProps>;
+
   /**
    * Copies text data to the clipboard when the user clicks the trigger.
    * ---
@@ -2389,6 +2397,19 @@ export type CustomElements = {
    */
   "sl-datepicker": DefineComponent<SlDatepickerProps>;
 
+  /**
+   *
+   * ---
+   *
+   *
+   * ### **Methods:**
+   *  - **checkValidity()** - 检查有效性并触发 sl-invalid 事件（如果无效）
+   * - **getForm(): _HTMLFormElement | null_** - 获取表单引用
+   * - **reportValidity()** - 检查有效性并显示浏览器原生的有效性提示
+   * - **setCustomValidity(message: _string_)** - 设置自定义有效性消息
+   */
+  "sl-daterange": DefineComponent<SlDaterangeProps>;
+
   /**
    * Details show a brief summary and expand to show additional content.
    * ---
@@ -2546,19 +2567,6 @@ export type CustomElements = {
    */
   "sl-dropdown": DefineComponent<SlDropdownProps>;
 
-  /**
-   *
-   * ---
-   *
-   *
-   * ### **Methods:**
-   *  - **checkValidity()** - 检查有效性并触发 sl-invalid 事件（如果无效）
-   * - **getForm(): _HTMLFormElement | null_** - 获取表单引用
-   * - **reportValidity()** - 检查有效性并显示浏览器原生的有效性提示
-   * - **setCustomValidity(message: _string_)** - 设置自定义有效性消息
-   */
-  "sl-daterange": DefineComponent<SlDaterangeProps>;
-
   /**
    * Formats a number as a human readable bytes value.
    * ---
@@ -3242,33 +3250,6 @@ export type CustomElements = {
    */
   "sl-spinner": DefineComponent<SlSpinnerProps>;
 
-  /**
-   * Split panels display two adjacent panels, allowing the user to reposition them.
-   * ---
-   *
-   *
-   * ### **Events:**
-   *  - **sl-reposition** - Emitted when the divider's position changes.
-   *
-   * ### **Slots:**
-   *  - **start** - Content to place in the start panel.
-   * - **end** - Content to place in the end panel.
-   * - **divider** - The divider. Useful for slotting in a custom icon that renders as a handle.
-   *
-   * ### **CSS Properties:**
-   *  - **--divider-width** - The width of the visible divider. _(default: 4px)_
-   * - **--divider-hit-area** - The invisible region around the divider where dragging can occur. This is usually wider than the divider to facilitate easier dragging. _(default: 12px)_
-   * - **--min** - The minimum allowed size of the primary panel. _(default: 0)_
-   * - **--max** - The maximum allowed size of the primary panel. _(default: 100%)_
-   *
-   * ### **CSS Parts:**
-   *  - **start** - The start panel.
-   * - **end** - The end panel.
-   * - **panel** - Targets both the start and end panels.
-   * - **divider** - The divider that separates the start and end panels.
-   */
-  "sl-split-panel": DefineComponent<SlSplitPanelProps>;
-
   /**
    * Switches allow the user to toggle an option on or off.
    * ---
@@ -3308,6 +3289,33 @@ export type CustomElements = {
    */
   "sl-switch": DefineComponent<SlSwitchProps>;
 
+  /**
+   * Split panels display two adjacent panels, allowing the user to reposition them.
+   * ---
+   *
+   *
+   * ### **Events:**
+   *  - **sl-reposition** - Emitted when the divider's position changes.
+   *
+   * ### **Slots:**
+   *  - **start** - Content to place in the start panel.
+   * - **end** - Content to place in the end panel.
+   * - **divider** - The divider. Useful for slotting in a custom icon that renders as a handle.
+   *
+   * ### **CSS Properties:**
+   *  - **--divider-width** - The width of the visible divider. _(default: 4px)_
+   * - **--divider-hit-area** - The invisible region around the divider where dragging can occur. This is usually wider than the divider to facilitate easier dragging. _(default: 12px)_
+   * - **--min** - The minimum allowed size of the primary panel. _(default: 0)_
+   * - **--max** - The maximum allowed size of the primary panel. _(default: 100%)_
+   *
+   * ### **CSS Parts:**
+   *  - **start** - The start panel.
+   * - **end** - The end panel.
+   * - **panel** - Targets both the start and end panels.
+   * - **divider** - The divider that separates the start and end panels.
+   */
+  "sl-split-panel": DefineComponent<SlSplitPanelProps>;
+
   /**
    * Tabs are used inside [tab groups](/components/tab-group) to represent and activate [tab panels](/components/tab-panel).
    * ---