hys-ui 0.3.0 → 0.5.0

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

@@ -1,5 +1,5 @@
 import type { HysPopupTransition } from '../motion/popup';
-import type { CSSProperties, HTMLAttributes, VNodeChild } from "vue";
+import type { Component, CSSProperties, HTMLAttributes, VNodeChild } from "vue";
 import type { Placement } from "./useFloating";
 export type HysTableKey = string | number;
 export type HysTableDirection = "asc" | "desc";
@@ -20,6 +20,22 @@ export interface HysTableSelectionColumn {
     fixed?: boolean | "left" | "right";
     align?: "left" | "center" | "right";
 }
+export interface HysTableRowSelectionOptions {
+    range?: boolean;
+    /** 只允许指定行绕过行级选择限制。 */
+    ignoreSelectable?: boolean;
+}
+export interface HysTableSelectionAction<T extends object = Record<string, unknown>> {
+    key: string;
+    label: string;
+    disabled?: boolean;
+    select: (context: {
+        rows: readonly T[];
+        keys: readonly HysTableKey[];
+        selectedKeys: readonly HysTableKey[];
+        setSelected: (keys: readonly HysTableKey[]) => Promise<boolean>;
+    }) => void | Promise<void>;
+}
 export interface HysTableFilterConfirmOptions {
     closeDropdown?: boolean;
 }
@@ -30,12 +46,26 @@ export interface HysTableScrollRowOptions {
     behavior?: ScrollBehavior;
     block?: "start" | "center" | "end" | "nearest";
 }
+export interface HysTableStickyOptions {
+    offsetHeader?: number;
+    offsetScroll?: number;
+    getContainer?: () => HTMLElement | Window | null | undefined;
+}
 export interface HysTableFilter {
     label: string;
     value: HysTableFilterValue;
     disabled?: boolean;
     children?: readonly HysTableFilter[];
 }
+export interface HysTableFilterDropdownContext<T extends object = Record<string, unknown>> {
+    column: HysTableColumn<T>;
+    open: boolean;
+    values: readonly HysTableFilterValue[];
+    setValues: (values: readonly HysTableFilterValue[]) => void;
+    confirm: (options?: HysTableFilterConfirmOptions) => void;
+    clear: (options?: HysTableFilterResetOptions) => void;
+    close: () => void;
+}
 export type HysTableElementAttrs = HTMLAttributes & Record<string, unknown>;
 export type HysTablePaginationPosition = "top-left" | "top-center" | "top-right" | "bottom-left" | "bottom-center" | "bottom-right";
 export interface HysTableCellContext<T extends object = Record<string, unknown>> {
@@ -45,6 +75,28 @@ export interface HysTableCellContext<T extends object = Record<string, unknown>>
     rowIndex: number;
     columnIndex: number;
 }
