@nuxt/ui 4.4.0 → 4.5.1

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

@@ -1,3 +1,4 @@
+import type { VNode } from 'vue';
 import type { AppConfig } from '@nuxt/schema';
 import theme from '#build/ui/pricing-table';
 import type { PricingPlanProps } from '../types';
@@ -10,19 +11,19 @@ type DynamicSlots<T extends {
         tier: Extract<T, {
             id: K extends `${infer Base}-${S}` ? Base : K;
         }>;
-    }) => any;
+    }) => VNode[];
 };
 type FeatureDynamicSlots<T extends PricingTableSectionFeature, S extends string | undefined = undefined> = {
     [K in (T['id'] extends string ? T['id'] : string) as K extends string ? S extends string ? (`feature-${K}` | `feature-${K}-${S}`) : `feature-${K}` : never]?: (props: {
         feature: T;
         tier: PricingTableTier;
         section: PricingTableSection;
-    }) => any;
+    }) => VNode[];
 };
 type SectionDynamicSlots<T extends PricingTableSection, S extends string | undefined = undefined> = {
     [K in (T['id'] extends string ? T['id'] : string) as K extends string ? S extends string ? (`section-${K}` | `section-${K}-${S}`) : `section-${K}` : never]?: (props: {
         section: T;
-    }) => any;
+    }) => VNode[];
 };
 export type PricingTableTier = Pick<PricingPlanProps, 'title' | 'description' | 'badge' | 'billingCycle' | 'billingPeriod' | 'price' | 'discount' | 'button' | 'highlight'> & {
     id: string;
@@ -66,29 +67,29 @@ export interface PricingTableProps<T extends PricingTableTier = PricingTableTier
 }
 type SlotProps<T extends PricingTableTier> = (props: {
     tier: T;
-}) => any;
+}) => VNode[];
 export type PricingTableSlots<T extends PricingTableTier = PricingTableTier> = {
-    'caption': (props?: {}) => any;
-    'tier': SlotProps<T>;
-    'tier-title': SlotProps<T>;
-    'tier-description': SlotProps<T>;
-    'tier-badge': SlotProps<T>;
-    'tier-button': SlotProps<T>;
-    'tier-billing': SlotProps<T>;
-    'tier-discount': SlotProps<T>;
-    'tier-price': SlotProps<T>;
-    'section-title': (props: {
+    'caption'?: (props?: {}) => VNode[];
+    'tier'?: SlotProps<T>;
+    'tier-title'?: SlotProps<T>;
+    'tier-description'?: SlotProps<T>;
+    'tier-badge'?: SlotProps<T>;
+    'tier-button'?: SlotProps<T>;
+    'tier-billing'?: SlotProps<T>;
+    'tier-discount'?: SlotProps<T>;
+    'tier-price'?: SlotProps<T>;
+    'section-title'?: (props: {
         section: PricingTableSection<T>;
-    }) => any;
-    'feature-title': (props: {
+    }) => VNode[];
+    'feature-title'?: (props: {
         feature: PricingTableSectionFeature<T>;
         section: PricingTableSection<T>;
-    }) => any;
-    'feature-value': (props: {
+    }) => VNode[];
+    'feature-value'?: (props: {
         feature: PricingTableSectionFeature<T>;
         tier: T;
         section: PricingTableSection<T>;
-    }) => any;
+    }) => VNode[];
 } & DynamicSlots<T, 'title' | 'description' | 'badge' | 'button' | 'billing' | 'discount' | 'price'> & FeatureDynamicSlots<PricingTableSectionFeature<T>, 'title' | 'value'> & SectionDynamicSlots<PricingTableSection<T>, 'title'>;
 declare const _default: typeof __VLS_export;
 export default _default;

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

@@ -1,4 +1,5 @@
 import type { ProgressRootProps, ProgressRootEmits } from 'reka-ui';
+import type { VNode } from 'vue';
 import type { AppConfig } from '@nuxt/schema';
 import theme from '#build/ui/progress';
 import type { ComponentConfig } from '../types/tv';
@@ -39,13 +40,13 @@ export interface ProgressProps extends Pick<ProgressRootProps, 'getValueLabel' |
 export interface ProgressEmits extends ProgressRootEmits {
 }
 export type ProgressSlots = {
-    status(props: {
+    status?(props: {
         percent?: number;
-    }): any;
+    }): VNode[];
 } & {
     [key: string]: (props: {
         step: number;
-    }) => any;
+    }) => VNode[];
 };
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/components/Progress.vue

