@dazhicheng/ui 1.6.6 → 1.6.8

package/dist/components/tt-vtable/src/public/table-column.d.ts

@@ -0,0 +1,123 @@
+import { ColumnDefine, ListTable } from '@visactor/vtable';
+import { VNodeChild } from 'vue';
+import { TtVTableApi, TtVTableFieldPath, TtVTableRowKey } from './table-api';
+/** 需要由封装层控制的原生列字段。 */
+type TtVTableReservedNativeColumnKey = "columns" | "field" | "key" | "title";
+/** 对联合类型的每个成员分别移除字段。 */
+type OmitUnion<Union, Key extends PropertyKey> = Union extends unknown ? Omit<Union, Extract<keyof Union, Key>> : never;
+/** 允许业务透传的原生 VTable 列配置。 */
+export type TtVTableNativeColumnOptions = OmitUnion<ColumnDefine, TtVTableReservedNativeColumnKey>;
+/** 不依赖 VisActor 内部声明的单元格矩形。 */
+export interface TtVTableCellRect {
+    /** 左边界。 */
+    left: number;
+    /** 右边界。 */
+    right: number;
+    /** 上边界。 */
+    top: number;
+    /** 下边界。 */
+    bottom: number;
+    /** 矩形宽度。 */
+    width: number;
+    /** 矩形高度。 */
+    height: number;
+}
+/** Vue 单元格额外暴露的原生坐标上下文。 */
+export interface TtVTableNativeCellContext {
+    /** 原生列坐标。 */
+    col: number;
+    /** 原生行坐标。 */
+    row: number;
+    /** 当前原生表格实例。 */
+    table: ListTable;
+    /** 原生单元格矩形。 */
+    rect?: TtVTableCellRect;
+}
+/** Vue 正文 renderer 的标准上下文。 */
+export interface TtVTableCellRenderContext<Row extends Record<string, unknown>, Key extends TtVTableRowKey = TtVTableRowKey> {
+    /** 当前运行时记录。 */
+    record: Readonly<Row>;
+    /** 当前记录稳定主键。 */
+    rowKey: Key;
+    /** 当前显示顺序，只能用于展示。 */
+    rowIndex: number;
+    /** 当前语义列。 */
+    column: Readonly<TtVTableColumn<Row, Key>>;
+    /** 当前字段路径。 */
+    field?: TtVTableFieldPath;
+    /** 当前原始值。 */
+    value: unknown;
+    /** 当前表格稳定公共 API。 */
+    tableApi: TtVTableApi<Row, Key>;
+    /** 通过 records feature 精确修改当前单元格。 */
+    setCellValue: (value: unknown) => void;
+    /** 需要原生坐标时使用的高级上下文。 */
+    nativeContext: TtVTableNativeCellContext;
+}
+/** Vue 表头 renderer 的标准上下文。 */
+export interface TtVTableHeaderRenderContext<Row extends Record<string, unknown>, Key extends TtVTableRowKey = TtVTableRowKey> {
+    /** 当前语义列。 */
+    column: Readonly<TtVTableColumn<Row, Key>>;
+    /** 当前表格稳定公共 API。 */
+    tableApi: TtVTableApi<Row, Key>;
+    /** 需要原生坐标时使用的高级上下文。 */
+    nativeContext: TtVTableNativeCellContext;
+}
+/** 正文 Vue DOM renderer，可使用内联 JSX 回调或命名插槽。 */
+export interface TtVTableVueRenderer<Row extends Record<string, unknown>, Key extends TtVTableRowKey = TtVTableRowKey> {
+    /** 固定为 Vue DOM 渲染通道。 */
+    kind: "vue";
+    /** 内联 Vue render/JSX 回调。 */
+    render?: (context: TtVTableCellRenderContext<Row, Key>) => VNodeChild;
+    /** 命名插槽。 */
+    slot?: string;
+    /** 是否允许 DOM 接收鼠标和键盘交互。 */
+    interactive?: boolean;
+    /** 当前列建议保留的最大 DOM 缓存数。 */
+    maxCacheCount?: number;
+}
+/** 表头 Vue DOM renderer，可使用内联 JSX 回调或命名插槽。 */
+export interface TtVTableVueHeaderRenderer<Row extends Record<string, unknown>, Key extends TtVTableRowKey = TtVTableRowKey> {
+    /** 固定为 Vue DOM 渲染通道。 */
+    kind: "vue";
+    /** 内联 Vue render/JSX 回调。 */
+    render?: (context: TtVTableHeaderRenderContext<Row, Key>) => VNodeChild;
+    /** 命名插槽。 */
+    slot?: string;
+    /** 是否允许 DOM 接收鼠标和键盘交互。 */
+    interactive?: boolean;
+    /** 当前表头建议保留的最大 DOM 缓存数。 */
+    maxCacheCount?: number;
+}
+/** TtVTable 的语义列定义。 */
+export interface TtVTableColumn<Row extends Record<string, unknown> = Record<string, unknown>, Key extends TtVTableRowKey = TtVTableRowKey> {
+    /** 整棵列树中唯一且稳定的语义键。 */
+    key: string;
+    /** 业务字段或嵌套字段路径。 */
+    field?: TtVTableFieldPath;
+    /** 默认 Canvas 表头文字。 */
+    title?: string;
+    /** 固定列宽。 */
+    width?: number | string;
+    /** 最小列宽。 */
+    minWidth?: number | string;
+    /** 最大列宽。 */
+    maxWidth?: number | string;
+    /** 正文对齐方式。 */
+    align?: "center" | "left" | "right";
+    /** 是否隐藏该列。 */
+    visible?: boolean;
+    /** 冻结列位置。 */
+    frozen?: boolean | "left" | "right";
+    /** 是否作为树结构展示列。 */
+    tree?: boolean;
+    /** 嵌套表头子列。 */
+    columns?: readonly TtVTableColumn<Row, Key>[];
+    /** 复杂正文启用的 Vue DOM renderer。 */
+    renderer?: TtVTableVueRenderer<Row, Key>;
+    /** 复杂表头启用的 Vue DOM renderer。 */
+    headerRenderer?: TtVTableVueHeaderRenderer<Row, Key>;
+    /** Canvas、VRender 和其他原生列能力的受控透传配置。 */
+    native?: TtVTableNativeColumnOptions;
+}
+export {};