+export interface HysTableOverflowTooltipOptions {
+    placement?: Placement;
+    effect?: "light" | "dark";
+    maxWidth?: number | string;
+    offset?: number;
+    hideDelay?: number;
+    enterable?: boolean;
+}
+export interface HysTableComponents {
+    table?: Component;
+    header?: {
+        wrapper?: Component;
+        row?: Component;
+        cell?: Component;
+    };
+    body?: {
+        wrapper?: Component;
+        row?: Component;
+        cell?: Component;
+        rowHeaderCell?: Component;
+    };
+}
 export interface HysTableColumn<T extends object = any> {
     key: string;
     label: string;
@@ -57,11 +109,18 @@ export interface HysTableColumn<T extends object = any> {
     fixed?: boolean | "left" | "right";
     align?: "left" | "center" | "right";
     headerAlign?: "left" | "center" | "right";
+    /** 合并同一层、同一固定区域内相邻的叶列表头。0 隐藏标题。 */
+    headerColSpan?: number;
+    /** 表头插槽未提供内容时渲染列标题。 */
+    renderHeader?: (column: HysTableColumn<T>, sorts: readonly HysTableSort[]) => VNodeChild;
     sortable?: boolean | "custom";
     sorter?: (a: T, b: T) => number;
     sortBy?: string | ((row: T) => unknown) | readonly (string | ((row: T) => unknown))[];
     sortOrders?: readonly (HysTableDirection | null)[];
     defaultSortOrder?: HysTableDirection;
+    /** 受控排序方向，null 清除该列排序。表格级 sort 和 sorts 优先。 */
+    sortOrder?: HysTableDirection | null;
+    showSorterTooltip?: boolean | HysTableOverflowTooltipOptions;
     sortPriority?: number;
     filters?: readonly HysTableFilter[];
     filterable?: boolean;
@@ -69,11 +128,25 @@ export interface HysTableColumn<T extends object = any> {
     filterMode?: "menu" | "tree";
     filterSearch?: boolean | ((query: string, option: HysTableFilter) => boolean);
     defaultFilterValue?: readonly HysTableFilterValue[];
+    /** 受控筛选值，空数组清除该列筛选。表格级 filters 优先。 */
+    filteredValue?: readonly HysTableFilterValue[];
+    filtered?: boolean;
+    filterDropdownOpen?: boolean;
+    onFilterDropdownOpenChange?: (open: boolean) => void;
+    filterPlacement?: Placement;
+    renderFilterIcon?: (context: {
+        column: HysTableColumn<T>;
+        filtered: boolean;
+        open: boolean;
+    }) => VNodeChild;
+    renderFilterDropdown?: (context: HysTableFilterDropdownContext<T>) => VNodeChild;
     filterResetToDefault?: boolean;
     filterMethod?: (value: HysTableFilterValue, row: T, column: HysTableColumn<T>) => boolean;
     formatter?: (row: T, column: HysTableColumn<T>, value: unknown, index: number) => VNodeChild;
-    ellipsis?: boolean;
-    showOverflowTooltip?: boolean;
+    ellipsis?: boolean | {
+        showTitle?: boolean;
+    };
+    showOverflowTooltip?: boolean | HysTableOverflowTooltipOptions;
     tooltipFormatter?: (context: HysTableCellContext<T>) => VNodeChild;
     className?: string;
     headerClassName?: string;
@@ -91,12 +164,20 @@ export interface HysTablePagination {
     position?: readonly HysTablePaginationPosition[];
     page?: number;
     pageSize?: number;
+    defaultPage?: number;
+    defaultPageSize?: number;
     total?: number;
+    /** 服务端分页的总页数，可在总记录数未知时使用。 */
+    pageCount?: number;
     pageSizeOptions?: number[];
     showSizeChanger?: boolean;
     showQuickJumper?: boolean;
     showTotal?: boolean;
     compact?: boolean;
+    layout?: string;
+    size?: "sm" | "md" | "lg";
+    responsive?: boolean;
+    siblingCount?: number;
     hideOnSinglePage?: boolean;
 }
 export interface HysTableQuery<T extends object = Record<string, unknown>> {
@@ -131,6 +212,8 @@ export interface HysTableLocale {
     resizeColumn: string;
     sortAsc: string;
     sortDesc: string;
+    sortClear?: string;
+    stickyScrollLabel?: string;
     filterSearch?: string;
     noFilterMatch?: string;
     invertSelection?: string;
@@ -141,6 +224,9 @@ export interface HysTableLocale {
         perPage: string;
         jump: string;
         page: string;
+        pageItem: string;
+        navigation: string;
+        confirm: string;
         first: string;
         previous: string;
         next: string;
@@ -153,9 +239,13 @@ export interface HysTableProps<T extends object> {
     locale?: Partial<HysTableLocale>;
     columns: readonly HysTableColumn<T>[];
     rows: readonly T[];
+    /** 替换表格的结构组件。自定义组件需转发属性与默认插槽，并保留原生表格元素。 */
+    components?: HysTableComponents;
     rowKey?: string | ((row: T) => HysTableKey);
     emptyText?: string;
     loading?: boolean;
+    /** replace 用加载行替换数据，overlay 保留当前行并覆盖加载提示。 */
+    loadingMode?: "replace" | "overlay";
     disabled?: boolean;
     striped?: boolean;
     bordered?: boolean;
@@ -165,9 +255,15 @@ export interface HysTableProps<T extends object> {
     height?: number | string;
     maxHeight?: number | string;
     stickyHeader?: boolean;
+    /** 随页面或自定义容器滚动固定表头和水平滚动条。 */
+    sticky?: boolean | HysTableStickyOptions;
     showHeader?: boolean;
     fit?: boolean;
+    /** 表格横向最小宽度，用于控制滚动区域内的列布局。 */
+    scrollWidth?: number | string;
     scrollbarAlwaysOn?: boolean;
+    /** 使用浏览器默认的滚动条样式。 */
+    nativeScrollbar?: boolean;
     scrollbarTabindex?: number | string;
     headerRowClassName?: string | ((columns: readonly HysTableColumn<T>[], level: number) => string);
     headerRowStyle?: CSSProperties | ((columns: readonly HysTableColumn<T>[], level: number) => CSSProperties);
@@ -188,7 +284,7 @@ export interface HysTableProps<T extends object> {
     reserveSelection?: boolean;
     checkStrictly?: boolean;
     selectOnIndeterminate?: boolean;
-    selectionActions?: boolean;
+    selectionActions?: boolean | readonly HysTableSelectionAction<T>[];
     rangeSelection?: boolean;
     hideSelectAll?: boolean;
     selectionColumn?: HysTableSelectionColumn;
@@ -203,11 +299,15 @@ export interface HysTableProps<T extends object> {
     defaultSort?: HysTableSort | readonly HysTableSort[] | null;
     multiSort?: boolean;
     sortOrders?: readonly (HysTableDirection | null)[];
+    /** 悬停或聚焦列标题时提示下一次排序操作。 */
+    showSorterTooltip?: boolean | HysTableOverflowTooltipOptions;
     filters?: HysTableFilters;
     defaultFilters?: HysTableFilters;
     filterColumnKey?: string | null;
     filterPlacement?: Placement;
     appendFilterTo?: string | HTMLElement | false;
+    /** 根据触发元素指定排序、溢出与筛选浮层的挂载目标。 */
+    getPopupContainer?: (trigger: HTMLElement) => HTMLElement | string | false | undefined;
     pagination?: boolean | HysTablePagination;
     page?: number;
     pageSize?: number;
@@ -230,6 +330,10 @@ export interface HysTableProps<T extends object> {
     indent?: number;
     loadChildren?: (row: T, context: HysTableLoadContext) => readonly T[] | Promise<readonly T[]>;
     showSummary?: boolean;
+    /** 汇总全部筛选结果，或仅汇总当前页实际显示的行。 */
+    summaryScope?: "filtered" | "page";
+    /** 将汇总行固定在表格滚动区域底部。 */
+    stickySummary?: boolean;
     sumText?: string;
     summaryMethod?: (context: {
         columns: readonly HysTableColumn<T>[];
@@ -239,8 +343,13 @@ export interface HysTableProps<T extends object> {
         rowspan?: number;
         colspan?: number;
     } | readonly [number, number] | undefined;
-    showOverflowTooltip?: boolean;
+    /** 默认溢出提示，列可覆盖配置或设置 false 关闭。 */
+    showOverflowTooltip?: boolean | HysTableOverflowTooltipOptions;
     tooltipFormatter?: (context: HysTableCellContext<T>) => VNodeChild;
+    /** 在列格式化后统一处理默认单元格内容。 */
+    transformCellText?: (context: HysTableCellContext<T> & {
+        text: VNodeChild;
+    }) => VNodeChild;
     resizable?: boolean;
     columnWidths?: Readonly<Record<string, number>>;
     allowDragLastColumn?: boolean;
@@ -256,7 +365,7 @@ export interface HysTableInstance<T extends object = Record<string, unknown>> {
     clearSelection: () => Promise<boolean>;
     getSelectionRows: () => T[];
     getHalfSelectionRows: () => T[];
-    toggleRowSelection: (row: T | HysTableKey, selected?: boolean, range?: boolean) => Promise<boolean>;
+    toggleRowSelection: (row: T | HysTableKey, selected?: boolean, options?: boolean | HysTableRowSelectionOptions) => Promise<boolean>;
     toggleAllSelection: (selected?: boolean) => Promise<boolean>;
     invertSelection: () => Promise<boolean>;
     setCurrentRow: (row?: T | HysTableKey | null) => Promise<boolean>;
@@ -295,6 +404,7 @@ export interface TableHeader<T extends object> {
     leaves: HysTableColumn<T>[];
     colspan: number;
     rowspan: number;
+    blank?: boolean;
     fixed?: "left" | "right";
 }
 export declare const tableToken: (key: HysTableKey) => string;

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

@@ -1,4 +1,4 @@
-import type { Component, InputHTMLAttributes, TextareaHTMLAttributes } from "vue";
+import type { Component, InputHTMLAttributes, StyleValue, TextareaHTMLAttributes } from "vue";
 export interface HysInputFormatInfo {
     userTyping: boolean;
     input: string;
@@ -9,8 +9,20 @@ export interface HysInputCountInfo {
     maxLength?: number;
 }
 export type HysInputCountStrategy = boolean | ((value: string) => number);
+export type HysInputSize = "sm" | "md" | "lg" | "small" | "middle" | "default" | "large";
+export interface HysInputModelModifiers {
+    lazy?: boolean;
+    trim?: boolean;
+    number?: boolean;
+}
+export interface HysTextareaStyle {
+    height?: string;
+    overflowY?: "auto" | "hidden";
+}
 export interface HysInputProps {
     modelValue?: string | number | null;
+    /** Vue v-model 修饰符。lazy 延后写入模型，trim 去首尾空白，number 由 Vue 转换数值。 */
+    modelModifiers?: HysInputModelModifiers;
     defaultValue?: string | number | null;
     placeholder?: string;
     type?: string;
@@ -21,6 +33,12 @@ export interface HysInputProps {
     error?: string;
     status?: "error" | "warning" | "success";
     clearable?: boolean;
+    /** 清空开关别名，clearable 显式设置时优先。 */
+    allowClear?: boolean;
+    /** 输入框外侧的附加文字，prepend 插槽优先。 */
+    addonBefore?: string;
+    /** 输入框外侧的附加文字，append 插槽优先。 */
+    addonAfter?: string;
     clearIcon?: Component;
     prefixIcon?: Component;
     suffixIcon?: Component;
@@ -42,7 +60,7 @@ export interface HysInputProps {
     allowInput?: (value: string) => boolean;
     autocomplete?: string;
     name?: string;
-    size?: "sm" | "md" | "lg";
+    size?: HysInputSize;
     rows?: number;
     autosize?: boolean | {
         minRows?: number;
@@ -50,27 +68,44 @@ export interface HysInputProps {
     };
     resize?: "none" | "both" | "horizontal" | "vertical";
     inputProps?: InputHTMLAttributes | TextareaHTMLAttributes;
+    /** 应用到原生输入元素的样式。自动高度启用时由组件管理 height 和 overflowY。 */
+    inputStyle?: StyleValue;
+    /** 原生 inputmode，用于提示移动端键盘布局。 */
+    inputmode?: InputHTMLAttributes["inputmode"];
+    /** 原生控件的 Tab 顺序。 */
+    tabindex?: string | number;
+    /** 关联的原生 form 元素 ID，可提交在表单外的输入。 */
+    form?: string;
+    /** 是否由组件交互触发表单的 change、blur 校验，默认 true。 */
+    validateEvent?: boolean;
     autofocus?: boolean;
     selectOnFocus?: boolean;
     bordered?: boolean;
     round?: boolean;
 }
 export interface HysInputInstance {
+    element: HTMLInputElement | HTMLTextAreaElement | undefined;
     input: HTMLInputElement | HTMLTextAreaElement | undefined;
     textarea: HTMLTextAreaElement | undefined;
     isComposing: boolean;
+    passwordVisible: boolean;
+    textareaStyle: HysTextareaStyle;
     focus: (options?: FocusOptions) => void;
     blur: () => void;
     select: () => void;
     clear: () => void;
     resize: () => Promise<void>;
+    resizeTextarea: () => Promise<void>;
     setSelectionRange: (start: number, end: number, direction?: "forward" | "backward" | "none") => void;
     scrollTo: (options: ScrollToOptions) => void;
 }
-export type HysTextareaProps = Omit<HysInputProps, 'type' | 'showPassword' | 'showPasswordOn' | 'passwordVisible' | 'defaultPasswordVisible'>;
-export interface HysTextareaInstance extends Omit<HysInputInstance, 'input'> {
+export type HysTextareaProps = Omit<HysInputProps, "type" | "showPassword" | "showPasswordOn" | "passwordVisible" | "defaultPasswordVisible">;
+export interface HysTextareaInstance extends Omit<HysInputInstance, "input" | "element" | "passwordVisible"> {
     input: HTMLTextAreaElement | undefined;
+    element: HTMLTextAreaElement | undefined;
 }
+export declare function textInputSize(size?: HysInputSize): "sm" | "md" | "lg" | undefined;
+export declare function modelText(value: string, modifiers?: HysInputModelModifiers): string;
 export declare function textCount(value: string, strategy?: HysInputCountStrategy): number;
 export declare function textLimit(value: string, max: number | undefined, strategy?: HysInputCountStrategy): string;
 export declare function textLengthLimit(value?: string | number): number | undefined;

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

@@ -0,0 +1,68 @@
+import type { Component, CSSProperties, VNode } from "vue";
+import type { HysButtonProps } from "../components/HysButton/HysButton.vue";
+import type { HysPopupMotionProps } from "../motion/popup";
+import type { Placement } from "./useFloating";
+export type HysTourTarget = string | HTMLElement | (() => HTMLElement | null | undefined);
+export type HysTourContent = string | VNode | (() => string | VNode);
+export type HysTourMask = boolean | {
+    color?: string;
+    style?: CSSProperties;
+};
+export interface HysTourGap {
+    /** Pixels around the target, either uniform or [horizontal, vertical]. */
+    offset?: number | [number, number];
+    radius?: number;
+}
+export interface HysTourButtonProps extends HysButtonProps {
+    children?: HysTourContent;
+    onClick?: (event: MouseEvent) => void;
+}
+export interface HysTourAppearance {
+    /** Preferred card placement; flips to the opposite side when space is limited. */
+    placement?: Placement;
+    mask?: HysTourMask;
+    gap?: HysTourGap;
+    showArrow?: boolean;
+    arrow?: boolean | {
+        pointAtCenter?: boolean;
+    };
+    type?: "default" | "primary";
+    contentStyle?: CSSProperties;
+    scrollIntoViewOptions?: boolean | ScrollIntoViewOptions;
+    targetAreaClickable?: boolean;
+    showClose?: boolean;
+    closeIcon?: string | Component;
+    prevButtonProps?: HysTourButtonProps;
+    nextButtonProps?: HysTourButtonProps;
+}
+export interface HysTourStep extends HysTourAppearance {
+    /** An element, CSS selector, or function returning the element. */
+    target?: HysTourTarget;
+    title?: HysTourContent;
+    description?: HysTourContent;
+    cover?: HysTourContent;
+    onClose?: () => void;
+}
+export interface HysTourProps extends HysPopupMotionProps, HysTourAppearance {
+    steps: readonly HysTourStep[];
+    /** Display state alias for v-model:open. */
+    open?: boolean;
+    /** Zero-based step index; supports v-model:current and external navigation. */
+    current?: number;
+    closeOnEscape?: boolean;
+    appendTo?: string | HTMLElement | false;
+    zIndex?: number;
+    skipText?: string;
+    prevText?: string;
+    nextText?: string;
+    finishText?: string;
+}
+export interface HysTourContext {
+    step: HysTourStep | undefined;
+    current: number;
+    total: number;
+    goTo: (index: number) => void;
+    previous: () => void;
+    next: () => void;
+    close: () => void;
+}

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

@@ -15,7 +15,7 @@ export interface FloatingAnchor {
     readonly isConnected: boolean;
 }
 export declare function useFloating(anchor: Readonly<Ref<FloatingAnchor | undefined>>, panel: Ref<HTMLElement | undefined>, options?: {
-    placement?: Placement;
+    placement?: Placement | (() => Placement);
     gap?: number;
     padding?: number;
     matchWidth?: boolean | "min" | (() => boolean | "min");

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

@@ -0,0 +1,37 @@
+import { type MaybeRefOrGetter } from "vue";
+import type { HysNumberComposableOptions, HysNumberEvent, HysNumberFrame, HysNumberValue } from "./animatedNumber";
+/** 在 Vue setup 中使用。与 HysAnimatedNumber 共享调度和播放控制。 */
+export declare function useHysAnimatedNumber(source?: MaybeRefOrGetter<HysNumberComposableOptions>, onEvent?: (event: HysNumberEvent, frame: HysNumberFrame) => void): {
+    frame: Readonly<import("vue").Ref<{
+        readonly value: HysNumberValue;
+        readonly from: HysNumberValue;
+        readonly to: HysNumberValue;
+        readonly progress: number;
+        readonly easedProgress: number;
+        readonly direction: import("./animatedNumber").HysNumberDirection;
+        readonly status: import("./animatedNumber").HysNumberStatus;
+        readonly iteration: number;
+    }, {
+        readonly value: HysNumberValue;
+        readonly from: HysNumberValue;
+        readonly to: HysNumberValue;
+        readonly progress: number;
+        readonly easedProgress: number;
+        readonly direction: import("./animatedNumber").HysNumberDirection;
+        readonly status: import("./animatedNumber").HysNumberStatus;
+        readonly iteration: number;
+    }>>;
+    motionEnabled: import("vue").ComputedRef<boolean>;
+    play: () => void;
+    pause: () => void;
+    resume: () => void;
+    stop: () => void;
+    restart: () => void;
+    reset: () => void;
+    reverse: () => void;
+    seek: (progress: number) => void;
+    finishAnimation: () => void;
+    updateTarget: (next: HysNumberValue) => void;
+    sync: () => void;
+    hold: (value: boolean) => void;
+};

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

@@ -0,0 +1,4 @@
+import { type MaybeRefOrGetter } from "vue";
+import type { HysNumberControls } from "./animatedNumber";
+/** 同时控制组件实例和独立动画。空实例会被跳过。 */
+export declare function useHysNumberAnimationGroup(source: MaybeRefOrGetter<readonly (HysNumberControls | null | undefined)[]>): HysNumberControls;

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

@@ -0,0 +1,6 @@
+import { type Ref } from "vue";
+import type { FloatingAnchor } from "./useFloating";
+export declare function useMentionCaret(input: Readonly<Ref<HTMLElement | undefined>>, value: Readonly<Ref<string>>, start: () => number): {
+    anchor: import("vue").ComputedRef<FloatingAnchor | undefined>;
+    removeMirror: () => void;
+};

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

@@ -0,0 +1,23 @@
+import { type Ref } from "vue";
+import type { HysMentionProps } from "./mention";
+import type { MentionEntry } from "./useMentionOptions";
+type ListRow = {
+    key: string;
+    group: string;
+} | {
+    key: string;
+    entry: MentionEntry;
+    index: number;
+};
+export declare function useMentionList(props: HysMentionProps, choices: Readonly<Ref<readonly MentionEntry[]>>, element: Readonly<Ref<HTMLElement | undefined>>, loadMore: () => Promise<boolean>): {
+    rows: import("vue").ComputedRef<ListRow[]>;
+    enabled: import("vue").ComputedRef<MentionEntry[]>;
+    visibleRows: import("vue").ComputedRef<ListRow[]>;
+    topSpacer: import("vue").ComputedRef<number>;
+    bottomSpacer: import("vue").ComputedRef<number>;
+    rowHeight: import("vue").ComputedRef<number>;
+    onScroll: () => void;
+    reset: () => void;
+    ensureVisible: (key: string) => void;
+};
+export {};

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

@@ -0,0 +1,14 @@
+import type { HysMentionDocument, HysMentionEntity, HysMentionProps } from "./mention";
+import type { MentionSelection } from "./mentionEditor";
+export declare function mentionEntityKey(entity: HysMentionEntity): string;
+export declare function diffMentionEntities(previous: HysMentionEntity[], next: HysMentionEntity[]): {
+    added: HysMentionEntity[];
+    removed: HysMentionEntity[];
+};
+export declare function useMentionModel(props: HysMentionProps, publish: (next: HysMentionDocument, previous: HysMentionDocument, changedText: boolean) => void, accepted: (next: HysMentionDocument, previous: HysMentionDocument) => void): {
+    value: import("vue").ComputedRef<string>;
+    entities: import("vue").ComputedRef<HysMentionEntity[]>;
+    document: import("vue").ComputedRef<HysMentionDocument>;
+    commit: (next: HysMentionDocument, selection: MentionSelection, notify?: () => void, record?: boolean, force?: boolean) => Promise<boolean>;
+    history: (direction: "undo" | "redo", selection: MentionSelection) => Promise<MentionSelection | undefined>;
+};

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

@@ -0,0 +1,26 @@
+import { type Ref } from "vue";
+import type { HysMentionContext, HysMentionOption, HysMentionProps, HysMentionTrigger, HysMentionUser } from "./mention";
+export interface MentionEntry {
+    key: string;
+    option: HysMentionOption;
+    user: HysMentionUser;
+    created?: boolean;
+    remote?: boolean;
+}
+export declare function useMentionOptions(props: HysMentionProps, context: Readonly<Ref<HysMentionContext | undefined>>, trigger: Readonly<Ref<HysMentionTrigger | undefined>>, dismissed: Readonly<Ref<boolean>>, text: Readonly<Ref<string>>, onError: (error: unknown, context: HysMentionContext) => void): {
+    entries: import("vue").ComputedRef<MentionEntry[]>;
+    choices: import("vue").ComputedRef<MentionEntry[]>;
+    enabled: import("vue").ComputedRef<MentionEntry[]>;
+    busy: import("vue").ComputedRef<boolean>;
+    loadingMore: Ref<boolean, boolean>;
+    hasMore: import("vue").ComputedRef<boolean>;
+    loadError: import("vue").ShallowRef<{
+        reason: unknown;
+    } | undefined, {
+        reason: unknown;
+    } | undefined>;
+    retry: () => void;
+    loadMore: () => Promise<boolean>;
+    cancelLoad: () => void;
+    remember: (option: HysMentionOption, prefix: string) => void;
+};

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

@@ -0,0 +1,14 @@
+interface DragSettings {
+    vertical: boolean;
+    direction: 1 | -1;
+    available: number;
+    initial: number;
+    constrain: (value: number) => number;
+}
+export declare function useSplitPaneDrag(update: (value: number) => void, ended: (value: number, cancelled: boolean, notify: boolean) => void): {
+    start: (event: PointerEvent, settings: DragSettings) => boolean;
+    cancel: (event: PointerEvent) => void;
+    finish: (cancelled: boolean, notify?: boolean) => void;
+    active: () => boolean;
+};
+export {};

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

@@ -0,0 +1,4 @@
+import { type Ref } from "vue";
+import type { HysSplitPaneSizes } from "../components/HysSplitPane/HysSplitPane.vue";
+export declare function readStoredPaneSizes(value: unknown): HysSplitPaneSizes | undefined;
+export declare function useSplitPaneStorage<T>(key: () => string | undefined, state: Ref<T | undefined>, decode: (value: unknown) => T | undefined): void;

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

@@ -1,4 +1,4 @@
-import { type HysTableProps, type HysTableKey, type HysTableColumn, type HysTableSort, type HysTableFilters, type HysTableFilterValue, type HysTableQuery, type TableNode } from "./table";
+import { type HysTableProps, type HysTableKey, type HysTableColumn, type HysTableSort, type HysTableFilters, type HysTableFilterValue, type HysTableQuery, type HysTableRowSelectionOptions, type TableNode } from "./table";
 export declare function useTable<T extends object>(props: HysTableProps<T>, columns: () => readonly HysTableColumn<T>[], hasExpand: () => boolean, emit: (name: string, ...args: any[]) => void): {
     live: import("vue").Ref<boolean, boolean>;
     busy: import("vue").ComputedRef<boolean>;
@@ -16,6 +16,7 @@ export declare function useTable<T extends object>(props: HysTableProps<T>, colu
     eligible: (node: TableNode<T>) => boolean;
     allSelected: import("vue").ComputedRef<boolean>;
     someSelected: import("vue").ComputedRef<boolean>;
+    selectionPage: import("vue").ComputedRef<TableNode<T>[]>;
     sorts: import("vue").ComputedRef<HysTableSort[]>;
     filters: import("vue").ComputedRef<HysTableFilters>;
     processed: import("vue").ComputedRef<{
@@ -26,7 +27,8 @@ export declare function useTable<T extends object>(props: HysTableProps<T>, colu
     display: import("vue").ComputedRef<TableNode<T>[]>;
     page: import("vue").ComputedRef<number>;
     pageSize: import("vue").ComputedRef<number>;
-    total: import("vue").ComputedRef<number>;
+    pageCount: import("vue").ComputedRef<number>;
+    paginationTotal: import("vue").ComputedRef<number | undefined>;
     pagination: import("vue").ComputedRef<import("./table").HysTablePagination>;
     currentKey: import("vue").ComputedRef<HysTableKey | null>;
     currentRow: import("vue").ComputedRef<T | undefined>;
@@ -40,16 +42,18 @@ export declare function useTable<T extends object>(props: HysTableProps<T>, colu
     }>>;
     loadErrors: import("vue").ShallowRef<Map<string, unknown>, Map<string, unknown>>;
     canExpand: (node: TableNode<T>) => boolean;
+    nextSortOrder: (column: HysTableColumn<T>, direction?: "asc" | "desc") => import("./table").HysTableDirection | null;
     toggleSort: (column: HysTableColumn<T>, direction?: "asc" | "desc") => void;
     setSort: (value: HysTableSort | readonly HysTableSort[] | null) => void;
     setFilter: (key: string, values: readonly HysTableFilterValue[]) => void;
     clearFilter: (keys?: readonly string[]) => void;
     requestPage: (n: number, action?: "page" | "pageSize") => void;
     changeSize: (n: number) => void;
-    toggleRowSelection: (value: T | HysTableKey, checked?: boolean, range?: boolean) => Promise<boolean>;
+    toggleRowSelection: (value: T | HysTableKey, checked?: boolean, options?: boolean | HysTableRowSelectionOptions) => Promise<boolean>;
     toggleAllSelection: (checked?: boolean) => Promise<boolean>;
     invertSelection: () => Promise<boolean>;
     clearSelection: () => Promise<boolean>;
+    selectPage: (keys: readonly HysTableKey[], nodes?: TableNode<T>[]) => Promise<boolean>;
     getSelectionRows: () => T[];
     getHalfSelectionRows: () => T[];
     setCurrentRow: (value?: T | HysTableKey | null) => Promise<boolean>;

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

@@ -0,0 +1,22 @@
+import { type Ref } from "vue";
+import type { HysTableStickyOptions } from "./table";
+export declare function useTableSticky(viewport: Ref<HTMLElement | undefined>, header: Readonly<Ref<HTMLTableSectionElement | undefined>>, options: () => boolean | HysTableStickyOptions | undefined): {
+    headerTop: Ref<number, number>;
+    bar: import("vue").ShallowRef<{
+        top: number;
+        left: number;
+        width: number;
+        contentWidth: number;
+        direction: "ltr" | "rtl";
+    } | undefined, {
+        top: number;
+        left: number;
+        width: number;
+        contentWidth: number;
+        direction: "ltr" | "rtl";
+    } | undefined>;
+    scrollbar: Ref<HTMLElement | undefined, HTMLElement | undefined>;
+    syncScrollbar: () => void;
+    scrollViewport: (event: Event) => void;
+    scrollbarHeight: number;
+};

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

@@ -1,3 +1,6 @@
 import { type Ref } from "vue";
-import type { HysInputProps } from "./textInput";
-export declare function useTextareaSize(input: Ref<HTMLInputElement | HTMLTextAreaElement | undefined>, props: HysInputProps, size: Ref<string>, value: Ref<string>): () => Promise<void>;
+import type { HysInputProps, HysTextareaStyle } from "./textInput";
+export declare function useTextareaSize(input: Ref<HTMLInputElement | HTMLTextAreaElement | undefined>, props: HysInputProps, size: Ref<string>, value: Ref<string>): {
+    resize: () => Promise<void>;
+    textareaStyle: import("vue").ShallowRef<HysTextareaStyle, HysTextareaStyle>;
+};