hys-ui 0.3.0 → 0.5.0

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

@@ -88,7 +88,7 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
     destroyOnHide: boolean;
     type: "line" | "card" | "segment" | "border-card";
     animated: boolean;
-    activation: "auto" | "manual";
+    activation: "manual" | "auto";
     showScrollButtons: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

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

@@ -47,8 +47,8 @@ declare const __VLS_base: import("vue").DefineComponent<HysTagInputProps, {
     max: number;
     placeholder: string;
     autocomplete: string;
-    caseSensitive: boolean;
     validateEvent: boolean;
+    caseSensitive: boolean;
     addOnBlur: boolean;
     tagTone: "primary" | "success" | "warning" | "danger" | "neutral";
     tagEffect: "dark" | "light" | "outline";

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

@@ -4,11 +4,12 @@ type __VLS_Slots = {
     suffix?: () => any;
     prepend?: () => any;
     append?: () => any;
-    'clear-icon'?: () => any;
+    "clear-icon"?: () => any;
     count?: (info: HysInputCountInfo) => any;
 };
 type __VLS_Props = Omit<HysInputProps, "type" | "showPassword" | "showPasswordOn" | "passwordVisible" | "defaultPasswordVisible">;
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
+    element: import("vue").ComputedRef<HTMLTextAreaElement | undefined>;
     input: import("vue").ComputedRef<HTMLTextAreaElement | undefined>;
     textarea: import("vue").ComputedRef<HTMLTextAreaElement | undefined>;
     isComposing: import("vue").ComputedRef<boolean>;
@@ -17,6 +18,8 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
     select: () => void | undefined;
     clear: () => void | undefined;
     resize: () => Promise<void>;
+    resizeTextarea: () => Promise<void>;
+    textareaStyle: import("vue").ComputedRef<import("../../index.js").HysTextareaStyle>;
     setSelectionRange: (start: number, end: number, direction?: "forward" | "backward" | "none") => void | undefined;
     scrollTo: (options: ScrollToOptions) => void | undefined;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
@@ -24,31 +27,39 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
     "update:modelValue": (value: string) => any;
     clear: () => any;
     input: (value: string) => any;
+    keydown: (event: KeyboardEvent) => any;
     blur: (event: FocusEvent) => any;
     compositionend: (event: CompositionEvent) => any;
     compositionstart: (event: CompositionEvent) => any;
     compositionupdate: (event: CompositionEvent) => any;
     focus: (event: FocusEvent) => any;
+    mouseenter: (event: MouseEvent) => any;
+    mouseleave: (event: MouseEvent) => any;
     pressEnter: (event: KeyboardEvent) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onChange?: ((value: string) => any) | undefined;
     "onUpdate:modelValue"?: ((value: string) => any) | undefined;
     onClear?: (() => any) | undefined;
     onInput?: ((value: string) => any) | undefined;
+    onKeydown?: ((event: KeyboardEvent) => any) | undefined;
     onBlur?: ((event: FocusEvent) => any) | undefined;
     onCompositionend?: ((event: CompositionEvent) => any) | undefined;
     onCompositionstart?: ((event: CompositionEvent) => any) | undefined;
     onCompositionupdate?: ((event: CompositionEvent) => any) | undefined;
     onFocus?: ((event: FocusEvent) => any) | undefined;
+    onMouseenter?: ((event: MouseEvent) => any) | undefined;
+    onMouseleave?: ((event: MouseEvent) => any) | undefined;
     onPressEnter?: ((event: KeyboardEvent) => any) | undefined;
 }>, {
     bordered: boolean;
-    resize: "none" | "both" | "horizontal" | "vertical";
+    resize: "none" | "horizontal" | "vertical" | "both";
+    clearable: boolean;
     showCount: boolean | {
         formatter: (info: HysInputCountInfo) => string;
     };
     countPosition: "inside" | "outside";
     rows: number;
+    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/HysToast/HysToast.vue.d.ts

@@ -50,8 +50,8 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
     offset: number;
     closable: boolean;
     showIcon: boolean;
-    message: string;
     position: HysToastPosition;
+    message: string;
     zIndex: number;
     appendTo: string | HTMLElement;
     pauseOnHover: boolean;

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

@@ -33,8 +33,8 @@ declare const __VLS_base: import("vue").DefineComponent<HysTooltipProps, {
     modelValue: boolean;
     destroyOnHide: boolean;
     effect: "dark" | "light";
-    placement: import("../..").Placement;
     open: boolean;
+    placement: import("../..").Placement;
     appendTo: string | false | HTMLElement;
     showDelay: number;
     hideDelay: number;

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

@@ -1,30 +1,67 @@
-import type { HysPopupMotionProps } from '../../motion/popup';
-type __VLS_Props = HysPopupMotionProps & {
-    steps: {
-        title: string;
-        description: string;
-    }[];
-    current?: number;
-    closeOnEscape?: boolean;
+import type { HysTourContext, HysTourProps } from "../../composables/tour";
+type __VLS_Props = HysTourProps;
+type __VLS_Slots = {
+    /** 自定义引导说明，接收当前步骤与导航方法。 */
+    default?: (context: HysTourContext) => unknown;
+    header?: (context: HysTourContext) => unknown;
+    cover?: (context: HysTourContext) => unknown;
+    indicators?: (context: HysTourContext) => unknown;
+    footer?: (context: HysTourContext) => unknown;
+    "close-icon"?: (context: HysTourContext) => unknown;
 };
+declare function goTo(value: number): void;
+declare function start(value?: number): void;
+declare function close(): void;
+declare function previous(): void;
+declare function next(): void;
 type __VLS_ModelProps = {
     modelValue?: boolean;
 };
 type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
-declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {
+    start: typeof start;
+    close: typeof close;
+    goTo: typeof goTo;
+    previous: typeof previous;
+    next: typeof next;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     change: (index: number) => any;
     "update:modelValue": (value: boolean) => any;
     close: () => any;
     finish: () => any;
+    "update:open": (open: boolean) => any;
     "update:current": (index: number) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     onChange?: ((index: number) => any) | undefined;
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
     onClose?: (() => any) | undefined;
     onFinish?: (() => any) | undefined;
+    "onUpdate:open"?: ((open: boolean) => any) | undefined;
     "onUpdate:current"?: ((index: number) => any) | undefined;
 }>, {
+    showArrow: boolean;
+    mask: import("../../index.js").HysTourMask;
+    type: "default" | "primary";
+    open: boolean;
+    placement: import("../../index.js").Placement;
+    appendTo: string | false | HTMLElement;
+    arrow: boolean | {
+        pointAtCenter?: boolean;
+    };
     closeOnEscape: boolean;
+    showClose: boolean;
+    skipText: string;
+    prevText: string;
+    nextText: string;
+    finishText: string;
+    scrollIntoViewOptions: boolean | ScrollIntoViewOptions;
+    targetAreaClickable: 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/HysTreeSelect/HysTreeSelect.vue.d.ts

@@ -16,6 +16,7 @@ declare const __VLS_export: <V extends HysTreeSelectValue = string, N extends ob
             loadedKeys: HysTreeKey[];
         }) => any) | undefined;
         onScroll?: ((event: Event) => any) | undefined;
+        "onValue-change"?: ((value: V, info: HysTreeSelectChange<N>) => any) | undefined;
         "onUpdate:open"?: ((value: boolean) => any) | undefined;
         "onUpdate:searchValue"?: ((value: string) => any) | undefined;
         onDeselect?: ((key: HysTreeKey, node: N, info: unknown) => any) | undefined;
@@ -33,7 +34,6 @@ declare const __VLS_export: <V extends HysTreeSelectValue = string, N extends ob
             node: N;
             error: unknown;
         }) => any) | undefined;
