@bitrix24/b24ui-nuxt 2.1.17 → 2.3.0

package/dist/runtime/components/ScrollArea.vue.d.ts

@@ -0,0 +1,85 @@
+import type { AppConfig } from '@nuxt/schema';
+import type { VirtualItem, VirtualizerOptions } from '@tanstack/vue-virtual';
+import theme from '#build/b24ui/scroll-area';
+import type { ComponentConfig } from '../types/tv';
+type ScrollArea = ComponentConfig<typeof theme, AppConfig, 'scrollArea'>;
+export interface ScrollAreaVirtualizeOptions extends Partial<Omit<VirtualizerOptions<Element, Element>, 'count' | 'getScrollElement' | 'horizontal' | 'isRtl' | 'estimateSize' | 'lanes' | 'enabled'>> {
+    /**
+     * Estimated size (in px) of each item along the scroll axis. Can be a number or a function.
+     * @defaultValue 100
+     */
+    estimateSize?: number | ((index: number) => number);
+    /**
+     * Number of lanes for multi-column/row layouts.
+     * For responsive lane counts, use a computed property with viewport/container size:
+     * @example
+     * ```ts
+     * const { width } = useWindowSize()
+     * const lanes = computed(() => Math.floor(width.value / 300))
+     * ```
+     * @defaultValue undefined
+     */
+    lanes?: number;
+}
+export type ScrollAreaItem = any;
+export interface ScrollAreaProps<T extends ScrollAreaItem = ScrollAreaItem> {
+    /**
+     * The element or component this component should render as.
+     * @defaultValue 'div'
+     */
+    as?: any;
+    /**
+     * The scroll direction.
+     * @defaultValue 'vertical'
+     */
+    orientation?: ScrollArea['variants']['orientation'];
+    /**
+     * Array of items to render.
+     */
+    items?: T[];
+    /**
+     * Enable virtualization for large lists.
+     * @see https://tanstack.com/virtual/latest/docs/api/virtualizer#options
+     * @defaultValue false
+     */
+    virtualize?: boolean | ScrollAreaVirtualizeOptions;
+    class?: any;
+    b24ui?: ScrollArea['slots'];
+}
+export interface ScrollAreaSlots<T extends ScrollAreaItem = ScrollAreaItem> {
+    default(props: {
+        item: T;
+        index: number;
+        virtualItem?: VirtualItem;
+    } | Record<string, never>): any;
+}
+export interface ScrollAreaEmits {
+    /**
+     * Emitted when scroll state changes
+     * @param isScrolling - Whether the list is currently being scrolled
+     */
+    scroll: [isScrolling: boolean];
+}
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: <T extends ScrollAreaItem>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: import("vue").PublicProps & __VLS_PrettifyLocal<ScrollAreaProps<T> & {
+        onScroll?: ((isScrolling: boolean) => any) | undefined;
+    }> & (typeof globalThis extends {
+        __VLS_PROPS_FALLBACK: infer P;
+    } ? P : {});
+    expose: (exposed: import("vue").ShallowUnwrapRef<{
+        readonly $el: HTMLElement;
+        virtualizer: import("vue").Ref<import("@tanstack/vue-virtual").Virtualizer<Element, Element>, import("@tanstack/vue-virtual").Virtualizer<Element, Element>> | undefined;
+    }>) => void;
+    attrs: any;
+    slots: ScrollAreaSlots<T>;
+    emit: (evt: "scroll", isScrolling: boolean) => void;
+}>) => import("vue").VNode & {
+    __ctx?: Awaited<typeof __VLS_setup>;
+};
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};

package/dist/runtime/components/Select.d.vue.ts

@@ -166,12 +166,21 @@ export interface SelectSlots<A extends ArrayOrNested<SelectItem> = ArrayOrNested
     'content-top': (props?: {}) => any;
     'content-bottom': (props?: {}) => any;
 }
