@wordrhyme/auto-crud 1.0.0 → 1.0.2

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime3 from "react/jsx-runtime";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
 import { z } from "zod";
 import * as _tanstack_react_table0 from "@tanstack/react-table";
 import { Column, ColumnDef, ColumnSort, Row, RowData, Table, TableOptions, TableState } from "@tanstack/react-table";
@@ -314,7 +314,7 @@ declare function AutoTableActionBar<TData>({
   enableExport,
   enableDelete,
   extraActions
-}: AutoTableActionBarProps<TData>): react_jsx_runtime3.JSX.Element;
+}: AutoTableActionBarProps<TData>): react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/lib/schema-bridge/types.d.ts
 /**
@@ -394,16 +394,23 @@ declare function createSelectColumn<T>(): ColumnDef<T>;
 /**
  * 操作列配置
  */
-interface ActionsColumnConfig<T> {
-  onEdit?: (row: T) => void;
-  onDelete?: (row: T) => void;
-  onView?: (row: T) => void;
-  onCopy?: (row: T) => void;
+/**
+ * 已解析的操作项（渲染层使用）
+ */
+interface ResolvedActionItem<T> {
+  label: string;
+  onClick: (row: T) => void;
+  separator?: boolean;
+  variant?: "default" | "destructive";
 }
+/**
+ * 操作列配置（ResolvedActionItem 数组）
+ */
+type ActionsColumnConfig<T> = ResolvedActionItem<T>[];
 /**
  * 创建操作列
  */
-declare function createActionsColumn<T>(config: ActionsColumnConfig<T>): ColumnDef<T>;
+declare function createActionsColumn<T>(items: ActionsColumnConfig<T>): ColumnDef<T>;
 //#endregion
 //#region src/components/auto-crud/auto-table.d.ts
 /** 过滤模式类型 */
@@ -463,7 +470,97 @@ declare function AutoTable<T extends z.ZodObject<z.ZodRawShape>>({
   enableExport,
   onSelectedCountChange,
   getSelectedRows
-}: AutoTableProps<T>): react_jsx_runtime3.JSX.Element;
+}: AutoTableProps<T>): react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/i18n/locale.d.ts
+/**
+ * AutoCrud 国际化接口及内置语言包
+ *
+ * 使用方式：
+ *   // 内置语言
+ *   <AutoCrudTable locale="en-US" ... />
+ *
+ *   // 部分覆盖（以 zh-CN 为基础深合并）
+ *   <AutoCrudTable locale={{ toolbar: { create: "Add" } }} ... />
+ */
+interface AutoCrudLocale {
+  toolbar: {
+    create: string;
+    import: string;
+    export: string;
+    exportSelected: (count: number) => string;
+  };
+  rowActions: {
+    view: string;
+    edit: string;
+    copy: string;
+    delete: string;
+  };
+  viewModal: {
+    title: string;
+  };
+  boolean: {
+    true: string;
+    false: string;
+  };
+  formModal: {
+    createTitle: string;
+    editTitle: string;
+    cancel: string;
+    create: string;
+    save: string;
+    submitting: string;
+  };
+  deleteModal: {
+    title: string;
+    description: string;
+    cancel: string;
+    confirm: string;
+    confirming: string;
+  };
+  importDialog: {
+    title: string;
+    uploadDescription: string;
+    previewDescription: (count: number) => string;
+    importingDescription: string;
+    doneDescription: string;
+    dragHint: string;
+    formatHint: string;
+    downloadTemplate: string;
+    moreColumns: (count: number) => string;
+    previewSummary: (rows: number, fields: number, format: string, previewLimit?: number) => string;
+    reselect: string;
+    confirmImport: string;
+    importingRows: (count: number) => string;
+    resultCreated: string;
+    resultUpdated: string;
+    resultSkipped: string;
+    resultFailed: string;
+    failedRowHeader: string;
+    failedErrorHeader: string;
+    close: string;
+    continueImport: string;
+    errorNoData: string;
+    errorParseFailed: string;
+    errorImportFailed: string;
+  };
+}
+declare const zhCN: AutoCrudLocale;
+declare const enUS: AutoCrudLocale;
+declare const jaJP: AutoCrudLocale;
+declare const koKR: AutoCrudLocale;
+declare const frFR: AutoCrudLocale;
+declare const deDE: AutoCrudLocale;
+declare const esES: AutoCrudLocale;
+type DeepPartial<T> = { [P in keyof T]?: T[P] extends ((...args: unknown[]) => unknown) ? T[P] : T[P] extends object ? DeepPartial<T[P]> : T[P] };
+/** locale prop 类型：内置语言 key 或部分覆盖对象 */
+type LocaleProp = string | DeepPartial<AutoCrudLocale>;
+/**
+ * 解析 locale prop 为完整的 AutoCrudLocale
+ * - string → 内置语言（fallback: zh-CN）
+ * - object → 以 zh-CN 为基础深合并
+ */
+declare function resolveLocale(localeProp?: LocaleProp): AutoCrudLocale;
 //#endregion
 //#region src/components/auto-crud/auto-crud-table.d.ts
 /**
@@ -490,6 +587,8 @@ interface FilterConfig {
   placeholder?: string;
   /** 是否在筛选栏中隐藏（隐藏筛选但不影响表格列显示） */
   hidden?: boolean;
