@wordrhyme/auto-crud 1.2.5 → 1.3.0

package/dist/index.d.cts

@@ -313,7 +313,12 @@ interface BatchActionContext<TData> {
   clearSelection: () => void;
 }
 type BatchBuiltinActionType = 'batchUpdate' | 'export' | 'delete';
-type BatchBuiltinActionItem<TData> = {
+type BatchActionMeta = {
+  id?: string;
+  order?: number;
+  hidden?: boolean;
+};
+type BatchBuiltinActionItem<TData> = BatchActionMeta & {
   type: BatchBuiltinActionType;
   /** 替代默认行为 */
   onClick?: (rows: TData[], context: BatchActionContext<TData>, event: React$1.MouseEvent<HTMLButtonElement>) => void;
@@ -322,7 +327,7 @@ type BatchBuiltinActionItem<TData> = {
   /** 替代整个内置操作的渲染 */
   component?: React$1.ReactNode | ((context: BatchActionContext<TData>) => React$1.ReactNode);
 };
-type BatchCustomActionItem<TData> = {
+type BatchCustomActionItem<TData> = BatchActionMeta & {
   type: 'custom';
   /** 操作文本。传 component 时可省略 */
   label?: string;
@@ -448,16 +453,18 @@ declare function createSelectColumn<T>(): ColumnDef<T>;
 /**
  * 已解析的操作项（渲染层使用）
  */
-interface ResolvedActionItem<T> {
-  label: string;
-  onClick: (row: T) => void;
+interface ResolvedActionItem<T, TContext = any> {
+  label?: string;
+  onClick?: (row: T) => void;
+  component?: React$1.ReactNode | ((context: TContext) => React$1.ReactNode);
+  getContext?: (row: T) => TContext;
   separator?: boolean;
   variant?: 'default' | 'destructive';
 }
 /**
  * 操作列配置（ResolvedActionItem 数组）
  */
-type ActionsColumnConfig<T> = ResolvedActionItem<T>[];
+type ActionsColumnConfig<T> = ResolvedActionItem<T, any>[];
 /**
  * 创建操作列
  */
@@ -662,27 +669,27 @@ type AutoCrudDataSourceEntry = {
   reset: boolean;
   load: AutoCrudDataSourceLoader;
 };
-type RegistryListener = () => void;
+type RegistryListener$1 = () => void;
 declare const formComponents: {
   register(name: string, value: AutoCrudFormComponentConfig): void;
   unregister(name: string): void;
   get(name: string): AutoCrudFormComponentConfig | undefined;
   all(): Record<string, AutoCrudFormComponentConfig>;
-  subscribe(listener: RegistryListener): () => void;
+  subscribe(listener: RegistryListener$1): () => void;
 };
 declare const components: {
   register(name: string, value: AutoCrudFormComponentConfig): void;
   unregister(name: string): void;
   get(name: string): AutoCrudFormComponentConfig | undefined;
   all(): Record<string, AutoCrudFormComponentConfig>;
-  subscribe(listener: RegistryListener): () => void;
+  subscribe(listener: RegistryListener$1): () => 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;
+  subscribe: (listener: RegistryListener$1) => () => void;
 };
 declare function normalizeDataSourceConfig(config: AutoCrudDataSourceConfig | undefined): {
   key: string;
@@ -778,51 +785,76 @@ interface Field {
   } | false;
 }
 type Fields = Record<string, Field>;
-type BuiltinType = 'view' | 'edit' | 'copy' | 'delete';
 /** 内置操作项（覆盖默认行为或调整位置） */
-type BuiltinActionItem<T> = {
-  type: BuiltinType;
+type ActionMeta = {
+  id?: string;
+  order?: number;
+  hidden?: boolean;
+};
+interface AutoCrudRowActionContext<T> {
+  crudId: string;
+  idKey: string;
+  row: T;
+  rowId?: string;
+  openView: (row: T) => void;
+  openEdit?: (row: T) => void;
+  copyRow?: (row: T) => void;
+  openDelete?: (row: T) => void;
+}
+type ActionComponent<TContext> = React$1.ReactNode | ((context: TContext) => React$1.ReactNode);
+type RowBuiltinActionType = 'view' | 'edit' | 'copy' | 'delete';
+type RowBuiltinActionItem<T> = ActionMeta & {
+  type: RowBuiltinActionType;
   onClick?: (row: T) => void;
   label?: string;
   separator?: boolean;
 };
-/** 自定义操作项 */
-type CustomActionItem<T> = {
+type RowCustomActionItem<T> = ActionMeta & {
   type: 'custom';
-  label: string;
-  onClick: (row: T) => void;
-  /** 仅在无内置项时生效：插入到首部还是尾部（默认 end） */
+  label?: string;
+  onClick?: (row: T) => void;
+  component?: ActionComponent<AutoCrudRowActionContext<T>>;
   position?: 'start' | 'end';
   separator?: boolean;
   variant?: 'default' | 'destructive';
 };
 /**
- * 行操作项
+ * Row action item.
  *
- * - **只传 custom**：内置保持默认，custom 追加到首/尾
- * - **包含任意内置 type**：数组完全接管，未列出的隐藏，顺序即渲染顺序
- */
-type ActionItem<T> = BuiltinActionItem<T> | CustomActionItem<T>;
-type ActionConfig<T> = ActionItem<T>[] | ((defaults: BuiltinActionItem<T>[]) => ActionItem<T>[]);
+ * - Custom-only config keeps builtin row actions and appends custom actions.
+ * - Including any builtin type takes over builtin ordering.
+ */
+type RowActionItem<T> = RowBuiltinActionItem<T> | RowCustomActionItem<T>;
+type RowActionConfig<T> = RowActionItem<T>[] | ((defaults: RowBuiltinActionItem<T>[]) => RowActionItem<T>[]);
+/** @deprecated Use RowActionItem instead. */
+type ActionItem<T> = RowActionItem<T>;
+/** @deprecated Use RowActionConfig instead. */
+type ActionConfig<T> = RowActionConfig<T>;
+type AutoCrudActionsConfig<T> = {
+  toolbar?: ToolbarActionConfig;
+  row?: RowActionConfig<T>;
+  batch?: BatchActionConfig<T>;
+};
+type AutoCrudActionConfig<T> = RowActionConfig<T> | AutoCrudActionsConfig<T>;
 /**
  * 顶部工具栏内置操作项
  */
-type ToolbarBuiltinActionItem = {
+type ToolbarBuiltinActionItem = ActionMeta & {
   type: 'create' | 'import' | 'export';
   /** 替代默认的行为 */
   onClick?: () => void;
   /** 替代默认的标签文本 */
   label?: string;
   /** 替代整个按钮的渲染 */
-  component?: React$1.ReactNode;
+  component?: ActionComponent<AutoCrudToolbarContext>;
 };
 /**
  * 顶部工具栏自定义操作项
  */
-type ToolbarCustomActionItem = {
+type ToolbarCustomActionItem = ActionMeta & {
   type: 'custom';
   /** 渲染自定义内容 */
-  component: React$1.ReactNode;
+  component: ActionComponent<AutoCrudToolbarContext>;
   /** 仅在无内置项时生效：插入到首部还是尾部（默认 end） */
   position?: 'start' | 'end';
 };
@@ -883,6 +915,7 @@ interface AutoCrudTableProps<TSchema extends z.ZodObject<z.ZodRawShape>> {
      * 多选后悬浮批量操作栏配置
      * 用法类同 `actions` 行操作和 `toolbar` 顶部工具栏。
      * 只传 custom 时保留默认批量操作；包含任意内置 type 时完全接管顺序。
+     * @deprecated Use actions.batch instead.
      */
     batchActions?: BatchActionConfig<z.output<TSchema>>;
     /** 默认排序 */
@@ -897,11 +930,12 @@ interface AutoCrudTableProps<TSchema extends z.ZodObject<z.ZodRawShape>> {
     /** 弹窗自定义容器类名（支持控制大小、最大高度等） */
     className?: string;
   };
-  /** 行操作配置，见 {@link ActionItem} */
-  actions?: ActionConfig<z.output<TSchema>>;
+  /** 行操作配置，或统一的 toolbar/row/batch 操作配置。 */
+  actions?: AutoCrudActionConfig<z.output<TSchema>>;
   /**
    * 顶层工具栏操作配置
    * 用法类同 `actions` 行操作。一旦配置了包含内置 `type` 的数组，它将完全接管右侧工具栏！
+   * @deprecated Use actions.toolbar instead.
    */
   toolbar?: ToolbarActionConfig;
   /** @deprecated Use toolbar instead. */
@@ -1211,12 +1245,12 @@ declare const filterItemSchema: z.ZodObject<{
   variant: z.ZodEnum<{
     number: "number";
     boolean: "boolean";
-    date: "date";
     text: "text";
+    range: "range";
+    date: "date";
+    dateRange: "dateRange";
     select: "select";
     multiSelect: "multiSelect";
-    dateRange: "dateRange";
-    range: "range";
   }>;
   operator: z.ZodEnum<{
     iLike: "iLike";
@@ -1510,6 +1544,45 @@ interface MultiComboboxProps extends Omit<ComponentProps<typeof Command>, 'value
 }
 declare const MultiCombobox: React$1.FC<MultiComboboxProps>;
 //#endregion
+//#region src/lib/crud-actions.d.ts
+type CrudActionZone = 'toolbar' | 'row' | 'batch';
+type CrudActionBase = {
+  type: string;
+  id?: string;
+  order?: number;
+  hidden?: boolean;
+  position?: 'start' | 'end';
+};
+type CrudActionEntry<TAction extends CrudActionBase = CrudActionBase> = {
+  targetId: string;
+  zone: CrudActionZone;
+  ownerId: string;
+  action: TAction;
+  order: number;
+  seq: number;
+};
+type CrudActionRegistration<TAction extends CrudActionBase = CrudActionBase> = {
+  targetId: string;
+  zone: CrudActionZone;
+  ownerId: string;
+  actions: readonly TAction[];
+};
+type RegistryListener = () => void;
+declare function unregisterOwnerActions(ownerId: string, options?: {
+  targetId?: string;
+  zone?: CrudActionZone;
+}, shouldNotify?: boolean): void;
+declare function resolveActions<TAction extends CrudActionBase>(targetId: string | undefined, zone: CrudActionZone, ownerActions: readonly TAction[]): TAction[];
+declare const crudActions: {
+  register<TAction extends CrudActionBase>(registration: CrudActionRegistration<TAction>): void;
+  unregister: typeof unregisterOwnerActions;
+  clear(): void;
+  get<TAction extends CrudActionBase>(targetId: string, zone: CrudActionZone): CrudActionEntry<TAction>[];
+  resolve: typeof resolveActions;
+  subscribe(listener: RegistryListener): () => void;
+  getSnapshot(): number;
+};
+//#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">> {
   initialState?: Omit<Partial<TableState>, "sorting"> & {
@@ -1844,4 +1917,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, 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 };
+export { type ActionConfig, type ActionItem, type ActionsColumnConfig, type AutoCrudActionConfig, type AutoCrudActionsConfig, type AutoCrudDataSourceConfig, type AutoCrudDataSourceContext, type AutoCrudDataSourceEntry, type AutoCrudDataSourceLoader, type AutoCrudDataSourceRegistration, type AutoCrudFormComponentConfig, type AutoCrudLocale, type AutoCrudOption, type AutoCrudRowActionContext, 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, type CrudActionBase, type CrudActionEntry, type CrudActionRegistration, type CrudActionZone, 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, type RowActionConfig, type RowActionItem, type RowBuiltinActionItem, type RowBuiltinActionType, type RowCustomActionItem, 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, crudActions, 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

@@ -313,7 +313,12 @@ interface BatchActionContext<TData> {
   clearSelection: () => void;
 }
 type BatchBuiltinActionType = 'batchUpdate' | 'export' | 'delete';
-type BatchBuiltinActionItem<TData> = {
+type BatchActionMeta = {
+  id?: string;
+  order?: number;
+  hidden?: boolean;
+};
+type BatchBuiltinActionItem<TData> = BatchActionMeta & {
   type: BatchBuiltinActionType;
   /** 替代默认行为 */
   onClick?: (rows: TData[], context: BatchActionContext<TData>, event: React$1.MouseEvent<HTMLButtonElement>) => void;
@@ -322,7 +327,7 @@ type BatchBuiltinActionItem<TData> = {
   /** 替代整个内置操作的渲染 */
   component?: React$1.ReactNode | ((context: BatchActionContext<TData>) => React$1.ReactNode);
 };
-type BatchCustomActionItem<TData> = {
+type BatchCustomActionItem<TData> = BatchActionMeta & {
   type: 'custom';
   /** 操作文本。传 component 时可省略 */
   label?: string;
@@ -448,16 +453,18 @@ declare function createSelectColumn<T>(): ColumnDef<T>;
 /**
  * 已解析的操作项（渲染层使用）
  */
-interface ResolvedActionItem<T> {
-  label: string;
-  onClick: (row: T) => void;
+interface ResolvedActionItem<T, TContext = any> {
+  label?: string;
+  onClick?: (row: T) => void;
+  component?: React$1.ReactNode | ((context: TContext) => React$1.ReactNode);
+  getContext?: (row: T) => TContext;
   separator?: boolean;
   variant?: 'default' | 'destructive';
 }
 /**
  * 操作列配置（ResolvedActionItem 数组）
  */
-type ActionsColumnConfig<T> = ResolvedActionItem<T>[];
+type ActionsColumnConfig<T> = ResolvedActionItem<T, any>[];
 /**
  * 创建操作列
  */
@@ -662,27 +669,27 @@ type AutoCrudDataSourceEntry = {
   reset: boolean;
   load: AutoCrudDataSourceLoader;
 };
-type RegistryListener = () => void;
+type RegistryListener$1 = () => void;
 declare const formComponents: {
   register(name: string, value: AutoCrudFormComponentConfig): void;
   unregister(name: string): void;
   get(name: string): AutoCrudFormComponentConfig | undefined;
   all(): Record<string, AutoCrudFormComponentConfig>;
-  subscribe(listener: RegistryListener): () => void;
+  subscribe(listener: RegistryListener$1): () => void;
 };
 declare const components: {
   register(name: string, value: AutoCrudFormComponentConfig): void;
   unregister(name: string): void;
   get(name: string): AutoCrudFormComponentConfig | undefined;
   all(): Record<string, AutoCrudFormComponentConfig>;
-  subscribe(listener: RegistryListener): () => void;
+  subscribe(listener: RegistryListener$1): () => 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;
+  subscribe: (listener: RegistryListener$1) => () => void;
 };
 declare function normalizeDataSourceConfig(config: AutoCrudDataSourceConfig | undefined): {
   key: string;
@@ -778,51 +785,76 @@ interface Field {
   } | false;
 }
 type Fields = Record<string, Field>;
-type BuiltinType = 'view' | 'edit' | 'copy' | 'delete';
 /** 内置操作项（覆盖默认行为或调整位置） */
-type BuiltinActionItem<T> = {
-  type: BuiltinType;
+type ActionMeta = {
+  id?: string;
+  order?: number;
+  hidden?: boolean;
+};
+interface AutoCrudRowActionContext<T> {
+  crudId: string;
+  idKey: string;
+  row: T;
+  rowId?: string;
+  openView: (row: T) => void;
+  openEdit?: (row: T) => void;
+  copyRow?: (row: T) => void;
+  openDelete?: (row: T) => void;
+}
+type ActionComponent<TContext> = React$1.ReactNode | ((context: TContext) => React$1.ReactNode);
+type RowBuiltinActionType = 'view' | 'edit' | 'copy' | 'delete';
+type RowBuiltinActionItem<T> = ActionMeta & {
+  type: RowBuiltinActionType;
   onClick?: (row: T) => void;
   label?: string;
   separator?: boolean;
 };
-/** 自定义操作项 */
-type CustomActionItem<T> = {
+type RowCustomActionItem<T> = ActionMeta & {
   type: 'custom';
-  label: string;
-  onClick: (row: T) => void;
-  /** 仅在无内置项时生效：插入到首部还是尾部（默认 end） */
+  label?: string;
+  onClick?: (row: T) => void;
+  component?: ActionComponent<AutoCrudRowActionContext<T>>;
   position?: 'start' | 'end';
   separator?: boolean;
   variant?: 'default' | 'destructive';
 };
 /**
- * 行操作项
+ * Row action item.
  *
- * - **只传 custom**：内置保持默认，custom 追加到首/尾
- * - **包含任意内置 type**：数组完全接管，未列出的隐藏，顺序即渲染顺序
- */
-type ActionItem<T> = BuiltinActionItem<T> | CustomActionItem<T>;
-type ActionConfig<T> = ActionItem<T>[] | ((defaults: BuiltinActionItem<T>[]) => ActionItem<T>[]);
+ * - Custom-only config keeps builtin row actions and appends custom actions.
+ * - Including any builtin type takes over builtin ordering.
+ */
+type RowActionItem<T> = RowBuiltinActionItem<T> | RowCustomActionItem<T>;
+type RowActionConfig<T> = RowActionItem<T>[] | ((defaults: RowBuiltinActionItem<T>[]) => RowActionItem<T>[]);
+/** @deprecated Use RowActionItem instead. */
+type ActionItem<T> = RowActionItem<T>;
+/** @deprecated Use RowActionConfig instead. */
+type ActionConfig<T> = RowActionConfig<T>;
+type AutoCrudActionsConfig<T> = {
+  toolbar?: ToolbarActionConfig;
+  row?: RowActionConfig<T>;
+  batch?: BatchActionConfig<T>;
+};
+type AutoCrudActionConfig<T> = RowActionConfig<T> | AutoCrudActionsConfig<T>;
 /**
  * 顶部工具栏内置操作项
  */
-type ToolbarBuiltinActionItem = {
+type ToolbarBuiltinActionItem = ActionMeta & {
   type: 'create' | 'import' | 'export';
   /** 替代默认的行为 */
   onClick?: () => void;
   /** 替代默认的标签文本 */
   label?: string;
   /** 替代整个按钮的渲染 */
-  component?: React$1.ReactNode;
+  component?: ActionComponent<AutoCrudToolbarContext>;
 };
 /**
  * 顶部工具栏自定义操作项
  */
-type ToolbarCustomActionItem = {
+type ToolbarCustomActionItem = ActionMeta & {
   type: 'custom';
   /** 渲染自定义内容 */
-  component: React$1.ReactNode;
+  component: ActionComponent<AutoCrudToolbarContext>;
   /** 仅在无内置项时生效：插入到首部还是尾部（默认 end） */
   position?: 'start' | 'end';
 };
@@ -883,6 +915,7 @@ interface AutoCrudTableProps<TSchema extends z.ZodObject<z.ZodRawShape>> {
      * 多选后悬浮批量操作栏配置
      * 用法类同 `actions` 行操作和 `toolbar` 顶部工具栏。
      * 只传 custom 时保留默认批量操作；包含任意内置 type 时完全接管顺序。
+     * @deprecated Use actions.batch instead.
      */
     batchActions?: BatchActionConfig<z.output<TSchema>>;
     /** 默认排序 */
@@ -897,11 +930,12 @@ interface AutoCrudTableProps<TSchema extends z.ZodObject<z.ZodRawShape>> {
     /** 弹窗自定义容器类名（支持控制大小、最大高度等） */
     className?: string;
   };
-  /** 行操作配置，见 {@link ActionItem} */
-  actions?: ActionConfig<z.output<TSchema>>;
+  /** 行操作配置，或统一的 toolbar/row/batch 操作配置。 */
+  actions?: AutoCrudActionConfig<z.output<TSchema>>;
   /**
    * 顶层工具栏操作配置
    * 用法类同 `actions` 行操作。一旦配置了包含内置 `type` 的数组，它将完全接管右侧工具栏！
+   * @deprecated Use actions.toolbar instead.
    */
   toolbar?: ToolbarActionConfig;
   /** @deprecated Use toolbar instead. */
@@ -1211,12 +1245,12 @@ declare const filterItemSchema: z.ZodObject<{
   variant: z.ZodEnum<{
     number: "number";
     boolean: "boolean";
-    date: "date";
     text: "text";
+    range: "range";
+    date: "date";
+    dateRange: "dateRange";
     select: "select";
     multiSelect: "multiSelect";
-    dateRange: "dateRange";
-    range: "range";
   }>;
   operator: z.ZodEnum<{
     iLike: "iLike";
@@ -1510,6 +1544,45 @@ interface MultiComboboxProps extends Omit<ComponentProps<typeof Command>, 'value
 }
 declare const MultiCombobox: React$1.FC<MultiComboboxProps>;
 //#endregion
+//#region src/lib/crud-actions.d.ts
+type CrudActionZone = 'toolbar' | 'row' | 'batch';
+type CrudActionBase = {
+  type: string;
+  id?: string;
+  order?: number;
+  hidden?: boolean;
+  position?: 'start' | 'end';
+};
+type CrudActionEntry<TAction extends CrudActionBase = CrudActionBase> = {
+  targetId: string;
+  zone: CrudActionZone;
+  ownerId: string;
+  action: TAction;
+  order: number;
+  seq: number;
+};
+type CrudActionRegistration<TAction extends CrudActionBase = CrudActionBase> = {
+  targetId: string;
+  zone: CrudActionZone;
+  ownerId: string;
+  actions: readonly TAction[];
+};
+type RegistryListener = () => void;
+declare function unregisterOwnerActions(ownerId: string, options?: {
+  targetId?: string;
+  zone?: CrudActionZone;
+}, shouldNotify?: boolean): void;
+declare function resolveActions<TAction extends CrudActionBase>(targetId: string | undefined, zone: CrudActionZone, ownerActions: readonly TAction[]): TAction[];
+declare const crudActions: {
+  register<TAction extends CrudActionBase>(registration: CrudActionRegistration<TAction>): void;
+  unregister: typeof unregisterOwnerActions;
+  clear(): void;
+  get<TAction extends CrudActionBase>(targetId: string, zone: CrudActionZone): CrudActionEntry<TAction>[];
+  resolve: typeof resolveActions;
+  subscribe(listener: RegistryListener): () => void;
+  getSnapshot(): number;
+};
+//#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">> {
   initialState?: Omit<Partial<TableState>, "sorting"> & {
@@ -1844,4 +1917,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, 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 };
+export { type ActionConfig, type ActionItem, type ActionsColumnConfig, type AutoCrudActionConfig, type AutoCrudActionsConfig, type AutoCrudDataSourceConfig, type AutoCrudDataSourceContext, type AutoCrudDataSourceEntry, type AutoCrudDataSourceLoader, type AutoCrudDataSourceRegistration, type AutoCrudFormComponentConfig, type AutoCrudLocale, type AutoCrudOption, type AutoCrudRowActionContext, 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, type CrudActionBase, type CrudActionEntry, type CrudActionRegistration, type CrudActionZone, 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, type RowActionConfig, type RowActionItem, type RowBuiltinActionItem, type RowBuiltinActionType, type RowCustomActionItem, 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, crudActions, 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 };