@wordrhyme/auto-crud 1.5.7 → 1.7.0

package/dist/index.d.ts

@@ -1,10 +1,11 @@
 import * as React$1 from "react";
 import * as _tanstack_react_table0 from "@tanstack/react-table";
-import { Column, ColumnDef, ColumnSort, Row, RowData, Table, TableOptions, TableState } from "@tanstack/react-table";
+import { Column, ColumnDef, ColumnMeta, ColumnSort, Row, RowData, Table, TableOptions, TableState } from "@tanstack/react-table";
 import { DropdownMenuTrigger, PopoverContent } from "@wordrhyme/shadcn";
 import { ClassValue } from "clsx";
 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 { DropdownMenuItem as DropdownMenuItem$1 } from "@wordrhyme/ui";
 import { z } from "zod";
 import { JsonSchemaFormScope } from "@wordrhyme/formily-shadcn";
 import { ISchema } from "@formily/json-schema";
@@ -326,1113 +327,1164 @@ interface CrudPermissions {
   deny?: string[];
 }
 //#endregion
-//#region src/components/auto-crud/auto-table-action-bar.d.ts
-/** 批量更新字段配置 */
-interface BatchUpdateField {
-  /** 字段名 */
-  field: string;
-  /** 显示标签 */
-  label: string;
-  /** 可选值 */
-  options: Array<{
-    label: string;
-    value: string;
-  }>;
+//#region src/hooks/use-url-state.d.ts
+/**
+ * URL 状态管理 Hook - 替代 nuqs
+ * 将 React 状态同步到 URL query string
+ *
+ * 架构说明：
+ * - 使用 queueMicrotask 延迟 URL 更新，确保在渲染完成后执行
+ * - 符合 React 渲染规则，不会触发 "Cannot update a component while rendering" 错误
+ */
+interface UrlStateOptions {
+  /** 历史记录模式: push 添加新记录, replace 替换当前记录 */
+  history?: 'push' | 'replace';
+  /** 是否浅层更新（不触发页面刷新） */
+  shallow?: boolean;
+  /** 节流时间（毫秒） */
+  throttleMs?: number;
+  /** 防抖时间（毫秒） */
+  debounceMs?: number;
+  /** 当值等于默认值时是否清除 URL 参数 */
+  clearOnDefault?: boolean;
+  /** 滚动到顶部 */
+  scroll?: boolean;
+  /** React transition */
+  startTransition?: React$1.TransitionStartFunction;
 }
-interface BatchActionContext<TData> {
-  /** 选中的原始行数据 */
-  rows: TData[];
-  /** TanStack Table 实例 */
-  table: Table<TData>;
-  /** 清空当前选择 */
-  clearSelection: () => void;
+interface Parser<T> {
+  parse: (value: string) => T;
+  serialize: (value: T) => string;
 }
-type BatchBuiltinActionType = 'batchUpdate' | 'export' | 'delete';
-type BatchActionMeta = {
-  id?: string;
-  order?: number;
-  hidden?: boolean;
+declare const parseAsInteger: Parser<number> & {
+  withDefault: (defaultValue: number) => Parser<number> & {
+    defaultValue: number;
+  };
 };
-type BatchBuiltinActionItem<TData> = BatchActionMeta & {
-  type: BatchBuiltinActionType;
-  /** 替代默认行为 */
-  onClick?: (rows: TData[], context: BatchActionContext<TData>, event: React$1.MouseEvent<HTMLButtonElement>) => void;
-  /** 替代默认标签，仅对 export/delete 生效 */
-  label?: string;
-  /** 替代整个内置操作的渲染 */
-  component?: React$1.ReactNode | ((context: BatchActionContext<TData>) => React$1.ReactNode);
+declare const parseAsString: Parser<string> & {
+  withDefault: (defaultValue: string) => Parser<string> & {
+    defaultValue: string;
+  };
 };
-type BatchCustomActionItem<TData> = BatchActionMeta & {
-  type: 'custom';
-  /** 操作文本。传 component 时可省略 */
-  label?: string;
-  /** 自定义点击行为。传 component 时可省略 */
-  onClick?: (rows: TData[], context: BatchActionContext<TData>, event: React$1.MouseEvent<HTMLButtonElement>) => void;
-  /** 渲染自定义内容 */
-  component?: React$1.ReactNode | ((context: BatchActionContext<TData>) => React$1.ReactNode);
-  /** 仅在无内置项时生效：插入到首部还是尾部（默认 end） */
-  position?: 'start' | 'end';
-  variant?: 'default' | 'destructive';
+declare function parseAsStringEnum<T extends string>(validValues: readonly T[]): Parser<T | null> & {
+  withDefault: (defaultValue: T) => Parser<T> & {
+    defaultValue: T;
+  };
 };
-type BatchActionItem<TData> = BatchBuiltinActionItem<TData> | BatchCustomActionItem<TData>;
-type BatchActionConfig<TData> = BatchActionItem<TData>[] | ((defaults: BatchBuiltinActionItem<TData>[]) => BatchActionItem<TData>[]);
-interface BatchDeleteConfirmation {
-  title: string;
-  description: (count: number) => string;
-  cancel: string;
-  confirm: string;
-}
-interface AutoTableActionBarProps<TData> {
-  table: Table<TData>;
-  onDeleteSelected?: (rows: TData[]) => void;
-  /** 批量更新回调 */
-  onUpdateSelected?: (rows: TData[], data: Record<string, unknown>) => void;
-  /** 批量更新字段配置 */
-  batchUpdateFields?: BatchUpdateField[];
-  /** 是否启用导出功能 */
-  enableExport?: boolean;
-  /** 未配置 actions / 只配置 custom actions 时，是否展示默认导出按钮 */
-  showDefaultExport?: boolean;
-  /** 是否启用删除功能 */
-  enableDelete?: boolean;
-  /** 额外的操作按钮 */
-  extraActions?: React$1.ReactNode;
-  /** 批量操作配置，支持和行操作/顶部工具栏一致的顺序接管语义 */
-  actions?: BatchActionConfig<TData>;
-  /** 批量删除二次确认文案 */
-  deleteConfirmation?: BatchDeleteConfirmation;
-}
-declare function AutoTableActionBar<TData>({
-  table,
-  onDeleteSelected,
-  onUpdateSelected,
-  batchUpdateFields,
-  enableExport,
-  showDefaultExport,
-  enableDelete,
-  extraActions,
-  actions,
-  deleteConfirmation
-}: AutoTableActionBarProps<TData>): react_jsx_runtime2.JSX.Element;
-//#endregion
-//#region src/lib/schema-bridge/types.d.ts
-/**
- * 字段类型映射
- */
-type FieldType = 'string' | 'number' | 'boolean' | 'date' | 'enum' | 'array' | 'object';
-/**
- * DataTable Filter Variant
- */
-type FilterVariant = 'text' | 'number' | 'boolean' | 'select' | 'multiSelect' | 'date' | 'dateRange' | 'range';
-/**
- * 解析后的 Zod 字段信息
- */
-interface ParsedZodField {
-  type: FieldType;
-  required: boolean;
-  enumValues?: string[];
-  description?: string;
-  defaultValue?: unknown;
-}
-/**
- * 列定义覆盖选项
- */
-type ColumnOverrides<T> = Partial<{ [K in keyof T]: Partial<ColumnDef<T, unknown>> & {
-  hidden?: boolean;
-  label?: string;
-  index?: number;
-} }>;
-/**
- * Formily Schema 覆盖选项
- */
-type FormSchemaOverrides = Record<string, Partial<ISchema>>;
-/**
- * createTableSchema 选项
- */
-interface CreateTableSchemaOptions<T> {
-  overrides?: ColumnOverrides<T>;
-  exclude?: (keyof T)[];
-}
-/**
- * createFormSchema 选项
- */
-interface CreateFormSchemaOptions {
-  overrides?: FormSchemaOverrides;
-  exclude?: string[];
-  layout?: 'vertical' | 'horizontal' | 'grid';
-  gridColumns?: number;
-  /** Label 对齐方式 */
-  labelAlign?: 'left' | 'top' | 'right';
-  /** Label 宽度（labelAlign 为 left 时有效） */
-  labelWidth?: number | string;
-  /** Label 栅格占位 */
-  labelCol?: number;
-  /** 输入框栅格占位 */
-  wrapperCol?: number;
-}
-/**
- * Enum 选项类型
- */
-interface EnumOption {
-  label: string;
-  value: string;
-}
-//#endregion
-//#region src/lib/schema-bridge/zod-to-columns.d.ts
-/**
- * 解析 Zod 字段类型
- */
-declare function parseZodField(schema: z.ZodType): ParsedZodField;
-/**
- * 从 Zod Schema 创建 Table Schema (ColumnDef 数组)
- */
-declare function createTableSchema<T extends z.ZodObject<z.ZodRawShape>>(schema: T, options?: CreateTableSchemaOptions<z.infer<T>>): ColumnDef<z.infer<T>>[];
-/**
- * 创建选择列
- */
-declare function createSelectColumn<T>(): ColumnDef<T>;
+declare function parseAsArrayOf<T>(itemParser: Parser<T>, separator?: string): Parser<T[]> & {
+  withDefault: (defaultValue: T[]) => Parser<T[]> & {
+    defaultValue: T[];
+  };
+};
+declare function getUrlParams(): URLSearchParams;
+declare function setSearchParams(params: URLSearchParams, options?: Pick<UrlStateOptions, 'history' | 'scroll'>): void;
 /**
- * 操作列配置
+ * 单个 URL 状态参数
  */
+declare function useUrlState<T>(key: string, parser: Parser<T> & {
+  defaultValue?: T;
+}, options?: UrlStateOptions): [T, (value: T | ((prev: T) => T)) => void];
 /**
- * 已解析的操作项（渲染层使用）
+ * 多个 URL 状态参数
  */
-interface ResolvedActionItem<T, TContext = any> {
-  label?: string;
-  onClick?: (row: T) => void;
-  component?: React$1.ReactNode | ((context: TContext) => React$1.ReactNode);
-  getContext?: (row: T) => TContext;
-  separator?: boolean;
-  variant?: 'default' | 'destructive';
-}
+declare function useUrlStates<T extends Record<string, unknown>>(parsers: { [K in keyof T]: Parser<T[K]> & {
+  defaultValue?: T[K];
+} }, options?: UrlStateOptions): [T, (values: Partial<T>) => void];
 /**
- * 操作列配置（ResolvedActionItem 数组）
+ * nuqs 兼容层 - useQueryState
  */
-type ActionsColumnConfig<T> = ResolvedActionItem<T, any>[];
+declare function useQueryState<T>(key: string, parser: Parser<T> & {
+  defaultValue?: T;
+}, options?: UrlStateOptions): [T, (value: T | ((prev: T) => T)) => Promise<URLSearchParams>];
 /**
- * 创建操作列
+ * nuqs 兼容层 - useQueryStates
  */
-declare function createActionsColumn<T>(items: ActionsColumnConfig<T>): ColumnDef<T>;
+declare function useQueryStates<T extends Record<string, unknown>>(parsers: { [K in keyof T]: Parser<T[K]> & {
+  defaultValue?: T[K];
+} }, options?: UrlStateOptions): [T, (values: Partial<T>) => Promise<URLSearchParams>];
 //#endregion
-//#region src/components/auto-crud/auto-table.d.ts
-/** 过滤模式类型 */
-type FilterMode = 'simple' | 'advanced' | 'command';
-interface AutoTableProps<T extends z.ZodObject<z.ZodRawShape>> {
-  schema: T;
-  data: z.infer<T>[];
-  pageCount?: number;
-  /** Total rows matching the current search and filters. */
-  total?: number;
-  overrides?: ColumnOverrides<z.infer<T>>;
-  enableRowSelection?: boolean;
-  exclude?: (keyof z.infer<T>)[];
-  actions?: ActionsColumnConfig<z.infer<T>>;
-  /** 自定义固定列配置 */
-  pinnedColumns?: {
-    left?: string[];
-    right?: string[];
-  };
-  /**
-   * 过滤模式配置
-   * - 单个值: 只使用该模式，不显示切换按钮
-   * - 数组: 第一个为默认值，显示切换按钮
-   * 默认: ["simple", "advanced", "command"] (全部显示)
-   */
-  filterMode?: FilterMode | FilterMode[];
-  /** 全局搜索框 */
-  search?: boolean | {
-    placeholder?: string;
-  };
-  /** 批量删除回调 */
-  onDeleteSelected?: (rows: z.infer<T>[]) => void;
-  /** 批量更新回调 */
-  onUpdateSelected?: (rows: z.infer<T>[], data: Record<string, unknown>) => void;
-  /** 批量更新字段配置 */
-  batchUpdateFields?: BatchUpdateField[];
-  /** 批量操作栏额外按钮 */
-  actionBarExtra?: React.ReactNode;
-  /** 批量悬浮操作配置 */
-  actionBarActions?: BatchActionConfig<z.infer<T>>;
-  /** 批量删除二次确认文案 */
-  deleteConfirmation?: BatchDeleteConfirmation;
-  /** 初始排序 */
-  initialSorting?: any[];
-  /** 是否启用导出功能 (默认 true) */
-  enableExport?: boolean;
-  /** 未配置批量 actions / 只配置 custom actions 时，是否展示默认导出按钮 */
-  showDefaultExport?: boolean;
-  /** 选中行数变化回调（用于外层组件获知选中状态） */
-  onSelectedCountChange?: (count: number) => void;
-  /** 选中行数据变化回调（用于外层组件获知选中行身份变化） */
-  onSelectedRowsChange?: (rows: z.infer<T>[]) => void;
-  /** 获取选中行数据的回调（由外层组件调用） */
-  getSelectedRows?: React.MutableRefObject<(() => z.infer<T>[]) | null>;
-}
-declare function AutoTable<T extends z.ZodObject<z.ZodRawShape>>({
-  schema,
-  data,
-  pageCount,
-  total,
-  overrides,
-  enableRowSelection,
-  exclude,
-  actions,
-  pinnedColumns,
-  filterMode,
-  search,
-  onDeleteSelected,
-  onUpdateSelected,
-  batchUpdateFields,
-  actionBarExtra,
-  actionBarActions,
-  deleteConfirmation,
-  initialSorting,
-  enableExport,
-  showDefaultExport,
-  onSelectedCountChange,
-  onSelectedRowsChange,
-  getSelectedRows
-}: AutoTableProps<T>): react_jsx_runtime2.JSX.Element;
-//#endregion
-//#region src/i18n/locale.d.ts
-/**
- * AutoCrud 国际化接口及内置语言包
- *
- * 使用方式：
- *   // 内置语言
- *   <AutoCrudTable locale="en-US" ... />
- *
- *   // 部分覆盖（以 zh-CN 为基础深合并）
- *   <AutoCrudTable locale={{ toolbar: { create: "Add" } }} ... />
- */
-interface AutoCrudLocale {
-  toolbar: {
-    refresh: string;
-    create: string;
-    import: string;
-    export: string;
-    exportSelected: (count: number) => string;
-  };
-  rowActions: {
-    view: string;
-    edit: string;
-    copy: string;
-    delete: string;
-  };
-  viewModal: {
-    title: string;
-  };
-  boolean: {
-    true: string;
-    false: string;
-  };
-  formModal: {
-    createTitle: string;
-    editTitle: string;
-    cancel: string;
-    create: string;
-    save: string;
-    submitting: string;
-  };
-  deleteModal: {
-    title: string;
-    description: string;
-    cancel: string;
-    confirm: string;
-    confirming: string;
-  };
-  bulkDeleteModal: {
-    title: string;
-    description: (count: number) => string;
-    cancel: string;
-    confirm: string;
-  };
-  importDialog: {
-    title: string;
-    uploadDescription: string;
-    previewDescription: (count: number) => string;
-    importingDescription: string;
-    doneDescription: string;
-    dragHint: string;
-    formatHint: string;
-    downloadTemplate: string;
-    moreColumns: (count: number) => string;
-    previewSummary: (rows: number, fields: number, format: string, previewLimit?: number) => string;
-    reselect: string;
-    confirmImport: string;
-    importingRows: (count: number) => string;
-    resultCreated: string;
-    resultUpdated: string;
-    resultSkipped: string;
-    resultFailed: string;
-    failedRowHeader: string;
-    failedErrorHeader: string;
-    close: string;
-    continueImport: string;
-    errorNoData: string;
-    errorParseFailed: string;
-    errorImportFailed: string;
-  };
-}
-declare const zhCN: AutoCrudLocale;
-declare const enUS: AutoCrudLocale;
-declare const jaJP: AutoCrudLocale;
-declare const koKR: AutoCrudLocale;
-declare const frFR: AutoCrudLocale;
-declare const deDE: AutoCrudLocale;
-declare const esES: AutoCrudLocale;
-type DeepPartial<T> = { [P in keyof T]?: T[P] extends ((...args: unknown[]) => unknown) ? T[P] : T[P] extends object ? DeepPartial<T[P]> : T[P] };
-/** locale prop 类型：内置语言 key 或部分覆盖对象 */
-type LocaleProp = string | DeepPartial<AutoCrudLocale>;
-/**
- * 解析 locale prop 为完整的 AutoCrudLocale
- * - string → 内置语言（fallback: zh-CN）
- * - object → 以 zh-CN 为基础深合并
- */
-declare function resolveLocale(localeProp?: LocaleProp): AutoCrudLocale;
-//#endregion
-//#region src/lib/registries.d.ts
-type AutoCrudFormComponentConfig = {
-  component: React$1.ComponentType<any>;
-  decorator?: string | React$1.ComponentType<any>;
-  [key: string]: unknown;
-};
-type AutoCrudOption = {
-  value: string;
-  label: string;
-  searchText?: string | string[];
-  keywords?: string[];
-  count?: number;
-  disabled?: boolean;
-};
-type AutoCrudDataSourceContextType = 'form' | 'filter' | 'resolve';
-type AutoCrudDataSourceResolveFields = readonly string[] | ((context: {
-  field: string;
-}) => readonly string[]);
-type AutoCrudDataSourceContext = {
-  field: string;
-  type: AutoCrudDataSourceContextType;
-  page?: number;
-  pageSize?: number;
-  query?: string;
-  /** @deprecated Use `query` instead. */
-  search?: string;
-  values?: Record<string, unknown> | Record<string, unknown>[];
-  signal?: AbortSignal;
-};
-type AutoCrudDataSourceResult = AutoCrudOption[] | {
-  hasMore?: boolean;
-  options?: AutoCrudOption[];
-};
-type AutoCrudDataSourceLoader = (context: AutoCrudDataSourceContext) => AutoCrudDataSourceResult | Promise<AutoCrudDataSourceResult>;
-type AutoCrudDataSourceConfig = string;
-type AutoCrudDataSourceRegistration = AutoCrudDataSourceLoader | {
-  dependencies?: string[];
-  reset?: boolean;
-  search?: boolean;
-  debounceMs?: number;
-  loadMore?: boolean;
-  pageSize?: number;
-  resolveFields?: AutoCrudDataSourceResolveFields;
-  load: AutoCrudDataSourceLoader;
-};
-type AutoCrudDataSourceEntry = {
-  dependencies: string[];
-  reset: boolean;
-  search: boolean;
-  debounceMs: number;
-  loadMore: boolean;
-  pageSize: number;
-  resolveFields?: AutoCrudDataSourceResolveFields;
-  load: AutoCrudDataSourceLoader;
-};
-type RegistryListener$1 = () => void;
-declare const formComponents: {
-  register(name: string, value: AutoCrudFormComponentConfig): void;
-  unregister(name: string): void;
-  get(name: string): AutoCrudFormComponentConfig | undefined;
-  all(): Record<string, AutoCrudFormComponentConfig>;
-  subscribe(listener: RegistryListener$1): () => void;
-};
-declare const components: {
-  register(name: string, value: AutoCrudFormComponentConfig): void;
-  unregister(name: string): void;
-  get(name: string): AutoCrudFormComponentConfig | undefined;
-  all(): Record<string, AutoCrudFormComponentConfig>;
-  subscribe(listener: RegistryListener$1): () => void;
-};
-declare const dataSources: {
-  register(name: string, registration: AutoCrudDataSourceRegistration): void;
-  unregister: (name: string) => void;
-  get: (name: string) => AutoCrudDataSourceEntry | undefined;
-  all: () => Record<string, AutoCrudDataSourceEntry>;
-  subscribe: (listener: RegistryListener$1) => () => void;
+//#region src/config/data-table.d.ts
+type DataTableConfig = typeof dataTableConfig;
+declare const dataTableConfig: {
+  textOperators: ({
+    label: string;
+    value: "iLike";
+  } | {
+    label: string;
+    value: "notILike";
+  } | {
+    label: string;
+    value: "eq";
+  } | {
+    label: string;
+    value: "ne";
+  } | {
+    label: string;
+    value: "isEmpty";
+  } | {
+    label: string;
+    value: "isNotEmpty";
+  })[];
+  numericOperators: ({
+    label: string;
+    value: "eq";
+  } | {
+    label: string;
+    value: "ne";
+  } | {
+    label: string;
+    value: "lt";
+  } | {
+    label: string;
+    value: "lte";
+  } | {
+    label: string;
+    value: "gt";
+  } | {
+    label: string;
+    value: "gte";
+  } | {
+    label: string;
+    value: "isBetween";
+  } | {
+    label: string;
+    value: "isEmpty";
+  } | {
+    label: string;
+    value: "isNotEmpty";
+  })[];
+  dateOperators: ({
+    label: string;
+    value: "eq";
+  } | {
+    label: string;
+    value: "ne";
+  } | {
+    label: string;
+    value: "lt";
+  } | {
+    label: string;
+    value: "gt";
+  } | {
+    label: string;
+    value: "lte";
+  } | {
+    label: string;
+    value: "gte";
+  } | {
+    label: string;
+    value: "isBetween";
+  } | {
+    label: string;
+    value: "isRelativeToToday";
+  } | {
+    label: string;
+    value: "isEmpty";
+  } | {
+    label: string;
+    value: "isNotEmpty";
+  })[];
+  selectOperators: ({
+    label: string;
+    value: "eq";
+  } | {
+    label: string;
+    value: "ne";
+  } | {
+    label: string;
+    value: "isEmpty";
+  } | {
+    label: string;
+    value: "isNotEmpty";
+  })[];
+  multiSelectOperators: ({
+    label: string;
+    value: "inArray";
+  } | {
+    label: string;
+    value: "notInArray";
+  } | {
+    label: string;
+    value: "isEmpty";
+  } | {
+    label: string;
+    value: "isNotEmpty";
+  })[];
+  booleanOperators: ({
+    label: string;
+    value: "eq";
+  } | {
+    label: string;
+    value: "ne";
+  })[];
+  sortOrders: ({
+    label: string;
+    value: "asc";
+  } | {
+    label: string;
+    value: "desc";
+  })[];
+  filterVariants: readonly ["text", "number", "range", "date", "dateRange", "boolean", "select", "multiSelect"];
+  operators: readonly ["iLike", "notILike", "eq", "ne", "inArray", "notInArray", "isEmpty", "isNotEmpty", "lt", "lte", "gt", "gte", "isBetween", "isRelativeToToday"];
+  joinOperators: readonly ["and", "or"];
 };
-declare function normalizeDataSourceConfig(config: AutoCrudDataSourceConfig | undefined): {
-  key: string;
-} | undefined;
-declare function normalizeOptions(result: AutoCrudDataSourceResult | undefined): AutoCrudOption[];
 //#endregion
-//#region src/components/auto-crud/auto-crud-table.d.ts
-/**
- * 筛选器独立配置
- * 可独立于 table.meta 配置筛选器行为
- */
-interface FilterConfig {
-  /** 是否启用筛选（默认跟随 table.meta.variant 推断） */
-  enabled?: boolean;
-  /** 筛选器类型 */
-  variant?: 'text' | 'number' | 'range' | 'date' | 'dateRange' | 'boolean' | 'select' | 'multiSelect';
-  /** select/multiSelect 的选项列表 */
-  options?: FieldOption[];
-  /** select/multiSelect 的动态选项源 */
-  dataSource?: AutoCrudDataSourceConfig;
-  /** range 的最小/最大值 */
-  range?: [number, number];
-  /** number 的单位 */
-  unit?: string;
-  /** 过滤器占位符 */
-  placeholder?: string;
-  /** 排序权重，数值越小越靠前 */
-  index?: number;
-  /** 是否在筛选栏中隐藏（隐藏筛选但不影响表格列显示） */
-  hidden?: boolean;
-  /** 控制在哪些筛选模式下显示（未设置则在所有模式显示） */
-  modes?: Array<'simple' | 'advanced' | 'command'>;
+//#region src/lib/parsers.d.ts
+declare const filterItemSchema: z.ZodObject<{
+  id: z.ZodString;
+  value: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+  variant: z.ZodEnum<{
+    number: "number";
+    boolean: "boolean";
+    text: "text";
+    range: "range";
+    date: "date";
+    dateRange: "dateRange";
+    select: "select";
+    multiSelect: "multiSelect";
+  }>;
+  operator: z.ZodEnum<{
+    iLike: "iLike";
+    notILike: "notILike";
+    eq: "eq";
+    ne: "ne";
+    isEmpty: "isEmpty";
+    isNotEmpty: "isNotEmpty";
+    lt: "lt";
+    lte: "lte";
+    gt: "gt";
+    gte: "gte";
+    isBetween: "isBetween";
+    isRelativeToToday: "isRelativeToToday";
+    inArray: "inArray";
+    notInArray: "notInArray";
+  }>;
+  filterId: z.ZodString;
+}, z.core.$strip>;
+type FilterItemSchema = z.infer<typeof filterItemSchema>;
+//#endregion
+//#region src/types/data-table.d.ts
+interface DataTableClassNames {
+  table?: string;
+  thead?: string;
+  tbody?: string;
+  /** 应用于表头行、正文行和空状态行 */
+  tr?: string;
+  th?: string;
+  td?: string;
 }
-interface FieldOption {
+declare module '@tanstack/react-table' {
+  interface TableMeta<TData extends RowData> {
+    queryKeys?: QueryKeys;
+    queryStateOptions?: UrlStateOptions;
+  }
+  interface ColumnMeta<TData extends RowData, TValue> {
+    label?: string;
+    index?: number;
+    /** 按元素分组的列类名，优先于全局单元格类名 */
+    classNames?: Pick<DataTableClassNames, 'th' | 'td'>;
+    placeholder?: string;
+    variant?: FilterVariant$1;
+    options?: Option[];
+    range?: [number, number];
+    unit?: string;
+    icon?: React.FC<React.SVGProps<SVGSVGElement>>;
+    /** 控制在哪些筛选模式下显示（未设置则在所有模式显示） */
+    modes?: Array<'simple' | 'advanced' | 'command'>;
+    /** 内部：远程筛选选项搜索值 */
+    autoCrudFilterSearchValue?: string;
+    /** 内部：远程筛选选项搜索回调 */
+    autoCrudFilterOnSearch?: (value: string) => void;
+    /** 内部：是否启用本地选项过滤 */
+    autoCrudFilterShouldFilter?: boolean;
+    /** 内部：远程筛选当前弹窗选项，和稳定标签缓存分离 */
+    autoCrudFilterOptions?: Option[];
+    /** 内部：远程筛选是否还有更多选项 */
+    autoCrudFilterHasMore?: boolean;
+    /** 内部：远程筛选是否正在加载 */
+    autoCrudFilterLoading?: boolean;
+    /** 内部：远程筛选弹窗滚动回调 */
+    autoCrudFilterOnPopupScroll?: React.UIEventHandler<HTMLElement>;
+  }
+}
+interface QueryKeys {
+  page: string;
+  perPage: string;
+  sort: string;
+  filters: string;
+  joinOperator: string;
+}
+interface Option {
   label: string;
   value: string;
-  searchText?: string | string[];
+  searchText?: string;
   count?: number;
-  icon?: React$1.FC<React$1.SVGProps<SVGSVGElement>>;
-  disabled?: boolean;
+  icon?: React.FC<React.SVGProps<SVGSVGElement>>;
 }
-type FieldTableDisplay = 'auto' | 'text' | 'badge' | 'date' | 'datetime';
-/**
- * 统一字段配置
- * 支持共用配置 + 表格/表单特定配置
- */
-interface Field {
-  /** 字段标签（表格和表单共用） */
-  label?: string;
-  /** 字段级静态选项（表单、筛选、展示共用） */
-  enum?: FieldOption[];
-  /** 字段级动态选项源（表单、筛选、展示共用） */
-  dataSource?: AutoCrudDataSourceConfig;
-  /** 是否隐藏（表格和表单都隐藏） */
-  hidden?: boolean;
-  /** 是否参与 AutoCrud 全局搜索 */
-  search?: boolean;
-  /**
-   * 筛选器独立配置
-   * - FilterConfig: 详细配置
-   * - false: 禁用筛选（简写，等价于 { enabled: false }）
-   * 独立于 table.meta 控制筛选器行为，不影响表格列显示/隐藏
-   */
-  filter?: FilterConfig | false;
-  /**
-   * 表格特定配置
-   * - object: 详细配置
-   * - false: 隐藏表格列（简写，等价于 { hidden: true }）
-   */
-  table?: {
-    /** 是否在表格中隐藏 */
-    hidden?: boolean;
-    /** 表格列标签 */
-    label?: string;
-    /** 排序权重，数值越小越靠前 */
-    index?: number;
-    /** 仅用于表格展示的静态值标签；与 dataSource 同时配置时覆盖同值的动态标签 */
-    options?: FieldOption[];
-    /** 仅用于表格展示的动态值标签源 */
-    dataSource?: AutoCrudDataSourceConfig;
-    /** 声明式单元格展示模式；非 auto 模式会覆盖拥有方自定义 cell */
-    display?: FieldTableDisplay;
-    /** 筛选器配置 */
-    meta?: Record<string, unknown>;
-    /** 其他列配置 */
-    [key: string]: unknown;
-  } | false;
-  /**
-   * 表单特定配置
-   * - object: 详细配置（Formily Schema）
-   * - false: 隐藏表单字段（简写，等价于 { "x-hidden": true }）
-   */
-  form?: {
-    /** 是否在表单中隐藏 */
-    'x-hidden'?: boolean;
-    /** 组件类型 */
-    'x-component'?: string;
-    /** 组件属性 */
-    'x-component-props'?: Record<string, unknown>;
-    /** 其他表单配置 */
-    [key: string]: unknown;
-  } | false;
+type FilterOperator = DataTableConfig['operators'][number];
+type FilterVariant$1 = DataTableConfig['filterVariants'][number];
+type JoinOperator = DataTableConfig['joinOperators'][number];
+interface ExtendedColumnSort<TData> extends Omit<ColumnSort, 'id'> {
+  id: Extract<keyof TData, string>;
+}
+interface ExtendedColumnFilter<TData> extends FilterItemSchema {
+  id: Extract<keyof TData, string>;
+}
+interface DataTableRowAction<TData> {
+  row: Row<TData>;
+  variant: 'update' | 'delete';
+}
+//#endregion
+//#region src/components/auto-crud/auto-table-action-bar.d.ts
+/** 批量更新字段配置 */
+interface BatchUpdateField {
+  /** 字段名 */
+  field: string;
+  /** 显示标签 */
+  label: string;
+  /** 可选值 */
+  options: Array<{
+    label: string;
+    value: string;
+  }>;
 }
-type Fields = Record<string, Field>;
-/** 内置操作项（覆盖默认行为或调整位置） */
-type ActionMeta = {
+interface BatchActionContext<TData> {
+  /** 选中的原始行数据 */
+  rows: TData[];
+  /** TanStack Table 实例 */
+  table: Table<TData>;
+  /** 清空当前选择 */
+  clearSelection: () => void;
+}
+type BatchBuiltinActionType = 'batchUpdate' | 'export' | 'delete';
+type BatchActionMeta = {
   id?: string;
   order?: number;
   hidden?: boolean;
 };
-interface AutoCrudRowActionContext<T> {
-  crudId: string;
-  idKey: string;
-  row: T;
-  rowId?: string;
-  openView: (row: T) => void;
-  openEdit?: (row: T) => void;
-  copyRow?: (row: T) => void;
-  openDelete?: (row: T) => void;
-}
-type ActionComponent<TContext> = React$1.ReactNode | ((context: TContext) => React$1.ReactNode);
-type RowBuiltinActionType = 'view' | 'edit' | 'copy' | 'delete';
-type RowBuiltinActionItem<T> = ActionMeta & {
-  type: RowBuiltinActionType;
-  onClick?: (row: T) => void;
+type BatchBuiltinActionItem<TData> = BatchActionMeta & {
+  type: BatchBuiltinActionType;
+  /** 替代默认行为 */
+  onClick?: (rows: TData[], context: BatchActionContext<TData>, event: React$1.MouseEvent<HTMLButtonElement>) => void;
+  /** 替代默认标签，仅对 export/delete 生效 */
   label?: string;
-  separator?: boolean;
+  /** 替代整个内置操作的渲染 */
+  component?: React$1.ReactNode | ((context: BatchActionContext<TData>) => React$1.ReactNode);
 };
-type RowCustomActionItem<T> = ActionMeta & {
+type BatchCustomActionItem<TData> = BatchActionMeta & {
   type: 'custom';
+  /** 操作文本。传 component 时可省略 */
   label?: string;
-  onClick?: (row: T) => void;
-  component?: ActionComponent<AutoCrudRowActionContext<T>>;
-  position?: 'start' | 'end';
-  separator?: boolean;
-  variant?: 'default' | 'destructive';
-};
-/**
- * Row action item.
- *
- * - Custom-only config keeps builtin row actions and appends custom actions.
- * - Including any builtin type takes over builtin ordering.
- */
-type RowActionItem<T> = RowBuiltinActionItem<T> | RowCustomActionItem<T>;
-type RowActionConfig<T> = RowActionItem<T>[] | ((defaults: RowBuiltinActionItem<T>[]) => RowActionItem<T>[]);
-/** @deprecated Use RowActionItem instead. */
-type ActionItem<T> = RowActionItem<T>;
-/** @deprecated Use RowActionConfig instead. */
-type ActionConfig<T> = RowActionConfig<T>;
-type AutoCrudActionsConfig<T> = {
-  toolbar?: ToolbarActionConfig;
-  row?: RowActionConfig<T>;
-  batch?: BatchActionConfig<T>;
-};
-type AutoCrudActionConfig<T> = RowActionConfig<T> | AutoCrudActionsConfig<T>;
-/**
- * 顶部工具栏内置操作项
- */
-type ToolbarBuiltinActionType = 'refresh' | 'create' | 'import' | 'export';
-type ToolbarBuiltinActionItem = ActionMeta & {
-  type: ToolbarBuiltinActionType;
-  /** 替代默认的行为 */
-  onClick?: () => void;
-  /** 替代默认的标签文本 */
-  label?: string;
-  /** 替代整个按钮的渲染 */
-  component?: ActionComponent<AutoCrudToolbarContext>;
-};
-/**
- * 顶部工具栏自定义操作项
- */
-type ToolbarCustomActionItem = ActionMeta & {
-  type: 'custom';
+  /** 自定义点击行为。传 component 时可省略 */
+  onClick?: (rows: TData[], context: BatchActionContext<TData>, event: React$1.MouseEvent<HTMLButtonElement>) => void;
   /** 渲染自定义内容 */
-  component: ActionComponent<AutoCrudToolbarContext>;
+  component?: React$1.ReactNode | ((context: BatchActionContext<TData>) => React$1.ReactNode);
   /** 仅在无内置项时生效：插入到首部还是尾部（默认 end） */
   position?: 'start' | 'end';
+  variant?: 'default' | 'destructive';
 };
-type ToolbarActionItem = ToolbarBuiltinActionItem | ToolbarCustomActionItem;
-type ToolbarActionConfig = ToolbarActionItem[] | ((defaults: ToolbarBuiltinActionItem[]) => ToolbarActionItem[]);
-interface AutoCrudToolbarContext {
-  crudId: string;
-  idKey: string;
-  rowIds: string[];
-  selectedRowIds: string[];
-  selectedCount: number;
-  refresh?: () => Promise<unknown>;
-  openImport?: () => void;
-  exportData?: () => Promise<void>;
-  openCreate?: () => void;
-  isRefreshing: boolean;
-  isExporting: boolean;
+type BatchActionItem<TData> = BatchBuiltinActionItem<TData> | BatchCustomActionItem<TData>;
+type BatchActionConfig<TData> = BatchActionItem<TData>[] | ((defaults: BatchBuiltinActionItem<TData>[]) => BatchActionItem<TData>[]);
+interface BatchDeleteConfirmation {
+  title: string;
+  description: (count: number) => string;
+  cancel: string;
+  confirm: string;
 }
-type AutoCrudToolbarResolver = (targetId: string, ownerActions: readonly ToolbarActionItem[], context: AutoCrudToolbarContext) => ToolbarActionItem[];
-declare function setToolbarResolver(resolver: AutoCrudToolbarResolver | null): void;
+interface AutoTableActionBarProps<TData> {
+  table: Table<TData>;
+  onDeleteSelected?: (rows: TData[]) => void;
+  /** 批量更新回调 */
+  onUpdateSelected?: (rows: TData[], data: Record<string, unknown>) => void;
+  /** 批量更新字段配置 */
+  batchUpdateFields?: BatchUpdateField[];
+  /** 是否启用导出功能 */
+  enableExport?: boolean;
+  /** 未配置 actions / 只配置 custom actions 时，是否展示默认导出按钮 */
+  showDefaultExport?: boolean;
+  /** 是否启用删除功能 */
+  enableDelete?: boolean;
+  /** 额外的操作按钮 */
+  extraActions?: React$1.ReactNode;
+  /** 批量操作配置，支持和行操作/顶部工具栏一致的顺序接管语义 */
+  actions?: BatchActionConfig<TData>;
+  /** 批量删除二次确认文案 */
+  deleteConfirmation?: BatchDeleteConfirmation;
+}
+declare function AutoTableActionBar<TData>({
+  table,
+  onDeleteSelected,
+  onUpdateSelected,
+  batchUpdateFields,
+  enableExport,
+  showDefaultExport,
+  enableDelete,
+  extraActions,
+  actions,
+  deleteConfirmation
+}: AutoTableActionBarProps<TData>): react_jsx_runtime2.JSX.Element;
+//#endregion
+//#region src/lib/schema-bridge/types.d.ts
 /**
- * AutoCrudTable Props 接口
+ * 字段类型映射
  */
-interface AutoCrudTableProps<TSchema extends z.ZodObject<z.ZodRawShape>> {
-  /** Public CRUD id. Used by hosts to document the extension target. */
-  id?: string;
-  /** 页面标题 */
-  title?: string;
-  /** 页面描述 */
-  description?: string;
-  /** Zod schema */
-  schema: TSchema;
-  /** useAutoCrudResource hook 返回值 */
-  resource: UseAutoCrudResourceReturn<TSchema, z.output<TSchema>>;
-  /**
-   * 统一字段配置
-   * 支持共用配置（label, hidden）+ 表格/表单特定配置
-   */
-  fields?: Fields;
-  /** 表格配置 */
-  table?: {
-    /** 隐藏的列 */
-    hidden?: string[];
-    /** 列覆盖配置 */
-    overrides?: Record<string, any>;
-    /**
-     * 过滤模式配置
-     * - 单个值: 只使用该模式，不显示切换按钮
-     * - 数组: 第一个为默认值，显示切换按钮
-     */
-    filterModes?: FilterMode | FilterMode[];
-    /** 全局搜索框；默认在存在 search: true 字段时显示 */
-    search?: boolean | {
-      placeholder?: string;
-    };
-    /**
-     * 批量更新字段配置
-     * - 只需传字段名数组，options 自动从 schema enum 推导
-     * - 也可以传完整配置覆盖 label 或 options
-     */
-    batchFields?: (string | BatchUpdateField)[];
-    /**
-     * 多选后悬浮批量操作栏配置
-     * 用法类同 `actions` 行操作和 `toolbar` 顶部工具栏。
-     * 只传 custom 时保留默认批量操作；包含任意内置 type 时完全接管顺序。
-     * @deprecated Use actions.batch instead.
-     */
-    batchActions?: BatchActionConfig<z.output<TSchema>>;
-    /** 默认排序 */
-    defaultSort?: any[];
-  };
-  /** 表单配置 */
-  form?: {
-    /** 表单覆盖配置（兼容旧 API，优先级低于 fieldOverrides） */
-    overrides?: Record<string, any>;
-    /** Formily schema expression/reaction scope */
-    scope?: JsonSchemaFormScope;
-    /** 表单列数 */
-    columns?: number;
-    /** 弹窗自定义容器类名（支持控制大小、最大高度等） */
-    className?: string;
-  };
-  /** 行操作配置，或统一的 toolbar/row/batch 操作配置。 */
-  actions?: AutoCrudActionConfig<z.output<TSchema>>;
-  /**
-   * 顶层工具栏操作配置
-   * 用法类同 `actions` 行操作。一旦配置了包含内置 `type` 的数组，它将完全接管右侧工具栏！
-   * @deprecated Use actions.toolbar instead.
-   */
-  toolbar?: ToolbarActionConfig;
-  /** @deprecated Use toolbar instead. */
-  toolbarActions?: ToolbarActionConfig;
-  /**
-   * 权限配置
-   * 控制按钮显示和字段访问
-   *
-   * @example
-   * ```tsx
-   * const permissions = useMemo(() => ({
-   *   can: {
-   *     create: user.role === 'admin',
-   *     update: user.role === 'admin' || user.role === 'editor',
-   *     delete: user.role === 'admin',
-   *     export: true,
-   *     import: true,
-   *   },
-   *   deny: user.role === 'user' ? ['salary', 'ssn'] : [],
-   * }), [user.role]);
-   *
-   * <AutoCrudTable permissions={permissions} ... />
-   * ```
-   */
-  permissions?: CrudPermissions;
-  /**
-   * 语言配置
-   * - 内置语言 key：`"zh-CN"`（默认）、`"en-US"`
-   * - 部分覆盖对象：以 zh-CN 为基础深合并
-   *
-   * @example
-   * ```tsx
-   * <AutoCrudTable locale="en-US" ... />
-   * <AutoCrudTable locale={{ toolbar: { create: "Add New" } }} ... />
-   * ```
-   */
-  locale?: LocaleProp;
-  /**
-   * 自定义新建按钮点击事件
-   * 如果提供，将覆盖默认的打开新建弹窗行为
-   */
-  onCreate?: () => void;
+type FieldType = 'string' | 'number' | 'boolean' | 'date' | 'enum' | 'array' | 'object';
+/**
+ * DataTable Filter Variant
+ */
+type FilterVariant = 'text' | 'number' | 'boolean' | 'select' | 'multiSelect' | 'date' | 'dateRange' | 'range';
+/**
+ * 解析后的 Zod 字段信息
+ */
+interface ParsedZodField {
+  type: FieldType;
+  required: boolean;
+  enumValues?: string[];
+  description?: string;
+  defaultValue?: unknown;
 }
 /**
- * AutoCrudTable 组件
- *
- * 高级 CRUD 表格组件，封装了完整的增删改查流程
+ * 列定义覆盖选项
  */
-declare function AutoCrudTable<TSchema extends z.ZodObject<z.ZodRawShape>>({
-  id,
-  title,
-  description,
-  schema,
-  resource,
-  fields,
-  table: tableConfig,
-  form: formConfig,
-  permissions,
-  actions: actionItems,
-  toolbar,
-  toolbarActions,
-  locale: localeProp,
-  onCreate
-}: 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>> {
-  schema: T;
-  initialValues?: Partial<z.infer<T>>;
-  onSubmit: (values: z.infer<T>) => void | Promise<void>;
-  /** 统一字段配置，推荐用于描述 auto-crud 字段级表单行为 */
-  fields?: Fields;
-  /** Formily 字段 schema 覆盖配置，保留兼容旧 API */
+type ColumnOverrides<T> = Partial<{ [K in keyof T]: Partial<ColumnDef<T, unknown>> & {
+  hidden?: boolean;
+  label?: string;
+  index?: number;
+} }>;
+/**
+ * Formily Schema 覆盖选项
+ */
+type FormSchemaOverrides = Record<string, Partial<ISchema>>;
+/**
+ * createTableSchema 选项
+ */
+interface CreateTableSchemaOptions<T> {
+  overrides?: ColumnOverrides<T>;
+  exclude?: (keyof T)[];
+}
+/**
+ * createFormSchema 选项
+ */
+interface CreateFormSchemaOptions {
   overrides?: FormSchemaOverrides;
-  /** Formily schema expression/reaction scope */
-  scope?: JsonSchemaFormScope;
-  mode?: 'create' | 'edit';
-  loading?: boolean;
+  exclude?: string[];
+  layout?: 'vertical' | 'horizontal' | 'grid';
   gridColumns?: number;
   /** Label 对齐方式 */
   labelAlign?: 'left' | 'top' | 'right';
   /** Label 宽度（labelAlign 为 left 时有效） */
   labelWidth?: number | string;
-  /** 是否显示提交按钮（默认 true） */
-  showSubmitButton?: boolean;
+  /** Label 栅格占位 */
+  labelCol?: number;
+  /** 输入框栅格占位 */
+  wrapperCol?: number;
 }
-interface AutoFormRef {
-  submit: () => Promise<void>;
+/**
+ * Enum 选项类型
+ */
+interface EnumOption {
+  label: string;
+  value: string;
 }
-declare function AutoFormInner<T extends z.ZodObject<z.ZodRawShape>>({
-  schema: zodSchema,
-  initialValues,
-  onSubmit,
-  fields,
-  overrides,
-  scope: scopeProp,
-  mode,
-  loading,
-  gridColumns,
-  labelAlign,
-  labelWidth,
-  showSubmitButton
-}: 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>;
 //#endregion
-//#region src/hooks/use-url-state.d.ts
+//#region src/lib/schema-bridge/zod-to-columns.d.ts
 /**
- * URL 状态管理 Hook - 替代 nuqs
- * 将 React 状态同步到 URL query string
- *
- * 架构说明：
- * - 使用 queueMicrotask 延迟 URL 更新，确保在渲染完成后执行
- * - 符合 React 渲染规则，不会触发 "Cannot update a component while rendering" 错误
+ * 解析 Zod 字段类型
  */
-interface UrlStateOptions {
-  /** 历史记录模式: push 添加新记录, replace 替换当前记录 */
-  history?: 'push' | 'replace';
-  /** 是否浅层更新（不触发页面刷新） */
-  shallow?: boolean;
-  /** 节流时间（毫秒） */
-  throttleMs?: number;
-  /** 防抖时间（毫秒） */
-  debounceMs?: number;
-  /** 当值等于默认值时是否清除 URL 参数 */
-  clearOnDefault?: boolean;
-  /** 滚动到顶部 */
-  scroll?: boolean;
-  /** React transition */
-  startTransition?: React$1.TransitionStartFunction;
+declare function parseZodField(schema: z.ZodType): ParsedZodField;
+/**
+ * 从 Zod Schema 创建 Table Schema (ColumnDef 数组)
+ */
+declare function createTableSchema<T extends z.ZodObject<z.ZodRawShape>>(schema: T, options?: CreateTableSchemaOptions<z.infer<T>>): ColumnDef<z.infer<T>>[];
+/**
+ * 创建选择列
+ */
+declare function createSelectColumn<T>(): ColumnDef<T>;
+/**
+ * 操作列配置
+ */
+/**
+ * 已解析的操作项（渲染层使用）
+ */
+interface ResolvedActionItem<T, TContext = any> {
+  label?: string;
+  onClick?: (row: T) => void;
+  component?: React$1.ReactNode | ((context: TContext) => React$1.ReactNode);
+  getContext?: (row: T) => TContext;
+  separator?: boolean;
+  variant?: 'default' | 'destructive';
 }
-interface Parser<T> {
-  parse: (value: string) => T;
-  serialize: (value: T) => string;
+/**
+ * 操作列配置（ResolvedActionItem 数组）
+ */
+type ActionsColumnConfig<T> = ResolvedActionItem<T, any>[];
+declare module '@tanstack/react-table' {
+  interface ColumnMeta<TData extends RowData, TValue> {
+    rowActions?: ActionsColumnConfig<TData>;
+  }
 }
-declare const parseAsInteger: Parser<number> & {
-  withDefault: (defaultValue: number) => Parser<number> & {
-    defaultValue: number;
+/**
+ * 创建操作列
+ */
+declare function createActionsColumn<T>(items: ActionsColumnConfig<T>): ColumnDef<T>;
+//#endregion
+//#region src/components/auto-crud/auto-table.d.ts
+/** 过滤模式类型 */
+type FilterMode = 'simple' | 'advanced' | 'command';
+interface AutoTableProps<T extends z.ZodObject<z.ZodRawShape>> {
+  schema: T;
+  data: z.infer<T>[];
+  pageCount?: number;
+  /** Total rows matching the current search and filters. */
+  total?: number;
+  overrides?: ColumnOverrides<z.infer<T>>;
+  /** 按元素分组的全局表格类名 */
+  classNames?: DataTableClassNames;
+  enableRowSelection?: boolean;
+  exclude?: (keyof z.infer<T>)[];
+  actions?: ActionsColumnConfig<z.infer<T>>;
+  /** 自定义固定列配置 */
+  pinnedColumns?: {
+    left?: string[];
+    right?: string[];
+  };
+  /**
+   * 过滤模式配置
+   * - 单个值: 只使用该模式，不显示切换按钮
+   * - 数组: 第一个为默认值，显示切换按钮
+   * 默认: ["simple", "advanced", "command"] (全部显示)
+   */
+  filterMode?: FilterMode | FilterMode[];
+  /** 全局搜索框 */
+  search?: boolean | {
+    placeholder?: string;
+  };
+  /** 批量删除回调 */
+  onDeleteSelected?: (rows: z.infer<T>[]) => void;
+  /** 批量更新回调 */
+  onUpdateSelected?: (rows: z.infer<T>[], data: Record<string, unknown>) => void;
+  /** 批量更新字段配置 */
+  batchUpdateFields?: BatchUpdateField[];
+  /** 批量操作栏额外按钮 */
+  actionBarExtra?: React.ReactNode;
+  /** 批量悬浮操作配置 */
+  actionBarActions?: BatchActionConfig<z.infer<T>>;
+  /** 批量删除二次确认文案 */
+  deleteConfirmation?: BatchDeleteConfirmation;
+  /** 初始排序 */
+  initialSorting?: any[];
+  /** 是否启用导出功能 (默认 true) */
+  enableExport?: boolean;
+  /** 未配置批量 actions / 只配置 custom actions 时，是否展示默认导出按钮 */
+  showDefaultExport?: boolean;
+  /** 选中行数变化回调（用于外层组件获知选中状态） */
+  onSelectedCountChange?: (count: number) => void;
+  /** 选中行数据变化回调（用于外层组件获知选中行身份变化） */
+  onSelectedRowsChange?: (rows: z.infer<T>[]) => void;
+  /** 获取选中行数据的回调（由外层组件调用） */
+  getSelectedRows?: React.MutableRefObject<(() => z.infer<T>[]) | null>;
+}
+declare function AutoTable<T extends z.ZodObject<z.ZodRawShape>>({
+  schema,
+  data,
+  pageCount,
+  total,
+  overrides,
+  classNames,
+  enableRowSelection,
+  exclude,
+  actions,
+  pinnedColumns,
+  filterMode,
+  search,
+  onDeleteSelected,
+  onUpdateSelected,
+  batchUpdateFields,
+  actionBarExtra,
+  actionBarActions,
+  deleteConfirmation,
+  initialSorting,
+  enableExport,
+  showDefaultExport,
+  onSelectedCountChange,
+  onSelectedRowsChange,
+  getSelectedRows
+}: AutoTableProps<T>): react_jsx_runtime2.JSX.Element;
+//#endregion
+//#region src/lib/row-action-dialog.d.ts
+interface RowActionDialogProps {
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+  onDismiss?: () => void;
+}
+//#endregion
+//#region src/i18n/locale.d.ts
+/**
+ * AutoCrud 国际化接口及内置语言包
+ *
+ * 使用方式：
+ *   // 内置语言
+ *   <AutoCrudTable locale="en-US" ... />
+ *
+ *   // 部分覆盖（以 zh-CN 为基础深合并）
+ *   <AutoCrudTable locale={{ toolbar: { create: "Add" } }} ... />
+ */
+interface AutoCrudLocale {
+  toolbar: {
+    refresh: string;
+    create: string;
+    import: string;
+    export: string;
+    exportSelected: (count: number) => string;
   };
-};
-declare const parseAsString: Parser<string> & {
-  withDefault: (defaultValue: string) => Parser<string> & {
-    defaultValue: string;
+  rowActions: {
+    view: string;
+    edit: string;
+    copy: string;
+    delete: string;
   };
-};
-declare function parseAsStringEnum<T extends string>(validValues: readonly T[]): Parser<T | null> & {
-  withDefault: (defaultValue: T) => Parser<T> & {
-    defaultValue: T;
+  viewModal: {
+    title: string;
   };
-};
-declare function parseAsArrayOf<T>(itemParser: Parser<T>, separator?: string): Parser<T[]> & {
-  withDefault: (defaultValue: T[]) => Parser<T[]> & {
-    defaultValue: T[];
+  boolean: {
+    true: string;
+    false: string;
   };
-};
-declare function getUrlParams(): URLSearchParams;
-declare function setSearchParams(params: URLSearchParams, options?: Pick<UrlStateOptions, 'history' | 'scroll'>): void;
-/**
- * 单个 URL 状态参数
- */
-declare function useUrlState<T>(key: string, parser: Parser<T> & {
-  defaultValue?: T;
-}, options?: UrlStateOptions): [T, (value: T | ((prev: T) => T)) => void];
-/**
- * 多个 URL 状态参数
- */
-declare function useUrlStates<T extends Record<string, unknown>>(parsers: { [K in keyof T]: Parser<T[K]> & {
-  defaultValue?: T[K];
-} }, options?: UrlStateOptions): [T, (values: Partial<T>) => void];
-/**
- * nuqs 兼容层 - useQueryState
- */
-declare function useQueryState<T>(key: string, parser: Parser<T> & {
-  defaultValue?: T;
-}, options?: UrlStateOptions): [T, (value: T | ((prev: T) => T)) => Promise<URLSearchParams>];
+  formModal: {
+    createTitle: string;
+    editTitle: string;
+    cancel: string;
+    create: string;
+    save: string;
+    submitting: string;
+  };
+  deleteModal: {
+    title: string;
+    description: string;
+    cancel: string;
+    confirm: string;
+    confirming: string;
+  };
+  bulkDeleteModal: {
+    title: string;
+    description: (count: number) => string;
+    cancel: string;
+    confirm: string;
+  };
+  importDialog: {
+    title: string;
+    uploadDescription: string;
+    previewDescription: (count: number) => string;
+    importingDescription: string;
+    doneDescription: string;
+    dragHint: string;
+    formatHint: string;
+    downloadTemplate: string;
+    moreColumns: (count: number) => string;
+    previewSummary: (rows: number, fields: number, format: string, previewLimit?: number) => string;
+    reselect: string;
+    confirmImport: string;
+    importingRows: (count: number) => string;
+    resultCreated: string;
+    resultUpdated: string;
+    resultSkipped: string;
+    resultFailed: string;
+    failedRowHeader: string;
+    failedErrorHeader: string;
+    close: string;
+    continueImport: string;
+    errorNoData: string;
+    errorParseFailed: string;
+    errorImportFailed: string;
+  };
+}
+declare const zhCN: AutoCrudLocale;
+declare const enUS: AutoCrudLocale;
+declare const jaJP: AutoCrudLocale;
+declare const koKR: AutoCrudLocale;
+declare const frFR: AutoCrudLocale;
+declare const deDE: AutoCrudLocale;
+declare const esES: AutoCrudLocale;
+type DeepPartial<T> = { [P in keyof T]?: T[P] extends ((...args: unknown[]) => unknown) ? T[P] : T[P] extends object ? DeepPartial<T[P]> : T[P] };
+/** locale prop 类型：内置语言 key 或部分覆盖对象 */
+type LocaleProp = string | DeepPartial<AutoCrudLocale>;
 /**
- * nuqs 兼容层 - useQueryStates
+ * 解析 locale prop 为完整的 AutoCrudLocale
+ * - string → 内置语言（fallback: zh-CN）
+ * - object → 以 zh-CN 为基础深合并
  */
-declare function useQueryStates<T extends Record<string, unknown>>(parsers: { [K in keyof T]: Parser<T[K]> & {
-  defaultValue?: T[K];
-} }, options?: UrlStateOptions): [T, (values: Partial<T>) => Promise<URLSearchParams>];
+declare function resolveLocale(localeProp?: LocaleProp): AutoCrudLocale;
 //#endregion
-//#region src/config/data-table.d.ts
-type DataTableConfig = typeof dataTableConfig;
-declare const dataTableConfig: {
-  textOperators: ({
-    label: string;
-    value: "iLike";
-  } | {
-    label: string;
-    value: "notILike";
-  } | {
-    label: string;
-    value: "eq";
-  } | {
-    label: string;
-    value: "ne";
-  } | {
-    label: string;
-    value: "isEmpty";
-  } | {
-    label: string;
-    value: "isNotEmpty";
-  })[];
-  numericOperators: ({
-    label: string;
-    value: "eq";
-  } | {
-    label: string;
-    value: "ne";
-  } | {
-    label: string;
-    value: "lt";
-  } | {
-    label: string;
-    value: "lte";
-  } | {
-    label: string;
-    value: "gt";
-  } | {
-    label: string;
-    value: "gte";
-  } | {
-    label: string;
-    value: "isBetween";
-  } | {
-    label: string;
-    value: "isEmpty";
-  } | {
-    label: string;
-    value: "isNotEmpty";
-  })[];
-  dateOperators: ({
-    label: string;
-    value: "eq";
-  } | {
-    label: string;
-    value: "ne";
-  } | {
-    label: string;
-    value: "lt";
-  } | {
-    label: string;
-    value: "gt";
-  } | {
-    label: string;
-    value: "lte";
-  } | {
-    label: string;
-    value: "gte";
-  } | {
-    label: string;
-    value: "isBetween";
-  } | {
-    label: string;
-    value: "isRelativeToToday";
-  } | {
-    label: string;
-    value: "isEmpty";
-  } | {
-    label: string;
-    value: "isNotEmpty";
-  })[];
-  selectOperators: ({
-    label: string;
-    value: "eq";
-  } | {
-    label: string;
-    value: "ne";
-  } | {
-    label: string;
-    value: "isEmpty";
-  } | {
-    label: string;
-    value: "isNotEmpty";
-  })[];
-  multiSelectOperators: ({
-    label: string;
-    value: "inArray";
-  } | {
-    label: string;
-    value: "notInArray";
-  } | {
-    label: string;
-    value: "isEmpty";
-  } | {
-    label: string;
-    value: "isNotEmpty";
-  })[];
-  booleanOperators: ({
-    label: string;
-    value: "eq";
-  } | {
-    label: string;
-    value: "ne";
-  })[];
-  sortOrders: ({
-    label: string;
-    value: "asc";
-  } | {
-    label: string;
-    value: "desc";
-  })[];
-  filterVariants: readonly ["text", "number", "range", "date", "dateRange", "boolean", "select", "multiSelect"];
-  operators: readonly ["iLike", "notILike", "eq", "ne", "inArray", "notInArray", "isEmpty", "isNotEmpty", "lt", "lte", "gt", "gte", "isBetween", "isRelativeToToday"];
-  joinOperators: readonly ["and", "or"];
+//#region src/lib/registries.d.ts
+type AutoCrudFormComponentConfig = {
+  component: React$1.ComponentType<any>;
+  decorator?: string | React$1.ComponentType<any>;
+  [key: string]: unknown;
+};
+type AutoCrudOption = {
+  value: string;
+  label: string;
+  searchText?: string | string[];
+  keywords?: string[];
+  count?: number;
+  disabled?: boolean;
+};
+type AutoCrudDataSourceContextType = 'form' | 'filter' | 'resolve';
+type AutoCrudDataSourceResolveFields = readonly string[] | ((context: {
+  field: string;
+}) => readonly string[]);
+type AutoCrudDataSourceContext = {
+  field: string;
+  type: AutoCrudDataSourceContextType;
+  page?: number;
+  pageSize?: number;
+  query?: string;
+  /** @deprecated Use `query` instead. */
+  search?: string;
+  values?: Record<string, unknown> | Record<string, unknown>[];
+  signal?: AbortSignal;
 };
+type AutoCrudDataSourceResult = AutoCrudOption[] | {
+  hasMore?: boolean;
+  options?: AutoCrudOption[];
+};
+type AutoCrudDataSourceLoader = (context: AutoCrudDataSourceContext) => AutoCrudDataSourceResult | Promise<AutoCrudDataSourceResult>;
+type AutoCrudDataSourceConfig = string;
+type AutoCrudDataSourceRegistration = AutoCrudDataSourceLoader | {
+  dependencies?: string[];
+  reset?: boolean;
+  search?: boolean;
+  debounceMs?: number;
+  loadMore?: boolean;
+  pageSize?: number;
+  resolveFields?: AutoCrudDataSourceResolveFields;
+  load: AutoCrudDataSourceLoader;
+};
+type AutoCrudDataSourceEntry = {
+  dependencies: string[];
+  reset: boolean;
+  search: boolean;
+  debounceMs: number;
+  loadMore: boolean;
+  pageSize: number;
+  resolveFields?: AutoCrudDataSourceResolveFields;
+  load: AutoCrudDataSourceLoader;
+};
+type RegistryListener$1 = () => void;
+declare const formComponents: {
+  register(name: string, value: AutoCrudFormComponentConfig): void;
+  unregister(name: string): void;
+  get(name: string): AutoCrudFormComponentConfig | undefined;
+  all(): Record<string, AutoCrudFormComponentConfig>;
+  subscribe(listener: RegistryListener$1): () => void;
+};
+declare const components: {
+  register(name: string, value: AutoCrudFormComponentConfig): void;
+  unregister(name: string): void;
+  get(name: string): AutoCrudFormComponentConfig | undefined;
+  all(): Record<string, AutoCrudFormComponentConfig>;
+  subscribe(listener: RegistryListener$1): () => void;
+};
+declare const dataSources: {
+  register(name: string, registration: AutoCrudDataSourceRegistration): void;
+  unregister: (name: string) => void;
+  get: (name: string) => AutoCrudDataSourceEntry | undefined;
+  all: () => Record<string, AutoCrudDataSourceEntry>;
+  subscribe: (listener: RegistryListener$1) => () => void;
+};
+declare function normalizeDataSourceConfig(config: AutoCrudDataSourceConfig | undefined): {
+  key: string;
+} | undefined;
+declare function normalizeOptions(result: AutoCrudDataSourceResult | undefined): AutoCrudOption[];
 //#endregion
-//#region src/lib/parsers.d.ts
-declare const filterItemSchema: z.ZodObject<{
-  id: z.ZodString;
-  value: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
-  variant: z.ZodEnum<{
-    number: "number";
-    boolean: "boolean";
-    text: "text";
-    range: "range";
-    date: "date";
-    dateRange: "dateRange";
-    select: "select";
-    multiSelect: "multiSelect";
-  }>;
-  operator: z.ZodEnum<{
-    iLike: "iLike";
-    notILike: "notILike";
-    eq: "eq";
-    ne: "ne";
-    isEmpty: "isEmpty";
-    isNotEmpty: "isNotEmpty";
-    lt: "lt";
-    lte: "lte";
-    gt: "gt";
-    gte: "gte";
-    isBetween: "isBetween";
-    isRelativeToToday: "isRelativeToToday";
-    inArray: "inArray";
-    notInArray: "notInArray";
-  }>;
-  filterId: z.ZodString;
-}, z.core.$strip>;
-type FilterItemSchema = z.infer<typeof filterItemSchema>;
-//#endregion
-//#region src/types/data-table.d.ts
-declare module '@tanstack/react-table' {
-  interface TableMeta<TData extends RowData> {
-    queryKeys?: QueryKeys;
-    queryStateOptions?: UrlStateOptions;
-  }
-  interface ColumnMeta<TData extends RowData, TValue> {
-    label?: string;
-    index?: number;
-    placeholder?: string;
-    variant?: FilterVariant$1;
-    options?: Option[];
-    range?: [number, number];
-    unit?: string;
-    icon?: React.FC<React.SVGProps<SVGSVGElement>>;
-    /** 控制在哪些筛选模式下显示（未设置则在所有模式显示） */
-    modes?: Array<'simple' | 'advanced' | 'command'>;
-    /** 内部：远程筛选选项搜索值 */
-    autoCrudFilterSearchValue?: string;
-    /** 内部：远程筛选选项搜索回调 */
-    autoCrudFilterOnSearch?: (value: string) => void;
-    /** 内部：是否启用本地选项过滤 */
-    autoCrudFilterShouldFilter?: boolean;
-    /** 内部：远程筛选当前弹窗选项，和稳定标签缓存分离 */
-    autoCrudFilterOptions?: Option[];
-    /** 内部：远程筛选是否还有更多选项 */
-    autoCrudFilterHasMore?: boolean;
-    /** 内部：远程筛选是否正在加载 */
-    autoCrudFilterLoading?: boolean;
-    /** 内部：远程筛选弹窗滚动回调 */
-    autoCrudFilterOnPopupScroll?: React.UIEventHandler<HTMLElement>;
-  }
-}
-interface QueryKeys {
-  page: string;
-  perPage: string;
-  sort: string;
-  filters: string;
-  joinOperator: string;
+//#region src/components/auto-crud/auto-crud-table.d.ts
+/**
+ * 筛选器独立配置
+ * 可独立于 table.meta 配置筛选器行为
+ */
+interface FilterConfig {
+  /** 是否启用筛选（默认跟随 table.meta.variant 推断） */
+  enabled?: boolean;
+  /** 筛选器类型 */
+  variant?: 'text' | 'number' | 'range' | 'date' | 'dateRange' | 'boolean' | 'select' | 'multiSelect';
+  /** select/multiSelect 的选项列表 */
+  options?: FieldOption[];
+  /** select/multiSelect 的动态选项源 */
+  dataSource?: AutoCrudDataSourceConfig;
+  /** range 的最小/最大值 */
+  range?: [number, number];
+  /** number 的单位 */
+  unit?: string;
+  /** 过滤器占位符 */
+  placeholder?: string;
+  /** 排序权重，数值越小越靠前 */
+  index?: number;
+  /** 是否在筛选栏中隐藏（隐藏筛选但不影响表格列显示） */
+  hidden?: boolean;
+  /** 控制在哪些筛选模式下显示（未设置则在所有模式显示） */
+  modes?: Array<'simple' | 'advanced' | 'command'>;
 }
-interface Option {
+interface FieldOption {
+  /** Optional semantic color and dot for status badges. */
+  badgeTone?: 'neutral' | 'success' | 'warning' | 'info';
   label: string;
   value: string;
-  searchText?: string;
+  searchText?: string | string[];
   count?: number;
-  icon?: React.FC<React.SVGProps<SVGSVGElement>>;
+  icon?: React$1.FC<React$1.SVGProps<SVGSVGElement>>;
+  disabled?: boolean;
+}
+type FieldTableDisplay = 'auto' | 'text' | 'badge' | 'date' | 'datetime';
+/**
+ * 统一字段配置
+ * 支持共用配置 + 表格/表单特定配置
+ */
+interface Field {
+  /** 字段标签（表格和表单共用） */
+  label?: string;
+  /** 字段级静态选项（表单、筛选、展示共用） */
+  enum?: FieldOption[];
+  /** 字段级动态选项源（表单、筛选、展示共用） */
+  dataSource?: AutoCrudDataSourceConfig;
+  /** 是否隐藏（表格和表单都隐藏） */
+  hidden?: boolean;
+  /** 是否参与 AutoCrud 全局搜索 */
+  search?: boolean;
+  /**
+   * 筛选器独立配置
+   * - FilterConfig: 详细配置
+   * - false: 禁用筛选（简写，等价于 { enabled: false }）
+   * 独立于 table.meta 控制筛选器行为，不影响表格列显示/隐藏
+   */
+  filter?: FilterConfig | false;
+  /**
+   * 表格特定配置
+   * - object: 详细配置
+   * - false: 隐藏表格列（简写，等价于 { hidden: true }）
+   */
+  table?: {
+    /** 是否在表格中隐藏 */
+    hidden?: boolean;
+    /** 表格列标签 */
+    label?: string;
+    /** 排序权重，数值越小越靠前 */
+    index?: number;
+    /** 仅用于表格展示的静态值标签；与 dataSource 同时配置时覆盖同值的动态标签 */
+    options?: FieldOption[];
+    /** 仅用于表格展示的动态值标签源 */
+    dataSource?: AutoCrudDataSourceConfig;
+    /** 声明式单元格展示模式；非 auto 模式会覆盖拥有方自定义 cell */
+    display?: FieldTableDisplay;
+    /** 该列的类名；th 应用于表头，td 应用于正文单元格 */
+    classNames?: ColumnMeta<unknown, unknown>['classNames'];
+    /** 列元数据 */
+    meta?: Record<string, unknown>;
+    /** 其他列配置 */
+    [key: string]: unknown;
+  } | false;
+  /**
+   * 表单特定配置
+   * - object: 详细配置（Formily Schema）
+   * - false: 隐藏表单字段（简写，等价于 { "x-hidden": true }）
+   */
+  form?: {
+    /** 是否在表单中隐藏 */
+    'x-hidden'?: boolean;
+    /** 组件类型 */
+    'x-component'?: string;
+    /** 组件属性 */
+    'x-component-props'?: Record<string, unknown>;
+    /** 其他表单配置 */
+    [key: string]: unknown;
+  } | false;
+}
+type Fields = Record<string, Field>;
+/** 内置操作项（覆盖默认行为或调整位置） */
+type ActionMeta = {
+  id?: string;
+  order?: number;
+  hidden?: boolean;
+};
+type AutoCrudRowOpenOptions<T> = {
+  type: 'view' | 'edit' | 'copy' | 'delete';
+  row: T;
+} | {
+  type: 'custom';
+  component: React$1.ReactElement<RowActionDialogProps>;
+};
+interface AutoCrudRowActionContext<T> {
+  /** Unified entry point. Unavailable built-in operations are ignored. */
+  open: (options: AutoCrudRowOpenOptions<T>) => void;
+  /** Menu primitive from the same runtime instance as the owning menu. */
+  MenuItem: typeof DropdownMenuItem$1;
+  crudId: string;
+  idKey: string;
+  row: T;
+  rowId?: string;
+  openView: (row: T) => void;
+  openEdit?: (row: T) => void;
+  copyRow?: (row: T) => void;
+  openDelete?: (row: T) => void;
+}
+type ActionComponent<TContext> = React$1.ReactNode | ((context: TContext) => React$1.ReactNode);
+type RowBuiltinActionType = 'view' | 'edit' | 'copy' | 'delete';
+type RowBuiltinActionItem<T> = ActionMeta & {
+  type: RowBuiltinActionType;
+  onClick?: (row: T) => void;
+  label?: string;
+  separator?: boolean;
+};
+type RowCustomActionItem<T> = ActionMeta & {
+  type: 'custom';
+  label?: string;
+  onClick?: (row: T) => void;
+  component?: ActionComponent<AutoCrudRowActionContext<T>>;
+  position?: 'start' | 'end';
+  separator?: boolean;
+  variant?: 'default' | 'destructive';
+};
+/**
+ * Row action item.
+ *
+ * - Custom-only config keeps builtin row actions and appends custom actions.
+ * - Including any builtin type takes over builtin ordering.
+ */
+type RowActionItem<T> = RowBuiltinActionItem<T> | RowCustomActionItem<T>;
+type RowActionConfig<T> = RowActionItem<T>[] | ((defaults: RowBuiltinActionItem<T>[]) => RowActionItem<T>[]);
+/** @deprecated Use RowActionItem instead. */
+type ActionItem<T> = RowActionItem<T>;
+/** @deprecated Use RowActionConfig instead. */
+type ActionConfig<T> = RowActionConfig<T>;
+type AutoCrudActionsConfig<T> = {
+  toolbar?: ToolbarActionConfig;
+  row?: RowActionConfig<T>;
+  batch?: BatchActionConfig<T>;
+};
+type AutoCrudActionConfig<T> = RowActionConfig<T> | AutoCrudActionsConfig<T>;
+/**
+ * 顶部工具栏内置操作项
+ */
+type ToolbarBuiltinActionType = 'refresh' | 'create' | 'import' | 'export';
+type ToolbarBuiltinActionItem = ActionMeta & {
+  type: ToolbarBuiltinActionType;
+  /** 替代默认的行为 */
+  onClick?: () => void;
+  /** 替代默认的标签文本 */
+  label?: string;
+  /** 替代整个按钮的渲染 */
+  component?: ActionComponent<AutoCrudToolbarContext>;
+};
+/**
+ * 顶部工具栏自定义操作项
+ */
+type ToolbarCustomActionItem = ActionMeta & {
+  type: 'custom';
+  /** 渲染自定义内容 */
+  component: ActionComponent<AutoCrudToolbarContext>;
+  /** 仅在无内置项时生效：插入到首部还是尾部（默认 end） */
+  position?: 'start' | 'end';
+};
+type ToolbarActionItem = ToolbarBuiltinActionItem | ToolbarCustomActionItem;
+type ToolbarActionConfig = ToolbarActionItem[] | ((defaults: ToolbarBuiltinActionItem[]) => ToolbarActionItem[]);
+interface AutoCrudToolbarContext {
+  crudId: string;
+  idKey: string;
+  rowIds: string[];
+  selectedRowIds: string[];
+  selectedCount: number;
+  refresh?: () => Promise<unknown>;
+  openImport?: () => void;
+  exportData?: () => Promise<void>;
+  openCreate?: () => void;
+  isRefreshing: boolean;
+  isExporting: boolean;
 }
-type FilterOperator = DataTableConfig['operators'][number];
-type FilterVariant$1 = DataTableConfig['filterVariants'][number];
-type JoinOperator = DataTableConfig['joinOperators'][number];
-interface ExtendedColumnSort<TData> extends Omit<ColumnSort, 'id'> {
-  id: Extract<keyof TData, string>;
+type AutoCrudToolbarResolver = (targetId: string, ownerActions: readonly ToolbarActionItem[], context: AutoCrudToolbarContext) => ToolbarActionItem[];
+declare function setToolbarResolver(resolver: AutoCrudToolbarResolver | null): void;
+/**
+ * AutoCrudTable Props 接口
+ */
+interface AutoCrudTableProps<TSchema extends z.ZodObject<z.ZodRawShape>> {
+  /** Public CRUD id. Used by hosts to document the extension target. */
+  id?: string;
+  /** 页面标题 */
+  title?: string;
+  /** 页面描述 */
+  description?: string;
+  /** Zod schema */
+  schema: TSchema;
+  /** useAutoCrudResource hook 返回值 */
+  resource: UseAutoCrudResourceReturn<TSchema, z.output<TSchema>>;
+  /**
+   * 统一字段配置
+   * 支持共用配置（label, hidden）+ 表格/表单特定配置
+   */
+  fields?: Fields;
+  /** Detail presentation shares field formatting by default. */
+  view?: {
+    /** Explicitly reuse custom list cells with a separate, single-row table context. */
+    presentation?: 'table';
+    /** Detail-only column overrides; the list presentation is unchanged. */
+    overrides?: NonNullable<Parameters<typeof createTableSchema<TSchema>>[1]>['overrides'];
+  };
+  /** 表格配置 */
+  table?: {
+    /** 按元素分组的全局表格类名；列级 th/td 类名优先 */
+    classNames?: DataTableClassNames;
+    /** 隐藏的列 */
+    hidden?: string[];
+    /** 列覆盖配置 */
+    overrides?: Record<string, any>;
+    /**
+     * 过滤模式配置
+     * - 单个值: 只使用该模式，不显示切换按钮
+     * - 数组: 第一个为默认值，显示切换按钮
+     */
+    filterModes?: FilterMode | FilterMode[];
+    /** 全局搜索框；默认在存在 search: true 字段时显示 */
+    search?: boolean | {
+      placeholder?: string;
+    };
+    /**
+     * 批量更新字段配置
+     * - 只需传字段名数组，options 自动从 schema enum 推导
+     * - 也可以传完整配置覆盖 label 或 options
+     */
+    batchFields?: (string | BatchUpdateField)[];
+    /**
+     * 多选后悬浮批量操作栏配置
+     * 用法类同 `actions` 行操作和 `toolbar` 顶部工具栏。
+     * 只传 custom 时保留默认批量操作；包含任意内置 type 时完全接管顺序。
+     * @deprecated Use actions.batch instead.
+     */
+    batchActions?: BatchActionConfig<z.output<TSchema>>;
+    /** 默认排序 */
+    defaultSort?: any[];
+  };
+  /** 表单配置 */
+  form?: {
+    /** 表单覆盖配置（兼容旧 API，优先级低于 fieldOverrides） */
+    overrides?: Record<string, any>;
+    /** Formily schema expression/reaction scope */
+    scope?: JsonSchemaFormScope;
+    /** 表单列数 */
+    columns?: number;
+    /** 弹窗自定义容器类名（支持控制大小、最大高度等） */
+    className?: string;
+  };
+  /** 行操作配置，或统一的 toolbar/row/batch 操作配置。 */
+  actions?: AutoCrudActionConfig<z.output<TSchema>>;
+  /**
+   * 顶层工具栏操作配置
+   * 用法类同 `actions` 行操作。一旦配置了包含内置 `type` 的数组，它将完全接管右侧工具栏！
+   * @deprecated Use actions.toolbar instead.
+   */
+  toolbar?: ToolbarActionConfig;
+  /** @deprecated Use toolbar instead. */
+  toolbarActions?: ToolbarActionConfig;
+  /**
+   * 权限配置
+   * 控制按钮显示和字段访问
+   *
+   * @example
+   * ```tsx
+   * const permissions = useMemo(() => ({
+   *   can: {
+   *     create: user.role === 'admin',
+   *     update: user.role === 'admin' || user.role === 'editor',
+   *     delete: user.role === 'admin',
+   *     export: true,
+   *     import: true,
+   *   },
+   *   deny: user.role === 'user' ? ['salary', 'ssn'] : [],
+   * }), [user.role]);
+   *
+   * <AutoCrudTable permissions={permissions} ... />
+   * ```
+   */
+  permissions?: CrudPermissions;
+  /**
+   * 语言配置
+   * - 内置语言 key：`"zh-CN"`（默认）、`"en-US"`
+   * - 部分覆盖对象：以 zh-CN 为基础深合并
+   *
+   * @example
+   * ```tsx
+   * <AutoCrudTable locale="en-US" ... />
+   * <AutoCrudTable locale={{ toolbar: { create: "Add New" } }} ... />
+   * ```
+   */
+  locale?: LocaleProp;
+  /**
+   * 自定义新建按钮点击事件
+   * 如果提供，将覆盖默认的打开新建弹窗行为
+   */
+  onCreate?: () => void;
 }
-interface ExtendedColumnFilter<TData> extends FilterItemSchema {
-  id: Extract<keyof TData, string>;
+/**
+ * AutoCrudTable 组件
+ *
+ * 高级 CRUD 表格组件，封装了完整的增删改查流程
+ */
+declare function AutoCrudTable<TSchema extends z.ZodObject<z.ZodRawShape>>({
+  id,
+  title,
+  description,
+  schema,
+  resource,
+  fields,
+  table: tableConfig,
+  form: formConfig,
+  view: viewConfig,
+  permissions,
+  actions: actionItems,
+  toolbar,
+  toolbarActions,
+  locale: localeProp,
+  onCreate
+}: 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>> {
+  schema: T;
+  initialValues?: Partial<z.infer<T>>;
+  onSubmit: (values: z.infer<T>) => void | Promise<void>;
+  /** 统一字段配置，推荐用于描述 auto-crud 字段级表单行为 */
+  fields?: Fields;
+  /** Formily 字段 schema 覆盖配置，保留兼容旧 API */
+  overrides?: FormSchemaOverrides;
+  /** Formily schema expression/reaction scope */
+  scope?: JsonSchemaFormScope;
+  mode?: 'create' | 'edit';
+  loading?: boolean;
+  gridColumns?: number;
+  /** Label 对齐方式 */
+  labelAlign?: 'left' | 'top' | 'right';
+  /** Label 宽度（labelAlign 为 left 时有效） */
+  labelWidth?: number | string;
+  /** 是否显示提交按钮（默认 true） */
+  showSubmitButton?: boolean;
 }
-interface DataTableRowAction<TData> {
-  row: Row<TData>;
-  variant: 'update' | 'delete';
+interface AutoFormRef {
+  submit: () => Promise<void>;
 }
+declare function AutoFormInner<T extends z.ZodObject<z.ZodRawShape>>({
+  schema: zodSchema,
+  initialValues,
+  onSubmit,
+  fields,
+  overrides,
+  scope: scopeProp,
+  mode,
+  loading,
+  gridColumns,
+  labelAlign,
+  labelWidth,
+  showSubmitButton
+}: 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>;
 //#endregion
 //#region src/components/auto-crud/auto-table-simple-filters.d.ts
 interface AutoTableSimpleFiltersProps<TData> {
@@ -1539,6 +1591,7 @@ declare function ExportDialog({
 //#region src/components/data-table/data-table.d.ts
 interface DataTableProps<TData> extends React$1.ComponentProps<'div'> {
   table: Table<TData>;
+  classNames?: DataTableClassNames;
   actionBar?: React$1.ReactNode;
 }
 declare function DataTable<TData>({
@@ -1546,6 +1599,7 @@ declare function DataTable<TData>({
   actionBar,
   children,
   className,
+  classNames,
   ...props
 }: DataTableProps<TData>): react_jsx_runtime2.JSX.Element;
 //#endregion
@@ -1917,13 +1971,19 @@ declare function createMemoryDataSource<T extends {
 //#region src/lib/format.d.ts
 type DateFormatPreset = 'date' | 'datetime';
 type DateFormatter = (date: Date, options: Intl.DateTimeFormatOptions, preset?: DateFormatPreset) => string;
+interface DateLocaleOptions {
+  locale: string;
+  /** Host policy metadata; calendar days are not shifted into this zone.
+   * Configure the server's resolveDateRange separately for query boundaries.
+   */
+  timeZone: string;
+}
 /**
- * Register the host's process-wide date presentation policy without coupling
- * AutoCrud to locale or timezone selection. The returned cleanup removes only
- * this registration, so overlapping registrations may be disposed out of order.
+ * Register the host's date formatter and optional calendar locale policy.
+ * Cleanup removes only this registration, including out-of-order cleanup.
  * Passing undefined clears every registration.
  */
-declare function setDateFormatter(formatter?: DateFormatter): () => void;
+declare function setDateFormatter(formatter?: DateFormatter, options?: DateLocaleOptions): () => void;
 declare function formatDate(date: Date | string | number | undefined, opts?: Intl.DateTimeFormatOptions, preset?: DateFormatPreset): string;
 //#endregion
 //#region src/lib/humanize.d.ts
@@ -2004,4 +2064,4 @@ declare function exportAllToCSV<T extends Record<string, unknown>>(data: T[], op
  */
 declare function downloadCSVTemplate(headers: string[], filename?: string): void;
 //#endregion
-export { type ActionConfig, type ActionItem, type ActionsColumnConfig, type AutoCrudActionConfig, type AutoCrudActionsConfig, type AutoCrudDataSourceConfig, type AutoCrudDataSourceContext, type AutoCrudDataSourceEntry, type AutoCrudDataSourceLoader, type AutoCrudDataSourceRegistration, type AutoCrudFormComponentConfig, type AutoCrudLocale, type AutoCrudOption, type AutoCrudQueryCapabilities, type AutoCrudRowActionContext, AutoCrudTable, type AutoCrudTableProps, type AutoCrudToolbarContext, type AutoCrudToolbarResolver, AutoForm, type AutoFormProps, type AutoQueryParams, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, type BatchActionConfig, type BatchActionContext, type BatchActionItem, type BatchBuiltinActionItem, type BatchBuiltinActionType, type BatchCustomActionItem, type BatchUpdateField, type ColumnOverrides, type CreateFormSchemaOptions, type CreateTableSchemaOptions, type CrudActionBase, type CrudActionEntry, type CrudActionRegistration, type CrudActionZone, CrudFormModal, type CrudHooks, type CrudOperationPermissions, type CrudPermissions, type DataSource, DataTable, DataTableAdvancedToolbar, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableRowAction, DataTableToolbar, DataTableViewOptions, type DateFormatPreset, type DateFormatter, type EnumOption, ExportDialog, type ExportDialogProps, type ExportMode, ExtendedColumnFilter, ExtendedColumnSort, type Field, type FieldOption, type FieldTableDisplay, type FieldType, type Fields, type FilterConfig, FilterOperator, type FilterVariant, type FormSchemaOverrides, ImportDialog, type ImportDialogProps, type ImportResult, type JSONSchema, type JSONSchemaProperty, JoinOperator, type ListParams, type ListResult, type LocaleProp, MultiCombobox, type MultiComboboxOption, type MultiComboboxProps, type MultiComboboxTriggerRenderProps, Option, type ParsedImportData, type ParsedZodField, type Parser, QueryKeys, type RowActionConfig, type RowActionItem, type RowBuiltinActionItem, type RowBuiltinActionType, type RowCustomActionItem, SchemaAdapter, Select, type SelectMode, type SelectOption, type SelectProps, type SelectSearchableDynamicProps, type SelectSearchableMultipleProps, type SelectSearchableProps, type SelectSearchableSingleProps, type SelectSimpleProps, type SelectTriggerRenderProps, type SimpleFieldConfig, type SimpleFieldsConfig, type ToastAdapter, type ToolbarActionConfig, type ToolbarActionItem, type ToolbarBuiltinActionItem, type ToolbarBuiltinActionType, type ToolbarCustomActionItem, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, type UseAutoCrudResourceParams, type UseAutoCrudResourceReturn, cn, coerceRowValues, components, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, crudActions, dataSources, dataToCSV, deDE, downloadCSVTemplate, enUS, esES, exportAllToCSV, exportTableToCSV, formComponents, formatDate, frFR, generateCSVTemplate, getUrlParams, humanize, jaJP, koKR, noopToastAdapter, normalizeDataSourceConfig, normalizeOptions, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseCSV, parseImportFile, parseJSON, parseZodField, resolveLocale, setDateFormatter, setSearchParams, setToolbarResolver, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates, zhCN };
+export { type ActionConfig, type ActionItem, type ActionsColumnConfig, type AutoCrudActionConfig, type AutoCrudActionsConfig, type AutoCrudDataSourceConfig, type AutoCrudDataSourceContext, type AutoCrudDataSourceEntry, type AutoCrudDataSourceLoader, type AutoCrudDataSourceRegistration, type AutoCrudFormComponentConfig, type AutoCrudLocale, type AutoCrudOption, type AutoCrudQueryCapabilities, type AutoCrudRowActionContext, type AutoCrudRowOpenOptions, AutoCrudTable, type AutoCrudTableProps, type AutoCrudToolbarContext, type AutoCrudToolbarResolver, AutoForm, type AutoFormProps, type AutoQueryParams, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, type BatchActionConfig, type BatchActionContext, type BatchActionItem, type BatchBuiltinActionItem, type BatchBuiltinActionType, type BatchCustomActionItem, type BatchUpdateField, type ColumnOverrides, type CreateFormSchemaOptions, type CreateTableSchemaOptions, type CrudActionBase, type CrudActionEntry, type CrudActionRegistration, type CrudActionZone, CrudFormModal, type CrudHooks, type CrudOperationPermissions, type CrudPermissions, type DataSource, DataTable, DataTableAdvancedToolbar, DataTableClassNames, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableRowAction, DataTableToolbar, DataTableViewOptions, type DateFormatPreset, type DateFormatter, type DateLocaleOptions, type EnumOption, ExportDialog, type ExportDialogProps, type ExportMode, ExtendedColumnFilter, ExtendedColumnSort, type Field, type FieldOption, type FieldTableDisplay, type FieldType, type Fields, type FilterConfig, FilterOperator, type FilterVariant, type FormSchemaOverrides, ImportDialog, type ImportDialogProps, type ImportResult, type JSONSchema, type JSONSchemaProperty, JoinOperator, type ListParams, type ListResult, type LocaleProp, MultiCombobox, type MultiComboboxOption, type MultiComboboxProps, type MultiComboboxTriggerRenderProps, Option, type ParsedImportData, type ParsedZodField, type Parser, QueryKeys, type RowActionConfig, type RowActionDialogProps, type RowActionItem, type RowBuiltinActionItem, type RowBuiltinActionType, type RowCustomActionItem, SchemaAdapter, Select, type SelectMode, type SelectOption, type SelectProps, type SelectSearchableDynamicProps, type SelectSearchableMultipleProps, type SelectSearchableProps, type SelectSearchableSingleProps, type SelectSimpleProps, type SelectTriggerRenderProps, type SimpleFieldConfig, type SimpleFieldsConfig, type ToastAdapter, type ToolbarActionConfig, type ToolbarActionItem, type ToolbarBuiltinActionItem, type ToolbarBuiltinActionType, type ToolbarCustomActionItem, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, type UseAutoCrudResourceParams, type UseAutoCrudResourceReturn, cn, coerceRowValues, components, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, crudActions, dataSources, dataToCSV, deDE, downloadCSVTemplate, enUS, esES, exportAllToCSV, exportTableToCSV, formComponents, formatDate, frFR, generateCSVTemplate, getUrlParams, humanize, jaJP, koKR, noopToastAdapter, normalizeDataSourceConfig, normalizeOptions, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseCSV, parseImportFile, parseJSON, parseZodField, resolveLocale, setDateFormatter, setSearchParams, setToolbarResolver, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates, zhCN };