@wordrhyme/auto-crud 1.0.1 → 1.0.3

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 * 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_runtime0.JSX.Element;
+}: AutoTableActionBarProps<TData>): react_jsx_runtime3.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_runtime0.JSX.Element;
+}: AutoTableProps<T>): react_jsx_runtime3.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
 /**
@@ -539,6 +636,31 @@ interface Field {
   } | 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 接口
  */
@@ -590,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>>[];
   /**
    * 权限配置
    * 控制按钮显示和字段访问
@@ -617,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 组件
@@ -632,8 +763,10 @@ declare function AutoCrudTable<TSchema extends z.ZodObject<z.ZodRawShape>>({
   table: tableConfig,
   form: formConfig,
   slots,
-  permissions
-}: AutoCrudTableProps<TSchema>): react_jsx_runtime0.JSX.Element;
+  permissions,
+  actions: actionItems,
+  locale: localeProp
+}: 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>> {
@@ -665,7 +798,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>;
@@ -879,12 +1012,12 @@ declare const filterItemSchema: z.ZodObject<{
   variant: z.ZodEnum<{
     number: "number";
     boolean: "boolean";
-    text: "text";
-    range: "range";
     date: "date";
-    dateRange: "dateRange";
+    text: "text";
     select: "select";
     multiSelect: "multiSelect";
+    dateRange: "dateRange";
+    range: "range";
   }>;
   operator: z.ZodEnum<{
     iLike: "iLike";
@@ -963,7 +1096,7 @@ declare function AutoTableSimpleFilters<TData>({
   shallow,
   filters: externalFilters,
   onFiltersChange
-}: 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";
@@ -980,6 +1113,8 @@ interface CrudFormModalProps<T extends z.ZodObject<z.ZodRawShape>> {
   variant?: ModalVariant;
   overrides?: FormSchemaOverrides;
   title?: string;
+  locale?: AutoCrudLocale["formModal"];
+  gridColumns?: number;
   /** Label 对齐方式 */
   labelAlign?: "left" | "top" | "right";
   /** Label 宽度（labelAlign 为 left 时有效） */
@@ -996,9 +1131,11 @@ declare function CrudFormModal<T extends z.ZodObject<z.ZodRawShape>>({
   variant,
   overrides,
   title,
+  locale,
+  gridColumns,
   labelAlign,
   labelWidth
-}: 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 {
@@ -1008,16 +1145,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_runtime0.JSX.Element;
+  title,
+  locale
+}: ImportDialogProps): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/export-dialog.d.ts
 type ExportMode = "selected" | "filtered";
@@ -1037,7 +1177,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"> {
@@ -1050,7 +1190,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"> {
@@ -1061,7 +1201,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> {
@@ -1073,7 +1213,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> {
@@ -1087,7 +1227,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"> {
@@ -1099,7 +1239,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"> {
@@ -1110,7 +1250,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> {
@@ -1121,7 +1261,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/hooks/use-data-table.d.ts
 interface UseDataTableProps<TData> extends Omit<TableOptions<TData>, "state" | "pageCount" | "getCoreRowModel" | "manualFiltering" | "manualPagination" | "manualSorting">, Required<Pick<TableOptions<TData>, "pageCount">> {
@@ -1456,4 +1596,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 };