@movk/nuxt 1.1.2 → 1.3.0

package/dist/runtime/types/components/color-chooser.d.ts

@@ -0,0 +1,109 @@
+import type { VNode } from 'vue';
+import type { ButtonProps, ColorPickerProps, IconProps, PopoverProps } from '@nuxt/ui';
+import type { OmitByKey } from '@movk/core';
+import type { ClassNameValue } from '../shared';
+type PopoverMode = 'click' | 'hover';
+export type ColorFormat = NonNullable<ColorPickerProps['format']>;
+export type ColorChooserTrigger = 'button' | 'chip' | 'input';
+export interface ColorChooserProps<M extends PopoverMode = PopoverMode> extends /** @vue-ignore */ OmitByKey<PopoverProps<M>, 'open' | 'defaultOpen' | 'ui'> {
+    id?: string;
+    name?: string;
+    /**
+     * 当前激活的颜色格式。
+     * @defaultValue 'hex'
+     */
+    format?: ColorFormat;
+    /**
+     * 启用的颜色格式 tab 列表，长度 >= 2 时在 popover 顶部渲染切换器。
+     * 仅一项时不渲染 tab，等价于 `format`。
+     * @defaultValue ['hex']
+     */
+    formats?: ColorFormat[];
+    /**
+     * 预设色板。
+     * 一维数组渲染为单行，二维数组渲染为多行分组。
+     */
+    swatches?: string[] | string[][];
+    /**
+     * 点击预设色后是否自动关闭弹层。
+     * @defaultValue true
+     */
+    closeOnSwatch?: boolean;
+    /** 是否在底部 actions 区显示清除按钮。 */
+    clearable?: boolean;
+    /** actions 区显示复制按钮（基于 navigator.clipboard）。 */
+    copyable?: boolean;
+    /**
+     * 触发器形态。
+     * - `button`：色点 + 色值 / label 的常规按钮（默认）
+     * - `chip`：仅一个圆形色点
+     * - `input`：色点 leading + 可输入色值文本框
+     * @defaultValue 'button'
+     */
+    trigger?: ColorChooserTrigger;
+    /** `trigger='button'` 时按钮上的文本，未传则显示当前色值。 */
+    label?: string;
+    /**
+     * 未选中颜色时的占位文案。
+     * @defaultValue '选择颜色'
+     */
+    placeholder?: string;
+    /**
+     * 触发器尺寸，同时驱动主题 size variant。
+     * @defaultValue 'md'
+     */
+    size?: ButtonProps['size'];
+    /** 触发按钮的颜色（trigger=button|chip 生效）。 */
+    color?: ButtonProps['color'];
+    /**
+     * 触发按钮的视觉变体（trigger=button|chip 生效）。
+     * @defaultValue 'subtle'
+     */
+    variant?: ButtonProps['variant'];
+    /** 是否禁用。禁用时弹层不会打开、所有交互失效。 */
+    disabled?: boolean;
+    /** Highlight the ring color like a focus state. */
+    highlight?: boolean;
+    /**
+     * 未选中颜色时占位的图标。
+     * @IconifyIcon
+     * @defaultValue 'i-lucide-palette'
+     */
+    icon?: IconProps['name'];
+    /**
+     * 透传给 `UColorPicker` 的属性。
+     * `modelValue`、`format`、`disabled` 由组件内部托管。
+     */
+    colorPickerProps?: Omit<ColorPickerProps, 'modelValue' | 'format' | 'disabled'>;
+    ui?: Record<string, ClassNameValue>;
+}
+export interface ColorChooserEmits {
+    'update:modelValue': [value: string | undefined];
+    'update:open': [open: boolean];
+    'change': [value: string | undefined];
+    'clear': [];
+    'copy': [value: string];
+    'format-change': [format: ColorFormat];
+}
+export interface ColorChooserSlots {
+    default?(props: {
+        open: boolean;
+        value: string | undefined;
+    }): VNode[];
+    leading?(props: {
+        value: string | undefined;
+    }): VNode[];
+    trailing?(props: {
+        value: string | undefined;
+    }): VNode[];
+    swatches?(props: {
+        swatches: string[][];
+        select: (color: string) => void;
+    }): VNode[];
+    actions?(props: {
+        value: string | undefined;
+        copy: () => void;
+        clear: () => void;
+    }): VNode[];
+}
+export {};