+  /** 控制在哪些筛选模式下显示（未设置则在所有模式显示） */
+  modes?: Array<"simple" | "advanced" | "command">;
 }
 /**
  * 统一字段配置
@@ -502,10 +601,16 @@ interface Field {
   hidden?: boolean;
   /**
    * 筛选器独立配置
+   * - FilterConfig: 详细配置
+   * - false: 禁用筛选（简写，等价于 { enabled: false }）
    * 独立于 table.meta 控制筛选器行为，不影响表格列显示/隐藏
    */
-  filter?: FilterConfig;
-  /** 表格特定配置 */
+  filter?: FilterConfig | false;
+  /**
+   * 表格特定配置
+   * - object: 详细配置
+   * - false: 隐藏表格列（简写，等价于 { hidden: true }）
+   */
   table?: {
     /** 是否在表格中隐藏 */
     hidden?: boolean;
@@ -513,8 +618,12 @@ interface Field {
     meta?: Record<string, unknown>;
     /** 其他列配置 */
     [key: string]: unknown;
-  };
-  /** 表单特定配置 */
+  } | false;
+  /**
+   * 表单特定配置
+   * - object: 详细配置（Formily Schema）
+   * - false: 隐藏表单字段（简写，等价于 { "x-hidden": true }）
+   */
   form?: {
     /** 是否在表单中隐藏 */
     "x-hidden"?: boolean;
@@ -524,9 +633,34 @@ interface Field {
     "x-component-props"?: Record<string, unknown>;
     /** 其他表单配置 */
     [key: string]: unknown;
-  };
+  } | false;
 }
 type Fields = Record<string, Field>;
+type BuiltinType = "view" | "edit" | "copy" | "delete";
+/** 内置操作项（覆盖默认行为或调整位置） */
+type BuiltinActionItem<T> = {
+  type: BuiltinType;
+  onClick?: (row: T) => void;
+  label?: string;
+  separator?: boolean;
+};
+/** 自定义操作项 */
+type CustomActionItem<T> = {
+  type: "custom";
+  label: string;
+  onClick: (row: T) => void;
+  /** 仅在无内置项时生效：插入到首部还是尾部（默认 end） */
+  position?: "start" | "end";
+  separator?: boolean;
+  variant?: "default" | "destructive";
+};
+/**
+ * 行操作项
+ *
+ * - **只传 custom**：内置保持默认，custom 追加到首/尾
+ * - **包含任意内置 type**：数组完全接管，未列出的隐藏，顺序即渲染顺序
+ */
+type ActionItem<T> = BuiltinActionItem<T> | CustomActionItem<T>;
 /**
  * AutoCrudTable Props 接口
  */
@@ -578,12 +712,9 @@ interface AutoCrudTableProps<TSchema extends z.ZodObject<z.ZodRawShape>> {
     toolbarStart?: React$1.ReactNode;
     /** 工具栏右侧插槽 */
     toolbarEnd?: React$1.ReactNode;
-    /** 自定义行操作 */
-    rowActions?: (row: z.output<TSchema>) => Array<{
-      label: string;
-      onClick: () => void;
-    }>;
   };
+  /** 行操作配置，见 {@link ActionItem} */
+  actions?: ActionItem<z.output<TSchema>>[];
   /**
    * 权限配置
    * 控制按钮显示和字段访问
@@ -605,6 +736,18 @@ interface AutoCrudTableProps<TSchema extends z.ZodObject<z.ZodRawShape>> {
    * ```
    */
   permissions?: CrudPermissions;