package/dist/components/tt-vtable/src/public/table-errors.d.ts

@@ -0,0 +1,26 @@
+/** TtVTable 可识别的语义错误码。 */
+export type TtVTableErrorCode = "TT_VTABLE_SOURCE_CONFLICT" | "TT_VTABLE_ROW_KEY_REQUIRED" | "TT_VTABLE_ROW_KEY_INVALID" | "TT_VTABLE_DUPLICATE_ROW_KEY" | "TT_VTABLE_DUPLICATE_COLUMN_KEY" | "TT_VTABLE_CONTAINER_SIZE_INVALID" | "TT_VTABLE_RENDERER_INVALID" | "TT_VTABLE_SLOT_MISSING" | "TT_VTABLE_NATIVE_OPTION_RESERVED" | "TT_VTABLE_NATIVE_EVENT_RESERVED" | "TT_VTABLE_RECORD_NOT_FOUND" | "TT_VTABLE_NOT_READY" | "TT_VTABLE_CONTROLLER_BOUND" | "TT_VTABLE_RELEASED" | "TT_VTABLE_INIT_FAILED" | "TT_VTABLE_FETCH_FAILED" | "TT_VTABLE_TREE_FETCH_FAILED" | "TT_VTABLE_EDIT_VALIDATION_FAILED";
+/** 错误附带的结构化上下文。 */
+export type TtVTableErrorContext = Readonly<Record<string, unknown>>;
+/** TtVTable 对外抛出的语义错误。 */
+export declare class TtVTableError extends Error {
+    /** 稳定错误码。 */
+    readonly code: TtVTableErrorCode;
+    /** 帮助定位配置或运行状态的上下文。 */
+    readonly context: TtVTableErrorContext;
+    /**
+     * 创建一个带稳定错误码的表格错误。
+     * @param code 稳定错误码
+     * @param message 可读错误说明
+     * @param context 结构化上下文
+     */
+    constructor(code: TtVTableErrorCode, message: string, context?: TtVTableErrorContext);
+}
+/**
+ * 创建一个 TtVTable 语义错误。
+ * @param code 稳定错误码
+ * @param message 可读错误说明
+ * @param context 结构化上下文
+ * @returns 新建的语义错误
+ */
+export declare function createTtVTableError(code: TtVTableErrorCode, message: string, context?: TtVTableErrorContext): TtVTableError;