-        "onValue-change"?: ((value: V, info: HysTreeSelectChange<N>) => any) | undefined;
         "onRemove-tag"?: ((key: HysTreeKey, node: N | undefined) => any) | undefined;
         "onSearch-complete"?: ((query: string) => any) | undefined;
         "onSearch-error"?: ((error: unknown, query: string) => any) | undefined;
@@ -101,13 +101,13 @@ declare const __VLS_export: <V extends HysTreeSelectValue = string, N extends ob
         node: N;
         children: readonly N[];
         loadedKeys: HysTreeKey[];
-    }) => void) & ((evt: "scroll", event: Event) => void) & ((evt: "update:open", value: boolean) => void) & ((evt: "update:searchValue", value: string) => void) & ((evt: "deselect", key: HysTreeKey, node: N, info: unknown) => void) & ((evt: "limit", limit: number) => void) & ((evt: "check", info: HysTreeCheckInfo<N>) => void) & ((evt: "update:expandedKeys", keys: HysTreeKey[]) => void) & ((evt: "node-expand", node: N, info: unknown) => void) & ((evt: "node-collapse", node: N, info: unknown) => void) & ((evt: "update:loadedKeys", keys: HysTreeKey[]) => void) & ((evt: "children-loaded", info: {
+    }) => void) & ((evt: "scroll", event: Event) => void) & ((evt: "value-change", value: V, info: HysTreeSelectChange<N>) => void) & ((evt: "update:open", value: boolean) => void) & ((evt: "update:searchValue", value: string) => void) & ((evt: "deselect", key: HysTreeKey, node: N, info: unknown) => void) & ((evt: "limit", limit: number) => void) & ((evt: "check", info: HysTreeCheckInfo<N>) => void) & ((evt: "update:expandedKeys", keys: HysTreeKey[]) => void) & ((evt: "node-expand", node: N, info: unknown) => void) & ((evt: "node-collapse", node: N, info: unknown) => void) & ((evt: "update:loadedKeys", keys: HysTreeKey[]) => void) & ((evt: "children-loaded", info: {
         node: N;
         children: readonly N[];
     }) => void) & ((evt: "load-error", info: {
         node: N;
         error: unknown;
-    }) => void) & ((evt: "value-change", value: V, info: HysTreeSelectChange<N>) => void) & ((evt: "remove-tag", key: HysTreeKey, node: N | undefined) => void) & ((evt: "search-complete", query: string) => void) & ((evt: "search-error", error: unknown, query: string) => void) & ((evt: "visible-change", value: boolean) => void);
+    }) => void) & ((evt: "remove-tag", key: HysTreeKey, node: N | undefined) => void) & ((evt: "search-complete", query: string) => void) & ((evt: "search-error", error: unknown, query: string) => void) & ((evt: "visible-change", value: boolean) => void);
 }>) => import("vue").VNode & {
     __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };

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