@@ -7,6 +7,7 @@ import { computed } from "vue";
 import { Primitive, ProgressRoot, ProgressIndicator, useForwardPropsEmits } from "reka-ui";
 import { reactivePick } from "@vueuse/core";
 import { useAppConfig } from "#imports";
+import { useComponentUI } from "../composables/useComponentUI";
 import { useLocale } from "../composables/useLocale";
 import { tv } from "../utils/tv";
 const props = defineProps({
@@ -19,7 +20,7 @@ const props = defineProps({
   orientation: { type: null, required: false, default: "horizontal" },
   animation: { type: null, required: false },
   class: { type: null, required: false },
-  ui: { type: null, required: false },
+  ui: { type: Object, required: false },
   getValueLabel: { type: Function, required: false },
   getValueText: { type: Function, required: false },
   modelValue: { type: [Number, null], required: false, default: null }
@@ -28,6 +29,7 @@ const emits = defineEmits(["update:modelValue", "update:max"]);
 const slots = defineSlots();
 const { dir } = useLocale();
 const appConfig = useAppConfig();
+const uiProp = useComponentUI("progress", props);
 const rootProps = useForwardPropsEmits(reactivePick(props, "getValueLabel", "getValueText", "modelValue"), emits);
 const isIndeterminate = computed(() => rootProps.value.modelValue === null);
 const hasSteps = computed(() => Array.isArray(props.max));
@@ -109,19 +111,19 @@ const ui = computed(() => tv({ extend: tv(theme), ...appConfig.ui?.progress || {
 </script>
 
 <template>
-  <Primitive :as="as" :data-orientation="orientation" data-slot="root" :class="ui.root({ class: [props.ui?.root, props.class] })">
-    <div v-if="!isIndeterminate && (status || !!slots.status)" data-slot="status" :class="ui.status({ class: props.ui?.status })" :style="statusStyle">
+  <Primitive :as="as" :data-orientation="orientation" data-slot="root" :class="ui.root({ class: [uiProp?.root, props.class] })">
+    <div v-if="!isIndeterminate && (status || !!slots.status)" data-slot="status" :class="ui.status({ class: uiProp?.status })" :style="statusStyle">
       <slot name="status" :percent="percent">
         {{ percent }}%
       </slot>
     </div>
 
-    <ProgressRoot v-bind="rootProps" :max="realMax" data-slot="base" :class="ui.base({ class: props.ui?.base })" style="transform: translateZ(0)">
-      <ProgressIndicator data-slot="indicator" :class="ui.indicator({ class: props.ui?.indicator })" :style="indicatorStyle" />
+    <ProgressRoot v-bind="rootProps" :max="realMax" data-slot="base" :class="ui.base({ class: uiProp?.base })" style="transform: translateZ(0)">
+      <ProgressIndicator data-slot="indicator" :class="ui.indicator({ class: uiProp?.indicator })" :style="indicatorStyle" />
     </ProgressRoot>
 
-    <div v-if="hasSteps" data-slot="steps" :class="ui.steps({ class: props.ui?.steps })">
-      <div v-for="(step, index) in max" :key="index" data-slot="step" :class="ui.step({ class: props.ui?.step, step: stepVariant(index) })">
+    <div v-if="hasSteps" data-slot="steps" :class="ui.steps({ class: uiProp?.steps })">
+      <div v-for="(step, index) in max" :key="index" data-slot="step" :class="ui.step({ class: uiProp?.step, step: stepVariant(index) })">
         <slot :name="`step-${index}`" :step="step">
           {{ step }}
         </slot>

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

@@ -1,4 +1,5 @@
 import type { ProgressRootProps, ProgressRootEmits } from 'reka-ui';
+import type { VNode } from 'vue';
 import type { AppConfig } from '@nuxt/schema';
 import theme from '#build/ui/progress';
 import type { ComponentConfig } from '../types/tv';
@@ -39,13 +40,13 @@ export interface ProgressProps extends Pick<ProgressRootProps, 'getValueLabel' |
 export interface ProgressEmits extends ProgressRootEmits {
 }
 export type ProgressSlots = {
-    status(props: {
+    status?(props: {
         percent?: number;
-    }): any;
+    }): VNode[];
 } & {
     [key: string]: (props: {
         step: number;
-    }) => any;
+    }) => VNode[];
 };
 declare const _default: typeof __VLS_export;
 export default _default;

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

@@ -1,4 +1,5 @@
 import type { RadioGroupRootProps, RadioGroupRootEmits } from 'reka-ui';
+import type { VNode } from 'vue';
 import type { AppConfig } from '@nuxt/schema';
 import theme from '#build/ui/radio-group';
 import type { AcceptableValue, GetItemKeys, GetModelValue, GetModelValueEmits } from '../types/utils';
@@ -74,26 +75,26 @@ type NormalizeItem<T extends RadioGroupItem> = Exclude<T & {
 }, RadioGroupValue>;
 type SlotProps<T extends RadioGroupItem> = (props: {
     item: NormalizeItem<T>;
-    modelValue?: RadioGroupValue;
-}) => any;
+    modelValue: RadioGroupValue;
+}) => VNode[];
 export interface RadioGroupSlots<T extends RadioGroupItem[] = RadioGroupItem[]> {
-    legend(props?: {}): any;
-    label: SlotProps<T[number]>;
-    description: SlotProps<T[number]>;
+    legend?(props?: {}): VNode[];
+    label?: SlotProps<T[number]>;
+    description?: SlotProps<T[number]>;
 }
 declare const _default: typeof __VLS_export;
 export default _default;
 declare const __VLS_export: <T extends RadioGroupItem[], VK extends GetItemKeys<T> = "value">(__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<RadioGroupProps<T, VK> & {
         onChange?: ((event: Event) => any) | undefined;
-        "onUpdate:modelValue"?: ((value: import("../types").GetItemValue<T, VK, import("../types").NestedItem<T>>) => any) | undefined;
+        "onUpdate:modelValue"?: ((value: import("../types").GetItemValue<T, VK, undefined, import("../types").NestedItem<T>>) => any) | undefined;
     }> & (typeof globalThis extends {
         __VLS_PROPS_FALLBACK: infer P;
     } ? P : {});
     expose: (exposed: {}) => void;
     attrs: any;
     slots: RadioGroupSlots<T>;
-    emit: ((evt: "change", event: Event) => void) & ((evt: "update:modelValue", value: import("../types").GetItemValue<T, VK, import("../types").NestedItem<T>>) => void);
+    emit: ((evt: "change", event: Event) => void) & ((evt: "update:modelValue", value: import("../types").GetItemValue<T, VK, undefined, import("../types").NestedItem<T>>) => void);
 }>) => import("vue").VNode & {
     __ctx?: Awaited<typeof __VLS_setup>;
 };

package/dist/runtime/components/RadioGroup.vue

@@ -7,6 +7,7 @@ import { computed, useId } from "vue";
 import { RadioGroupRoot, RadioGroupItem as RRadioGroupItem, RadioGroupIndicator, Label, useForwardPropsEmits } from "reka-ui";
 import { reactivePick } from "@vueuse/core";
 import { useAppConfig } from "#imports";
+import { useComponentUI } from "../composables/useComponentUI";
 import { useFormField } from "../composables/useFormField";
 import { get } from "../utils";
 import { tv } from "../utils/tv";
@@ -25,7 +26,7 @@ const props = defineProps({
   orientation: { type: null, required: false, default: "vertical" },
   indicator: { type: null, required: false },
   class: { type: null, required: false },
-  ui: { type: null, required: false },
+  ui: { type: Object, required: false },
   disabled: { type: Boolean, required: false },
   loop: { type: Boolean, required: false },
   name: { type: String, required: false },
@@ -34,6 +35,7 @@ const props = defineProps({
 const emits = defineEmits(["change", "update:modelValue"]);
 const slots = defineSlots();
 const appConfig = useAppConfig();
+const uiProp = useComponentUI("radioGroup", props);
 const rootProps = useForwardPropsEmits(reactivePick(props, "as", "loop", "required"), emits);
 const { emitFormChange, emitFormInput, color, name, size, id: _id, disabled, ariaAttrs } = useFormField(props, { bind: false });
 const id = _id.value ?? useId();
@@ -96,36 +98,36 @@ function onUpdate(value) {
     :name="name"
     :disabled="disabled"
     data-slot="root"
-    :class="ui.root({ class: [props.ui?.root, props.class] })"
+    :class="ui.root({ class: [uiProp?.root, props.class] })"
     @update:model-value="onUpdate"
   >
-    <fieldset data-slot="fieldset" :class="ui.fieldset({ class: props.ui?.fieldset })" v-bind="ariaAttrs">
-      <legend v-if="legend || !!slots.legend" data-slot="legend" :class="ui.legend({ class: props.ui?.legend })">
+    <fieldset data-slot="fieldset" :class="ui.fieldset({ class: uiProp?.fieldset })" v-bind="ariaAttrs">
+      <legend v-if="legend || !!slots.legend" data-slot="legend" :class="ui.legend({ class: uiProp?.legend })">
         <slot name="legend">
           {{ legend }}
         </slot>
       </legend>
 
-      <component :is="!variant || variant === 'list' ? 'div' : Label" v-for="item in normalizedItems" :key="item.value" data-slot="item" :class="ui.item({ class: [props.ui?.item, item.ui?.item, item.class], disabled: item.disabled || disabled })">
-        <div data-slot="container" :class="ui.container({ class: [props.ui?.container, item.ui?.container] })">
+      <component :is="!variant || variant === 'list' ? 'div' : Label" v-for="item in normalizedItems" :key="item.value" data-slot="item" :class="ui.item({ class: [uiProp?.item, item.ui?.item, item.class], disabled: item.disabled || disabled })">
+        <div data-slot="container" :class="ui.container({ class: [uiProp?.container, item.ui?.container] })">
           <RRadioGroupItem
             :id="item.id"
             :value="item.value"
             :disabled="item.disabled || disabled"
             data-slot="base"
-            :class="ui.base({ class: [props.ui?.base, item.ui?.base], disabled: item.disabled || disabled })"
+            :class="ui.base({ class: [uiProp?.base, item.ui?.base], disabled: item.disabled || disabled })"
           >
-            <RadioGroupIndicator data-slot="indicator" :class="ui.indicator({ class: [props.ui?.indicator, item.ui?.indicator] })" />
+            <RadioGroupIndicator data-slot="indicator" :class="ui.indicator({ class: [uiProp?.indicator, item.ui?.indicator] })" />
           </RRadioGroupItem>
         </div>
 
-        <div v-if="item.label || !!slots.label || (item.description || !!slots.description)" data-slot="wrapper" :class="ui.wrapper({ class: [props.ui?.wrapper, item.ui?.wrapper] })">
-          <component :is="!variant || variant === 'list' ? Label : 'p'" v-if="item.label || !!slots.label" :for="item.id" data-slot="label" :class="ui.label({ class: [props.ui?.label, item.ui?.label], disabled: item.disabled || disabled })">
+        <div v-if="item.label || !!slots.label || (item.description || !!slots.description)" data-slot="wrapper" :class="ui.wrapper({ class: [uiProp?.wrapper, item.ui?.wrapper] })">
+          <component :is="!variant || variant === 'list' ? Label : 'p'" v-if="item.label || !!slots.label" :for="item.id" data-slot="label" :class="ui.label({ class: [uiProp?.label, item.ui?.label], disabled: item.disabled || disabled })">
             <slot name="label" :item="item" :model-value="modelValue">
               {{ item.label }}
             </slot>
           </component>
-          <p v-if="item.description || !!slots.description" data-slot="description" :class="ui.description({ class: [props.ui?.description, item.ui?.description], disabled: item.disabled || disabled })">
+          <p v-if="item.description || !!slots.description" data-slot="description" :class="ui.description({ class: [uiProp?.description, item.ui?.description], disabled: item.disabled || disabled })">
             <slot name="description" :item="item" :model-value="modelValue">
               {{ item.description }}
             </slot>

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

@@ -1,4 +1,5 @@
 import type { RadioGroupRootProps, RadioGroupRootEmits } from 'reka-ui';
+import type { VNode } from 'vue';
 import type { AppConfig } from '@nuxt/schema';
 import theme from '#build/ui/radio-group';
 import type { AcceptableValue, GetItemKeys, GetModelValue, GetModelValueEmits } from '../types/utils';
@@ -74,26 +75,26 @@ type NormalizeItem<T extends RadioGroupItem> = Exclude<T & {
 }, RadioGroupValue>;
 type SlotProps<T extends RadioGroupItem> = (props: {
     item: NormalizeItem<T>;
-    modelValue?: RadioGroupValue;
-}) => any;
+    modelValue: RadioGroupValue;
+}) => VNode[];
 export interface RadioGroupSlots<T extends RadioGroupItem[] = RadioGroupItem[]> {
-    legend(props?: {}): any;
-    label: SlotProps<T[number]>;
-    description: SlotProps<T[number]>;
+    legend?(props?: {}): VNode[];
+    label?: SlotProps<T[number]>;
+    description?: SlotProps<T[number]>;
 }
 declare const _default: typeof __VLS_export;
 export default _default;
 declare const __VLS_export: <T extends RadioGroupItem[], VK extends GetItemKeys<T> = "value">(__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<RadioGroupProps<T, VK> & {
         onChange?: ((event: Event) => any) | undefined;
-        "onUpdate:modelValue"?: ((value: import("../types").GetItemValue<T, VK, import("../types").NestedItem<T>>) => any) | undefined;
+        "onUpdate:modelValue"?: ((value: import("../types").GetItemValue<T, VK, undefined, import("../types").NestedItem<T>>) => any) | undefined;
     }> & (typeof globalThis extends {
         __VLS_PROPS_FALLBACK: infer P;
     } ? P : {});
     expose: (exposed: {}) => void;
     attrs: any;
     slots: RadioGroupSlots<T>;
-    emit: ((evt: "change", event: Event) => void) & ((evt: "update:modelValue", value: import("../types").GetItemValue<T, VK, import("../types").NestedItem<T>>) => void);
+    emit: ((evt: "change", event: Event) => void) & ((evt: "update:modelValue", value: import("../types").GetItemValue<T, VK, undefined, import("../types").NestedItem<T>>) => void);
 }>) => import("vue").VNode & {
     __ctx?: Awaited<typeof __VLS_setup>;
 };

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

@@ -1,3 +1,4 @@
+import type { VNode } from 'vue';
 import type { AppConfig } from '@nuxt/schema';
 import type { VirtualItem, VirtualizerOptions } from '@tanstack/vue-virtual';
 import theme from '#build/ui/scroll-area';
@@ -20,6 +21,13 @@ export interface ScrollAreaVirtualizeOptions extends Partial<Omit<VirtualizerOpt
      * @defaultValue undefined
      */
     lanes?: number;
+    /**
+     * Skip per-item DOM measurement for uniform-height items.
+     * When `true`, uses `estimateSize` only — significantly improving performance for uniform items.
+     * When `false` (default), measures each item for variable-height layouts (e.g., masonry).
+     * @defaultValue false
+     */
+    skipMeasurement?: boolean;
 }
 export type ScrollAreaItem = any;
 export interface ScrollAreaProps<T extends ScrollAreaItem = ScrollAreaItem> {
@@ -47,11 +55,14 @@ export interface ScrollAreaProps<T extends ScrollAreaItem = ScrollAreaItem> {
     ui?: ScrollArea['slots'];
 }
 export interface ScrollAreaSlots<T extends ScrollAreaItem = ScrollAreaItem> {
-    default(props: {
+    default?(props: {
         item: T;
         index: number;
         virtualItem?: VirtualItem;
-    } | Record<string, never>): any;
+    } | {
+        item: T;
+        index: 0;
+    }): VNode[];
 }
 export interface ScrollAreaEmits {
     /**

package/dist/runtime/components/ScrollArea.vue

@@ -3,11 +3,12 @@ import theme from "#build/ui/scroll-area";
 </script>
 
 <script setup>
-import { computed, toRef, useTemplateRef, watch } from "vue";
+import { computed, onMounted, onUnmounted, toRef, useTemplateRef, watch } from "vue";
 import { Primitive } from "reka-ui";
 import { defu } from "defu";
 import { useVirtualizer } from "@tanstack/vue-virtual";
 import { useAppConfig } from "#imports";
+import { useComponentUI } from "../composables/useComponentUI";
 import { tv } from "../utils/tv";
 import { useLocale } from "../composables/useLocale";
 const props = defineProps({
@@ -16,12 +17,13 @@ const props = defineProps({
   items: { type: Array, required: false },
   virtualize: { type: [Boolean, Object], required: false, default: false },
   class: { type: null, required: false },
-  ui: { type: null, required: false }
+  ui: { type: Object, required: false }
 });
 defineSlots();
 const emits = defineEmits(["scroll"]);
 const { dir } = useLocale();
 const appConfig = useAppConfig();
+const uiProp = useComponentUI("scrollArea", props);
 const ui = computed(() => tv({ extend: tv(theme), ...appConfig.ui?.scrollArea || {} })({
   orientation: props.orientation
 }));
@@ -44,6 +46,9 @@ const lanes = computed(() => {
   const value = virtualizerProps.value.lanes;
   return typeof value === "number" ? value : void 0;
 });
+const skipMeasurement = computed(() => {
+  return typeof props.virtualize === "object" && props.virtualize.skipMeasurement === true;
+});
 const virtualizer = !!props.virtualize && useVirtualizer({
   ...virtualizerProps.value,
   get overscan() {
@@ -101,13 +106,32 @@ function getVirtualItemStyle(virtualItem) {
     transform: isHorizontal.value ? `translateX(${isRtl.value ? -virtualItem.start : virtualItem.start}px)` : `translateY(${virtualItem.start}px)`
   };
 }
-watch(lanes, () => {
+let resizeObserver = null;
+let rafId = null;
+onMounted(() => {
   if (virtualizer) {
-    virtualizer.value.measure();
+    const el = rootRef.value?.$el;
+    if (el) {
+      resizeObserver = new ResizeObserver(() => {
+        if (rafId !== null) return;
+        rafId = requestAnimationFrame(() => {
+          rafId = null;
+          virtualizer.value.measure();
+        });
+      });
+      resizeObserver.observe(el);
+    }
+  }
+});
+onUnmounted(() => {
+  if (rafId !== null) {
+    cancelAnimationFrame(rafId);
+    rafId = null;
   }
-}, { flush: "sync" });
+  resizeObserver?.disconnect();
+});
 function measureElement(el) {
-  if (el && virtualizer) {
+  if (el && virtualizer && !skipMeasurement.value) {
     const element = el instanceof Element ? el : el.$el;
     virtualizer.value.measureElement(element);
   }
@@ -139,12 +163,12 @@ defineExpose({
     :as="as"
     data-slot="root"
     :data-orientation="orientation"
-    :class="ui.root({ class: [props.ui?.root, props.class] })"
+    :class="ui.root({ class: [uiProp?.root, props.class] })"
   >
     <template v-if="virtualizer">
       <div
         data-slot="viewport"
-        :class="ui.viewport({ class: props.ui?.viewport })"
+        :class="ui.viewport({ class: uiProp?.viewport })"
         :style="virtualViewportStyle"
       >
         <div
@@ -153,7 +177,7 @@ defineExpose({
           :ref="measureElement"
           :data-index="virtualItem.index"
           data-slot="item"
-          :class="ui.item({ class: props.ui?.item })"
+          :class="ui.item({ class: uiProp?.item })"
           :style="getVirtualItemStyle(virtualItem)"
         >
           <slot
@@ -166,20 +190,20 @@ defineExpose({
     </template>
 
     <template v-else>
-      <div data-slot="viewport" :class="ui.viewport({ class: props.ui?.viewport })">
-        <template v-if="items?.length">
+      <div data-slot="viewport" :class="ui.viewport({ class: uiProp?.viewport })">
+        <template v-if="items">
           <div
             v-for="(item, index) in items"
             :key="getItemKey(item, index)"
             data-slot="item"
-            :class="ui.item({ class: props.ui?.item })"
+            :class="ui.item({ class: uiProp?.item })"
           >
             <slot :item="item" :index="index" />
           </div>
         </template>
 
         <template v-else>
-          <slot />
+          <slot :item="{}" :index="0" />
         </template>
       </div>
     </template>

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

@@ -1,3 +1,4 @@
+import type { VNode } from 'vue';
 import type { AppConfig } from '@nuxt/schema';
 import type { VirtualItem, VirtualizerOptions } from '@tanstack/vue-virtual';
 import theme from '#build/ui/scroll-area';
@@ -20,6 +21,13 @@ export interface ScrollAreaVirtualizeOptions extends Partial<Omit<VirtualizerOpt
      * @defaultValue undefined
      */
     lanes?: number;
+    /**
+     * Skip per-item DOM measurement for uniform-height items.
+     * When `true`, uses `estimateSize` only — significantly improving performance for uniform items.
+     * When `false` (default), measures each item for variable-height layouts (e.g., masonry).
+     * @defaultValue false
+     */
+    skipMeasurement?: boolean;
 }
 export type ScrollAreaItem = any;
 export interface ScrollAreaProps<T extends ScrollAreaItem = ScrollAreaItem> {
@@ -47,11 +55,14 @@ export interface ScrollAreaProps<T extends ScrollAreaItem = ScrollAreaItem> {
     ui?: ScrollArea['slots'];
 }
 export interface ScrollAreaSlots<T extends ScrollAreaItem = ScrollAreaItem> {
-    default(props: {
+    default?(props: {
         item: T;
         index: number;
         virtualItem?: VirtualItem;
-    } | Record<string, never>): any;
+    } | {
+        item: T;
+        index: 0;
+    }): VNode[];
 }
 export interface ScrollAreaEmits {
     /**