@wordrhyme/auto-crud 1.3.6 → 1.3.8

package/README.md

@@ -268,7 +268,7 @@ interface AutoCrudTableProps<TSchema> {
     batchFields?: (string | BatchUpdateField)[]; // 批量更新字段
     /** @deprecated 新代码请使用 actions.batch */
     batchActions?: BatchActionConfig<z.output<TSchema>>;
-    defaultSort?: any[]; // 默认排序
+    defaultSort?: any[]; // 手动 resource 的 UI 默认排序；useAutoCrudResource 请配置 options.defaultSort
   };
   form?: {
     overrides?: Record<string, any>; // 表单覆盖配置
@@ -280,11 +280,13 @@ interface AutoCrudTableProps<TSchema> {
    * 旧写法 actions={[...]} 仍表示行操作；
    * 新写法 actions={{ toolbar, row, batch }} 可集中配置三类操作。
    */
-  actions?: RowActionConfig<z.output<TSchema>> | {
-    toolbar?: ToolbarActionConfig;
-    row?: RowActionConfig<z.output<TSchema>>;
-    batch?: BatchActionConfig<z.output<TSchema>>;
-  };
+  actions?:
+    | RowActionConfig<z.output<TSchema>>
+    | {
+        toolbar?: ToolbarActionConfig;
+        row?: RowActionConfig<z.output<TSchema>>;
+        batch?: BatchActionConfig<z.output<TSchema>>;
+      };
   /** @deprecated 新代码请使用 actions.toolbar */
   toolbar?: ToolbarActionConfig;
   /** @deprecated 新代码请使用 actions.toolbar */
@@ -302,6 +304,11 @@ interface AutoCrudTableProps<TSchema> {
 interface UseAutoCrudResourceConfig<TData> {
   dataSource: DataSource<TData>; // 数据源
   schema: z.ZodType<TData>; // Zod Schema
+  options?: {
+    defaultSort?: Array<{ id: string; desc: boolean }> | false;
+    // undefined: schema 有 createdAt 时默认 createdAt desc
+    // false: 不应用默认排序
+  };
 }
 ```
 
@@ -776,7 +783,12 @@ crudActions.register({
   actions={{
     row: [
       { type: 'custom', label: '分配', onClick: (row) => assign(row.id) },
-      { type: 'custom', label: '预览', onClick: (row) => preview(row), position: 'start' },
+      {
+        type: 'custom',
+        label: '预览',
+        onClick: (row) => preview(row),
+        position: 'start',
+      },
     ],
   }}
 />
@@ -849,7 +861,9 @@ type RowCustomActionItem<T> = ActionMeta & {
   type: 'custom';
   label?: string;
   onClick?: (row: T) => void;
-  component?: React.ReactNode | ((context: AutoCrudRowActionContext<T>) => React.ReactNode);
+  component?:
+    | React.ReactNode
+    | ((context: AutoCrudRowActionContext<T>) => React.ReactNode);
   position?: 'start' | 'end'; // 仅无内置项时生效，默认 end
   separator?: boolean;
   variant?: 'default' | 'destructive';
@@ -992,7 +1006,7 @@ import {
   createSelectColumn, // 创建选择列
   createActionsColumn, // 创建操作列
   createFormSchema, // Zod Schema → Formily Schema
-  createEditFormSchema, // 创建编辑表单 Schema（排除 id, createdAt, updatedAt）
+  createEditFormSchema, // 创建编辑表单 Schema（排除平台托管字段）
 } from '@wordrhyme/auto-crud';
 ```
 
@@ -1254,7 +1268,15 @@ function CustomCrudPage() {
   });
 
   const formSchema = createFormSchema(taskSchema, {
-    exclude: ["id", "createdAt", "updatedAt"],
+    exclude: [
+      "id",
+      "createdAt",
+      "updatedAt",
+      "createdBy",
+      "createdByType",
+      "updatedBy",
+      "updatedByType",
+    ],
   });
 
   return (

package/dist/index.cjs

@@ -4207,6 +4207,15 @@ function FormModal({ open, onOpenChange, title, description, children, variant =
 
 //#endregion
 //#region src/lib/schema-bridge/zod-to-formily.ts
+const DEFAULT_FORM_MANAGED_FIELDS = [
+	"id",
+	"createdAt",
+	"updatedAt",
+	"createdBy",
+	"createdByType",
+	"updatedBy",
+	"updatedByType"
+];
 /**
 * 将字符串转为人类可读格式
 */
@@ -4289,16 +4298,12 @@ function createFormSchema(schema, options) {
 	};
 }
 /**
-* 为编辑模式创建 Form Schema（排除 id, createdAt, updatedAt）
+* 为编辑模式创建 Form Schema（排除平台托管字段）
 */
 function createEditFormSchema(schema, options) {
 	return createFormSchema(schema, {
 		...options,
-		exclude: [
-			"id",
-			"createdAt",
-			"updatedAt"
-		]
+		exclude: [...DEFAULT_FORM_MANAGED_FIELDS]
 	});
 }
 
@@ -5632,6 +5637,15 @@ function ImportDialog({ open, onOpenChange, onImport, columns = [], title, local
 	});
 }
 
+//#endregion
+//#region src/lib/default-sorting.ts
+function getDefaultSortingForSchema(schema) {
+	return Object.prototype.hasOwnProperty.call(schema.shape, "createdAt") ? [{
+		id: "createdAt",
+		desc: true
+	}] : [];
+}
+
 //#endregion
 //#region src/lib/crud-actions.ts
 const entries = /* @__PURE__ */ new Map();
@@ -5781,6 +5795,29 @@ const crudActions = {
 
 //#endregion
 //#region src/components/auto-crud/auto-crud-table.tsx
+const DEFAULT_IMPORT_MANAGED_FIELDS = [
+	"createdAt",
+	"updatedAt",
+	"createdBy",
+	"createdByType",
+	"updatedBy",
+	"updatedByType"
+];
+const DEFAULT_HIDDEN_AUDIT_FIELDS = [
+	"createdBy",
+	"createdByType",
+	"updatedBy",
+	"updatedByType"
+];
+function isDefaultHiddenAuditField(key) {
+	return DEFAULT_HIDDEN_AUDIT_FIELDS.includes(key);
+}
+function isFieldTableExplicitlyVisible(config) {
+	return config?.hidden === false || config?.table !== false && typeof config?.table === "object" && config.table.hidden === false;
+}
+function isTableOverrideExplicitlyVisible(config) {
+	return config?.hidden === false;
+}
 let autoCrudToolbarResolver = null;
 function setToolbarResolver(resolver) {
 	autoCrudToolbarResolver = resolver;
@@ -6232,10 +6269,18 @@ function buildTableOverrides(fields, legacyOverrides, dynamicFilterState) {
 /**
 * 从统一配置生成隐藏列列表
 */
-function buildHiddenColumns(fields, legacyHidden, denyFields) {
-	const hidden = new Set([...legacyHidden ?? [], ...denyFields ?? []]);
-	if (fields) {
-		for (const [key, config] of Object.entries(fields)) if (config.hidden) hidden.add(key);
+function buildHiddenColumns(fields, legacyHidden, denyFields, legacyOverrides) {
+	const legacyHiddenSet = new Set(legacyHidden ?? []);
+	const denySet = new Set(denyFields ?? []);
+	const hidden = new Set([
+		...DEFAULT_HIDDEN_AUDIT_FIELDS,
+		...legacyHiddenSet,
+		...denySet
+	]);
+	for (const key of DEFAULT_HIDDEN_AUDIT_FIELDS) if (!legacyHiddenSet.has(key) && !denySet.has(key) && isTableOverrideExplicitlyVisible(legacyOverrides?.[key])) hidden.delete(key);
+	if (fields) for (const [key, config] of Object.entries(fields)) {
+		if (isDefaultHiddenAuditField(key) && !legacyHiddenSet.has(key) && !denySet.has(key) && isFieldTableExplicitlyVisible(config)) hidden.delete(key);
+		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);
 	}
@@ -6339,7 +6384,10 @@ function ViewModal({ open, onOpenChange, variant, data, schema, fields: fieldCon
 		className: "grid gap-4 py-4",
 		children: Object.entries(shape).filter(([key]) => {
 			if (denySet.has(key)) return false;
-			return !(fieldConfig?.[key])?.hidden;
+			const config = fieldConfig?.[key];
+			if (config?.hidden) return false;
+			if (isDefaultHiddenAuditField(key) && !isFieldTableExplicitlyVisible(config)) return false;
+			return true;
 		}).map(([key, fieldSchema]) => {
 			const parsed = parseZodField(fieldSchema);
 			const label = fieldConfig?.[key]?.label ?? humanize(key);
@@ -6552,7 +6600,7 @@ function AutoCrudTable({ id, title, description, schema, resource, fields, table
 	const resolvedToolbarActions = resolveToolbarActionsWithResolver(id, registryToolbarActions, toolbarContext);
 	const importColumns = react.useMemo(() => {
 		const shape = resolvedSchema.shape;
-		const denySet = new Set(denyFields ?? []);
+		const denySet = new Set([...DEFAULT_IMPORT_MANAGED_FIELDS, ...denyFields ?? []]);
 		return Object.keys(shape).filter((key) => !denySet.has(key));
 	}, [resolvedSchema, denyFields]);
 	const handleExport = react.useCallback(async (mode) => {
@@ -6591,15 +6639,21 @@ function AutoCrudTable({ id, title, description, schema, resource, fields, table
 		tableConfig?.overrides,
 		dynamicFilterOptions
 	]);
+	const defaultSort = react.useMemo(() => resource.defaultSort ?? tableConfig?.defaultSort ?? getDefaultSortingForSchema(resolvedSchema), [
+		resource.defaultSort,
+		resolvedSchema,
+		tableConfig?.defaultSort
+	]);
 	const formOverrides = react.useMemo(() => buildFormOverrides(resolvedFields, formConfig?.overrides, denyFields), [
 		resolvedFields,
 		formConfig?.overrides,
 		denyFields
 	]);
-	const hiddenColumns = react.useMemo(() => buildHiddenColumns(resolvedFields, tableConfig?.hidden, denyFields), [
+	const hiddenColumns = react.useMemo(() => buildHiddenColumns(resolvedFields, tableConfig?.hidden, denyFields, tableConfig?.overrides), [
 		resolvedFields,
 		tableConfig?.hidden,
-		denyFields
+		denyFields,
+		tableConfig?.overrides
 	]);
 	const searchConfig = react.useMemo(() => {
 		const tableSearch = tableConfig?.search;
@@ -6747,7 +6801,7 @@ function AutoCrudTable({ id, title, description, schema, resource, fields, table
 				deleteConfirmation: locale.bulkDeleteModal,
 				enableExport: canExport,
 				showDefaultExport: false,
-				initialSorting: tableConfig?.defaultSort,
+				initialSorting: defaultSort,
 				onSelectedRowsChange: handleSelectedRowsChange,
 				getSelectedRows: getSelectedRowsRef
 			}),
@@ -7549,7 +7603,7 @@ function modalReducer(state, action$1) {
 * Hook 主函数
 */
 function useAutoCrudResource({ router, schema, query: queryTransform, options = {} }) {
-	const { idKey = "id", defaultVariant = "dialog", hooks, toast: toastAdapter, exportFetcher } = options;
+	const { idKey = "id", defaultVariant = "dialog", hooks, toast: toastAdapter, exportFetcher, defaultSort: defaultSortOption } = options;
 	const toast = (0, react.useMemo)(() => toastAdapter === false ? noopToastAdapter : toastAdapter ?? defaultToastAdapter, [toastAdapter]);
 	const hooksRef = (0, react.useRef)(hooks);
 	(0, react.useEffect)(() => {
@@ -7557,12 +7611,13 @@ function useAutoCrudResource({ router, schema, query: queryTransform, options =
 	}, [hooks]);
 	const metadata = (router.meta?.useQuery(void 0, { staleTime: 3e4 }))?.data;
 	const resolvedSchema = (0, react.useMemo)(() => mergeMetadataSchema(schema, metadata?.schema), [schema, metadata?.schema]);
+	const defaultSorting = (0, react.useMemo)(() => defaultSortOption === false ? [] : defaultSortOption ?? getDefaultSortingForSchema(resolvedSchema), [defaultSortOption, resolvedSchema]);
 	const metadataFields = (0, react.useMemo)(() => readMetadataFields(metadata?.fields), [metadata?.fields]);
 	const columns = (0, react.useMemo)(() => createTableSchema(resolvedSchema), [resolvedSchema]);
 	const [urlParams] = useQueryStates({
 		page: parseAsInteger.withDefault(1),
 		perPage: parseAsInteger.withDefault(10),
-		sort: getSortingStateParser().withDefault([]),
+		sort: getSortingStateParser().withDefault(defaultSorting),
 		joinOperator: parseAsStringEnum(["and", "or"]).withDefault("and"),
 		search: parseAsString.withDefault("")
 	}, { shallow: false });
@@ -7850,6 +7905,7 @@ function useAutoCrudResource({ router, schema, query: queryTransform, options =
 		},
 		schema: resolvedSchema,
 		fields: metadataFields,
+		defaultSort: defaultSorting,
 		modal,
 		mutations: {
 			isCreating: createMutation.isPending,

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime0 from "react/jsx-runtime";
+import * as react_jsx_runtime5 from "react/jsx-runtime";
 import { z } from "zod";
 import { JsonSchemaFormScope } from "@wordrhyme/formily-shadcn";
 import * as _tanstack_react_table0 from "@tanstack/react-table";
@@ -9,6 +9,12 @@ import { DropdownMenuTrigger, PopoverContent } from "@wordrhyme/shadcn";
 import { MultiCombobox, MultiComboboxOption, MultiComboboxProps, MultiComboboxTriggerRenderProps, Select, SelectMode, SelectOption, SelectProps, SelectSearchableDynamicProps, SelectSearchableMultipleProps, SelectSearchableProps, SelectSearchableSingleProps, SelectSimpleProps, SelectTriggerRenderProps } from "@wordrhyme/shadcn-ui";
 import { ClassValue } from "clsx";
 
+//#region src/lib/default-sorting.d.ts
+type AutoCrudSorting = Array<{
+  id: string;
+  desc: boolean;
+}>;
+//#endregion
 //#region src/hooks/use-auto-crud-resource.d.ts
 /**
  * Toast 适配器接口
@@ -103,6 +109,12 @@ interface UseAutoCrudResourceOptions<TSchema extends z.ZodObject<z.ZodRawShape>,
     total: number;
     hasMore: boolean;
   }>;
+  /**
+   * 默认排序。
+   * - undefined: schema 有 createdAt 时默认 createdAt desc
+   * - false: 不应用默认排序
+   */
+  defaultSort?: AutoCrudSorting | false;
 }
 /**
  * 导入结果类型（与服务端保持一致）
@@ -133,6 +145,8 @@ interface UseAutoCrudResourceReturn<TSchema extends z.ZodObject<z.ZodRawShape>,
   schema?: z.ZodObject<z.ZodRawShape>;
   /** Optional field config override from host metadata. */
   fields?: Fields;
+  /** Default sorting used by this resource's list query. */
+  defaultSort?: AutoCrudSorting;
   modal: ModalState<TListItem>;
   mutations: {
     isCreating: boolean;
@@ -381,7 +395,7 @@ declare function AutoTableActionBar<TData>({
   extraActions,
   actions,
   deleteConfirmation
-}: AutoTableActionBarProps<TData>): react_jsx_runtime0.JSX.Element;
+}: AutoTableActionBarProps<TData>): react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/lib/schema-bridge/types.d.ts
 /**
@@ -557,7 +571,7 @@ declare function AutoTable<T extends z.ZodObject<z.ZodRawShape>>({
   onSelectedCountChange,
   onSelectedRowsChange,
   getSelectedRows
-}: AutoTableProps<T>): react_jsx_runtime0.JSX.Element;
+}: AutoTableProps<T>): react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/i18n/locale.d.ts
 /**
@@ -1037,7 +1051,7 @@ declare function AutoCrudTable<TSchema extends z.ZodObject<z.ZodRawShape>>({
   toolbarActions,
   locale: localeProp,
   onCreate
-}: AutoCrudTableProps<TSchema>): react_jsx_runtime0.JSX.Element;
+}: AutoCrudTableProps<TSchema>): react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/auto-form.d.ts
 interface AutoFormProps<T extends z.ZodObject<z.ZodRawShape>> {
@@ -1076,7 +1090,7 @@ declare function AutoFormInner<T extends z.ZodObject<z.ZodRawShape>>({
   labelAlign,
   labelWidth,
   showSubmitButton
-}: AutoFormProps<T>, ref: React.Ref<AutoFormRef>): react_jsx_runtime0.JSX.Element;
+}: AutoFormProps<T>, ref: React.Ref<AutoFormRef>): react_jsx_runtime5.JSX.Element;
 declare const AutoForm: <T extends z.ZodObject<z.ZodRawShape>>(props: AutoFormProps<T> & {
   ref?: React.Ref<AutoFormRef>;
 }) => ReturnType<typeof AutoFormInner>;
@@ -1392,7 +1406,7 @@ declare function AutoTableSimpleFilters<TData>({
   filters: externalFilters,
   onFiltersChange,
   leading
-}: AutoTableSimpleFiltersProps<TData>): react_jsx_runtime0.JSX.Element | null;
+}: AutoTableSimpleFiltersProps<TData>): react_jsx_runtime5.JSX.Element | null;
 //#endregion
 //#region src/components/auto-crud/form-modal.d.ts
 type ModalVariant = "dialog" | "sheet";
@@ -1436,7 +1450,7 @@ declare function CrudFormModal<T extends z.ZodObject<z.ZodRawShape>>({
   labelAlign,
   labelWidth,
   className
-}: CrudFormModalProps<T>): react_jsx_runtime0.JSX.Element;
+}: CrudFormModalProps<T>): react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/import-dialog.d.ts
 interface ImportDialogProps {
@@ -1458,7 +1472,7 @@ declare function ImportDialog({
   columns,
   title,
   locale
-}: ImportDialogProps): react_jsx_runtime0.JSX.Element;
+}: ImportDialogProps): react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/export-dialog.d.ts
 type ExportMode = "selected" | "filtered";
@@ -1478,7 +1492,7 @@ declare function ExportDialog({
   selectedCount,
   onExport,
   canExportFiltered
-}: ExportDialogProps): react_jsx_runtime0.JSX.Element;
+}: ExportDialogProps): react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table.d.ts
 interface DataTableProps<TData> extends React$1.ComponentProps<"div"> {
@@ -1491,7 +1505,7 @@ declare function DataTable<TData>({
   children,
   className,
   ...props
-}: DataTableProps<TData>): react_jsx_runtime0.JSX.Element;
+}: DataTableProps<TData>): react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-advanced-toolbar.d.ts
 interface DataTableAdvancedToolbarProps<TData> extends React$1.ComponentProps<"div"> {
@@ -1502,7 +1516,7 @@ declare function DataTableAdvancedToolbar<TData>({
   children,
   className,
   ...props
-}: DataTableAdvancedToolbarProps<TData>): react_jsx_runtime0.JSX.Element;
+}: DataTableAdvancedToolbarProps<TData>): react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-column-header.d.ts
 interface DataTableColumnHeaderProps<TData, TValue> extends React.ComponentProps<typeof DropdownMenuTrigger> {
@@ -1514,7 +1528,7 @@ declare function DataTableColumnHeader<TData, TValue>({
   label,
   className,
   ...props
-}: DataTableColumnHeaderProps<TData, TValue>): react_jsx_runtime0.JSX.Element;
+}: DataTableColumnHeaderProps<TData, TValue>): react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-faceted-filter.d.ts
 interface DataTableFacetedFilterProps<TData, TValue> {
@@ -1528,7 +1542,7 @@ declare function DataTableFacetedFilter<TData, TValue>({
   title,
   options,
   multiple
-}: DataTableFacetedFilterProps<TData, TValue>): react_jsx_runtime0.JSX.Element;
+}: DataTableFacetedFilterProps<TData, TValue>): react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-pagination.d.ts
 interface DataTablePaginationProps<TData> extends React.ComponentProps<"div"> {
@@ -1540,7 +1554,7 @@ declare function DataTablePagination<TData>({
   pageSizeOptions,
   className,
   ...props
-}: DataTablePaginationProps<TData>): react_jsx_runtime0.JSX.Element;
+}: DataTablePaginationProps<TData>): react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-toolbar.d.ts
 interface DataTableToolbarProps<TData> extends React$1.ComponentProps<"div"> {
@@ -1551,7 +1565,7 @@ declare function DataTableToolbar<TData>({
   children,
   className,
   ...props
-}: DataTableToolbarProps<TData>): react_jsx_runtime0.JSX.Element;
+}: DataTableToolbarProps<TData>): react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-view-options.d.ts
 interface DataTableViewOptionsProps<TData> extends React$1.ComponentProps<typeof PopoverContent> {
@@ -1562,7 +1576,7 @@ declare function DataTableViewOptions<TData>({
   table,
   disabled,
   ...props
-}: DataTableViewOptionsProps<TData>): react_jsx_runtime0.JSX.Element;
+}: DataTableViewOptionsProps<TData>): react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/lib/crud-actions.d.ts
 type CrudActionZone = 'toolbar' | 'row' | 'batch';
@@ -1644,7 +1658,7 @@ declare function useReadableFilters<TData>(columns: ColumnLike<TData>[], options
  */
 declare function createFormSchema<T extends z.ZodObject<z.ZodRawShape>>(schema: T, options?: CreateFormSchemaOptions): ISchema;
 /**
- * 为编辑模式创建 Form Schema（排除 id, createdAt, updatedAt）
+ * 为编辑模式创建 Form Schema（排除平台托管字段）
  */
 declare function createEditFormSchema<T extends z.ZodObject<z.ZodRawShape>>(schema: T, options?: Omit<CreateFormSchemaOptions, 'exclude'>): ISchema;
 //#endregion

package/dist/index.d.ts

@@ -3,12 +3,18 @@ import * as _tanstack_react_table0 from "@tanstack/react-table";
 import { Column, ColumnDef, ColumnSort, Row, RowData, Table, TableOptions, TableState } from "@tanstack/react-table";
 import { DropdownMenuTrigger, PopoverContent } from "@wordrhyme/shadcn";
 import { ClassValue } from "clsx";
-import * as react_jsx_runtime0 from "react/jsx-runtime";
+import * as react_jsx_runtime2 from "react/jsx-runtime";
 import { MultiCombobox, MultiComboboxOption, MultiComboboxProps, MultiComboboxTriggerRenderProps, Select, SelectMode, SelectOption, SelectProps, SelectSearchableDynamicProps, SelectSearchableMultipleProps, SelectSearchableProps, SelectSearchableSingleProps, SelectSimpleProps, SelectTriggerRenderProps } from "@wordrhyme/shadcn-ui";
 import { z } from "zod";
 import { JsonSchemaFormScope } from "@wordrhyme/formily-shadcn";
 import { ISchema } from "@formily/json-schema";
 
+//#region src/lib/default-sorting.d.ts
+type AutoCrudSorting = Array<{
+  id: string;
+  desc: boolean;
+}>;
+//#endregion
 //#region src/hooks/use-auto-crud-resource.d.ts
 /**
  * Toast 适配器接口
@@ -103,6 +109,12 @@ interface UseAutoCrudResourceOptions<TSchema extends z.ZodObject<z.ZodRawShape>,
     total: number;
     hasMore: boolean;
   }>;
+  /**
+   * 默认排序。
+   * - undefined: schema 有 createdAt 时默认 createdAt desc
+   * - false: 不应用默认排序
+   */
+  defaultSort?: AutoCrudSorting | false;
 }
 /**
  * 导入结果类型（与服务端保持一致）
@@ -133,6 +145,8 @@ interface UseAutoCrudResourceReturn<TSchema extends z.ZodObject<z.ZodRawShape>,
   schema?: z.ZodObject<z.ZodRawShape>;
   /** Optional field config override from host metadata. */
   fields?: Fields;
+  /** Default sorting used by this resource's list query. */
+  defaultSort?: AutoCrudSorting;
   modal: ModalState<TListItem>;
   mutations: {
     isCreating: boolean;
@@ -381,7 +395,7 @@ declare function AutoTableActionBar<TData>({
   extraActions,
   actions,
   deleteConfirmation
-}: AutoTableActionBarProps<TData>): react_jsx_runtime0.JSX.Element;
+}: AutoTableActionBarProps<TData>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/lib/schema-bridge/types.d.ts
 /**
@@ -557,7 +571,7 @@ declare function AutoTable<T extends z.ZodObject<z.ZodRawShape>>({
   onSelectedCountChange,
   onSelectedRowsChange,
   getSelectedRows
-}: AutoTableProps<T>): react_jsx_runtime0.JSX.Element;
+}: AutoTableProps<T>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/i18n/locale.d.ts
 /**
@@ -1037,7 +1051,7 @@ declare function AutoCrudTable<TSchema extends z.ZodObject<z.ZodRawShape>>({
   toolbarActions,
   locale: localeProp,
   onCreate
-}: AutoCrudTableProps<TSchema>): react_jsx_runtime0.JSX.Element;
+}: AutoCrudTableProps<TSchema>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/auto-form.d.ts
 interface AutoFormProps<T extends z.ZodObject<z.ZodRawShape>> {
@@ -1076,7 +1090,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_runtime2.JSX.Element;
 declare const AutoForm: <T extends z.ZodObject<z.ZodRawShape>>(props: AutoFormProps<T> & {
   ref?: React.Ref<AutoFormRef>;
 }) => ReturnType<typeof AutoFormInner>;
@@ -1392,7 +1406,7 @@ declare function AutoTableSimpleFilters<TData>({
   filters: externalFilters,
   onFiltersChange,
   leading
-}: AutoTableSimpleFiltersProps<TData>): react_jsx_runtime0.JSX.Element | null;
+}: AutoTableSimpleFiltersProps<TData>): react_jsx_runtime2.JSX.Element | null;
 //#endregion
 //#region src/components/auto-crud/form-modal.d.ts
 type ModalVariant = "dialog" | "sheet";
@@ -1436,7 +1450,7 @@ declare function CrudFormModal<T extends z.ZodObject<z.ZodRawShape>>({
   labelAlign,
   labelWidth,
   className
-}: CrudFormModalProps<T>): react_jsx_runtime0.JSX.Element;
+}: CrudFormModalProps<T>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/import-dialog.d.ts
 interface ImportDialogProps {
@@ -1458,7 +1472,7 @@ declare function ImportDialog({
   columns,
   title,
   locale
-}: ImportDialogProps): react_jsx_runtime0.JSX.Element;
+}: ImportDialogProps): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/export-dialog.d.ts
 type ExportMode = "selected" | "filtered";
@@ -1478,7 +1492,7 @@ declare function ExportDialog({
   selectedCount,
   onExport,
   canExportFiltered
-}: ExportDialogProps): react_jsx_runtime0.JSX.Element;
+}: ExportDialogProps): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table.d.ts
 interface DataTableProps<TData> extends React$1.ComponentProps<"div"> {
@@ -1491,7 +1505,7 @@ declare function DataTable<TData>({
   children,
   className,
   ...props
-}: DataTableProps<TData>): react_jsx_runtime0.JSX.Element;
+}: DataTableProps<TData>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-advanced-toolbar.d.ts
 interface DataTableAdvancedToolbarProps<TData> extends React$1.ComponentProps<"div"> {
@@ -1502,7 +1516,7 @@ declare function DataTableAdvancedToolbar<TData>({
   children,
   className,
   ...props
-}: DataTableAdvancedToolbarProps<TData>): react_jsx_runtime0.JSX.Element;
+}: DataTableAdvancedToolbarProps<TData>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-column-header.d.ts
 interface DataTableColumnHeaderProps<TData, TValue> extends React.ComponentProps<typeof DropdownMenuTrigger> {
@@ -1514,7 +1528,7 @@ declare function DataTableColumnHeader<TData, TValue>({
   label,
   className,
   ...props
-}: DataTableColumnHeaderProps<TData, TValue>): react_jsx_runtime0.JSX.Element;
+}: DataTableColumnHeaderProps<TData, TValue>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-faceted-filter.d.ts
 interface DataTableFacetedFilterProps<TData, TValue> {
@@ -1528,7 +1542,7 @@ declare function DataTableFacetedFilter<TData, TValue>({
   title,
   options,
   multiple
-}: DataTableFacetedFilterProps<TData, TValue>): react_jsx_runtime0.JSX.Element;
+}: DataTableFacetedFilterProps<TData, TValue>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-pagination.d.ts
 interface DataTablePaginationProps<TData> extends React.ComponentProps<"div"> {
@@ -1540,7 +1554,7 @@ declare function DataTablePagination<TData>({
   pageSizeOptions,
   className,
   ...props
-}: DataTablePaginationProps<TData>): react_jsx_runtime0.JSX.Element;
+}: DataTablePaginationProps<TData>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-toolbar.d.ts
 interface DataTableToolbarProps<TData> extends React$1.ComponentProps<"div"> {
@@ -1551,7 +1565,7 @@ declare function DataTableToolbar<TData>({
   children,
   className,
   ...props
-}: DataTableToolbarProps<TData>): react_jsx_runtime0.JSX.Element;
+}: DataTableToolbarProps<TData>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-view-options.d.ts
 interface DataTableViewOptionsProps<TData> extends React$1.ComponentProps<typeof PopoverContent> {
@@ -1562,7 +1576,7 @@ declare function DataTableViewOptions<TData>({
   table,
   disabled,
   ...props
-}: DataTableViewOptionsProps<TData>): react_jsx_runtime0.JSX.Element;
+}: DataTableViewOptionsProps<TData>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/lib/crud-actions.d.ts
 type CrudActionZone = 'toolbar' | 'row' | 'batch';
@@ -1644,7 +1658,7 @@ declare function useReadableFilters<TData>(columns: ColumnLike<TData>[], options
  */
 declare function createFormSchema<T extends z.ZodObject<z.ZodRawShape>>(schema: T, options?: CreateFormSchemaOptions): ISchema;
 /**
- * 为编辑模式创建 Form Schema（排除 id, createdAt, updatedAt）
+ * 为编辑模式创建 Form Schema（排除平台托管字段）
  */
 declare function createEditFormSchema<T extends z.ZodObject<z.ZodRawShape>>(schema: T, options?: Omit<CreateFormSchemaOptions, 'exclude'>): ISchema;
 //#endregion

package/dist/index.js

@@ -4170,6 +4170,15 @@ function FormModal({ open, onOpenChange, title, description, children, variant =
 
 //#endregion
 //#region src/lib/schema-bridge/zod-to-formily.ts
+const DEFAULT_FORM_MANAGED_FIELDS = [
+	"id",
+	"createdAt",
+	"updatedAt",
+	"createdBy",
+	"createdByType",
+	"updatedBy",
+	"updatedByType"
+];
 /**
 * 将字符串转为人类可读格式
 */
@@ -4252,16 +4261,12 @@ function createFormSchema(schema, options) {
 	};
 }
 /**
-* 为编辑模式创建 Form Schema（排除 id, createdAt, updatedAt）
+* 为编辑模式创建 Form Schema（排除平台托管字段）
 */
 function createEditFormSchema(schema, options) {
 	return createFormSchema(schema, {
 		...options,
-		exclude: [
-			"id",
-			"createdAt",
-			"updatedAt"
-		]
+		exclude: [...DEFAULT_FORM_MANAGED_FIELDS]
 	});
 }
 
@@ -5595,6 +5600,15 @@ function ImportDialog({ open, onOpenChange, onImport, columns = [], title, local
 	});
 }
 
+//#endregion
+//#region src/lib/default-sorting.ts
+function getDefaultSortingForSchema(schema) {
+	return Object.prototype.hasOwnProperty.call(schema.shape, "createdAt") ? [{
+		id: "createdAt",
+		desc: true
+	}] : [];
+}
+
 //#endregion
 //#region src/lib/crud-actions.ts
 const entries = /* @__PURE__ */ new Map();
@@ -5744,6 +5758,29 @@ const crudActions = {
 
 //#endregion
 //#region src/components/auto-crud/auto-crud-table.tsx
+const DEFAULT_IMPORT_MANAGED_FIELDS = [
+	"createdAt",
+	"updatedAt",
+	"createdBy",
+	"createdByType",
+	"updatedBy",
+	"updatedByType"
+];
+const DEFAULT_HIDDEN_AUDIT_FIELDS = [
+	"createdBy",
+	"createdByType",
+	"updatedBy",
+	"updatedByType"
+];
+function isDefaultHiddenAuditField(key) {
+	return DEFAULT_HIDDEN_AUDIT_FIELDS.includes(key);
+}
+function isFieldTableExplicitlyVisible(config) {
+	return config?.hidden === false || config?.table !== false && typeof config?.table === "object" && config.table.hidden === false;
+}
+function isTableOverrideExplicitlyVisible(config) {
+	return config?.hidden === false;
+}
 let autoCrudToolbarResolver = null;
 function setToolbarResolver(resolver) {
 	autoCrudToolbarResolver = resolver;
@@ -6195,10 +6232,18 @@ function buildTableOverrides(fields, legacyOverrides, dynamicFilterState) {
 /**
 * 从统一配置生成隐藏列列表
 */
-function buildHiddenColumns(fields, legacyHidden, denyFields) {
-	const hidden = new Set([...legacyHidden ?? [], ...denyFields ?? []]);
-	if (fields) {
-		for (const [key, config] of Object.entries(fields)) if (config.hidden) hidden.add(key);
+function buildHiddenColumns(fields, legacyHidden, denyFields, legacyOverrides) {
+	const legacyHiddenSet = new Set(legacyHidden ?? []);
+	const denySet = new Set(denyFields ?? []);
+	const hidden = new Set([
+		...DEFAULT_HIDDEN_AUDIT_FIELDS,
+		...legacyHiddenSet,
+		...denySet
+	]);
+	for (const key of DEFAULT_HIDDEN_AUDIT_FIELDS) if (!legacyHiddenSet.has(key) && !denySet.has(key) && isTableOverrideExplicitlyVisible(legacyOverrides?.[key])) hidden.delete(key);
+	if (fields) for (const [key, config] of Object.entries(fields)) {
+		if (isDefaultHiddenAuditField(key) && !legacyHiddenSet.has(key) && !denySet.has(key) && isFieldTableExplicitlyVisible(config)) hidden.delete(key);
+		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);
 	}
@@ -6302,7 +6347,10 @@ function ViewModal({ open, onOpenChange, variant, data, schema, fields: fieldCon
 		className: "grid gap-4 py-4",
 		children: Object.entries(shape).filter(([key]) => {
 			if (denySet.has(key)) return false;
-			return !(fieldConfig?.[key])?.hidden;
+			const config = fieldConfig?.[key];
+			if (config?.hidden) return false;
+			if (isDefaultHiddenAuditField(key) && !isFieldTableExplicitlyVisible(config)) return false;
+			return true;
 		}).map(([key, fieldSchema]) => {
 			const parsed = parseZodField(fieldSchema);
 			const label = fieldConfig?.[key]?.label ?? humanize(key);
@@ -6515,7 +6563,7 @@ function AutoCrudTable({ id, title, description, schema, resource, fields, table
 	const resolvedToolbarActions = resolveToolbarActionsWithResolver(id, registryToolbarActions, toolbarContext);
 	const importColumns = React.useMemo(() => {
 		const shape = resolvedSchema.shape;
-		const denySet = new Set(denyFields ?? []);
+		const denySet = new Set([...DEFAULT_IMPORT_MANAGED_FIELDS, ...denyFields ?? []]);
 		return Object.keys(shape).filter((key) => !denySet.has(key));
 	}, [resolvedSchema, denyFields]);
 	const handleExport = React.useCallback(async (mode) => {
@@ -6554,15 +6602,21 @@ function AutoCrudTable({ id, title, description, schema, resource, fields, table
 		tableConfig?.overrides,
 		dynamicFilterOptions
 	]);
+	const defaultSort = React.useMemo(() => resource.defaultSort ?? tableConfig?.defaultSort ?? getDefaultSortingForSchema(resolvedSchema), [
+		resource.defaultSort,
+		resolvedSchema,
+		tableConfig?.defaultSort
+	]);
 	const formOverrides = React.useMemo(() => buildFormOverrides(resolvedFields, formConfig?.overrides, denyFields), [
 		resolvedFields,
 		formConfig?.overrides,
 		denyFields
 	]);
-	const hiddenColumns = React.useMemo(() => buildHiddenColumns(resolvedFields, tableConfig?.hidden, denyFields), [
+	const hiddenColumns = React.useMemo(() => buildHiddenColumns(resolvedFields, tableConfig?.hidden, denyFields, tableConfig?.overrides), [
 		resolvedFields,
 		tableConfig?.hidden,
-		denyFields
+		denyFields,
+		tableConfig?.overrides
 	]);
 	const searchConfig = React.useMemo(() => {
 		const tableSearch = tableConfig?.search;
@@ -6710,7 +6764,7 @@ function AutoCrudTable({ id, title, description, schema, resource, fields, table
 				deleteConfirmation: locale.bulkDeleteModal,
 				enableExport: canExport,
 				showDefaultExport: false,
-				initialSorting: tableConfig?.defaultSort,
+				initialSorting: defaultSort,
 				onSelectedRowsChange: handleSelectedRowsChange,
 				getSelectedRows: getSelectedRowsRef
 			}),
@@ -7512,7 +7566,7 @@ function modalReducer(state, action$1) {
 * Hook 主函数
 */
 function useAutoCrudResource({ router, schema, query: queryTransform, options = {} }) {
-	const { idKey = "id", defaultVariant = "dialog", hooks, toast: toastAdapter, exportFetcher } = options;
+	const { idKey = "id", defaultVariant = "dialog", hooks, toast: toastAdapter, exportFetcher, defaultSort: defaultSortOption } = options;
 	const toast$1 = useMemo(() => toastAdapter === false ? noopToastAdapter : toastAdapter ?? defaultToastAdapter, [toastAdapter]);
 	const hooksRef = useRef(hooks);
 	useEffect(() => {
@@ -7520,12 +7574,13 @@ function useAutoCrudResource({ router, schema, query: queryTransform, options =
 	}, [hooks]);
 	const metadata = (router.meta?.useQuery(void 0, { staleTime: 3e4 }))?.data;
 	const resolvedSchema = useMemo(() => mergeMetadataSchema(schema, metadata?.schema), [schema, metadata?.schema]);
+	const defaultSorting = useMemo(() => defaultSortOption === false ? [] : defaultSortOption ?? getDefaultSortingForSchema(resolvedSchema), [defaultSortOption, resolvedSchema]);
 	const metadataFields = useMemo(() => readMetadataFields(metadata?.fields), [metadata?.fields]);
 	const columns = useMemo(() => createTableSchema(resolvedSchema), [resolvedSchema]);
 	const [urlParams] = useQueryStates({
 		page: parseAsInteger.withDefault(1),
 		perPage: parseAsInteger.withDefault(10),
-		sort: getSortingStateParser().withDefault([]),
+		sort: getSortingStateParser().withDefault(defaultSorting),
 		joinOperator: parseAsStringEnum(["and", "or"]).withDefault("and"),
 		search: parseAsString.withDefault("")
 	}, { shallow: false });
@@ -7813,6 +7868,7 @@ function useAutoCrudResource({ router, schema, query: queryTransform, options =
 		},
 		schema: resolvedSchema,
 		fields: metadataFields,
+		defaultSort: defaultSorting,
 		modal,
 		mutations: {
 			isCreating: createMutation.isPending,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wordrhyme/auto-crud",
   "type": "module",
-  "version": "1.3.6",
+  "version": "1.3.8",
   "description": "Schema-first CRUD components with auto-generated tables and forms",
   "author": "wordrhyme",
   "license": "MIT",
@@ -63,8 +63,8 @@
     "tailwind-merge": "^3.5.0",
     "vaul": "^1.1.2",
     "@wordrhyme/formily-shadcn": "1.12.9",
-    "@wordrhyme/shadcn-ui": "1.32.4",
-    "@wordrhyme/shadcn": "1.3.2"
+    "@wordrhyme/shadcn": "1.3.2",
+    "@wordrhyme/shadcn-ui": "1.32.4"
   },
   "devDependencies": {
     "@tanstack/react-query": "^5.90.15",