+  /**
+   * 语言配置
+   * - 内置语言 key：`"zh-CN"`（默认）、`"en-US"`
+   * - 部分覆盖对象：以 zh-CN 为基础深合并
+   *
+   * @example
+   * ```tsx
+   * <AutoCrudTable locale="en-US" ... />
+   * <AutoCrudTable locale={{ toolbar: { create: "Add New" } }} ... />
+   * ```
+   */
+  locale?: LocaleProp;
 }
 /**
  * AutoCrudTable 组件
@@ -620,8 +763,10 @@ declare function AutoCrudTable<TSchema extends z.ZodObject<z.ZodRawShape>>({
   table: tableConfig,
   form: formConfig,
   slots,
-  permissions
-}: AutoCrudTableProps<TSchema>): react_jsx_runtime3.JSX.Element;
+  permissions,
+  actions: actionItems,
+  locale: localeProp
+}: AutoCrudTableProps<TSchema>): react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/auto-form.d.ts
 interface AutoFormProps<T extends z.ZodObject<z.ZodRawShape>> {
@@ -653,7 +798,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_runtime0.JSX.Element;
 declare const AutoForm: <T extends z.ZodObject<z.ZodRawShape>>(props: AutoFormProps<T> & {
   ref?: React.Ref<AutoFormRef>;
 }) => ReturnType<typeof AutoFormInner>;
@@ -908,6 +1053,8 @@ declare module "@tanstack/react-table" {
     range?: [number, number];
     unit?: string;
     icon?: React.FC<React.SVGProps<SVGSVGElement>>;
+    /** 控制在哪些筛选模式下显示（未设置则在所有模式显示） */
+    modes?: Array<"simple" | "advanced" | "command">;
   }
 }
 interface QueryKeys {
@@ -949,7 +1096,7 @@ declare function AutoTableSimpleFilters<TData>({
   shallow,
   filters: externalFilters,
   onFiltersChange
-}: AutoTableSimpleFiltersProps<TData>): react_jsx_runtime3.JSX.Element | null;
+}: AutoTableSimpleFiltersProps<TData>): react_jsx_runtime0.JSX.Element | null;
 //#endregion
 //#region src/components/auto-crud/form-modal.d.ts
 type ModalVariant = "dialog" | "sheet";
@@ -966,6 +1113,7 @@ interface CrudFormModalProps<T extends z.ZodObject<z.ZodRawShape>> {
   variant?: ModalVariant;
   overrides?: FormSchemaOverrides;
   title?: string;
+  locale?: AutoCrudLocale["formModal"];
   /** Label 对齐方式 */
   labelAlign?: "left" | "top" | "right";
   /** Label 宽度（labelAlign 为 left 时有效） */
@@ -982,9 +1130,10 @@ declare function CrudFormModal<T extends z.ZodObject<z.ZodRawShape>>({
   variant,
   overrides,
   title,
+  locale,
   labelAlign,
   labelWidth
-}: CrudFormModalProps<T>): react_jsx_runtime3.JSX.Element;
+}: CrudFormModalProps<T>): react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/import-dialog.d.ts
 interface ImportDialogProps {
@@ -994,16 +1143,19 @@ interface ImportDialogProps {
   onImport: (rows: Record<string, unknown>[]) => Promise<ImportResult>;
   /** 可用列名（用于生成模板） */
   columns?: string[];
-  /** 对话框标题 */
+  /** 对话框标题（优先于 locale.title） */
   title?: string;
+  /** 语言包，默认 zh-CN */
+  locale?: AutoCrudLocale["importDialog"];
 }
 declare function ImportDialog({
   open,
   onOpenChange,
   onImport,
   columns,
-  title
-}: ImportDialogProps): react_jsx_runtime3.JSX.Element;
+  title,
+  locale
+}: ImportDialogProps): react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/export-dialog.d.ts
 type ExportMode = "selected" | "filtered";
