@movk/nuxt 1.1.2 → 1.3.0

package/dist/runtime/types/data-table/columns.d.ts

@@ -0,0 +1,236 @@
+import type { ButtonProps, CheckboxProps, DropdownMenuProps, IconProps, ModalProps, TableColumn, TooltipProps } from '@nuxt/ui';
+import type { OmitByKey } from '@movk/core';
+import type { CellContext, ColumnDef, ColumnDefTemplate } from '@tanstack/vue-table';
+import type { SemanticColor } from '../shared';
+import type { DataTableCheckboxContext, DataTableExpandButtonContext, DataTableExpandToggleAllContext, DataTablePinButtonContext, DataTableRowPinningButtonContext, DataTableSortButtonContext } from './contexts';
+export type DataTableDensityPreset = 'compact' | 'normal' | 'comfortable';
+export type DataTableTreeSelectionStrategy = 'cascade' | 'isolated' | 'leaf';
+export type DataTableSizePreset = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+export type DataTableDynamic<V, Ctx> = V | ((ctx: Ctx) => V);
+interface DataTableBaseColumn {
+    /** 列头文本 */
+    header: string;
+    /** 固定到左/右侧 */
+    fixed?: 'left' | 'right';
+    /** 对齐方式 */
+    align?: 'left' | 'center' | 'right';
+    /** 列宽，支持数值或预设 */
+    size?: number | DataTableSizePreset;
+    /** 最小宽度 */
+    minSize?: number;
+    /** 最大宽度 */
+    maxSize?: number;
+}
+export interface DataTableDataColumn<T> extends DataTableBaseColumn {
+    /** 数据字段键 */
+    accessorKey: keyof T & string | (string & {});
+    /**
+     * 默认是否可见
+     * @defaultValue true
+     */
+    visibility?: boolean;
+    /** 允许通过表头交互切换列固定（left -> right -> none），优先级高于全局 pinable */
+    pinable?: boolean;
+    /** 固定列按钮 props 透传，列级可覆盖全局 pinButtonProps */
+    pinButtonProps?: DataTableDynamic<ButtonProps, DataTablePinButtonContext<T>>;
+    /** 启用排序，优先级高于全局 sortable */
+    sortable?: boolean;
+    /** 排序按钮 props 透传，列级可覆盖全局 sortButtonProps */
+    sortButtonProps?: DataTableDynamic<ButtonProps, DataTableSortButtonContext<T>>;
+    /** 是否可拖拽调整宽度，优先级高于全局 resizable */
+    resizable?: boolean;
+    /**
+     * 单元格文本溢出截断，优先级高于全局 truncate
+     * - true = 单行截断
+     * - number > 1 = 多行截断行数
+     * - false = 禁用截断
+     * - 函数 = 按 cell 上下文动态决定
+     */
+    truncate?: boolean | number | ((ctx: CellContext<T, unknown>) => boolean | number);
+    /**
+     * 空值占位，false 禁用，函数接收 CellContext 动态渲染
+     * @defaultValue 继承全局 emptyCell
+     */
+    emptyCell?: string | false | ColumnDefTemplate<CellContext<T, unknown>>;
+    /**
+     * 溢出 Tooltip，优先级高于全局 tooltip
+     * - true = 溢出时单行显示
+     * - number = 溢出时多行显示（行数）
+     * - false = 禁用
+     * - 函数 = 按 cell 上下文动态决定
+     */
+    tooltip?: boolean | number | ((ctx: CellContext<T, unknown>) => boolean | number);
+    /** UTooltip 额外 props 透传（tooltip 启用时生效） */
+    tooltipProps?: TooltipProps;
+    /** 单元格自定义渲染，string 直接显示，函数接收 CellContext */
+    cell?: TableColumn<T>['cell'];
+    /** TanStack ColumnDef 透传（逃生舱） */
+    _raw?: Partial<ColumnDef<T, unknown>>;
+}
+export interface DataTableGroupColumn<T> extends DataTableBaseColumn {
+    /** 分组子列，设置后作为分组表头 */
+    children: (DataTableDataColumn<T> | DataTableGroupColumn<T>)[];
+}
+export interface DataTableSpecialColumnBase<T = unknown> extends Omit<DataTableBaseColumn, 'header' | 'truncate'> {
+    /**
+     * 默认是否可见
+     * @defaultValue true
+     */
+    visibility?: boolean;
+    /**
+     * 允许通过表头交互切换列固定位置（left -> right -> none）
+     * @defaultValue false
+     */
+    pinable?: boolean;
+    /**
+     * 是否可拖拽调整宽度
+     * @defaultValue false
+     */
+    resizable?: boolean;
+    /** 固定列按钮 props 透传，列级可覆盖全局 pinButtonProps */
+    pinButtonProps?: DataTableDynamic<ButtonProps, DataTablePinButtonContext<T>>;
+    /** TanStack ColumnDef 透传（逃生舱） */
+    _raw?: Partial<ColumnDef<any, unknown>>;
+}
+/** @defaultValue size=48, fixed='left', align='center' */
+export interface DataTableSelectionColumn<T = unknown> extends DataTableSpecialColumnBase<T> {
+    /** 选择列，显示复选框/单选框用于行选择 */
+    type: 'selection';
+    /**
+     * 单选/多选
+     * @defaultValue 'multiple'
+     */
+    mode?: 'single' | 'multiple';
+    /**
+     * 树形勾选策略，仅在 childrenKey 启用时生效
+     * - 'cascade'  父子级联（默认，=TanStack enableSubRowSelection: true）
+     * - 'isolated' 父子独立勾选（=enableSubRowSelection: false）
+     * - 'leaf'     仅叶子节点可勾选，父节点展示为子孙派生态（只读）
+     * @defaultValue 'cascade'
+     */
+    strategy?: DataTableTreeSelectionStrategy;
+    /** 单选模式下的表头文本 */
+    header?: string;
+    /** UCheckbox props 透传 */
+    checkboxProps?: DataTableDynamic<CheckboxProps, DataTableCheckboxContext<T>>;
+}
+/** @defaultValue size=60, align='center' */
+export interface DataTableIndexColumn<T = unknown> extends DataTableSpecialColumnBase<T> {
+    /** 索引列，显示行索引 */
+    type: 'index';
+    /**
+     * 表头文本
+     * @defaultValue '#'
+     */
+    header?: string;
+}
+/** @defaultValue size=48 */
+export interface DataTableExpandColumn<T = unknown> extends DataTableSpecialColumnBase<T> {
+    /** 展开列，显示展开图标用于树形表格 */
+    type: 'expand';
+    /** 展开/折叠按钮 props 透传 */
+    buttonProps?: DataTableDynamic<ButtonProps, DataTableExpandButtonContext<T>>;
+    /**
+     * 表头是否渲染「全部展开/收起」按钮，树形与行详情展开模式均生效
+     * @defaultValue true
+     */
+    toggleAll?: boolean;
+    /** 表头「全部展开/收起」按钮 props 透传 */
+    toggleAllButtonProps?: DataTableDynamic<ButtonProps, DataTableExpandToggleAllContext<T>>;
+}
+/** @defaultValue size=48, fixed='left', align='center' */
+export interface DataTableRowPinningColumn<T = unknown> extends DataTableSpecialColumnBase<T> {
+    /** 行固定列，显示图标用于行固定 */
+    type: 'row-pinning';
+    /**
+     * 行固定位置
+     * @defaultValue 'top'
+     */
+    position?: 'top' | 'bottom';
+    /**
+     * 表头文本
+     * @defaultValue '#'
+     */
+    header?: string;
+    /** 行固定/取消固定按钮 props 透传 */
+    buttonProps?: DataTableDynamic<ButtonProps, DataTableRowPinningButtonContext<T>>;
+}
+/** 操作按钮回调上下文 */
+export interface DataTableActionButtonContext<T> {
+    cellContext: CellContext<T, unknown>;
+    row: T;
+    index: number;
+    action: DataTableAction<T>;
+}
+interface DataTableActionConfirmProps extends OmitByKey<ModalProps, 'title' | 'open' | 'defaultOpen' | 'dismissible'> {
+    title?: string;
+    type?: SemanticColor;
+    icon?: IconProps['name'];
+    dismissible?: boolean;
+    description?: string;
+    confirmText?: string;
+    cancelText?: string;
+    confirmButtonProps?: ButtonProps;
+    cancelButtonProps?: ButtonProps;
+}
+export interface DataTableAction<T> {
+    /** 唯一 key，用于渲染稳定性与溢出菜单定位；未提供时回退到数组下标 */
+    key?: string | number;
+    /** 按钮 props，支持整体回调按行动态计算 */
+    buttonProps?: DataTableDynamic<ButtonProps, DataTableActionButtonContext<T>>;
+    /** 是否可见 */
+    visibility?: boolean | ((ctx: DataTableActionButtonContext<T>) => boolean);
+    /** 是否禁用（loading 中自动叠加） */
+    disabled?: boolean | ((ctx: DataTableActionButtonContext<T>) => boolean);
+    /** 点击回调，支持 async；返回 Promise 时自动维护 loading 状态 */
+    onClick: (ctx: DataTableActionButtonContext<T>) => void | Promise<void>;
+    /** 触发前需要 MessageBox 确认 */
+    confirm?: boolean;
+    /** 确认弹窗 props，支持回调 */
+    confirmProps?: DataTableDynamic<DataTableActionConfirmProps, DataTableActionButtonContext<T>>;
+    /** 溢出菜单内在该项之前插入分隔线（仅 overflow 模式生效） */
+    divider?: boolean;
+}
+/** @defaultValue fixed='right' */
+export interface DataTableActionsColumn<T = unknown> extends DataTableSpecialColumnBase<T> {
+    /** 操作列，显示操作按钮 */
+    type: 'actions';
+    /**
+     * 表头文本
+     * @defaultValue '操作'
+     */
+    header?: string;
+    /** 操作按钮列表，支持整体回调 */
+    actions: DataTableAction<T>[] | ((ctx: CellContext<T, unknown>) => DataTableAction<T>[]);
+    /**
+     * 最多平铺的 action 数；超出部分收纳到 UDropdownMenu
+     * @defaultValue 3
+     */
+    maxInline?: number;
+    /** 溢出触发按钮 props */
+    overflowTrigger?: DataTableDynamic<ButtonProps, CellContext<T, unknown>>;
+    /** 溢出菜单透传 props（UDropdownMenu） */
+    dropdownProps?: DataTableDynamic<Partial<DropdownMenuProps>, CellContext<T, unknown>>;
+    /** 容器 class，默认 'flex items-center gap-1' */
+    wrapperClass?: string | ((ctx: CellContext<T, unknown>) => string);
+}
+export type DataTableColumn<T> = DataTableDataColumn<T> | DataTableGroupColumn<T> | DataTableSelectionColumn<T> | DataTableIndexColumn<T> | DataTableExpandColumn<T> | DataTableRowPinningColumn<T> | DataTableActionsColumn<T> | TableColumn<T>;
+export declare function isDataColumn<T>(col: DataTableColumn<T>): col is DataTableDataColumn<T>;
+export declare function isGroupColumn<T>(col: DataTableColumn<T>): col is DataTableGroupColumn<T>;
+export interface TreeSelectionResult<T> {
+    /** TanStack 原生语义：所有 selected=true 的行对象 */
+    selected: T[];
+    /** 只包含叶子节点（无子节点）且被勾选的行 */
+    leaves: T[];
+    /** 父节点且所有子孙叶子均已选中（「全选」的父） */
+    parents: T[];
+    /** 父节点且子孙叶子部分选中（indeterminate） */
+    halfSelected: T[];
+    /**
+     * 严格被用户勾选：排除因父级联而带上的子节点。
+     * - 'isolated' / 'leaf'：等价于 `selected`
+     * - 'cascade'：若自身被选且父节点也在 selected 中，视为级联产物，剔除
+     */
+    strictlyChecked: T[];
+}
+export {};