@@ -8,11 +8,11 @@ declare const __VLS_export: <T extends HysUploadItem = HysUploadFile>(__VLS_prop
         onSelect?: ((files: File[]) => any) | undefined;
         onSuccess?: ((response: unknown, file: T) => any) | undefined;
         onAbort?: ((file: T, reason: string) => any) | undefined;
+        onStart?: ((file: T) => any) | undefined;
         onDrop?: ((event: DragEvent) => any) | undefined;
         onError?: ((message: string) => any) | undefined;
         onInvalid?: ((info: HysUploadInvalid<T>) => any) | undefined;
         onPaste?: ((event: ClipboardEvent) => any) | undefined;
-        onStart?: ((file: T) => any) | undefined;
         onRemove?: ((file: T) => any) | undefined;
         onPreview?: ((file: T) => any) | undefined;
         onDownload?: ((file: T) => any) | undefined;
@@ -45,7 +45,7 @@ declare const __VLS_export: <T extends HysUploadItem = HysUploadFile>(__VLS_prop
     }>) => void;
     attrs: any;
     slots: HysUploadSlots<T>;
-    emit: ((evt: "change", files: T[]) => void) & ((evt: "update:modelValue", files: T[]) => void) & ((evt: "progress", percentage: number, file: T) => void) & ((evt: "select", files: File[]) => void) & ((evt: "success", response: unknown, file: T) => void) & ((evt: "abort", file: T, reason: string) => void) & ((evt: "drop", event: DragEvent) => void) & ((evt: "error", message: string) => void) & ((evt: "invalid", info: HysUploadInvalid<T>) => void) & ((evt: "paste", event: ClipboardEvent) => void) & ((evt: "start", file: T) => void) & ((evt: "remove", file: T) => void) & ((evt: "preview", file: T) => void) & ((evt: "download", file: T) => void) & ((evt: "update:fileList", files: T[]) => void) & ((evt: "fileChange", change: HysUploadChange<T>) => void) & ((evt: "uploadError", error: HysUploadError, file: T) => void) & ((evt: "exceed", files: File[]) => void) & ((evt: "removeError", error: Error, file: T) => void);
+    emit: ((evt: "change", files: T[]) => void) & ((evt: "update:modelValue", files: T[]) => void) & ((evt: "progress", percentage: number, file: T) => void) & ((evt: "select", files: File[]) => void) & ((evt: "success", response: unknown, file: T) => void) & ((evt: "abort", file: T, reason: string) => void) & ((evt: "start", file: T) => void) & ((evt: "drop", event: DragEvent) => void) & ((evt: "error", message: string) => void) & ((evt: "invalid", info: HysUploadInvalid<T>) => void) & ((evt: "paste", event: ClipboardEvent) => void) & ((evt: "remove", file: T) => void) & ((evt: "preview", file: T) => void) & ((evt: "download", file: T) => void) & ((evt: "update:fileList", files: T[]) => void) & ((evt: "fileChange", change: HysUploadChange<T>) => void) & ((evt: "uploadError", error: HysUploadError, file: T) => void) & ((evt: "exceed", files: File[]) => void) & ((evt: "removeError", error: Error, file: T) => void);
 }>) => import("vue").VNode & {
     __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };

