@wordrhyme/auto-crud 1.2.1 → 1.2.4

package/dist/index.d.cts

@@ -24,7 +24,7 @@ declare const noopToastAdapter: ToastAdapter;
 /**
  * Modal 状态类型
  */
-type ModalVariant$1 = "dialog" | "sheet";
+type ModalVariant$1 = 'dialog' | 'sheet';
 interface ModalState<T> {
   createOpen: boolean;
   editOpen: boolean;
@@ -66,9 +66,9 @@ interface CrudHooks<TSchema extends z.ZodObject<z.ZodRawShape>, TListItem> {
    */
   beforeDelete?: (item: TListItem) => boolean | void | Promise<boolean | void>;
   /** 操作成功回调 */
-  onSuccess?: (op: "create" | "update" | "delete", payload: unknown) => void;
+  onSuccess?: (op: 'create' | 'update' | 'delete', payload: unknown) => void;
   /** 操作失败回调 */
-  onError?: (op: "create" | "update" | "delete", error: Error) => void;
+  onError?: (op: 'create' | 'update' | 'delete', error: Error) => void;
 }
 /**
  * Hook 配置选项
@@ -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;
@@ -204,7 +206,7 @@ interface AutoQueryParams {
   }>;
   search?: string;
   filters: any[];
-  joinOperator: "and" | "or";
+  joinOperator: 'and' | 'or';
 }
 /**
  * Hook 配置参数
@@ -368,11 +370,11 @@ declare function AutoTableActionBar<TData>({
 /**
  * 字段类型映射
  */
-type FieldType = "string" | "number" | "boolean" | "date" | "enum" | "array" | "object";
+type FieldType = 'string' | 'number' | 'boolean' | 'date' | 'enum' | 'array' | 'object';
 /**
  * DataTable Filter Variant
  */
-type FilterVariant = "text" | "number" | "boolean" | "select" | "multiSelect" | "date" | "dateRange" | "range";
+type FilterVariant = 'text' | 'number' | 'boolean' | 'select' | 'multiSelect' | 'date' | 'dateRange' | 'range';
 /**
  * 解析后的 Zod 字段信息
  */
@@ -408,10 +410,10 @@ interface CreateTableSchemaOptions<T> {
 interface CreateFormSchemaOptions {
   overrides?: FormSchemaOverrides;
   exclude?: string[];
-  layout?: "vertical" | "horizontal" | "grid";
+  layout?: 'vertical' | 'horizontal' | 'grid';
   gridColumns?: number;
   /** Label 对齐方式 */
-  labelAlign?: "left" | "top" | "right";
+  labelAlign?: 'left' | 'top' | 'right';
   /** Label 宽度（labelAlign 为 left 时有效） */
   labelWidth?: number | string;
   /** Label 栅格占位 */
@@ -450,7 +452,7 @@ interface ResolvedActionItem<T> {
   label: string;
   onClick: (row: T) => void;
   separator?: boolean;
-  variant?: "default" | "destructive";
+  variant?: 'default' | 'destructive';
 }
 /**
  * 操作列配置（ResolvedActionItem 数组）
@@ -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_runtime3.JSX.Element;
 //#endregion
@@ -646,10 +651,16 @@ type AutoCrudDataSourceResult = AutoCrudOption[] | {
   options?: AutoCrudOption[];
 };
 type AutoCrudDataSourceLoader = (context: AutoCrudDataSourceContext) => AutoCrudDataSourceResult | Promise<AutoCrudDataSourceResult>;
-type AutoCrudDataSourceConfig = string | {
-  key: string;
-  dependsOn?: string[];
-  resetOnChange?: boolean;
+type AutoCrudDataSourceConfig = string;
+type AutoCrudDataSourceRegistration = AutoCrudDataSourceLoader | {
+  dependencies?: string[];
+  reset?: boolean;
+  load: AutoCrudDataSourceLoader;
+};
+type AutoCrudDataSourceEntry = {
+  dependencies: string[];
+  reset: boolean;
+  load: AutoCrudDataSourceLoader;
 };
 type RegistryListener = () => void;
 declare const formComponents: {
@@ -659,17 +670,22 @@ declare const formComponents: {
   all(): Record<string, AutoCrudFormComponentConfig>;
   subscribe(listener: RegistryListener): () => void;
 };
-declare const dataSources: {
-  register(name: string, value: AutoCrudDataSourceLoader): void;
+declare const components: {
+  register(name: string, value: AutoCrudFormComponentConfig): void;
   unregister(name: string): void;
-  get(name: string): AutoCrudDataSourceLoader | undefined;
-  all(): Record<string, AutoCrudDataSourceLoader>;
+  get(name: string): AutoCrudFormComponentConfig | undefined;
+  all(): Record<string, AutoCrudFormComponentConfig>;
   subscribe(listener: RegistryListener): () => void;
 };
+declare const dataSources: {
+  register(name: string, registration: AutoCrudDataSourceRegistration): void;
+  unregister: (name: string) => void;
+  get: (name: string) => AutoCrudDataSourceEntry | undefined;
+  all: () => Record<string, AutoCrudDataSourceEntry>;
+  subscribe: (listener: RegistryListener) => () => void;
+};
 declare function normalizeDataSourceConfig(config: AutoCrudDataSourceConfig | undefined): {
   key: string;
-  dependsOn: string[];
-  resetOnChange: boolean;
 } | undefined;
 declare function normalizeOptions(result: AutoCrudDataSourceResult | undefined): AutoCrudOption[];
 //#endregion
@@ -812,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 setAutoCrudToolbarResolver(resolver: AutoCrudToolbarResolver | null): void;
 /**
  * AutoCrudTable Props 接口
  */
@@ -855,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>>;
@@ -877,6 +903,8 @@ interface AutoCrudTableProps<TSchema extends z.ZodObject<z.ZodRawShape>> {
    * 顶层工具栏操作配置
    * 用法类同 `actions` 行操作。一旦配置了包含内置 `type` 的数组，它将完全接管右侧工具栏！
    */
+  toolbar?: ToolbarActionConfig;
+  /** @deprecated Use toolbar instead. */
   toolbarActions?: ToolbarActionConfig;
   /**
    * 权限配置
@@ -923,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,
@@ -932,6 +961,7 @@ declare function AutoCrudTable<TSchema extends z.ZodObject<z.ZodRawShape>>({
   form: formConfig,
   permissions,
   actions: actionItems,
+  toolbar,
   toolbarActions,
   locale: localeProp,
   onCreate
@@ -1209,7 +1239,7 @@ declare const filterItemSchema: z.ZodObject<{
 type FilterItemSchema = z.infer<typeof filterItemSchema>;
 //#endregion
 //#region src/types/data-table.d.ts
-declare module "@tanstack/react-table" {
+declare module '@tanstack/react-table' {
   interface TableMeta<TData extends RowData> {
     queryKeys?: QueryKeys;
     queryStateOptions?: UrlStateOptions;
@@ -1224,7 +1254,7 @@ declare module "@tanstack/react-table" {
     unit?: string;
     icon?: React.FC<React.SVGProps<SVGSVGElement>>;
     /** 控制在哪些筛选模式下显示（未设置则在所有模式显示） */
-    modes?: Array<"simple" | "advanced" | "command">;
+    modes?: Array<'simple' | 'advanced' | 'command'>;
   }
 }
 interface QueryKeys {
@@ -1241,10 +1271,10 @@ interface Option {
   count?: number;
   icon?: React.FC<React.SVGProps<SVGSVGElement>>;
 }
-type FilterOperator = DataTableConfig["operators"][number];
-type FilterVariant$1 = DataTableConfig["filterVariants"][number];
-type JoinOperator = DataTableConfig["joinOperators"][number];
-interface ExtendedColumnSort<TData> extends Omit<ColumnSort, "id"> {
+type FilterOperator = DataTableConfig['operators'][number];
+type FilterVariant$1 = DataTableConfig['filterVariants'][number];
+type JoinOperator = DataTableConfig['joinOperators'][number];
+interface ExtendedColumnSort<TData> extends Omit<ColumnSort, 'id'> {
   id: Extract<keyof TData, string>;
 }
 interface ExtendedColumnFilter<TData> extends FilterItemSchema {
@@ -1252,7 +1282,7 @@ interface ExtendedColumnFilter<TData> extends FilterItemSchema {
 }
 interface DataTableRowAction<TData> {
   row: Row<TData>;
-  variant: "update" | "delete";
+  variant: 'update' | 'delete';
 }
 //#endregion
 //#region src/components/auto-crud/auto-table-simple-filters.d.ts
@@ -1814,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 AutoCrudDataSourceLoader, 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, 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, setAutoCrudToolbarResolver, setSearchParams, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates, zhCN };

package/dist/index.d.ts

@@ -4,7 +4,7 @@ import * as _tanstack_react_table0 from "@tanstack/react-table";
 import { Column, ColumnDef, ColumnSort, Row, RowData, Table, TableOptions, TableState } from "@tanstack/react-table";
 import { Command, DropdownMenuTrigger, PopoverContent } from "@pixpilot/shadcn";
 import { ClassValue } from "clsx";
-import * as react_jsx_runtime3 from "react/jsx-runtime";
+import * as react_jsx_runtime1 from "react/jsx-runtime";
 import { z } from "zod";
 import { ISchema } from "@formily/json-schema";
 
@@ -24,7 +24,7 @@ declare const noopToastAdapter: ToastAdapter;
 /**
  * Modal 状态类型
  */
-type ModalVariant$1 = "dialog" | "sheet";
+type ModalVariant$1 = 'dialog' | 'sheet';
 interface ModalState<T> {
   createOpen: boolean;
   editOpen: boolean;
@@ -66,9 +66,9 @@ interface CrudHooks<TSchema extends z.ZodObject<z.ZodRawShape>, TListItem> {
    */
   beforeDelete?: (item: TListItem) => boolean | void | Promise<boolean | void>;
   /** 操作成功回调 */
-  onSuccess?: (op: "create" | "update" | "delete", payload: unknown) => void;
+  onSuccess?: (op: 'create' | 'update' | 'delete', payload: unknown) => void;
   /** 操作失败回调 */
-  onError?: (op: "create" | "update" | "delete", error: Error) => void;
+  onError?: (op: 'create' | 'update' | 'delete', error: Error) => void;
 }
 /**
  * Hook 配置选项
@@ -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;
@@ -204,7 +206,7 @@ interface AutoQueryParams {
   }>;
   search?: string;
   filters: any[];
-  joinOperator: "and" | "or";
+  joinOperator: 'and' | 'or';
 }
 /**
  * Hook 配置参数
@@ -362,17 +364,17 @@ 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
 /**
  * 字段类型映射
  */
-type FieldType = "string" | "number" | "boolean" | "date" | "enum" | "array" | "object";
+type FieldType = 'string' | 'number' | 'boolean' | 'date' | 'enum' | 'array' | 'object';
 /**
  * DataTable Filter Variant
  */
-type FilterVariant = "text" | "number" | "boolean" | "select" | "multiSelect" | "date" | "dateRange" | "range";
+type FilterVariant = 'text' | 'number' | 'boolean' | 'select' | 'multiSelect' | 'date' | 'dateRange' | 'range';
 /**
  * 解析后的 Zod 字段信息
  */
@@ -408,10 +410,10 @@ interface CreateTableSchemaOptions<T> {
 interface CreateFormSchemaOptions {
   overrides?: FormSchemaOverrides;
   exclude?: string[];
-  layout?: "vertical" | "horizontal" | "grid";
+  layout?: 'vertical' | 'horizontal' | 'grid';
   gridColumns?: number;
   /** Label 对齐方式 */
-  labelAlign?: "left" | "top" | "right";
+  labelAlign?: 'left' | 'top' | 'right';
   /** Label 宽度（labelAlign 为 left 时有效） */
   labelWidth?: number | string;
   /** Label 栅格占位 */
@@ -450,7 +452,7 @@ interface ResolvedActionItem<T> {
   label: string;
   onClick: (row: T) => void;
   separator?: boolean;
-  variant?: "default" | "destructive";
+  variant?: 'default' | 'destructive';
 }
 /**
  * 操作列配置（ResolvedActionItem 数组）
@@ -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
 /**
@@ -646,10 +651,16 @@ type AutoCrudDataSourceResult = AutoCrudOption[] | {
   options?: AutoCrudOption[];
 };
 type AutoCrudDataSourceLoader = (context: AutoCrudDataSourceContext) => AutoCrudDataSourceResult | Promise<AutoCrudDataSourceResult>;
-type AutoCrudDataSourceConfig = string | {
-  key: string;
-  dependsOn?: string[];
-  resetOnChange?: boolean;
+type AutoCrudDataSourceConfig = string;
+type AutoCrudDataSourceRegistration = AutoCrudDataSourceLoader | {
+  dependencies?: string[];
+  reset?: boolean;
+  load: AutoCrudDataSourceLoader;
+};
+type AutoCrudDataSourceEntry = {
+  dependencies: string[];
+  reset: boolean;
+  load: AutoCrudDataSourceLoader;
 };
 type RegistryListener = () => void;
 declare const formComponents: {
@@ -659,17 +670,22 @@ declare const formComponents: {
   all(): Record<string, AutoCrudFormComponentConfig>;
   subscribe(listener: RegistryListener): () => void;
 };
-declare const dataSources: {
-  register(name: string, value: AutoCrudDataSourceLoader): void;
+declare const components: {
+  register(name: string, value: AutoCrudFormComponentConfig): void;
   unregister(name: string): void;
-  get(name: string): AutoCrudDataSourceLoader | undefined;
-  all(): Record<string, AutoCrudDataSourceLoader>;
+  get(name: string): AutoCrudFormComponentConfig | undefined;
+  all(): Record<string, AutoCrudFormComponentConfig>;
   subscribe(listener: RegistryListener): () => void;
 };
+declare const dataSources: {
+  register(name: string, registration: AutoCrudDataSourceRegistration): void;
+  unregister: (name: string) => void;
+  get: (name: string) => AutoCrudDataSourceEntry | undefined;
+  all: () => Record<string, AutoCrudDataSourceEntry>;
+  subscribe: (listener: RegistryListener) => () => void;
+};
 declare function normalizeDataSourceConfig(config: AutoCrudDataSourceConfig | undefined): {
   key: string;
-  dependsOn: string[];
-  resetOnChange: boolean;
 } | undefined;
 declare function normalizeOptions(result: AutoCrudDataSourceResult | undefined): AutoCrudOption[];
 //#endregion
@@ -812,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 setAutoCrudToolbarResolver(resolver: AutoCrudToolbarResolver | null): void;
 /**
  * AutoCrudTable Props 接口
  */
@@ -855,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>>;
@@ -877,6 +903,8 @@ interface AutoCrudTableProps<TSchema extends z.ZodObject<z.ZodRawShape>> {
    * 顶层工具栏操作配置
    * 用法类同 `actions` 行操作。一旦配置了包含内置 `type` 的数组，它将完全接管右侧工具栏！
    */
+  toolbar?: ToolbarActionConfig;
+  /** @deprecated Use toolbar instead. */
   toolbarActions?: ToolbarActionConfig;
   /**
    * 权限配置
@@ -923,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,
@@ -932,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>> {
@@ -967,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>;
@@ -1209,7 +1239,7 @@ declare const filterItemSchema: z.ZodObject<{
 type FilterItemSchema = z.infer<typeof filterItemSchema>;
 //#endregion
 //#region src/types/data-table.d.ts
-declare module "@tanstack/react-table" {
+declare module '@tanstack/react-table' {
   interface TableMeta<TData extends RowData> {
     queryKeys?: QueryKeys;
     queryStateOptions?: UrlStateOptions;
@@ -1224,7 +1254,7 @@ declare module "@tanstack/react-table" {
     unit?: string;
     icon?: React.FC<React.SVGProps<SVGSVGElement>>;
     /** 控制在哪些筛选模式下显示（未设置则在所有模式显示） */
-    modes?: Array<"simple" | "advanced" | "command">;
+    modes?: Array<'simple' | 'advanced' | 'command'>;
   }
 }
 interface QueryKeys {
@@ -1241,10 +1271,10 @@ interface Option {
   count?: number;
   icon?: React.FC<React.SVGProps<SVGSVGElement>>;
 }
-type FilterOperator = DataTableConfig["operators"][number];
-type FilterVariant$1 = DataTableConfig["filterVariants"][number];
-type JoinOperator = DataTableConfig["joinOperators"][number];
-interface ExtendedColumnSort<TData> extends Omit<ColumnSort, "id"> {
+type FilterOperator = DataTableConfig['operators'][number];
+type FilterVariant$1 = DataTableConfig['filterVariants'][number];
+type JoinOperator = DataTableConfig['joinOperators'][number];
+interface ExtendedColumnSort<TData> extends Omit<ColumnSort, 'id'> {
   id: Extract<keyof TData, string>;
 }
 interface ExtendedColumnFilter<TData> extends FilterItemSchema {
@@ -1252,7 +1282,7 @@ interface ExtendedColumnFilter<TData> extends FilterItemSchema {
 }
 interface DataTableRowAction<TData> {
   row: Row<TData>;
-  variant: "update" | "delete";
+  variant: 'update' | 'delete';
 }
 //#endregion
 //#region src/components/auto-crud/auto-table-simple-filters.d.ts
@@ -1269,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";
@@ -1311,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 {
@@ -1333,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";
@@ -1353,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"> {
@@ -1366,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"> {
@@ -1377,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> {
@@ -1389,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> {
@@ -1403,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"> {
@@ -1415,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"> {
@@ -1426,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> {
@@ -1437,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 {
@@ -1814,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 AutoCrudDataSourceLoader, 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, 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, setAutoCrudToolbarResolver, setSearchParams, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates, zhCN };