package/dist/runtime/types/components/date-picker.d.ts

@@ -0,0 +1,41 @@
+import type { ButtonProps, ButtonSlots, CalendarEmits, CalendarProps, CalendarSlots, PopoverEmits, PopoverProps, PopoverSlots } from '@nuxt/ui';
+import type { OmitByKey } from '@movk/core';
+import type { DateValue } from '@internationalized/date';
+import type { DateFormatter, DateFormatterOptions, ValueFormat } from '../../composables/useDateFormatter';
+import type { ClassNameValue } from '../shared';
+export type { ValueFormat } from '../../composables/useDateFormatter';
+export type LabelFormat = 'iso' | 'formatted' | 'date' | 'timestamp' | 'unix';
+export type DatePickerLabelFormatter<R extends boolean, M extends boolean> = (formatter: DateFormatter, modelValue: CalendarProps<R, M>['modelValue']) => string;
+type PopoverMode = 'click' | 'hover';
+type FormattedSingle<V extends ValueFormat> = V extends 'date-value' ? DateValue : V extends 'iso' ? string : V extends 'timestamp' ? number : V extends 'unix' ? number : V extends 'date' ? Date : never;
+export type FormattedValue<R extends boolean, M extends boolean, V extends ValueFormat> = M extends true ? FormattedSingle<V>[] : R extends true ? {
+    start: FormattedSingle<V> | undefined;
+    end: FormattedSingle<V> | undefined;
+} | undefined : FormattedSingle<V> | undefined;
+export interface DatePickerPreset<R extends boolean, M extends boolean> {
+    label: string;
+    value: CalendarProps<R, M>['modelValue'] | ((formatter: DateFormatter) => CalendarProps<R, M>['modelValue']);
+}
+export interface DatePickerProps<R extends boolean, M extends boolean, P extends PopoverMode = PopoverMode, V extends ValueFormat = 'date-value'> extends DateFormatterOptions, 
+/** @vue-ignore */ OmitByKey<CalendarProps<R, M>, 'modelValue' | 'placeholder' | 'ui'> {
+    id?: string;
+    name?: string;
+    /** @defaultValue '选择日期' */
+    placeholder?: string;
+    buttonProps?: ButtonProps;
+    popoverProps?: PopoverProps<P>;
+    labelFormat?: LabelFormat | DatePickerLabelFormatter<R, M>;
+    /**
+     * v-model 投影输出格式
+     * @defaultValue 'date-value'
+     */
+    valueFormat?: V;
+    clearable?: boolean;
+    /** 快捷预设 */
+    presets?: DatePickerPreset<R, M>[] | 'default';
+    ui?: Record<string, ClassNameValue>;
+}
+export type DatePickerEmits<R extends boolean, M extends boolean, V extends ValueFormat = 'date-value'> = PopoverEmits & Omit<CalendarEmits<R, M>, 'update:modelValue'> & {
+    'update:modelValue': [value: FormattedValue<R, M, V>];
+};
+export type DatePickerSlots<P extends PopoverMode = PopoverMode> = OmitByKey<PopoverSlots<P>, 'anchor'> & CalendarSlots & OmitByKey<ButtonSlots, 'default'>;

package/dist/runtime/types/components/index.d.ts