package/dist/types/composables/animatedNumber.d.ts

@@ -0,0 +1,220 @@
+import type { StyleValue, VNodeChild } from "vue";
+import type { HysNumberAnimation, HysNumberAnimationPresets, HysNumberDigitAnimations } from "./numberAnimation";
+export type HysNumberValue = number | string;
+export type HysNumberDirection = "up" | "down" | "none";
+export type HysNumberStatus = "idle" | "delayed" | "playing" | "paused" | "stopped" | "finished";
+export type HysNumberEasing = "linear" | "ease-in" | "ease-out" | "ease-in-out" | "spring" | "bounce" | readonly [number, number, number, number] | ((progress: number) => number);
+export type HysNumberInterrupt = "retarget" | "restart" | "queue" | "snap";
+export type HysNumberTrigger = "mount" | "activate" | "update" | "manual" | "click" | "hover" | "visible";
+export type HysNumberEffect = "count" | "odometer" | "wheel" | "flip" | "slot" | "random" | "scramble" | "fade" | "scale" | "bounce" | "spring" | "slide" | "blur" | "appear" | "disappear" | "flash" | "highlight" | "gradient";
+export type HysNumberRounding = "half-up" | "half-even" | "floor" | "ceil" | "trunc";
+export type HysNumberFormat = "decimal" | "percent" | "currency" | "scientific";
+export interface HysNumberInterpolationContext {
+    from: HysNumberValue;
+    to: HysNumberValue;
+    progress: number;
+    easedProgress: number;
+    /** 内置插值计算的当前值，字符串模式保留十进制精度。 */
+    defaultValue: HysNumberValue;
+}
+export interface HysNumberAnimationOptions {
+    /** 目标值。十进制字符串可保留超出 Number 安全范围的精度。 */
+    value?: HysNumberValue;
+    /** 起始值。省略时首次直接显示目标值，后续从当前显示值过渡。 */
+    from?: HysNumberValue;
+    /** 单轮时长，单位毫秒。默认 650，非正数直接到达终点。 */
+    duration?: number;
+    /** 每次新播放的等待毫秒数，循环的后续轮次立即开始。 */
+    delay?: number;
+    /** 播放速度倍率，影响延迟与时长，默认 1。 */
+    speed?: number;
+    /** 缓动名称、四元组 [x1, y1, x2, y2] 或返回进度的函数。默认 ease-out。 */
+    easing?: HysNumberEasing;
+    /** 替换中间帧数值。接收起止值、原始进度、缓动进度和内置插值，首尾始终精确。 */
+    interpolate?: (context: HysNumberInterpolationContext) => HysNumberValue;
+    /** true 无限循环，正整数表示总轮数，默认 1。 */
+    loop?: boolean | number;
+    /** 循环轮次交替方向。 */
+    alternate?: boolean;
+    /** 更新策略。retarget 从当前帧衔接，restart 回到起点，queue 逐个播放，snap 立即显示。 */
+    interrupt?: HysNumberInterrupt;
+    /** queue 等待项上限，默认 32，范围 1–256。满时丢弃最旧的等待项。 */
+    queueLimit?: number;
+    /** retarget / restart 的最短更新时间间隔，单位毫秒。间隔内保留最新目标。 */
+    updateInterval?: number;
+    /** 最大采样帧率，范围 1–120，默认随浏览器刷新率采样。 */
+    fps?: number;
+    /** 直接显示目标值。全局动效关闭与系统减少动态效果也会立即完成。 */
+    disabled?: boolean;
+    /** 页面隐藏时冻结计时，可见时继续，默认 true。 */
+    pauseWhenHidden?: boolean;
+}
+export interface HysNumberFrame {
+    value: HysNumberValue;
+    from: HysNumberValue;
+    to: HysNumberValue;
+    progress: number;
+    easedProgress: number;
+    direction: HysNumberDirection;
+    status: HysNumberStatus;
+    iteration: number;
+}
+export interface HysNumberComposableOptions extends HysNumberAnimationOptions {
+    /** 指定是否在挂载时播放，省略时提供 from 即播放。 */
+    autoPlay?: boolean;
+    /** 监听 value 并应用更新策略，默认 true。 */
+    autoUpdate?: boolean;
+}
+export interface HysNumberTrend {
+    previous: HysNumberValue;
+    target: HysNumberValue;
+    direction: HysNumberDirection;
+    delta: string | null;
+    percent: string | null;
+    significant: boolean;
+}
+export type HysNumberEvent = "start" | "update" | "progress" | "pause" | "resume" | "end" | "cancel" | "loop";
+export interface HysNumberControls {
+    play: () => void;
+    pause: () => void;
+    resume: () => void;
+    stop: () => void;
+    restart: () => void;
+    reset: () => void;
+    reverse: () => void;
+    seek: (progress: number) => void;
+    finishAnimation: () => void;
+}
+export interface HysNumberUnitRule {
+    /** 按绝对值匹配的最小值，优先使用匹配规则中阈值最大的一项。 */
+    threshold: HysNumberValue;
+    /** 缩放除数，省略时使用 threshold。 */
+    divisor?: HysNumberValue;
+    label: string;
+}
+export interface HysNumberFormatOptions {
+    /** 小数位数的兼容属性，precision 优先。 */
+    decimals?: number;
+    /** 固定小数位数，范围 0–100。省略时普通字符串保留有效精度。 */
+    precision?: number;
+    /** 去掉末尾小数零及多余的小数点。 */
+    trimZeros?: boolean;
+    /** 整数最小位数，范围 1–21，不足时补零。 */
+    minimumIntegerDigits?: number;
+    /** 舍入规则，默认 half-up，恰好一半时远离零。 */
+    rounding?: HysNumberRounding;
+    /** 千分位符号。空字符串关闭分组，省略时由 grouping 和 locale 决定。 */
+    groupSeparator?: string;
+    /** 小数点符号。省略时使用地区格式或句点。 */
+    decimalSeparator?: string;
+    /** 是否按地区习惯分组。省略时指定 locale 才默认开启。 */
+    grouping?: boolean;
+    /** BCP 47 地区或语言标签，例如 zh-CN、de-DE、hi-IN、ar-EG。 */
+    locale?: string | string[];
+    /** decimal、percent、currency 或 scientific。默认 decimal。 */
+    numberFormat?: HysNumberFormat;
+    /** percent 的数据约定，ratio（默认）下 0.42 显示为 42%，points 下 42 显示为 42%。 */
+    percentInput?: "ratio" | "points";
+    /** ISO 4217 货币代码，例如 CNY、USD 或 EUR。默认 CNY。 */
+    currency?: string;
+    /** 替换地区格式生成的货币符号，保留符号位置。 */
+    currencySymbol?: string;
+    /** 使用 symbol、narrowSymbol 或 code 显示币种。默认 symbol。 */
+    currencyDisplay?: "symbol" | "narrowSymbol" | "code";
+    /** 自动单位。short 使用 K/M/B/T，zh 使用万/亿/万亿，也可传自定义规则数组。 */
+    compact?: "short" | "zh" | readonly HysNumberUnitRule[];
+    /** 在自动缩写单位之后附加文字。 */
+    unit?: string;
+    /** 正负号显示策略。默认 auto，仅显示负号。 */
+    signDisplay?: "auto" | "always" | "exceptZero" | "never";
+    /** 自定义正号。需设置 signDisplay="always" 或 "exceptZero"。 */
+    positiveSign?: string;
+    /** 自定义负号。 */
+    negativeSign?: string;
+}
+export interface HysAnimatedNumberContext extends HysNumberFrame {
+    displayValue: string;
+    unit: string;
+    remaining?: number;
+    trend: HysNumberTrend;
+}
+export interface HysNumberDigitContext extends HysAnimatedNumberContext {
+    digit: string;
+    index: number;
+    position: number;
+    section: "integer" | "fraction";
+    digitProgress: number;
+}
+export interface HysAnimatedNumberProps extends HysNumberAnimationOptions, HysNumberFormatOptions {
+    /** v-model 的目标值。与 value 同时传入时优先。 */
+    modelValue?: HysNumberValue;
+    /** 可组合的播放触发条件。默认 mount 和 update，manual 仅响应实例方法。 */
+    trigger?: HysNumberTrigger | readonly HysNumberTrigger[];
+    /** 自动和用户交互触发时的条件，可接收触发原因与最新目标值。 */
+    canPlay?: boolean | ((trigger: HysNumberTrigger, target: HysNumberValue) => boolean);
+    /** 进入视口触发时只播放一次，默认 true。 */
+    visibleOnce?: boolean;
+    /** 离开视口暂停并在重新进入时继续。 */
+    pauseOutside?: boolean;
+    /** 可视比例 0–1，默认 0.2。 */
+    visibilityThreshold?: number;
+    /** 数字动画效果，可传数组组合。默认 count。 */
+    effect?: HysNumberEffect | readonly HysNumberEffect[];
+    /** 统一效果入口。接受效果名、带参数的配置，或最多 8 层的配置数组，支持运行时切换。 */
+    animation?: HysNumberAnimation;
+    /** 用户预设表。预设可引用其他预设，循环引用自动跳过。 */
+    animationPresets?: HysNumberAnimationPresets;
+    /** animation 无法解析时使用的备用配置。 */
+    fallbackAnimation?: HysNumberAnimation;
+    /** 按位权覆盖效果。键为 integer:0（个位）、fraction:1（第一位小数）或 *（所有未指定数位）。 */
+    digitAnimations?: HysNumberDigitAnimations;
+    /** 全局效果强度 0–2，默认 1；0 仅保留数值变化。 */
+    motionIntensity?: number;
+    /** full 完整效果，simplified 仅计数，off 立即到达目标。遵循系统减少动效设置。 */
+    animationMotion?: "full" | "simplified" | "off";
+    /** 播放区间的差值达到 changeThreshold 时追加的效果，默认 highlight。 */
+    thresholdEffect?: HysNumberEffect | readonly HysNumberEffect[];
+    /** 滚轮与滑动方向，默认 vertical。 */
+    axis?: "vertical" | "horizontal";
+    /** 逐位启动间隔，单位毫秒。 */
+    stagger?: number;
+    /** 单位数字动效时长，单位毫秒。省略时使用剩余的播放时间。 */
+    digitDuration?: number;
+    /** high-to-low 从高位开始，low-to-high 从低位开始。 */
+    digitOrder?: "high-to-low" | "low-to-high";
+    /** 数值区域的自定义逐帧样式，可与内置效果组合。 */
+    animationStyle?: (context: HysAnimatedNumberContext) => StyleValue;
+    /** 为起点和终点文本预留宽度，并保留当前内容的自然宽度。 */
+    stableWidth?: boolean;
+    /** plain 常规数字、panel 逐位面板、display 大屏数字。默认 plain。 */
+    appearance?: "plain" | "panel" | "display";
+    /** 启用正负值的语义配色。 */
+    colorBySign?: boolean;
+    /** 按最近一次目标值增减配色，优先于 colorBySign。 */
+    colorByDirection?: boolean;
+    /** 差值绝对值达到此阈值时标记 significant 并触发 threshold 事件。 */
+    changeThreshold?: HysNumberValue;
+    /** 展示统计标题，title 插槽优先。 */
+    title?: string;
+    /** 数值前的文本，prefix 插槽优先。 */
+    prefix?: string;
+    /** 数值后的文本，suffix 插槽优先。 */
+    suffix?: string;
+    /** 应用到数值区域的 Vue 样式。 */
+    valueStyle?: StyleValue;
+    /** 接收当前值、格式文本、播放状态与趋势，可返回文字或 VNode。 */
+    formatter?: (context: HysAnimatedNumberContext) => VNodeChild;
+    /** 朗读结束值和倒计时结束值。默认静默更新。 */
+    announce?: boolean;
+    /** 启用截止时间倒计时，传 Unix 毫秒时间戳或 Date。 */
+    deadline?: number | Date;
+    /** 倒计时模板支持 D、DD、H、HH、m、mm、s、ss、SSS，字面文本使用方括号。 */
+    format?: string;
+}
+export interface HysAnimatedNumberInstance extends HysNumberControls {
+    displayValue: string;
+    remaining: number;
+    frame: HysNumberFrame;
+    trend: HysNumberTrend;
+    setValue: (target: HysNumberValue) => void;
+}

