@dazhicheng/ui 1.6.7 → 1.6.9

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 './column-preferences';
+/** 由封装层固定控制的原生 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>;

package/dist/components/tt-vtable/src/runtime/createVTableController.js

@@ -0,0 +1,238 @@
+import { shallowRef as c, computed as l, watch as a } from "vue";
+import { createTtVTableError as S } from "../public/table-errors.js";
+function ke() {
+  let o, g = [];
+  const h = [], u = c([]), R = c(!1), K = c(), d = c(1), y = c(20), C = c(0), f = c([]), V = c([]), B = c([]), m = c([]), E = c(), w = c(!1), A = c(), q = c([]), L = c([]), p = c(!1), P = c(0), N = c(0), _ = l(() => u.value), O = l(() => u.value.length), z = l(() => C.value), I = l(() => f.value), M = l(() => V.value), k = l(() => B.value), D = l(() => m.value);
+  function r() {
+    if (o) return o;
+    throw S("TT_VTABLE_NOT_READY", "TtVTable controller 尚未绑定存活组件。", {});
+  }
+  function n(e) {
+    if (o) {
+      e(o);
+      return;
+    }
+    h.push(e);
+  }
+  function i(e, t) {
+    return a(e, (s) => t.value = s, { immediate: !0 });
+  }
+  function F() {
+    return (o == null ? void 0 : o.records.getAll()) ?? u.value;
+  }
+  function Q(e) {
+    return o == null ? void 0 : o.records.getByKey(e);
+  }
+  function H(e) {
+    u.value = [...e], n((t) => t.records.replaceAll(e));
+  }
+  function U(e) {
+    n((t) => t.records.append(e));
+  }
+  function W(e, t) {
+    n((s) => s.records.insertAt(e, t));
+  }
+  function Y(e, t, s) {
+    n((v) => v.records.patchByKey(e, t, s));
+  }
+  function j(e) {
+    n((t) => t.records.patchMany(e));
+  }
+  function G(e, t, s, v) {
+    n((we) => we.records.setCellValue(e, t, s, v));
+  }
+  function J(e) {
+    n((t) => t.records.removeByKeys(e));
+  }
+  function X() {
+    return r().query.fetch();
+  }
+  function Z() {
+    return r().query.refresh();
+  }
+  function $() {
+    r().query.cancel();
+  }
+  function T(e) {
+    d.value = e, n((t) => t.pagination.setPage(e));
+  }
+  function x(e) {
+    y.value = e, d.value = 1, n((t) => t.pagination.setPageSize(e));
+  }
+  function b() {
+    n((e) => e.pagination.reset());
+  }
+  function ee(e) {
+    f.value = [...e], n((t) => t.selection.setKeys(e));
+  }
+  function te(e, t) {
+    n((s) => s.selection.toggleKey(e, t));
+  }
+  function ne() {
+    n((e) => e.selection.selectCurrentPage());
+  }
+  function oe() {
+    n((e) => e.selection.selectLoadedRecords());
+  }
+  function ce() {
+    f.value = [], n((e) => e.selection.clear());
+  }
+  function re(e) {
+    m.value = [...e], n((t) => t.columns.replaceAll(e));
+  }
+  function ie(e) {
+    n((t) => t.columns.show(e));
+  }
+  function se(e) {
+    n((t) => t.columns.hide(e));
+  }
+  function le(e, t) {
+    n((s) => s.columns.move(e, t));
+  }
+  function ae() {
+    return r().columns.resetPreferences();
+  }
+  function ue(e, t) {
+    return r().editing.start(e, t);
+  }
+  function de(e) {
+    return r().editing.commit(e);
+  }
+  function fe() {
+    r().editing.cancel();
+  }
+  function ge(e) {
+    return r().editing.validate(e);
+  }
+  function ye(e) {
+    return r().tree.expand(e);
+  }
+  function me(e) {
+    r().tree.collapse(e);
+  }
+  function pe(e) {
+    return r().tree.toggle(e);
+  }
+  function ve(e) {
+    return r().tree.fetchChildren(e);
+  }
+  function he() {
+    r().layout.recalculate();
+  }
+  function Re(e) {
+    r().layout.scrollToRecord(e);
+  }
+  function Ke(e, t) {
+    r().layout.scrollToCell(e, t);
+  }
+  function Ce() {
+    return o == null ? void 0 : o.native.getInstance();
+  }
+  const Ve = {
+    records: {
+      records: _,
+      count: O,
+      getAll: F,
+      getByKey: Q,
+      replaceAll: H,
+      append: U,
+      insertAt: W,
+      patchByKey: Y,
+      patchMany: j,
+      setCellValue: G,
+      removeByKeys: J
+    },
+    query: {
+      isFetching: R,
+      error: K,
+      fetch: X,
+      refresh: Z,
+      cancel: $
+    },
+    pagination: {
+      page: d,
+      pageSize: y,
+      total: z,
+      setPage: T,
+      setPageSize: x,
+      reset: b
+    },
+    selection: {
+      keys: I,
+      loadedRows: M,
+      missingKeys: k,
+      setKeys: ee,
+      toggleKey: te,
+      selectCurrentPage: ne,
+      selectLoadedRecords: oe,
+      clear: ce
+    },
+    columns: {
+      columns: D,
+      replaceAll: re,
+      show: ie,
+      hide: se,
+      move: le,
+      resetPreferences: ae
+    },
+    editing: {
+      activeCell: E,
+      isValidating: w,
+      validationError: A,
+      start: ue,
+      commit: de,
+      cancel: fe,
+      validate: ge
+    },
+    tree: {
+      expandedKeys: q,
+      loadingKeys: L,
+      expand: ye,
+      collapse: me,
+      toggle: pe,
+      fetchChildren: ve
+    },
+    layout: {
+      isReady: p,
+      width: P,
+      height: N,
+      recalculate: he,
+      scrollToRecord: Re,
+      scrollToCell: Ke
+    },
+    native: { getInstance: Ce }
+  };
+  function Be(e) {
+    if (o !== e) {
+      if (o)
+        throw S("TT_VTABLE_CONTROLLER_BOUND", "同一个 controller 不能绑定两个存活表格。", {});
+      o = e, g = [
+        i(e.records.records, u),
+        i(e.query.isFetching, R),
+        i(e.query.error, K),
+        i(e.pagination.page, d),
+        i(e.pagination.pageSize, y),
+        a(e.pagination.total, (t) => C.value = t, { immediate: !0 }),
+        a(e.selection.keys, (t) => f.value = t, { immediate: !0 }),
+        a(e.selection.loadedRows, (t) => V.value = t, { immediate: !0 }),
+        a(e.selection.missingKeys, (t) => B.value = t, { immediate: !0 }),
+        a(e.columns.columns, (t) => m.value = t, { immediate: !0 }),
+        i(e.editing.activeCell, E),
+        i(e.editing.isValidating, w),
+        i(e.editing.validationError, A),
+        i(e.tree.expandedKeys, q),
+        i(e.tree.loadingKeys, L),
+        i(e.layout.isReady, p),
+        i(e.layout.width, P),
+        i(e.layout.height, N)
+      ], h.splice(0).forEach((t) => t(e));
+    }
+  }
+  function Ee(e) {
+    o === e && (g.forEach((t) => t()), g = [], o = void 0, p.value = !1);
+  }
+  return { tableApi: Ve, bind: Be, unbind: Ee };
+}
+export {
+  ke as createVTableController
+};

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

@@ -0,0 +1,79 @@
+import { ListTable } from '@visactor/vtable';
+import { ComputedRef, Ref } from 'vue';
+import { TtVTableApi, TtVTableColumn, TtVTableEditCommit, TtVTableFeatureOptions, TtVTableFetchRecords, TtVTableFetchRequest, TtVTableFetchResponse, TtVTableMutationMode, TtVTableNativeEvents, TtVTablePageChange, TtVTableRecordChange, TtVTableRowKey, TtVTableRowKeySource, TtVTableSortDescriptor, TtVTableTreeLoadError, TtVTableTreeLoadSuccess } from '../public';
+/** 封装层内部选择列使用的稳定字段。 */
+export declare const TT_VTABLE_SELECTION_FIELD = "__tt_vtable_selection__";
+/** 创建运行时所需的响应式输入。 */
+export interface CreateVTableRuntimeOptions<Row extends Record<string, unknown>, Key extends TtVTableRowKey = TtVTableRowKey, QueryParams extends Record<string, unknown> = Record<string, unknown>> {
+    /** 初始本地记录根快照。 */
+    records?: readonly Row[];
+    /** 读取最新本地记录根快照。 */
+    getRecords: () => readonly Row[] | undefined;
+    /** 读取最新语义列根。 */
+    getColumns: () => readonly TtVTableColumn<Row, Key>[];
+    /** 业务主键字段路径或读取函数。 */
+    rowKey: TtVTableRowKeySource<Row, Key>;
+    /** 当前受控选择主键。 */
+    selectedRowKeys: Ref<Key[]>;
+    /** 读取最新查询参数根。 */
+    getQueryParams: () => QueryParams;
+    /** 读取最新 feature 配置。 */
+    getFeatures: () => TtVTableFeatureOptions<Row, Key> | undefined;
+    /** 读取最新原生事件。 */
+    getNativeEvents: () => TtVTableNativeEvents | undefined;
+    /** 远程记录请求。 */
+    fetchRecords?: TtVTableFetchRecords<Row, QueryParams>;
+    /** 记录所有权策略。 */
+    mutationMode?: TtVTableMutationMode;
+    /** 精确记录变化回调。 */
+    onRecordChange?: (change: TtVTableRecordChange<Row, Key>) => void;
+    /** 最新远程请求成功回调。 */
+    onFetchSuccess?: (response: TtVTableFetchResponse<Row>, request: TtVTableFetchRequest<QueryParams>) => void;
+    /** 最新远程请求失败回调。 */
+    onFetchError?: (error: Error, request: TtVTableFetchRequest<QueryParams>) => void;
+    /** 分页变化回调。 */
+    onPageChange?: (change: TtVTablePageChange) => void;
+    /** 排序变化回调。 */
+    onSortChange?: (sort: readonly TtVTableSortDescriptor[]) => void;
+    /** 筛选变化回调。 */
+    onFilterChange?: (filters: Readonly<Record<string, unknown>>) => void;
+    /** 编辑提交回调。 */
+    onEditCommit?: (change: TtVTableEditCommit<Key>) => void;
+    /** 编辑失败回调。 */
+    onEditError?: (error: Error) => void;
+    /** 树子节点加载成功回调。 */
+    onTreeLoadSuccess?: (change: TtVTableTreeLoadSuccess<Row, Key>) => void;
+    /** 树子节点加载失败回调。 */
+    onTreeLoadError?: (failure: TtVTableTreeLoadError<Key>) => void;
+    /** 列偏好变化回调。 */
+    onColumnPreferencesChange?: (preferences: unknown) => void;
+}
+/** 运行时暴露给组件层的状态与生命周期。 */
+export interface TtVTableRuntime<Row extends Record<string, unknown>, Key extends TtVTableRowKey = TtVTableRowKey, QueryParams extends Record<string, unknown> = Record<string, unknown>> {
+    /** 稳定公共 API。 */
+    tableApi: TtVTableApi<Row, Key>;
+    /** 传给原生视口的列，包含内部选择列。 */
+    renderColumns: ComputedRef<readonly TtVTableColumn<Row, Key>[]>;
+    /** 当前是否使用远程记录源。 */
+    isRemote: boolean;
+    /** 当前选择模式。 */
+    selectionMode: ComputedRef<"multiple" | "none" | "single">;
+    /** 当前查询排序。 */
+    sort: Readonly<Ref<readonly TtVTableSortDescriptor[]>>;
+    /** 当前查询筛选。 */
+    filters: Readonly<Ref<Readonly<Record<string, unknown>>>>;
+    /** 从运行时记录读取稳定业务主键。 */
+    getRowKey: (record: Row) => Key;
+    /** 视口获得原生实例后的入口。 */
+    acceptNativeInstance: (table: ListTable) => void;
+    /** 视口释放原生实例引用。 */
+    clearNativeInstance: (table: ListTable) => void;
+    /** 更新视口测量尺寸。 */
+    acceptViewportSize: (width: number, height: number) => void;
+    /** 外部 records 根替换入口。 */
+    acceptRecords: (records: readonly Row[]) => void;
+    /** 释放运行时及异步任务。 */
+    release: () => void;
+}
+/** 创建不依赖原生实例的稳定 TtVTable 运行时。 */
+export declare function createVTableRuntime<Row extends Record<string, unknown>, Key extends TtVTableRowKey = TtVTableRowKey, QueryParams extends Record<string, unknown> = Record<string, unknown>>(options: CreateVTableRuntimeOptions<Row, Key, QueryParams>): TtVTableRuntime<Row, Key, QueryParams>;