@@ -1023,7 +1175,7 @@ declare function ExportDialog({
   selectedCount,
   onExport,
   canExportFiltered
-}: ExportDialogProps): react_jsx_runtime3.JSX.Element;
+}: ExportDialogProps): react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table.d.ts
 interface DataTableProps<TData> extends React$1.ComponentProps<"div"> {
@@ -1036,7 +1188,7 @@ declare function DataTable<TData>({
   children,
   className,
   ...props
-}: DataTableProps<TData>): react_jsx_runtime3.JSX.Element;
+}: DataTableProps<TData>): react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-advanced-toolbar.d.ts
 interface DataTableAdvancedToolbarProps<TData> extends React$1.ComponentProps<"div"> {
@@ -1047,7 +1199,7 @@ declare function DataTableAdvancedToolbar<TData>({
   children,
   className,
   ...props
-}: DataTableAdvancedToolbarProps<TData>): react_jsx_runtime3.JSX.Element;
+}: DataTableAdvancedToolbarProps<TData>): react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-column-header.d.ts
 interface DataTableColumnHeaderProps<TData, TValue> extends React.ComponentProps<typeof DropdownMenuTrigger> {
@@ -1059,7 +1211,7 @@ declare function DataTableColumnHeader<TData, TValue>({
   label,
   className,
   ...props
-}: DataTableColumnHeaderProps<TData, TValue>): react_jsx_runtime3.JSX.Element;
+}: DataTableColumnHeaderProps<TData, TValue>): react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-faceted-filter.d.ts
 interface DataTableFacetedFilterProps<TData, TValue> {
@@ -1073,7 +1225,7 @@ declare function DataTableFacetedFilter<TData, TValue>({
   title,
   options,
   multiple
-}: DataTableFacetedFilterProps<TData, TValue>): react_jsx_runtime3.JSX.Element;
+}: DataTableFacetedFilterProps<TData, TValue>): react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-pagination.d.ts
 interface DataTablePaginationProps<TData> extends React.ComponentProps<"div"> {
@@ -1085,7 +1237,7 @@ declare function DataTablePagination<TData>({
   pageSizeOptions,
   className,
   ...props
-}: DataTablePaginationProps<TData>): react_jsx_runtime3.JSX.Element;
+}: DataTablePaginationProps<TData>): react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-toolbar.d.ts
 interface DataTableToolbarProps<TData> extends React$1.ComponentProps<"div"> {
@@ -1096,7 +1248,7 @@ declare function DataTableToolbar<TData>({
   children,
   className,
   ...props
-}: DataTableToolbarProps<TData>): react_jsx_runtime3.JSX.Element;
+}: DataTableToolbarProps<TData>): react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-view-options.d.ts
 interface DataTableViewOptionsProps<TData> extends React$1.ComponentProps<typeof PopoverContent> {
@@ -1107,7 +1259,7 @@ declare function DataTableViewOptions<TData>({
   table,
   disabled,
   ...props
-}: DataTableViewOptionsProps<TData>): react_jsx_runtime3.JSX.Element;
+}: DataTableViewOptionsProps<TData>): react_jsx_runtime0.JSX.Element;
 //#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">> {
@@ -1442,4 +1594,4 @@ declare function exportAllToCSV<T extends Record<string, unknown>>(data: T[], op
  */
 declare function downloadCSVTemplate(headers: string[], filename?: string): void;
 //#endregion
-export { type ActionsColumnConfig, AutoCrudTable, type AutoCrudTableProps, AutoForm, type AutoQueryParams, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, 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 FieldType, type Fields, type FilterConfig, FilterOperator, type FilterVariant, type FormSchemaOverrides, ImportDialog, type ImportDialogProps, type ImportResult, type JSONSchema, type JSONSchemaProperty, JoinOperator, type ListParams, type ListResult, Option, type ParsedImportData, type ParsedZodField, type Parser, QueryKeys, SchemaAdapter, type SimpleFieldConfig, type SimpleFieldsConfig, type ToastAdapter, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, type UseAutoCrudResourceParams, type UseAutoCrudResourceReturn, cn, coerceRowValues, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, dataToCSV, downloadCSVTemplate, exportAllToCSV, exportTableToCSV, formatDate, generateCSVTemplate, getUrlParams, humanize, noopToastAdapter, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseCSV, parseImportFile, parseJSON, parseZodField, setSearchParams, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates };
+export { type ActionItem, type ActionsColumnConfig, type AutoCrudLocale, AutoCrudTable, type AutoCrudTableProps, AutoForm, type AutoQueryParams, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, 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 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, Option, type ParsedImportData, type ParsedZodField, type Parser, QueryKeys, SchemaAdapter, type SimpleFieldConfig, type SimpleFieldsConfig, type ToastAdapter, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, type UseAutoCrudResourceParams, type UseAutoCrudResourceReturn, cn, coerceRowValues, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, dataToCSV, deDE, downloadCSVTemplate, enUS, esES, exportAllToCSV, exportTableToCSV, formatDate, frFR, generateCSVTemplate, getUrlParams, humanize, jaJP, koKR, noopToastAdapter, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseCSV, parseImportFile, parseJSON, parseZodField, resolveLocale, setSearchParams, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates, zhCN };