package/dist/runtime/types/data-table/columns.js

@@ -0,0 +1,6 @@
+export function isDataColumn(col) {
+  return "accessorKey" in col && !("children" in col) && !("type" in col);
+}
+export function isGroupColumn(col) {
+  return "children" in col && !("type" in col);
+}

package/dist/runtime/types/data-table/component.d.ts

@@ -0,0 +1,190 @@
+import type { CellContext, ColumnDefTemplate, ColumnMeta, PaginationState, Row, Table, TableMeta } from '@tanstack/vue-table';
+import type { ButtonProps, TableData, TableProps, TableRow, TooltipProps } from '@nuxt/ui';
+import type { FirstParameter, OmitByKey } from '@movk/core';
+import type { VNode } from 'vue';
+import type { DataTableActionButtonContext, DataTableColumn, DataTableDataColumn, DataTableDensityPreset, DataTableDynamic, TreeSelectionResult } from './columns';
+import type { DataTablePinButtonContext, DataTableSortButtonContext } from './contexts';
+import type { DataTablePaginationSlots, DataTablePaginationUi } from './pagination';
+import type { ClassNameValue } from '../shared';
+export type DataTableSelectHandler<T extends TableData> = (e: Event, row: TableRow<T>) => void;
+export type DataTableHoverHandler<T extends TableData> = (e: Event, row: TableRow<T> | null) => void;
+export type DataTableContextmenuHandler<T extends TableData> = ((e: Event, row: TableRow<T>) => void) | ((e: Event, row: TableRow<T>) => void)[];
+export interface DataTableExposed<T extends TableData> {
+    tableRef: HTMLTableElement | null;
+    tableApi: Table<T> | null;
+    /** UTable 根元素，即滚动容器 */
+    el: HTMLElement | null;
+    scrollToTop: (options?: ScrollToOptions) => void;
+    clearSelection: () => void;
+    /** 展开到指定层级（depth < n 的可展开行展开，其余收起）；depth=0 等价收起全部 */
+    expandToDepth: (depth: number) => void;
+    /** 收起全部行 */
+    collapseAll: () => void;
+    treeSelection: TreeSelectionResult<T>;
+}
+export interface DataTableProps<T extends TableData> extends /* @vue-ignore */ OmitByKey<TableProps<T>, 'columns' | 'meta' | 'sticky' | 'loading' | 'ui' | 'columnSizingOptions' | 'columnPinningOptions' | 'rowSelectionOptions' | 'sortingOptions' | 'expandedOptions' | 'paginationOptions' | 'onSelect' | 'onHover' | 'onContextmenu'> {
+    /**
+     * 行唯一标识字段，自动派生 getRowId；与 getRowId 同传时后者优先
+     * @example 'id'
+     */
+    rowKey?: keyof T & string | (string & {});
+    columns?: DataTableColumn<T>[];
+    loading?: TableProps<T>['loading'];
+    /**
+     * 斑马纹
+     * @defaultValue false
+     */
+    stripe?: boolean;
+    /**
+     * 纵向边框，传对象可定制 color/width/style
+     * @defaultValue false
+     */
+    bordered?: boolean | {
+        color?: string;
+        width?: string;
+        style?: 'solid' | 'dashed' | 'dotted' | 'double';
+    };
+    /**
+     * 表格宽度由列宽内容决定（w-fit）
+     * @defaultValue false
+     */
+    fitContent?: boolean;
+    /**
+     * 空值占位符
+     * @defaultValue '-'
+     */
+    emptyCell?: false | string | ColumnDefTemplate<CellContext<T, unknown>>;
+    /**
+     * 启用列固定按钮，传函数可按列动态决定
+     * @defaultValue false
+     */
+    pinable?: boolean | ((col: DataTableDataColumn<T>) => boolean);
+    pinButtonProps?: DataTableDynamic<ButtonProps, DataTablePinButtonContext<T>>;
+    /**
+     * 启用列排序，传函数可按列动态决定
+     * @defaultValue false
+     */
+    sortable?: boolean | ((col: DataTableDataColumn<T>) => boolean);
+    sortButtonProps?: DataTableDynamic<ButtonProps, DataTableSortButtonContext<T>>;
+    /** 全局 action 按钮 props，与列级 action.buttonProps 深度合并，列级优先 */
+    actionButtonProps?: DataTableDynamic<ButtonProps, DataTableActionButtonContext<T>>;
+    /**
+     * 行内最多展示多少 action 按钮，超出折叠到 overflow
+     * @defaultValue 3
+     */
+    actionsMaxInline?: number;
+    actionsOverflowTrigger?: DataTableDynamic<ButtonProps, CellContext<T, unknown>>;
+    /**
+     * 启用列宽拖拽，传函数可按列动态决定
+     * @defaultValue false
+     */
+    resizable?: boolean | ((col: DataTableDataColumn<T>) => boolean);
+    /**
+     * - 'onChange' 拖动中实时重排
+     * - 'onEnd' 释放后才更新
+     * @defaultValue 'onChange'
+     */
+    columnResizeMode?: 'onChange' | 'onEnd';
+    /** 单元格内边距密度 */
+    density?: DataTableDensityPreset | ColumnMeta<T, unknown>['class'];
+    meta?: TableMeta<T>;
+    rowClass?: string | ((row: T) => string);
+    rowStyle?: string | Record<string, string> | ((row: T) => string | Record<string, string>);
+    /**
+     * 单元格溢出 Tooltip：true 单行 / number 多行 / false 禁用 / 函数 动态
+     * @defaultValue false
+     */
+    tooltip?: boolean | number | ((ctx: CellContext<T, unknown>) => boolean | number);
+    tooltipProps?: OmitByKey<TooltipProps, 'text'>;
+    /**
+     * 单元格文本截断：true 单行 / number 多行 / false 禁用 / 函数 动态
+     * @defaultValue true
+     */
+    truncate?: boolean | number | ((ctx: CellContext<T, unknown>) => boolean | number);
+    sortingOptions?: TableProps<T>['sortingOptions'];
+    columnSizingOptions?: TableProps<T>['columnSizingOptions'];
+    columnPinningOptions?: TableProps<T>['columnPinningOptions'];
+    rowSelectionOptions?: TableProps<T>['rowSelectionOptions'];
+    /**
+     * 子行字段名，设置后启用树形模式
+     * @example 'children'
+     */
+    childrenKey?: keyof T & string | (string & {});
+    /**
+     * 树形缩进：number 每层缩进 px / string CSS 值 / 函数 动态返回 CSS
+     * @defaultValue '1rem'
+     */
+    indentSize?: number | string | ((ctx: CellContext<T, unknown>) => string);
+    expandedOptions?: TableProps<T>['expandedOptions'];
+    /** @defaultValue false */
+    expandOnRowClick?: boolean;
+    /** @defaultValue false */
+    selectOnRowClick?: boolean;
+    /** 可见列白名单（数组形） */
+    columnVisibilityKeys?: string[];
+    /** 隐藏列黑名单（数组形），与 columnVisibilityKeys 互斥，同传时白名单优先 */
+    columnVisibilityExcludeKeys?: string[];
+    /** 选中行 id 列表（数组形） */
+    rowSelectionKeys?: string[];
+    /** 展开行 id 列表（数组形） */
+    expandedKeys?: string[];
+    onSelect?: DataTableSelectHandler<T>;
+    onHover?: DataTableHoverHandler<T>;
+    onRowContextmenu?: DataTableContextmenuHandler<T>;
+    /**
+     * 分页配置，透传给 TanStack / UTable
+     * - 客户端分页：传入即启用，自动注入 getPaginationRowModel
+     * - 服务端分页：manualPagination=true 并提供 rowCount 或 pageCount
+     */
+    paginationOptions?: TableProps<T>['paginationOptions'];
+    /**
+     * 粘性表头
+     * @defaultValue true
+     */
+    sticky?: TableProps<T>['sticky'];
+    paginationUi?: DataTablePaginationUi;
+    /**
+     * 触底加载回调，传入即启用无限滚动模式（自动隐藏内置分页、async 期间派生 loading）
+     */
+    loadMore?: () => void | Promise<void>;
+    /**
+     * 是否还能加载更多
+     * @defaultValue true
+     */
+    canLoadMore?: boolean;
+    /**
+     * 触发 loadMore 的距底像素阈值
+     * @defaultValue 100
+     */
+    loadMoreDistance?: number;
+    class?: ClassNameValue;
+    ui?: Record<string, ClassNameValue>;
+}
+export interface DataTablePaginationSlotProps<T extends TableData> {
+    tableApi: Table<T>;
+    pagination: PaginationState;
+    page: number;
+    rowCount: number;
+    rowCountKnown: boolean;
+    pageCount: number;
+    currentPageRowCount: number;
+    from: number;
+    to: number;
+    show: boolean;
+    selectedCount: number;
+    setPage: (page: number) => void;
+    setPageSize: (pageSize: unknown) => void;
+}
+export interface DataTableSlots<T extends TableData> {
+    'expanded'(props: {
+        row: Row<T>;
+    }): VNode[];
+    'empty'(): VNode[];
+    'loading'(): VNode[];
+    'caption'(): VNode[];
+    'body-top'(): VNode[];
+    'body-bottom'(): VNode[];
+    'pagination'(props: DataTablePaginationSlotProps<T>): VNode[];
+    'pagination-summary'(props: FirstParameter<DataTablePaginationSlots<T>['summary']>): VNode[];
+    'pagination-actions'(props: FirstParameter<DataTablePaginationSlots<T>['actions']>): VNode[];
+}

