@wordrhyme/auto-crud 1.3.6 → 1.3.9

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime0 from "react/jsx-runtime";
+import * as react_jsx_runtime3 from "react/jsx-runtime";
 import { z } from "zod";
 import { JsonSchemaFormScope } from "@wordrhyme/formily-shadcn";
 import * as _tanstack_react_table0 from "@tanstack/react-table";
@@ -9,6 +9,12 @@ 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/lib/default-sorting.d.ts
+type AutoCrudSorting = Array<{
+  id: string;
+  desc: boolean;
+}>;
+//#endregion
 //#region src/hooks/use-auto-crud-resource.d.ts
 /**
  * Toast 适配器接口
@@ -103,6 +109,12 @@ interface UseAutoCrudResourceOptions<TSchema extends z.ZodObject<z.ZodRawShape>,
     total: number;
     hasMore: boolean;
   }>;
+  /**
+   * 默认排序。
+   * - undefined: schema 有 createdAt 时默认 createdAt desc
+   * - false: 不应用默认排序
+   */
+  defaultSort?: AutoCrudSorting | false;
 }
 /**
  * 导入结果类型（与服务端保持一致）
@@ -133,6 +145,8 @@ interface UseAutoCrudResourceReturn<TSchema extends z.ZodObject<z.ZodRawShape>,
   schema?: z.ZodObject<z.ZodRawShape>;
   /** Optional field config override from host metadata. */
   fields?: Fields;
+  /** Default sorting used by this resource's list query. */
+  defaultSort?: AutoCrudSorting;
   modal: ModalState<TListItem>;
   mutations: {
     isCreating: boolean;
@@ -381,7 +395,7 @@ declare function AutoTableActionBar<TData>({
   extraActions,
   actions,
   deleteConfirmation
-}: AutoTableActionBarProps<TData>): react_jsx_runtime0.JSX.Element;
+}: AutoTableActionBarProps<TData>): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/lib/schema-bridge/types.d.ts
 /**
@@ -557,7 +571,7 @@ declare function AutoTable<T extends z.ZodObject<z.ZodRawShape>>({
   onSelectedCountChange,
   onSelectedRowsChange,
   getSelectedRows
-}: AutoTableProps<T>): react_jsx_runtime0.JSX.Element;
+}: AutoTableProps<T>): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/i18n/locale.d.ts
 /**
@@ -670,12 +684,19 @@ type AutoCrudOption = {
   count?: number;
   disabled?: boolean;
 };
+type AutoCrudDataSourceContextType = 'form' | 'filter' | 'resolve';
+type AutoCrudDataSourceResolveFields = readonly string[] | ((context: {
+  field: string;
+}) => readonly string[]);
 type AutoCrudDataSourceContext = {
   field: string;
+  type: AutoCrudDataSourceContextType;
   page?: number;
   pageSize?: number;
+  query?: string;
+  /** @deprecated Use `query` instead. */
   search?: string;
-  values?: Record<string, unknown>;
+  values?: Record<string, unknown> | Record<string, unknown>[];
   signal?: AbortSignal;
 };
 type AutoCrudDataSourceResult = AutoCrudOption[] | {
@@ -691,6 +712,7 @@ type AutoCrudDataSourceRegistration = AutoCrudDataSourceLoader | {
   debounceMs?: number;
   loadMore?: boolean;
   pageSize?: number;
+  resolveFields?: AutoCrudDataSourceResolveFields;
   load: AutoCrudDataSourceLoader;
 };
 type AutoCrudDataSourceEntry = {
@@ -700,6 +722,7 @@ type AutoCrudDataSourceEntry = {
   debounceMs: number;
   loadMore: boolean;
   pageSize: number;
+  resolveFields?: AutoCrudDataSourceResolveFields;
   load: AutoCrudDataSourceLoader;
 };
 type RegistryListener$1 = () => void;
@@ -901,8 +924,11 @@ interface AutoCrudToolbarContext {
   selectedRowIds: string[];
   selectedCount: number;
   refresh?: () => Promise<unknown>;
-  isRefreshing: boolean;
+  openImport?: () => void;
+  exportData?: () => Promise<void>;
   openCreate?: () => void;
+  isRefreshing: boolean;
+  isExporting: boolean;
 }
 type AutoCrudToolbarResolver = (targetId: string, ownerActions: readonly ToolbarActionItem[], context: AutoCrudToolbarContext) => ToolbarActionItem[];
 declare function setToolbarResolver(resolver: AutoCrudToolbarResolver | null): void;
@@ -1037,7 +1063,7 @@ declare function AutoCrudTable<TSchema extends z.ZodObject<z.ZodRawShape>>({
   toolbarActions,
   locale: localeProp,
   onCreate
-}: AutoCrudTableProps<TSchema>): react_jsx_runtime0.JSX.Element;
+}: AutoCrudTableProps<TSchema>): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/auto-form.d.ts
 interface AutoFormProps<T extends z.ZodObject<z.ZodRawShape>> {
@@ -1076,7 +1102,7 @@ declare function AutoFormInner<T extends z.ZodObject<z.ZodRawShape>>({
   labelAlign,
   labelWidth,
   showSubmitButton
-}: AutoFormProps<T>, ref: React.Ref<AutoFormRef>): react_jsx_runtime0.JSX.Element;
+}: AutoFormProps<T>, ref: React.Ref<AutoFormRef>): react_jsx_runtime3.JSX.Element;
 declare const AutoForm: <T extends z.ZodObject<z.ZodRawShape>>(props: AutoFormProps<T> & {
   ref?: React.Ref<AutoFormRef>;
 }) => ReturnType<typeof AutoFormInner>;
