@wordrhyme/auto-crud 0.2.0 → 0.3.0

package/README.md

@@ -26,13 +26,13 @@
 
 ```bash
 # pnpm
-pnpm add @wordrhyme/auto-crud zod
+pnpm add @wordrhyme/auto-crud zod sonner
 
 # npm
-npm install @wordrhyme/auto-crud zod
+npm install @wordrhyme/auto-crud zod sonner
 
 # yarn
-yarn add @wordrhyme/auto-crud zod
+yarn add @wordrhyme/auto-crud zod sonner
 ```
 
 ### Peer Dependencies
@@ -41,6 +41,7 @@ yarn add @wordrhyme/auto-crud zod
 {
   "react": "^18.0.0 || ^19.0.0",
   "react-dom": "^18.0.0 || ^19.0.0",
+  "sonner": "^2.0.0",
   "zod": "^3.0.0 || ^4.0.0"
 }
 ```
@@ -129,14 +130,14 @@ function TasksPage() {
       title="任务管理"
       schema={taskSchema}
       resource={resource}
-      fieldOverrides={{
+      fields={{
         id: { hidden: true },
         status: { label: "状态" },
         priority: { label: "优先级" },
       }}
-      tableProps={{
-        filterMode: ["simple", "advanced", "command"],
-        batchUpdateFields: ["status", "priority"],
+      table={{
+        filterModes: ["simple", "advanced", "command"],
+        batchFields: ["status", "priority"],
       }}
     />
   );
@@ -244,54 +245,34 @@ const dataSource: DataSource<Task> = {
 #### Props
 
 ```typescript