package/dist/types/composables/animatedNumberDigits.d.ts

@@ -0,0 +1,32 @@
+import type { HysNumberEffect } from "./animatedNumber";
+import type { NumberPresentation } from "./animatedNumberFormat";
+export declare const digitEffects: readonly HysNumberEffect[];
+type DigitSection = "integer" | "fraction";
+export declare function digitCount(parts: Intl.NumberFormatPart[]): number;
+export interface DigitToken {
+    key: string;
+    text: string;
+    type: Intl.NumberFormatPartTypes;
+    position: number;
+    section?: DigitSection;
+}
+export declare function numberTokens(parts: Intl.NumberFormatPart[], split: boolean): DigitToken[];
+export declare function createDigitTracks(start: NumberPresentation, end: NumberPresentation, glyphs: string[]): (token: DigitToken) => {
+    offset: number;
+    destination: number;
+    steps: number;
+    carry: {
+        start: number;
+        end: number;
+    } | undefined;
+    fromPresent: boolean;
+    toPresent: boolean;
+};
+export declare function digitMotion(effect: HysNumberEffect, track: ReturnType<ReturnType<typeof createDigitTracks>>, progress: number, index: number, glyphs: string[]): {
+    first: string;
+    second: string;
+    phase: number;
+    direction: number;
+    changed: boolean;
+};
+export {};