package/dist/runtime/types/data-table/contexts.d.ts

@@ -0,0 +1,44 @@
+import type { CellContext, HeaderContext } from '@tanstack/vue-table';
+/** 排序按钮回调上下文 */
+export interface DataTableSortButtonContext<T> {
+    isSorted: 'asc' | 'desc' | false;
+    headerContext: HeaderContext<T, unknown>;
+}
+/** 列固定按钮回调上下文 */
+export interface DataTablePinButtonContext<T> {
+    pinned: 'left' | 'right' | false;
+    headerContext: HeaderContext<T, unknown>;
+}
+/** 选择列复选框回调上下文（表头 / 单元格共用，用 scope 区分） */
+export type DataTableCheckboxContext<T> = {
+    scope: 'header';
+    headerContext: HeaderContext<T, unknown>;
+    isAllSelected: boolean;
+    isIndeterminate: boolean;
+} | {
+    scope: 'cell';
+    cellContext: CellContext<T, unknown>;
+    isSelected: boolean;
+    isIndeterminate: boolean;
+    /** 是否为 leaf 策略下派生态的只读父行 */
+    isLeafAggregate: boolean;
+};
+/** 展开列按钮回调上下文 */
+export interface DataTableExpandButtonContext<T> {
+    cellContext: CellContext<T, unknown>;
+    isExpanded: boolean;
+    depth: number;
+    canExpand: boolean;
+}
+/** 展开列表头「全部展开/收起」按钮回调上下文 */
+export interface DataTableExpandToggleAllContext<T> {
+    headerContext: HeaderContext<T, unknown>;
+    isAllExpanded: boolean;
+    isSomeExpanded: boolean;
+}
+/** 行固定列按钮回调上下文 */
+export interface DataTableRowPinningButtonContext<T> {
+    cellContext: CellContext<T, unknown>;
+    pinned: 'top' | 'bottom' | false;
+    position: 'top' | 'bottom';
+}