-interface AutoCrudTableProps<TData> {
+interface AutoCrudTableProps<TSchema> {
   // 必需
-  title: string;                    // 表格标题
-  schema: z.ZodType<TData>;         // Zod Schema
-  resource: AutoCrudResource<TData>; // useAutoCrudResource 返回值
+  schema: TSchema;                              // Zod Schema
+  resource: UseAutoCrudResourceReturn<TSchema>; // useAutoCrudResource 返回值
 
   // 可选
-  fieldOverrides?: FieldOverrides<TData>;  // 字段配置
-  tableProps?: {
-    filterMode?: FilterMode | FilterMode[];  // 过滤模式
-    batchUpdateFields?: (keyof TData)[];     // 批量更新字段
+  title?: string;
+  description?: string;
+  fields?: Fields;                              // 统一字段配置
+  table?: {
+    hidden?: string[];                          // 隐藏的列
+    overrides?: Record<string, any>;            // 列覆盖配置
+    filterModes?: FilterMode | FilterMode[];    // 过滤模式
+    batchFields?: (string | BatchUpdateField)[]; // 批量更新字段
+    defaultSort?: any[];                        // 默认排序
+  };
+  form?: {
+    overrides?: Record<string, any>;            // 表单覆盖配置
+    columns?: number;                           // 表单列数
   };
   slots?: {
-    toolbarEnd?: React.ReactNode;  // 工具栏右侧插槽
+    toolbarStart?: React.ReactNode;             // 工具栏左侧插槽
+    toolbarEnd?: React.ReactNode;               // 工具栏右侧插槽
+    rowActions?: (row) => Array<{ label: string; onClick: () => void }>;
   };
 }
 ```
 
-#### 示例
-
-```typescript
-<AutoCrudTable
-  title="用户管理"
-  schema={userSchema}
-  resource={resource}
-  fieldOverrides={{
-    id: { hidden: true },
-    email: { label: "邮箱" },
-    role: {
-      label: "角色",
-      table: {
-        meta: {
-          variant: "select",
-          options: [
-            { label: "管理员", value: "admin" },
-            { label: "用户", value: "user" },
-          ],
-        },
-      },
-    },
-  }}
-  tableProps={{
-    filterMode: ["simple", "advanced"],
-    batchUpdateFields: ["role", "status"],
-  }}
-/>
-```
-
 ### `useAutoCrudResource()`
 
 连接数据源到组件的 Hook。
@@ -308,30 +289,44 @@ interface UseAutoCrudResourceConfig<TData> {
 #### 返回值
 
 ```typescript
-interface AutoCrudResource<TData> {
-  // 数据
-  data: TData[];
-  total: number;
-  isLoading: boolean;
+interface UseAutoCrudResourceReturn<TSchema, TData> {
+  // 表格数据
+  tableData: {
+    data: TData[];
+    pageCount: number;
+  };
 
   // 模态框状态
   modal: {
     variant: "dialog" | "sheet";
-    isOpen: boolean;
-    mode: "create" | "edit";
-    editingItem: TData | null;
+    createOpen: boolean;
+    editOpen: boolean;
+    viewOpen: boolean;
+    deleteOpen: boolean;
+    selected: TData | null;
+    copySource: TData | null;
   };
 
   // 操作方法
   handlers: {
-    setVariant: (variant: "dialog" | "sheet") => void;
     openCreate: () => void;
     openEdit: (item: TData) => void;
-    closeModal: () => void;
-    handleCreate: (data: Partial<TData>) => Promise<void>;
-    handleUpdate: (id: string, data: Partial<TData>) => Promise<void>;
-    handleDelete: (id: string) => Promise<void>;
-    handleDeleteMany: (ids: string[]) => Promise<void>;
+    openView: (item: TData) => void;
+    openDelete: (item: TData) => void;
+    copyRow: (item: TData) => void;
+    closeModals: () => void;
+    submitCreate: (data: TData) => Promise<void>;
+    submitUpdate: (data: TData) => Promise<void>;
+    confirmDelete: () => Promise<void>;
+    deleteMany: (rows: TData[]) => Promise<void>;
+    updateMany: (rows: TData[], data: Record<string, unknown>) => Promise<void>;
+  };
+
+  // 加载状态
+  mutations: {
+    isCreating: boolean;
+    isUpdating: boolean;
+    isDeleting: boolean;
   };
 }
 ```
@@ -340,100 +335,147 @@ interface AutoCrudResource<TData> {
 
 ## 🔧 字段配置
 
+### Field 类型
+
+```typescript
+interface Field {
+  /** 字段标签（表格和表单共用） */
+  label?: string;
+  /** 是否隐藏（表格和表单都隐藏） */
+  hidden?: boolean;
+  /** 表格特定配置 */
+  table?: {
+    hidden?: boolean;                    // 仅表格隐藏
+    meta?: Record<string, unknown>;      // 筛选器配置
+    [key: string]: unknown;
+  };
+  /** 表单特定配置 */
+  form?: {
+    "x-hidden"?: boolean;                // 仅表单隐藏
+    "x-component"?: string;              // 组件类型
+    "x-component-props"?: Record<string, unknown>;  // 组件属性
+    "x-reactions"?: object;              // 字段联动
+    [key: string]: unknown;
+  };
+}
+
+type Fields = Record<string, Field>;
+```
+
 ### 基础配置
 
 ```typescript
-fieldOverrides={{
-  fieldName: {
-    label: "显示名称",      // 表格和表单共用
-    hidden: true,           // 表格和表单都隐藏
-  },
-}}
+<AutoCrudTable
+  schema={taskSchema}
+  resource={resource}
+  fields={{
+    id: { hidden: true },           // 表格和表单都隐藏
+    title: { label: "标题" },        // 自定义标签
+    createdAt: {
+      label: "创建时间",
+      form: { "x-hidden": true },    // 仅表单隐藏
+    },
+  }}
+/>
 ```
 
-### 表格特定配置
+### 表格筛选器配置
 
 ```typescript
-fieldOverrides={{
-  amount: {
-    label: "金额",
-    table: {
-      meta: {
-        unit: "¥",          // 单位显示
-        variant: "number",  // 筛选器类型
+<AutoCrudTable
+  schema={taskSchema}
+  resource={resource}
+  fields={{
+    status: {
+      label: "状态",
+      table: {
+        meta: {
+          variant: "select",  // "text" | "select" | "multiSelect" | "date" | "dateRange" | "range"
+          options: [
+            { label: "待处理", value: "pending" },
+            { label: "已完成", value: "completed" },
+          ],
+        },
       },
     },
-  },
-  status: {
-    label: "状态",
-    table: {
-      meta: {
-        variant: "select",
-        options: [
-          { label: "待处理", value: "pending" },
-          { label: "已完成", value: "completed" },
-        ],
+    amount: {
+      label: "金额",
+      table: {
+        meta: {
+          variant: "range",
+          range: [0, 10000],
+          unit: "¥",
+        },
       },
     },
-  },
-}}
+  }}
+/>
 ```
 
-### 表单特定配置
+### 表单组件配置
 
 ```typescript
-fieldOverrides={{
-  description: {
-    label: "描述",
-    form: {
-      "x-component": "Textarea",
-      "x-component-props": { rows: 5 },
+<AutoCrudTable
+  schema={taskSchema}
+  resource={resource}
+  fields={{
+    description: {
+      label: "描述",
+      form: {
+        "x-component": "Textarea",
+        "x-component-props": { rows: 5 },
+      },
     },
-  },
-  createdAt: {
-    label: "创建时间",
-    form: {
-      "x-hidden": true,  // 仅表单隐藏
+    assignee: {
+      label: "负责人",
+      form: {
+        "x-component": "Combobox",
+        "x-component-props": { placeholder: "选择负责人" },
+      },
     },
-  },
-}}
+  }}
+/>
 ```
 
 ### 字段联动
 
 ```typescript
-fieldOverrides={{
-  endDate: {
-    label: "结束日期",
-    form: {
-      "x-reactions": {
-        dependencies: ["startDate"],
-        when: "{{$deps[0] !== undefined}}",
-        fulfill: {
-          state: {
-            visible: true,
-            disabled: false,
+<AutoCrudTable
+  schema={taskSchema}
+  resource={resource}
+  fields={{
+    endDate: {
+      label: "结束日期",
+      form: {
+        "x-reactions": {
+          dependencies: ["startDate"],
+          when: "{{$deps[0] !== undefined}}",
+          fulfill: {
+            state: {
+              visible: true,
+              disabled: false,
+            },
           },
         },
       },
     },
-  },
-}}
+  }}
+/>
 ```
 
 ---
 
 ## 🎯 过滤模式
 
-### Simple 模式（简单筛选）
+### Simple 模式（默认）
 
 - 适合：快速筛选常用字段
 - 特点：下拉选择框，一键清除
 - 示例：状态筛选、优先级筛选
 
 ```typescript
-tableProps={{
-  filterMode: "simple",
+table={{
+  filterModes: "simple",
 }}
 ```
 
@@ -444,8 +486,8 @@ tableProps={{
 - 示例：`status = "done" AND priority = "high"`
 
 ```typescript
-tableProps={{
-  filterMode: "advanced",
+table={{
+  filterModes: "advanced",
 }}
 ```
 
@@ -456,16 +498,16 @@ tableProps={{
 - 示例：快速搜索并添加筛选条件
 
 ```typescript
-tableProps={{
-  filterMode: "command",
+table={{
+  filterModes: "command",
 }}
 ```
 
 ### 多模式切换
 
 ```typescript
-tableProps={{
-  filterMode: ["simple", "advanced", "command"],  // 第一个为默认模式
+table={{
+  filterModes: ["simple", "advanced", "command"],  // 第一个为默认模式
 }}
 ```
 
@@ -479,8 +521,8 @@ tableProps={{
 <AutoCrudTable
   schema={taskSchema}
   resource={resource}
-  tableProps={{
-    batchUpdateFields: ["status", "priority"],
+  table={{
+    batchFields: ["status", "priority"],
   }}
 />
 ```
@@ -506,162 +548,334 @@ tableProps={{
 
 ---
 
-## 🎨 自定义样式
+## 🔌 与其他库集成
 
-### 使用 Tailwind CSS
+### 与 Drizzle ORM 集成
 
 ```typescript
-<AutoCrudTable
-  schema={taskSchema}
-  resource={resource}
-  className="custom-table"
-/>
+import { createSelectSchema } from "drizzle-zod";
+import { tasks } from "@/db/schema";
+
+const taskSchema = createSelectSchema(tasks);
+
+<AutoCrudTable schema={taskSchema} resource={resource} />
 ```
 
-### 自定义工具栏
+### 与 Next.js 集成
 
 ```typescript
-<AutoCrudTable
-  schema={taskSchema}
-  resource={resource}
-  slots={{
-    toolbarEnd: (
-      <div className="flex gap-2">
-        <Button onClick={handleExport}>导出</Button>
-        <Button onClick={handleImport}>导入</Button>
-      </div>
-    ),
-  }}
-/>
+// app/tasks/page.tsx
+"use client";
+
+import { AutoCrudTable } from "@wordrhyme/auto-crud";
+
+export default function TasksPage() {
+  return <AutoCrudTable schema={taskSchema} resource={resource} />;
+}
 ```
 
 ---
 
-## 📚 高级用法
+## 🧰 工具函数
+
+### Schema Bridge - 核心转换函数
+
+```typescript
+import {
+  parseZodField,        // 解析 Zod 字段类型
+  createTableSchema,        // Zod Schema → TanStack Table 列定义
+  createSelectColumn,   // 创建选择列
+  createActionsColumn,  // 创建操作列
+  createFormSchema,     // Zod Schema → Formily Schema
+  createEditFormSchema, // 创建编辑表单 Schema（排除 id, createdAt, updatedAt）
+} from "@wordrhyme/auto-crud";
+```
 
 ### 自定义列渲染
 
+使用 `createTableSchema` 的 `overrides` 参数自定义列渲染：
+
 ```typescript
-import { createColumns } from "@wordrhyme/auto-crud";
+import { createTableSchema } from "@wordrhyme/auto-crud";
+import { Badge } from "@shadcn/ui";
 
-const columns = createColumns(taskSchema, {
+const columns = createTableSchema(taskSchema, {
   overrides: {
     status: {
-      cell: ({ row }) => (
-        <Badge variant={row.original.status === "done" ? "success" : "default"}>
-          {row.original.status}
-        </Badge>
-      ),
+      label: "状态",
+      // 自定义 cell 渲染
+      cell: ({ row }) => {
+        const status = row.getValue("status");
+        return (
+          <Badge variant={status === "done" ? "success" : "secondary"}>
+            {status}
+          </Badge>
+        );
+      },
+    },
+    priority: {
+      label: "优先级",
+      // 自定义列配置
+      size: 100,
+      enableSorting: false,
     },
   },
+  exclude: ["id", "createdAt"],  // 排除字段
 });
 ```
 
-### 自定义表单组件
+### 自定义表单渲染
+
+使用 `createFormSchema` 的 `overrides` 参数自定义表单组件：
 
 ```typescript
-fieldOverrides={{
-  tags: {
-    label: "标签",
-    form: {
-      "x-component": "TagsInput",
+import { createFormSchema } from "@wordrhyme/auto-crud";
+
+const formSchema = createFormSchema(taskSchema, {
+  overrides: {
+    description: {
+      "x-component": "Textarea",
+      "x-component-props": { rows: 5 },
+    },
+    status: {
+      "x-component": "Select",
       "x-component-props": {
-        placeholder: "输入标签",
-        maxTags: 5,
+        options: [
+          { label: "待办", value: "todo" },
+          { label: "完成", value: "done" },
+        ],
       },
     },
+    dueDate: {
+      "x-component": "DatePicker",
+      "x-component-props": { format: "YYYY-MM-DD" },
+    },
   },
-}}
+  layout: "grid",
+  gridColumns: 2,
+  exclude: ["id", "createdAt"],
+});
 ```
 
-### 服务端分页
+---
+
+## 🔀 三种 Schema 类型
+
+`@wordrhyme/auto-crud` 支持三种 Schema 输入格式，通过 `SchemaAdapter` 统一处理：
+
+### 1. Zod Schema（推荐）
 
 ```typescript
-const [queryParams] = useQueryStates({
-  page: parseAsInteger.withDefault(1),
-  perPage: parseAsInteger.withDefault(10),
-});
+import { z } from "zod";
 
-const dataSource = createTRPCDataSource({
-  router: trpc.tasks,
-  queryInput: queryParams,
+const taskSchema = z.object({
+  id: z.string(),
+  title: z.string(),
+  status: z.enum(["todo", "in-progress", "done"]),
+  priority: z.enum(["low", "medium", "high"]),
+  createdAt: z.date(),
 });
 ```
 
----
-
-## 🔌 与其他库集成
-
-### 与 Drizzle ORM 集成
+### 2. JSON Schema
 
 ```typescript
-import { createSelectSchema } from "drizzle-zod";
-import { tasks } from "@/db/schema";
+import type { JSONSchema } from "@wordrhyme/auto-crud";
 
-const taskSchema = createSelectSchema(tasks);
-
-<AutoCrudTable schema={taskSchema} resource={resource} />
+const taskSchema: JSONSchema = {
+  type: "object",
+  properties: {
+    id: { type: "string" },
+    title: { type: "string", title: "标题" },
+    status: {
+      type: "string",
+      enum: ["todo", "in-progress", "done"],
+      title: "状态",
+    },
+    createdAt: { type: "string", format: "date-time" },
+  },
+  required: ["id", "title"],
+};
 ```
 
-### 与 React Hook Form 集成
+### 3. 简化配置（Simple Config）
 
 ```typescript
-import { zodResolver } from "@hookform/resolvers/zod";
-import { useForm } from "react-hook-form";
+import type { SimpleFieldsConfig } from "@wordrhyme/auto-crud";
 
-const form = useForm({
-  resolver: zodResolver(taskSchema),
-});
+const taskSchema: SimpleFieldsConfig = {
+  id: { type: "string", required: true },
+  title: { type: "string", label: "标题", required: true },
+  status: {
+    type: "select",
+    label: "状态",
+    options: ["todo", "in-progress", "done"],
+  },
+  description: { type: "textarea", label: "描述" },
+  createdAt: { type: "datetime" },
+};
 ```
 
-### 与 Next.js 集成
+### SchemaAdapter 使用
 
 ```typescript
-// app/tasks/page.tsx
-"use client";
+import { SchemaAdapter } from "@wordrhyme/auto-crud";
 
-import { AutoCrudTable } from "@wordrhyme/auto-crud";
+// 自动检测 Schema 类型
+const type = SchemaAdapter.detectType(schema);  // "zod" | "json" | "simple"
 
-export default function TasksPage() {
-  return <AutoCrudTable schema={taskSchema} resource={resource} />;
-}
+// 转换为统一的字段定义
+const fields = SchemaAdapter.toUnified(schema);
+
+// 转换为 Formily Schema
+const formilySchema = SchemaAdapter.toFormily(fields);
 ```
 
 ---
 
-## 🛠️ 工具函数
+## 🧩 基础组件（自定义组合）
+
+如果 `AutoCrudTable` 不能满足需求，可以使用基础组件自行组合：
 
-### `createColumns()`
+### 组件层级
+
+```
+AutoCrudTable         ← 高级封装，一站式 CRUD
+  ├── AutoTable       ← 表格 + 工具栏 + 筛选器
+  │   ├── DataTable   ← 纯表格组件（TanStack Table）
+  │   ├── AutoTableActionBar    ← 批量操作栏
+  │   └── AutoTableSimpleFilters ← 简单筛选器
+  ├── AutoForm        ← 表单组件（Formily）
+  └── CrudFormModal   ← 表单弹窗（创建/编辑/查看）
+```
 
-从 Zod Schema 自动生成表格列。
+### 使用 DataTable 组件
 
 ```typescript
-import { createColumns } from "@wordrhyme/auto-crud";
+import { DataTable, createTableSchema, createSelectColumn, createActionsColumn } from "@wordrhyme/auto-crud";
+
+function CustomTable({ data }) {
+  const columns = [
+    createSelectColumn(),
+    ...createTableSchema(taskSchema, { exclude: ["id"] }),
+    createActionsColumn({
+      onEdit: (row) => console.log("Edit", row),
+      onDelete: (row) => console.log("Delete", row),
+      onView: (row) => console.log("View", row),
+      onCopy: (row) => console.log("Copy", row),
+    }),
+  ];
 
-const columns = createColumns(taskSchema, {
-  exclude: ["id", "createdAt"],
-  overrides: {
-    status: {
-      meta: {
-        label: "状态",
-        variant: "select",
-      },
-    },
-  },
-});
+  return (
+    <DataTable
+      columns={columns}
+      data={data}
+      pageCount={10}
+    />
+  );
+}
+```
+
+### 使用 AutoForm 组件
+
+```typescript
+import { AutoForm, createFormSchema } from "@wordrhyme/auto-crud";
+import { createForm } from "@formily/core";
+
+function CustomForm() {
+  const form = createForm();
+  const formSchema = createFormSchema(taskSchema, {
+    exclude: ["id", "createdAt"],
+    layout: "grid",
+    gridColumns: 2,
+  });
+
+  return (
+    <AutoForm
+      form={form}
+      schema={formSchema}
+      onSubmit={(values) => console.log(values)}
+    />
+  );
+}
 ```
 
-### `createFormSchema()`
+### 使用 useDataTable Hook
+
+```typescript
+import { useDataTable, DataTable, DataTablePagination } from "@wordrhyme/auto-crud";
+
+function CustomDataTable({ data, pageCount }) {
+  const { table } = useDataTable({
+    data,
+    columns,
+    pageCount,
+    initialState: {
+      pagination: { pageIndex: 0, pageSize: 10 },
+      sorting: [{ id: "createdAt", desc: true }],
+    },
+  });
+
+  return (
+    <div>
+      <DataTable table={table} />
+      <DataTablePagination table={table} />
+    </div>
+  );
+}
+```
 
-从 Zod Schema 自动生成 Formily 表单 Schema。
+### 组件组合示例
 
 ```typescript
-import { createFormSchema } from "@wordrhyme/auto-crud";
+import {
+  AutoTable,
+  AutoForm,
+  CrudFormModal,
+  useAutoCrudResource,
+  createTableSchema,
+  createFormSchema,
+} from "@wordrhyme/auto-crud";
+
+function CustomCrudPage() {
+  const resource = useAutoCrudResource({ dataSource, schema: taskSchema });
+
+  const columns = createTableSchema(taskSchema, {
+    overrides: {
+      status: {
+        cell: ({ row }) => <StatusBadge status={row.getValue("status")} />,
+      },
+    },
+  });
 
-const formSchema = createFormSchema(taskSchema, {
-  exclude: ["id", "createdAt"],
-  layout: "vertical",
-});
+  const formSchema = createFormSchema(taskSchema, {
+    exclude: ["id", "createdAt", "updatedAt"],
+  });
+
+  return (
+    <div>
+      {/* 自定义表格 */}
+      <AutoTable
+        columns={columns}
+        data={resource.tableData.data}
+        pageCount={resource.tableData.pageCount}
+        filterMode="simple"
+      />
+
+      {/* 自定义表单弹窗 */}
+      <CrudFormModal
+        mode={resource.modal.editOpen ? "edit" : "create"}
+        open={resource.modal.createOpen || resource.modal.editOpen}
+        onClose={resource.handlers.closeModals}
+        schema={formSchema}
+        initialValues={resource.modal.selected}
+        onSubmit={resource.modal.editOpen
+          ? resource.handlers.submitUpdate
+          : resource.handlers.submitCreate}
+      />
+    </div>
+  );
+}
 ```
 
 ---
@@ -669,27 +883,49 @@ const formSchema = createFormSchema(taskSchema, {
 ## 📦 导出的类型
 
 ```typescript
-// 组件
+// Auto-CRUD 组件
 export { AutoCrudTable } from "./components/auto-crud/auto-crud-table";
+export type { Field, Fields, AutoCrudTableProps } from "./components/auto-crud/auto-crud-table";
 export { AutoForm } from "./components/auto-crud/auto-form";
 export { AutoTable } from "./components/auto-crud/auto-table";
+export { AutoTableActionBar } from "./components/auto-crud/auto-table-action-bar";
+export { AutoTableSimpleFilters } from "./components/auto-crud/auto-table-simple-filters";
+export { CrudFormModal } from "./components/auto-crud/crud-form-modal";
+
+// 数据表格组件
+export { DataTable } from "./components/data-table/data-table";
+export { DataTableAdvancedToolbar } from "./components/data-table/data-table-advanced-toolbar";
+export { DataTableColumnHeader } from "./components/data-table/data-table-column-header";
+export { DataTableFacetedFilter } from "./components/data-table/data-table-faceted-filter";
+export { DataTablePagination } from "./components/data-table/data-table-pagination";
+export { DataTableToolbar } from "./components/data-table/data-table-toolbar";
+export { DataTableViewOptions } from "./components/data-table/data-table-view-options";
 
 // Hooks
-export { useAutoCrudResource } from "./hooks/use-auto-crud-resource";
+export { useAutoCrudResource, noopToastAdapter } from "./hooks/use-auto-crud-resource";
+export type { ToastAdapter, CrudHooks, UseAutoCrudResourceOptions } from "./hooks/use-auto-crud-resource";
 export { useDataTable } from "./hooks/use-data-table";
+export { useReadableFilters } from "./hooks/use-readable-filters";
+export { useUrlState, useQueryState, useQueryStates } from "./hooks/use-url-state";
+
+// Schema Bridge - 核心工具
+export { parseZodField, createTableSchema, createSelectColumn, createActionsColumn } from "./lib/schema-bridge/zod-to-columns";
+export { createFormSchema, createEditFormSchema } from "./lib/schema-bridge/zod-to-formily";
+export { SchemaAdapter } from "./lib/schema-bridge/schema-adapter";
+export type {
+  ColumnOverrides, FormSchemaOverrides,
+  CreateTableSchemaOptions, CreateFormSchemaOptions,
+  UnifiedSchema, JSONSchema, SimpleFieldsConfig, UnifiedField,
+} from "./lib/schema-bridge";
 
 // 数据源
 export { createTRPCDataSource, createMemoryDataSource } from "./lib/data-source";
 export type { DataSource, ListParams, ListResult } from "./lib/data-source";
 
 // 工具函数
-export { createColumns, createFormSchema } from "./lib/schema-bridge";
-export type {
-  FieldOverrides,
-  FieldOverride,
-  CreateColumnsOptions,
-  CreateFormSchemaOptions,
-} from "./lib/schema-bridge";
+export { cn } from "./lib/utils";
+export { formatDate } from "./lib/format";
+export { humanize } from "./lib/humanize";
 ```
 
 ---

package/dist/index.cjs

@@ -4073,9 +4073,9 @@ function renderCell(value, type) {
 	}
 }
 /**
-* 从 Zod Schema 创建 ColumnDef 数组
+* 从 Zod Schema 创建 Table Schema (ColumnDef 数组)
 */
-function createColumns(schema, options) {
+function createTableSchema(schema, options) {
 	const shape = schema.shape;
 	const columns = [];
 	const { overrides, exclude = [] } = options ?? {};
@@ -4212,7 +4212,7 @@ function AutoTable({ schema, data, pageCount = 1, overrides, enableRowSelection
 	const { table, shallow, debounceMs, throttleMs } = useDataTable({
 		data,
 		columns: (0, react.useMemo)(() => {
-			const dataColumns = createColumns(schema, {
+			const dataColumns = createTableSchema(schema, {
 				overrides,
 				exclude
 			});
@@ -6040,12 +6040,12 @@ exports.DataTableViewOptions = DataTableViewOptions;
 exports.SchemaAdapter = SchemaAdapter;
 exports.cn = cn;
 exports.createActionsColumn = createActionsColumn;
-exports.createColumns = createColumns;
 exports.createEditFormSchema = createEditFormSchema;
 exports.createFormSchema = createFormSchema;
 exports.createMemoryDataSource = createMemoryDataSource;
 exports.createSelectColumn = createSelectColumn;
 exports.createTRPCDataSource = createTRPCDataSource;
+exports.createTableSchema = createTableSchema;
 exports.formatDate = formatDate;
 exports.getUrlParams = getUrlParams;
 exports.humanize = humanize;

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime8 from "react/jsx-runtime";
+import * as react_jsx_runtime2 from "react/jsx-runtime";
 import { z } from "zod";
 import * as _tanstack_react_table0 from "@tanstack/react-table";
 import { Column, ColumnDef, ColumnSort, Row, RowData, Table, TableOptions, TableState } from "@tanstack/react-table";
@@ -199,7 +199,7 @@ declare function AutoTableActionBar<TData>({
   enableExport,
   enableDelete,
   extraActions
-}: AutoTableActionBarProps<TData>): react_jsx_runtime8.JSX.Element;
+}: AutoTableActionBarProps<TData>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/lib/schema-bridge/types.d.ts
 /**
@@ -232,9 +232,9 @@ type ColumnOverrides<T> = Partial<{ [K in keyof T]: Partial<ColumnDef<T, unknown
  */
 type FormSchemaOverrides = Record<string, Partial<ISchema>>;
 /**
- * createColumns 选项
+ * createTableSchema 选项
  */
-interface CreateColumnsOptions<T> {
+interface CreateTableSchemaOptions<T> {
   overrides?: ColumnOverrides<T>;
   exclude?: (keyof T)[];
 }
@@ -269,9 +269,9 @@ interface EnumOption {
  */
 declare function parseZodField(schema: z.ZodType): ParsedZodField;
 /**
- * 从 Zod Schema 创建 ColumnDef 数组
+ * 从 Zod Schema 创建 Table Schema (ColumnDef 数组)
  */
-declare function createColumns<T extends z.ZodObject<z.ZodRawShape>>(schema: T, options?: CreateColumnsOptions<z.infer<T>>): ColumnDef<z.infer<T>>[];
+declare function createTableSchema<T extends z.ZodObject<z.ZodRawShape>>(schema: T, options?: CreateTableSchemaOptions<z.infer<T>>): ColumnDef<z.infer<T>>[];
 /**
  * 创建选择列
  */
@@ -339,7 +339,7 @@ declare function AutoTable<T extends z.ZodObject<z.ZodRawShape>>({
   batchUpdateFields,
   actionBarExtra,
   initialSorting
-}: AutoTableProps<T>): react_jsx_runtime8.JSX.Element;
+}: AutoTableProps<T>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/auto-crud-table.d.ts
 /**
@@ -445,7 +445,7 @@ declare function AutoCrudTable<TSchema extends z.ZodObject<z.ZodRawShape>>({
   table: tableConfig,
   form: formConfig,
   slots
-}: AutoCrudTableProps<TSchema>): react_jsx_runtime8.JSX.Element;
+}: AutoCrudTableProps<TSchema>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/auto-form.d.ts
 interface AutoFormProps<T extends z.ZodObject<z.ZodRawShape>> {
@@ -477,7 +477,7 @@ declare function AutoFormInner<T extends z.ZodObject<z.ZodRawShape>>({
   labelAlign,
   labelWidth,
   showSubmitButton
-}: AutoFormProps<T>, ref: React.Ref<AutoFormRef>): react_jsx_runtime8.JSX.Element;
+}: AutoFormProps<T>, ref: React.Ref<AutoFormRef>): react_jsx_runtime2.JSX.Element;
 declare const AutoForm: <T extends z.ZodObject<z.ZodRawShape>>(props: AutoFormProps<T> & {
   ref?: React.Ref<AutoFormRef>;
 }) => ReturnType<typeof AutoFormInner>;
@@ -691,12 +691,12 @@ declare const filterItemSchema: z.ZodObject<{
   variant: z.ZodEnum<{
     number: "number";
     boolean: "boolean";
-    text: "text";
-    range: "range";
     date: "date";
-    dateRange: "dateRange";
+    text: "text";
     select: "select";
     multiSelect: "multiSelect";
+    dateRange: "dateRange";
+    range: "range";
   }>;
   operator: z.ZodEnum<{
     iLike: "iLike";
@@ -772,7 +772,7 @@ declare function AutoTableSimpleFilters<TData>({
   shallow,
   filters: externalFilters,
   onFiltersChange
-}: AutoTableSimpleFiltersProps<TData>): react_jsx_runtime8.JSX.Element | null;
+}: AutoTableSimpleFiltersProps<TData>): react_jsx_runtime2.JSX.Element | null;
 //#endregion
 //#region src/components/auto-crud/form-modal.d.ts
 type ModalVariant = "dialog" | "sheet";
@@ -807,7 +807,7 @@ declare function CrudFormModal<T extends z.ZodObject<z.ZodRawShape>>({
   title,
   labelAlign,
   labelWidth
-}: CrudFormModalProps<T>): react_jsx_runtime8.JSX.Element;
+}: CrudFormModalProps<T>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table.d.ts
 interface DataTableProps<TData> extends React$1.ComponentProps<"div"> {
@@ -820,7 +820,7 @@ declare function DataTable<TData>({
   children,
   className,
   ...props
-}: DataTableProps<TData>): react_jsx_runtime8.JSX.Element;
+}: DataTableProps<TData>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-advanced-toolbar.d.ts
 interface DataTableAdvancedToolbarProps<TData> extends React$1.ComponentProps<"div"> {
@@ -831,7 +831,7 @@ declare function DataTableAdvancedToolbar<TData>({
   children,
   className,
   ...props
-}: DataTableAdvancedToolbarProps<TData>): react_jsx_runtime8.JSX.Element;
+}: DataTableAdvancedToolbarProps<TData>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-column-header.d.ts
 interface DataTableColumnHeaderProps<TData, TValue> extends React.ComponentProps<typeof DropdownMenuTrigger> {
@@ -843,7 +843,7 @@ declare function DataTableColumnHeader<TData, TValue>({
   label,
   className,
   ...props
-}: DataTableColumnHeaderProps<TData, TValue>): react_jsx_runtime8.JSX.Element;
+}: DataTableColumnHeaderProps<TData, TValue>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-faceted-filter.d.ts
 interface DataTableFacetedFilterProps<TData, TValue> {
@@ -857,7 +857,7 @@ declare function DataTableFacetedFilter<TData, TValue>({
   title,
   options,
   multiple
-}: DataTableFacetedFilterProps<TData, TValue>): react_jsx_runtime8.JSX.Element;
+}: DataTableFacetedFilterProps<TData, TValue>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-pagination.d.ts
 interface DataTablePaginationProps<TData> extends React.ComponentProps<"div"> {
@@ -869,7 +869,7 @@ declare function DataTablePagination<TData>({
   pageSizeOptions,
   className,
   ...props
-}: DataTablePaginationProps<TData>): react_jsx_runtime8.JSX.Element;
+}: DataTablePaginationProps<TData>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-toolbar.d.ts
 interface DataTableToolbarProps<TData> extends React$1.ComponentProps<"div"> {
@@ -880,7 +880,7 @@ declare function DataTableToolbar<TData>({
   children,
   className,
   ...props
-}: DataTableToolbarProps<TData>): react_jsx_runtime8.JSX.Element;
+}: DataTableToolbarProps<TData>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-view-options.d.ts
 interface DataTableViewOptionsProps<TData> extends React$1.ComponentProps<typeof PopoverContent> {
@@ -891,7 +891,7 @@ declare function DataTableViewOptions<TData>({
   table,
   disabled,
   ...props
-}: DataTableViewOptionsProps<TData>): react_jsx_runtime8.JSX.Element;
+}: DataTableViewOptionsProps<TData>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/hooks/use-data-table.d.ts
 interface UseDataTableProps<TData> extends Omit<TableOptions<TData>, "state" | "pageCount" | "getCoreRowModel" | "manualFiltering" | "manualPagination" | "manualSorting">, Required<Pick<TableOptions<TData>, "pageCount">> {
@@ -1162,4 +1162,4 @@ declare function formatDate(date: Date | string | number | undefined, opts?: Int
  */
 declare function humanize(str: string): string;
 //#endregion
-export { type ActionsColumnConfig, AutoCrudTable, type AutoCrudTableProps, AutoForm, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, type ColumnOverrides, type CreateColumnsOptions, type CreateFormSchemaOptions, CrudFormModal, type CrudHooks, type DataSource, DataTable, DataTableAdvancedToolbar, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableRowAction, DataTableToolbar, DataTableViewOptions, type EnumOption, ExtendedColumnFilter, ExtendedColumnSort, type Field, type FieldType, type Fields, FilterOperator, type FilterVariant, type FormSchemaOverrides, type JSONSchema, type JSONSchemaProperty, JoinOperator, type ListParams, type ListResult, Option, type ParsedZodField, type Parser, QueryKeys, SchemaAdapter, type SimpleFieldConfig, type SimpleFieldsConfig, type ToastAdapter, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, cn, createActionsColumn, createColumns, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, formatDate, getUrlParams, humanize, noopToastAdapter, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseZodField, setSearchParams, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates };
+export { type ActionsColumnConfig, AutoCrudTable, type AutoCrudTableProps, AutoForm, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, type ColumnOverrides, type CreateFormSchemaOptions, type CreateTableSchemaOptions, CrudFormModal, type CrudHooks, type DataSource, DataTable, DataTableAdvancedToolbar, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableRowAction, DataTableToolbar, DataTableViewOptions, type EnumOption, ExtendedColumnFilter, ExtendedColumnSort, type Field, type FieldType, type Fields, FilterOperator, type FilterVariant, type FormSchemaOverrides, type JSONSchema, type JSONSchemaProperty, JoinOperator, type ListParams, type ListResult, Option, type ParsedZodField, type Parser, QueryKeys, SchemaAdapter, type SimpleFieldConfig, type SimpleFieldsConfig, type ToastAdapter, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, cn, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, formatDate, getUrlParams, humanize, noopToastAdapter, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseZodField, setSearchParams, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates };

package/dist/index.d.ts

@@ -3,7 +3,7 @@ import * as _tanstack_react_table0 from "@tanstack/react-table";
 import { Column, ColumnDef, ColumnSort, Row, RowData, Table, TableOptions, TableState } from "@tanstack/react-table";
 import { DropdownMenuTrigger, PopoverContent } from "@pixpilot/shadcn";
 import { ClassValue } from "clsx";
-import * as react_jsx_runtime3 from "react/jsx-runtime";
+import * as react_jsx_runtime7 from "react/jsx-runtime";
 import { z } from "zod";
 import { ISchema } from "@formily/json-schema";
 
@@ -199,7 +199,7 @@ declare function AutoTableActionBar<TData>({
   enableExport,
   enableDelete,
   extraActions
-}: AutoTableActionBarProps<TData>): react_jsx_runtime3.JSX.Element;
+}: AutoTableActionBarProps<TData>): react_jsx_runtime7.JSX.Element;
 //#endregion
 //#region src/lib/schema-bridge/types.d.ts
 /**
@@ -232,9 +232,9 @@ type ColumnOverrides<T> = Partial<{ [K in keyof T]: Partial<ColumnDef<T, unknown
  */
 type FormSchemaOverrides = Record<string, Partial<ISchema>>;
 /**
- * createColumns 选项
+ * createTableSchema 选项
  */
-interface CreateColumnsOptions<T> {
+interface CreateTableSchemaOptions<T> {
   overrides?: ColumnOverrides<T>;
   exclude?: (keyof T)[];
 }
@@ -269,9 +269,9 @@ interface EnumOption {
  */
 declare function parseZodField(schema: z.ZodType): ParsedZodField;
 /**
- * 从 Zod Schema 创建 ColumnDef 数组
+ * 从 Zod Schema 创建 Table Schema (ColumnDef 数组)
  */
-declare function createColumns<T extends z.ZodObject<z.ZodRawShape>>(schema: T, options?: CreateColumnsOptions<z.infer<T>>): ColumnDef<z.infer<T>>[];
+declare function createTableSchema<T extends z.ZodObject<z.ZodRawShape>>(schema: T, options?: CreateTableSchemaOptions<z.infer<T>>): ColumnDef<z.infer<T>>[];
 /**
  * 创建选择列
  */
@@ -339,7 +339,7 @@ declare function AutoTable<T extends z.ZodObject<z.ZodRawShape>>({
   batchUpdateFields,
   actionBarExtra,
   initialSorting
-}: AutoTableProps<T>): react_jsx_runtime3.JSX.Element;
+}: AutoTableProps<T>): react_jsx_runtime7.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/auto-crud-table.d.ts
 /**
@@ -445,7 +445,7 @@ declare function AutoCrudTable<TSchema extends z.ZodObject<z.ZodRawShape>>({
   table: tableConfig,
   form: formConfig,
   slots
-}: AutoCrudTableProps<TSchema>): react_jsx_runtime3.JSX.Element;
+}: AutoCrudTableProps<TSchema>): react_jsx_runtime7.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/auto-form.d.ts
 interface AutoFormProps<T extends z.ZodObject<z.ZodRawShape>> {
@@ -477,7 +477,7 @@ declare function AutoFormInner<T extends z.ZodObject<z.ZodRawShape>>({
   labelAlign,
   labelWidth,
   showSubmitButton
-}: AutoFormProps<T>, ref: React.Ref<AutoFormRef>): react_jsx_runtime3.JSX.Element;
+}: AutoFormProps<T>, ref: React.Ref<AutoFormRef>): react_jsx_runtime7.JSX.Element;
 declare const AutoForm: <T extends z.ZodObject<z.ZodRawShape>>(props: AutoFormProps<T> & {
   ref?: React.Ref<AutoFormRef>;
 }) => ReturnType<typeof AutoFormInner>;
@@ -691,12 +691,12 @@ declare const filterItemSchema: z.ZodObject<{
   variant: z.ZodEnum<{
     number: "number";
     boolean: "boolean";
-    text: "text";
-    range: "range";
     date: "date";
-    dateRange: "dateRange";
+    text: "text";
     select: "select";
     multiSelect: "multiSelect";
+    dateRange: "dateRange";
+    range: "range";
   }>;
   operator: z.ZodEnum<{
     iLike: "iLike";
@@ -772,7 +772,7 @@ declare function AutoTableSimpleFilters<TData>({
   shallow,
   filters: externalFilters,
   onFiltersChange
-}: AutoTableSimpleFiltersProps<TData>): react_jsx_runtime3.JSX.Element | null;
+}: AutoTableSimpleFiltersProps<TData>): react_jsx_runtime7.JSX.Element | null;
 //#endregion
 //#region src/components/auto-crud/form-modal.d.ts
 type ModalVariant = "dialog" | "sheet";
@@ -807,7 +807,7 @@ declare function CrudFormModal<T extends z.ZodObject<z.ZodRawShape>>({
   title,
   labelAlign,
   labelWidth
-}: CrudFormModalProps<T>): react_jsx_runtime3.JSX.Element;
+}: CrudFormModalProps<T>): react_jsx_runtime7.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table.d.ts
 interface DataTableProps<TData> extends React$1.ComponentProps<"div"> {
@@ -820,7 +820,7 @@ declare function DataTable<TData>({
   children,
   className,
   ...props
-}: DataTableProps<TData>): react_jsx_runtime3.JSX.Element;
+}: DataTableProps<TData>): react_jsx_runtime7.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-advanced-toolbar.d.ts
 interface DataTableAdvancedToolbarProps<TData> extends React$1.ComponentProps<"div"> {
@@ -831,7 +831,7 @@ declare function DataTableAdvancedToolbar<TData>({
   children,
   className,
   ...props
-}: DataTableAdvancedToolbarProps<TData>): react_jsx_runtime3.JSX.Element;
+}: DataTableAdvancedToolbarProps<TData>): react_jsx_runtime7.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-column-header.d.ts
 interface DataTableColumnHeaderProps<TData, TValue> extends React.ComponentProps<typeof DropdownMenuTrigger> {
@@ -843,7 +843,7 @@ declare function DataTableColumnHeader<TData, TValue>({
   label,
   className,
   ...props
-}: DataTableColumnHeaderProps<TData, TValue>): react_jsx_runtime3.JSX.Element;
+}: DataTableColumnHeaderProps<TData, TValue>): react_jsx_runtime7.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-faceted-filter.d.ts
 interface DataTableFacetedFilterProps<TData, TValue> {
@@ -857,7 +857,7 @@ declare function DataTableFacetedFilter<TData, TValue>({
   title,
   options,
   multiple
-}: DataTableFacetedFilterProps<TData, TValue>): react_jsx_runtime3.JSX.Element;
+}: DataTableFacetedFilterProps<TData, TValue>): react_jsx_runtime7.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-pagination.d.ts
 interface DataTablePaginationProps<TData> extends React.ComponentProps<"div"> {
@@ -869,7 +869,7 @@ declare function DataTablePagination<TData>({
   pageSizeOptions,
   className,
   ...props
-}: DataTablePaginationProps<TData>): react_jsx_runtime3.JSX.Element;
+}: DataTablePaginationProps<TData>): react_jsx_runtime7.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-toolbar.d.ts
 interface DataTableToolbarProps<TData> extends React$1.ComponentProps<"div"> {
@@ -880,7 +880,7 @@ declare function DataTableToolbar<TData>({
   children,
   className,
   ...props
-}: DataTableToolbarProps<TData>): react_jsx_runtime3.JSX.Element;
+}: DataTableToolbarProps<TData>): react_jsx_runtime7.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-view-options.d.ts
 interface DataTableViewOptionsProps<TData> extends React$1.ComponentProps<typeof PopoverContent> {
@@ -891,7 +891,7 @@ declare function DataTableViewOptions<TData>({
   table,
   disabled,
   ...props
-}: DataTableViewOptionsProps<TData>): react_jsx_runtime3.JSX.Element;
+}: DataTableViewOptionsProps<TData>): react_jsx_runtime7.JSX.Element;
 //#endregion
 //#region src/hooks/use-data-table.d.ts
 interface UseDataTableProps<TData> extends Omit<TableOptions<TData>, "state" | "pageCount" | "getCoreRowModel" | "manualFiltering" | "manualPagination" | "manualSorting">, Required<Pick<TableOptions<TData>, "pageCount">> {
@@ -1162,4 +1162,4 @@ declare function formatDate(date: Date | string | number | undefined, opts?: Int
  */
 declare function humanize(str: string): string;
 //#endregion
-export { type ActionsColumnConfig, AutoCrudTable, type AutoCrudTableProps, AutoForm, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, type ColumnOverrides, type CreateColumnsOptions, type CreateFormSchemaOptions, CrudFormModal, type CrudHooks, type DataSource, DataTable, DataTableAdvancedToolbar, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableRowAction, DataTableToolbar, DataTableViewOptions, type EnumOption, ExtendedColumnFilter, ExtendedColumnSort, type Field, type FieldType, type Fields, FilterOperator, type FilterVariant, type FormSchemaOverrides, type JSONSchema, type JSONSchemaProperty, JoinOperator, type ListParams, type ListResult, Option, type ParsedZodField, type Parser, QueryKeys, SchemaAdapter, type SimpleFieldConfig, type SimpleFieldsConfig, type ToastAdapter, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, cn, createActionsColumn, createColumns, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, formatDate, getUrlParams, humanize, noopToastAdapter, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseZodField, setSearchParams, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates };
+export { type ActionsColumnConfig, AutoCrudTable, type AutoCrudTableProps, AutoForm, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, type ColumnOverrides, type CreateFormSchemaOptions, type CreateTableSchemaOptions, CrudFormModal, type CrudHooks, type DataSource, DataTable, DataTableAdvancedToolbar, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableRowAction, DataTableToolbar, DataTableViewOptions, type EnumOption, ExtendedColumnFilter, ExtendedColumnSort, type Field, type FieldType, type Fields, FilterOperator, type FilterVariant, type FormSchemaOverrides, type JSONSchema, type JSONSchemaProperty, JoinOperator, type ListParams, type ListResult, Option, type ParsedZodField, type Parser, QueryKeys, SchemaAdapter, type SimpleFieldConfig, type SimpleFieldsConfig, type ToastAdapter, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, cn, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, formatDate, getUrlParams, humanize, noopToastAdapter, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseZodField, setSearchParams, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates };

package/dist/index.js

@@ -4031,9 +4031,9 @@ function renderCell(value, type) {
 	}
 }
 /**
-* 从 Zod Schema 创建 ColumnDef 数组
+* 从 Zod Schema 创建 Table Schema (ColumnDef 数组)
 */
-function createColumns(schema, options) {
+function createTableSchema(schema, options) {
 	const shape = schema.shape;
 	const columns = [];
 	const { overrides, exclude = [] } = options ?? {};
@@ -4170,7 +4170,7 @@ function AutoTable({ schema, data, pageCount = 1, overrides, enableRowSelection
 	const { table, shallow, debounceMs, throttleMs } = useDataTable({
 		data,
 		columns: useMemo(() => {
-			const dataColumns = createColumns(schema, {
+			const dataColumns = createTableSchema(schema, {
 				overrides,
 				exclude
 			});
@@ -5982,4 +5982,4 @@ function createMemoryDataSource(initialData = []) {
 }
 
 //#endregion
-export { AutoCrudTable, AutoForm, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, CrudFormModal, DataTable, DataTableAdvancedToolbar, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableToolbar, DataTableViewOptions, SchemaAdapter, cn, createActionsColumn, createColumns, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, formatDate, getUrlParams, humanize, noopToastAdapter, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseZodField, setSearchParams, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates };
+export { AutoCrudTable, AutoForm, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, CrudFormModal, DataTable, DataTableAdvancedToolbar, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableToolbar, DataTableViewOptions, SchemaAdapter, cn, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, formatDate, getUrlParams, humanize, noopToastAdapter, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseZodField, setSearchParams, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wordrhyme/auto-crud",
   "type": "module",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Schema-first CRUD components with auto-generated tables and forms",
   "author": "wordrhyme",
   "license": "MIT",
@@ -82,10 +82,10 @@
     "tsdown": "^0.15.12",
     "typescript": "^5.9.3",
     "@internal/eslint-config": "0.3.0",
-    "@internal/prettier-config": "0.0.1",
-    "@internal/tsdown-config": "0.1.0",
     "@internal/tsconfig": "0.1.0",
-    "@internal/vitest-config": "0.1.0"
+    "@internal/tsdown-config": "0.1.0",
+    "@internal/vitest-config": "0.1.0",
+    "@internal/prettier-config": "0.0.1"
   },
   "prettier": "@internal/prettier-config",
   "scripts": {