package/dist/types/composables/animatedNumberFormat.d.ts

@@ -0,0 +1,16 @@
+import type { HysNumberAnimationOptions, HysNumberDirection, HysNumberFormatOptions, HysNumberTrend, HysNumberValue } from "./animatedNumber";
+export declare function numberValue(value: HysNumberValue | undefined): HysNumberValue;
+export declare function bounded(value: number | undefined, fallback: number, min: number, max: number): number;
+export declare function numberDirection(from: HysNumberValue, to: HysNumberValue): HysNumberDirection;
+export declare function numberInterpolation(from: HysNumberValue, to: HysNumberValue): (progress: number) => HysNumberValue;
+export declare function createNumberInterpolator(from: HysNumberValue, to: HysNumberValue, custom: HysNumberAnimationOptions["interpolate"]): (_progress: number, easedProgress: number) => HysNumberValue;
+export declare function numberTrend(previous: HysNumberValue, target: HysNumberValue, threshold?: HysNumberValue): HysNumberTrend;
+export interface NumberPresentation {
+    text: string;
+    parts: Intl.NumberFormatPart[];
+    unit: string;
+}
+export declare function createNumberPresentation(options: HysNumberFormatOptions): {
+    format: (raw: HysNumberValue) => NumberPresentation;
+    localized: string[];
+};

