@wordrhyme/auto-crud 1.0.0 → 1.0.2

package/dist/index.js

@@ -1408,7 +1408,12 @@ function DataTableFilterList({ table, debounceMs = DEBOUNCE_MS$2, throttleMs = T
 	const [open, setOpen] = React.useState(false);
 	const addButtonRef = React.useRef(null);
 	const columns = React.useMemo(() => {
-		return table.getAllColumns().filter((column) => column.columnDef.enableColumnFilter);
+		return table.getAllColumns().filter((column) => {
+			if (!column.getCanFilter()) return false;
+			const modes = column.columnDef.meta?.modes;
+			if (modes && !modes.includes("advanced")) return false;
+			return true;
+		});
 	}, [table]);
 	const [filters, setFilters] = useReadableFilters(columns, { debounceMs });
 	const debouncedSetFilters = useDebouncedCallback(setFilters, debounceMs);
@@ -1890,7 +1895,12 @@ const REMOVE_FILTER_SHORTCUTS = ["backspace", "delete"];
 function DataTableFilterMenu({ table, debounceMs = DEBOUNCE_MS$1, throttleMs = THROTTLE_MS$1, shallow = true, disabled,...props }) {
 	const id = React.useId();
 	const columns = React.useMemo(() => {
-		return table.getAllColumns().filter((column) => column.columnDef.enableColumnFilter);
+		return table.getAllColumns().filter((column) => {
+			if (!column.columnDef.enableColumnFilter) return false;
+			const modes = column.columnDef.meta?.modes;
+			if (modes && !modes.includes("command")) return false;
+			return true;
+		});
 	}, [table]);
 	const [open, setOpen] = React.useState(false);
 	const [selectedColumn, setSelectedColumn] = React.useState(null);
@@ -2647,7 +2657,7 @@ function DataTableViewOptions({ table, disabled,...props }) {
 //#endregion
 //#region src/components/auto-crud/auto-table-simple-filters.tsx
 function AutoTableSimpleFilters({ table, shallow = false, filters: externalFilters, onFiltersChange }) {
-	const columns = React.useMemo(() => table.getAllColumns().filter((col) => col.columnDef.enableColumnFilter), [table]);
+	const columns = React.useMemo(() => table.getAllColumns().filter((col) => col.getCanFilter()), [table]);
 	const queryStateOptions = table.options.meta?.queryStateOptions;
 	const [queryFilters, setQueryFilters] = useReadableFilters(columns, {
 		...queryStateOptions,
@@ -2667,9 +2677,10 @@ function AutoTableSimpleFilters({ table, shallow = false, filters: externalFilte
 	React.useEffect(() => {
 		setMounted(true);
 	}, []);
-	const getFilterValue = (columnId) => {
-		return filters.find((f) => f.id === columnId)?.value;
-	};
+	const filterMap = React.useMemo(() => new Map(filters.map((f) => [f.id, f])), [filters]);
+	const getFilterValue = React.useCallback((columnId) => {
+		return filterMap.get(columnId)?.value;
+	}, [filterMap]);
 	const updateFilter = React.useCallback((columnId, value) => {
 		const column = columns.find((c) => c.id === columnId);
 		if (!column) return;
@@ -2692,7 +2703,14 @@ function AutoTableSimpleFilters({ table, shallow = false, filters: externalFilte
 		setFilters
 	]);
 	const hasFilters = filters.length > 0;
-	const filterColumns = React.useMemo(() => columns.filter((col) => col.columnDef.meta?.variant && col.columnDef.enableColumnFilter !== false), [columns]);
+	const filterColumns = React.useMemo(() => columns.filter((col) => {
+		const meta = col.columnDef.meta;
+		const enableFilter = col.columnDef.enableColumnFilter !== false;
+		if (!meta?.variant || !enableFilter) return false;
+		const modes = meta.modes;
+		if (modes && !modes.includes("simple")) return false;
+		return true;
+	}), [columns]);
 	const [expanded, setExpanded] = React.useState(false);
 	const [visibleCount, setVisibleCount] = React.useState(null);
 	const containerRef = React.useRef(null);
@@ -2832,7 +2850,7 @@ function AutoTableSimpleFilters({ table, shallow = false, filters: externalFilte
 }
 function SimpleFacetedFilter({ title, options, multiple, value, onChange }) {
 	const [open, setOpen] = React.useState(false);
-	const selectedValues = new Set(value);
+	const selectedValues = React.useMemo(() => new Set(value), [value]);
 	const onItemSelect = (option, isSelected) => {
 		if (multiple) {
 			const newValues = new Set(selectedValues);
@@ -2863,6 +2881,12 @@ function SimpleFacetedFilter({ title, options, multiple, value, onChange }) {
 						tabIndex: 0,
 						className: "rounded-sm opacity-70 hover:opacity-100",
 						onClick: onReset,
+						onKeyDown: (e) => {
+							if (e.key === "Enter" || e.key === " ") {
+								e.preventDefault();
+								onReset(e);
+							}
+						},
 						children: /* @__PURE__ */ jsx(XCircle, {})
 					}) : /* @__PURE__ */ jsx(PlusCircle, {}),
 					title,
@@ -2970,6 +2994,12 @@ function SimpleSliderFilter({ title, range, unit, value, onChange }) {
 					tabIndex: 0,
 					className: "rounded-sm opacity-70 hover:opacity-100",
 					onClick: onReset,
+					onKeyDown: (e) => {
+						if (e.key === "Enter" || e.key === " ") {
+							e.preventDefault();
+							onReset(e);
+						}
+					},
 					children: /* @__PURE__ */ jsx(XCircle, {})
 				}) : /* @__PURE__ */ jsx(PlusCircle, {}),
 				/* @__PURE__ */ jsx("span", { children: title }),
@@ -3093,6 +3123,12 @@ function SimpleDateFilter({ title, multiple, value, onChange }) {
 					tabIndex: 0,
 					className: "rounded-sm opacity-70 hover:opacity-100",
 					onClick: onReset,
+					onKeyDown: (e) => {
+						if (e.key === "Enter" || e.key === " ") {
+							e.preventDefault();
+							onReset(e);
+						}
+					},
 					children: /* @__PURE__ */ jsx(XCircle, {})
 				}) : /* @__PURE__ */ jsx(CalendarIcon, {}),
 				/* @__PURE__ */ jsx("span", { children: title }),
@@ -3705,33 +3741,47 @@ function inferFilterVariantByFieldName(fieldName) {
 
 //#endregion
 //#region src/lib/schema-bridge/zod-to-columns.tsx
+const parsedFieldCache = /* @__PURE__ */ new WeakMap();
+const baseTableSchemaCache = /* @__PURE__ */ new WeakMap();
 /**
 * 解析 Zod 字段类型
 */
 function parseZodField(schema) {
+	const cached = parsedFieldCache.get(schema);
+	if (cached) return cached;
+	const finalize = (result) => {
+		parsedFieldCache.set(schema, result);
+		return result;
+	};
 	const def = schema._zod?.def ?? schema._def;
-	const testNull = schema.safeParse(null);
-	const required = !schema.safeParse(void 0).success && !testNull.success;
 	const typeName = def?.typeName;
-	if (def?.type === "nullable" || def?.type === "optional" || typeName === "ZodNullable" || typeName === "ZodOptional") {
+	const isOptional = def?.type === "optional" || typeName === "ZodOptional";
+	const isNullable = def?.type === "nullable" || typeName === "ZodNullable";
+	if (isOptional || isNullable) {
 		const innerType = def?.innerType;
-		if (innerType) return {
+		if (innerType) return finalize({
 			...parseZodField(innerType),
 			required: false
-		};
+		});
 	}
-	if (def?.type === "boolean") return {
+	let required;
+	if (isOptional || isNullable) required = false;
+	else {
+		const testNull = schema.safeParse(null);
+		required = !schema.safeParse(void 0).success && !testNull.success;
+	}
+	if (def?.type === "boolean") return finalize({
 		type: "boolean",
 		required
-	};
-	if (def?.type === "number") return {
+	});
+	if (def?.type === "number") return finalize({
 		type: "number",
 		required
-	};
-	if (def?.type === "date") return {
+	});
+	if (def?.type === "date") return finalize({
 		type: "date",
 		required
-	};
+	});
 	if (def?.type === "enum") {
 		let enumValues$1;
 		if (def?.entries) {
@@ -3742,20 +3792,20 @@ function parseZodField(schema) {
 			const values = def.values;
 			if (Array.isArray(values)) enumValues$1 = values.map(String);
 		}
-		if (enumValues$1 && enumValues$1.length > 0) return {
+		if (enumValues$1 && enumValues$1.length > 0) return finalize({
 			type: "enum",
 			required,
 			enumValues: enumValues$1
-		};
+		});
 	}
-	if (def?.type === "string") return {
+	if (def?.type === "string") return finalize({
 		type: "string",
 		required
-	};
-	if (typeName === "ZodBoolean") return {
+	});
+	if (typeName === "ZodBoolean") return finalize({
 		type: "boolean",
 		required
-	};
+	});
 	let enumValues;
 	if (def?.entries) {
 		const entries = def.entries;
@@ -3765,51 +3815,51 @@ function parseZodField(schema) {
 		const values = def.values;
 		if (Array.isArray(values)) enumValues = values.map(String);
 	}
-	if (enumValues && Array.isArray(enumValues) && enumValues.length > 0) return {
+	if (enumValues && Array.isArray(enumValues) && enumValues.length > 0) return finalize({
 		type: "enum",
 		required,
 		enumValues
-	};
-	if (typeName === "ZodNumber") return {
+	});
+	if (typeName === "ZodNumber") return finalize({
 		type: "number",
 		required
-	};
-	if (typeName === "ZodDate") return {
+	});
+	if (typeName === "ZodDate") return finalize({
 		type: "date",
 		required
-	};
-	if (typeName === "ZodArray") return {
+	});
+	if (typeName === "ZodArray") return finalize({
 		type: "array",
 		required
-	};
-	if (typeName === "ZodObject") return {
+	});
+	if (typeName === "ZodObject") return finalize({
 		type: "object",
 		required
-	};
+	});
 	const testString = schema.safeParse("test");
 	const testNumber = schema.safeParse(123);
 	const testBoolean = schema.safeParse(true);
 	const testDate = schema.safeParse(17040672e5);
-	if (testBoolean.success && !testString.success && !testNumber.success) return {
+	if (testBoolean.success && !testString.success && !testNumber.success) return finalize({
 		type: "boolean",
 		required
-	};
-	if (testDate.success && !testString.success) return {
+	});
+	if (testDate.success && !testString.success) return finalize({
 		type: "date",
 		required
-	};
-	if (testNumber.success && !testString.success) return {
+	});
+	if (testNumber.success && !testString.success) return finalize({
 		type: "number",
 		required
-	};
-	if (schema.safeParse([]).success && !testString.success) return {
+	});
+	if (schema.safeParse([]).success && !testString.success) return finalize({
 		type: "array",
 		required
-	};
-	return {
+	});
+	return finalize({
 		type: "string",
 		required
-	};
+	});
 }
 /**
 * 渲染单元格内容
@@ -3851,9 +3901,14 @@ function renderCell(value, type) {
 * 从 Zod Schema 创建 Table Schema (ColumnDef 数组)
 */
 function createTableSchema(schema, options) {
+	const { overrides, exclude = [] } = options ?? {};
+	const canCache = !(!!overrides && Object.keys(overrides).length > 0) && exclude.length === 0;
+	if (canCache) {
+		const cached = baseTableSchemaCache.get(schema);
+		if (cached) return [...cached];
+	}
 	const shape = schema.shape;
 	const columns = [];
-	const { overrides, exclude = [] } = options ?? {};
 	for (const [key, fieldSchema] of Object.entries(shape)) {
 		if (exclude.includes(key)) continue;
 		const override = overrides?.[key];
@@ -3888,6 +3943,7 @@ function createTableSchema(schema, options) {
 			...restOverride
 		});
 	}
+	if (canCache) baseTableSchemaCache.set(schema, columns);
 	return columns;
 }
 /**
@@ -3916,8 +3972,7 @@ function createSelectColumn() {
 /**
 * 创建操作列
 */
-function createActionsColumn(config) {
-	const { onEdit, onDelete, onView, onCopy } = config;
+function createActionsColumn(items) {
 	return {
 		id: "actions",
 		cell: ({ row }) => /* @__PURE__ */ jsxs(DropdownMenu, { children: [/* @__PURE__ */ jsx(DropdownMenuTrigger, {
@@ -3928,29 +3983,14 @@ function createActionsColumn(config) {
 				className: "flex size-8 p-0 data-[state=open]:bg-muted",
 				children: /* @__PURE__ */ jsx(Ellipsis, { className: "size-4" })
 			})
-		}), /* @__PURE__ */ jsxs(DropdownMenuContent, {
+		}), /* @__PURE__ */ jsx(DropdownMenuContent, {
 			align: "end",
 			className: "w-40",
-			children: [
-				onView && /* @__PURE__ */ jsx(DropdownMenuItem, {
-					onClick: () => onView(row.original),
-					children: "查看"
-				}),
-				onEdit && /* @__PURE__ */ jsx(DropdownMenuItem, {
-					onClick: () => onEdit(row.original),
-					children: "编辑"
-				}),
-				onCopy && /* @__PURE__ */ jsx(DropdownMenuItem, {
-					onClick: () => onCopy(row.original),
-					children: "复制"
-				}),
-				(onView || onEdit || onCopy) && onDelete && /* @__PURE__ */ jsx(DropdownMenuSeparator, {}),
-				onDelete && /* @__PURE__ */ jsx(DropdownMenuItem, {
-					className: "text-destructive",
-					onClick: () => onDelete(row.original),
-					children: "删除"
-				})
-			]
+			children: items.map((item, i) => /* @__PURE__ */ jsxs(React.Fragment, { children: [item.separator && /* @__PURE__ */ jsx(DropdownMenuSeparator, {}), /* @__PURE__ */ jsx(DropdownMenuItem, {
+				className: item.variant === "destructive" ? "text-destructive" : "",
+				onClick: () => item.onClick(row.original),
+				children: item.label
+			})] }, i))
 		})] }),
 		size: 40
 	};
@@ -4404,6 +4444,13 @@ function useDataTable(props) {
 		filterableColumns,
 		enableAdvancedFilter
 	]);
+	const getCoreRowModelFn = React.useMemo(() => getCoreRowModel(), []);
+	const getFilteredRowModelFn = React.useMemo(() => getFilteredRowModel(), []);
+	const getPaginationRowModelFn = React.useMemo(() => getPaginationRowModel(), []);
+	const getSortedRowModelFn = React.useMemo(() => getSortedRowModel(), []);
+	const getFacetedRowModelFn = React.useMemo(() => getFacetedRowModel(), []);
+	const getFacetedUniqueValuesFn = React.useMemo(() => getFacetedUniqueValues(), []);
+	const getFacetedMinMaxValuesFn = React.useMemo(() => getFacetedMinMaxValues(), []);
 	const table = useReactTable({
 		...tableProps,
 		columns,
@@ -4426,13 +4473,13 @@ function useDataTable(props) {
 		onSortingChange,
 		onColumnFiltersChange,
 		onColumnVisibilityChange: setColumnVisibility,
-		getCoreRowModel: getCoreRowModel(),
-		getFilteredRowModel: getFilteredRowModel(),
-		getPaginationRowModel: getPaginationRowModel(),
-		getSortedRowModel: getSortedRowModel(),
-		getFacetedRowModel: getFacetedRowModel(),
-		getFacetedUniqueValues: getFacetedUniqueValues(),
-		getFacetedMinMaxValues: getFacetedMinMaxValues(),
+		getCoreRowModel: getCoreRowModelFn,
+		getFilteredRowModel: getFilteredRowModelFn,
+		getPaginationRowModel: getPaginationRowModelFn,
+		getSortedRowModel: getSortedRowModelFn,
+		getFacetedRowModel: getFacetedRowModelFn,
+		getFacetedUniqueValues: getFacetedUniqueValuesFn,
+		getFacetedMinMaxValues: getFacetedMinMaxValuesFn,
 		manualPagination: true,
 		manualSorting: true,
 		manualFiltering: true,
@@ -4463,6 +4510,11 @@ function useDataTable(props) {
 
 //#endregion
 //#region src/components/auto-crud/auto-table.tsx
+const DEFAULT_MODES = [
+	"simple",
+	"advanced",
+	"command"
+];
 /** 过滤模式配置 */
 const filterModeConfig = {
 	simple: {
@@ -4482,11 +4534,7 @@ const filterModeConfig = {
 	}
 };
 function AutoTable({ schema, data, pageCount = 1, overrides, enableRowSelection = true, exclude, actions, pinnedColumns, filterMode = "simple", onDeleteSelected, onUpdateSelected, batchUpdateFields, actionBarExtra, initialSorting, enableExport = true, onSelectedCountChange, getSelectedRows }) {
-	const modes = filterMode ? Array.isArray(filterMode) ? filterMode : [filterMode] : [
-		"simple",
-		"advanced",
-		"command"
-	];
+	const modes = filterMode ? Array.isArray(filterMode) ? filterMode : [filterMode] : DEFAULT_MODES;
 	const [currentMode, setCurrentMode] = useQueryState("filterMode", parseAsStringEnum(modes).withDefault(modes[0] ?? "simple"));
 	const showToggle = modes.length > 1;
 	const { table, shallow, debounceMs, throttleMs } = useDataTable({
@@ -4508,13 +4556,18 @@ function AutoTable({ schema, data, pageCount = 1, overrides, enableRowSelection
 		]),
 		pageCount,
 		enableAdvancedFilter: true,
-		initialState: {
+		initialState: useMemo(() => ({
 			sorting: initialSorting,
 			columnPinning: pinnedColumns ?? {
 				left: enableRowSelection ? ["select"] : [],
 				right: actions ? ["actions"] : []
 			}
-		},
+		}), [
+			initialSorting,
+			pinnedColumns,
+			enableRowSelection,
+			actions
+		]),
 		shallow: false,
 		clearOnDefault: true
 	});
@@ -4555,7 +4608,7 @@ function AutoTable({ schema, data, pageCount = 1, overrides, enableRowSelection
 			})
 		})
 	})] }) : null;
-	const renderFilters = () => {
+	const filtersContent = useMemo(() => {
 		switch (currentMode) {
 			case "simple": return /* @__PURE__ */ jsx(AutoTableSimpleFilters, {
 				table,
@@ -4575,7 +4628,13 @@ function AutoTable({ schema, data, pageCount = 1, overrides, enableRowSelection
 				align: "start"
 			});
 		}
-	};
+	}, [
+		currentMode,
+		table,
+		shallow,
+		debounceMs,
+		throttleMs
+	]);
 	return /* @__PURE__ */ jsxs("div", {
 		className: "space-y-4",
 		children: [
@@ -4587,7 +4646,7 @@ function AutoTable({ schema, data, pageCount = 1, overrides, enableRowSelection
 					children: [currentMode !== "simple" && /* @__PURE__ */ jsx(DataTableSortList, {
 						table,
 						align: "start"
-					}), renderFilters()]
+					}), filtersContent]
 				}), /* @__PURE__ */ jsxs("div", {
 					className: "flex items-center gap-2",
 					children: [
@@ -4819,10 +4878,462 @@ function AutoFormInner({ schema: zodSchema, initialValues, onSubmit, overrides,
 }
 const AutoForm = forwardRef(AutoFormInner);
 
+//#endregion
+//#region src/i18n/locale.ts
+const zhCN = {
+	toolbar: {
+		create: "新建",
+		import: "导入",
+		export: "导出",
+		exportSelected: (count) => `导出(${count})`
+	},
+	rowActions: {
+		view: "查看",
+		edit: "编辑",
+		copy: "复制",
+		delete: "删除"
+	},
+	viewModal: { title: "详情" },
+	boolean: {
+		true: "是",
+		false: "否"
+	},
+	formModal: {
+		createTitle: "新建",
+		editTitle: "编辑",
+		cancel: "取消",
+		create: "创建",
+		save: "保存",
+		submitting: "处理中..."
+	},
+	deleteModal: {
+		title: "确认删除",
+		description: "此操作无法撤销。确定要删除这条记录吗？",
+		cancel: "取消",
+		confirm: "确认删除",
+		confirming: "删除中..."
+	},
+	importDialog: {
+		title: "导入数据",
+		uploadDescription: "上传 CSV 或 JSON 文件以批量导入数据",
+		previewDescription: (count) => `已解析 ${count} 条数据，确认后开始导入`,
+		importingDescription: "正在导入数据...",
+		doneDescription: "导入完成",
+		dragHint: "拖拽文件到此处，或点击选择文件",
+		formatHint: "支持 CSV、JSON 格式",
+		downloadTemplate: "下载 CSV 模板",
+		moreColumns: (count) => `+${count} 列`,
+		previewSummary: (rows, fields, format, previewLimit) => `共 ${rows} 条数据${previewLimit ? `（预览前 ${previewLimit} 条）` : ""}，${fields} 个字段，格式: ${format.toUpperCase()}`,
+		reselect: "重新选择",
+		confirmImport: "确认导入",
+		importingRows: (count) => `正在导入 ${count} 条数据...`,
+		resultCreated: "新建",
+		resultUpdated: "更新",
+		resultSkipped: "跳过",
+		resultFailed: "验证失败",
+		failedRowHeader: "行号",
+		failedErrorHeader: "错误",
+		close: "关闭",
+		continueImport: "继续导入",
+		errorNoData: "文件中没有数据行",
+		errorParseFailed: "文件解析失败",
+		errorImportFailed: "导入失败"
+	}
+};
+const enUS = {
+	toolbar: {
+		create: "New",
+		import: "Import",
+		export: "Export",
+		exportSelected: (count) => `Export (${count})`
+	},
+	rowActions: {
+		view: "View",
+		edit: "Edit",
+		copy: "Copy",
+		delete: "Delete"
+	},
+	viewModal: { title: "Details" },
+	boolean: {
+		true: "Yes",
+		false: "No"
+	},
+	formModal: {
+		createTitle: "New",
+		editTitle: "Edit",
+		cancel: "Cancel",
+		create: "Create",
+		save: "Save",
+		submitting: "Processing..."
+	},
+	deleteModal: {
+		title: "Confirm Delete",
+		description: "This action cannot be undone. Are you sure you want to delete this record?",
+		cancel: "Cancel",
+		confirm: "Delete",
+		confirming: "Deleting..."
+	},
+	importDialog: {
+		title: "Import Data",
+		uploadDescription: "Upload a CSV or JSON file to bulk import data",
+		previewDescription: (count) => `Parsed ${count} records, confirm to start importing`,
+		importingDescription: "Importing data...",
+		doneDescription: "Import complete",
+		dragHint: "Drag file here, or click to select",
+		formatHint: "Supports CSV, JSON formats",
+		downloadTemplate: "Download CSV Template",
+		moreColumns: (count) => `+${count} more`,
+		previewSummary: (rows, fields, format, previewLimit) => `${rows} records${previewLimit ? ` (preview first ${previewLimit})` : ""}, ${fields} fields, format: ${format.toUpperCase()}`,
+		reselect: "Reselect",
+		confirmImport: "Confirm Import",
+		importingRows: (count) => `Importing ${count} records...`,
+		resultCreated: "Created",
+		resultUpdated: "Updated",
+		resultSkipped: "Skipped",
+		resultFailed: "Failed",
+		failedRowHeader: "Row",
+		failedErrorHeader: "Error",
+		close: "Close",
+		continueImport: "Import More",
+		errorNoData: "No data rows found in file",
+		errorParseFailed: "Failed to parse file",
+		errorImportFailed: "Import failed"
+	}
+};
+const jaJP = {
+	toolbar: {
+		create: "新規作成",
+		import: "インポート",
+		export: "エクスポート",
+		exportSelected: (count) => `エクスポート(${count})`
+	},
+	rowActions: {
+		view: "詳細",
+		edit: "編集",
+		copy: "コピー",
+		delete: "削除"
+	},
+	viewModal: { title: "詳細" },
+	boolean: {
+		true: "はい",
+		false: "いいえ"
+	},
+	formModal: {
+		createTitle: "新規作成",
+		editTitle: "編集",
+		cancel: "キャンセル",
+		create: "作成",
+		save: "保存",
+		submitting: "処理中..."
+	},
+	deleteModal: {
+		title: "削除の確認",
+		description: "この操作は元に戻せません。このレコードを削除してもよろしいですか？",
+		cancel: "キャンセル",
+		confirm: "削除する",
+		confirming: "削除中..."
+	},
+	importDialog: {
+		title: "データのインポート",
+		uploadDescription: "CSVまたはJSONファイルをアップロードして一括インポート",
+		previewDescription: (count) => `${count}件のデータを解析しました。確認してインポートを開始します`,
+		importingDescription: "データをインポート中...",
+		doneDescription: "インポート完了",
+		dragHint: "ファイルをここにドラッグするか、クリックして選択",
+		formatHint: "CSV・JSON形式に対応",
+		downloadTemplate: "CSVテンプレートをダウンロード",
+		moreColumns: (count) => `+${count}列`,
+		previewSummary: (rows, fields, format, previewLimit) => `${rows}件${previewLimit ? `（上位${previewLimit}件プレビュー）` : ""}、${fields}フィールド、形式: ${format.toUpperCase()}`,
+		reselect: "再選択",
+		confirmImport: "インポートを確認",
+		importingRows: (count) => `${count}件をインポート中...`,
+		resultCreated: "新規作成",
+		resultUpdated: "更新",
+		resultSkipped: "スキップ",
+		resultFailed: "失敗",
+		failedRowHeader: "行番号",
+		failedErrorHeader: "エラー",
+		close: "閉じる",
+		continueImport: "続けてインポート",
+		errorNoData: "ファイルにデータ行がありません",
+		errorParseFailed: "ファイルの解析に失敗しました",
+		errorImportFailed: "インポートに失敗しました"
+	}
+};
+const koKR = {
+	toolbar: {
+		create: "새로 만들기",
+		import: "가져오기",
+		export: "내보내기",
+		exportSelected: (count) => `내보내기(${count})`
+	},
+	rowActions: {
+		view: "보기",
+		edit: "편집",
+		copy: "복사",
+		delete: "삭제"
+	},
+	viewModal: { title: "상세 정보" },
+	boolean: {
+		true: "예",
+		false: "아니요"
+	},
+	formModal: {
+		createTitle: "새로 만들기",
+		editTitle: "편집",
+		cancel: "취소",
+		create: "만들기",
+		save: "저장",
+		submitting: "처리 중..."
+	},
+	deleteModal: {
+		title: "삭제 확인",
+		description: "이 작업은 취소할 수 없습니다. 이 레코드를 삭제하시겠습니까?",
+		cancel: "취소",
+		confirm: "삭제",
+		confirming: "삭제 중..."
+	},
+	importDialog: {
+		title: "데이터 가져오기",
+		uploadDescription: "CSV 또는 JSON 파일을 업로드하여 일괄 가져오기",
+		previewDescription: (count) => `${count}개의 데이터를 분석했습니다. 확인 후 가져오기를 시작합니다`,
+		importingDescription: "데이터를 가져오는 중...",
+		doneDescription: "가져오기 완료",
+		dragHint: "파일을 여기에 드래그하거나 클릭하여 선택",
+		formatHint: "CSV, JSON 형식 지원",
+		downloadTemplate: "CSV 템플릿 다운로드",
+		moreColumns: (count) => `+${count}열 더`,
+		previewSummary: (rows, fields, format, previewLimit) => `${rows}개 레코드${previewLimit ? ` (상위 ${previewLimit}개 미리보기)` : ""}, ${fields}개 필드, 형식: ${format.toUpperCase()}`,
+		reselect: "다시 선택",
+		confirmImport: "가져오기 확인",
+		importingRows: (count) => `${count}개의 레코드를 가져오는 중...`,
+		resultCreated: "생성됨",
+		resultUpdated: "업데이트됨",
+		resultSkipped: "건너뜀",
+		resultFailed: "실패",
+		failedRowHeader: "행 번호",
+		failedErrorHeader: "오류",
+		close: "닫기",
+		continueImport: "계속 가져오기",
+		errorNoData: "파일에 데이터 행이 없습니다",
+		errorParseFailed: "파일 파싱에 실패했습니다",
+		errorImportFailed: "가져오기에 실패했습니다"
+	}
+};
+const frFR = {
+	toolbar: {
+		create: "Nouveau",
+		import: "Importer",
+		export: "Exporter",
+		exportSelected: (count) => `Exporter (${count})`
+	},
+	rowActions: {
+		view: "Voir",
+		edit: "Modifier",
+		copy: "Copier",
+		delete: "Supprimer"
+	},
+	viewModal: { title: "Détails" },
+	boolean: {
+		true: "Oui",
+		false: "Non"
+	},
+	formModal: {
+		createTitle: "Nouveau",
+		editTitle: "Modifier",
+		cancel: "Annuler",
+		create: "Créer",
+		save: "Enregistrer",
+		submitting: "En cours..."
+	},
+	deleteModal: {
+		title: "Confirmer la suppression",
+		description: "Cette action est irréversible. Voulez-vous vraiment supprimer cet enregistrement ?",
+		cancel: "Annuler",
+		confirm: "Supprimer",
+		confirming: "Suppression..."
+	},
+	importDialog: {
+		title: "Importer des données",
+		uploadDescription: "Téléchargez un fichier CSV ou JSON pour importer en masse",
+		previewDescription: (count) => `${count} enregistrements analysés, confirmez pour démarrer l'import`,
+		importingDescription: "Importation en cours...",
+		doneDescription: "Import terminé",
+		dragHint: "Glissez un fichier ici ou cliquez pour sélectionner",
+		formatHint: "Formats CSV et JSON acceptés",
+		downloadTemplate: "Télécharger le modèle CSV",
+		moreColumns: (count) => `+${count} colonnes`,
+		previewSummary: (rows, fields, format, previewLimit) => `${rows} enregistrements${previewLimit ? ` (aperçu des ${previewLimit} premiers)` : ""}, ${fields} champs, format : ${format.toUpperCase()}`,
+		reselect: "Resélectionner",
+		confirmImport: "Confirmer l'import",
+		importingRows: (count) => `Importation de ${count} enregistrements...`,
+		resultCreated: "Créés",
+		resultUpdated: "Mis à jour",
+		resultSkipped: "Ignorés",
+		resultFailed: "Échoués",
+		failedRowHeader: "Ligne",
+		failedErrorHeader: "Erreur",
+		close: "Fermer",
+		continueImport: "Continuer l'import",
+		errorNoData: "Aucune ligne de données dans le fichier",
+		errorParseFailed: "Échec de l'analyse du fichier",
+		errorImportFailed: "Échec de l'importation"
+	}
+};
+const deDE = {
+	toolbar: {
+		create: "Neu",
+		import: "Importieren",
+		export: "Exportieren",
+		exportSelected: (count) => `Exportieren (${count})`
+	},
+	rowActions: {
+		view: "Anzeigen",
+		edit: "Bearbeiten",
+		copy: "Kopieren",
+		delete: "Löschen"
+	},
+	viewModal: { title: "Details" },
+	boolean: {
+		true: "Ja",
+		false: "Nein"
+	},
+	formModal: {
+		createTitle: "Neu",
+		editTitle: "Bearbeiten",
+		cancel: "Abbrechen",
+		create: "Erstellen",
+		save: "Speichern",
+		submitting: "Wird verarbeitet..."
+	},
+	deleteModal: {
+		title: "Löschen bestätigen",
+		description: "Diese Aktion kann nicht rückgängig gemacht werden. Möchten Sie diesen Datensatz wirklich löschen?",
+		cancel: "Abbrechen",
+		confirm: "Löschen",
+		confirming: "Wird gelöscht..."
+	},
+	importDialog: {
+		title: "Daten importieren",
+		uploadDescription: "CSV- oder JSON-Datei hochladen, um Daten massenweise zu importieren",
+		previewDescription: (count) => `${count} Datensätze analysiert, bestätigen Sie den Import`,
+		importingDescription: "Daten werden importiert...",
+		doneDescription: "Import abgeschlossen",
+		dragHint: "Datei hierher ziehen oder klicken zum Auswählen",
+		formatHint: "CSV- und JSON-Formate werden unterstützt",
+		downloadTemplate: "CSV-Vorlage herunterladen",
+		moreColumns: (count) => `+${count} Spalten`,
+		previewSummary: (rows, fields, format, previewLimit) => `${rows} Datensätze${previewLimit ? ` (Vorschau der ersten ${previewLimit})` : ""}, ${fields} Felder, Format: ${format.toUpperCase()}`,
+		reselect: "Neu auswählen",
+		confirmImport: "Import bestätigen",
+		importingRows: (count) => `${count} Datensätze werden importiert...`,
+		resultCreated: "Erstellt",
+		resultUpdated: "Aktualisiert",
+		resultSkipped: "Übersprungen",
+		resultFailed: "Fehlgeschlagen",
+		failedRowHeader: "Zeile",
+		failedErrorHeader: "Fehler",
+		close: "Schließen",
+		continueImport: "Weiteren Import starten",
+		errorNoData: "Keine Datenzeilen in der Datei",
+		errorParseFailed: "Datei konnte nicht analysiert werden",
+		errorImportFailed: "Import fehlgeschlagen"
+	}
+};
+const esES = {
+	toolbar: {
+		create: "Nuevo",
+		import: "Importar",
+		export: "Exportar",
+		exportSelected: (count) => `Exportar (${count})`
+	},
+	rowActions: {
+		view: "Ver",
+		edit: "Editar",
+		copy: "Copiar",
+		delete: "Eliminar"
+	},
+	viewModal: { title: "Detalles" },
+	boolean: {
+		true: "Sí",
+		false: "No"
+	},
+	formModal: {
+		createTitle: "Nuevo",
+		editTitle: "Editar",
+		cancel: "Cancelar",
+		create: "Crear",
+		save: "Guardar",
+		submitting: "Procesando..."
+	},
+	deleteModal: {
+		title: "Confirmar eliminación",
+		description: "Esta acción no se puede deshacer. ¿Está seguro de que desea eliminar este registro?",
+		cancel: "Cancelar",
+		confirm: "Eliminar",
+		confirming: "Eliminando..."
+	},
+	importDialog: {
+		title: "Importar datos",
+		uploadDescription: "Suba un archivo CSV o JSON para importar datos de forma masiva",
+		previewDescription: (count) => `Se analizaron ${count} registros, confirme para iniciar la importación`,
+		importingDescription: "Importando datos...",
+		doneDescription: "Importación completada",
+		dragHint: "Arrastre el archivo aquí o haga clic para seleccionar",
+		formatHint: "Formatos CSV y JSON compatibles",
+		downloadTemplate: "Descargar plantilla CSV",
+		moreColumns: (count) => `+${count} columnas`,
+		previewSummary: (rows, fields, format, previewLimit) => `${rows} registros${previewLimit ? ` (vista previa de los primeros ${previewLimit})` : ""}, ${fields} campos, formato: ${format.toUpperCase()}`,
+		reselect: "Volver a seleccionar",
+		confirmImport: "Confirmar importación",
+		importingRows: (count) => `Importando ${count} registros...`,
+		resultCreated: "Creados",
+		resultUpdated: "Actualizados",
+		resultSkipped: "Omitidos",
+		resultFailed: "Fallidos",
+		failedRowHeader: "Fila",
+		failedErrorHeader: "Error",
+		close: "Cerrar",
+		continueImport: "Continuar importando",
+		errorNoData: "No se encontraron filas de datos en el archivo",
+		errorParseFailed: "Error al analizar el archivo",
+		errorImportFailed: "Error en la importación"
+	}
+};
+const BUILTIN_LOCALES = {
+	"zh-CN": zhCN,
+	"en-US": enUS,
+	"ja-JP": jaJP,
+	"ko-KR": koKR,
+	"fr-FR": frFR,
+	"de-DE": deDE,
+	"es-ES": esES
+};
+function deepMerge(target, source) {
+	const result = { ...target };
+	for (const key of Object.keys(source)) {
+		const sv = source[key];
+		const tv = target[key];
+		if (sv !== void 0 && sv !== null && typeof sv === "object" && !Array.isArray(sv) && typeof tv === "object" && tv !== null && !Array.isArray(tv)) result[key] = deepMerge(tv, sv);
+		else if (sv !== void 0) result[key] = sv;
+	}
+	return result;
+}
+/**
+* 解析 locale prop 为完整的 AutoCrudLocale
+* - string → 内置语言（fallback: zh-CN）
+* - object → 以 zh-CN 为基础深合并
+*/
+function resolveLocale(localeProp) {
+	if (!localeProp) return zhCN;
+	if (typeof localeProp === "string") return BUILTIN_LOCALES[localeProp] ?? zhCN;
+	return deepMerge(zhCN, localeProp);
+}
+
 //#endregion
 //#region src/components/auto-crud/crud-form-modal.tsx
-function CrudFormModal({ open, onOpenChange, mode, schema, initialValues, onSubmit, loading = false, variant = "dialog", overrides, title, labelAlign, labelWidth }) {
-	const defaultTitle = mode === "create" ? "新建" : "编辑";
+function CrudFormModal({ open, onOpenChange, mode, schema, initialValues, onSubmit, loading = false, variant = "dialog", overrides, title, locale = zhCN.formModal, labelAlign, labelWidth }) {
+	const defaultTitle = mode === "create" ? locale.createTitle : locale.editTitle;
 	const formRef = useRef(null);
 	const handleSubmit = async () => {
 		await formRef.current?.submit();
@@ -4838,12 +5349,12 @@ function CrudFormModal({ open, onOpenChange, mode, schema, initialValues, onSubm
 				type: "button",
 				variant: "outline",
 				onClick: () => onOpenChange(false),
-				children: "取消"
+				children: locale.cancel
 			}), /* @__PURE__ */ jsx(Button, {
 				type: "button",
 				onClick: handleSubmit,
 				disabled: loading,
-				children: loading ? "处理中..." : mode === "create" ? "创建" : "保存"
+				children: loading ? locale.submitting : mode === "create" ? locale.create : locale.save
 			})]
 		}),
 		children: /* @__PURE__ */ jsx(AutoForm, {
@@ -4863,7 +5374,7 @@ function CrudFormModal({ open, onOpenChange, mode, schema, initialValues, onSubm
 
 //#endregion
 //#region src/components/auto-crud/import-dialog.tsx
-function ImportDialog({ open, onOpenChange, onImport, columns = [], title = "导入数据" }) {
+function ImportDialog({ open, onOpenChange, onImport, columns = [], title, locale = zhCN.importDialog }) {
 	const [step, setStep] = React.useState("upload");
 	const [parsedData, setParsedData] = React.useState(null);
 	const [error, setError] = React.useState(null);
@@ -4886,13 +5397,13 @@ function ImportDialog({ open, onOpenChange, onImport, columns = [], title = "导
 		try {
 			const data = await parseImportFile(file);
 			if (data.rows.length === 0) {
-				setError("文件中没有数据行");
+				setError(locale.errorNoData);
 				return;
 			}
 			setParsedData(data);
 			setStep("preview");
 		} catch (e) {
-			setError(e instanceof Error ? e.message : "文件解析失败");
+			setError(e instanceof Error ? e.message : locale.errorParseFailed);
 		}
 	}, []);
 	const handleDrop = React.useCallback((e) => {
@@ -4912,7 +5423,7 @@ function ImportDialog({ open, onOpenChange, onImport, columns = [], title = "导
 			setResult(await onImport(parsedData.rows));
 			setStep("result");
 		} catch (e) {
-			setError(e instanceof Error ? e.message : "导入失败");
+			setError(e instanceof Error ? e.message : locale.errorImportFailed);
 			setStep("preview");
 		}
 	}, [parsedData, onImport]);
@@ -4932,11 +5443,11 @@ function ImportDialog({ open, onOpenChange, onImport, columns = [], title = "导
 		onOpenChange: handleOpenChange,
 		children: /* @__PURE__ */ jsxs(DialogContent, {
 			className: "sm:max-w-[600px]",
-			children: [/* @__PURE__ */ jsxs(DialogHeader, { children: [/* @__PURE__ */ jsx(DialogTitle, { children: title }), /* @__PURE__ */ jsxs(DialogDescription, { children: [
-				step === "upload" && "上传 CSV 或 JSON 文件以批量导入数据",
-				step === "preview" && `已解析 ${parsedData?.rows.length ?? 0} 条数据，确认后开始导入`,
-				step === "importing" && "正在导入数据...",
-				step === "result" && "导入完成"
+			children: [/* @__PURE__ */ jsxs(DialogHeader, { children: [/* @__PURE__ */ jsx(DialogTitle, { children: title ?? locale.title }), /* @__PURE__ */ jsxs(DialogDescription, { children: [
+				step === "upload" && locale.uploadDescription,
+				step === "preview" && locale.previewDescription(parsedData?.rows.length ?? 0),
+				step === "importing" && locale.importingDescription,
+				step === "result" && locale.doneDescription
 			] })] }), /* @__PURE__ */ jsxs("div", {
 				className: "space-y-4",
 				children: [
@@ -4967,11 +5478,11 @@ function ImportDialog({ open, onOpenChange, onImport, columns = [], title = "导
 								}),
 								/* @__PURE__ */ jsx("p", {
 									className: "text-sm text-muted-foreground",
-									children: "拖拽文件到此处，或点击选择文件"
+									children: locale.dragHint
 								}),
 								/* @__PURE__ */ jsx("p", {
 									className: "text-xs text-muted-foreground/60",
-									children: "支持 CSV、JSON 格式"
+									children: locale.formatHint
 								})
 							]
 						}), /* @__PURE__ */ jsx("input", {
@@ -4986,7 +5497,7 @@ function ImportDialog({ open, onOpenChange, onImport, columns = [], title = "导
 						size: "sm",
 						className: "w-full",
 						onClick: handleDownloadTemplate,
-						children: "下载 CSV 模板"
+						children: locale.downloadTemplate
 					})] }),
 					step === "preview" && parsedData && /* @__PURE__ */ jsxs(Fragment, { children: [
 						/* @__PURE__ */ jsx("div", {
@@ -5006,13 +5517,9 @@ function ImportDialog({ open, onOpenChange, onImport, columns = [], title = "导
 												className: "px-3 py-2 text-left font-medium text-muted-foreground",
 												children: h
 											}, h)),
-											parsedData.headers.length > 6 && /* @__PURE__ */ jsxs("th", {
+											parsedData.headers.length > 6 && /* @__PURE__ */ jsx("th", {
 												className: "px-3 py-2 text-left font-medium text-muted-foreground",
-												children: [
-													"+",
-													parsedData.headers.length - 6,
-													" 列"
-												]
+												children: locale.moreColumns(parsedData.headers.length - 6)
 											})
 										] })
 									}), /* @__PURE__ */ jsx("tbody", { children: parsedData.rows.slice(0, 10).map((row, i) => /* @__PURE__ */ jsxs("tr", {
@@ -5035,40 +5542,27 @@ function ImportDialog({ open, onOpenChange, onImport, columns = [], title = "导
 								})
 							})
 						}),
-						/* @__PURE__ */ jsxs("p", {
+						/* @__PURE__ */ jsx("p", {
 							className: "text-sm text-muted-foreground",
-							children: [
-								"共 ",
-								parsedData.rows.length,
-								" 条数据",
-								parsedData.rows.length > 10 && "（预览前 10 条）",
-								"，",
-								parsedData.headers.length,
-								" 个字段 ，格式: ",
-								parsedData.format.toUpperCase()
-							]
+							children: locale.previewSummary(parsedData.rows.length, parsedData.headers.length, parsedData.format, parsedData.rows.length > 10 ? 10 : void 0)
 						}),
 						/* @__PURE__ */ jsxs("div", {
 							className: "flex gap-2 justify-end",
 							children: [/* @__PURE__ */ jsx(Button, {
 								variant: "outline",
 								onClick: reset,
-								children: "重新选择"
+								children: locale.reselect
 							}), /* @__PURE__ */ jsx(Button, {
 								onClick: handleImport,
-								children: "确认导入"
+								children: locale.confirmImport
 							})]
 						})
 					] }),
 					step === "importing" && /* @__PURE__ */ jsxs("div", {
 						className: "flex flex-col items-center gap-4 py-8",
-						children: [/* @__PURE__ */ jsx("div", { className: "h-8 w-8 animate-spin rounded-full border-4 border-primary border-t-transparent" }), /* @__PURE__ */ jsxs("p", {
+						children: [/* @__PURE__ */ jsx("div", { className: "h-8 w-8 animate-spin rounded-full border-4 border-primary border-t-transparent" }), /* @__PURE__ */ jsx("p", {
 							className: "text-sm text-muted-foreground",
-							children: [
-								"正在导入 ",
-								parsedData?.rows.length ?? 0,
-								" 条数据..."
-							]
+							children: locale.importingRows(parsedData?.rows.length ?? 0)
 						})]
 					}),
 					step === "result" && result && /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsxs("div", {
@@ -5083,7 +5577,7 @@ function ImportDialog({ open, onOpenChange, onImport, columns = [], title = "导
 										children: result.success
 									}), /* @__PURE__ */ jsx("p", {
 										className: "text-xs text-green-600/80",
-										children: "新建"
+										children: locale.resultCreated
 									})]
 								}),
 								(result.updated ?? 0) > 0 && /* @__PURE__ */ jsxs("div", {
@@ -5093,7 +5587,7 @@ function ImportDialog({ open, onOpenChange, onImport, columns = [], title = "导
 										children: result.updated
 									}), /* @__PURE__ */ jsx("p", {
 										className: "text-xs text-blue-600/80",
-										children: "更新"
+										children: locale.resultUpdated
 									})]
 								}),
 								result.skipped > 0 && /* @__PURE__ */ jsxs("div", {
@@ -5103,7 +5597,7 @@ function ImportDialog({ open, onOpenChange, onImport, columns = [], title = "导
 										children: result.skipped
 									}), /* @__PURE__ */ jsx("p", {
 										className: "text-xs text-yellow-600/80",
-										children: "跳过"
+										children: locale.resultSkipped
 									})]
 								}),
 								result.failed.length > 0 && /* @__PURE__ */ jsxs("div", {
@@ -5113,7 +5607,7 @@ function ImportDialog({ open, onOpenChange, onImport, columns = [], title = "导
 										children: result.failed.length
 									}), /* @__PURE__ */ jsx("p", {
 										className: "text-xs text-red-600/80",
-										children: "验证失败"
+										children: locale.resultFailed
 									})]
 								})
 							]
@@ -5127,10 +5621,10 @@ function ImportDialog({ open, onOpenChange, onImport, columns = [], title = "导
 										className: "sticky top-0 bg-red-50 dark:bg-red-950/30",
 										children: /* @__PURE__ */ jsxs("tr", { children: [/* @__PURE__ */ jsx("th", {
 											className: "px-3 py-2 text-left font-medium text-red-600",
-											children: "行号"
+											children: locale.failedRowHeader
 										}), /* @__PURE__ */ jsx("th", {
 											className: "px-3 py-2 text-left font-medium text-red-600",
-											children: "错误"
+											children: locale.failedErrorHeader
 										})] })
 									}), /* @__PURE__ */ jsx("tbody", { children: result.failed.map((f) => /* @__PURE__ */ jsxs("tr", {
 										className: "border-t border-red-100 dark:border-red-900",
@@ -5150,11 +5644,11 @@ function ImportDialog({ open, onOpenChange, onImport, columns = [], title = "导
 						children: [/* @__PURE__ */ jsx(Button, {
 							variant: "outline",
 							onClick: () => handleOpenChange(false),
-							children: "关闭"
+							children: locale.close
 						}), /* @__PURE__ */ jsx(Button, {
 							variant: "outline",
 							onClick: reset,
-							children: "继续导入"
+							children: locale.continueImport
 						})]
 					})] }),
 					error && /* @__PURE__ */ jsx("div", {
@@ -5176,26 +5670,51 @@ function ImportDialog({ open, onOpenChange, onImport, columns = [], title = "导
 function buildTableOverrides(fields, legacyOverrides) {
 	const result = { ...legacyOverrides };
 	if (fields) for (const [key, config] of Object.entries(fields)) {
+		const tableMeta = config.table !== false && typeof config.table === "object" ? config.table.meta : void 0;
 		let filterMeta;
-		if (config.filter && config.filter.enabled !== false && !config.filter.hidden) {
-			const { enabled: _, hidden: __,...filterProps } = config.filter;
-			if (Object.keys(filterProps).length > 0) filterMeta = filterProps;
+		if (config.filter && typeof config.filter === "object") {
+			if (config.filter.enabled !== false && config.filter.hidden !== true) {
+				const { enabled: _, hidden: __,...filterProps } = config.filter;
+				if (Object.keys(filterProps).length > 0) filterMeta = filterProps;
+			}
+		}
+		if (config.filter === false) result[key] = {
+			...result[key],
+			enableColumnFilter: false
+		};
+		else if (config.filter && typeof config.filter === "object") {
+			if (config.filter.enabled === false || config.filter.hidden === true) result[key] = {
+				...result[key],
+				enableColumnFilter: false
+			};
 		}
-		result[key] = {
+		if (tableMeta || filterMeta) result[key] = {
 			...result[key],
-			...config.label && { label: config.label },
-			...config.hidden && { hidden: true },
-			...config.table,
-			...filterMeta && { meta: {
+			meta: {
 				...result[key]?.meta ?? {},
-				...config.table?.meta ?? {},
-				...filterMeta
-			} }
+				...tableMeta ?? {},
+				...filterMeta ?? {}
+			}
 		};
-		if (config.filter?.enabled === false || config.filter?.hidden === true) result[key] = {
+		if (config.label) result[key] = {
 			...result[key],
-			enableColumnFilter: false
+			label: config.label
 		};
+		if (config.hidden) result[key] = {
+			...result[key],
+			hidden: true
+		};
+		if (config.table === false) result[key] = {
+			...result[key],
+			hidden: true
+		};
+		else if (config.table && typeof config.table === "object") {
+			const { meta,...tableProps } = config.table;
+			result[key] = {
+				...result[key],
+				...tableProps
+			};
+		}
 	}
 	return result;
 }
@@ -5209,12 +5728,24 @@ function buildFormOverrides(fields, legacyOverrides, denyFields) {
 		...result[field],
 		"x-hidden": true
 	};
-	if (fields) for (const [key, config] of Object.entries(fields)) result[key] = {
-		...result[key],
-		...config.label && { title: config.label },
-		...config.hidden && { "x-hidden": true },
-		...config.form
-	};
+	if (fields) for (const [key, config] of Object.entries(fields)) {
+		if (config.label) result[key] = {
+			...result[key],
+			title: config.label
+		};
+		if (config.hidden) result[key] = {
+			...result[key],
+			"x-hidden": true
+		};
+		if (config.form === false) result[key] = {
+			...result[key],
+			"x-hidden": true
+		};
+		else if (config.form && typeof config.form === "object") result[key] = {
+			...result[key],
+			...config.form
+		};
+	}
 	return result;
 }
 /**
@@ -5223,7 +5754,9 @@ function buildFormOverrides(fields, legacyOverrides, denyFields) {
 function buildHiddenColumns(fields, legacyHidden, denyFields) {
 	const hidden = new Set([...legacyHidden ?? [], ...denyFields ?? []]);
 	if (fields) {
-		for (const [key, config] of Object.entries(fields)) if (config.hidden || config.table?.hidden) hidden.add(key);
+		for (const [key, config] of Object.entries(fields)) if (config.hidden) hidden.add(key);
+		else if (config.table === false) hidden.add(key);
+		else if (config.table && typeof config.table === "object" && config.table.hidden) hidden.add(key);
 	}
 	return Array.from(hidden);
 }
@@ -5265,13 +5798,13 @@ function buildBatchUpdateFields(schema, batchFields, fields) {
 /**
 * 渲染字段值
 */
-function renderFieldValue(value, type) {
+function renderFieldValue(value, type, booleanLocale) {
 	if (value === null || value === void 0) return /* @__PURE__ */ jsx("span", {
 		className: "text-muted-foreground",
 		children: "-"
 	});
 	switch (type) {
-		case "boolean": return value ? "是" : "否";
+		case "boolean": return value ? booleanLocale.true : booleanLocale.false;
 		case "date": return formatDate(value);
 		case "enum": return /* @__PURE__ */ jsx(Badge, {
 			variant: "outline",
@@ -5294,7 +5827,7 @@ function renderFieldValue(value, type) {
 /**
 * ViewModal 组件 - 详情查看弹窗
 */
-function ViewModal({ open, onOpenChange, variant, data, schema, fields: fieldConfig, denyFields }) {
+function ViewModal({ open, onOpenChange, variant, data, schema, fields: fieldConfig, denyFields, locale }) {
 	if (!data) return null;
 	const shape = schema.shape;
 	const denySet = new Set(denyFields ?? []);
@@ -5314,7 +5847,7 @@ function ViewModal({ open, onOpenChange, variant, data, schema, fields: fieldCon
 					children: label
 				}), /* @__PURE__ */ jsx("dd", {
 					className: "col-span-2 text-sm",
-					children: renderFieldValue(value, parsed.type)
+					children: renderFieldValue(value, parsed.type, locale.boolean)
 				})]
 			}, key);
 		})
@@ -5322,23 +5855,89 @@ function ViewModal({ open, onOpenChange, variant, data, schema, fields: fieldCon
 	if (variant === "sheet") return /* @__PURE__ */ jsx(Sheet, {
 		open,
 		onOpenChange,
-		children: /* @__PURE__ */ jsxs(SheetContent, { children: [/* @__PURE__ */ jsx(SheetHeader, { children: /* @__PURE__ */ jsx(SheetTitle, { children: "详情" }) }), content] })
+		children: /* @__PURE__ */ jsxs(SheetContent, { children: [/* @__PURE__ */ jsx(SheetHeader, { children: /* @__PURE__ */ jsx(SheetTitle, { children: locale.viewModal.title }) }), content] })
 	});
 	return /* @__PURE__ */ jsx(Dialog, {
 		open,
 		onOpenChange,
 		children: /* @__PURE__ */ jsxs(DialogContent, {
 			className: "max-w-2xl max-h-[80vh] overflow-y-auto",
-			children: [/* @__PURE__ */ jsx(DialogHeader, { children: /* @__PURE__ */ jsx(DialogTitle, { children: "详情" }) }), content]
+			children: [/* @__PURE__ */ jsx(DialogHeader, { children: /* @__PURE__ */ jsx(DialogTitle, { children: locale.viewModal.title }) }), content]
 		})
 	});
 }
+function resolveActions(items, defaults, rowActionsLocale) {
+	const defaultItems = [
+		{
+			label: rowActionsLocale.view,
+			onClick: defaults.openView
+		},
+		...defaults.openEdit ? [{
+			label: rowActionsLocale.edit,
+			onClick: defaults.openEdit
+		}] : [],
+		...defaults.copyRow ? [{
+			label: rowActionsLocale.copy,
+			onClick: defaults.copyRow
+		}] : [],
+		...defaults.openDelete ? [{
+			label: rowActionsLocale.delete,
+			onClick: defaults.openDelete,
+			separator: true,
+			variant: "destructive"
+		}] : []
+	];
+	if (!items || items.length === 0) return defaultItems;
+	if (!items.some((i) => i.type !== "custom")) {
+		const startItems = items.filter((i) => i.type === "custom" && i.position === "start").map(({ label, onClick, separator, variant }) => ({
+			label,
+			onClick,
+			separator,
+			variant
+		}));
+		const endItems = items.filter((i) => i.type === "custom" && i.position !== "start").map(({ label, onClick, separator, variant }) => ({
+			label,
+			onClick,
+			separator,
+			variant
+		}));
+		return [
+			...startItems,
+			...defaultItems,
+			...endItems
+		];
+	}
+	const handlerMap = {
+		view: defaults.openView,
+		edit: defaults.openEdit,
+		copy: defaults.copyRow,
+		delete: defaults.openDelete
+	};
+	const variantMap = { delete: "destructive" };
+	return items.flatMap((item) => {
+		if (item.type === "custom") return [{
+			label: item.label,
+			onClick: item.onClick,
+			separator: item.separator,
+			variant: item.variant
+		}];
+		const handler = item.onClick ?? handlerMap[item.type];
+		if (!handler) return [];
+		return [{
+			label: item.label ?? rowActionsLocale[item.type],
+			onClick: handler,
+			separator: item.separator,
+			variant: variantMap[item.type]
+		}];
+	});
+}
 /**
 * AutoCrudTable 组件
 *
 * 高级 CRUD 表格组件，封装了完整的增删改查流程
 */
-function AutoCrudTable({ title, description, schema, resource, fields, table: tableConfig, form: formConfig, slots, permissions }) {
+function AutoCrudTable({ title, description, schema, resource, fields, table: tableConfig, form: formConfig, slots, permissions, actions: actionItems, locale: localeProp }) {
+	const locale = resolveLocale(localeProp);
 	const can = {
 		create: permissions?.can?.create ?? true,
 		update: permissions?.can?.update ?? true,
@@ -5389,10 +5988,22 @@ function AutoCrudTable({ title, description, schema, resource, fields, table: ta
 			setExporting(false);
 		}
 	}, [selectedCount, handleExport]);
-	const tableOverrides = buildTableOverrides(fields, tableConfig?.overrides);
-	const formOverrides = buildFormOverrides(fields, formConfig?.overrides, denyFields);
-	const hiddenColumns = buildHiddenColumns(fields, tableConfig?.hidden, denyFields);
-	const batchFields = buildBatchUpdateFields(schema, tableConfig?.batchFields, fields);
+	const tableOverrides = React.useMemo(() => buildTableOverrides(fields, tableConfig?.overrides), [fields, tableConfig?.overrides]);
+	const formOverrides = React.useMemo(() => buildFormOverrides(fields, formConfig?.overrides, denyFields), [
+		fields,
+		formConfig?.overrides,
+		denyFields
+	]);
+	const hiddenColumns = React.useMemo(() => buildHiddenColumns(fields, tableConfig?.hidden, denyFields), [
+		fields,
+		tableConfig?.hidden,
+		denyFields
+	]);
+	const batchFields = React.useMemo(() => buildBatchUpdateFields(schema, tableConfig?.batchFields, fields), [
+		schema,
+		tableConfig?.batchFields,
+		fields
+	]);
 	return /* @__PURE__ */ jsxs("div", {
 		className: "space-y-4",
 		children: [
@@ -5419,18 +6030,18 @@ function AutoCrudTable({ title, description, schema, resource, fields, table: ta
 							variant: "outline",
 							size: "sm",
 							onClick: () => setImportOpen(true),
-							children: [/* @__PURE__ */ jsx(Download, { className: "mr-2 h-4 w-4" }), "导入"]
+							children: [/* @__PURE__ */ jsx(Download, { className: "mr-2 h-4 w-4" }), locale.toolbar.import]
 						}),
 						canExport && /* @__PURE__ */ jsxs(Button, {
 							variant: "outline",
 							size: "sm",
 							onClick: handleExportClick,
 							disabled: exporting || selectedCount === 0 && !resource.handlers.export,
-							children: [exporting ? /* @__PURE__ */ jsx(Loader2, { className: "mr-2 h-4 w-4 animate-spin" }) : /* @__PURE__ */ jsx(Upload, { className: "mr-2 h-4 w-4" }), selectedCount > 0 ? `导出(${selectedCount})` : "导出"]
+							children: [exporting ? /* @__PURE__ */ jsx(Loader2, { className: "mr-2 h-4 w-4 animate-spin" }) : /* @__PURE__ */ jsx(Upload, { className: "mr-2 h-4 w-4" }), selectedCount > 0 ? locale.toolbar.exportSelected(selectedCount) : locale.toolbar.export]
 						}),
 						can.create && /* @__PURE__ */ jsx(Button, {
 							onClick: resource.handlers.openCreate,
-							children: "新建"
+							children: locale.toolbar.create
 						})
 					]
 				})]
@@ -5442,12 +6053,12 @@ function AutoCrudTable({ title, description, schema, resource, fields, table: ta
 				overrides: tableOverrides,
 				exclude: hiddenColumns,
 				filterMode: tableConfig?.filterModes,
-				actions: {
-					onView: resource.handlers.openView,
-					onEdit: can.update ? resource.handlers.openEdit : void 0,
-					onCopy: can.create ? resource.handlers.copyRow : void 0,
-					onDelete: can.delete ? resource.handlers.openDelete : void 0
-				},
+				actions: resolveActions(actionItems, {
+					openView: resource.handlers.openView,
+					openEdit: can.update ? resource.handlers.openEdit : void 0,
+					copyRow: can.create ? resource.handlers.copyRow : void 0,
+					openDelete: can.delete ? resource.handlers.openDelete : void 0
+				}, locale.rowActions),
 				onDeleteSelected: can.delete ? resource.handlers.deleteMany : void 0,
 				onUpdateSelected: can.update ? resource.handlers.updateMany : void 0,
 				batchUpdateFields: can.update ? batchFields : void 0,
@@ -5468,7 +6079,8 @@ function AutoCrudTable({ title, description, schema, resource, fields, table: ta
 				},
 				loading: resource.mutations.isCreating || resource.mutations.isUpdating,
 				variant: resource.modal.variant,
-				overrides: formOverrides
+				overrides: formOverrides,
+				locale: locale.formModal
 			}),
 			/* @__PURE__ */ jsx(ViewModal, {
 				open: resource.modal.viewOpen,
@@ -5477,22 +6089,24 @@ function AutoCrudTable({ title, description, schema, resource, fields, table: ta
 				data: resource.modal.selected,
 				schema,
 				fields,
-				denyFields
+				denyFields,
+				locale
 			}),
 			/* @__PURE__ */ jsx(AlertDialog, {
 				open: resource.modal.deleteOpen,
 				onOpenChange: (open) => !open && resource.handlers.closeModals(),
-				children: /* @__PURE__ */ jsxs(AlertDialogContent, { children: [/* @__PURE__ */ jsxs(AlertDialogHeader, { children: [/* @__PURE__ */ jsx(AlertDialogTitle, { children: "确认删除" }), /* @__PURE__ */ jsx(AlertDialogDescription, { children: "此操作无法撤销。确定要删除这条记录吗？" })] }), /* @__PURE__ */ jsxs(AlertDialogFooter, { children: [/* @__PURE__ */ jsx(AlertDialogCancel, { children: "取消" }), /* @__PURE__ */ jsx(AlertDialogAction, {
+				children: /* @__PURE__ */ jsxs(AlertDialogContent, { children: [/* @__PURE__ */ jsxs(AlertDialogHeader, { children: [/* @__PURE__ */ jsx(AlertDialogTitle, { children: locale.deleteModal.title }), /* @__PURE__ */ jsx(AlertDialogDescription, { children: locale.deleteModal.description })] }), /* @__PURE__ */ jsxs(AlertDialogFooter, { children: [/* @__PURE__ */ jsx(AlertDialogCancel, { children: locale.deleteModal.cancel }), /* @__PURE__ */ jsx(AlertDialogAction, {
 					onClick: resource.handlers.confirmDelete,
 					disabled: resource.mutations.isDeleting,
-					children: resource.mutations.isDeleting ? "删除中..." : "确认删除"
+					children: resource.mutations.isDeleting ? locale.deleteModal.confirming : locale.deleteModal.confirm
 				})] })] })
 			}),
 			canImport && resource.handlers.import && /* @__PURE__ */ jsx(ImportDialog, {
 				open: importOpen,
 				onOpenChange: setImportOpen,
 				onImport: resource.handlers.import,
-				columns: importColumns
+				columns: importColumns,
+				locale: locale.importDialog
 			})
 		]
 	});
@@ -6124,6 +6738,8 @@ function DataTableToolbarFilter({ column }) {
 		const columnMeta = column.columnDef.meta;
 		return React.useCallback(() => {
 			if (!columnMeta?.variant) return null;
+			const modes = columnMeta.modes;
+			if (modes && !modes.includes("advanced")) return null;
 			switch (columnMeta.variant) {
 				case "text": return /* @__PURE__ */ jsx(Input, {
 					placeholder: columnMeta.placeholder ?? columnMeta.label,
@@ -6245,6 +6861,10 @@ function modalReducer(state, action) {
 function useAutoCrudResource({ router, schema, query: queryTransform, options = {} }) {
 	const { idKey = "id", defaultVariant = "dialog", hooks, toast: toastAdapter, exportFetcher } = options;
 	const toast$1 = useMemo(() => toastAdapter === false ? noopToastAdapter : toastAdapter ?? defaultToastAdapter, [toastAdapter]);
+	const hooksRef = useRef(hooks);
+	useEffect(() => {
+		hooksRef.current = hooks;
+	}, [hooks]);
 	const columns = useMemo(() => createTableSchema(schema), [schema]);
 	const [urlParams] = useQueryStates({
 		page: parseAsInteger.withDefault(1),
@@ -6308,15 +6928,16 @@ function useAutoCrudResource({ router, schema, query: queryTransform, options =
 		payload: variant
 	}), []);
 	const submitCreate = useCallback(async (values) => {
+		const currentHooks = hooksRef.current;
 		try {
-			if (hooks?.beforeCreate) {
-				const result = await hooks.beforeCreate(values);
+			if (currentHooks?.beforeCreate) {
+				const result = await currentHooks.beforeCreate(values);
 				if (typeof result === "boolean") {
 					if (result) {
 						toast$1.success("创建成功");
 						closeModals();
 						listQuery.refetch();
-						hooks?.onSuccess?.("create", values);
+						currentHooks?.onSuccess?.("create", values);
 					}
 					return;
 				}
@@ -6327,36 +6948,36 @@ function useAutoCrudResource({ router, schema, query: queryTransform, options =
 					toast$1.success("创建成功");
 					closeModals();
 					listQuery.refetch();
-					hooks?.onSuccess?.("create", data);
+					currentHooks?.onSuccess?.("create", data);
 				},
 				onError: (error) => {
 					const err = error;
 					toast$1.error(`创建失败: ${err.message}`);
-					hooks?.onError?.("create", err);
+					currentHooks?.onError?.("create", err);
 				}
 			});
 		} catch (error) {
 			const err = error;
 			toast$1.error(`创建失败: ${err.message}`);
-			hooks?.onError?.("create", err);
+			currentHooks?.onError?.("create", err);
 		}
 	}, [
 		createMutation,
 		closeModals,
-		listQuery,
-		hooks
+		listQuery
 	]);
 	const submitUpdate = useCallback(async (values) => {
+		const currentHooks = hooksRef.current;
 		if (!modal.selected) return;
 		try {
-			if (hooks?.beforeUpdate) {
-				const result = await hooks.beforeUpdate(values, modal.selected);
+			if (currentHooks?.beforeUpdate) {
+				const result = await currentHooks.beforeUpdate(values, modal.selected);
 				if (typeof result === "boolean") {
 					if (result) {
 						toast$1.success("更新成功");
 						closeModals();
 						listQuery.refetch();
-						hooks?.onSuccess?.("update", values);
+						currentHooks?.onSuccess?.("update", values);
 					}
 					return;
 				}
@@ -6371,38 +6992,38 @@ function useAutoCrudResource({ router, schema, query: queryTransform, options =
 					toast$1.success("更新成功");
 					closeModals();
 					listQuery.refetch();
-					hooks?.onSuccess?.("update", data);
+					currentHooks?.onSuccess?.("update", data);
 				},
 				onError: (error) => {
 					const err = error;
 					toast$1.error(`更新失败: ${err.message}`);
-					hooks?.onError?.("update", err);
+					currentHooks?.onError?.("update", err);
 				}
 			});
 		} catch (error) {
 			const err = error;
 			toast$1.error(`更新失败: ${err.message}`);
-			hooks?.onError?.("update", err);
+			currentHooks?.onError?.("update", err);
 		}
 	}, [
 		modal.selected,
 		idKey,
 		updateMutation,
 		closeModals,
-		listQuery,
-		hooks
+		listQuery
 	]);
 	const confirmDelete = useCallback(async () => {
+		const currentHooks = hooksRef.current;
 		if (!modal.selected) return;
 		try {
-			if (hooks?.beforeDelete) {
-				const result = await hooks.beforeDelete(modal.selected);
+			if (currentHooks?.beforeDelete) {
+				const result = await currentHooks.beforeDelete(modal.selected);
 				if (typeof result === "boolean") {
 					if (result) {
 						toast$1.success("删除成功");
 						closeModals();
 						listQuery.refetch();
-						hooks?.onSuccess?.("delete", modal.selected);
+						currentHooks?.onSuccess?.("delete", modal.selected);
 					}
 					return;
 				}
@@ -6413,28 +7034,28 @@ function useAutoCrudResource({ router, schema, query: queryTransform, options =
 					toast$1.success("删除成功");
 					closeModals();
 					listQuery.refetch();
-					hooks?.onSuccess?.("delete", data);
+					currentHooks?.onSuccess?.("delete", data);
 				},
 				onError: (error) => {
 					const err = error;
 					toast$1.error(`删除失败: ${err.message}`);
-					hooks?.onError?.("delete", err);
+					currentHooks?.onError?.("delete", err);
 				}
 			});
 		} catch (error) {
 			const err = error;
 			toast$1.error(`删除失败: ${err.message}`);
-			hooks?.onError?.("delete", err);
+			currentHooks?.onError?.("delete", err);
 		}
 	}, [
 		modal.selected,
 		idKey,
 		deleteMutation,
 		closeModals,
-		listQuery,
-		hooks
+		listQuery
 	]);
 	const deleteMany = useCallback((rows) => {
+		const currentHooks = hooksRef.current;
 		if (!deleteManyMutation) {
 			toast$1.error("批量删除功能未启用");
 			return;
@@ -6444,21 +7065,21 @@ function useAutoCrudResource({ router, schema, query: queryTransform, options =
 			onSuccess: (data) => {
 				toast$1.success(`成功删除 ${ids.length} 条记录`);
 				listQuery.refetch();
-				hooks?.onSuccess?.("delete", data);
+				currentHooks?.onSuccess?.("delete", data);
 			},
 			onError: (error) => {
 				const err = error;
 				toast$1.error(`批量删除失败: ${err.message}`);
-				hooks?.onError?.("delete", err);
+				currentHooks?.onError?.("delete", err);
 			}
 		});
 	}, [
 		deleteManyMutation,
 		idKey,
-		listQuery,
-		hooks
+		listQuery
 	]);
 	const updateMany = useCallback((rows, data) => {
+		const currentHooks = hooksRef.current;
 		if (!updateManyMutation) {
 			toast$1.error("批量更新功能未启用");
 			return;
@@ -6471,19 +7092,18 @@ function useAutoCrudResource({ router, schema, query: queryTransform, options =
 			onSuccess: (result) => {
 				toast$1.success(`成功更新 ${ids.length} 条记录`);
 				listQuery.refetch();
-				hooks?.onSuccess?.("update", result);
+				currentHooks?.onSuccess?.("update", result);
 			},
 			onError: (error) => {
 				const err = error;
 				toast$1.error(`批量更新失败: ${err.message}`);
-				hooks?.onError?.("update", err);
+				currentHooks?.onError?.("update", err);
 			}
 		});
 	}, [
 		updateManyMutation,
 		idKey,
-		listQuery,
-		hooks
+		listQuery
 	]);
 	const copyRow = useCallback((row) => {
 		dispatch({
@@ -6856,4 +7476,4 @@ function createMemoryDataSource(initialData = []) {
 }
 
 //#endregion
-export { AutoCrudTable, AutoForm, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, CrudFormModal, DataTable, DataTableAdvancedToolbar, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableToolbar, DataTableViewOptions, ExportDialog, ImportDialog, SchemaAdapter, 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 { AutoCrudTable, AutoForm, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, CrudFormModal, DataTable, DataTableAdvancedToolbar, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableToolbar, DataTableViewOptions, ExportDialog, ImportDialog, SchemaAdapter, 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 };