@wordrhyme/auto-crud 1.3.0 → 1.3.2

package/dist/index.d.cts

@@ -1,11 +1,12 @@
 import * as react_jsx_runtime1 from "react/jsx-runtime";
 import { z } from "zod";
+import { JsonSchemaFormScope } from "@wordrhyme/formily-shadcn";
 import * as _tanstack_react_table0 from "@tanstack/react-table";
 import { Column, ColumnDef, ColumnSort, Row, RowData, Table, TableOptions, TableState } from "@tanstack/react-table";
 import * as React$1 from "react";
-import { ComponentProps, ReactNode } from "react";
 import { ISchema } from "@formily/json-schema";
-import { Command, DropdownMenuTrigger, PopoverContent } from "@pixpilot/shadcn";
+import { DropdownMenuTrigger, PopoverContent } from "@wordrhyme/shadcn";
+import { MultiCombobox, MultiComboboxOption, MultiComboboxProps, MultiComboboxTriggerRenderProps, Select, SelectMode, SelectOption, SelectProps, SelectSearchableDynamicProps, SelectSearchableMultipleProps, SelectSearchableProps, SelectSearchableSingleProps, SelectSimpleProps, SelectTriggerRenderProps } from "@wordrhyme/shadcn-ui";
 import { ClassValue } from "clsx";
 
 //#region src/hooks/use-auto-crud-resource.d.ts
@@ -152,6 +153,8 @@ interface UseAutoCrudResourceReturn<TSchema extends z.ZodObject<z.ZodRawShape>,
     deleteMany: (rows: TListItem[]) => void;
     updateMany: (rows: TListItem[], data: Record<string, unknown>) => void;
     setVariant: (variant: ModalVariant$1) => void;
+    /** 刷新当前列表数据 */
+    refresh?: () => Promise<unknown>;
     /** 导入数据（router 有 import 路由时自动可用） */
     import: ((rows: Record<string, unknown>[]) => Promise<ImportResult>) | null;
     /** 导出筛选结果（router 有 export procedure 或传入 exportFetcher 时自动可用）。导出选中行由 AutoCrudTable 内部处理 */
@@ -341,6 +344,12 @@ type BatchCustomActionItem<TData> = BatchActionMeta & {
 };
 type BatchActionItem<TData> = BatchBuiltinActionItem<TData> | BatchCustomActionItem<TData>;
 type BatchActionConfig<TData> = BatchActionItem<TData>[] | ((defaults: BatchBuiltinActionItem<TData>[]) => BatchActionItem<TData>[]);