package/dist/types/composables/animatedNumberTiming.d.ts

@@ -0,0 +1,21 @@
+import type { HysNumberEasing, HysNumberValue } from "./animatedNumber";
+import type { createNumberInterpolator } from "./animatedNumberFormat";
+type Tick = (now: number) => void;
+export declare function unsubscribe(tick: Tick): void;
+export declare function subscribe(tick: Tick): void;
+export declare function listenVisibility(update: () => void): void;
+export declare function unlistenVisibility(update: () => void): void;
+export declare function makeEasing(easing?: HysNumberEasing): (progress: number) => number;
+export interface Run {
+    from: HysNumberValue;
+    to: HysNumberValue;
+    interpolate: ReturnType<typeof createNumberInterpolator>;
+    easing: ReturnType<typeof makeEasing>;
+    duration: number;
+    elapsed: number;
+    iteration: number;
+    loops: number;
+    alternate: boolean;
+    started: boolean;
+}
+export {};

package/dist/types/composables/buttonGroup.d.ts

@@ -0,0 +1,9 @@
+import type { InjectionKey, Ref } from "vue";
+import type { HysButtonAppearance, HysButtonSize, HysButtonVariant } from "../components/HysButton/HysButton.vue";
+export declare function buttonSize(size: HysButtonSize | undefined): "sm" | "md" | "lg" | undefined;
+export declare function buttonVariant(type: HysButtonAppearance | "button" | "submit" | "reset" | undefined): HysButtonVariant | undefined;
+export declare const buttonGroupKey: InjectionKey<{
+    variant: Readonly<Ref<HysButtonVariant | undefined>>;
+    size: Readonly<Ref<"sm" | "md" | "lg" | undefined>>;
+    disabled: Readonly<Ref<boolean>>;
+}>;

package/dist/types/composables/drawer.d.ts

@@ -98,5 +98,5 @@ export declare const drawerSizes: {
     readonly xl: 960;
     readonly full: "100%";
 };
-export declare const drawerVertical: (placement?: HysDrawerPlacement) => placement is "top" | "bottom";
+export declare const drawerVertical: (placement?: HysDrawerPlacement) => placement is "bottom" | "top";
 export declare function drawerSize(props: HysDrawerProps): string | number;

package/dist/types/composables/floatingPosition.d.ts

@@ -0,0 +1,14 @@
+import type { Placement } from "./useFloating";
+export declare function positionFloating(anchor: DOMRect, size: {
+    width: number;
+    height: number;
+}, viewport: {
+    width: number;
+    height: number;
+}, placement: Placement, gap: number, padding: number, flip: boolean): {
+    width: number;
+    height: number;
+    x: number;
+    y: number;
+    placement: Placement;
+};