hys-ui 0.3.0 → 0.4.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/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/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/useTourLayout.d.ts

@@ -0,0 +1,33 @@
+import { type Ref } from "vue";
+import type { HysTourAppearance, HysTourTarget } from "./tour";
+export declare function useTourLayout(shown: Readonly<Ref<boolean>>, panel: Readonly<Ref<HTMLElement | undefined>>, settings: Readonly<Ref<HysTourAppearance>>, targetInput: Readonly<Ref<HysTourTarget | undefined>>): {
+    view: import("vue").ShallowRef<{
+        width: number;
+        height: number;
+    }, {
+        width: number;
+        height: number;
+    }>;
+    bounds: import("vue").ShallowRef<DOMRect | undefined, DOMRect | undefined>;
+    card: import("vue").ShallowRef<{
+        width: number;
+        height: number;
+        x: number;
+        y: number;
+        placement: import("./useFloating").Placement;
+    } | undefined, {
+        width: number;
+        height: number;
+        x: number;
+        y: number;
+        placement: import("./useFloating").Placement;
+    } | undefined>;
+    arrow: import("vue").ShallowRef<{
+        x: number;
+        y: number;
+    } | undefined, {
+        x: number;
+        y: number;
+    } | undefined>;
+    path: import("vue").ComputedRef<string>;
+};

package/dist/types/config.d.ts

@@ -4,6 +4,7 @@ export type HysMotion = 'full' | 'subtle' | 'off';
 export interface HysConfig {
     theme?: MaybeRefOrGetter<HysTheme>;
     motion?: MaybeRefOrGetter<HysMotion>;
+    buttonAutoInsertSpace?: MaybeRefOrGetter<boolean>;
 }
 /** Call in a component setup. Reactive options are inherited by children and teleported panels. */
 export declare function provideHysConfig(config: HysConfig): void;

package/dist/types/index.d.ts

@@ -4,6 +4,8 @@ export type { HysAccordionKey } from './components/HysAccordion/HysAccordion.vue
 export type { HysAccordionItem } from './components/HysAccordion/HysAccordion.vue';
 export { default as HysAlert } from './components/HysAlert/HysAlert.vue';
 export { default as HysAnimatedNumber } from './components/HysAnimatedNumber/HysAnimatedNumber.vue';
+export type { HysAnimatedNumberContext } from './components/HysAnimatedNumber/HysAnimatedNumber.vue';
+export type { HysAnimatedNumberProps } from './components/HysAnimatedNumber/HysAnimatedNumber.vue';
 export { default as HysAutocomplete } from './components/HysAutocomplete/HysAutocomplete.vue';
 export { default as HysAvatar } from './components/HysAvatar/HysAvatar.vue';
 export { default as HysAvatarGroup } from './components/HysAvatarGroup/HysAvatarGroup.vue';
@@ -13,8 +15,17 @@ export type { HysBreadcrumbItem } from './components/HysBreadcrumb/HysBreadcrumb
 export type { HysBreadcrumbSelectInfo } from './components/HysBreadcrumb/HysBreadcrumb.vue';
 export type { HysBreadcrumbProps } from './components/HysBreadcrumb/HysBreadcrumb.vue';
 export { default as HysButton } from './components/HysButton/HysButton.vue';
+export type { HysButtonPaletteColor } from './components/HysButton/HysButton.vue';
 export type { HysButtonVariant } from './components/HysButton/HysButton.vue';
+export type { HysButtonAppearance } from './components/HysButton/HysButton.vue';
+export type { HysButtonSize } from './components/HysButton/HysButton.vue';
+export type { HysButtonActionContext } from './components/HysButton/HysButton.vue';
+export type { HysButtonAction } from './components/HysButton/HysButton.vue';
+export type { HysButtonActionGuard } from './components/HysButton/HysButton.vue';
+export type { HysButtonInstance } from './components/HysButton/HysButton.vue';
 export type { HysButtonProps } from './components/HysButton/HysButton.vue';
+export { default as HysButtonGroup } from './components/HysButtonGroup/HysButtonGroup.vue';
+export type { HysButtonGroupProps } from './components/HysButtonGroup/HysButtonGroup.vue';
 export { default as HysCalendar } from './components/HysCalendar/HysCalendar.vue';
 export { default as HysCalendarNavigation } from './components/HysCalendarNavigation/HysCalendarNavigation.vue';
 export { default as HysCard } from './components/HysCard/HysCard.vue';