-declare const __VLS_export: <T extends ArrayOrNested<SelectItem>, VK extends GetItemKeys<T> = "value", M extends boolean = false>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
-    props: __VLS_PrettifyLocal<SelectProps<T, VK, M> & __VLS_EmitsToProps<__VLS_NormalizeEmits<((evt: "blur", event: FocusEvent) => void) & ((evt: "change", event: Event) => void) & ((evt: "focus", event: FocusEvent) => void) & ((evt: "update:open", value: boolean) => void) & ((evt: "update:modelValue", value: GetModelValue<T, VK, M>) => void)>>> & import("vue").PublicProps & (typeof globalThis extends {
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: <T extends ArrayOrNested<SelectItem>, VK extends GetItemKeys<T> = "value", M extends boolean = false>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: import("vue").PublicProps & __VLS_PrettifyLocal<SelectProps<T, VK, M> & {
+        onBlur?: ((event: FocusEvent) => any) | undefined;
+        onChange?: ((event: Event) => any) | undefined;
+        onFocus?: ((event: FocusEvent) => any) | undefined;
+        "onUpdate:open"?: ((value: boolean) => any) | undefined;
+        "onUpdate:modelValue"?: ((value: GetModelValue<T, VK, M>) => any) | undefined;
+    }> & (typeof globalThis extends {
         __VLS_PROPS_FALLBACK: infer P;
     } ? P : {});
     expose: (exposed: import("vue").ShallowUnwrapRef<{
         triggerRef: Readonly<import("vue").Ref<HTMLButtonElement, HTMLButtonElement>>;
+        viewportRef: Readonly<import("vue").Ref<HTMLDivElement | null, HTMLDivElement | null>>;
     }>) => void;
     attrs: any;
     slots: SelectSlots<T, VK, M, NestedItem<T>>;
@@ -179,8 +188,8 @@ declare const __VLS_export: <T extends ArrayOrNested<SelectItem>, VK extends Get
 }>) => import("vue").VNode & {
     __ctx?: Awaited<typeof __VLS_setup>;
 };
-declare const _default: typeof __VLS_export;
-export default _default;
-type __VLS_PrettifyLocal<T> = {
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
     [K in keyof T as K]: T[K];
-} & {};
+}) & {};

package/dist/runtime/components/Select.vue

