@wordrhyme/auto-crud 1.7.0 → 1.8.0

package/README.md

@@ -370,6 +370,11 @@ interface UseAutoCrudResourceReturn<TSchema, TData> {
 interface Field {
   /** 字段标签（表格和表单共用） */
   label?: string;
+  /** 默认表格/详情文本和 CSV 值格式化；undefined 使用原来的默认行为 */
+  format?: (
+    value: unknown,
+    context: { row: Record<string, unknown>; target: 'display' | 'export' },
+  ) => string | undefined;
   /** 是否隐藏（表格和表单都隐藏） */
   hidden?: boolean;
   /** 表格特定配置 */
@@ -392,6 +397,31 @@ interface Field {
 type Fields = Record<string, Field>;
 ```
 
+### 值格式化
+
+在字段上配置 `format`，表格和详情使用 `target: 'display'`，顶部工具栏的选中/筛选导出及内置批量导出使用 `target: 'export'`。`value` 是格式化前的值，`row` 是原始记录。
+
+```tsx
+fields={{
+  discount: {
+    format: (value) => `${value}%`,
+  },
+  createdAt: {
+    label: t('fields.createdAt'),
+    format: (value, { target }) => {
+      if (target !== 'export') return undefined;
+      if (value === null || value === undefined) return '';
+      const date = value instanceof Date ? value : new Date(String(value));
+      return Number.isNaN(date.getTime()) ? '' : date.toISOString();
+    },
+  },
+}}
+```
+
+返回字符串（包括空字符串）时使用该结果；返回 `undefined` 时保留原有默认展示或原始 CSV 值。格式化只影响输出，不改变排序、筛选、表单或保存的数据。显式自定义 `cell` 仍负责自己的界面渲染；声明式 `table.display` / `table.options` / `table.dataSource` 按已有优先级接管单元格时也会应用 `format`。
+
+导出保留已有的列、字段名表头和权限排除规则。翻译继续在现有 `label`、选项和 `format` 中使用应用的 `t()`；无需另配导出列或语言。
+
 ### 列宽与单元格样式
 
 `fields.xxx.table` 中的 `size`、`minSize` 和 `maxSize` 控制列宽。`fields.xxx.table.classNames` 按元素分组配置该列的 CSS 类名：`th` 应用于该列的表头单元格，`td` 应用于该列每一行的正文单元格。
@@ -1699,3 +1729,31 @@ import '@wordrhyme/auto-crud/styles.css';
 
 See the [shared style guide](https://github.com/denvey/wordrhyme-components#styles)
 for theme setup, dark mode, and custom classes.
+
+### Optional pagination controls
+
+Existing pagination defaults are preserved. Set `table.pagination` on `AutoCrudTable`
+(or `pagination` on `AutoTable` / `DataTable`) to opt in. Applications can also
+register options for a public CRUD id without changing the owning page:
+
+```ts
+import { tablePagination } from '@wordrhyme/auto-crud';
+
+tablePagination.register('example.stores', {
+  alwaysShowFirstLast: true,
+  showPageJump: true,
+  pageJumpLabel: 'Go to page',
+});
+// Remove the application override when no longer needed.
+// tablePagination.unregister('example.stores');
+```
+
+Registrations notify mounted tables. Explicit `table.pagination` takes precedence
+over registration. Page jumps accept only integer pages in the known page range;
+the control is disabled when the page count is unavailable.
+
+In `AutoCrudTable`, the jump label follows the existing `locale` unless explicitly overridden.
+
+Set `responsive: true` alongside these options to hide the extra controls when
+their measured content does not fit the pagination container. This responds to
+container resizing and translated text widths, without changing other tables.