+interface BatchDeleteConfirmation {
+  title: string;
+  description: (count: number) => string;
+  cancel: string;
+  confirm: string;
+}
 interface AutoTableActionBarProps<TData> {
   table: Table<TData>;
   onDeleteSelected?: (rows: TData[]) => void;
@@ -358,6 +367,8 @@ interface AutoTableActionBarProps<TData> {
   extraActions?: React$1.ReactNode;
   /** 批量操作配置，支持和行操作/顶部工具栏一致的顺序接管语义 */
   actions?: BatchActionConfig<TData>;
+  /** 批量删除二次确认文案 */
+  deleteConfirmation?: BatchDeleteConfirmation;
 }
 declare function AutoTableActionBar<TData>({
   table,
@@ -368,7 +379,8 @@ declare function AutoTableActionBar<TData>({
   showDefaultExport,
   enableDelete,
   extraActions,
-  actions
+  actions,
+  deleteConfirmation
 }: AutoTableActionBarProps<TData>): react_jsx_runtime1.JSX.Element;
 //#endregion
 //#region src/lib/schema-bridge/types.d.ts
@@ -507,6 +519,8 @@ interface AutoTableProps<T extends z.ZodObject<z.ZodRawShape>> {
   actionBarExtra?: React.ReactNode;
   /** 批量悬浮操作配置 */
   actionBarActions?: BatchActionConfig<z.infer<T>>;
+  /** 批量删除二次确认文案 */
+  deleteConfirmation?: BatchDeleteConfirmation;
   /** 初始排序 */
   initialSorting?: any[];
   /** 是否启用导出功能 (默认 true) */
@@ -536,6 +550,7 @@ declare function AutoTable<T extends z.ZodObject<z.ZodRawShape>>({
   batchUpdateFields,
   actionBarExtra,
   actionBarActions,
+  deleteConfirmation,
   initialSorting,
   enableExport,
   showDefaultExport,
@@ -557,6 +572,7 @@ declare function AutoTable<T extends z.ZodObject<z.ZodRawShape>>({
  */
 interface AutoCrudLocale {
   toolbar: {
+    refresh: string;
     create: string;
     import: string;
     export: string;
@@ -590,6 +606,12 @@ interface AutoCrudLocale {
     confirm: string;
     confirming: string;
   };
+  bulkDeleteModal: {
+    title: string;
+    description: (count: number) => string;
+    cancel: string;
+    confirm: string;
+  };
   importDialog: {
     title: string;
     uploadDescription: string;
@@ -650,11 +672,14 @@ type AutoCrudOption = {
 };
 type AutoCrudDataSourceContext = {
   field: string;
+  page?: number;
+  pageSize?: number;
   search?: string;
   values?: Record<string, unknown>;
   signal?: AbortSignal;
 };
 type AutoCrudDataSourceResult = AutoCrudOption[] | {
+  hasMore?: boolean;
   options?: AutoCrudOption[];
 };
 type AutoCrudDataSourceLoader = (context: AutoCrudDataSourceContext) => AutoCrudDataSourceResult | Promise<AutoCrudDataSourceResult>;
@@ -662,11 +687,19 @@ type AutoCrudDataSourceConfig = string;
 type AutoCrudDataSourceRegistration = AutoCrudDataSourceLoader | {
   dependencies?: string[];
   reset?: boolean;
+  search?: boolean;
+  debounceMs?: number;
+  loadMore?: boolean;
+  pageSize?: number;
   load: AutoCrudDataSourceLoader;
 };
 type AutoCrudDataSourceEntry = {
   dependencies: string[];
   reset: boolean;
+  search: boolean;
+  debounceMs: number;
+  loadMore: boolean;
+  pageSize: number;
   load: AutoCrudDataSourceLoader;
 };
 type RegistryListener$1 = () => void;
@@ -839,8 +872,9 @@ type AutoCrudActionConfig<T> = RowActionConfig<T> | AutoCrudActionsConfig<T>;
 /**
  * 顶部工具栏内置操作项
  */
+type ToolbarBuiltinActionType = 'refresh' | 'create' | 'import' | 'export';
 type ToolbarBuiltinActionItem = ActionMeta & {
-  type: 'create' | 'import' | 'export';
+  type: ToolbarBuiltinActionType;
   /** 替代默认的行为 */
   onClick?: () => void;
   /** 替代默认的标签文本 */
@@ -866,6 +900,8 @@ interface AutoCrudToolbarContext {
   rowIds: string[];
   selectedRowIds: string[];
   selectedCount: number;
+  refresh?: () => Promise<unknown>;
+  isRefreshing: boolean;
   openCreate?: () => void;
 }
 type AutoCrudToolbarResolver = (targetId: string, ownerActions: readonly ToolbarActionItem[], context: AutoCrudToolbarContext) => ToolbarActionItem[];
@@ -925,6 +961,8 @@ interface AutoCrudTableProps<TSchema extends z.ZodObject<z.ZodRawShape>> {
   form?: {
     /** 表单覆盖配置（兼容旧 API，优先级低于 fieldOverrides） */
     overrides?: Record<string, any>;
+    /** Formily schema expression/reaction scope */
+    scope?: JsonSchemaFormScope;
     /** 表单列数 */
     columns?: number;
     /** 弹窗自定义容器类名（支持控制大小、最大高度等） */
@@ -1006,7 +1044,12 @@ interface AutoFormProps<T extends z.ZodObject<z.ZodRawShape>> {
   schema: T;
   initialValues?: Partial<z.infer<T>>;
   onSubmit: (values: z.infer<T>) => void | Promise<void>;
+  /** 统一字段配置，推荐用于描述 auto-crud 字段级表单行为 */
+  fields?: Fields;
+  /** Formily 字段 schema 覆盖配置，保留兼容旧 API */
   overrides?: FormSchemaOverrides;
+  /** Formily schema expression/reaction scope */
+  scope?: JsonSchemaFormScope;
   mode?: 'create' | 'edit';
   loading?: boolean;
   gridColumns?: number;
@@ -1024,7 +1067,9 @@ declare function AutoFormInner<T extends z.ZodObject<z.ZodRawShape>>({
   schema: zodSchema,
   initialValues,
   onSubmit,
+  fields,
   overrides,
+  scope: scopeProp,
   mode,
   loading,
   gridColumns,
@@ -1289,6 +1334,20 @@ declare module '@tanstack/react-table' {
     icon?: React.FC<React.SVGProps<SVGSVGElement>>;
     /** 控制在哪些筛选模式下显示（未设置则在所有模式显示） */
     modes?: Array<'simple' | 'advanced' | 'command'>;
+    /** 内部：远程筛选选项搜索值 */
+    autoCrudFilterSearchValue?: string;
+    /** 内部：远程筛选选项搜索回调 */
+    autoCrudFilterOnSearch?: (value: string) => void;
+    /** 内部：是否启用本地选项过滤 */
+    autoCrudFilterShouldFilter?: boolean;
+    /** 内部：远程筛选当前弹窗选项，和稳定标签缓存分离 */
+    autoCrudFilterOptions?: Option[];
+    /** 内部：远程筛选是否还有更多选项 */
+    autoCrudFilterHasMore?: boolean;
+    /** 内部：远程筛选是否正在加载 */
+    autoCrudFilterLoading?: boolean;
+    /** 内部：远程筛选弹窗滚动回调 */
+    autoCrudFilterOnPopupScroll?: React.UIEventHandler<HTMLElement>;
   }
 }
 interface QueryKeys {
@@ -1342,18 +1401,19 @@ type ModalVariant = "dialog" | "sheet";
 interface CrudFormModalProps<T extends z.ZodObject<z.ZodRawShape>> {
   open: boolean;
   onOpenChange: (open: boolean) => void;
-  mode: "create" | "edit";
+  mode: 'create' | 'edit';
   schema: T;
   initialValues?: Partial<z.infer<T>>;
   onSubmit: (values: z.infer<T>) => void | Promise<void>;
   loading?: boolean;
   variant?: ModalVariant;
   overrides?: FormSchemaOverrides;
+  scope?: JsonSchemaFormScope;
   title?: string;
-  locale?: AutoCrudLocale["formModal"];
+  locale?: AutoCrudLocale['formModal'];
   gridColumns?: number;
   /** Label 对齐方式 */
-  labelAlign?: "left" | "top" | "right";
+  labelAlign?: 'left' | 'top' | 'right';
   /** Label 宽度（labelAlign 为 left 时有效） */
   labelWidth?: number | string;
   /** 弹窗自定义样式 */
@@ -1369,6 +1429,7 @@ declare function CrudFormModal<T extends z.ZodObject<z.ZodRawShape>>({
   loading,
   variant,
   overrides,
+  scope,
   title,
   locale,
   gridColumns,
@@ -1388,7 +1449,7 @@ interface ImportDialogProps {
   /** 对话框标题（优先于 locale.title） */
   title?: string;
   /** 语言包，默认 zh-CN */
-  locale?: AutoCrudLocale["importDialog"];
+  locale?: AutoCrudLocale['importDialog'];
 }
 declare function ImportDialog({
   open,
@@ -1503,47 +1564,6 @@ declare function DataTableViewOptions<TData>({
   ...props
 }: DataTableViewOptionsProps<TData>): react_jsx_runtime1.JSX.Element;
 //#endregion
-//#region src/components/ui/multi-combobox.d.ts
-interface MultiComboboxOption {
-  value: string;
-  label: ReactNode;
-  searchText?: string | string[];
-  keywords?: string[];
-  count?: number;
-  disabled?: boolean;
-  icon?: React$1.ComponentType<{
-    className?: string;
-  }>;
-}
-interface MultiComboboxTriggerRenderProps {
-  open: boolean;
-  selectedOptions: MultiComboboxOption[];
-  selectedValues: string[];
-  clearSelection: (event?: React$1.MouseEvent) => void;
-  disabled?: boolean;
-  readOnly?: boolean;
-}
-interface MultiComboboxProps extends Omit<ComponentProps<typeof Command>, 'value' | 'defaultValue' | 'onChange' | 'onValueChange'> {
-  value?: string[];
-  defaultValue?: string[];
-  onChange?: (value: string[]) => void;
-  options?: MultiComboboxOption[];
-  placeholder?: string;
-  searchPlaceholder?: string;
-  emptyText?: string;
-  clearText?: string;
-  selectedText?: string;
-  selectionMode?: 'single' | 'multiple';
-  disabled?: boolean;
-  readOnly?: boolean;
-  className?: string;
-  contentClassName?: string;
-  triggerClassName?: string;
-  matchTriggerWidth?: boolean;
-  renderTrigger?: (props: MultiComboboxTriggerRenderProps) => ReactNode;
-}
-declare const MultiCombobox: React$1.FC<MultiComboboxProps>;
-//#endregion
 //#region src/lib/crud-actions.d.ts
 type CrudActionZone = 'toolbar' | 'row' | 'batch';
 type CrudActionBase = {
@@ -1917,4 +1937,4 @@ declare function exportAllToCSV<T extends Record<string, unknown>>(data: T[], op
  */
 declare function downloadCSVTemplate(headers: string[], filename?: string): void;
 //#endregion
-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 };
+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 AutoFormProps, 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, Select, type SelectMode, type SelectOption, type SelectProps, type SelectSearchableDynamicProps, type SelectSearchableMultipleProps, type SelectSearchableProps, type SelectSearchableSingleProps, type SelectSimpleProps, type SelectTriggerRenderProps, type SimpleFieldConfig, type SimpleFieldsConfig, type ToastAdapter, type ToolbarActionConfig, type ToolbarActionItem, type ToolbarBuiltinActionItem, type ToolbarBuiltinActionType, 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 };