@@ -1392,7 +1418,7 @@ declare function AutoTableSimpleFilters<TData>({
   filters: externalFilters,
   onFiltersChange,
   leading
-}: AutoTableSimpleFiltersProps<TData>): react_jsx_runtime0.JSX.Element | null;
+}: AutoTableSimpleFiltersProps<TData>): react_jsx_runtime3.JSX.Element | null;
 //#endregion
 //#region src/components/auto-crud/form-modal.d.ts
 type ModalVariant = "dialog" | "sheet";
@@ -1436,7 +1462,7 @@ declare function CrudFormModal<T extends z.ZodObject<z.ZodRawShape>>({
   labelAlign,
   labelWidth,
   className
-}: CrudFormModalProps<T>): react_jsx_runtime0.JSX.Element;
+}: CrudFormModalProps<T>): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/import-dialog.d.ts
 interface ImportDialogProps {
@@ -1458,7 +1484,7 @@ declare function ImportDialog({
   columns,
   title,
   locale
-}: ImportDialogProps): react_jsx_runtime0.JSX.Element;
+}: ImportDialogProps): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/export-dialog.d.ts
 type ExportMode = "selected" | "filtered";
@@ -1478,7 +1504,7 @@ declare function ExportDialog({
   selectedCount,
   onExport,
   canExportFiltered
-}: ExportDialogProps): react_jsx_runtime0.JSX.Element;
+}: ExportDialogProps): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table.d.ts
 interface DataTableProps<TData> extends React$1.ComponentProps<"div"> {
@@ -1491,7 +1517,7 @@ declare function DataTable<TData>({
   children,
   className,
   ...props
-}: DataTableProps<TData>): react_jsx_runtime0.JSX.Element;
+}: DataTableProps<TData>): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-advanced-toolbar.d.ts
 interface DataTableAdvancedToolbarProps<TData> extends React$1.ComponentProps<"div"> {
@@ -1502,7 +1528,7 @@ declare function DataTableAdvancedToolbar<TData>({
   children,
   className,
   ...props
-}: DataTableAdvancedToolbarProps<TData>): react_jsx_runtime0.JSX.Element;
+}: DataTableAdvancedToolbarProps<TData>): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-column-header.d.ts
 interface DataTableColumnHeaderProps<TData, TValue> extends React.ComponentProps<typeof DropdownMenuTrigger> {
@@ -1514,7 +1540,7 @@ declare function DataTableColumnHeader<TData, TValue>({
   label,
   className,
   ...props
-}: DataTableColumnHeaderProps<TData, TValue>): react_jsx_runtime0.JSX.Element;
+}: DataTableColumnHeaderProps<TData, TValue>): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-faceted-filter.d.ts
 interface DataTableFacetedFilterProps<TData, TValue> {
@@ -1528,7 +1554,7 @@ declare function DataTableFacetedFilter<TData, TValue>({
   title,
   options,
   multiple
-}: DataTableFacetedFilterProps<TData, TValue>): react_jsx_runtime0.JSX.Element;
+}: DataTableFacetedFilterProps<TData, TValue>): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-pagination.d.ts
 interface DataTablePaginationProps<TData> extends React.ComponentProps<"div"> {
@@ -1540,7 +1566,7 @@ declare function DataTablePagination<TData>({
   pageSizeOptions,
   className,
   ...props
-}: DataTablePaginationProps<TData>): react_jsx_runtime0.JSX.Element;
+}: DataTablePaginationProps<TData>): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-toolbar.d.ts
 interface DataTableToolbarProps<TData> extends React$1.ComponentProps<"div"> {
@@ -1551,7 +1577,7 @@ declare function DataTableToolbar<TData>({
   children,
   className,
   ...props
-}: DataTableToolbarProps<TData>): react_jsx_runtime0.JSX.Element;
+}: DataTableToolbarProps<TData>): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-view-options.d.ts
 interface DataTableViewOptionsProps<TData> extends React$1.ComponentProps<typeof PopoverContent> {
@@ -1562,7 +1588,7 @@ declare function DataTableViewOptions<TData>({
   table,
   disabled,
   ...props
-}: DataTableViewOptionsProps<TData>): react_jsx_runtime0.JSX.Element;
+}: DataTableViewOptionsProps<TData>): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/lib/crud-actions.d.ts
 type CrudActionZone = 'toolbar' | 'row' | 'batch';