package/dist/runtime/types/data-table/index.d.ts

@@ -0,0 +1,6 @@
+export type { DataTableCheckboxContext, DataTableExpandButtonContext, DataTableExpandToggleAllContext, DataTablePinButtonContext, DataTableRowPinningButtonContext, DataTableSortButtonContext } from './contexts';
+export type { DataTableAction, DataTableActionButtonContext, DataTableActionsColumn, DataTableColumn, DataTableDataColumn, DataTableDensityPreset, DataTableDynamic, DataTableExpandColumn, DataTableGroupColumn, DataTableIndexColumn, DataTableRowPinningColumn, DataTableSelectionColumn, DataTableSizePreset, DataTableSpecialColumnBase, DataTableTreeSelectionStrategy, TreeSelectionResult } from './columns';
+export { isDataColumn, isGroupColumn } from './columns';
+export type { DataTablePaginationUi, DataTablePaginationProps, DataTablePaginationSlots } from './pagination';
+export type { DataTableContextmenuHandler, DataTableExposed, DataTableHoverHandler, DataTablePaginationSlotProps, DataTableProps, DataTableSelectHandler, DataTableSlots } from './component';
+export type { ExpandedState, PaginationState, RowPinningState, RowSelectionState, SortingState } from '@tanstack/vue-table';