package/dist/components/tt-vtable/src/public/table-errors.js

@@ -0,0 +1,26 @@
+var s = Object.defineProperty;
+var a = (e, r, t) => r in e ? s(e, r, { enumerable: !0, configurable: !0, writable: !0, value: t }) : e[r] = t;
+var o = (e, r, t) => a(e, typeof r != "symbol" ? r + "" : r, t);
+class T extends Error {
+  /**
+   * 创建一个带稳定错误码的表格错误。
+   * @param code 稳定错误码
+   * @param message 可读错误说明
+   * @param context 结构化上下文
+   */
+  constructor(t, n, c = {}) {
+    super(`[${t}] ${n}`);
+    /** 稳定错误码。 */
+    o(this, "code");
+    /** 帮助定位配置或运行状态的上下文。 */
+    o(this, "context");
+    this.name = "TtVTableError", this.code = t, this.context = c;
+  }
+}
+function l(e, r, t = {}) {
+  return new T(e, r, t);
+}
+export {
+  T as TtVTableError,
+  l as createTtVTableError
+};

package/dist/components/tt-vtable/src/public/table-events.d.ts

@@ -0,0 +1,69 @@
+import { TtVTableApi, TtVTableFieldPath, TtVTableRecordChange, TtVTableRowKey, TtVTableSortDescriptor } from './table-api';
+import { TtVTableFetchRequest, TtVTableFetchResponse } from './table-props';
+/** 分页变化来源。 */
+export type TtVTablePageChangeReason = "page" | "page-size" | "reset";
+/** 分页变化事件载荷。 */
+export interface TtVTablePageChange {
+    /** 当前页码。 */
+    page: number;
+    /** 当前每页记录数。 */
+    pageSize: number;
+    /** 本次变化来源。 */
+    reason: TtVTablePageChangeReason;
+}
+/** 编辑提交事件载荷。 */
+export interface TtVTableEditCommit<Key extends TtVTableRowKey = TtVTableRowKey> {
+    /** 业务记录主键。 */
+    rowKey: Key;
+    /** 修改字段路径。 */
+    field: TtVTableFieldPath;
+    /** 修改前的值。 */
+    previousValue: unknown;
+    /** 已提交值。 */
+    value: unknown;
+    /** 本次修改涉及的字段。 */
+    changedFields: readonly TtVTableFieldPath[];
+    /** 固定编辑来源。 */
+    source: "editing";
+}
+/** 树子节点加载成功事件载荷。 */
+export interface TtVTableTreeLoadSuccess<Row, Key extends TtVTableRowKey = TtVTableRowKey> {
+    /** 父节点主键。 */
+    parentKey: Key;
+    /** 已写入运行时的子记录。 */
+    children: readonly Row[];
+}
+/** 树子节点加载失败事件载荷。 */
+export interface TtVTableTreeLoadError<Key extends TtVTableRowKey = TtVTableRowKey> {
+    /** 父节点主键。 */
+    parentKey: Key;
+    /** 规范化后的请求错误。 */
+    error: Error;
+}
+/** TtVTable 允许公开的语义事件。 */
+export interface TtVTableEmits<Row extends Record<string, unknown> = Record<string, unknown>, Key extends TtVTableRowKey = TtVTableRowKey, QueryParams extends Record<string, unknown> = Record<string, unknown>> {
+    /** 原生实例与全部 feature 已经就绪。 */
+    ready: [tableApi: TtVTableApi<Row, Key>];
+    /** records API 或 Vue renderer 提交了精确记录变化。 */
+    "record-change": [change: TtVTableRecordChange<Row, Key>];
+    /** 最新远程请求成功。 */
+    "fetch-success": [response: TtVTableFetchResponse<Row>, request: TtVTableFetchRequest<QueryParams>];
+    /** 最新远程请求失败。 */
+    "fetch-error": [error: Error, request: TtVTableFetchRequest<QueryParams>];
+    /** 分页状态发生语义变化。 */
+    "page-change": [change: TtVTablePageChange];
+    /** 排序状态发生语义变化。 */
+    "sort-change": [sort: readonly TtVTableSortDescriptor[]];
+    /** 筛选状态发生语义变化。 */
+    "filter-change": [filters: Readonly<Record<string, unknown>>];
+    /** 编辑器成功提交。 */
+    "edit-commit": [change: TtVTableEditCommit<Key>];
+    /** 编辑校验或提交失败。 */
+    "edit-error": [error: Error];
+    /** 树子节点成功写入。 */
+    "tree-load-success": [change: TtVTableTreeLoadSuccess<Row, Key>];
+    /** 树子节点加载失败。 */
+    "tree-load-error": [failure: TtVTableTreeLoadError<Key>];
+    /** 列偏好发生语义变化。 */
+    "column-preferences-change": [preferences: unknown];
+}