@@ -1644,7 +1670,7 @@ declare function useReadableFilters<TData>(columns: ColumnLike<TData>[], options
  */
 declare function createFormSchema<T extends z.ZodObject<z.ZodRawShape>>(schema: T, options?: CreateFormSchemaOptions): ISchema;
 /**
- * 为编辑模式创建 Form Schema（排除 id, createdAt, updatedAt）
+ * 为编辑模式创建 Form Schema（排除平台托管字段）
  */
 declare function createEditFormSchema<T extends z.ZodObject<z.ZodRawShape>>(schema: T, options?: Omit<CreateFormSchemaOptions, 'exclude'>): ISchema;
 //#endregion

package/dist/index.d.ts

@@ -3,12 +3,18 @@ import * as _tanstack_react_table0 from "@tanstack/react-table";
 import { Column, ColumnDef, ColumnSort, Row, RowData, Table, TableOptions, TableState } from "@tanstack/react-table";
 import { DropdownMenuTrigger, PopoverContent } from "@wordrhyme/shadcn";
 import { ClassValue } from "clsx";
-import * as react_jsx_runtime0 from "react/jsx-runtime";
+import * as react_jsx_runtime5 from "react/jsx-runtime";
 import { MultiCombobox, MultiComboboxOption, MultiComboboxProps, MultiComboboxTriggerRenderProps, Select, SelectMode, SelectOption, SelectProps, SelectSearchableDynamicProps, SelectSearchableMultipleProps, SelectSearchableProps, SelectSearchableSingleProps, SelectSimpleProps, SelectTriggerRenderProps } from "@wordrhyme/shadcn-ui";
 import { z } from "zod";
 import { JsonSchemaFormScope } from "@wordrhyme/formily-shadcn";
 import { ISchema } from "@formily/json-schema";
 
+//#region src/lib/default-sorting.d.ts
+type AutoCrudSorting = Array<{
+  id: string;
+  desc: boolean;
+}>;
+//#endregion
 //#region src/hooks/use-auto-crud-resource.d.ts
 /**
  * Toast 适配器接口
@@ -103,6 +109,12 @@ interface UseAutoCrudResourceOptions<TSchema extends z.ZodObject<z.ZodRawShape>,
     total: number;
     hasMore: boolean;
   }>;
+  /**
+   * 默认排序。
+   * - undefined: schema 有 createdAt 时默认 createdAt desc
+   * - false: 不应用默认排序
+   */
+  defaultSort?: AutoCrudSorting | false;
 }
 /**
  * 导入结果类型（与服务端保持一致）
@@ -133,6 +145,8 @@ interface UseAutoCrudResourceReturn<TSchema extends z.ZodObject<z.ZodRawShape>,
   schema?: z.ZodObject<z.ZodRawShape>;
   /** Optional field config override from host metadata. */
   fields?: Fields;