@@ -65,6 +76,8 @@ export { default as HysRating } from './components/HysRating/HysRating.vue';
 export { default as HysResizablePanel } from './components/HysResizablePanel/HysResizablePanel.vue';
 export { default as HysRichTextEditor } from './components/HysRichTextEditor/HysRichTextEditor.vue';
 export { default as HysSearch } from './components/HysSearch/HysSearch.vue';
+export type { HysSearchProps } from './components/HysSearch/HysSearch.vue';
+export type { HysSearchButtonContext } from './components/HysSearch/HysSearch.vue';
 export { default as HysSegmented } from './components/HysSegmented/HysSegmented.vue';
 export { default as HysSelect } from './components/HysSelect/HysSelect.vue';
 export { default as HysShortcutHelp } from './components/HysShortcutHelp/HysShortcutHelp.vue';
@@ -73,6 +86,19 @@ export type { HysSkeletonVariant } from './components/HysSkeleton/HysSkeleton.vu
 export { default as HysSlider } from './components/HysSlider/HysSlider.vue';
 export { default as HysSortableList } from './components/HysSortableList/HysSortableList.vue';
 export { default as HysSplitPane } from './components/HysSplitPane/HysSplitPane.vue';
+export type { HysSplitPaneSide } from './components/HysSplitPane/HysSplitPane.vue';
+export type { HysSplitPaneLength } from './components/HysSplitPane/HysSplitPane.vue';
+export type { HysSplitPanePanelOptions } from './components/HysSplitPane/HysSplitPane.vue';
+export type { HysSplitPanePanel } from './components/HysSplitPane/HysSplitPane.vue';
+export type { HysSplitPaneSizes } from './components/HysSplitPane/HysSplitPane.vue';
+export type { HysSplitPanePanelResize } from './components/HysSplitPane/HysSplitPane.vue';
+export type { HysSplitPanePanelResizeEnd } from './components/HysSplitPane/HysSplitPane.vue';
+export type { HysSplitPaneHandleContext } from './components/HysSplitPane/HysSplitPane.vue';
+export type { HysSplitPaneProps } from './components/HysSplitPane/HysSplitPane.vue';
+export type { HysSplitPaneSlotContext } from './components/HysSplitPane/HysSplitPane.vue';
+export type { HysSplitPanePanelContext } from './components/HysSplitPane/HysSplitPane.vue';
+export type { HysSplitPaneResizeEnd } from './components/HysSplitPane/HysSplitPane.vue';
+export type { HysSplitPaneInstance } from './components/HysSplitPane/HysSplitPane.vue';
 export { default as HysSteps } from './components/HysSteps/HysSteps.vue';
 export type { HysStepStatus } from './components/HysSteps/HysSteps.vue';
 export type { HysStepItem } from './components/HysSteps/HysSteps.vue';