package/dist/components/tt-vtable/src/public/table-props.d.ts

@@ -0,0 +1,216 @@
+import { ListTableConstructorOptions, TYPES } from '@visactor/vtable';
+import { TtVTableFieldPath, TtVTableMutationMode, TtVTableRowKey, TtVTableSortDescriptor } from './table-api';
+import { TtVTableColumn } from './table-column';
+import { VTableColumnPreferenceStorage } from '../features/column-preferences/column-preference-storage';
+/** 由封装层固定控制的原生 options 字段。 */
+export type TtVTableReservedNativeOptionKey = "columns" | "pagination" | "records";
+/** 由封装层固定控制的 customConfig 字段。 */
+export type TtVTableReservedCustomConfigKey = "createReactContainer";
+/** 由封装层独占的原生事件。 */
+export type TtVTableReservedNativeEventName = "change_cell_value" | "change_cell_values" | "checkbox_state_change" | "radio_state_change" | "tree_hierarchy_state_change";
+/** 官方声明之外由 Vue DOM 插件读取的 customConfig 扩展。 */
+export interface TtVTableVueBridgeCustomConfig {
+    /** Vue DOM 插件允许保留的最大缓存数量。 */
+    maxDomCacheCount?: number;
+    /** 延迟读取当前 Vue appContext。 */
+    getVueUserAppContext?: () => unknown;
+}
+/** 允许业务配置且不会覆盖受控状态的 customConfig。 */
+export type TtVTableNativeCustomConfig = Omit<NonNullable<ListTableConstructorOptions["customConfig"]>, TtVTableReservedCustomConfigKey> & TtVTableVueBridgeCustomConfig;
+/** 允许业务透传的原生 ListTable options。 */
+export type TtVTableNativeOptions = Omit<ListTableConstructorOptions, TtVTableReservedNativeOptionKey | "customConfig"> & {
+    /** 不允许覆盖 createReactContainer 的原生扩展配置。 */
+    customConfig?: TtVTableNativeCustomConfig;
+};
+/** 单个原生事件监听函数。 */
+export type TtVTableNativeEventListener<EventName extends keyof TYPES.TableEventHandlersEventArgumentMap> = (event: TYPES.TableEventHandlersEventArgumentMap[EventName]) => void;
+/** 允许业务监听且不会绕过受控 feature 的原生事件。 */
+export type TtVTableNativeEvents = Partial<{
+    [EventName in Exclude<keyof TYPES.TableEventHandlersEventArgumentMap, TtVTableReservedNativeEventName>]: TtVTableNativeEventListener<EventName>;
+}>;
+/** 业务主键字段路径或读取函数。 */
+export type TtVTableRowKeySource<Row, Key extends TtVTableRowKey = TtVTableRowKey> = TtVTableFieldPath | ((record: Readonly<Row>) => Key);
+/** 一次远程 records 请求的完整上下文。 */
+export interface TtVTableFetchRequest<QueryParams extends Record<string, unknown>> {
+    /** 当前页码，起始值为 1。 */
+    page: number;
+    /** 当前每页记录数。 */
+    pageSize: number;
+    /** 不可变查询参数根快照。 */
+    queryParams: Readonly<QueryParams>;
+    /** 当前排序条件。 */
+    sort: readonly TtVTableSortDescriptor[];
+    /** 当前筛选条件。 */
+    filters: Readonly<Record<string, unknown>>;
+    /** 新请求或释放时会终止的信号。 */
+    signal: AbortSignal;
+}
+/** 一次远程 records 请求的返回值。 */
+export interface TtVTableFetchResponse<Row> {
+    /** 当前页记录。 */
+    records: readonly Row[];
+    /** 服务端结果总数。 */
+    total: number;
+}
+/** 远程 records 请求函数。 */
+export type TtVTableFetchRecords<Row, QueryParams extends Record<string, unknown>> = (request: TtVTableFetchRequest<QueryParams>) => Promise<TtVTableFetchResponse<Row>>;
+/** 编辑校验上下文。 */
+export interface TtVTableEditValidationContext<Row, Key extends TtVTableRowKey = TtVTableRowKey> {
+    /** 当前运行时记录。 */
+    record: Readonly<Row>;
+    /** 当前业务主键。 */
+    rowKey: Key;
+    /** 当前字段路径。 */
+    field: TtVTableFieldPath;
+    /** 开始编辑时的值。 */
+    previousValue: unknown;
+    /** 待提交值。 */
+    value: unknown;
+}
+/** 编辑校验函数。 */
+export type TtVTableEditValidator<Row, Key extends TtVTableRowKey = TtVTableRowKey> = (context: TtVTableEditValidationContext<Row, Key>) => boolean | Promise<boolean | string | undefined | void> | string | undefined | void;
+/** 懒加载树节点的请求上下文。 */
+export interface TtVTableTreeChildrenRequest<Row, Key extends TtVTableRowKey = TtVTableRowKey> {
+    /** 当前父记录。 */
+    parent: Readonly<Row>;
+    /** 当前父记录主键。 */
+    parentKey: Key;
+    /** records 换根或释放时会终止的信号。 */
+    signal: AbortSignal;
+}
+/** 单选和多选配置。 */
+export interface TtVTableSelectionOptions<Row> {
+    /** 选择模式。 */
+    mode?: "multiple" | "none" | "single";
+    /** 是否保留当前页之外的已选主键。 */
+    reserveAcrossPages?: boolean;
+    /** 是否启用树节点父子级联。 */
+    cascade?: boolean;
+    /** 业务行是否允许选择。 */
+    isRowSelectable?: (record: Readonly<Row>) => boolean;
+}
+/** Element Plus 分页组件的语义配置。 */
+export interface TtVTablePaginationOptions {
+    /** 初始页码。 */
+    page?: number;
+    /** 初始每页记录数。 */
+    pageSize?: number;
+    /** 可选每页记录数集合。 */
+    pageSizes?: readonly number[];
+    /** ElPagination layout。 */
+    layout?: string;
+    /** 是否使用带背景的分页按钮。 */
+    background?: boolean;
+    /** 仅一页时是否隐藏分页。 */
+    hideOnSinglePage?: boolean;
+}
+/** 远程查询策略。 */
+export interface TtVTableQueryOptions {
+    /** 挂载后是否立即发起首次请求。 */
+    immediate?: boolean;
+    /** 排序变化时是否回到第一页。 */
+    resetPageOnSort?: boolean;
+    /** 筛选变化时是否回到第一页。 */
+    resetPageOnFilter?: boolean;
+}
+/** 单元格编辑配置。 */
+export interface TtVTableEditingOptions<Row, Key extends TtVTableRowKey = TtVTableRowKey> {
+    /** 允许开始编辑的交互方式。 */
+    trigger?: "click" | "doubleclick" | "api" | readonly ("api" | "click" | "doubleclick")[];
+    /** 按字段路径配置校验函数。 */
+    validators?: Readonly<Record<string, TtVTableEditValidator<Row, Key>>>;
+}
+/** 树结构配置。 */
+export interface TtVTableTreeOptions<Row, Key extends TtVTableRowKey = TtVTableRowKey> {
+    /** 子节点字段路径。 */
+    childrenField?: string;
+    /** 初始展开节点主键。 */
+    defaultExpandedKeys?: readonly Key[];
+    /** 是否复用已经加载的子节点。 */
+    cacheChildren?: boolean;
+    /** 异步加载子节点。 */
+    fetchTreeChildren?: (request: TtVTableTreeChildrenRequest<Row, Key>) => Promise<readonly Row[]>;
+}
+/** 列偏好配置。 */
+export interface TtVTableColumnPreferenceOptions {
+    /** 是否保存列显隐、顺序、宽度和冻结状态。 */
+    persistent?: boolean;
+    /** 页面和用户维度唯一的列配置键。 */
+    columnsKey?: string;
+    /** 持久化结构版本。 */
+    schemaVersion?: number;
+    /** 高频列宽和拖拽写入的合并时长。 */
+    writeDelay?: number;
+    /** 可替换为服务端实现的列偏好存储。 */
+    storage?: VTableColumnPreferenceStorage;
+}
+/** 工具栏配置。 */
+export interface TtVTableToolbarOptions {
+    /** 是否显示刷新命令。 */
+    refresh?: boolean;
+    /** 是否显示列设置命令。 */
+    columns?: boolean;
+}
+/** TtVTable 可组合 feature 配置。 */
+export interface TtVTableFeatureOptions<Row extends Record<string, unknown>, Key extends TtVTableRowKey = TtVTableRowKey> {
+    /** 单选和多选。 */
+    selection?: TtVTableSelectionOptions<Row>;
+    /** Element Plus 分页。 */
+    pagination?: false | TtVTablePaginationOptions;
+    /** 远程查询。 */
+    query?: TtVTableQueryOptions;
+    /** 单元格编辑。 */
+    editing?: false | TtVTableEditingOptions<Row, Key>;
+    /** 树结构与懒加载。 */
+    tree?: false | TtVTableTreeOptions<Row, Key>;
+    /** 列偏好。 */
+    columnPreferences?: false | TtVTableColumnPreferenceOptions;
+    /** 工具栏。 */
+    toolbar?: false | TtVTableToolbarOptions;
+}
+/** Vue DOM 渲染通道配置。 */
+export interface TtVTableRenderingOptions {
+    /** 全表 Vue DOM 缓存上限。 */
+    maxDomCacheCount?: number;
+}
+/** 本地和远程来源共享的 props。 */
+export interface TtVTableSharedProps<Row extends Record<string, unknown>, Key extends TtVTableRowKey = TtVTableRowKey, QueryParams extends Record<string, unknown> = Record<string, unknown>> {
+    /** 语义列配置。 */
+    columns: readonly TtVTableColumn<Row, Key>[];
+    /** 业务主键字段路径或读取函数。 */
+    rowKey: TtVTableRowKeySource<Row, Key>;
+    /** 远程查询参数，只监听根引用。 */
+    queryParams?: QueryParams;
+    /** 当前选择主键，由 v-model:selected-row-keys 管理。 */
+    selectedRowKeys?: readonly Key[];
+    /** 可组合 feature 配置。 */
+    features?: TtVTableFeatureOptions<Row, Key>;
+    /** 记录所有权策略。 */
+    mutationMode?: TtVTableMutationMode;
+    /** Vue DOM 渲染配置。 */
+    rendering?: TtVTableRenderingOptions;
+    /** 未封装的安全原生 options。 */
+    nativeOptions?: TtVTableNativeOptions;
+    /** 未被 feature 独占的原生事件。 */
+    nativeEvents?: TtVTableNativeEvents;
+    /** 表格容器宽度。 */
+    width?: number | string;
+    /** 表格容器高度。 */
+    height?: number | string;
+}
+/** 本地 records 来源。 */
+export interface TtVTableLocalSourceProps<Row> {
+    /** 调用方持有的本地根快照。 */
+    records?: readonly Row[];
+    /** 本地模式不允许配置远程请求。 */
+    fetchRecords?: never;
+}
+/** 远程 records 来源。 */
+export interface TtVTableRemoteSourceProps<Row, QueryParams extends Record<string, unknown>> {
+    /** 远程模式不接受本地根快照。 */
+    records?: never;
+    /** 远程记录请求函数。 */
+    fetchRecords: TtVTableFetchRecords<Row, QueryParams>;
+}
+/** TtVTable 完整 props。 */
+export type TtVTableProps<Row extends Record<string, unknown> = Record<string, unknown>, Key extends TtVTableRowKey = TtVTableRowKey, QueryParams extends Record<string, unknown> = Record<string, unknown>> = TtVTableSharedProps<Row, Key, QueryParams> & (TtVTableLocalSourceProps<Row> | TtVTableRemoteSourceProps<Row, QueryParams>);

