@wordrhyme/auto-crud 1.2.3 → 1.2.5

package/README.md

@@ -277,7 +277,9 @@ interface AutoCrudTableProps<TSchema> {
    * - 只传 custom 项：内置保持默认，custom 追加到首/尾
    * - 包含任意内置 type：数组完全接管，未列出的内置项自动隐藏
    */
-  toolbarActions?: ToolbarActionItem[];
+  toolbar?: ToolbarActionConfig;
+  /** @deprecated 新代码请使用 toolbar */
+  toolbarActions?: ToolbarActionConfig;
   /**
    * 行操作配置
    * - 只传 custom 项：内置保持默认，custom 追加到首/尾
@@ -304,6 +306,9 @@ interface UseAutoCrudResourceConfig<TData> {
 
 ```typescript
 interface UseAutoCrudResourceReturn<TSchema, TData> {
+  // 主键字段名；未提供时 AutoCrudTable 默认按 "id" 读取
+  idKey?: keyof TData & string;
+
   // 表格数据
   tableData: {
     data: TData[];
@@ -529,7 +534,7 @@ table={{
 
 ## 🔧 工具栏操作配置
 
-`toolbarActions` 数组控制页面顶部右侧工具栏的按钮，设计思路完全对齐行操作 `actions`。
+`toolbar` 数组控制页面顶部右侧工具栏的按钮，设计思路完全对齐行操作 `actions`。旧 prop `toolbarActions` 仍兼容读取，但新代码请使用 `toolbar`。
 
 内置操作类型：`create`（新建）、`import`（导入）、`export`（导出）。
 
@@ -539,7 +544,7 @@ table={{
 
 ```tsx
 <AutoCrudTable
-  toolbarActions={[
+  toolbar={[
     {
       type: 'custom',
       component: <Button variant="outline">分类管理</Button>,
@@ -557,7 +562,7 @@ table={{
 
 ```tsx
 <AutoCrudTable
-  toolbarActions={[
+  toolbar={[
     { type: 'create' }, // 新建移到最前
     { type: 'export', label: '导出 CSV' }, // 覆盖文案
     // import 未列出 → 隐藏
@@ -570,7 +575,7 @@ table={{
 
 ```tsx
 <AutoCrudTable
-  toolbarActions={[
+  toolbar={[
     { type: 'import' },
     { type: 'export' },
     {
@@ -586,7 +591,7 @@ table={{
 
 ```tsx
 <AutoCrudTable
-  toolbarActions={[
+  toolbar={[
     { type: 'export' },
     {
       type: 'create',
@@ -614,7 +619,7 @@ table={{
 
 ```tsx
 <AutoCrudTable
-  toolbarActions={[
+  toolbar={[
     { type: 'custom', component: <CategoryFilter onChange={setCategory} /> },
     { type: 'export' },
     { type: 'create', label: '发布', onClick: () => router.push('/products/new') },
@@ -625,7 +630,7 @@ table={{
 
 ### 与 `permissions` 的交互
 
-`toolbarActions` 与 `permissions` 的交互规则如下：
+`toolbar` 与 `permissions` 的交互规则如下：
 
 - `permissions.can.create = false` → 即使配置了 `{ type: "create" }`，新建按钮仍不渲染
 - `permissions.can.export = false` → 即使配置了 `{ type: "export" }`，导出按钮仍不渲染
@@ -637,7 +642,7 @@ table={{
   permissions={{
     can: { create: isAdmin, export: true, delete: isAdmin },
   }}
-  toolbarActions={[
+  toolbar={[
     { type: 'export' }, // ✅ 始终渲染
     { type: 'create', label: '发布商品' }, // 🔒 仅 isAdmin 时渲染
     {
@@ -648,14 +653,14 @@ table={{
 />
 ```
 
-### `toolbarActions` 传参高级语法（函数式）
+### `toolbar` 传参高级语法（函数式）
 
 如果你的目标是拦截并修改基于原顺序的所有内容，你还可以传递一个函数：
 
 ```tsx
 <AutoCrudTable
   // defaults 即内置三个按钮的信息，在此数组里你可以随意 map、过滤或插值
-  toolbarActions={(defaults) =>
+  toolbar={(defaults) =>
     defaults.map((btn) =>
       btn.type === 'create'
         ? { ...btn, label: '发布商品', onClick: () => router.push('/products/new') }
@@ -671,6 +676,10 @@ table={{
 ```typescript
 type ToolbarActionItem = ToolbarBuiltinActionItem | ToolbarCustomActionItem;
 
+type ToolbarActionConfig =
+  | ToolbarActionItem[]
+  | ((defaults: ToolbarBuiltinActionItem[]) => ToolbarActionItem[]);
+
 type ToolbarBuiltinActionItem = {
   type: 'create' | 'import' | 'export';
   onClick?: () => void; // 覆盖默认行为
@@ -685,6 +694,29 @@ type ToolbarCustomActionItem = {
 };
 ```
 
+### 工具栏扩展 Resolver
+
+宿主应用可以通过 `setToolbarResolver` 为指定 CRUD 注入额外工具栏动作。resolver 是普通纯函数，不是 React Hook；不要在 resolver 内调用 `useRouter`、`useMemo` 等 React Hooks。
+
+```tsx
+import { AutoCrudTable, setToolbarResolver } from '@wordrhyme/auto-crud';
+import type { AutoCrudToolbarResolver } from '@wordrhyme/auto-crud';
+
+const toolbarResolver: AutoCrudToolbarResolver = (targetId, ownerActions, context) => {
+  if (targetId !== 'com.wordrhyme.shop.products') return [...ownerActions];
+
+  return [
+    ...ownerActions,
+    {
+      type: 'custom',
+      component: <Button disabled={context.selectedCount === 0}>批量发布</Button>,
+    },
+  ];
+};
+
+setToolbarResolver(toolbarResolver);
+```
+
 ---
 
 ## 🎬 行操作配置
@@ -790,7 +822,7 @@ type ActionItem<T> =
 
 ### 批量悬浮栏操作顺序
 
-`table.batchActions` 控制多选后悬浮操作栏，设计思路对齐行操作 `actions` 和顶部 `toolbarActions`。
+`table.batchActions` 控制多选后悬浮操作栏，设计思路对齐行操作 `actions` 和顶部 `toolbar`。
 
 内置操作类型：`batchUpdate`（批量更新字段下拉）、`export`（导出选中行）、`delete`（删除选中行）。
 

package/dist/index.cjs

@@ -4907,7 +4907,7 @@ const filterModeConfig = {
 		tooltip: "Linear-style command filters"
 	}
 };
-function AutoTable({ schema, data, pageCount = 1, overrides, enableRowSelection = true, exclude, actions, pinnedColumns, filterMode = "simple", search = false, onDeleteSelected, onUpdateSelected, batchUpdateFields, actionBarExtra, actionBarActions, initialSorting, enableExport = true, showDefaultExport = true, onSelectedCountChange, getSelectedRows }) {
+function AutoTable({ schema, data, pageCount = 1, overrides, enableRowSelection = true, exclude, actions, pinnedColumns, filterMode = "simple", search = false, onDeleteSelected, onUpdateSelected, batchUpdateFields, actionBarExtra, actionBarActions, initialSorting, enableExport = true, showDefaultExport = true, onSelectedCountChange, onSelectedRowsChange, getSelectedRows }) {
 	const modes = filterMode ? Array.isArray(filterMode) ? filterMode : [filterMode] : DEFAULT_MODES;
 	const [currentMode, setCurrentMode] = useQueryState("filterMode", parseAsStringEnum(modes).withDefault(modes[0] ?? "simple"));
 	const showToggle = modes.length > 1;
@@ -4956,17 +4956,28 @@ function AutoTable({ schema, data, pageCount = 1, overrides, enableRowSelection
 		shallow: false,
 		clearOnDefault: true
 	});
-	const getSelectedRowsFn = (0, react.useCallback)(() => table.getFilteredSelectedRowModel().rows.map((row) => row.original), [table]);
+	const rowSelection = table.getState().rowSelection;
+	const columnFilters = table.getState().columnFilters;
+	const selectedRows = (0, react.useMemo)(() => table.getFilteredSelectedRowModel().rows.map((row) => row.original), [
+		table,
+		rowSelection,
+		columnFilters,
+		data
+	]);
+	const getSelectedRowsFn = (0, react.useCallback)(() => selectedRows, [selectedRows]);
 	(0, react.useEffect)(() => {
 		if (getSelectedRows) getSelectedRows.current = getSelectedRowsFn;
 		return () => {
 			if (getSelectedRows) getSelectedRows.current = null;
 		};
 	}, [getSelectedRows, getSelectedRowsFn]);
-	const selectedRowCount = table.getFilteredSelectedRowModel().rows.length;
+	const selectedRowCount = selectedRows.length;
 	(0, react.useEffect)(() => {
 		onSelectedCountChange?.(selectedRowCount);
 	}, [selectedRowCount, onSelectedCountChange]);
+	(0, react.useEffect)(() => {
+		onSelectedRowsChange?.(selectedRows);
+	}, [selectedRows, onSelectedRowsChange]);
 	const FilterModeSelect = showToggle ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(__pixpilot_shadcn.DropdownMenu, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__pixpilot_shadcn.DropdownMenuTrigger, {
 		asChild: true,
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__pixpilot_shadcn.Button, {
@@ -6275,6 +6286,44 @@ function ImportDialog({ open, onOpenChange, onImport, columns = [], title, local
 
 //#endregion
 //#region src/components/auto-crud/auto-crud-table.tsx
+let autoCrudToolbarResolver = null;
+function setToolbarResolver(resolver) {
+	autoCrudToolbarResolver = resolver;
+}
+function getDefaultToolbarActions() {
+	return [
+		{ type: "import" },
+		{ type: "export" },
+		{ type: "create" }
+	];
+}
+function resolveOwnerToolbarActions(toolbar) {
+	const resolved = typeof toolbar === "function" ? toolbar(getDefaultToolbarActions()) : toolbar;
+	return resolved !== void 0 && resolved.length > 0 ? [...resolved] : getDefaultToolbarActions();
+}
+function readRowIds(rows, idKey) {
+	return rows.flatMap((row) => {
+		const value = row[idKey];
+		return value === null || value === void 0 ? [] : [String(value)];
+	});
+}
+function areStringArraysEqual(left, right) {
+	return left.length === right.length && left.every((value, index) => value === right[index]);
+}
+function haveSameRowSelection(left, right, idKey) {
+	if (left.length !== right.length) return false;
+	const leftIds = readRowIds(left, idKey);
+	const rightIds = readRowIds(right, idKey);
+	if (leftIds.length === left.length && rightIds.length === right.length) return areStringArraysEqual(leftIds, rightIds);
+	return left.every((row, index) => row === right[index]);
+}
+function readCreateAction(actions) {
+	return actions.find((action) => action.type === "create");
+}
+function resolveToolbarActionsWithResolver(targetId, ownerActions, context) {
+	const resolver = autoCrudToolbarResolver;
+	return targetId !== void 0 && targetId.length > 0 && resolver !== null ? resolver(targetId, ownerActions, context) : ownerActions;
+}
 function mergeFieldPart(base, override) {
 	if (override === void 0) return base;
 	if (override === false || base === false || typeof base !== "object" || typeof override !== "object" || base === null || override === null || Array.isArray(base) || Array.isArray(override)) return override;
@@ -6725,7 +6774,7 @@ function resolveActions(actionsOrFn, defaults, rowActionsLocale) {
 *
 * 高级 CRUD 表格组件，封装了完整的增删改查流程
 */
-function AutoCrudTable({ title, description, schema, resource, fields, table: tableConfig, form: formConfig, permissions, actions: actionItems, toolbarActions, locale: localeProp, onCreate }) {
+function AutoCrudTable({ id, title, description, schema, resource, fields, table: tableConfig, form: formConfig, permissions, actions: actionItems, toolbar, toolbarActions, locale: localeProp, onCreate }) {
 	const locale = resolveLocale(localeProp);
 	const resolvedSchema = resource.schema ?? schema;
 	const resolvedFields = react.useMemo(() => mergeFields(resource.fields, fields) ?? {}, [fields, resource.fields]);
@@ -6740,10 +6789,35 @@ function AutoCrudTable({ title, description, schema, resource, fields, table: ta
 	const canImport = can.import && !!resource.handlers.import;
 	const canExport = can.export;
 	const [importOpen, setImportOpen] = react.useState(false);
-	const [selectedCount, setSelectedCount] = react.useState(0);
+	const [selectedRows, setSelectedRows] = react.useState([]);
 	const [exporting, setExporting] = react.useState(false);
 	const getSelectedRowsRef = react.useRef(null);
 	const dynamicFilterOptions = useDynamicFilterOptions(resolvedFields);
+	const resourceIdKey = resource.idKey ?? "id";
+	const ownerToolbarActions = react.useMemo(() => resolveOwnerToolbarActions(toolbar ?? toolbarActions), [toolbar, toolbarActions]);
+	const selectedCount = selectedRows.length;
+	const selectedRowIds = react.useMemo(() => readRowIds(selectedRows, resourceIdKey), [selectedRows, resourceIdKey]);
+	const rowIds = react.useMemo(() => readRowIds(resource.tableData.data, resourceIdKey), [resource.tableData.data, resourceIdKey]);
+	const handleSelectedRowsChange = react.useCallback((rows) => {
+		setSelectedRows((currentRows) => haveSameRowSelection(currentRows, rows, resourceIdKey) ? currentRows : rows);
+	}, [resourceIdKey]);
+	const ownerCreateAction = react.useMemo(() => readCreateAction(ownerToolbarActions), [ownerToolbarActions]);
+	const toolbarOpenCreate = can.create ? ownerCreateAction?.onClick ?? onCreate ?? resource.handlers.openCreate : void 0;
+	const resolvedToolbarActions = resolveToolbarActionsWithResolver(id, ownerToolbarActions, react.useMemo(() => ({
+		crudId: id ?? "",
+		idKey: resourceIdKey,
+		rowIds,
+		selectedRowIds,
+		selectedCount,
+		...toolbarOpenCreate ? { openCreate: toolbarOpenCreate } : {}
+	}), [
+		id,
+		resourceIdKey,
+		rowIds,
+		selectedRowIds,
+		selectedCount,
+		toolbarOpenCreate
+	]));
 	const importColumns = react.useMemo(() => {
 		const shape = resolvedSchema.shape;
 		const denySet = new Set(denyFields ?? []);
@@ -6753,9 +6827,9 @@ function AutoCrudTable({ title, description, schema, resource, fields, table: ta
 		const filename = title ?? "export";
 		const excludeColumns = denyFields;
 		if (mode === "selected") {
-			const selectedRows = getSelectedRowsRef.current?.();
-			if (!selectedRows || selectedRows.length === 0) return;
-			exportAllToCSV(selectedRows, {
+			const selectedRows$1 = getSelectedRowsRef.current?.();
+			if (!selectedRows$1 || selectedRows$1.length === 0) return;
+			exportAllToCSV(selectedRows$1, {
 				filename,
 				excludeColumns
 			});
@@ -6849,11 +6923,6 @@ function AutoCrudTable({ title, description, schema, resource, fields, table: ta
 						}, "create");
 						return null;
 					};
-					const resolvedToolbarActions = typeof toolbarActions === "function" ? toolbarActions([
-						{ type: "import" },
-						{ type: "export" },
-						{ type: "create" }
-					]) : toolbarActions;
 					if (!resolvedToolbarActions || resolvedToolbarActions.length === 0) return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 						className: "flex items-center gap-2",
 						children: [
@@ -6911,7 +6980,7 @@ function AutoCrudTable({ title, description, schema, resource, fields, table: ta
 				enableExport: canExport,
 				showDefaultExport: false,
 				initialSorting: tableConfig?.defaultSort,
-				onSelectedCountChange: setSelectedCount,
+				onSelectedRowsChange: handleSelectedRowsChange,
 				getSelectedRows: getSelectedRowsRef
 			}),
 			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(CrudFormModal, {
@@ -7986,6 +8055,7 @@ function useAutoCrudResource({ router, schema, query: queryTransform, options =
 	]);
 	const canExport = !!(exportFetcher || exportQuery);
 	return {
+		idKey,
 		tableData: {
 			data: tableRows,
 			pageCount: listQuery.data?.pageCount ?? 0,
@@ -8381,6 +8451,7 @@ exports.parseJSON = parseJSON;
 exports.parseZodField = parseZodField;
 exports.resolveLocale = resolveLocale;
 exports.setSearchParams = setSearchParams;
+exports.setToolbarResolver = setToolbarResolver;
 exports.useAutoCrudResource = useAutoCrudResource;
 exports.useDataTable = useDataTable;
 exports.useQueryState = useQueryState;

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime3 from "react/jsx-runtime";
+import * as react_jsx_runtime1 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";
@@ -119,6 +119,8 @@ interface ImportResult {
  * Hook 返回值类型
  */
 interface UseAutoCrudResourceReturn<TSchema extends z.ZodObject<z.ZodRawShape>, TListItem> {
+  /** 主键字段名（默认: "id"） */
+  idKey?: keyof TListItem & string;
   tableData: {
     data: TListItem[];
     pageCount: number;
@@ -362,7 +364,7 @@ declare function AutoTableActionBar<TData>({
   enableDelete,
   extraActions,
   actions
-}: AutoTableActionBarProps<TData>): react_jsx_runtime3.JSX.Element;
+}: AutoTableActionBarProps<TData>): react_jsx_runtime1.JSX.Element;
 //#endregion
 //#region src/lib/schema-bridge/types.d.ts
 /**
@@ -506,6 +508,8 @@ interface AutoTableProps<T extends z.ZodObject<z.ZodRawShape>> {
   showDefaultExport?: boolean;
   /** 选中行数变化回调（用于外层组件获知选中状态） */
   onSelectedCountChange?: (count: number) => void;
+  /** 选中行数据变化回调（用于外层组件获知选中行身份变化） */
+  onSelectedRowsChange?: (rows: z.infer<T>[]) => void;
   /** 获取选中行数据的回调（由外层组件调用） */
   getSelectedRows?: React.MutableRefObject<(() => z.infer<T>[]) | null>;
 }
@@ -529,8 +533,9 @@ declare function AutoTable<T extends z.ZodObject<z.ZodRawShape>>({
   enableExport,
   showDefaultExport,
   onSelectedCountChange,
+  onSelectedRowsChange,
   getSelectedRows
-}: AutoTableProps<T>): react_jsx_runtime3.JSX.Element;
+}: AutoTableProps<T>): react_jsx_runtime1.JSX.Element;
 //#endregion
 //#region src/i18n/locale.d.ts
 /**
@@ -823,6 +828,16 @@ type ToolbarCustomActionItem = {
 };
 type ToolbarActionItem = ToolbarBuiltinActionItem | ToolbarCustomActionItem;
 type ToolbarActionConfig = ToolbarActionItem[] | ((defaults: ToolbarBuiltinActionItem[]) => ToolbarActionItem[]);
+interface AutoCrudToolbarContext {
+  crudId: string;
+  idKey: string;
+  rowIds: string[];
+  selectedRowIds: string[];
+  selectedCount: number;
+  openCreate?: () => void;
+}
+type AutoCrudToolbarResolver = (targetId: string, ownerActions: readonly ToolbarActionItem[], context: AutoCrudToolbarContext) => ToolbarActionItem[];
+declare function setToolbarResolver(resolver: AutoCrudToolbarResolver | null): void;
 /**
  * AutoCrudTable Props 接口
  */
@@ -866,7 +881,7 @@ interface AutoCrudTableProps<TSchema extends z.ZodObject<z.ZodRawShape>> {
     batchFields?: (string | BatchUpdateField)[];
     /**
      * 多选后悬浮批量操作栏配置
-     * 用法类同 `actions` 行操作和 `toolbarActions` 顶部工具栏。
+     * 用法类同 `actions` 行操作和 `toolbar` 顶部工具栏。
      * 只传 custom 时保留默认批量操作；包含任意内置 type 时完全接管顺序。
      */
     batchActions?: BatchActionConfig<z.output<TSchema>>;
@@ -888,6 +903,8 @@ interface AutoCrudTableProps<TSchema extends z.ZodObject<z.ZodRawShape>> {
    * 顶层工具栏操作配置
    * 用法类同 `actions` 行操作。一旦配置了包含内置 `type` 的数组，它将完全接管右侧工具栏！
    */
+  toolbar?: ToolbarActionConfig;
+  /** @deprecated Use toolbar instead. */
   toolbarActions?: ToolbarActionConfig;
   /**
    * 权限配置
@@ -934,6 +951,7 @@ interface AutoCrudTableProps<TSchema extends z.ZodObject<z.ZodRawShape>> {
  * 高级 CRUD 表格组件，封装了完整的增删改查流程
  */
 declare function AutoCrudTable<TSchema extends z.ZodObject<z.ZodRawShape>>({
+  id,
   title,
   description,
   schema,
@@ -943,10 +961,11 @@ declare function AutoCrudTable<TSchema extends z.ZodObject<z.ZodRawShape>>({
   form: formConfig,
   permissions,
   actions: actionItems,
+  toolbar,
   toolbarActions,
   locale: localeProp,
   onCreate
-}: AutoCrudTableProps<TSchema>): react_jsx_runtime3.JSX.Element;
+}: AutoCrudTableProps<TSchema>): react_jsx_runtime1.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/auto-form.d.ts
 interface AutoFormProps<T extends z.ZodObject<z.ZodRawShape>> {
@@ -978,7 +997,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_runtime1.JSX.Element;
 declare const AutoForm: <T extends z.ZodObject<z.ZodRawShape>>(props: AutoFormProps<T> & {
   ref?: React.Ref<AutoFormRef>;
 }) => ReturnType<typeof AutoFormInner>;
@@ -1192,12 +1211,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";
@@ -1280,7 +1299,7 @@ declare function AutoTableSimpleFilters<TData>({
   filters: externalFilters,
   onFiltersChange,
   leading
-}: AutoTableSimpleFiltersProps<TData>): react_jsx_runtime3.JSX.Element | null;
+}: AutoTableSimpleFiltersProps<TData>): react_jsx_runtime1.JSX.Element | null;
 //#endregion
 //#region src/components/auto-crud/form-modal.d.ts
 type ModalVariant = "dialog" | "sheet";
@@ -1322,7 +1341,7 @@ declare function CrudFormModal<T extends z.ZodObject<z.ZodRawShape>>({
   labelAlign,
   labelWidth,
   className
-}: CrudFormModalProps<T>): react_jsx_runtime3.JSX.Element;
+}: CrudFormModalProps<T>): react_jsx_runtime1.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/import-dialog.d.ts
 interface ImportDialogProps {
@@ -1344,7 +1363,7 @@ declare function ImportDialog({
   columns,
   title,
   locale
-}: ImportDialogProps): react_jsx_runtime3.JSX.Element;
+}: ImportDialogProps): react_jsx_runtime1.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/export-dialog.d.ts
 type ExportMode = "selected" | "filtered";
@@ -1364,7 +1383,7 @@ declare function ExportDialog({
   selectedCount,
   onExport,
   canExportFiltered
-}: ExportDialogProps): react_jsx_runtime3.JSX.Element;
+}: ExportDialogProps): react_jsx_runtime1.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table.d.ts
 interface DataTableProps<TData> extends React$1.ComponentProps<"div"> {
@@ -1377,7 +1396,7 @@ declare function DataTable<TData>({
   children,
   className,
   ...props
-}: DataTableProps<TData>): react_jsx_runtime3.JSX.Element;
+}: DataTableProps<TData>): react_jsx_runtime1.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-advanced-toolbar.d.ts
 interface DataTableAdvancedToolbarProps<TData> extends React$1.ComponentProps<"div"> {
@@ -1388,7 +1407,7 @@ declare function DataTableAdvancedToolbar<TData>({
   children,
   className,
   ...props
-}: DataTableAdvancedToolbarProps<TData>): react_jsx_runtime3.JSX.Element;
+}: DataTableAdvancedToolbarProps<TData>): react_jsx_runtime1.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-column-header.d.ts
 interface DataTableColumnHeaderProps<TData, TValue> extends React.ComponentProps<typeof DropdownMenuTrigger> {
@@ -1400,7 +1419,7 @@ declare function DataTableColumnHeader<TData, TValue>({
   label,
   className,
   ...props
-}: DataTableColumnHeaderProps<TData, TValue>): react_jsx_runtime3.JSX.Element;
+}: DataTableColumnHeaderProps<TData, TValue>): react_jsx_runtime1.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-faceted-filter.d.ts
 interface DataTableFacetedFilterProps<TData, TValue> {
@@ -1414,7 +1433,7 @@ declare function DataTableFacetedFilter<TData, TValue>({
   title,
   options,
   multiple
-}: DataTableFacetedFilterProps<TData, TValue>): react_jsx_runtime3.JSX.Element;
+}: DataTableFacetedFilterProps<TData, TValue>): react_jsx_runtime1.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-pagination.d.ts
 interface DataTablePaginationProps<TData> extends React.ComponentProps<"div"> {
@@ -1426,7 +1445,7 @@ declare function DataTablePagination<TData>({
   pageSizeOptions,
   className,
   ...props
-}: DataTablePaginationProps<TData>): react_jsx_runtime3.JSX.Element;
+}: DataTablePaginationProps<TData>): react_jsx_runtime1.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-toolbar.d.ts
 interface DataTableToolbarProps<TData> extends React$1.ComponentProps<"div"> {
@@ -1437,7 +1456,7 @@ declare function DataTableToolbar<TData>({
   children,
   className,
   ...props
-}: DataTableToolbarProps<TData>): react_jsx_runtime3.JSX.Element;
+}: DataTableToolbarProps<TData>): react_jsx_runtime1.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-view-options.d.ts
 interface DataTableViewOptionsProps<TData> extends React$1.ComponentProps<typeof PopoverContent> {
@@ -1448,7 +1467,7 @@ declare function DataTableViewOptions<TData>({
   table,
   disabled,
   ...props
-}: DataTableViewOptionsProps<TData>): react_jsx_runtime3.JSX.Element;
+}: DataTableViewOptionsProps<TData>): react_jsx_runtime1.JSX.Element;
 //#endregion
 //#region src/components/ui/multi-combobox.d.ts
 interface MultiComboboxOption {
@@ -1825,4 +1844,4 @@ declare function exportAllToCSV<T extends Record<string, unknown>>(data: T[], op
  */
 declare function downloadCSVTemplate(headers: string[], filename?: string): void;
 //#endregion
-export { type ActionItem, type ActionsColumnConfig, type AutoCrudDataSourceConfig, type AutoCrudDataSourceContext, type AutoCrudDataSourceEntry, type AutoCrudDataSourceLoader, type AutoCrudDataSourceRegistration, type AutoCrudFormComponentConfig, type AutoCrudLocale, type AutoCrudOption, AutoCrudTable, type AutoCrudTableProps, AutoForm, type AutoQueryParams, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, type BatchActionConfig, type BatchActionContext, type BatchActionItem, type BatchBuiltinActionItem, type BatchBuiltinActionType, type BatchCustomActionItem, type BatchUpdateField, type ColumnOverrides, type CreateFormSchemaOptions, type CreateTableSchemaOptions, CrudFormModal, type CrudHooks, type CrudOperationPermissions, type CrudPermissions, type DataSource, DataTable, DataTableAdvancedToolbar, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableRowAction, DataTableToolbar, DataTableViewOptions, type EnumOption, ExportDialog, type ExportDialogProps, type ExportMode, ExtendedColumnFilter, ExtendedColumnSort, type Field, type FieldOption, type FieldType, type Fields, type FilterConfig, FilterOperator, type FilterVariant, type FormSchemaOverrides, ImportDialog, type ImportDialogProps, type ImportResult, type JSONSchema, type JSONSchemaProperty, JoinOperator, type ListParams, type ListResult, type LocaleProp, MultiCombobox, type MultiComboboxOption, type MultiComboboxProps, type MultiComboboxTriggerRenderProps, Option, type ParsedImportData, type ParsedZodField, type Parser, QueryKeys, SchemaAdapter, type SimpleFieldConfig, type SimpleFieldsConfig, type ToastAdapter, type ToolbarActionItem, type ToolbarBuiltinActionItem, type ToolbarCustomActionItem, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, type UseAutoCrudResourceParams, type UseAutoCrudResourceReturn, cn, coerceRowValues, components, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, dataSources, dataToCSV, deDE, downloadCSVTemplate, enUS, esES, exportAllToCSV, exportTableToCSV, formComponents, formatDate, frFR, generateCSVTemplate, getUrlParams, humanize, jaJP, koKR, noopToastAdapter, normalizeDataSourceConfig, normalizeOptions, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseCSV, parseImportFile, parseJSON, parseZodField, resolveLocale, setSearchParams, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates, zhCN };
+export { type ActionItem, type ActionsColumnConfig, type AutoCrudDataSourceConfig, type AutoCrudDataSourceContext, type AutoCrudDataSourceEntry, type AutoCrudDataSourceLoader, type AutoCrudDataSourceRegistration, type AutoCrudFormComponentConfig, type AutoCrudLocale, type AutoCrudOption, AutoCrudTable, type AutoCrudTableProps, type AutoCrudToolbarContext, type AutoCrudToolbarResolver, AutoForm, type AutoQueryParams, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, type BatchActionConfig, type BatchActionContext, type BatchActionItem, type BatchBuiltinActionItem, type BatchBuiltinActionType, type BatchCustomActionItem, type BatchUpdateField, type ColumnOverrides, type CreateFormSchemaOptions, type CreateTableSchemaOptions, CrudFormModal, type CrudHooks, type CrudOperationPermissions, type CrudPermissions, type DataSource, DataTable, DataTableAdvancedToolbar, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableRowAction, DataTableToolbar, DataTableViewOptions, type EnumOption, ExportDialog, type ExportDialogProps, type ExportMode, ExtendedColumnFilter, ExtendedColumnSort, type Field, type FieldOption, type FieldType, type Fields, type FilterConfig, FilterOperator, type FilterVariant, type FormSchemaOverrides, ImportDialog, type ImportDialogProps, type ImportResult, type JSONSchema, type JSONSchemaProperty, JoinOperator, type ListParams, type ListResult, type LocaleProp, MultiCombobox, type MultiComboboxOption, type MultiComboboxProps, type MultiComboboxTriggerRenderProps, Option, type ParsedImportData, type ParsedZodField, type Parser, QueryKeys, SchemaAdapter, type SimpleFieldConfig, type SimpleFieldsConfig, type ToastAdapter, type ToolbarActionConfig, type ToolbarActionItem, type ToolbarBuiltinActionItem, type ToolbarCustomActionItem, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, type UseAutoCrudResourceParams, type UseAutoCrudResourceReturn, cn, coerceRowValues, components, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, dataSources, dataToCSV, deDE, downloadCSVTemplate, enUS, esES, exportAllToCSV, exportTableToCSV, formComponents, formatDate, frFR, generateCSVTemplate, getUrlParams, humanize, jaJP, koKR, noopToastAdapter, normalizeDataSourceConfig, normalizeOptions, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseCSV, parseImportFile, parseJSON, parseZodField, resolveLocale, setSearchParams, setToolbarResolver, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates, zhCN };

package/dist/index.d.ts

@@ -119,6 +119,8 @@ interface ImportResult {
  * Hook 返回值类型
  */
 interface UseAutoCrudResourceReturn<TSchema extends z.ZodObject<z.ZodRawShape>, TListItem> {
+  /** 主键字段名（默认: "id"） */
+  idKey?: keyof TListItem & string;
   tableData: {
     data: TListItem[];
     pageCount: number;
@@ -506,6 +508,8 @@ interface AutoTableProps<T extends z.ZodObject<z.ZodRawShape>> {
   showDefaultExport?: boolean;
   /** 选中行数变化回调（用于外层组件获知选中状态） */
   onSelectedCountChange?: (count: number) => void;
+  /** 选中行数据变化回调（用于外层组件获知选中行身份变化） */
+  onSelectedRowsChange?: (rows: z.infer<T>[]) => void;
   /** 获取选中行数据的回调（由外层组件调用） */
   getSelectedRows?: React.MutableRefObject<(() => z.infer<T>[]) | null>;
 }
@@ -529,6 +533,7 @@ declare function AutoTable<T extends z.ZodObject<z.ZodRawShape>>({
   enableExport,
   showDefaultExport,
   onSelectedCountChange,
+  onSelectedRowsChange,
   getSelectedRows
 }: AutoTableProps<T>): react_jsx_runtime2.JSX.Element;
 //#endregion
@@ -823,6 +828,16 @@ type ToolbarCustomActionItem = {
 };
 type ToolbarActionItem = ToolbarBuiltinActionItem | ToolbarCustomActionItem;
 type ToolbarActionConfig = ToolbarActionItem[] | ((defaults: ToolbarBuiltinActionItem[]) => ToolbarActionItem[]);
+interface AutoCrudToolbarContext {
+  crudId: string;
+  idKey: string;
+  rowIds: string[];
+  selectedRowIds: string[];
+  selectedCount: number;
+  openCreate?: () => void;
+}
+type AutoCrudToolbarResolver = (targetId: string, ownerActions: readonly ToolbarActionItem[], context: AutoCrudToolbarContext) => ToolbarActionItem[];
+declare function setToolbarResolver(resolver: AutoCrudToolbarResolver | null): void;
 /**
  * AutoCrudTable Props 接口
  */
@@ -866,7 +881,7 @@ interface AutoCrudTableProps<TSchema extends z.ZodObject<z.ZodRawShape>> {
     batchFields?: (string | BatchUpdateField)[];
     /**
      * 多选后悬浮批量操作栏配置
-     * 用法类同 `actions` 行操作和 `toolbarActions` 顶部工具栏。
+     * 用法类同 `actions` 行操作和 `toolbar` 顶部工具栏。
      * 只传 custom 时保留默认批量操作；包含任意内置 type 时完全接管顺序。
      */
     batchActions?: BatchActionConfig<z.output<TSchema>>;
@@ -888,6 +903,8 @@ interface AutoCrudTableProps<TSchema extends z.ZodObject<z.ZodRawShape>> {
    * 顶层工具栏操作配置
    * 用法类同 `actions` 行操作。一旦配置了包含内置 `type` 的数组，它将完全接管右侧工具栏！
    */
+  toolbar?: ToolbarActionConfig;
+  /** @deprecated Use toolbar instead. */
   toolbarActions?: ToolbarActionConfig;
   /**
    * 权限配置
@@ -934,6 +951,7 @@ interface AutoCrudTableProps<TSchema extends z.ZodObject<z.ZodRawShape>> {
  * 高级 CRUD 表格组件，封装了完整的增删改查流程
  */
 declare function AutoCrudTable<TSchema extends z.ZodObject<z.ZodRawShape>>({
+  id,
   title,
   description,
   schema,
@@ -943,6 +961,7 @@ declare function AutoCrudTable<TSchema extends z.ZodObject<z.ZodRawShape>>({
   form: formConfig,
   permissions,
   actions: actionItems,
+  toolbar,
   toolbarActions,
   locale: localeProp,
   onCreate
@@ -1192,12 +1211,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";
@@ -1825,4 +1844,4 @@ declare function exportAllToCSV<T extends Record<string, unknown>>(data: T[], op
  */
 declare function downloadCSVTemplate(headers: string[], filename?: string): void;
 //#endregion
-export { type ActionItem, type ActionsColumnConfig, type AutoCrudDataSourceConfig, type AutoCrudDataSourceContext, type AutoCrudDataSourceEntry, type AutoCrudDataSourceLoader, type AutoCrudDataSourceRegistration, type AutoCrudFormComponentConfig, type AutoCrudLocale, type AutoCrudOption, AutoCrudTable, type AutoCrudTableProps, AutoForm, type AutoQueryParams, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, type BatchActionConfig, type BatchActionContext, type BatchActionItem, type BatchBuiltinActionItem, type BatchBuiltinActionType, type BatchCustomActionItem, type BatchUpdateField, type ColumnOverrides, type CreateFormSchemaOptions, type CreateTableSchemaOptions, CrudFormModal, type CrudHooks, type CrudOperationPermissions, type CrudPermissions, type DataSource, DataTable, DataTableAdvancedToolbar, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableRowAction, DataTableToolbar, DataTableViewOptions, type EnumOption, ExportDialog, type ExportDialogProps, type ExportMode, ExtendedColumnFilter, ExtendedColumnSort, type Field, type FieldOption, type FieldType, type Fields, type FilterConfig, FilterOperator, type FilterVariant, type FormSchemaOverrides, ImportDialog, type ImportDialogProps, type ImportResult, type JSONSchema, type JSONSchemaProperty, JoinOperator, type ListParams, type ListResult, type LocaleProp, MultiCombobox, type MultiComboboxOption, type MultiComboboxProps, type MultiComboboxTriggerRenderProps, Option, type ParsedImportData, type ParsedZodField, type Parser, QueryKeys, SchemaAdapter, type SimpleFieldConfig, type SimpleFieldsConfig, type ToastAdapter, type ToolbarActionItem, type ToolbarBuiltinActionItem, type ToolbarCustomActionItem, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, type UseAutoCrudResourceParams, type UseAutoCrudResourceReturn, cn, coerceRowValues, components, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, dataSources, dataToCSV, deDE, downloadCSVTemplate, enUS, esES, exportAllToCSV, exportTableToCSV, formComponents, formatDate, frFR, generateCSVTemplate, getUrlParams, humanize, jaJP, koKR, noopToastAdapter, normalizeDataSourceConfig, normalizeOptions, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseCSV, parseImportFile, parseJSON, parseZodField, resolveLocale, setSearchParams, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates, zhCN };
+export { type ActionItem, type ActionsColumnConfig, type AutoCrudDataSourceConfig, type AutoCrudDataSourceContext, type AutoCrudDataSourceEntry, type AutoCrudDataSourceLoader, type AutoCrudDataSourceRegistration, type AutoCrudFormComponentConfig, type AutoCrudLocale, type AutoCrudOption, AutoCrudTable, type AutoCrudTableProps, type AutoCrudToolbarContext, type AutoCrudToolbarResolver, AutoForm, type AutoQueryParams, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, type BatchActionConfig, type BatchActionContext, type BatchActionItem, type BatchBuiltinActionItem, type BatchBuiltinActionType, type BatchCustomActionItem, type BatchUpdateField, type ColumnOverrides, type CreateFormSchemaOptions, type CreateTableSchemaOptions, CrudFormModal, type CrudHooks, type CrudOperationPermissions, type CrudPermissions, type DataSource, DataTable, DataTableAdvancedToolbar, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableRowAction, DataTableToolbar, DataTableViewOptions, type EnumOption, ExportDialog, type ExportDialogProps, type ExportMode, ExtendedColumnFilter, ExtendedColumnSort, type Field, type FieldOption, type FieldType, type Fields, type FilterConfig, FilterOperator, type FilterVariant, type FormSchemaOverrides, ImportDialog, type ImportDialogProps, type ImportResult, type JSONSchema, type JSONSchemaProperty, JoinOperator, type ListParams, type ListResult, type LocaleProp, MultiCombobox, type MultiComboboxOption, type MultiComboboxProps, type MultiComboboxTriggerRenderProps, Option, type ParsedImportData, type ParsedZodField, type Parser, QueryKeys, SchemaAdapter, type SimpleFieldConfig, type SimpleFieldsConfig, type ToastAdapter, type ToolbarActionConfig, type ToolbarActionItem, type ToolbarBuiltinActionItem, type ToolbarCustomActionItem, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, type UseAutoCrudResourceParams, type UseAutoCrudResourceReturn, cn, coerceRowValues, components, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, dataSources, dataToCSV, deDE, downloadCSVTemplate, enUS, esES, exportAllToCSV, exportTableToCSV, formComponents, formatDate, frFR, generateCSVTemplate, getUrlParams, humanize, jaJP, koKR, noopToastAdapter, normalizeDataSourceConfig, normalizeOptions, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseCSV, parseImportFile, parseJSON, parseZodField, resolveLocale, setSearchParams, setToolbarResolver, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates, zhCN };

package/dist/index.js

@@ -4864,7 +4864,7 @@ const filterModeConfig = {
 		tooltip: "Linear-style command filters"
 	}
 };
-function AutoTable({ schema, data, pageCount = 1, overrides, enableRowSelection = true, exclude, actions, pinnedColumns, filterMode = "simple", search = false, onDeleteSelected, onUpdateSelected, batchUpdateFields, actionBarExtra, actionBarActions, initialSorting, enableExport = true, showDefaultExport = true, onSelectedCountChange, getSelectedRows }) {
+function AutoTable({ schema, data, pageCount = 1, overrides, enableRowSelection = true, exclude, actions, pinnedColumns, filterMode = "simple", search = false, onDeleteSelected, onUpdateSelected, batchUpdateFields, actionBarExtra, actionBarActions, initialSorting, enableExport = true, showDefaultExport = true, onSelectedCountChange, onSelectedRowsChange, getSelectedRows }) {
 	const modes = filterMode ? Array.isArray(filterMode) ? filterMode : [filterMode] : DEFAULT_MODES;
 	const [currentMode, setCurrentMode] = useQueryState("filterMode", parseAsStringEnum(modes).withDefault(modes[0] ?? "simple"));
 	const showToggle = modes.length > 1;
@@ -4913,17 +4913,28 @@ function AutoTable({ schema, data, pageCount = 1, overrides, enableRowSelection
 		shallow: false,
 		clearOnDefault: true
 	});
-	const getSelectedRowsFn = useCallback(() => table.getFilteredSelectedRowModel().rows.map((row) => row.original), [table]);
+	const rowSelection = table.getState().rowSelection;
+	const columnFilters = table.getState().columnFilters;
+	const selectedRows = useMemo(() => table.getFilteredSelectedRowModel().rows.map((row) => row.original), [
+		table,
+		rowSelection,
+		columnFilters,
+		data
+	]);
+	const getSelectedRowsFn = useCallback(() => selectedRows, [selectedRows]);
 	useEffect(() => {
 		if (getSelectedRows) getSelectedRows.current = getSelectedRowsFn;
 		return () => {
 			if (getSelectedRows) getSelectedRows.current = null;
 		};
 	}, [getSelectedRows, getSelectedRowsFn]);
-	const selectedRowCount = table.getFilteredSelectedRowModel().rows.length;
+	const selectedRowCount = selectedRows.length;
 	useEffect(() => {
 		onSelectedCountChange?.(selectedRowCount);
 	}, [selectedRowCount, onSelectedCountChange]);
+	useEffect(() => {
+		onSelectedRowsChange?.(selectedRows);
+	}, [selectedRows, onSelectedRowsChange]);
 	const FilterModeSelect = showToggle ? /* @__PURE__ */ jsxs(DropdownMenu, { children: [/* @__PURE__ */ jsx(DropdownMenuTrigger, {
 		asChild: true,
 		children: /* @__PURE__ */ jsx(Button, {
@@ -6232,6 +6243,44 @@ function ImportDialog({ open, onOpenChange, onImport, columns = [], title, local
 
 //#endregion
 //#region src/components/auto-crud/auto-crud-table.tsx
+let autoCrudToolbarResolver = null;
+function setToolbarResolver(resolver) {
+	autoCrudToolbarResolver = resolver;
+}
+function getDefaultToolbarActions() {
+	return [
+		{ type: "import" },
+		{ type: "export" },
+		{ type: "create" }
+	];
+}
+function resolveOwnerToolbarActions(toolbar) {
+	const resolved = typeof toolbar === "function" ? toolbar(getDefaultToolbarActions()) : toolbar;
+	return resolved !== void 0 && resolved.length > 0 ? [...resolved] : getDefaultToolbarActions();
+}
+function readRowIds(rows, idKey) {
+	return rows.flatMap((row) => {
+		const value = row[idKey];
+		return value === null || value === void 0 ? [] : [String(value)];
+	});
+}
+function areStringArraysEqual(left, right) {
+	return left.length === right.length && left.every((value, index) => value === right[index]);
+}
+function haveSameRowSelection(left, right, idKey) {
+	if (left.length !== right.length) return false;
+	const leftIds = readRowIds(left, idKey);
+	const rightIds = readRowIds(right, idKey);
+	if (leftIds.length === left.length && rightIds.length === right.length) return areStringArraysEqual(leftIds, rightIds);
+	return left.every((row, index) => row === right[index]);
+}
+function readCreateAction(actions) {
+	return actions.find((action) => action.type === "create");
+}
+function resolveToolbarActionsWithResolver(targetId, ownerActions, context) {
+	const resolver = autoCrudToolbarResolver;
+	return targetId !== void 0 && targetId.length > 0 && resolver !== null ? resolver(targetId, ownerActions, context) : ownerActions;
+}
 function mergeFieldPart(base, override) {
 	if (override === void 0) return base;
 	if (override === false || base === false || typeof base !== "object" || typeof override !== "object" || base === null || override === null || Array.isArray(base) || Array.isArray(override)) return override;
@@ -6682,7 +6731,7 @@ function resolveActions(actionsOrFn, defaults, rowActionsLocale) {
 *
 * 高级 CRUD 表格组件，封装了完整的增删改查流程
 */
-function AutoCrudTable({ title, description, schema, resource, fields, table: tableConfig, form: formConfig, permissions, actions: actionItems, toolbarActions, locale: localeProp, onCreate }) {
+function AutoCrudTable({ id, title, description, schema, resource, fields, table: tableConfig, form: formConfig, permissions, actions: actionItems, toolbar, toolbarActions, locale: localeProp, onCreate }) {
 	const locale = resolveLocale(localeProp);
 	const resolvedSchema = resource.schema ?? schema;
 	const resolvedFields = React.useMemo(() => mergeFields(resource.fields, fields) ?? {}, [fields, resource.fields]);
@@ -6697,10 +6746,35 @@ function AutoCrudTable({ title, description, schema, resource, fields, table: ta
 	const canImport = can.import && !!resource.handlers.import;
 	const canExport = can.export;
 	const [importOpen, setImportOpen] = React.useState(false);
-	const [selectedCount, setSelectedCount] = React.useState(0);
+	const [selectedRows, setSelectedRows] = React.useState([]);
 	const [exporting, setExporting] = React.useState(false);
 	const getSelectedRowsRef = React.useRef(null);
 	const dynamicFilterOptions = useDynamicFilterOptions(resolvedFields);
+	const resourceIdKey = resource.idKey ?? "id";
+	const ownerToolbarActions = React.useMemo(() => resolveOwnerToolbarActions(toolbar ?? toolbarActions), [toolbar, toolbarActions]);
+	const selectedCount = selectedRows.length;
+	const selectedRowIds = React.useMemo(() => readRowIds(selectedRows, resourceIdKey), [selectedRows, resourceIdKey]);
+	const rowIds = React.useMemo(() => readRowIds(resource.tableData.data, resourceIdKey), [resource.tableData.data, resourceIdKey]);
+	const handleSelectedRowsChange = React.useCallback((rows) => {
+		setSelectedRows((currentRows) => haveSameRowSelection(currentRows, rows, resourceIdKey) ? currentRows : rows);
+	}, [resourceIdKey]);
+	const ownerCreateAction = React.useMemo(() => readCreateAction(ownerToolbarActions), [ownerToolbarActions]);
+	const toolbarOpenCreate = can.create ? ownerCreateAction?.onClick ?? onCreate ?? resource.handlers.openCreate : void 0;
+	const resolvedToolbarActions = resolveToolbarActionsWithResolver(id, ownerToolbarActions, React.useMemo(() => ({
+		crudId: id ?? "",
+		idKey: resourceIdKey,
+		rowIds,
+		selectedRowIds,
+		selectedCount,
+		...toolbarOpenCreate ? { openCreate: toolbarOpenCreate } : {}
+	}), [
+		id,
+		resourceIdKey,
+		rowIds,
+		selectedRowIds,
+		selectedCount,
+		toolbarOpenCreate
+	]));
 	const importColumns = React.useMemo(() => {
 		const shape = resolvedSchema.shape;
 		const denySet = new Set(denyFields ?? []);
@@ -6710,9 +6784,9 @@ function AutoCrudTable({ title, description, schema, resource, fields, table: ta
 		const filename = title ?? "export";
 		const excludeColumns = denyFields;
 		if (mode === "selected") {
-			const selectedRows = getSelectedRowsRef.current?.();
-			if (!selectedRows || selectedRows.length === 0) return;
-			exportAllToCSV(selectedRows, {
+			const selectedRows$1 = getSelectedRowsRef.current?.();
+			if (!selectedRows$1 || selectedRows$1.length === 0) return;
+			exportAllToCSV(selectedRows$1, {
 				filename,
 				excludeColumns
 			});
@@ -6806,11 +6880,6 @@ function AutoCrudTable({ title, description, schema, resource, fields, table: ta
 						}, "create");
 						return null;
 					};
-					const resolvedToolbarActions = typeof toolbarActions === "function" ? toolbarActions([
-						{ type: "import" },
-						{ type: "export" },
-						{ type: "create" }
-					]) : toolbarActions;
 					if (!resolvedToolbarActions || resolvedToolbarActions.length === 0) return /* @__PURE__ */ jsxs("div", {
 						className: "flex items-center gap-2",
 						children: [
@@ -6868,7 +6937,7 @@ function AutoCrudTable({ title, description, schema, resource, fields, table: ta
 				enableExport: canExport,
 				showDefaultExport: false,
 				initialSorting: tableConfig?.defaultSort,
-				onSelectedCountChange: setSelectedCount,
+				onSelectedRowsChange: handleSelectedRowsChange,
 				getSelectedRows: getSelectedRowsRef
 			}),
 			/* @__PURE__ */ jsx(CrudFormModal, {
@@ -7943,6 +8012,7 @@ function useAutoCrudResource({ router, schema, query: queryTransform, options =
 	]);
 	const canExport = !!(exportFetcher || exportQuery);
 	return {
+		idKey,
 		tableData: {
 			data: tableRows,
 			pageCount: listQuery.data?.pageCount ?? 0,
@@ -8282,4 +8352,4 @@ function createMemoryDataSource(initialData = []) {
 }
 
 //#endregion
-export { AutoCrudTable, AutoForm, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, CrudFormModal, DataTable, DataTableAdvancedToolbar, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableToolbar, DataTableViewOptions, ExportDialog, ImportDialog, MultiCombobox, SchemaAdapter, cn, coerceRowValues, components, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, dataSources, dataToCSV, deDE, downloadCSVTemplate, enUS, esES, exportAllToCSV, exportTableToCSV, formComponents, formatDate, frFR, generateCSVTemplate, getUrlParams, humanize, jaJP, koKR, noopToastAdapter, normalizeDataSourceConfig, normalizeOptions, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseCSV, parseImportFile, parseJSON, parseZodField, resolveLocale, setSearchParams, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates, zhCN };
+export { AutoCrudTable, AutoForm, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, CrudFormModal, DataTable, DataTableAdvancedToolbar, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableToolbar, DataTableViewOptions, ExportDialog, ImportDialog, MultiCombobox, SchemaAdapter, cn, coerceRowValues, components, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, dataSources, dataToCSV, deDE, downloadCSVTemplate, enUS, esES, exportAllToCSV, exportTableToCSV, formComponents, formatDate, frFR, generateCSVTemplate, getUrlParams, humanize, jaJP, koKR, noopToastAdapter, normalizeDataSourceConfig, normalizeOptions, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseCSV, parseImportFile, parseJSON, parseZodField, resolveLocale, setSearchParams, setToolbarResolver, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates, zhCN };

package/package.json

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