hys-ui 0.3.0 → 0.4.0

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

@@ -1,32 +1,70 @@
-type __VLS_Props = {
-    modelValue: string;
+import { type InputHTMLAttributes, type VNodeChild } from "vue";
+export interface HysSearchProps {
+    modelValue?: string;
+    defaultValue?: string;
     placeholder?: string;
+    /** 输入触发模式的等待时间，单位为毫秒。 */
     delay?: number;
+    /** 输入时防抖搜索，或只在确认时搜索。 */
+    trigger?: "input" | "submit";
+    /** 显示搜索按钮，可传按钮文案。 */
+    enterButton?: boolean | string;
+    /** 清空后立即搜索。省略时跟随触发模式。 */
+    searchOnClear?: boolean;
     disabled?: boolean;
     readonly?: boolean;
     clearable?: boolean;
     loading?: boolean;
     ariaLabel?: string;
+    searchLabel?: string;
+    size?: "sm" | "md" | "lg";
+    inputProps?: InputHTMLAttributes;
+}
+export interface HysSearchButtonContext {
+    search: (event?: Event) => void;
+    disabled: boolean;
+    loading: boolean;
+}
+type __VLS_Slots = {
+    prefix?: () => VNodeChild;
+    suffix?: () => VNodeChild;
+    "clear-icon"?: () => VNodeChild;
+    "search-button"?: (context: HysSearchButtonContext) => VNodeChild;
 };
-declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
-    focus: () => void | undefined;
+declare function submit(event?: Event): void;
+declare const __VLS_base: import("vue").DefineComponent<HysSearchProps, {
+    input: import("vue").Ref<HTMLInputElement | undefined, HTMLInputElement | undefined>;
+    search: typeof submit;
+    clear: () => Promise<void>;
+    focus: (options?: FocusOptions) => void | undefined;
     blur: () => void | undefined;
+    select: () => void | undefined;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: string) => any;
-    search: (value: string) => any;
+    search: (value: string, event?: Event | undefined) => any;
     clear: () => any;
     blur: (event: FocusEvent) => any;
     focus: (event: FocusEvent) => any;
-}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+}, string, import("vue").PublicProps, Readonly<HysSearchProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: string) => any) | undefined;
-    onSearch?: ((value: string) => any) | undefined;
+    onSearch?: ((value: string, event?: Event | undefined) => any) | undefined;
     onClear?: (() => any) | undefined;
     onBlur?: ((event: FocusEvent) => any) | undefined;
     onFocus?: ((event: FocusEvent) => any) | undefined;
 }>, {
+    trigger: "input" | "submit";
     placeholder: string;
+    defaultValue: string;
     clearable: boolean;
     delay: number;
+    searchOnClear: boolean;
+    searchLabel: string;
 }, {}, {}, {}, 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/HysSelect/HysSelect.vue.d.ts