@@ -0,0 +1,8 @@
+export type { ColorChooserEmits, ColorChooserProps, ColorChooserSlots, ColorChooserTrigger, ColorFormat } from './color-chooser';
+export type { DatePickerEmits, DatePickerLabelFormatter, DatePickerPreset, DatePickerProps, FormattedValue, LabelFormat, ValueFormat } from './date-picker';
+export type { MessageBoxEmits, MessageBoxProps, MessageBoxSlots } from './message-box';
+export type { PopconfirmEmits, PopconfirmProps, PopconfirmSlots } from './popconfirm';
+export type { SlideVerifyEmits, SlideVerifyProps, SlideVerifySlots } from './slide-verify';
+export type { StarRatingEmits, StarRatingProps } from './star-rating';
+export type { PillGroupEmits, PillGroupProps, PillGroupSlots, PillItem, PillGroupValue, PillSelectPayload } from './pill-group';
+export type { AsPhoneNumberInputProps, WithCharacterLimitProps, WithClearEmits, WithClearProps, WithCopyEmits, WithCopyProps, WithFloatingLabelEmits, WithFloatingLabelProps, WithPasswordToggleProps } from './input';

package/dist/runtime/types/components/input/as-phone-number-input.d.ts

@@ -0,0 +1,17 @@
+import type { InputProps, InputValue } from '@nuxt/ui';
+import type { OmitByKey } from '@movk/core';
+import type { ClassNameValue } from '../../shared';
+export interface AsPhoneNumberInputProps<T extends InputValue = InputValue> extends /** @vue-ignore */ OmitByKey<InputProps<T>, 'type' | 'modelValue' | 'ui'> {
+    /**
+     * 输入掩码格式，`#` 表示一个数字位。
+     * @defaultValue '(###) ###-####'
+     */
+    mask?: string;
+    /**
+     * 区号前缀
+     * @defaultValue '+86'
+     * @example '+1'、'+44'
+     */
+    dialCode?: string;
+    ui?: Record<string, ClassNameValue>;
+}

package/dist/runtime/types/components/input/index.d.ts

@@ -0,0 +1,6 @@
+export type { AsPhoneNumberInputProps } from './as-phone-number-input';
+export type { WithCharacterLimitProps } from './with-character-limit';
+export type { WithClearEmits, WithClearProps } from './with-clear';
+export type { WithCopyEmits, WithCopyProps } from './with-copy';
+export type { WithFloatingLabelEmits, WithFloatingLabelProps } from './with-floating-label';
+export type { WithPasswordToggleProps } from './with-password-toggle';

package/dist/runtime/types/components/input/with-character-limit.d.ts

@@ -0,0 +1,11 @@
+import type { InputProps, InputValue } from '@nuxt/ui';
+import type { OmitByKey } from '@movk/core';
+import type { ClassNameValue } from '../../shared';
+export interface WithCharacterLimitProps<T extends InputValue = InputValue> extends /** @vue-ignore */ OmitByKey<InputProps<T>, 'modelValue' | 'ui'> {
+    /**
+     * 最大允许输入的字符数
+     * @defaultValue 50
+     */
+    maxLength?: number;
+    ui?: Record<string, ClassNameValue>;
+}

package/dist/runtime/types/components/input/with-clear.d.ts

@@ -0,0 +1,10 @@
+import type { ButtonProps, InputEmits, InputProps, InputValue } from '@nuxt/ui';
+import type { OmitByKey } from '@movk/core';
+import type { ClassNameValue } from '../../shared';
+export interface WithClearProps<T extends InputValue = InputValue> extends /** @vue-ignore */ OmitByKey<InputProps<T>, 'modelValue' | 'ui'> {
+    buttonProps?: ButtonProps;
+    ui?: Record<string, ClassNameValue>;
+}
+export type WithClearEmits<T extends InputValue = InputValue> = InputEmits<T> & {
+    clear: [];
+};

package/dist/runtime/types/components/input/with-copy.d.ts

