@wordrhyme/auto-crud 0.2.0 → 0.4.0

package/dist/index.cjs

@@ -4073,9 +4073,9 @@ function renderCell(value, type) {
 	}
 }
 /**
-* 从 Zod Schema 创建 ColumnDef 数组
+* 从 Zod Schema 创建 Table Schema (ColumnDef 数组)
 */
-function createColumns(schema, options) {
+function createTableSchema(schema, options) {
 	const shape = schema.shape;
 	const columns = [];
 	const { overrides, exclude = [] } = options ?? {};
@@ -4201,7 +4201,7 @@ const filterModeConfig = {
 		tooltip: "Linear-style command filters"
 	}
 };
-function AutoTable({ schema, data, pageCount = 1, overrides, enableRowSelection = true, exclude, actions, pinnedColumns, filterMode = "simple", onDeleteSelected, onUpdateSelected, batchUpdateFields, actionBarExtra, initialSorting }) {
+function AutoTable({ schema, data, pageCount = 1, overrides, enableRowSelection = true, exclude, actions, pinnedColumns, filterMode = "simple", onDeleteSelected, onUpdateSelected, batchUpdateFields, actionBarExtra, initialSorting, enableExport = true }) {
 	const modes = filterMode ? Array.isArray(filterMode) ? filterMode : [filterMode] : [
 		"simple",
 		"advanced",
@@ -4212,7 +4212,7 @@ function AutoTable({ schema, data, pageCount = 1, overrides, enableRowSelection
 	const { table, shallow, debounceMs, throttleMs } = useDataTable({
 		data,
 		columns: (0, react.useMemo)(() => {
-			const dataColumns = createColumns(schema, {
+			const dataColumns = createTableSchema(schema, {
 				overrides,
 				exclude
 			});
@@ -4318,6 +4318,7 @@ function AutoTable({ schema, data, pageCount = 1, overrides, enableRowSelection
 				onUpdateSelected,
 				batchUpdateFields,
 				enableDelete: !!onDeleteSelected,
+				enableExport,
 				extraActions: actionBarExtra
 			})
 		]
@@ -4599,8 +4600,8 @@ function buildFormOverrides(fields, legacyOverrides) {
 /**
 * 从统一配置生成隐藏列列表
 */
-function buildHiddenColumns(fields, legacyHidden) {
-	const hidden = new Set(legacyHidden ?? []);
+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);
 	}
@@ -4715,10 +4716,16 @@ function ViewModal({ open, onOpenChange, variant, data, schema, fields: fieldCon
 *
 * 高级 CRUD 表格组件，封装了完整的增删改查流程
 */
-function AutoCrudTable({ title, description, schema, resource, fields, table: tableConfig, form: formConfig, slots }) {
+function AutoCrudTable({ title, description, schema, resource, fields, table: tableConfig, form: formConfig, slots, permissions }) {
+	const can = {
+		create: permissions?.can?.create ?? true,
+		update: permissions?.can?.update ?? true,
+		delete: permissions?.can?.delete ?? true,
+		export: permissions?.can?.export ?? true
+	};
 	const tableOverrides = buildTableOverrides(fields, tableConfig?.overrides);
 	const formOverrides = buildFormOverrides(fields, formConfig?.overrides);
-	const hiddenColumns = buildHiddenColumns(fields, tableConfig?.hidden);
+	const hiddenColumns = buildHiddenColumns(fields, tableConfig?.hidden, permissions?.deny);
 	const batchFields = buildBatchUpdateFields(schema, tableConfig?.batchFields, fields);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 		className: "space-y-4",
@@ -4740,7 +4747,7 @@ function AutoCrudTable({ title, description, schema, resource, fields, table: ta
 					children: slots?.toolbarStart
 				}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 					className: "flex items-center gap-2",
-					children: [slots?.toolbarEnd, /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__pixpilot_shadcn.Button, {
+					children: [slots?.toolbarEnd, can.create && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__pixpilot_shadcn.Button, {
 						onClick: resource.handlers.openCreate,
 						children: "新建"
 					})]
@@ -4755,13 +4762,14 @@ function AutoCrudTable({ title, description, schema, resource, fields, table: ta
 				filterMode: tableConfig?.filterModes,
 				actions: {
 					onView: resource.handlers.openView,
-					onEdit: resource.handlers.openEdit,
-					onCopy: resource.handlers.copyRow,
-					onDelete: resource.handlers.openDelete
+					onEdit: can.update ? resource.handlers.openEdit : void 0,
+					onCopy: can.create ? resource.handlers.copyRow : void 0,
+					onDelete: can.delete ? resource.handlers.openDelete : void 0
 				},
-				onDeleteSelected: resource.handlers.deleteMany,
-				onUpdateSelected: resource.handlers.updateMany,
-				batchUpdateFields: batchFields,
+				onDeleteSelected: can.delete ? resource.handlers.deleteMany : void 0,
+				onUpdateSelected: can.update ? resource.handlers.updateMany : void 0,
+				batchUpdateFields: can.update ? batchFields : void 0,
+				enableExport: can.export,
 				initialSorting: tableConfig?.defaultSort
 			}),
 			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(CrudFormModal, {
@@ -6040,12 +6048,12 @@ exports.DataTableViewOptions = DataTableViewOptions;
 exports.SchemaAdapter = SchemaAdapter;
 exports.cn = cn;
 exports.createActionsColumn = createActionsColumn;
-exports.createColumns = createColumns;
 exports.createEditFormSchema = createEditFormSchema;
 exports.createFormSchema = createFormSchema;
 exports.createMemoryDataSource = createMemoryDataSource;
 exports.createSelectColumn = createSelectColumn;
 exports.createTRPCDataSource = createTRPCDataSource;
+exports.createTableSchema = createTableSchema;
 exports.formatDate = formatDate;
 exports.getUrlParams = getUrlParams;
 exports.humanize = humanize;

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime8 from "react/jsx-runtime";
+import * as react_jsx_runtime2 from "react/jsx-runtime";
 import { z } from "zod";
 import * as _tanstack_react_table0 from "@tanstack/react-table";
 import { Column, ColumnDef, ColumnSort, Row, RowData, Table, TableOptions, TableState } from "@tanstack/react-table";
@@ -164,6 +164,50 @@ declare function useAutoCrudResource<TSchema extends z.ZodObject<z.ZodRawShape>,
   options
 }: UseAutoCrudResourceParams<TSchema, TListItem>): UseAutoCrudResourceReturn<TSchema, TListItem>;
 //#endregion
+//#region src/types/permissions.d.ts
+/**
+ * CRUD 操作权限
+ * 控制工具栏按钮、行操作按钮、批量操作按钮的显示
+ */
+interface CrudOperationPermissions {
+  /** 是否允许创建（新建按钮、复制行操作） */
+  create?: boolean;
+  /** 是否允许更新（编辑按钮、批量更新） */
+  update?: boolean;
+  /** 是否允许删除（删除按钮、批量删除） */
+  delete?: boolean;
+  /** 是否允许导出 */
+  export?: boolean;
+}
+/**
+ * AutoCrudTable 权限配置
+ *
+ * @example
+ * ```tsx
+ * const permissions = useMemo(() => ({
+ *   can: {
+ *     create: user.role === 'admin',
+ *     update: user.role === 'admin' || user.role === 'editor',
+ *     delete: user.role === 'admin',
+ *     export: true,
+ *   },
+ *   deny: user.role === 'user' ? ['salary', 'ssn'] : [],
+ * }), [user.role]);
+ *
+ * <AutoCrudTable
+ *   schema={employeeSchema}
+ *   resource={resource}
+ *   permissions={permissions}
+ * />
+ * ```
+ */
+interface CrudPermissions {
+  /** 操作权限（默认全部为 true） */
+  can?: CrudOperationPermissions;
+  /** 禁止访问的字段列表（表格列和表单字段都会隐藏） */
+  deny?: string[];
+}
+//#endregion
 //#region src/components/auto-crud/auto-table-action-bar.d.ts
 /** 批量更新字段配置 */
 interface BatchUpdateField {
@@ -199,7 +243,7 @@ declare function AutoTableActionBar<TData>({
   enableExport,
   enableDelete,
   extraActions
-}: AutoTableActionBarProps<TData>): react_jsx_runtime8.JSX.Element;
+}: AutoTableActionBarProps<TData>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/lib/schema-bridge/types.d.ts
 /**
@@ -232,9 +276,9 @@ type ColumnOverrides<T> = Partial<{ [K in keyof T]: Partial<ColumnDef<T, unknown
  */
 type FormSchemaOverrides = Record<string, Partial<ISchema>>;
 /**
- * createColumns 选项
+ * createTableSchema 选项
  */
-interface CreateColumnsOptions<T> {
+interface CreateTableSchemaOptions<T> {
   overrides?: ColumnOverrides<T>;
   exclude?: (keyof T)[];
 }
@@ -269,9 +313,9 @@ interface EnumOption {
  */
 declare function parseZodField(schema: z.ZodType): ParsedZodField;
 /**
- * 从 Zod Schema 创建 ColumnDef 数组
+ * 从 Zod Schema 创建 Table Schema (ColumnDef 数组)
  */
-declare function createColumns<T extends z.ZodObject<z.ZodRawShape>>(schema: T, options?: CreateColumnsOptions<z.infer<T>>): ColumnDef<z.infer<T>>[];
+declare function createTableSchema<T extends z.ZodObject<z.ZodRawShape>>(schema: T, options?: CreateTableSchemaOptions<z.infer<T>>): ColumnDef<z.infer<T>>[];
 /**
  * 创建选择列
  */
@@ -323,6 +367,8 @@ interface AutoTableProps<T extends z.ZodObject<z.ZodRawShape>> {
   actionBarExtra?: React.ReactNode;
   /** 初始排序 */
   initialSorting?: any[];
+  /** 是否启用导出功能 (默认 true) */
+  enableExport?: boolean;
 }
 declare function AutoTable<T extends z.ZodObject<z.ZodRawShape>>({
   schema,
@@ -338,8 +384,9 @@ declare function AutoTable<T extends z.ZodObject<z.ZodRawShape>>({
   onUpdateSelected,
   batchUpdateFields,
   actionBarExtra,
-  initialSorting
-}: AutoTableProps<T>): react_jsx_runtime8.JSX.Element;
+  initialSorting,
+  enableExport
+}: AutoTableProps<T>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/auto-crud-table.d.ts
 /**
@@ -430,6 +477,26 @@ interface AutoCrudTableProps<TSchema extends z.ZodObject<z.ZodRawShape>> {
       onClick: () => void;
     }>;
   };
+  /**
+   * 权限配置
+   * 控制按钮显示和字段访问
+   *
+   * @example
+   * ```tsx
+   * const permissions = useMemo(() => ({
+   *   can: {
+   *     create: user.role === 'admin',
+   *     update: user.role === 'admin' || user.role === 'editor',
+   *     delete: user.role === 'admin',
+   *     export: true,
+   *   },
+   *   deny: user.role === 'user' ? ['salary', 'ssn'] : [],
+   * }), [user.role]);
+   *
+   * <AutoCrudTable permissions={permissions} ... />
+   * ```
+   */
+  permissions?: CrudPermissions;
 }
 /**
  * AutoCrudTable 组件
@@ -444,8 +511,9 @@ declare function AutoCrudTable<TSchema extends z.ZodObject<z.ZodRawShape>>({
   fields,
   table: tableConfig,
   form: formConfig,
-  slots
-}: AutoCrudTableProps<TSchema>): react_jsx_runtime8.JSX.Element;
+  slots,
+  permissions
+}: 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>> {
@@ -477,7 +545,7 @@ declare function AutoFormInner<T extends z.ZodObject<z.ZodRawShape>>({
   labelAlign,
   labelWidth,
   showSubmitButton
-}: AutoFormProps<T>, ref: React.Ref<AutoFormRef>): react_jsx_runtime8.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>;
@@ -691,12 +759,12 @@ declare const filterItemSchema: z.ZodObject<{
   variant: z.ZodEnum<{
     number: "number";
     boolean: "boolean";
-    text: "text";
-    range: "range";
     date: "date";
-    dateRange: "dateRange";
+    text: "text";
     select: "select";
     multiSelect: "multiSelect";
+    dateRange: "dateRange";
+    range: "range";
   }>;
   operator: z.ZodEnum<{
     iLike: "iLike";
@@ -772,7 +840,7 @@ declare function AutoTableSimpleFilters<TData>({
   shallow,
   filters: externalFilters,
   onFiltersChange
-}: AutoTableSimpleFiltersProps<TData>): react_jsx_runtime8.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";
@@ -807,7 +875,7 @@ declare function CrudFormModal<T extends z.ZodObject<z.ZodRawShape>>({
   title,
   labelAlign,
   labelWidth
-}: CrudFormModalProps<T>): react_jsx_runtime8.JSX.Element;
+}: CrudFormModalProps<T>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table.d.ts
 interface DataTableProps<TData> extends React$1.ComponentProps<"div"> {
@@ -820,7 +888,7 @@ declare function DataTable<TData>({
   children,
   className,
   ...props
-}: DataTableProps<TData>): react_jsx_runtime8.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"> {
@@ -831,7 +899,7 @@ declare function DataTableAdvancedToolbar<TData>({
   children,
   className,
   ...props
-}: DataTableAdvancedToolbarProps<TData>): react_jsx_runtime8.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> {
@@ -843,7 +911,7 @@ declare function DataTableColumnHeader<TData, TValue>({
   label,
   className,
   ...props
-}: DataTableColumnHeaderProps<TData, TValue>): react_jsx_runtime8.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> {
@@ -857,7 +925,7 @@ declare function DataTableFacetedFilter<TData, TValue>({
   title,
   options,
   multiple
-}: DataTableFacetedFilterProps<TData, TValue>): react_jsx_runtime8.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"> {
@@ -869,7 +937,7 @@ declare function DataTablePagination<TData>({
   pageSizeOptions,
   className,
   ...props
-}: DataTablePaginationProps<TData>): react_jsx_runtime8.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"> {
@@ -880,7 +948,7 @@ declare function DataTableToolbar<TData>({
   children,
   className,
   ...props
-}: DataTableToolbarProps<TData>): react_jsx_runtime8.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> {
@@ -891,7 +959,7 @@ declare function DataTableViewOptions<TData>({
   table,
   disabled,
   ...props
-}: DataTableViewOptionsProps<TData>): react_jsx_runtime8.JSX.Element;
+}: DataTableViewOptionsProps<TData>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/hooks/use-data-table.d.ts
 interface UseDataTableProps<TData> extends Omit<TableOptions<TData>, "state" | "pageCount" | "getCoreRowModel" | "manualFiltering" | "manualPagination" | "manualSorting">, Required<Pick<TableOptions<TData>, "pageCount">> {
@@ -1162,4 +1230,4 @@ declare function formatDate(date: Date | string | number | undefined, opts?: Int
  */
 declare function humanize(str: string): string;
 //#endregion
-export { type ActionsColumnConfig, AutoCrudTable, type AutoCrudTableProps, AutoForm, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, type ColumnOverrides, type CreateColumnsOptions, type CreateFormSchemaOptions, CrudFormModal, type CrudHooks, type DataSource, DataTable, DataTableAdvancedToolbar, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableRowAction, DataTableToolbar, DataTableViewOptions, type EnumOption, ExtendedColumnFilter, ExtendedColumnSort, type Field, type FieldType, type Fields, FilterOperator, type FilterVariant, type FormSchemaOverrides, type JSONSchema, type JSONSchemaProperty, JoinOperator, type ListParams, type ListResult, Option, type ParsedZodField, type Parser, QueryKeys, SchemaAdapter, type SimpleFieldConfig, type SimpleFieldsConfig, type ToastAdapter, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, cn, createActionsColumn, createColumns, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, formatDate, getUrlParams, humanize, noopToastAdapter, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseZodField, setSearchParams, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates };
+export { type ActionsColumnConfig, AutoCrudTable, type AutoCrudTableProps, AutoForm, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, type ColumnOverrides, type CreateFormSchemaOptions, type CreateTableSchemaOptions, CrudFormModal, type CrudHooks, type CrudOperationPermissions, type CrudPermissions, type DataSource, DataTable, DataTableAdvancedToolbar, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableRowAction, DataTableToolbar, DataTableViewOptions, type EnumOption, ExtendedColumnFilter, ExtendedColumnSort, type Field, type FieldType, type Fields, FilterOperator, type FilterVariant, type FormSchemaOverrides, type JSONSchema, type JSONSchemaProperty, JoinOperator, type ListParams, type ListResult, Option, type ParsedZodField, type Parser, QueryKeys, SchemaAdapter, type SimpleFieldConfig, type SimpleFieldsConfig, type ToastAdapter, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, cn, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, formatDate, getUrlParams, humanize, noopToastAdapter, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseZodField, setSearchParams, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates };

package/dist/index.d.ts

@@ -164,6 +164,50 @@ declare function useAutoCrudResource<TSchema extends z.ZodObject<z.ZodRawShape>,
   options
 }: UseAutoCrudResourceParams<TSchema, TListItem>): UseAutoCrudResourceReturn<TSchema, TListItem>;
 //#endregion
+//#region src/types/permissions.d.ts
+/**
+ * CRUD 操作权限
+ * 控制工具栏按钮、行操作按钮、批量操作按钮的显示
+ */
+interface CrudOperationPermissions {
+  /** 是否允许创建（新建按钮、复制行操作） */
+  create?: boolean;
+  /** 是否允许更新（编辑按钮、批量更新） */
+  update?: boolean;
+  /** 是否允许删除（删除按钮、批量删除） */
+  delete?: boolean;
+  /** 是否允许导出 */
+  export?: boolean;
+}
+/**
+ * AutoCrudTable 权限配置
+ *
+ * @example
+ * ```tsx
+ * const permissions = useMemo(() => ({
+ *   can: {
+ *     create: user.role === 'admin',
+ *     update: user.role === 'admin' || user.role === 'editor',
+ *     delete: user.role === 'admin',
+ *     export: true,
+ *   },
+ *   deny: user.role === 'user' ? ['salary', 'ssn'] : [],
+ * }), [user.role]);
+ *
+ * <AutoCrudTable
+ *   schema={employeeSchema}
+ *   resource={resource}
+ *   permissions={permissions}
+ * />
+ * ```
+ */
+interface CrudPermissions {
+  /** 操作权限（默认全部为 true） */
+  can?: CrudOperationPermissions;
+  /** 禁止访问的字段列表（表格列和表单字段都会隐藏） */
+  deny?: string[];
+}
+//#endregion
 //#region src/components/auto-crud/auto-table-action-bar.d.ts
 /** 批量更新字段配置 */
 interface BatchUpdateField {
@@ -232,9 +276,9 @@ type ColumnOverrides<T> = Partial<{ [K in keyof T]: Partial<ColumnDef<T, unknown
  */
 type FormSchemaOverrides = Record<string, Partial<ISchema>>;
 /**
- * createColumns 选项
+ * createTableSchema 选项
  */
-interface CreateColumnsOptions<T> {
+interface CreateTableSchemaOptions<T> {
   overrides?: ColumnOverrides<T>;
   exclude?: (keyof T)[];
 }
@@ -269,9 +313,9 @@ interface EnumOption {
  */
 declare function parseZodField(schema: z.ZodType): ParsedZodField;
 /**
- * 从 Zod Schema 创建 ColumnDef 数组
+ * 从 Zod Schema 创建 Table Schema (ColumnDef 数组)
  */
-declare function createColumns<T extends z.ZodObject<z.ZodRawShape>>(schema: T, options?: CreateColumnsOptions<z.infer<T>>): ColumnDef<z.infer<T>>[];
+declare function createTableSchema<T extends z.ZodObject<z.ZodRawShape>>(schema: T, options?: CreateTableSchemaOptions<z.infer<T>>): ColumnDef<z.infer<T>>[];
 /**
  * 创建选择列
  */
@@ -323,6 +367,8 @@ interface AutoTableProps<T extends z.ZodObject<z.ZodRawShape>> {
   actionBarExtra?: React.ReactNode;
   /** 初始排序 */
   initialSorting?: any[];
+  /** 是否启用导出功能 (默认 true) */
+  enableExport?: boolean;
 }
 declare function AutoTable<T extends z.ZodObject<z.ZodRawShape>>({
   schema,
@@ -338,7 +384,8 @@ declare function AutoTable<T extends z.ZodObject<z.ZodRawShape>>({
   onUpdateSelected,
   batchUpdateFields,
   actionBarExtra,
-  initialSorting
+  initialSorting,
+  enableExport
 }: AutoTableProps<T>): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/auto-crud-table.d.ts
@@ -430,6 +477,26 @@ interface AutoCrudTableProps<TSchema extends z.ZodObject<z.ZodRawShape>> {
       onClick: () => void;
     }>;
   };
+  /**
+   * 权限配置
+   * 控制按钮显示和字段访问
+   *
+   * @example
+   * ```tsx
+   * const permissions = useMemo(() => ({
+   *   can: {
+   *     create: user.role === 'admin',
+   *     update: user.role === 'admin' || user.role === 'editor',
+   *     delete: user.role === 'admin',
+   *     export: true,
+   *   },
+   *   deny: user.role === 'user' ? ['salary', 'ssn'] : [],
+   * }), [user.role]);
+   *
+   * <AutoCrudTable permissions={permissions} ... />
+   * ```
+   */
+  permissions?: CrudPermissions;
 }
 /**
  * AutoCrudTable 组件
@@ -444,7 +511,8 @@ declare function AutoCrudTable<TSchema extends z.ZodObject<z.ZodRawShape>>({
   fields,
   table: tableConfig,
   form: formConfig,
-  slots
+  slots,
+  permissions
 }: AutoCrudTableProps<TSchema>): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/auto-form.d.ts
@@ -691,12 +759,12 @@ declare const filterItemSchema: z.ZodObject<{
   variant: z.ZodEnum<{
     number: "number";
     boolean: "boolean";
-    text: "text";
-    range: "range";
     date: "date";
-    dateRange: "dateRange";
+    text: "text";
     select: "select";
     multiSelect: "multiSelect";
+    dateRange: "dateRange";
+    range: "range";
   }>;
   operator: z.ZodEnum<{
     iLike: "iLike";
@@ -1162,4 +1230,4 @@ declare function formatDate(date: Date | string | number | undefined, opts?: Int
  */
 declare function humanize(str: string): string;
 //#endregion
-export { type ActionsColumnConfig, AutoCrudTable, type AutoCrudTableProps, AutoForm, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, type ColumnOverrides, type CreateColumnsOptions, type CreateFormSchemaOptions, CrudFormModal, type CrudHooks, type DataSource, DataTable, DataTableAdvancedToolbar, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableRowAction, DataTableToolbar, DataTableViewOptions, type EnumOption, ExtendedColumnFilter, ExtendedColumnSort, type Field, type FieldType, type Fields, FilterOperator, type FilterVariant, type FormSchemaOverrides, type JSONSchema, type JSONSchemaProperty, JoinOperator, type ListParams, type ListResult, Option, type ParsedZodField, type Parser, QueryKeys, SchemaAdapter, type SimpleFieldConfig, type SimpleFieldsConfig, type ToastAdapter, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, cn, createActionsColumn, createColumns, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, formatDate, getUrlParams, humanize, noopToastAdapter, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseZodField, setSearchParams, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates };
+export { type ActionsColumnConfig, AutoCrudTable, type AutoCrudTableProps, AutoForm, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, type ColumnOverrides, type CreateFormSchemaOptions, type CreateTableSchemaOptions, CrudFormModal, type CrudHooks, type CrudOperationPermissions, type CrudPermissions, type DataSource, DataTable, DataTableAdvancedToolbar, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableRowAction, DataTableToolbar, DataTableViewOptions, type EnumOption, ExtendedColumnFilter, ExtendedColumnSort, type Field, type FieldType, type Fields, FilterOperator, type FilterVariant, type FormSchemaOverrides, type JSONSchema, type JSONSchemaProperty, JoinOperator, type ListParams, type ListResult, Option, type ParsedZodField, type Parser, QueryKeys, SchemaAdapter, type SimpleFieldConfig, type SimpleFieldsConfig, type ToastAdapter, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, cn, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, formatDate, getUrlParams, humanize, noopToastAdapter, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseZodField, setSearchParams, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates };

package/dist/index.js

@@ -4031,9 +4031,9 @@ function renderCell(value, type) {
 	}
 }
 /**
-* 从 Zod Schema 创建 ColumnDef 数组
+* 从 Zod Schema 创建 Table Schema (ColumnDef 数组)
 */
-function createColumns(schema, options) {
+function createTableSchema(schema, options) {
 	const shape = schema.shape;
 	const columns = [];
 	const { overrides, exclude = [] } = options ?? {};
@@ -4159,7 +4159,7 @@ const filterModeConfig = {
 		tooltip: "Linear-style command filters"
 	}
 };
-function AutoTable({ schema, data, pageCount = 1, overrides, enableRowSelection = true, exclude, actions, pinnedColumns, filterMode = "simple", onDeleteSelected, onUpdateSelected, batchUpdateFields, actionBarExtra, initialSorting }) {
+function AutoTable({ schema, data, pageCount = 1, overrides, enableRowSelection = true, exclude, actions, pinnedColumns, filterMode = "simple", onDeleteSelected, onUpdateSelected, batchUpdateFields, actionBarExtra, initialSorting, enableExport = true }) {
 	const modes = filterMode ? Array.isArray(filterMode) ? filterMode : [filterMode] : [
 		"simple",
 		"advanced",
@@ -4170,7 +4170,7 @@ function AutoTable({ schema, data, pageCount = 1, overrides, enableRowSelection
 	const { table, shallow, debounceMs, throttleMs } = useDataTable({
 		data,
 		columns: useMemo(() => {
-			const dataColumns = createColumns(schema, {
+			const dataColumns = createTableSchema(schema, {
 				overrides,
 				exclude
 			});
@@ -4276,6 +4276,7 @@ function AutoTable({ schema, data, pageCount = 1, overrides, enableRowSelection
 				onUpdateSelected,
 				batchUpdateFields,
 				enableDelete: !!onDeleteSelected,
+				enableExport,
 				extraActions: actionBarExtra
 			})
 		]
@@ -4557,8 +4558,8 @@ function buildFormOverrides(fields, legacyOverrides) {
 /**
 * 从统一配置生成隐藏列列表
 */
-function buildHiddenColumns(fields, legacyHidden) {
-	const hidden = new Set(legacyHidden ?? []);
+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);
 	}
@@ -4673,10 +4674,16 @@ function ViewModal({ open, onOpenChange, variant, data, schema, fields: fieldCon
 *
 * 高级 CRUD 表格组件，封装了完整的增删改查流程
 */
-function AutoCrudTable({ title, description, schema, resource, fields, table: tableConfig, form: formConfig, slots }) {
+function AutoCrudTable({ title, description, schema, resource, fields, table: tableConfig, form: formConfig, slots, permissions }) {
+	const can = {
+		create: permissions?.can?.create ?? true,
+		update: permissions?.can?.update ?? true,
+		delete: permissions?.can?.delete ?? true,
+		export: permissions?.can?.export ?? true
+	};
 	const tableOverrides = buildTableOverrides(fields, tableConfig?.overrides);
 	const formOverrides = buildFormOverrides(fields, formConfig?.overrides);
-	const hiddenColumns = buildHiddenColumns(fields, tableConfig?.hidden);
+	const hiddenColumns = buildHiddenColumns(fields, tableConfig?.hidden, permissions?.deny);
 	const batchFields = buildBatchUpdateFields(schema, tableConfig?.batchFields, fields);
 	return /* @__PURE__ */ jsxs("div", {
 		className: "space-y-4",
@@ -4698,7 +4705,7 @@ function AutoCrudTable({ title, description, schema, resource, fields, table: ta
 					children: slots?.toolbarStart
 				}), /* @__PURE__ */ jsxs("div", {
 					className: "flex items-center gap-2",
-					children: [slots?.toolbarEnd, /* @__PURE__ */ jsx(Button, {
+					children: [slots?.toolbarEnd, can.create && /* @__PURE__ */ jsx(Button, {
 						onClick: resource.handlers.openCreate,
 						children: "新建"
 					})]
@@ -4713,13 +4720,14 @@ function AutoCrudTable({ title, description, schema, resource, fields, table: ta
 				filterMode: tableConfig?.filterModes,
 				actions: {
 					onView: resource.handlers.openView,
-					onEdit: resource.handlers.openEdit,
-					onCopy: resource.handlers.copyRow,
-					onDelete: resource.handlers.openDelete
+					onEdit: can.update ? resource.handlers.openEdit : void 0,
+					onCopy: can.create ? resource.handlers.copyRow : void 0,
+					onDelete: can.delete ? resource.handlers.openDelete : void 0
 				},
-				onDeleteSelected: resource.handlers.deleteMany,
-				onUpdateSelected: resource.handlers.updateMany,
-				batchUpdateFields: batchFields,
+				onDeleteSelected: can.delete ? resource.handlers.deleteMany : void 0,
+				onUpdateSelected: can.update ? resource.handlers.updateMany : void 0,
+				batchUpdateFields: can.update ? batchFields : void 0,
+				enableExport: can.export,
 				initialSorting: tableConfig?.defaultSort
 			}),
 			/* @__PURE__ */ jsx(CrudFormModal, {
@@ -5982,4 +5990,4 @@ function createMemoryDataSource(initialData = []) {
 }
 
 //#endregion
-export { AutoCrudTable, AutoForm, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, CrudFormModal, DataTable, DataTableAdvancedToolbar, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableToolbar, DataTableViewOptions, SchemaAdapter, cn, createActionsColumn, createColumns, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, formatDate, getUrlParams, humanize, noopToastAdapter, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseZodField, setSearchParams, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates };
+export { AutoCrudTable, AutoForm, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, CrudFormModal, DataTable, DataTableAdvancedToolbar, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableToolbar, DataTableViewOptions, SchemaAdapter, cn, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, formatDate, getUrlParams, humanize, noopToastAdapter, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseZodField, setSearchParams, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wordrhyme/auto-crud",
   "type": "module",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Schema-first CRUD components with auto-generated tables and forms",
   "author": "wordrhyme",
   "license": "MIT",
@@ -66,8 +66,8 @@
     "tailwind-merge": "^3.4.0",
     "vaul": "^1.1.2",
     "@pixpilot/formily-shadcn": "0.44.3",
-    "@pixpilot/shadcn": "0.9.0",
-    "@pixpilot/shadcn-ui": "0.47.0"
+    "@pixpilot/shadcn-ui": "0.47.0",
+    "@pixpilot/shadcn": "0.9.0"
   },
   "devDependencies": {
     "@tanstack/react-query": "^5.90.15",
@@ -81,10 +81,10 @@
     "react-dom": "19.2.4",
     "tsdown": "^0.15.12",
     "typescript": "^5.9.3",
+    "@internal/tsconfig": "0.1.0",
     "@internal/eslint-config": "0.3.0",
-    "@internal/prettier-config": "0.0.1",
     "@internal/tsdown-config": "0.1.0",
-    "@internal/tsconfig": "0.1.0",
+    "@internal/prettier-config": "0.0.1",
     "@internal/vitest-config": "0.1.0"
   },
   "prettier": "@internal/prettier-config",