@@ -21,7 +21,10 @@ declare const __VLS_export: <T extends HysSelectModelValue = string>(__VLS_props
         filterable?: boolean;
         clearable?: boolean;
         emptyValues?: readonly unknown[];
-        clearValue?: HysSelectValue | null;
+        /** 单选清空后的值，也可由函数计算。 */
+        clearValue?: HysSelectValue | null | (() => HysSelectValue | null);
+        /** 模型以 { value, label } 保存选中项，可在远程选项尚未加载时回显。 */
+        labelInValue?: boolean;
         fallbackOption?: false | ((value: HysSelectValue) => HysSelectOption);
         multipleLimit?: number;
         maxTagCount?: number;
@@ -44,6 +47,8 @@ declare const __VLS_export: <T extends HysSelectModelValue = string>(__VLS_props
         showOnFocus?: boolean;
         retainSearch?: boolean;
         defaultActiveFirst?: boolean;
+        /** 无已选项时优先高亮的可选值。 */
+        firstActiveValue?: HysSelectValue;
         keyboard?: boolean;
         popupMatchWidth?: boolean;
         popupWidth?: number | string;

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

@@ -1,33 +1,144 @@
-type __VLS_Props = {
+export type HysSplitPaneSide = "first" | "second";
+export type HysSplitPaneLength = number | `${number}px` | `${number}%`;
+export interface HysSplitPanePanelOptions {
+    /** Panel minimum size. Numbers are pixels; strings accept px and %. */
+    min?: HysSplitPaneLength;
+    /** Panel maximum size. Numbers are pixels; strings accept px and %. */
+    max?: HysSplitPaneLength;
+    resizable?: boolean;
+    collapsible?: boolean;
+}
+export interface HysSplitPanePanel extends HysSplitPanePanelOptions {
+    id: string;
+    label?: string;
+    /** 初始尺寸。省略时自动分配剩余空间。 */
+    size?: HysSplitPaneLength;
+}
+export type HysSplitPaneSizes = Readonly<Record<string, HysSplitPaneLength | undefined>>;
+export interface HysSplitPanePanelResize {
+    separator: number;
+    before: string;
+    after: string;
+    /** 每个面板当前或预览的像素尺寸。 */
+    sizes: Record<string, number>;
+}
+export interface HysSplitPanePanelResizeEnd extends HysSplitPanePanelResize {
+    cancelled: boolean;
+}
+export interface HysSplitPaneHandleContext {
+    separator: number;
+    before: string;
+    after: string;
+    vertical: boolean;
+    disabled: boolean;
+    resizing: boolean;
+}
+export interface HysSplitPaneProps {
+    /** 第一块面板占可用空间的百分比，支持 v-model。 */
     modelValue?: number;
+    /** 非受控初始比例，数字为百分比。 */
+    defaultValue?: number;
+    /** 兼容比例下限，firstPanel.min 优先。 */
     min?: number;
+    /** 兼容比例上限，firstPanel.max 优先。 */
     max?: number;
     vertical?: boolean;
+    /** 布局方向，指定时优先于 vertical。 */
+    layout?: "horizontal" | "vertical";
     disabled?: boolean;
+    /** 键盘调整的百分比步长。 */
     step?: number;
+    /** 拖动时移动预览线，释放后才提交 v-model。 */
+    lazy?: boolean;
+    firstPanel?: HysSplitPanePanelOptions;
+    secondPanel?: HysSplitPanePanelOptions;
+    /** 按顺序渲染的面板配置，每项以唯一 id 标识。 */
+    panels?: readonly HysSplitPanePanel[];
+    /** 多面板受控尺寸，支持 v-model:sizes。 */
+    sizes?: HysSplitPaneSizes;
+    /** 以浏览器本地存储记住非受控布局。 */
+    storageKey?: string;
+    /** 分隔条实际占用的宽度或高度，单位为像素。 */
+    dividerSize?: number;
+    /** 双击分隔条时折叠相邻面板、重置尺寸或保持原状。 */
+    doubleClickAction?: "none" | "collapse" | "reset";
+    ariaLabel?: string;
+    firstLabel?: string;
+    secondLabel?: string;
+}
+export interface HysSplitPaneSlotContext {
+    collapsed: boolean;
+    toggle: () => Promise<boolean>;
+}
+export interface HysSplitPanePanelContext extends HysSplitPaneSlotContext {
+    panel: HysSplitPanePanel;
+    index: number;
+    size: number;
+}
+export interface HysSplitPaneResizeEnd {
+    cancelled: boolean;
+}
+export interface HysSplitPaneInstance {
+    togglePanel: (side: HysSplitPaneSide) => Promise<boolean>;
+    togglePane: (id: string, separator?: number) => Promise<boolean>;
+    resizePane: (id: string, value: HysSplitPaneLength, separator?: number) => Promise<boolean>;
+    getPanelSizes: () => Record<string, number>;
+    getPaneElement: (id: string) => HTMLElement | undefined;
+    resetSizes: () => Promise<boolean>;
+}
+type __VLS_Slots = {
+    first?: (context: HysSplitPaneSlotContext) => unknown;
+    second?: (context: HysSplitPaneSlotContext) => unknown;
+    "first-collapse"?: (context: HysSplitPaneSlotContext) => unknown;
+    "second-collapse"?: (context: HysSplitPaneSlotContext) => unknown;
+    panel?: (context: HysSplitPanePanelContext) => unknown;
+    "panel-collapse"?: (context: HysSplitPanePanelContext & {
+        side: "start" | "end";
+    }) => unknown;
+    /** 自定义抓手图标。分隔条保留键盘和指针行为。 */
+    handle?: (context: HysSplitPaneHandleContext) => unknown;
 };
-declare const __VLS_template: () => {
-    __VLS_Slots: {
-        first?: (props: {}) => any;
-    } & {
-        second?: (props: {}) => any;
+declare function togglePanel(side: HysSplitPaneSide): Promise<boolean>;
+declare function resetSizes(): Promise<boolean>;
+declare const __VLS_base: import("vue").DefineComponent<HysSplitPaneProps, {
+    togglePanel: typeof togglePanel;
+    togglePane: (id: string, separator?: number) => Promise<boolean>;
+    getPanelSizes: () => {
+        [k: string]: number;
     };
-};
-type __VLS_Slots = ReturnType<typeof __VLS_template>['__VLS_Slots'];
-declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    getPaneElement: (id: string) => HTMLElement | undefined;
+    resizePane: (id: string, value: HysSplitPaneLength, separator?: number) => Promise<boolean>;
+    resetSizes: typeof resetSizes;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: number) => any;
-    resizeEnd: (value: number) => any;
+    collapse: (side: HysSplitPaneSide, collapsed: boolean) => any;
+    resize: (value: number) => any;
+    resizeEnd: (value: number, details: HysSplitPaneResizeEnd) => any;
     resizeStart: () => any;
-}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "update:sizes": (sizes: Readonly<Record<string, HysSplitPaneLength | undefined>>) => any;
+    panelResizeStart: (details: HysSplitPanePanelResize) => any;
+    panelResize: (details: HysSplitPanePanelResize) => any;
+    panelResizeEnd: (details: HysSplitPanePanelResizeEnd) => any;
+    panelCollapse: (id: string, collapsed: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<HysSplitPaneProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: number) => any) | undefined;
-    onResizeEnd?: ((value: number) => any) | undefined;
+    onCollapse?: ((side: HysSplitPaneSide, collapsed: boolean) => any) | undefined;
+    onResize?: ((value: number) => any) | undefined;
+    onResizeEnd?: ((value: number, details: HysSplitPaneResizeEnd) => any) | undefined;
     onResizeStart?: (() => any) | undefined;
+    "onUpdate:sizes"?: ((sizes: Readonly<Record<string, HysSplitPaneLength | undefined>>) => any) | undefined;
+    onPanelResizeStart?: ((details: HysSplitPanePanelResize) => any) | undefined;
+    onPanelResize?: ((details: HysSplitPanePanelResize) => any) | undefined;
+    onPanelResizeEnd?: ((details: HysSplitPanePanelResizeEnd) => any) | undefined;
+    onPanelCollapse?: ((id: string, collapsed: boolean) => any) | undefined;
 }>, {
-    modelValue: number;
     max: number;
     min: number;
-    vertical: boolean;
+    ariaLabel: string;
     step: number;
+    defaultValue: number;
+    firstLabel: string;
+    secondLabel: string;
 }, {}, {}, {}, 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/HysSteps/HysSteps.vue.d.ts

@@ -62,9 +62,9 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
 }>, {
     size: "sm" | "md";
     status: HysStepStatus;
+    responsive: boolean;
     current: number;
     labelPlacement: "right" | "bottom";
-    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;