@@ -0,0 +1,11 @@
+import type { ButtonProps, InputEmits, InputProps, InputValue, TooltipProps } from '@nuxt/ui';
+import type { OmitByKey } from '@movk/core';
+import type { ClassNameValue } from '../../shared';
+export interface WithCopyProps<T extends InputValue = InputValue> extends /** @vue-ignore */ OmitByKey<InputProps<T>, 'modelValue' | 'ui'> {
+    buttonProps?: ButtonProps;
+    tooltipProps?: TooltipProps;
+    ui?: Record<string, ClassNameValue>;
+}
+export type WithCopyEmits<T extends InputValue = InputValue> = InputEmits<T> & {
+    copy: [value: string];
+};

package/dist/runtime/types/components/input/with-floating-label.d.ts

@@ -0,0 +1,12 @@
+import type { ButtonProps, InputEmits, InputProps, InputValue } from '@nuxt/ui';
+import type { OmitByKey } from '@movk/core';
+import type { ClassNameValue } from '../../shared';
+export interface WithFloatingLabelProps<T extends InputValue = InputValue> extends /** @vue-ignore */ OmitByKey<InputProps<T>, 'modelValue' | 'size' | 'ui'> {
+    label?: string;
+    size?: InputProps<T>['size'];
+    clearButtonProps?: ButtonProps;
+    ui?: Record<string, ClassNameValue>;
+}
+export type WithFloatingLabelEmits<T extends InputValue = InputValue> = InputEmits<T> & {
+    clear: [];
+};

package/dist/runtime/types/components/input/with-password-toggle.d.ts

@@ -0,0 +1,7 @@
+import type { ButtonProps, InputProps, InputValue } from '@nuxt/ui';
+import type { OmitByKey } from '@movk/core';
+import type { ClassNameValue } from '../../shared';
+export interface WithPasswordToggleProps<T extends InputValue = InputValue> extends /** @vue-ignore */ OmitByKey<InputProps<T>, 'type' | 'modelValue' | 'ui'> {
+    buttonProps?: ButtonProps;
+    ui?: Record<string, ClassNameValue>;
+}

package/dist/runtime/types/components/message-box.d.ts

@@ -0,0 +1,69 @@
+import type { ButtonProps, IconProps, ModalProps, ModalSlots } from '@nuxt/ui';
+import type { OmitByKey } from '@movk/core';
+import type { ClassNameValue, SemanticColor } from '../shared';
+export interface MessageBoxProps extends /** @vue-ignore */ OmitByKey<ModalProps, 'title' | 'open' | 'defaultOpen' | 'dismissible' | 'ui'> {
+    /**
+     * 模态框标题文本。
+     * @defaultValue '提示'
+     */
+    title?: string;
+    /**
+     * 控制消息框的语义类型。
+     * 会影响默认图标与确认按钮颜色。
+     * @defaultValue 'primary'
+     */
+    type?: SemanticColor;
+    /**
+     * 标题前展示的图标名称。
+     * @IconifyIcon
+     * @defaultValue 'i-lucide-circle-question-mark'
+     */
+    icon?: IconProps['name'];
+    /**
+     * 控制消息框的操作模式。
+     * `alert` 仅显示确认按钮，`confirm` 显示取消与确认按钮。
+     * @defaultValue 'alert'
+     */
+    mode?: 'alert' | 'confirm';
+    /**
+     * 当 `false` 时，点击遮罩层或按下 `Esc` 键将不会关闭模态框。
+     * @defaultValue false
+     */
+    dismissible?: boolean;
+    /**
+     * alert 模式下的确认按钮文本。
+     * @defaultValue '知道了'
+     */
+    alertConfirmLabel?: string;
+    /**
+     * 确认按钮文本。
+     * @defaultValue '确认'
+     */
+    confirmLabel?: string;
+    /**
+     * 取消按钮文本。
+     * @defaultValue '取消'
+     */
+    cancelLabel?: string;
+    /**
+     * 透传给确认按钮的属性。
+     * 未显式指定 `color` 时会默认继承当前 `type`。
+     */
+    confirmButton?: ButtonProps;
+    /**
+     * 透传给取消按钮的属性。
+     * 仅在 `mode='confirm'` 时渲染。
+     */
+    cancelButton?: ButtonProps;
+    ui?: Record<string, ClassNameValue>;
+}
+export interface MessageBoxEmits {
+    /**
+     * 模态框关闭时触发。
+     * - `true`：用户点击了确认
+     * - `false`：用户点击了取消或通过其他方式关闭
+     */
+    close: [confirmed: boolean];
+}
+export interface MessageBoxSlots extends ModalSlots {
+}