+  /** Default sorting used by this resource's list query. */
+  defaultSort?: AutoCrudSorting;
   modal: ModalState<TListItem>;
   mutations: {
     isCreating: boolean;
@@ -381,7 +395,7 @@ declare function AutoTableActionBar<TData>({
   extraActions,
   actions,
   deleteConfirmation
-}: AutoTableActionBarProps<TData>): react_jsx_runtime0.JSX.Element;
+}: AutoTableActionBarProps<TData>): react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/lib/schema-bridge/types.d.ts
 /**
@@ -557,7 +571,7 @@ declare function AutoTable<T extends z.ZodObject<z.ZodRawShape>>({
   onSelectedCountChange,
   onSelectedRowsChange,
   getSelectedRows
-}: AutoTableProps<T>): react_jsx_runtime0.JSX.Element;
+}: AutoTableProps<T>): react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/i18n/locale.d.ts
 /**
@@ -670,12 +684,19 @@ type AutoCrudOption = {
   count?: number;
   disabled?: boolean;
 };
+type AutoCrudDataSourceContextType = 'form' | 'filter' | 'resolve';
+type AutoCrudDataSourceResolveFields = readonly string[] | ((context: {
+  field: string;
+}) => readonly string[]);
 type AutoCrudDataSourceContext = {
   field: string;
+  type: AutoCrudDataSourceContextType;
   page?: number;
   pageSize?: number;
+  query?: string;
+  /** @deprecated Use `query` instead. */
   search?: string;
-  values?: Record<string, unknown>;
+  values?: Record<string, unknown> | Record<string, unknown>[];
   signal?: AbortSignal;
 };
 type AutoCrudDataSourceResult = AutoCrudOption[] | {
@@ -691,6 +712,7 @@ type AutoCrudDataSourceRegistration = AutoCrudDataSourceLoader | {
   debounceMs?: number;
   loadMore?: boolean;
   pageSize?: number;
+  resolveFields?: AutoCrudDataSourceResolveFields;
   load: AutoCrudDataSourceLoader;
 };
 type AutoCrudDataSourceEntry = {
@@ -700,6 +722,7 @@ type AutoCrudDataSourceEntry = {
   debounceMs: number;
   loadMore: boolean;
   pageSize: number;
+  resolveFields?: AutoCrudDataSourceResolveFields;
   load: AutoCrudDataSourceLoader;
 };
 type RegistryListener$1 = () => void;
@@ -901,8 +924,11 @@ interface AutoCrudToolbarContext {
   selectedRowIds: string[];
   selectedCount: number;
   refresh?: () => Promise<unknown>;
-  isRefreshing: boolean;
+  openImport?: () => void;
+  exportData?: () => Promise<void>;
   openCreate?: () => void;
+  isRefreshing: boolean;
+  isExporting: boolean;
 }
 type AutoCrudToolbarResolver = (targetId: string, ownerActions: readonly ToolbarActionItem[], context: AutoCrudToolbarContext) => ToolbarActionItem[];
 declare function setToolbarResolver(resolver: AutoCrudToolbarResolver | null): void;
@@ -1037,7 +1063,7 @@ declare function AutoCrudTable<TSchema extends z.ZodObject<z.ZodRawShape>>({
   toolbarActions,
   locale: localeProp,
   onCreate
-}: AutoCrudTableProps<TSchema>): react_jsx_runtime0.JSX.Element;
+}: AutoCrudTableProps<TSchema>): react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/auto-form.d.ts
 interface AutoFormProps<T extends z.ZodObject<z.ZodRawShape>> {
@@ -1076,7 +1102,7 @@ declare function AutoFormInner<T extends z.ZodObject<z.ZodRawShape>>({
   labelAlign,
   labelWidth,
   showSubmitButton
-}: AutoFormProps<T>, ref: React.Ref<AutoFormRef>): react_jsx_runtime0.JSX.Element;
+}: AutoFormProps<T>, ref: React.Ref<AutoFormRef>): react_jsx_runtime5.JSX.Element;
 declare const AutoForm: <T extends z.ZodObject<z.ZodRawShape>>(props: AutoFormProps<T> & {
   ref?: React.Ref<AutoFormRef>;
 }) => ReturnType<typeof AutoFormInner>;
@@ -1392,7 +1418,7 @@ declare function AutoTableSimpleFilters<TData>({
   filters: externalFilters,
   onFiltersChange,
   leading
-}: AutoTableSimpleFiltersProps<TData>): react_jsx_runtime0.JSX.Element | null;
+}: AutoTableSimpleFiltersProps<TData>): react_jsx_runtime5.JSX.Element | null;
 //#endregion
 //#region src/components/auto-crud/form-modal.d.ts
 type ModalVariant = "dialog" | "sheet";