@@ -47,7 +47,7 @@ const props = defineProps({
   autofocus: { type: Boolean, required: false },
   autofocusDelay: { type: Number, required: false, default: 0 },
   class: { type: null, required: false },
-  b24ui: { type: null, required: false },
+  b24ui: { type: Object, required: false },
   open: { type: Boolean, required: false },
   defaultOpen: { type: Boolean, required: false },
   autocomplete: { type: String, required: false },
@@ -151,8 +151,10 @@ function onUpdateOpen(value) {
 function isSelectItem(item) {
   return typeof item === "object" && item !== null;
 }
+const viewportRef = useTemplateRef("viewportRef");
 defineExpose({
-  triggerRef: toRef(() => triggerRef.value?.$el)
+  triggerRef: toRef(() => triggerRef.value?.$el),
+  viewportRef: toRef(() => viewportRef.value)
 });
 </script>
 
@@ -238,6 +240,7 @@ defineExpose({
           <slot name="content-top" />
 
           <div
+            ref="viewportRef"
             role="presentation"
             data-slot="viewport"
             :class="b24ui.viewport({ class: props.b24ui?.viewport })"

package/dist/runtime/components/Select.vue.d.ts

@@ -166,12 +166,21 @@ export interface SelectSlots<A extends ArrayOrNested<SelectItem> = ArrayOrNested
     'content-top': (props?: {}) => any;
     'content-bottom': (props?: {}) => any;
 }
-declare const __VLS_export: <T extends ArrayOrNested<SelectItem>, VK extends GetItemKeys<T> = "value", M extends boolean = false>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
-    props: __VLS_PrettifyLocal<SelectProps<T, VK, M> & __VLS_EmitsToProps<__VLS_NormalizeEmits<((evt: "blur", event: FocusEvent) => void) & ((evt: "change", event: Event) => void) & ((evt: "focus", event: FocusEvent) => void) & ((evt: "update:open", value: boolean) => void) & ((evt: "update:modelValue", value: GetModelValue<T, VK, M>) => void)>>> & import("vue").PublicProps & (typeof globalThis extends {
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: <T extends ArrayOrNested<SelectItem>, VK extends GetItemKeys<T> = "value", M extends boolean = false>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: import("vue").PublicProps & __VLS_PrettifyLocal<SelectProps<T, VK, M> & {
+        onBlur?: ((event: FocusEvent) => any) | undefined;
+        onChange?: ((event: Event) => any) | undefined;
+        onFocus?: ((event: FocusEvent) => any) | undefined;
+        "onUpdate:open"?: ((value: boolean) => any) | undefined;
+        "onUpdate:modelValue"?: ((value: GetModelValue<T, VK, M>) => any) | undefined;
+    }> & (typeof globalThis extends {
         __VLS_PROPS_FALLBACK: infer P;
     } ? P : {});
     expose: (exposed: import("vue").ShallowUnwrapRef<{
         triggerRef: Readonly<import("vue").Ref<HTMLButtonElement, HTMLButtonElement>>;
+        viewportRef: Readonly<import("vue").Ref<HTMLDivElement | null, HTMLDivElement | null>>;
     }>) => void;
     attrs: any;
     slots: SelectSlots<T, VK, M, NestedItem<T>>;
@@ -179,8 +188,8 @@ declare const __VLS_export: <T extends ArrayOrNested<SelectItem>, VK extends Get
 }>) => import("vue").VNode & {
     __ctx?: Awaited<typeof __VLS_setup>;
 };
-declare const _default: typeof __VLS_export;
-export default _default;
-type __VLS_PrettifyLocal<T> = {
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
     [K in keyof T as K]: T[K];
-} & {};
+}) & {};

package/dist/runtime/components/SelectMenu.d.vue.ts

@@ -2,7 +2,7 @@ import type { ComboboxRootProps, ComboboxRootEmits, ComboboxContentProps, Combob
 import type { AppConfig } from '@nuxt/schema';
 import theme from '#build/b24ui/select-menu';
 import type { UseComponentIconsProps } from '../composables/useComponentIcons';
-import type { AvatarProps, ChipProps, InputProps, BadgeProps, IconComponent } from '../types';
+import type { AvatarProps, ButtonProps, ChipProps, InputProps, LinkPropsKeys, BadgeProps, IconComponent } from '../types';
 import type { ModelModifiers } from '../types/input';
 import type { ButtonHTMLAttributes } from '../types/html';
 import type { AcceptableValue, ArrayOrNested, GetItemKeys, GetModelValue, GetModelValueEmits, NestedItem, EmitsToProps } from '../types/utils';
@@ -31,7 +31,7 @@ export type SelectMenuItem = SelectMenuValue | {
     b24ui?: Pick<SelectMenu['slots'], 'label' | 'separator' | 'item' | 'itemLeadingIcon' | 'itemLeadingAvatarSize' | 'itemLeadingAvatar' | 'itemLeadingChipSize' | 'itemLeadingChip' | 'itemWrapper' | 'itemLabel' | 'itemDescription' | 'itemTrailing' | 'itemTrailingIcon'>;
     [key: string]: any;
 };
-export interface SelectMenuProps<T extends ArrayOrNested<SelectMenuItem> = ArrayOrNested<SelectMenuItem>, VK extends GetItemKeys<T> | undefined = undefined, M extends boolean = false> extends Pick<ComboboxRootProps<T>, 'open' | 'defaultOpen' | 'disabled' | 'name' | 'resetSearchTermOnBlur' | 'resetSearchTermOnSelect' | 'highlightOnHover'>, UseComponentIconsProps, /** @vue-ignore */ Omit<ButtonHTMLAttributes, 'type' | 'disabled' | 'name'> {
+export interface SelectMenuProps<T extends ArrayOrNested<SelectMenuItem> = ArrayOrNested<SelectMenuItem>, VK extends GetItemKeys<T> | undefined = undefined, M extends boolean = false> extends Pick<ComboboxRootProps<T>, 'open' | 'defaultOpen' | 'disabled' | 'name' | 'resetSearchTermOnBlur' | 'resetSearchTermOnSelect' | 'resetModelValueOnClear' | 'highlightOnHover' | 'by'>, UseComponentIconsProps, /** @vue-ignore */ Omit<ButtonHTMLAttributes, 'type' | 'disabled' | 'name'> {
     id?: string;
     /** The placeholder text when the select is empty. */
     placeholder?: string;
@@ -91,6 +91,18 @@ export interface SelectMenuProps<T extends ArrayOrNested<SelectMenuItem> = Array
      * @IconComponent
      */
     selectedIcon?: IconComponent;
+    /**
+     * Display a clear button to reset the model value.
+     * Can be an object to pass additional props to the Button.
+     * @defaultValue false
+     */
+    clear?: boolean | Partial<Omit<ButtonProps, LinkPropsKeys>>;
+    /**
+     * The icon displayed in the clear button.
+     * @defaultValue icons.close
+     * @IconifyIcon
+     */
+    clearIcon?: IconComponent;
     /**
      * The content of the menu.
      * @defaultValue { side: 'bottom', sideOffset: 8, collisionPadding: 8, position: 'popper' }
@@ -118,10 +130,10 @@ export interface SelectMenuProps<T extends ArrayOrNested<SelectMenuItem> = Array
          */
         overscan?: number;
         /**
-         * Estimated size (in px) of each item
+         * Estimated size (in px) of each item, or a function that returns the size for a given index
          * @defaultValue 32
          */
-        estimateSize?: number;
+        estimateSize?: number | ((index: number) => number);
     };
     /**
      * When `items` is an array of objects, select the field to use as the value instead of the object itself.
@@ -176,6 +188,7 @@ export type SelectMenuEmits<A extends ArrayOrNested<SelectMenuItem>, VK extends
     blur: [event: FocusEvent];
     focus: [event: FocusEvent];
     create: [item: string];
+    clear: [];
     /** Event handler when highlighted element changes. */
     highlight: [
         payload: {
@@ -225,29 +238,42 @@ export interface SelectMenuSlots<A extends ArrayOrNested<SelectMenuItem> = Array
         item: string;
     }): any;
 }
-declare const __VLS_export: <T extends ArrayOrNested<SelectMenuItem>, VK extends GetItemKeys<T> | undefined = undefined, M extends boolean = false>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
-    props: __VLS_PrettifyLocal<(SelectMenuProps<T, VK, M> & {
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: <T extends ArrayOrNested<SelectMenuItem>, VK extends GetItemKeys<T> | undefined = undefined, M extends boolean = false>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: import("vue").PublicProps & __VLS_PrettifyLocal<(SelectMenuProps<T, VK, M> & {
         searchTerm?: string;
-    }) & __VLS_EmitsToProps<__VLS_NormalizeEmits<((evt: "blur", event: FocusEvent) => void) & ((evt: "change", event: Event) => void) & ((evt: "focus", event: FocusEvent) => void) & ((evt: "update:open", value: boolean) => void) & ((evt: "create", item: string) => void) & ((evt: "update:modelValue", value: GetModelValue<T, VK, M>) => void) & ((evt: "highlight", payload: {
-        ref: HTMLElement;
-        value: GetModelValue<T, VK, M>;
-    } | undefined) => void) & ((evt: "update:searchTerm", value: string) => void)>>> & import("vue").PublicProps & (typeof globalThis extends {
+    }) & {
+        onClear?: (() => any) | undefined;
+        onBlur?: ((event: FocusEvent) => any) | undefined;
+        onChange?: ((event: Event) => any) | undefined;
+        onFocus?: ((event: FocusEvent) => any) | undefined;
+        "onUpdate:open"?: ((value: boolean) => any) | undefined;
+        onCreate?: ((item: string) => any) | undefined;
+        "onUpdate:modelValue"?: ((value: GetModelValue<T, VK, M>) => any) | undefined;
+        onHighlight?: ((payload: {
+            ref: HTMLElement;
+            value: GetModelValue<T, VK, M>;
+        } | undefined) => any) | undefined;
+        "onUpdate:searchTerm"?: ((value: string) => any) | undefined;
+    }> & (typeof globalThis extends {
         __VLS_PROPS_FALLBACK: infer P;
     } ? P : {});
     expose: (exposed: import("vue").ShallowUnwrapRef<{
         triggerRef: Readonly<import("vue").Ref<HTMLButtonElement, HTMLButtonElement>>;
+        viewportRef: Readonly<import("vue").Ref<HTMLDivElement | null, HTMLDivElement | null>>;
     }>) => void;
     attrs: any;
     slots: SelectMenuSlots<T, VK, M, NestedItem<T>>;
-    emit: (((evt: "blur", event: FocusEvent) => void) & ((evt: "change", event: Event) => void) & ((evt: "focus", event: FocusEvent) => void) & ((evt: "update:open", value: boolean) => void) & ((evt: "create", item: string) => void) & ((evt: "update:modelValue", value: GetModelValue<T, VK, M>) => void) & ((evt: "highlight", payload: {
+    emit: (((evt: "clear") => void) & ((evt: "blur", event: FocusEvent) => void) & ((evt: "change", event: Event) => void) & ((evt: "focus", event: FocusEvent) => void) & ((evt: "update:open", value: boolean) => void) & ((evt: "create", item: string) => void) & ((evt: "update:modelValue", value: GetModelValue<T, VK, M>) => void) & ((evt: "highlight", payload: {
         ref: HTMLElement;
         value: GetModelValue<T, VK, M>;
-    } | undefined) => void)) & ((evt: "update:searchTerm", value: string) => void);
+    } | undefined) => void)) & ((event: "update:searchTerm", value: string) => void);
 }>) => import("vue").VNode & {
     __ctx?: Awaited<typeof __VLS_setup>;
 };
-declare const _default: typeof __VLS_export;
-export default _default;
-type __VLS_PrettifyLocal<T> = {
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
     [K in keyof T as K]: T[K];
-} & {};
+}) & {};

package/dist/runtime/components/SelectMenu.vue

@@ -4,7 +4,7 @@ import theme from "#build/b24ui/select-menu";
 
 <script setup>
 import { useTemplateRef, computed, onMounted, toRef, toRaw } from "vue";
-import { Primitive, ComboboxRoot, ComboboxArrow, ComboboxAnchor, ComboboxInput, ComboboxTrigger, ComboboxPortal, ComboboxContent, ComboboxEmpty, ComboboxGroup, ComboboxVirtualizer, ComboboxLabel, ComboboxSeparator, ComboboxItem, ComboboxItemIndicator, FocusScope, useForwardPropsEmits, useFilter } from "reka-ui";
+import { Primitive, ComboboxRoot, ComboboxArrow, ComboboxAnchor, ComboboxInput, ComboboxTrigger, ComboboxCancel, ComboboxPortal, ComboboxContent, ComboboxEmpty, ComboboxGroup, ComboboxVirtualizer, ComboboxLabel, ComboboxSeparator, ComboboxItem, ComboboxItemIndicator, FocusScope, useForwardPropsEmits, useFilter } from "reka-ui";
 import { defu } from "defu";
 import { reactivePick, createReusableTemplate } from "@vueuse/core";
 import { useAppConfig } from "#imports";
@@ -19,6 +19,7 @@ import { tv } from "../utils/tv";
 import icons from "../dictionary/icons";
 import B24Badge from "./Badge.vue";
 import B24Avatar from "./Avatar.vue";
+import B24Button from "./Button.vue";
 import B24Chip from "./Chip.vue";
 import B24Input from "./Input.vue";
 defineOptions({ inheritAttrs: false });
@@ -37,6 +38,8 @@ const props = defineProps({
   required: { type: Boolean, required: false },
   trailingIcon: { type: [Function, Object], required: false },
   selectedIcon: { type: [Function, Object], required: false },
+  clear: { type: [Boolean, Object], required: false },
+  clearIcon: { type: [Function, Object], required: false },
   content: { type: Object, required: false },
   arrow: { type: [Boolean, Object], required: false },
   portal: { type: [Boolean, String], required: false, skipCheck: true, default: true },
@@ -56,33 +59,36 @@ const props = defineProps({
   autofocus: { type: Boolean, required: false },
   autofocusDelay: { type: Number, required: false, default: 0 },
   class: { type: null, required: false },
-  b24ui: { type: null, required: false },
+  b24ui: { type: Object, required: false },
   open: { type: Boolean, required: false },
   defaultOpen: { type: Boolean, required: false },
   disabled: { type: Boolean, required: false },
   name: { type: String, required: false },
   resetSearchTermOnBlur: { type: Boolean, required: false, default: true },
   resetSearchTermOnSelect: { type: Boolean, required: false, default: true },
+  resetModelValueOnClear: { type: Boolean, required: false, default: true },
   highlightOnHover: { type: Boolean, required: false },
+  by: { type: [String, Function], required: false },
   icon: { type: [Function, Object], required: false },
   avatar: { type: Object, required: false },
   loading: { type: Boolean, required: false },
   trailing: { type: Boolean, required: false }
 });
-const emits = defineEmits(["update:open", "change", "blur", "focus", "create", "highlight", "update:modelValue"]);
+const emits = defineEmits(["update:open", "change", "blur", "focus", "create", "clear", "highlight", "update:modelValue"]);
 const slots = defineSlots();
 const searchTerm = defineModel("searchTerm", { type: String, ...{ default: "" } });
 const { t } = useLocale();
 const appConfig = useAppConfig();
 const { contains } = useFilter({ sensitivity: "base" });
-const rootProps = useForwardPropsEmits(reactivePick(props, "modelValue", "defaultValue", "open", "defaultOpen", "required", "multiple", "resetSearchTermOnBlur", "resetSearchTermOnSelect", "highlightOnHover"), emits);
+const rootProps = useForwardPropsEmits(reactivePick(props, "modelValue", "defaultValue", "open", "defaultOpen", "required", "multiple", "resetSearchTermOnBlur", "resetSearchTermOnSelect", "resetModelValueOnClear", "highlightOnHover", "by"), emits);
 const portalProps = usePortal(toRef(() => props.portal));
 const contentProps = toRef(() => defu(props.content, { side: "bottom", sideOffset: 8, collisionPadding: 8, position: "popper" }));
 const arrowProps = toRef(() => defu(typeof props.arrow === "boolean" ? {} : props.arrow, { width: 20, height: 10 }));
+const clearProps = computed(() => typeof props.clear === "object" ? props.clear : {});
 const virtualizerProps = toRef(() => {
   if (!props.virtualize) return false;
   return defu(typeof props.virtualize === "boolean" ? {} : props.virtualize, {
-    estimateSize: getEstimateSize(items.value, props.size || "md", props.descriptionKey)
+    estimateSize: getEstimateSize(filteredItems.value, selectSize.value || "md", props.descriptionKey, !!slots["item-description"])
   });
 });
 const searchInputProps = toRef(() => defu(props.searchInput, { placeholder: t("selectMenu.search"), type: "text", size: "md" }));
@@ -124,13 +130,15 @@ function displayValue(value) {
   if (props.multiple && Array.isArray(value)) {
     const displayedValues = value.map((item) => getDisplayValue(items.value, item, {
       labelKey: props.labelKey,
-      valueKey: props.valueKey
+      valueKey: props.valueKey,
+      by: props.by
     })).filter((v) => v != null && v !== "");
     return displayedValues.length > 0 ? displayedValues.join(", ") : void 0;
   }
   return getDisplayValue(items.value, value, {
     labelKey: props.labelKey,
-    valueKey: props.valueKey
+    valueKey: props.valueKey,
+    by: props.by
   });
 }
 const groups = computed(
@@ -167,7 +175,7 @@ const createItem = computed(() => {
   }
   const newItem = props.valueKey ? { [props.valueKey]: searchTerm.value } : searchTerm.value;
   if (typeof props.createItem === "object" && props.createItem.when === "always" || props.createItem === "always") {
-    return !filteredItems.value.find((item) => compare(item, newItem, props.valueKey));
+    return !filteredItems.value.find((item) => compare(item, newItem, props.by ?? props.valueKey));
   }
   return !filteredItems.value.length;
 });
@@ -246,8 +254,19 @@ function onSelect(e, item) {
 function isSelectItem(item) {
   return typeof item === "object" && item !== null;
 }
+function isModelValueEmpty(modelValue) {
+  if (props.multiple && Array.isArray(modelValue)) {
+    return modelValue.length === 0;
+  }
+  return modelValue === void 0 || modelValue === null || modelValue === "";
+}
+function onClear() {
+  emits("clear");
+}
+const viewportRef = useTemplateRef("viewportRef");
 defineExpose({
-  triggerRef: toRef(() => triggerRef.value?.$el)
+  triggerRef: toRef(() => triggerRef.value?.$el),
+  viewportRef: toRef(() => viewportRef.value)
 });
 </script>
 
@@ -423,11 +442,25 @@ defineExpose({
             </template>
           </slot>
 
-          <span v-if="isTrailing || !!slots.trailing" data-slot="trailing" :class="b24ui.trailing({ class: props.b24ui?.trailing })">
+          <span v-if="isTrailing || !!slots.trailing || !!clear" data-slot="trailing" :class="b24ui.trailing({ class: props.b24ui?.trailing })">
             <slot name="trailing" :model-value="modelValue" :open="open" :b24ui="b24ui">
+              <ComboboxCancel v-if="!!clear && !isModelValueEmpty(modelValue)" as-child>
+                <B24Button
+                  as="span"
+                  :icon="clearIcon || icons.close"
+                  :size="selectSize"
+                  color="air-tertiary-no-accent"
+                  tabindex="-1"
+                  v-bind="clearProps"
+                  data-slot="trailingClear"
+                  :class="b24ui.trailingClear({ class: props.b24ui?.trailingClear })"
+                  @click.stop="onClear"
+                />
+              </ComboboxCancel>
+
               <Component
                 :is="trailingIconName"
-                v-if="trailingIconName"
+                v-else-if="trailingIconName"
                 data-slot="trailingIcon"
                 :class="b24ui.trailingIcon({ class: props.b24ui?.trailingIcon })"
               />
@@ -451,7 +484,7 @@ defineExpose({
                 no-border
                 autofocus
                 autocomplete="off"
-                :size="size"
+                :size="selectSize"
                 v-bind="searchInputProps"
                 data-slot="input"
                 :class="b24ui.input({ class: props.b24ui?.input })"
@@ -466,6 +499,7 @@ defineExpose({
             </ComboboxEmpty>
 
             <div
+              ref="viewportRef"
               role="presentation"
               data-slot="viewport"
               :class="b24ui.viewport({ class: props.b24ui?.viewport })"

package/dist/runtime/components/SelectMenu.vue.d.ts

@@ -2,7 +2,7 @@ import type { ComboboxRootProps, ComboboxRootEmits, ComboboxContentProps, Combob
 import type { AppConfig } from '@nuxt/schema';
 import theme from '#build/b24ui/select-menu';
 import type { UseComponentIconsProps } from '../composables/useComponentIcons';
-import type { AvatarProps, ChipProps, InputProps, BadgeProps, IconComponent } from '../types';
+import type { AvatarProps, ButtonProps, ChipProps, InputProps, LinkPropsKeys, BadgeProps, IconComponent } from '../types';
 import type { ModelModifiers } from '../types/input';
 import type { ButtonHTMLAttributes } from '../types/html';
 import type { AcceptableValue, ArrayOrNested, GetItemKeys, GetModelValue, GetModelValueEmits, NestedItem, EmitsToProps } from '../types/utils';
@@ -31,7 +31,7 @@ export type SelectMenuItem = SelectMenuValue | {
     b24ui?: Pick<SelectMenu['slots'], 'label' | 'separator' | 'item' | 'itemLeadingIcon' | 'itemLeadingAvatarSize' | 'itemLeadingAvatar' | 'itemLeadingChipSize' | 'itemLeadingChip' | 'itemWrapper' | 'itemLabel' | 'itemDescription' | 'itemTrailing' | 'itemTrailingIcon'>;
     [key: string]: any;
 };
-export interface SelectMenuProps<T extends ArrayOrNested<SelectMenuItem> = ArrayOrNested<SelectMenuItem>, VK extends GetItemKeys<T> | undefined = undefined, M extends boolean = false> extends Pick<ComboboxRootProps<T>, 'open' | 'defaultOpen' | 'disabled' | 'name' | 'resetSearchTermOnBlur' | 'resetSearchTermOnSelect' | 'highlightOnHover'>, UseComponentIconsProps, /** @vue-ignore */ Omit<ButtonHTMLAttributes, 'type' | 'disabled' | 'name'> {
+export interface SelectMenuProps<T extends ArrayOrNested<SelectMenuItem> = ArrayOrNested<SelectMenuItem>, VK extends GetItemKeys<T> | undefined = undefined, M extends boolean = false> extends Pick<ComboboxRootProps<T>, 'open' | 'defaultOpen' | 'disabled' | 'name' | 'resetSearchTermOnBlur' | 'resetSearchTermOnSelect' | 'resetModelValueOnClear' | 'highlightOnHover' | 'by'>, UseComponentIconsProps, /** @vue-ignore */ Omit<ButtonHTMLAttributes, 'type' | 'disabled' | 'name'> {
     id?: string;
     /** The placeholder text when the select is empty. */
     placeholder?: string;
@@ -91,6 +91,18 @@ export interface SelectMenuProps<T extends ArrayOrNested<SelectMenuItem> = Array
      * @IconComponent
      */
     selectedIcon?: IconComponent;
+    /**
+     * Display a clear button to reset the model value.
+     * Can be an object to pass additional props to the Button.
+     * @defaultValue false
+     */
+    clear?: boolean | Partial<Omit<ButtonProps, LinkPropsKeys>>;
+    /**
+     * The icon displayed in the clear button.
+     * @defaultValue icons.close
+     * @IconifyIcon
+     */
+    clearIcon?: IconComponent;
     /**
      * The content of the menu.
      * @defaultValue { side: 'bottom', sideOffset: 8, collisionPadding: 8, position: 'popper' }
@@ -118,10 +130,10 @@ export interface SelectMenuProps<T extends ArrayOrNested<SelectMenuItem> = Array
          */
         overscan?: number;
         /**
-         * Estimated size (in px) of each item
+         * Estimated size (in px) of each item, or a function that returns the size for a given index
          * @defaultValue 32
          */
-        estimateSize?: number;
+        estimateSize?: number | ((index: number) => number);
     };
     /**
      * When `items` is an array of objects, select the field to use as the value instead of the object itself.
@@ -176,6 +188,7 @@ export type SelectMenuEmits<A extends ArrayOrNested<SelectMenuItem>, VK extends
     blur: [event: FocusEvent];
     focus: [event: FocusEvent];
     create: [item: string];
+    clear: [];
     /** Event handler when highlighted element changes. */
     highlight: [
         payload: {
@@ -225,29 +238,42 @@ export interface SelectMenuSlots<A extends ArrayOrNested<SelectMenuItem> = Array
         item: string;
     }): any;
 }
-declare const __VLS_export: <T extends ArrayOrNested<SelectMenuItem>, VK extends GetItemKeys<T> | undefined = undefined, M extends boolean = false>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
-    props: __VLS_PrettifyLocal<(SelectMenuProps<T, VK, M> & {
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: <T extends ArrayOrNested<SelectMenuItem>, VK extends GetItemKeys<T> | undefined = undefined, M extends boolean = false>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: import("vue").PublicProps & __VLS_PrettifyLocal<(SelectMenuProps<T, VK, M> & {
         searchTerm?: string;
-    }) & __VLS_EmitsToProps<__VLS_NormalizeEmits<((evt: "blur", event: FocusEvent) => void) & ((evt: "change", event: Event) => void) & ((evt: "focus", event: FocusEvent) => void) & ((evt: "update:open", value: boolean) => void) & ((evt: "create", item: string) => void) & ((evt: "update:modelValue", value: GetModelValue<T, VK, M>) => void) & ((evt: "highlight", payload: {
-        ref: HTMLElement;
-        value: GetModelValue<T, VK, M>;
-    } | undefined) => void) & ((evt: "update:searchTerm", value: string) => void)>>> & import("vue").PublicProps & (typeof globalThis extends {
+    }) & {
+        onClear?: (() => any) | undefined;
+        onBlur?: ((event: FocusEvent) => any) | undefined;
+        onChange?: ((event: Event) => any) | undefined;
+        onFocus?: ((event: FocusEvent) => any) | undefined;
+        "onUpdate:open"?: ((value: boolean) => any) | undefined;
+        onCreate?: ((item: string) => any) | undefined;
+        "onUpdate:modelValue"?: ((value: GetModelValue<T, VK, M>) => any) | undefined;
+        onHighlight?: ((payload: {
+            ref: HTMLElement;
+            value: GetModelValue<T, VK, M>;
+        } | undefined) => any) | undefined;
+        "onUpdate:searchTerm"?: ((value: string) => any) | undefined;
+    }> & (typeof globalThis extends {
         __VLS_PROPS_FALLBACK: infer P;
     } ? P : {});
     expose: (exposed: import("vue").ShallowUnwrapRef<{
         triggerRef: Readonly<import("vue").Ref<HTMLButtonElement, HTMLButtonElement>>;
+        viewportRef: Readonly<import("vue").Ref<HTMLDivElement | null, HTMLDivElement | null>>;
     }>) => void;
     attrs: any;
     slots: SelectMenuSlots<T, VK, M, NestedItem<T>>;
-    emit: (((evt: "blur", event: FocusEvent) => void) & ((evt: "change", event: Event) => void) & ((evt: "focus", event: FocusEvent) => void) & ((evt: "update:open", value: boolean) => void) & ((evt: "create", item: string) => void) & ((evt: "update:modelValue", value: GetModelValue<T, VK, M>) => void) & ((evt: "highlight", payload: {
+    emit: (((evt: "clear") => void) & ((evt: "blur", event: FocusEvent) => void) & ((evt: "change", event: Event) => void) & ((evt: "focus", event: FocusEvent) => void) & ((evt: "update:open", value: boolean) => void) & ((evt: "create", item: string) => void) & ((evt: "update:modelValue", value: GetModelValue<T, VK, M>) => void) & ((evt: "highlight", payload: {
         ref: HTMLElement;
         value: GetModelValue<T, VK, M>;
-    } | undefined) => void)) & ((evt: "update:searchTerm", value: string) => void);
+    } | undefined) => void)) & ((event: "update:searchTerm", value: string) => void);
 }>) => import("vue").VNode & {
     __ctx?: Awaited<typeof __VLS_setup>;
 };
-declare const _default: typeof __VLS_export;
-export default _default;
-type __VLS_PrettifyLocal<T> = {
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
     [K in keyof T as K]: T[K];
-} & {};
+}) & {};

package/dist/runtime/components/Separator.d.vue.ts

@@ -38,7 +38,7 @@ export interface SeparatorProps extends Pick<_SeparatorProps, 'decorative'> {
      * The orientation of the separator.
      * @defaultValue 'horizontal'
      */
-    orientation?: _SeparatorProps['orientation'];
+    orientation?: Separator['variants']['orientation'];
     class?: any;
     b24ui?: Separator['slots'];
 }
@@ -47,9 +47,14 @@ export interface SeparatorSlots {
         b24ui: Separator['b24ui'];
     }): any;
 }
-declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<SeparatorProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<SeparatorProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, SeparatorSlots>;
 declare const _default: typeof __VLS_export;
 export default _default;
+declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<SeparatorProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<SeparatorProps> & Readonly<{}>, {
+    size: Separator["variants"]["size"];
+    accent: Separator["variants"]["accent"];
+    type: Separator["variants"]["type"];
+    orientation: Separator["variants"]["orientation"];
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, SeparatorSlots>;
 type __VLS_WithSlots<T, S> = T & {
     new (): {
         $slots: S;

package/dist/runtime/components/Separator.vue.d.ts

@@ -38,7 +38,7 @@ export interface SeparatorProps extends Pick<_SeparatorProps, 'decorative'> {
      * The orientation of the separator.
      * @defaultValue 'horizontal'
      */
-    orientation?: _SeparatorProps['orientation'];
+    orientation?: Separator['variants']['orientation'];
     class?: any;
     b24ui?: Separator['slots'];
 }
@@ -47,9 +47,14 @@ export interface SeparatorSlots {
         b24ui: Separator['b24ui'];
     }): any;
 }
-declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<SeparatorProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<SeparatorProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, SeparatorSlots>;
 declare const _default: typeof __VLS_export;
 export default _default;
+declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<SeparatorProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<SeparatorProps> & Readonly<{}>, {
+    size: Separator["variants"]["size"];
+    accent: Separator["variants"]["accent"];
+    type: Separator["variants"]["type"];
+    orientation: Separator["variants"]["orientation"];
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, SeparatorSlots>;
 type __VLS_WithSlots<T, S> = T & {
     new (): {
         $slots: S;