@wordrhyme/auto-crud 1.12.2 → 1.14.0

package/README.md

@@ -172,20 +172,20 @@ Zod Schema → 自动推断字段类型 → 生成表格列 + 表单字段
 ```typescript
 import { createMemoryDataSource } from '@wordrhyme/auto-crud';
 
-const dataSource = createMemoryDataSource({
-  data: initialData,
-  onCreate: async (data) => {
-    /* ... */
-  },
-  onUpdate: async (id, data) => {
-    /* ... */
-  },
-  onDelete: async (id) => {
-    /* ... */
-  },
+const dataSource = createMemoryDataSource(initialData);
+const result = await dataSource.list({
+  page: 1,
+  perPage: 10,
+  filters: [{ id: 'status', operator: 'inArray', value: ['draft', 'published'] }],
+  sort: [
+    { id: 'createdAt', desc: true },
+    { id: 'id', desc: false },
+  ],
 });
 ```
 
+筛选支持省略 operator / `eq`（严格相等）和 `inArray`（字段值属于给定数组）；其他 operator 会报错。排序按配置顺序比较，前一字段相同时使用下一字段，再进行分页。内存数据源不执行全文搜索。
+
 #### 2. tRPC 数据源（tRPC Data Source）
 
 适合：全栈 TypeScript 项目
@@ -278,6 +278,8 @@ interface AutoCrudTableProps<TSchema> {
   form?: {
     overrides?: Record<string, any>; // 表单覆盖配置
     columns?: number; // 表单列数
+    labelAlign?: 'left' | 'top' | 'right'; // 默认 top；left/right 为左右布局及标签文字对齐
+    labelWidth?: number | string; // 左右布局的标签宽度，数字单位为 px
   };
   /**
    * 行操作配置，或统一配置 toolbar/row/batch。
@@ -326,6 +328,37 @@ interface AutoCrudTableProps<TSchema> {
 
 `expandedRow` 的第二个参数是当前 TanStack `Row`，可通过 `row.getAllCells()` 读取已解析的列和单元格上下文，复用字段渲染器及数据源标签。只接收订单数据的单参数回调仍可使用。
 
+#### 表格状态与 URL 参数
+
+同页显示多个表格时，在资源 Hook 中配置独立的分页、排序和条件连接符参数名，`AutoCrudTable` 会自动传给表格：
+
+```tsx
+const resource = useAutoCrudResource({
+  router: trpc.orders,
+  schema: orderSchema,
+  queryKeys: {
+    page: 'ordersPage',
+    perPage: 'ordersSize',
+    sort: 'ordersSort',
+    joinOperator: 'ordersJoin',
+  },
+});
+
+<AutoCrudTable
+  id="orders"
+  schema={orderSchema}
+  resource={resource}
+  table={{
+    enableRowSelection: false,
+    initialColumnVisibility: { createdAt: false },
+  }}
+/>;
+```
+
+未配置的参数名保留默认值。搜索仍使用共享的 `search` 参数，字段筛选仍使用字段名；`queryKeys` 不隔离这些值。筛选或搜索变化时，仅重置该表格对应的页码。直接使用 `AutoTable` 时传入相同的 `queryKeys`；`table.queryKeys` 可覆盖资源提供的整组配置。
+
+`enableRowSelection` 默认 `true`，设为 `false` 后关闭行选择并隐藏选择列和批量操作栏。`initialColumnVisibility` 只设置首次显示的列，用户仍可通过列设置切换；它不同于 `table.hidden` 对列的排除。
+
 ### `useAutoCrudResource()`
 
 连接数据源到组件的 Hook。
@@ -1509,27 +1542,39 @@ function CustomTable({ data }) {
 ### 使用 AutoForm 组件
 
 ```typescript
-import { AutoForm, createFormSchema } from "@wordrhyme/auto-crud";
-import { createForm } from "@formily/core";
+import { AutoForm } from "@wordrhyme/auto-crud";
 
 function CustomForm() {
-  const form = createForm();
-  const formSchema = createFormSchema(taskSchema, {
-    exclude: ["id", "createdAt"],
-    layout: "grid",
-    gridColumns: 2,
-  });
-
   return (
     <AutoForm
-      form={form}
-      schema={formSchema}
+      schema={taskSchema}
+      gridColumns={2}
       onSubmit={(values) => console.log(values)}
     />
   );
 }
 ```
 
+详情使用同一条 Formily 渲染链路，通过 `mode="view"` 启用 `readPretty`，无需传入 `onSubmit`，也不会显示提交按钮：
+
+```tsx
+<AutoForm
+  mode="view"
+  schema={taskSchema}
+  initialValues={selectedTask}
+  fields={fields}
+  gridColumns={2}
+/>
+```
+
+创建、编辑排除 ID 和审计托管字段；详情保留 ID、创建时间和更新时间。`form: false` 和字段级 `form['x-hidden']` 只影响创建、编辑；全局 `hidden` 和 `permissions.deny` 仍限制详情字段。其他表单覆盖配置、布局、scope 和选项标签继续共用。
+
+内置字段提供阅读态映射；通过 `components.register()` 注册的自定义组件应使用 Formily `mapReadPretty` 实现自己的阅读态。`AutoCrudTable` 详情仍展示当前选中记录，不会额外请求单条接口。
+
+详情默认单列，列数由 `AutoCrudTable` 的 `form.columns` 或 `AutoForm` 的 `gridColumns` 控制，使用浅色标签和宽松间距；长文本、数组和对象默认占满整行，字段 `gridSpan` 可指定跨度。单选标签显示为文字，多选标签使用轻量徽标。长内容自动换行；弹窗最高为视口高度的 85%，超出后正文滚动，标题保持可见。
+
+`AutoCrudTable` 的 `form.labelAlign` 和 `form.labelWidth` 同时作用于创建、编辑及详情弹窗。例如 `form={{ columns: 1, labelAlign: 'left', labelWidth: 100 }}` 表示单列、左侧标签文字左对齐，标签宽度为 100px。`top` 表示上下布局（默认），`right` 表示左侧标签文字右对齐；`labelWidth` 仅在 `left` / `right` 布局时生效。
+
 ### 使用 useDataTable Hook
 
 ```typescript