package/dist/runtime/types/components/pill-group.d.ts

@@ -0,0 +1,103 @@
+import type { VNode } from 'vue';
+import type { AcceptableValue, AvatarProps, ButtonProps, GetItemKeys, GetModelValue } from '@nuxt/ui';
+import type { ClassNameValue } from '../shared';
+export type PillGroupValue = AcceptableValue;
+type PillItemUI = 'item' | 'itemWrapper' | 'itemLabel' | 'itemDescription' | 'leading' | 'trailing';
+export type PillItem = PillGroupValue | {
+    value?: PillGroupValue;
+    label?: string;
+    description?: string;
+    disabled?: boolean;
+    icon?: string;
+    avatar?: AvatarProps;
+    variant?: ButtonProps['variant'];
+    color?: ButtonProps['color'];
+    onSelect?: (e: Event) => void;
+    class?: ClassNameValue;
+    ui?: Partial<Record<PillItemUI, ClassNameValue>>;
+    [key: string]: any;
+};
+export interface PillGroupProps<T extends PillItem = PillItem, VK extends GetItemKeys<T> | undefined = undefined, M extends boolean = false> {
+    items?: T[];
+    valueKey?: VK;
+    /** @defaultValue 'label' */
+    labelKey?: GetItemKeys<T>;
+    /** @defaultValue 'description' */
+    descriptionKey?: GetItemKeys<T>;
+    /**
+     * 对象模式下判定 selected 的比较依据。string 走 `getPath` 比较（multiple=true 时启用 Map O(1)）；
+     * function 自定义比较；不传则按 [valueKey, 'value', labelKey] 启发式回退。
+     */
+    by?: string | ((a: T, b: T) => boolean);
+    /**
+     * 排列方向
+     * @defaultValue 'horizontal'
+     */
+    orientation?: 'horizontal' | 'vertical';
+    /**
+     * 按钮尺寸
+     * @defaultValue 'md'
+     */
+    size?: ButtonProps['size'];
+    /**
+     * 按钮颜色
+     * @defaultValue 'primary'
+     */
+    color?: ButtonProps['color'];
+    /**
+     * 选中态单项视觉变体
+     * @defaultValue 'solid'
+     */
+    activeVariant?: ButtonProps['variant'];
+    /**
+     * 未选中态单项视觉变体
+     * @defaultValue 'soft'
+     */
+    inactiveVariant?: ButtonProps['variant'];
+    disabled?: boolean;
+    /** 是否可以多选 */
+    multiple?: M & boolean;
+    /** 单选：再次点击当前选中项清空（多选模式下被忽略） */
+    deselectable?: boolean;
+    /** 多选：最多可选数量 */
+    max?: number;
+    /** 多选：最少需保留数量 */
+    min?: number;
+    defaultValue?: GetModelValue<T, VK, M>;
+    modelValue?: GetModelValue<T, VK, M>;
+    class?: ClassNameValue;
+    ui?: Record<string, ClassNameValue>;
+}
+type ItemSlotProps<T extends PillItem> = (props: {
+    item: T;
+    index: number;
+    selected: boolean;
+}) => VNode[];
+type GroupSlotProps<T extends PillItem, VK extends GetItemKeys<T> | undefined, M extends boolean> = (props: {
+    modelValue: GetModelValue<T, VK, M> | undefined;
+    items: T[];
+}) => VNode[];
+export interface PillGroupSlots<T extends PillItem = PillItem, VK extends GetItemKeys<T> | undefined = undefined, M extends boolean = false> {
+    'leading'?: GroupSlotProps<T, VK, M>;
+    'default'?: GroupSlotProps<T, VK, M>;
+    'trailing'?: GroupSlotProps<T, VK, M>;
+    'item'?: ItemSlotProps<T>;
+    'item-leading'?: ItemSlotProps<T>;
+    'item-label'?: ItemSlotProps<T>;
+    'item-description'?: ItemSlotProps<T>;
+    'item-trailing'?: ItemSlotProps<T>;
+}
+export interface PillSelectPayload<T extends PillItem> {
+    item: T;
+    value: PillGroupValue | T;
+    selected: boolean;
+    index: number;
+}
+export interface PillGroupEmits<T extends PillItem, VK extends GetItemKeys<T> | undefined, M extends boolean> {
+    'blur': [event: FocusEvent];
+    'focus': [event: FocusEvent];
+    'change': [value: GetModelValue<T, VK, M>];
+    'update:modelValue': [value: GetModelValue<T, VK, M>];
+    'select': [payload: PillSelectPayload<T>];
+}
+export {};

