@zhaoxiangjun/base44-table 项目索引

这是 Base44 React App 和本地 React 项目共用的高级表格组件库。
本项目基于 @tanstack/react-table 和 @zhaoxiangjun/base44-ui，只提供 React 表格 UI、表格交互状态和类型定义，不负责 Base44 SDK、后端接口、密钥、鉴权或业务数据请求。

package: @zhaoxiangjun/base44-table
npm: https://www.npmjs.com/package/@zhaoxiangjun/base44-table
current: 1.1.0（本地待发布）

1. 先看哪份文档

| 你是谁 / 你要做什么 | 应该看 | |---------------------|--------| | Base44 App 开发者 | docs/base44-usage.md | | Base44 AI Controls / AI Agent | docs/base44-usage.md | | 想知道组件怎么 import、props 怎么传 | docs/base44-usage.md | | 想了解表格选型、职责边界和后续规划 | docs/fun/table-selection.md | | 本地运行和验证展示页面 | docs/local-display.md | | 维护、构建、发布 npm 包 | docs/npm-package.md | | 查看当前项目功能与本轮修改内容 | docs/project-status.md | | 查看工程修改记录 | docs/logs/ |

2. 快速安装

Base44 App 通过 npm registry 安装，不使用 git 依赖。

1.1.0 当前仅完成本地发布准备。以下 registry 版本写法在用户发布 1.1.0 后使用；本地联调请按 docs/local-display.md 使用 file: 依赖。

{
  "dependencies": {
    "@zhaoxiangjun/base44-ui": "^1.7.0",
    "@zhaoxiangjun/base44-table": "^1.1.0"
  }
}

入口文件引入样式：

import "@zhaoxiangjun/base44-ui/styles.css";
import "@zhaoxiangjun/base44-table/styles.css";

组件和类型引入：

import { Base44Table, type ColumnDef } from "@zhaoxiangjun/base44-table";

更完整的 props、受控状态、i18n、后端分页和移动端示例见：

docs/base44-usage.md

3. 项目边界

可以包含：
React 高级表格组件
TanStack Table 封装
排序、分页、筛选、列显隐、行选择、固定列、列宽、层级、分组
编辑、CSV、偏好、保存视图、响应式和虚拟滚动
表格状态类型定义
表格 UI 工具函数

不应该包含：
base44.entities 调用
base44.auth 调用
base44.functions.invoke 调用
外部后端接口请求
密钥、Token、API Key
业务专属数据模型
Excel / Word / PDF 文档预览
Konva / Canvas 编辑器
AG Grid 重型数据网格封装

业务逻辑应由使用方通过 props、callbacks、当前 App 的 src/api / src/hooks / src/lib 或 Base44 Backend Functions 接入。

4. 组件分组

Table:
  Base44Table

Types:
  Base44TableProps / Base44TableLabels / Base44TableDensity
  Base44TableColumnMeta / Base44TableSavedView / Base44TableCsvExportOptions
  ColumnDef / SortingState / PaginationState / RowSelectionState / VisibilityState
  ColumnFiltersState / ColumnPinningState / ColumnSizingState / ColumnOrderState
  ExpandedState / GroupingState

Helpers:
  buildTableCsv / downloadTableCsv / getTableExportRows

5. 本地开发

npm install
npm run dev
npm run typecheck
npm test
npm run build
npm pack --dry-run

发布 npm 前必须查看：

docs/npm-package.md

本地展示和验证组件效果见：

docs/local-display.md

当前项目功能、已实现内容和本轮修改说明见：

docs/project-status.md

6. 修改记录

所有重要调整都记录在：

docs/logs/

新增组件、修改公共 API、调整发布流程或重构公共复用逻辑时，都需要新增或更新对应日志。