hys-ui 0.3.0 → 0.4.0

package/dist/types/components/HysAnimatedNumber/HysAnimatedNumber.vue.d.ts

@@ -1,11 +1,65 @@
-type __VLS_Props = {
-    value: number;
+import type { StyleValue, VNodeChild } from "vue";
+export interface HysAnimatedNumberContext {
+    value: number | string;
+    displayValue: string;
+    remaining?: number;
+}
+export interface HysAnimatedNumberProps {
+    value?: number | string;
     duration?: number;
     decimals?: number;
-};
-declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
-    duration: number;
-    decimals: number;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+    precision?: number;
+    groupSeparator?: string;
+    decimalSeparator?: string;
+    title?: string;
+    prefix?: string;
+    suffix?: string;
+    valueStyle?: StyleValue;
+    formatter?: (context: HysAnimatedNumberContext) => VNodeChild;
+    /** 倒计时截止时间，可传 Unix 毫秒时间戳或 Date。 */
+    deadline?: number | Date;
+    /** 支持 D、HH、mm、ss、SSS 等标记，用方括号包裹字面文本。 */
+    format?: string;
+}
 declare const _default: typeof __VLS_export;
 export default _default;
+declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<HysAnimatedNumberProps, {
+    displayValue: import("vue").ComputedRef<string>;
+    remaining: import("vue").Ref<number, number>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    change: (remaining: number) => any;
+    finish: () => any;
+}, string, import("vue").PublicProps, Readonly<HysAnimatedNumberProps> & Readonly<{
+    onChange?: ((remaining: number) => any) | undefined;
+    onFinish?: (() => any) | undefined;
+}>, {
+    value: string | number;
+    format: string;
+    duration: number;
+    decimalSeparator: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {
+    title?: (props: {}) => any;
+} & {
+    prefix?: (props: {
+        value: number | string;
+        displayValue: string;
+        remaining?: number;
+    }) => any;
+} & {
+    formatter?: (props: {
+        value: number | string;
+        displayValue: string;
+        remaining?: number;
+    }) => any;
+} & {
+    suffix?: (props: {
+        value: number | string;
+        displayValue: string;
+        remaining?: number;
+    }) => any;
+}>;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/components/HysAutocomplete/HysAutocomplete.vue.d.ts

@@ -35,6 +35,7 @@ declare const __VLS_template: () => {
                 "aria-busy": true | undefined;
                 type?: string;
                 autofocus?: boolean;
+                formatter?: (value: string, info: import("../..").HysInputFormatInfo) => string;
                 resize?: "none" | "both" | "horizontal" | "vertical";
                 showPassword?: boolean;
                 showPasswordOn?: "click" | "mousedown";
@@ -51,7 +52,6 @@ declare const __VLS_template: () => {
                 countGraphemes?: import("../..").HysInputCountStrategy;
                 maxlength?: number | string;
                 minlength?: number | string;
-                formatter?: (value: string, info: import("../..").HysInputFormatInfo) => string;
                 parser?: (value: string) => string | number;
                 allowInput?: (value: string) => boolean;
                 rows?: number;

package/dist/types/components/HysButton/HysButton.vue.d.ts

@@ -1,19 +1,70 @@
-import { type Component } from 'vue';
-export type HysButtonVariant = 'primary' | 'secondary' | 'ghost' | 'danger' | 'success' | 'warning' | 'info' | 'text' | 'link';
+import { type Component, type VNode } from 'vue';
+export type HysButtonPaletteColor = 'slate' | 'blue' | 'indigo' | 'purple' | 'cyan' | 'teal' | 'green' | 'lime' | 'amber' | 'orange' | 'red' | 'pink';
+export type HysButtonVariant = 'primary' | 'secondary' | 'ghost' | 'danger' | 'success' | 'warning' | 'info' | 'text' | 'link' | HysButtonPaletteColor;
+export type HysButtonAppearance = HysButtonVariant | 'default' | '';
+export type HysButtonSize = 'sm' | 'md' | 'lg' | 'small' | 'default' | 'large' | '';
+export interface HysButtonActionContext {
+    signal: AbortSignal;
+    event: MouseEvent;
+    pressed: boolean;
+}
+export type HysButtonAction = (context: HysButtonActionContext) => unknown;
+export type HysButtonActionGuard = (context: HysButtonActionContext) => boolean | void | Promise<boolean | void>;
+export interface HysButtonInstance {
+    readonly element?: HTMLElement;
+    readonly ref?: HTMLElement;
+    readonly busy: boolean;
+    readonly disabled: boolean;
+    readonly size: 'sm' | 'md' | 'lg';
+    readonly type: HysButtonVariant;
+    readonly shouldAddSpace: boolean;
+    focus: () => void;
+    blur: () => void;
+    cancelAction: () => void;
+}
 export interface HysButtonProps {
+    /** 语义外观或内置配色，例如 teal、indigo 和 amber。 */
     variant?: HysButtonVariant;
-    size?: 'sm' | 'md' | 'lg';
+    size?: HysButtonSize;
     disabled?: boolean;
-    loading?: boolean;
+    /** 延迟显示加载图标时，按钮仍会立即阻止重复操作。 */
+    loading?: boolean | {
+        delay: number;
+    };
+    loadingIcon?: string | Component;
+    loadingText?: string;
+    /** 执行期间锁定按钮并接管默认点击行为，组件停用或销毁时取消。 */
+    action?: HysButtonAction;
+    /** 返回 false 时取消操作，支持异步检查。 */
+    beforeAction?: HysButtonActionGuard;
+    actionLoadingDelay?: number;
+    toggle?: boolean;
+    /** 受控按下状态，配合 v-model:pressed 使用。 */
+    pressed?: boolean;
+    defaultPressed?: boolean;
     plain?: boolean;
     round?: boolean;
     circle?: boolean;
+    shape?: 'default' | 'round' | 'circle';
     block?: boolean;
     dashed?: boolean;
     color?: string;
-    icon?: Component;
+    /** 使用深色背景下的配色计算。默认跟随当前主题。 */
+    dark?: boolean;
+    danger?: boolean;
+    ghost?: boolean;
+    text?: boolean;
+    link?: boolean;
+    /** 为文字按钮显示背景。 */
+    bg?: boolean;
+    /** 文案恰好是两个汉字时显示字间距。 */
+    autoInsertSpace?: boolean;
+    /** 自定义根标签或组件，href 默认使用原生链接。 */
+    tag?: string | Component;
+    icon?: string | Component;
     iconPosition?: 'left' | 'right';
-    type?: 'button' | 'submit' | 'reset';
+    /** 外观类型，也兼容原有 button、submit、reset 原生类型。 */
+    type?: HysButtonAppearance | 'button' | 'submit' | 'reset';
     nativeType?: 'button' | 'submit' | 'reset';
     href?: string;
     target?: string;
@@ -22,32 +73,41 @@ export interface HysButtonProps {
     focusable?: boolean;
     ariaLabel?: string;
 }
-declare const __VLS_template: () => {
-    __VLS_Slots: {
-        loading?: (props: {}) => any;
-    } & {
-        icon?: (props: {}) => any;
-    } & {
-        default?: (props: {}) => any;
-    } & {
-        icon?: (props: {}) => any;
-    } & {
-        suffix?: (props: {}) => any;
-    };
+type __VLS_Slots = {
+    default?: () => VNode[];
+    icon?: () => VNode[];
+    loading?: () => VNode[];
+    suffix?: () => VNode[];
 };
-type __VLS_Slots = ReturnType<typeof __VLS_template>['__VLS_Slots'];
+declare function cancelAction(): void;
 declare const __VLS_base: import("vue").DefineComponent<HysButtonProps, {
-    element: import("vue").Ref<HTMLButtonElement | HTMLAnchorElement | undefined, HTMLButtonElement | HTMLAnchorElement | undefined>;
+    element: import("vue").ComputedRef<HTMLElement | undefined>;
+    ref: import("vue").ComputedRef<HTMLElement | undefined>;
+    busy: import("vue").ComputedRef<boolean>;
+    disabled: import("vue").ComputedRef<boolean>;
+    size: import("vue").ComputedRef<"sm" | "md" | "lg">;
+    type: import("vue").ComputedRef<HysButtonVariant>;
+    shouldAddSpace: import("vue").Ref<boolean, boolean>;
+    cancelAction: typeof cancelAction;
     focus: () => void | undefined;
     blur: () => void | undefined;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     click: (event: MouseEvent) => any;
+    "update:pressed": (value: boolean) => any;
+    pressedChange: (value: boolean) => any;
+    actionSuccess: (result: unknown, context: HysButtonActionContext) => any;
+    actionError: (error: unknown, context: HysButtonActionContext) => any;
 }, string, import("vue").PublicProps, Readonly<HysButtonProps> & Readonly<{
     onClick?: ((event: MouseEvent) => any) | undefined;
+    "onUpdate:pressed"?: ((value: boolean) => any) | undefined;
+    onPressedChange?: ((value: boolean) => any) | undefined;
+    onActionSuccess?: ((result: unknown, context: HysButtonActionContext) => any) | undefined;
+    onActionError?: ((error: unknown, context: HysButtonActionContext) => any) | undefined;
 }>, {
-    type: "button" | "submit" | "reset";
+    dark: boolean;
     focusable: boolean;
-    variant: HysButtonVariant;
+    pressed: boolean;
+    autoInsertSpace: boolean;
     iconPosition: "left" | "right";
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

package/dist/types/components/HysButtonGroup/HysButtonGroup.vue.d.ts

@@ -0,0 +1,30 @@
+import { type VNodeChild } from "vue";
+import type { HysButtonAppearance, HysButtonSize, HysButtonVariant } from "../HysButton/HysButton.vue";
+export interface HysButtonGroupProps {
+    variant?: HysButtonVariant;
+    size?: HysButtonSize;
+    type?: HysButtonAppearance;
+    direction?: "horizontal" | "vertical";
+    joined?: boolean;
+    gap?: number | string;
+    wrap?: boolean;
+    block?: boolean;
+    disabled?: boolean;
+    ariaLabel?: string;
+}
+type __VLS_Slots = {
+    default?: () => VNodeChild;
+};
+declare const __VLS_base: import("vue").DefineComponent<HysButtonGroupProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<HysButtonGroupProps> & Readonly<{}>, {
+    direction: "horizontal" | "vertical";
+    gap: string | number;
+    joined: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/components/HysCascader/HysCascaderColumn.vue.d.ts

@@ -22,11 +22,11 @@ declare const __VLS_export: <N extends object>(__VLS_props: NonNullable<Awaited<
         retryText: string;
         expandLabel: (entry: CascaderEntry<N>) => string;
     } & {
+        onKeyboard?: ((event: KeyboardEvent, entry: CascaderEntry<N>, level: number) => any) | undefined;
         onScroll?: ((event: Event) => any) | undefined;
         onRetry?: ((entry: CascaderEntry<N>) => any) | undefined;
         onHover?: ((entry: CascaderEntry<N> | null) => any) | undefined;
         onChoose?: ((entry: CascaderEntry<N>, event?: Event | undefined, checked?: boolean | undefined) => any) | undefined;
-        onKeyboard?: ((event: KeyboardEvent, entry: CascaderEntry<N>, level: number) => any) | undefined;
         onExpand?: ((entry: CascaderEntry<N>) => any) | undefined;
     }> & (typeof globalThis extends {
         __VLS_PROPS_FALLBACK: infer P;
@@ -42,7 +42,7 @@ declare const __VLS_export: <N extends object>(__VLS_props: NonNullable<Awaited<
         "expand-icon"?: (scope: HysCascaderOptionContext<N>) => any;
         loading?: (scope: HysCascaderOptionContext<N>) => any;
     };
-    emit: ((evt: "scroll", event: Event) => void) & ((evt: "retry", entry: CascaderEntry<N>) => void) & ((evt: "hover", entry: CascaderEntry<N> | null) => void) & ((evt: "choose", entry: CascaderEntry<N>, event?: Event | undefined, checked?: boolean | undefined) => void) & ((evt: "keyboard", event: KeyboardEvent, entry: CascaderEntry<N>, level: number) => void) & ((evt: "expand", entry: CascaderEntry<N>) => void);
+    emit: ((evt: "keyboard", event: KeyboardEvent, entry: CascaderEntry<N>, level: number) => void) & ((evt: "scroll", event: Event) => void) & ((evt: "retry", entry: CascaderEntry<N>) => void) & ((evt: "hover", entry: CascaderEntry<N> | null) => void) & ((evt: "choose", entry: CascaderEntry<N>, event?: Event | undefined, checked?: boolean | undefined) => void) & ((evt: "expand", entry: CascaderEntry<N>) => void);
 }>) => import("vue").VNode & {
     __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };

package/dist/types/components/HysColorPicker/HysColorPicker.vue.d.ts

@@ -52,10 +52,10 @@ declare const __VLS_base: import("vue").DefineComponent<HysColorPickerProps, {
     open: boolean;
     popupWidth: string | number;
     appendTo: string | false | HTMLElement;
-    showFooter: boolean;
-    validateEvent: boolean;
     showInput: boolean;
     showPresets: boolean;
+    showFooter: boolean;
+    validateEvent: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/types/components/HysContextMenu/HysMenuPanel.vue.d.ts

@@ -16,11 +16,11 @@ declare const __VLS_export: <N extends object>(__VLS_props: NonNullable<Awaited<
         context: (row: MenuRow<N>) => HysMenuItemContext<N>;
         tabbable: (row: MenuRow<N>) => number;
     } & {
+        onKeyboard?: ((event: KeyboardEvent) => any) | undefined;
         onScroll?: (() => any) | undefined;
         onChoose?: ((row: MenuRow<N>, event: MouseEvent) => any) | undefined;
         onFocusRow?: ((row: MenuRow<N>) => any) | undefined;
         onHoverRow?: ((row: MenuRow<N>) => any) | undefined;
-        onKeyboard?: ((event: KeyboardEvent) => any) | undefined;
         onBack?: (() => any) | undefined;
     }> & (typeof globalThis extends {
         __VLS_PROPS_FALLBACK: infer P;
@@ -66,7 +66,7 @@ declare const __VLS_export: <N extends object>(__VLS_props: NonNullable<Awaited<
     } & {
         footer?: (props: {}) => any;
     };
-    emit: ((evt: "scroll") => void) & ((evt: "choose", row: MenuRow<N>, event: MouseEvent) => void) & ((evt: "focusRow", row: MenuRow<N>) => void) & ((evt: "hoverRow", row: MenuRow<N>) => void) & ((evt: "keyboard", event: KeyboardEvent) => void) & ((evt: "back") => void);
+    emit: ((evt: "keyboard", event: KeyboardEvent) => void) & ((evt: "scroll") => void) & ((evt: "choose", row: MenuRow<N>, event: MouseEvent) => void) & ((evt: "focusRow", row: MenuRow<N>) => void) & ((evt: "hoverRow", row: MenuRow<N>) => void) & ((evt: "back") => void);
 }>) => import("vue").VNode & {
     __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };

package/dist/types/components/HysDatePicker/HysDatePickerControl.vue.d.ts

@@ -63,12 +63,12 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
     clearable: boolean;
     open: boolean;
     appendTo: string | false | HTMLElement;
+    showFooter: boolean;
+    validateEvent: boolean;
     showToday: boolean;
     firstDayOfWeek: number;
     locale: string;
     showAdjacentDays: boolean;
-    showFooter: boolean;
-    validateEvent: boolean;
     editable: boolean;
     showNow: boolean;
     showConfirm: boolean;

package/dist/types/components/HysDrawer/HysDrawer.vue.d.ts

@@ -77,9 +77,9 @@ declare const __VLS_base: import("vue").DefineComponent<HysDrawerProps, {
     open: boolean;
     appendTo: string | false | HTMLElement;
     loadingText: string;
+    cancelText: string;
     fullscreen: boolean;
     closeOnEscape: boolean;
-    cancelText: string;
     closeOnMask: boolean;
     showClose: boolean;
     destroyOnClose: boolean;

package/dist/types/components/HysMention/HysMention.vue.d.ts

@@ -1,50 +1,101 @@
-import type { HysPopupMotionProps } from '../../motion/popup';
-type __VLS_Props = HysPopupMotionProps & {
-    users: {
-        id: string;
-        name: string;
-        disabled?: boolean;
+import type { HysMentionContext, HysMentionDocument, HysMentionEntity, HysMentionInsertOptions, HysMentionOpenOptions, HysMentionOption, HysMentionProps, HysMentionSlots, HysMentionUser } from "../../composables/mention";
+type __VLS_Slots = HysMentionSlots;
+declare function dismiss(): void;
+declare function openManually(options?: HysMentionOpenOptions): boolean;
+declare function insertMention(option: HysMentionOption, options?: HysMentionInsertOptions): Promise<boolean>;
+declare function removeMention(target: HysMentionEntity | string | number): Promise<boolean>;
+declare function focusInput(): void;
+declare function clear(): Promise<boolean>;
+declare function setDocument(document: HysMentionDocument | string): Promise<boolean>;
+declare const __VLS_base: import("vue").DefineComponent<HysMentionProps, {
+    input: import("vue").Ref<HTMLElement | undefined, HTMLElement | undefined>;
+    dropdownVisible: import("vue").Ref<boolean, boolean>;
+    focus: typeof focusInput;
+    blur: () => void | undefined;
+    open: typeof openManually;
+    close: typeof dismiss;
+    update: () => void;
+    retry: () => void;
+    loadMore: () => Promise<boolean>;
+    insertMention: typeof insertMention;
+    removeMention: typeof removeMention;
+    getEntities: () => {
+        id: string | number;
+        value: string | number;
+        label: string;
+        type: string;
+        prefix: string;
+        text: string;
+        start: number;
+        end: number;
+        payload?: unknown;
     }[];
-    placeholder?: string;
-    disabled?: boolean;
-    readonly?: boolean;
-    maxlength?: number;
-    ariaLabel?: string;
-};
-type __VLS_ModelProps = {
-    modelValue?: string;
-};
-type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
-declare const __VLS_template: () => {
-    __VLS_Slots: {
-        option?: (props: {
-            user: {
-                id: string;
-                name: string;
-                disabled?: boolean;
-            };
-        }) => any;
+    getDocument: () => {
+        text: string;
+        entities: {
+            id: string | number;
+            value: string | number;
+            label: string;
+            type: string;
+            prefix: string;
+            text: string;
+            start: number;
+            end: number;
+            payload?: unknown;
+        }[];
     };
-};
-type __VLS_Slots = ReturnType<typeof __VLS_template>['__VLS_Slots'];
-declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {
-    focus: () => void | undefined;
-    blur: () => void | undefined;
+    setDocument: typeof setDocument;
+    serialize: () => string;
+    clear: typeof clear;
+    undo: () => Promise<boolean>;
+    redo: () => Promise<boolean>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     change: (value: string) => any;
     "update:modelValue": (value: string) => any;
-    select: (user: {
-        id: string;
-        name: string;
-    }) => any;
-}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    search: (query: string, prefix: string, context: HysMentionContext) => any;
+    clear: () => any;
+    select: (user: HysMentionUser, prefix: string, option: HysMentionOption) => any;
+    blur: (event: FocusEvent) => any;
+    focus: (event: FocusEvent) => any;
+    loadError: (error: unknown, context: HysMentionContext) => any;
+    create: (option: HysMentionOption, context: HysMentionContext) => any;
+    openChange: (open: boolean) => any;
+    "update:entities": (entities: HysMentionEntity[]) => any;
+    documentChange: (document: HysMentionDocument) => any;
+    entityAdd: (entity: HysMentionEntity) => any;
+    entityRemove: (entity: HysMentionEntity) => any;
+    wholeRemove: (value: string, prefix: string) => any;
+}, string, import("vue").PublicProps, Readonly<HysMentionProps> & Readonly<{
     onChange?: ((value: string) => any) | undefined;
     "onUpdate:modelValue"?: ((value: string) => any) | undefined;
-    onSelect?: ((user: {
-        id: string;
-        name: string;
-    }) => any) | undefined;
-}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+    onSearch?: ((query: string, prefix: string, context: HysMentionContext) => any) | undefined;
+    onClear?: (() => any) | undefined;
+    onSelect?: ((user: HysMentionUser, prefix: string, option: HysMentionOption) => any) | undefined;
+    onBlur?: ((event: FocusEvent) => any) | undefined;
+    onFocus?: ((event: FocusEvent) => any) | undefined;
+    onLoadError?: ((error: unknown, context: HysMentionContext) => any) | undefined;
+    onCreate?: ((option: HysMentionOption, context: HysMentionContext) => any) | undefined;
+    onOpenChange?: ((open: boolean) => any) | undefined;
+    "onUpdate:entities"?: ((entities: HysMentionEntity[]) => any) | undefined;
+    onDocumentChange?: ((document: HysMentionDocument) => any) | undefined;
+    onEntityAdd?: ((entity: HysMentionEntity) => any) | undefined;
+    onEntityRemove?: ((entity: HysMentionEntity) => any) | undefined;
+    onWholeRemove?: ((value: string, prefix: string) => any) | undefined;
+}>, {
+    split: string;
+    type: "textarea" | "text" | "rich";
+    offset: number;
+    placement: import("../..").Placement;
+    defaultValue: string;
+    filterOption: import("../..").HysMentionFilter;
+    debounce: number;
+    minQueryLength: number;
+    appendTo: string | false | HTMLElement;
+    autoAdjustOverflow: boolean;
+    restoreFocus: boolean;
+    invalidEntity: "mark" | "text" | "remove";
+    maxOptions: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/types/components/HysModal/HysModal.vue.d.ts

@@ -89,9 +89,9 @@ declare const __VLS_base: import("vue").DefineComponent<HysModalProps, {
     open: boolean;
     appendTo: string | false | HTMLElement;
     loadingText: string;
+    cancelText: string;
     fullscreen: boolean;
     closeOnEscape: boolean;
-    cancelText: string;
     initialFocus: import("../../index.js").HysModalInitialFocus;
     closeOnMask: boolean;
     showClose: boolean;

package/dist/types/components/HysNumberInput/HysNumberInput.vue.d.ts

@@ -45,11 +45,11 @@ declare const __VLS_export: <T extends HysNumberInputValue = number | null>(__VL
         "onUpdate:modelValue"?: ((value: T) => any) | undefined;
         onClear?: (() => any) | undefined;
         onInput?: ((value: T | null) => any) | undefined;
+        onStep?: ((value: T, info: HysNumberInputStepInfo) => any) | undefined;
         onBlur?: ((event: FocusEvent) => any) | undefined;
         onFocus?: ((event: FocusEvent) => any) | undefined;
         onInvalid?: ((info: HysNumberInputInvalidInfo) => any) | undefined;
         onPressEnter?: ((event: KeyboardEvent) => any) | undefined;
-        onStep?: ((value: T, info: HysNumberInputStepInfo) => any) | undefined;
     }> & (typeof globalThis extends {
         __VLS_PROPS_FALLBACK: infer P;
     } ? P : {});
@@ -83,7 +83,7 @@ declare const __VLS_export: <T extends HysNumberInputValue = number | null>(__VL
     } & {
         append?: (props: {}) => any;
     };
-    emit: ((evt: "change", value: T) => void) & ((evt: "update:modelValue", value: T) => void) & ((evt: "clear") => void) & ((evt: "input", value: T | null) => void) & ((evt: "blur", event: FocusEvent) => void) & ((evt: "focus", event: FocusEvent) => void) & ((evt: "invalid", info: HysNumberInputInvalidInfo) => void) & ((evt: "pressEnter", event: KeyboardEvent) => void) & ((evt: "step", value: T, info: HysNumberInputStepInfo) => void);
+    emit: ((evt: "change", value: T) => void) & ((evt: "update:modelValue", value: T) => void) & ((evt: "clear") => void) & ((evt: "input", value: T | null) => void) & ((evt: "step", value: T, info: HysNumberInputStepInfo) => void) & ((evt: "blur", event: FocusEvent) => void) & ((evt: "focus", event: FocusEvent) => void) & ((evt: "invalid", info: HysNumberInputInvalidInfo) => void) & ((evt: "pressEnter", event: KeyboardEvent) => void);
 }>) => import("vue").VNode & {
     __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };

package/dist/types/components/HysPagination/HysPagination.vue.d.ts

@@ -1,27 +1,68 @@
 type __VLS_Props = {
-    page: number;
-    total: number;
+    /** 受控页码，使用 v-model:page。省略时由分页器维护。 */
+    page?: number;
+    /** 总记录数，用于计算页数和当前记录范围。 */
+    total?: number;
+    /** 显式总页数；与 total 同时提供时优先用于分页。 */
+    pageCount?: number;
+    /** 受控每页条数，使用 v-model:page-size。省略时由分页器维护。 */
     pageSize?: number;
+    /** 非受控的初始页码，从 1 开始。 */
+    defaultPage?: number;
+    /** 非受控的初始每页条数。 */
+    defaultPageSize?: number;
+    /** 每页条数选项。当前条数会保留在列表中。 */
     pageSizeOptions?: number[];
+    /** 当前页左右各保留的页码数量，取值 0–5。 */
     siblingCount?: number;
     showSizeChanger?: boolean;
     showQuickJumper?: boolean;
+    /** 默认布局是否显示记录总数；需要 total 或 total 插槽。 */
     showTotal?: boolean;
+    /** 总页数小于等于一页时隐藏分页器。 */
+    hideOnSinglePage?: boolean;
     disabled?: boolean;
     loading?: boolean;
+    /** 以当前页 / 总页数代替页码，并隐藏跳转。 */
     compact?: boolean;
+    /** 在窄容器中以当前页 / 总页数代替页码。 */
+    responsive?: boolean;
+    /** 分页控件尺寸，sm、md、lg 分别为 28、32、40px。 */
+    size?: 'sm' | 'md' | 'lg';
+    /** 逗号分隔的控件顺序，支持 total、first、prev、pager、next、last、sizes、jumper。使用 -> 将后续控件靠右排列。 */
+    layout?: string;
+    /** 覆盖分页区域、按钮、字段标签和总数格式。 */
     labels?: Partial<{
         total: string;
         perPage: string;
         jump: string;
         page: string;
+        pageItem: string;
+        navigation: string;
+        confirm: string;
         first: string;
         previous: string;
         next: string;
         last: string;
     }>;
 };
-declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+type NavigationItem = 'first' | 'prev' | 'next' | 'last';
+type __VLS_Slots = {
+    total?: (props: {
+        total: number | undefined;
+        start: number;
+        end: number;
+        pageCount: number;
+    }) => unknown;
+    item?: (props: {
+        type: NavigationItem | 'page';
+        page: number;
+        active: boolean;
+        disabled: boolean;
+    }) => unknown;
+    'jump-button'?: () => unknown;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     change: (page: number) => any;
     "update:page": (page: number) => any;
     pageSizeChange: (size: number) => any;
@@ -33,13 +74,23 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
     "onUpdate:pageSize"?: ((size: number) => any) | undefined;
 }>, {
     disabled: boolean;
+    size: "sm" | "md" | "lg";
     compact: boolean;
     loading: boolean;
-    pageSize: number;
+    defaultPage: number;
+    defaultPageSize: number;
     siblingCount: number;
     showSizeChanger: boolean;
     showQuickJumper: boolean;
     showTotal: boolean;
+    hideOnSinglePage: boolean;
+    responsive: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/components/HysRating/HysRating.vue.d.ts

@@ -98,9 +98,9 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
     onHoverChange?: ((value: number | null) => any) | undefined;
 }>, {
     focusable: boolean;
+    keyboard: boolean;
     defaultValue: number;
     clearable: boolean;
-    keyboard: boolean;
     allowClear: boolean;
     scoreTemplate: string;
     lowThreshold: number;