package/dist/runtime/types/data-table/index.js

@@ -0,0 +1 @@
+export { isDataColumn, isGroupColumn } from "./columns.js";

package/dist/runtime/types/data-table/pagination.d.ts

@@ -0,0 +1,87 @@
+import type { PaginationProps, SelectProps, TableData } from '@nuxt/ui';
+import type { PaginationState, RowData, Table } from '@tanstack/vue-table';
+import type { VNode } from 'vue';
+import type { ClassNameValue } from '../shared';
+type DataTablePageSizeSelectProps = Omit<SelectProps<Array<{
+    label: string;
+    value: number;
+}>>, 'items' | 'modelValue' | 'defaultValue' | 'multiple' | 'valueKey' | 'labelKey' | 'descriptionKey' | 'onUpdate:modelValue'>;
+interface DataTablePaginationUiText {
+    total?: string;
+    item?: string;
+    range?: string;
+    selected?: string;
+    page?: string;
+}
+export interface DataTablePaginationUi {
+    /**
+     * 分页栏 UI 是否显示（仅在分页已启用时生效）。
+     * 仅控 UI 显隐，不影响数据切片；
+     * 若要完全关闭分页，请不要传入 `paginationOptions` / `v-model:pagination` / `pageSizes`。
+     * @defaultValue 分页启用时为 `pageCount > 1 || pageSizes.length > 1`，否则为 `false`
+     */
+    show?: boolean;
+    /**
+     * 可选每页条数列表，长度大于 1 时显示切换器
+     * @defaultValue []
+     */
+    pageSizes?: number[];
+    /**
+     * 是否显示已选行数
+     * @defaultValue true
+     */
+    showSelectedCount?: boolean;
+    /**
+     * 是否显示当前页区间
+     * @defaultValue true
+     */
+    showRowRange?: boolean;
+    paginationProps?: Omit<PaginationProps, 'page' | 'total' | 'itemsPerPage'>;
+    pageSizeSelectProps?: DataTablePageSizeSelectProps;
+    text?: DataTablePaginationUiText;
+    ui?: Record<string, ClassNameValue>;
+}
+export interface DataTablePaginationProps<TData extends RowData> {
+    tableApi: Table<TData>;
+    pagination: PaginationState;
+    page: number;
+    rowCount: number;
+    rowCountKnown: boolean;
+    pageCount: number;
+    from: number;
+    to: number;
+    selectedCount: number;
+    setPage: (page: number) => void;
+    setPageSize: (pageSize: unknown) => void;
+    uiConfig?: DataTablePaginationUi;
+}
+export interface DataTablePaginationSlots<TData extends RowData = RowData> {
+    summary(props: {
+        summaryText: string;
+        selectedText: string;
+        selectedCount: number;
+        rowCount: number;
+        rowCountKnown: boolean;
+        from: number;
+        to: number;
+        page: number;
+        pageCount: number;
+        showSelectedCount: boolean;
+    }): VNode[];
+    actions(props: {
+        tableApi: Table<TData>;
+        page: number;
+        pageCount: number;
+        pageSize: number;
+        rowCount: number;
+        pageSizes: number[];
+        pageSizeOptions: {
+            label: string;
+            value: number;
+        }[];
+        showPageSizeSelect: boolean;
+        setPage: (page: number) => void;
+        setPageSize: (pageSize: unknown) => void;
+    }): VNode[];
+}
+export type { TableData };