package/dist/runtime/types/components/popconfirm.d.ts

@@ -0,0 +1,74 @@
+import type { VNode } from 'vue';
+import type { ButtonProps, IconProps, LinkPropsKeys, PopoverProps, PopoverSlots } from '@nuxt/ui';
+import type { OmitByKey, VoidCallback } from '@movk/core';
+import type { ClassNameValue, SemanticColor } from '../shared';
+type PopoverMode = 'click' | 'hover';
+export interface PopconfirmProps<M extends PopoverMode = PopoverMode> extends /** @vue-ignore */ OmitByKey<PopoverProps<M>, 'open' | 'defaultOpen' | 'dismissible' | 'arrow' | 'ui'> {
+    /**
+     * 确认气泡的标题文本。
+     * @defaultValue '确认操作'
+     */
+    title?: string;
+    /**
+     * 标题下方的补充说明。
+     * 传入空字符串时可隐藏描述区。
+     * @defaultValue '请确认是否执行此操作?'
+     */
+    description?: string;
+    /**
+     * 预设的语义化颜色主题，会影响图标。
+     * @defaultValue 'neutral'
+     */
+    type?: SemanticColor;
+    /**
+     * 标题前展示的图标名称。
+     * @IconifyIcon
+     * @defaultValue 'i-lucide-circle-question-mark'
+     */
+    icon?: IconProps['name'];
+    /**
+     * 气泡内容与触发器之间的箭头指示。
+     * @defaultValue true
+     */
+    arrow?: boolean;
+    /**
+     * 透传给确认按钮的属性。
+     * `loading` 状态由组件内部托管。
+     */
+    confirmButton?: OmitByKey<ButtonProps, 'loading' | LinkPropsKeys>;
+    /**
+     * 透传给取消按钮的属性。
+     * 传入 `false` 可完全隐藏取消按钮。
+     * @defaultValue true
+     */
+    cancelButton?: ButtonProps | boolean;
+    /**
+     * 当 `false` 时，点击遮罩层或按下 `Esc` 键将不会关闭弹层。
+     * @defaultValue false
+     */
+    dismissible?: boolean;
+    /**
+     * 点击确认按钮时执行的回调。
+     * 支持返回 `Promise`，期间确认按钮自动进入 loading 状态。
+     * 回调成功完成后弹层自动关闭并触发 `confirm` 事件；抛错时保持弹层打开。
+     */
+    onConfirm?: VoidCallback;
+    ui?: Record<string, ClassNameValue>;
+}
+export interface PopconfirmEmits {
+    confirm: [];
+    cancel: [];
+    error: [error: unknown];
+}
+export interface PopconfirmSlots<M extends PopoverMode = PopoverMode> {
+    default?(props: {
+        open: boolean;
+    }): VNode[];
+    header?: PopoverSlots<M>['content'];
+    title?: PopoverSlots<M>['content'];
+    description?: PopoverSlots<M>['content'];
+    actions?: PopoverSlots<M>['content'];
+    body?: PopoverSlots<M>['content'];
+    footer?: PopoverSlots<M>['content'];
+}
+export {};