@@ -106,14 +132,23 @@ export type { HysInputProps, HysTextareaProps, HysInputFormatInfo, HysInputCount
 export { useHysToast, createHysToast } from './composables/useHysToast';
 export type { HysToastApi, HysToastOptions, HysToastConfig, HysToastHandle, HysToastServiceConfig, HysToastService } from './composables/useHysToast';
 export type { HysSliderValue, HysSliderStep, HysSliderMarks, HysSliderDragInfo, HysSliderInstance } from './composables/slider';
+export type { HysSelectLabeledValue } from './composables/selectOptions';
 export type { HysAvatarProps, HysAvatarSize, HysAvatarBreakpoint, HysAvatarFit, HysAvatarLoadInfo, HysAvatarOption, HysAvatarInstance, HysAvatarGroupProps, HysAvatarGroupInstance } from './composables/avatar';
 export type { HysAutocompleteProps, HysAutocompleteRow, HysAutocompleteOption, HysAutocompleteItem, HysAutocompleteGroup, HysAutocompleteDataOption, HysAutocompleteContext, HysAutocompleteCallback, HysAutocompleteFetch, HysAutocompleteInstance } from './composables/autocomplete';
+export type { HysMentionUser, HysMentionOption, HysMentionDataOption, HysMentionContext, HysMentionLoadContext, HysMentionFieldNames, HysMentionProps, HysMentionSlots, HysMentionPage, HysMentionLoader, HysMentionFilter, HysMentionSearchField, HysMentionSearchMode, HysMentionMatch, HysMentionTrigger, HysMentionSource, HysMentionEntity, HysMentionDocument, HysMentionOpenOptions, HysMentionInsertOptions, HysMentionAutosize, HysMentionLocale, HysMentionAction, HysMentionInstance } from './composables/mention';
+export { matchMention, mentionTriggers, normalizeMentionEntities, serializeMentionDocument, deserializeMentionDocument, rebaseMentionEntities } from './composables/mentionDocument';
+export { useMentionOptions } from './composables/useMentionOptions';
+export type { MentionEntry as HysMentionEntry } from './composables/useMentionOptions';
+export { useMentionList } from './composables/useMentionList';
+export { useMentionCaret } from './composables/useMentionCaret';
+export { useMentionModel } from './composables/useMentionModel';
+export type { HysTourTarget, HysTourContent, HysTourMask, HysTourGap, HysTourButtonProps, HysTourAppearance, HysTourStep, HysTourProps, HysTourContext } from './composables/tour';
 export type { HysChoiceValue, HysChoiceFieldNames, HysChoiceOption, HysChoiceDataOption, HysCheckboxChange, HysCheckboxReject, HysCheckboxInstance, HysCheckboxGroupInstance, HysRadioInstance, HysRadioGroupInstance, HysSwitchGuardContext, HysSwitchInstance } from './composables/choice';
 export type { HysRatingIcon, HysRatingLevels, HysRatingInstance } from './composables/rating';
 export type { HysSegmentedOption, HysSegmentedInstance } from './composables/segmented';
 export type { HysGanttScrollOptions, HysGanttInstance, HysGanttDependencyChange, HysGanttDependencyMove, HysGanttDependencyInvalid, HysGanttDependencyReason, HysGanttHistoryType, HysGanttHistoryEntry, HysGanttHistoryState, HysGanttHistoryInvalid, HysGanttConflictType, HysGanttConflict } from './composables/gantt';
 export type { CalendarEvent, HysCalendarValue, HysCalendarMode, HysCalendarTransition, HysCalendarAction, HysCalendarCell, HysCalendarMonthCell, HysCalendarSelectInfo, HysCalendarInstance } from './composables/calendar';
-export type { HysTableSelectionProps, HysTableSelectionColumn, HysTableFilterConfirmOptions, HysTableFilterResetOptions, HysTableScrollRowOptions, HysTableKey, HysTableDirection, HysTableFilterValue, HysTableFilters, HysTableSort, HysTableFilter, HysTableCellContext, HysTableColumn, HysTableElementAttrs, HysTablePaginationPosition, HysTablePagination, HysTableQuery, HysTableLoadContext, HysTableLocale, HysTableProps, HysTableInstance } from './composables/table';
+export type { HysTableSelectionProps, HysTableSelectionColumn, HysTableRowSelectionOptions, HysTableSelectionAction, HysTableFilterConfirmOptions, HysTableFilterResetOptions, HysTableFilterDropdownContext, HysTableScrollRowOptions, HysTableStickyOptions, HysTableOverflowTooltipOptions, HysTableComponents, HysTableKey, HysTableDirection, HysTableFilterValue, HysTableFilters, HysTableSort, HysTableFilter, HysTableCellContext, HysTableColumn, HysTableElementAttrs, HysTablePaginationPosition, HysTablePagination, HysTableQuery, HysTableLoadContext, HysTableLocale, HysTableProps, HysTableInstance } from './composables/table';
 export type { HysTransferKey, HysTransferSide, HysTransferOption, HysTransferFieldNames, HysTransferPagination, HysTransferLocale, HysTransferHeaderInfo, HysTransferProps, HysTransferPanelContext, HysTransferInstance, HysTransferSlots } from './composables/transfer';
 export type { TreeNode, HysTreeKey, HysTreeValue, HysTreeNode, HysTreeFieldNames, HysTreeLoadContext, HysTreeLocale, HysTreeRecord, HysTreeCheckInfo, HysTreeSelectInfo, HysTreeDropPosition, HysTreeDropInfo, HysTreeNodeContext, HysTreeProps, HysTreeInstance } from './composables/tree';
 export type { HysTreeSelectNode, HysTreeSelectDataNode, HysTreeSelectLabelValue, HysTreeSelectValue, HysTreeSelectFieldNames, HysTreeSelectSimpleMode, HysTreeSelectStrategy, HysTreeSelectItem, HysTreeSelectChange, HysTreeSelectProps, HysTreeSelectInstance } from './composables/treeSelect';