@@ -1436,7 +1462,7 @@ declare function CrudFormModal<T extends z.ZodObject<z.ZodRawShape>>({
   labelAlign,
   labelWidth,
   className
-}: CrudFormModalProps<T>): react_jsx_runtime0.JSX.Element;
+}: CrudFormModalProps<T>): react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/import-dialog.d.ts
 interface ImportDialogProps {
@@ -1458,7 +1484,7 @@ declare function ImportDialog({
   columns,
   title,
   locale
-}: ImportDialogProps): react_jsx_runtime0.JSX.Element;
+}: ImportDialogProps): react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/export-dialog.d.ts
 type ExportMode = "selected" | "filtered";
@@ -1478,7 +1504,7 @@ declare function ExportDialog({
   selectedCount,
   onExport,
   canExportFiltered
-}: ExportDialogProps): react_jsx_runtime0.JSX.Element;
+}: ExportDialogProps): react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table.d.ts
 interface DataTableProps<TData> extends React$1.ComponentProps<"div"> {
@@ -1491,7 +1517,7 @@ declare function DataTable<TData>({
   children,
   className,
   ...props
-}: DataTableProps<TData>): react_jsx_runtime0.JSX.Element;
+}: DataTableProps<TData>): react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-advanced-toolbar.d.ts
 interface DataTableAdvancedToolbarProps<TData> extends React$1.ComponentProps<"div"> {
@@ -1502,7 +1528,7 @@ declare function DataTableAdvancedToolbar<TData>({
   children,
   className,
   ...props
-}: DataTableAdvancedToolbarProps<TData>): react_jsx_runtime0.JSX.Element;
+}: DataTableAdvancedToolbarProps<TData>): react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-column-header.d.ts
 interface DataTableColumnHeaderProps<TData, TValue> extends React.ComponentProps<typeof DropdownMenuTrigger> {
@@ -1514,7 +1540,7 @@ declare function DataTableColumnHeader<TData, TValue>({
   label,
   className,
   ...props
-}: DataTableColumnHeaderProps<TData, TValue>): react_jsx_runtime0.JSX.Element;
+}: DataTableColumnHeaderProps<TData, TValue>): react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-faceted-filter.d.ts
 interface DataTableFacetedFilterProps<TData, TValue> {
@@ -1528,7 +1554,7 @@ declare function DataTableFacetedFilter<TData, TValue>({
   title,
   options,
   multiple
-}: DataTableFacetedFilterProps<TData, TValue>): react_jsx_runtime0.JSX.Element;
+}: DataTableFacetedFilterProps<TData, TValue>): react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-pagination.d.ts
 interface DataTablePaginationProps<TData> extends React.ComponentProps<"div"> {
@@ -1540,7 +1566,7 @@ declare function DataTablePagination<TData>({
   pageSizeOptions,
   className,
   ...props
-}: DataTablePaginationProps<TData>): react_jsx_runtime0.JSX.Element;
+}: DataTablePaginationProps<TData>): react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-toolbar.d.ts
 interface DataTableToolbarProps<TData> extends React$1.ComponentProps<"div"> {
@@ -1551,7 +1577,7 @@ declare function DataTableToolbar<TData>({
   children,
   className,
   ...props
-}: DataTableToolbarProps<TData>): react_jsx_runtime0.JSX.Element;
+}: DataTableToolbarProps<TData>): react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-view-options.d.ts
 interface DataTableViewOptionsProps<TData> extends React$1.ComponentProps<typeof PopoverContent> {
@@ -1562,7 +1588,7 @@ declare function DataTableViewOptions<TData>({
   table,
   disabled,
   ...props
-}: DataTableViewOptionsProps<TData>): react_jsx_runtime0.JSX.Element;
+}: DataTableViewOptionsProps<TData>): react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/lib/crud-actions.d.ts
 type CrudActionZone = 'toolbar' | 'row' | 'batch';
@@ -1644,7 +1670,7 @@ declare function useReadableFilters<TData>(columns: ColumnLike<TData>[], options
  */
 declare function createFormSchema<T extends z.ZodObject<z.ZodRawShape>>(schema: T, options?: CreateFormSchemaOptions): ISchema;
 /**
- * 为编辑模式创建 Form Schema（排除 id, createdAt, updatedAt）
+ * 为编辑模式创建 Form Schema（排除平台托管字段）
  */
 declare function createEditFormSchema<T extends z.ZodObject<z.ZodRawShape>>(schema: T, options?: Omit<CreateFormSchemaOptions, 'exclude'>): ISchema;
 //#endregion