package/dist/runtime/types/components/slide-verify.d.ts

@@ -0,0 +1,54 @@
+import type { VNode } from 'vue';
+import type { ClassNameValue } from '../shared';
+import type { IconProps } from '@nuxt/ui';
+export interface SlideVerifyProps {
+    id?: string;
+    name?: string;
+    /**
+     * 尺寸大小
+     * @defaultValue 'md'
+     */
+    size?: string;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /**
+     * 待滑动时的提示文本
+     * @defaultValue '请向右滑动验证'
+     */
+    text?: string;
+    /**
+     * 验证成功时的提示文本
+     * @defaultValue '验证成功'
+     */
+    successText?: string;
+    /**
+     * 滑块图标
+     * @IconifyIcon
+     * @defaultValue 'i-lucide-chevrons-right'
+     */
+    icon?: IconProps['name'];
+    /**
+     * 验证成功时的图标
+     * @IconifyIcon
+     * @defaultValue 'i-lucide-check'
+     */
+    successIcon?: IconProps['name'];
+    /**
+     * 完成验证所需的阈值百分比（0-1）
+     * @defaultValue 0.9
+     */
+    threshold?: number;
+    class?: ClassNameValue;
+    ui?: Record<string, ClassNameValue>;
+}
+export interface SlideVerifyEmits {
+    success: [];
+    dragStart: [];
+    dragEnd: [success: boolean];
+}
+export interface SlideVerifySlots {
+    slider?(props: {
+        verified?: boolean;
+        progress: number;
+    }): VNode[];
+}

package/dist/runtime/types/components/star-rating.d.ts

@@ -0,0 +1,55 @@
+import type { ButtonProps, IconProps } from '@nuxt/ui';
+import type { ClassNameValue } from '../shared';
+export interface StarRatingProps {
+    id?: string;
+    name?: string;
+    /**
+     * 最大星级数
+     * @defaultValue 5
+     */
+    max?: number;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** Highlight the ring color like a focus state. */
+    highlight?: boolean;
+    /** 是否只读 */
+    readonly?: boolean;
+    /**
+     * 是否显示评分徽章
+     * @defaultValue true
+     */
+    showBadge?: boolean;
+    buttonProps?: ButtonProps;
+    /**
+     * 未选中星星的图标
+     * @IconifyIcon
+     * @defaultValue 'i-lucide-star'
+     */
+    emptyIcon?: IconProps['name'];
+    /**
+     * 选中星星的图标
+     * @IconifyIcon
+     * @defaultValue 'i-lucide-star'
+     */
+    filledIcon?: IconProps['name'];
+    /**
+     * 半星图标
+     * @IconifyIcon
+     * @defaultValue 'i-lucide-star-half'
+     */
+    halfIcon?: IconProps['name'];
+    /** 选中星星的颜色 */
+    color?: ButtonProps['color'];
+    /**  星星大小 @defaultValue 'md' */
+    size?: ButtonProps['size'];
+    /** 是否允许半星 */
+    allowHalf?: boolean;
+    /** 是否允许清除评分 */
+    clearable?: boolean;
+    class?: ClassNameValue;
+    ui?: Record<string, ClassNameValue>;
+}
+export interface StarRatingEmits {
+    change: [value: number];
+    hover: [value: number | null];
+}