package/dist/runtime/types/index.d.ts

@@ -1,5 +1,6 @@
-export * from './auto-form.js';
-export * from './components.js';
-export * from './auto-form-renderer.js';
-export * from './api.js';
-export * from './module.js';
+export * from './api';
+export * from './auto-form';
+export * from './components';
+export * from './data-table';
+export * from './shared';
+export type { AnyCalendarDate, Calendar, CalendarDate, CalendarDateTime, DateDuration, DateFields, DateFormatter, DateFormatterOptions, DateRange, DateValue, Time, ZonedDateTime } from '../composables/useDateFormatter';

package/dist/runtime/types/index.js

@@ -1,5 +1,5 @@
-export * from "./auto-form.js";
-export * from "./components.js";
-export * from "./auto-form-renderer.js";
-export * from "./api.js";
-export * from "./module.js";
+export * from "./api/index.js";
+export * from "./auto-form/index.js";
+export * from "./components/index.js";
+export * from "./data-table/index.js";
+export * from "./shared.js";

package/dist/runtime/types/shared.d.ts

@@ -0,0 +1,5 @@
+import type { ClassValue } from 'tailwind-variants';
+export type ClassNameValue = ClassValue;
+export type ClassNameArray = ClassNameValue[];
+export type SemanticSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+export type SemanticColor = 'primary' | 'info' | 'success' | 'warning' | 'error' | 'neutral';