package/dist/components/tt-vtable/src/public/table-slots.d.ts

@@ -0,0 +1,37 @@
+import { VNodeChild } from 'vue';
+import { TtVTableCellRenderContext, TtVTableHeaderRenderContext } from './table-column';
+import { TtVTableApi, TtVTableRowKey } from './table-api';
+/** Vue DOM 正文命名插槽。 */
+export type TtVTableCellSlot<Row extends Record<string, unknown>, Key extends TtVTableRowKey = TtVTableRowKey> = (context: TtVTableCellRenderContext<Row, Key>) => VNodeChild;
+/** Vue DOM 表头命名插槽。 */
+export type TtVTableHeaderSlot<Row extends Record<string, unknown>, Key extends TtVTableRowKey = TtVTableRowKey> = (context: TtVTableHeaderRenderContext<Row, Key>) => VNodeChild;
+/** 空状态插槽上下文。 */
+export interface TtVTableEmptySlotContext<Row extends Record<string, unknown>, Key extends TtVTableRowKey = TtVTableRowKey> {
+    /** 当前稳定表格 API。 */
+    tableApi: TtVTableApi<Row, Key>;
+}
+/** 错误状态插槽上下文。 */
+export interface TtVTableErrorSlotContext<Row extends Record<string, unknown>, Key extends TtVTableRowKey = TtVTableRowKey> {
+    /** 当前错误。 */
+    error: Error;
+    /** 当前稳定表格 API。 */
+    tableApi: TtVTableApi<Row, Key>;
+    /** 重新执行当前查询。 */
+    retry: () => Promise<boolean>;
+}
+/** 工具栏插槽上下文。 */
+export interface TtVTableToolbarSlotContext<Row extends Record<string, unknown>, Key extends TtVTableRowKey = TtVTableRowKey> {
+    /** 当前稳定表格 API。 */
+    tableApi: TtVTableApi<Row, Key>;
+}
+/** 传给 VTableViewport 的动态 Vue renderer 集合。 */
+export type TtVTableRendererSlots<Row extends Record<string, unknown>, Key extends TtVTableRowKey = TtVTableRowKey> = Readonly<Record<string, TtVTableCellSlot<Row, Key> | TtVTableHeaderSlot<Row, Key>>>;
+/** TtVTable 固定界面插槽。 */
+export interface TtVTableSlots<Row extends Record<string, unknown> = Record<string, unknown>, Key extends TtVTableRowKey = TtVTableRowKey> {
+    /** 工具栏业务命令。 */
+    toolbar?: (context: TtVTableToolbarSlotContext<Row, Key>) => VNodeChild;
+    /** 空记录状态。 */
+    empty?: (context: TtVTableEmptySlotContext<Row, Key>) => VNodeChild;
+    /** 首次加载失败状态。 */
+    error?: (context: TtVTableErrorSlotContext<Row, Key>) => VNodeChild;
+}

package/dist/components/tt-vtable/src/runtime/createVTableController.d.ts

@@ -0,0 +1,12 @@
+import { TtVTableApi, TtVTableRowKey } from '../public';
+/** useVTable 与一个存活组件之间的稳定绑定控制器。 */
+export interface TtVTableController<Row extends Record<string, unknown>, Key extends TtVTableRowKey = TtVTableRowKey> {
+    /** 从创建开始保持引用不变的公共 API。 */
+    tableApi: TtVTableApi<Row, Key>;
+    /** 绑定一个组件创建的真实 API。 */
+    bind: (tableApi: TtVTableApi<Row, Key>) => void;
+    /** 解绑即将卸载的组件 API。 */
+    unbind: (tableApi: TtVTableApi<Row, Key>) => void;
+}
+/** 创建一个可在组件挂载前返回稳定 API 的控制器。 */
+export declare function createVTableController<Row extends Record<string, unknown>, Key extends TtVTableRowKey = TtVTableRowKey>(): TtVTableController<Row, Key>;