@wordrhyme/auto-crud 0.2.0

package/dist/index.d.cts

@@ -0,0 +1,1165 @@
+import * as react_jsx_runtime8 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";
+import * as React$1 from "react";
+import { ISchema } from "@formily/json-schema";
+import { DropdownMenuTrigger, PopoverContent } from "@pixpilot/shadcn";
+import { ClassValue } from "clsx";
+
+//#region src/hooks/use-auto-crud-resource.d.ts
+/**
+ * Toast 适配器接口
+ * 用户可以注入自己的 toast 实现
+ */
+interface ToastAdapter {
+  success: (message: string) => void;
+  error: (message: string) => void;
+  info?: (message: string) => void;
+  warning?: (message: string) => void;
+}
+/** 空 toast 适配器（禁用通知） */
+declare const noopToastAdapter: ToastAdapter;
+/**
+ * Modal 状态类型
+ */
+type ModalVariant$1 = "dialog" | "sheet";
+interface ModalState<T> {
+  createOpen: boolean;
+  editOpen: boolean;
+  deleteOpen: boolean;
+  viewOpen: boolean;
+  selected: T | null;
+  /** 复制源数据（用于复制行功能） */
+  copySource: T | null;
+  variant: ModalVariant$1;
+}
+/**
+ * Hook 返回值类型（用于判断是数据转换还是完全自定义）
+ * - 返回对象 = 数据转换，继续执行默认 mutation
+ * - 返回 true/false = 完全自定义，跳过默认 mutation
+ */
+type HookResult<T> = T | boolean;
+/**
+ * 统一的 hooks 配置
+ */
+interface CrudHooks<TSchema extends z.ZodObject<z.ZodRawShape>, TListItem> {
+  /**
+   * 创建前钩子
+   * - 返回对象: 作为转换后的数据，继续执行默认创建
+   * - 返回 true: 表示已自定义处理成功，跳过默认创建
+   * - 返回 false: 表示自定义处理失败，跳过默认创建
+   */
+  beforeCreate?: (values: z.infer<TSchema>) => HookResult<z.infer<TSchema>> | Promise<HookResult<z.infer<TSchema>>>;
+  /**
+   * 更新前钩子
+   * - 返回对象: 作为转换后的数据，继续执行默认更新
+   * - 返回 true/false: 完全自定义处理
+   */
+  beforeUpdate?: (values: z.infer<TSchema>, original: TListItem) => HookResult<z.infer<TSchema>> | Promise<HookResult<z.infer<TSchema>>>;
+  /**
+   * 删除前钩子
+   * - 返回 true: 表示已自定义处理成功（如软删除）
+   * - 返回 false: 表示自定义处理失败
+   * - 返回 undefined/void: 继续执行默认删除
+   */
+  beforeDelete?: (item: TListItem) => boolean | void | Promise<boolean | void>;
+  /** 操作成功回调 */
+  onSuccess?: (op: "create" | "update" | "delete", payload: unknown) => void;
+  /** 操作失败回调 */
+  onError?: (op: "create" | "update" | "delete", error: Error) => void;
+}
+/**
+ * Hook 配置选项
+ */
+interface UseAutoCrudResourceOptions<TSchema extends z.ZodObject<z.ZodRawShape>, TListItem> {
+  /** 主键字段名（默认: "id"） */
+  idKey?: keyof TListItem & string;
+  /** 默认弹窗模式 */
+  defaultVariant?: ModalVariant$1;
+  /** 统一钩子配置 */
+  hooks?: CrudHooks<TSchema, TListItem>;
+  /**
+   * Toast 配置
+   * - undefined: 使用内置 sonner（默认）
+   * - false: 禁用所有通知
+   * - ToastAdapter: 注入自定义 toast 实现
+   */
+  toast?: ToastAdapter | false;
+}
+/**
+ * Hook 返回值类型
+ */
+interface UseAutoCrudResourceReturn<TSchema extends z.ZodObject<z.ZodRawShape>, TListItem> {
+  tableData: {
+    data: TListItem[];
+    pageCount: number;
+    isLoading: boolean;
+    /** 是否正在获取数据（用于显示微妙的加载指示器） */
+    isFetching: boolean;
+  };
+  modal: ModalState<TListItem>;
+  mutations: {
+    isCreating: boolean;
+    isUpdating: boolean;
+    isDeleting: boolean;
+  };
+  handlers: {
+    openCreate: () => void;
+    openEdit: (row: TListItem) => void;
+    openDelete: (row: TListItem) => void;
+    openView: (row: TListItem) => void;
+    copyRow: (row: TListItem) => void;
+    closeModals: () => void;
+    submitCreate: (values: z.infer<TSchema>) => void;
+    submitUpdate: (values: z.infer<TSchema>) => void;
+    confirmDelete: () => void;
+    deleteMany: (rows: TListItem[]) => void;
+    updateMany: (rows: TListItem[], data: Record<string, unknown>) => void;
+    setVariant: (variant: ModalVariant$1) => void;
+  };
+}
+/**
+ * tRPC Router 接口定义（宽松类型以兼容实际 tRPC router）
+ */
+interface CrudRouter {
+  list: {
+    useQuery: (input?: any, opts?: any) => any;
+  };
+  create: {
+    useMutation: (opts?: any) => any;
+  };
+  update: {
+    useMutation: (opts?: any) => any;
+  };
+  delete: {
+    useMutation: (opts?: any) => any;
+  };
+  deleteMany?: {
+    useMutation: (opts?: any) => any;
+  };
+  updateMany?: {
+    useMutation: (opts?: any) => any;
+  };
+}
+/**
+ * Hook 配置参数
+ */
+interface UseAutoCrudResourceParams<TSchema extends z.ZodObject<z.ZodRawShape>, TListItem> {
+  /** tRPC router (如 trpc.tasks) */
+  router: CrudRouter;
+  /** 列表查询参数 */
+  queryInput?: any;
+  /** Zod schema */
+  schema: TSchema;
+  /** 其他配置选项 */
+  options?: UseAutoCrudResourceOptions<TSchema, TListItem>;
+}
+/**
+ * Hook 主函数
+ */
+declare function useAutoCrudResource<TSchema extends z.ZodObject<z.ZodRawShape>, TListItem = z.output<TSchema>>({
+  router,
+  queryInput,
+  options
+}: UseAutoCrudResourceParams<TSchema, TListItem>): UseAutoCrudResourceReturn<TSchema, TListItem>;
+//#endregion
+//#region src/components/auto-crud/auto-table-action-bar.d.ts
+/** 批量更新字段配置 */
+interface BatchUpdateField {
+  /** 字段名 */
+  field: string;
+  /** 显示标签 */
+  label: string;
+  /** 可选值 */
+  options: Array<{
+    label: string;
+    value: string;
+  }>;
+}
+interface AutoTableActionBarProps<TData> {
+  table: Table<TData>;
+  onDeleteSelected?: (rows: TData[]) => void;
+  /** 批量更新回调 */
+  onUpdateSelected?: (rows: TData[], data: Record<string, unknown>) => void;
+  /** 批量更新字段配置 */
+  batchUpdateFields?: BatchUpdateField[];
+  /** 是否启用导出功能 */
+  enableExport?: boolean;
+  /** 是否启用删除功能 */
+  enableDelete?: boolean;
+  /** 额外的操作按钮 */
+  extraActions?: React$1.ReactNode;
+}
+declare function AutoTableActionBar<TData>({
+  table,
+  onDeleteSelected,
+  onUpdateSelected,
+  batchUpdateFields,
+  enableExport,
+  enableDelete,
+  extraActions
+}: AutoTableActionBarProps<TData>): react_jsx_runtime8.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;
+} }>;
+/**
+ * Formily Schema 覆盖选项
+ */
+type FormSchemaOverrides = Record<string, Partial<ISchema>>;
+/**
+ * createColumns 选项
+ */
+interface CreateColumnsOptions<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 创建 ColumnDef 数组
+ */
+declare function createColumns<T extends z.ZodObject<z.ZodRawShape>>(schema: T, options?: CreateColumnsOptions<z.infer<T>>): ColumnDef<z.infer<T>>[];
+/**
+ * 创建选择列
+ */
+declare function createSelectColumn<T>(): ColumnDef<T>;
+/**
+ * 操作列配置
+ */
+interface ActionsColumnConfig<T> {
+  onEdit?: (row: T) => void;
+  onDelete?: (row: T) => void;
+  onView?: (row: T) => void;
+  onCopy?: (row: T) => void;
+}
+/**
+ * 创建操作列
+ */
+declare function createActionsColumn<T>(config: 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;
+  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[];
+  /** 批量删除回调 */
+  onDeleteSelected?: (rows: z.infer<T>[]) => void;
+  /** 批量更新回调 */
+  onUpdateSelected?: (rows: z.infer<T>[], data: Record<string, unknown>) => void;
+  /** 批量更新字段配置 */
+  batchUpdateFields?: BatchUpdateField[];
+  /** 批量操作栏额外按钮 */
+  actionBarExtra?: React.ReactNode;
+  /** 初始排序 */
+  initialSorting?: any[];
+}
+declare function AutoTable<T extends z.ZodObject<z.ZodRawShape>>({
+  schema,
+  data,
+  pageCount,
+  overrides,
+  enableRowSelection,
+  exclude,
+  actions,
+  pinnedColumns,
+  filterMode,
+  onDeleteSelected,
+  onUpdateSelected,
+  batchUpdateFields,
+  actionBarExtra,
+  initialSorting
+}: AutoTableProps<T>): react_jsx_runtime8.JSX.Element;
+//#endregion
+//#region src/components/auto-crud/auto-crud-table.d.ts
+/**
+ * 统一字段配置
+ * 支持共用配置 + 表格/表单特定配置
+ */
+interface Field {
+  /** 字段标签（表格和表单共用） */
+  label?: string;
+  /** 是否隐藏（表格和表单都隐藏） */
+  hidden?: boolean;
+  /** 表格特定配置 */
+  table?: {
+    /** 是否在表格中隐藏 */
+    hidden?: boolean;
+    /** 筛选器配置 */
+    meta?: Record<string, unknown>;
+    /** 其他列配置 */
+    [key: string]: unknown;
+  };
+  /** 表单特定配置 */
+  form?: {
+    /** 是否在表单中隐藏 */
+    "x-hidden"?: boolean;
+    /** 组件类型 */
+    "x-component"?: string;
+    /** 组件属性 */
+    "x-component-props"?: Record<string, unknown>;
+    /** 其他表单配置 */
+    [key: string]: unknown;
+  };
+}
+type Fields = Record<string, Field>;
+/**
+ * AutoCrudTable Props 接口
+ */
+interface AutoCrudTableProps<TSchema extends z.ZodObject<z.ZodRawShape>> {
+  /** 页面标题 */
+  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[];
+    /**
+     * 批量更新字段配置
+     * - 只需传字段名数组，options 自动从 schema enum 推导
+     * - 也可以传完整配置覆盖 label 或 options
+     */
+    batchFields?: (string | BatchUpdateField)[];
+    /** 默认排序 */
+    defaultSort?: any[];
+  };
+  /** 表单配置 */
+  form?: {
+    /** 表单覆盖配置 */
+    overrides?: Record<string, any>;
+    /** 表单列数 */
+    columns?: number;
+  };
+  /** 扩展点 */
+  slots?: {
+    /** 工具栏左侧插槽 */
+    toolbarStart?: React.ReactNode;
+    /** 工具栏右侧插槽 */
+    toolbarEnd?: React.ReactNode;
+    /** 自定义行操作 */
+    rowActions?: (row: z.output<TSchema>) => Array<{
+      label: string;
+      onClick: () => void;
+    }>;
+  };
+}
+/**
+ * AutoCrudTable 组件
+ *
+ * 高级 CRUD 表格组件，封装了完整的增删改查流程
+ */
+declare function AutoCrudTable<TSchema extends z.ZodObject<z.ZodRawShape>>({
+  title,
+  description,
+  schema,
+  resource,
+  fields,
+  table: tableConfig,
+  form: formConfig,
+  slots
+}: AutoCrudTableProps<TSchema>): react_jsx_runtime8.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>;
+  overrides?: FormSchemaOverrides;
+  mode?: "create" | "edit";
+  loading?: boolean;
+  gridColumns?: number;
+  /** Label 对齐方式 */
+  labelAlign?: "left" | "top" | "right";
+  /** Label 宽度（labelAlign 为 left 时有效） */
+  labelWidth?: number | string;
+  /** 是否显示提交按钮（默认 true） */
+  showSubmitButton?: boolean;
+}
+interface AutoFormRef {
+  submit: () => Promise<void>;
+}
+declare function AutoFormInner<T extends z.ZodObject<z.ZodRawShape>>({
+  schema: zodSchema,
+  initialValues,
+  onSubmit,
+  overrides,
+  mode,
+  loading,
+  gridColumns,
+  labelAlign,
+  labelWidth,
+  showSubmitButton
+}: AutoFormProps<T>, ref: React.Ref<AutoFormRef>): react_jsx_runtime8.JSX.Element;
+declare const AutoForm: <T extends z.ZodObject<z.ZodRawShape>>(props: AutoFormProps<T> & {
+  ref?: React.Ref<AutoFormRef>;
+}) => ReturnType<typeof AutoFormInner>;
+//#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"];
+};
+//#endregion
+//#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 Parser<T> {
+  parse: (value: string) => T;
+  serialize: (value: T) => string;
+}
+declare const parseAsInteger: Parser<number> & {
+  withDefault: (defaultValue: number) => Parser<number> & {
+    defaultValue: number;
+  };
+};
+declare const parseAsString: Parser<string> & {
+  withDefault: (defaultValue: string) => Parser<string> & {
+    defaultValue: string;
+  };
+};
+declare function parseAsStringEnum<T extends string>(validValues: readonly T[]): Parser<T | null> & {
+  withDefault: (defaultValue: T) => Parser<T> & {
+    defaultValue: 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 状态参数
+ */
+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>];
+/**
+ * nuqs 兼容层 - useQueryStates
+ */
+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/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;
+  }
+  interface ColumnMeta<TData extends RowData, TValue> {
+    label?: string;
+    placeholder?: string;
+    variant?: FilterVariant$1;
+    options?: Option[];
+    range?: [number, number];
+    unit?: string;
+    icon?: React.FC<React.SVGProps<SVGSVGElement>>;
+  }
+}
+interface QueryKeys {
+  page: string;
+  perPage: string;
+  sort: string;
+  filters: string;
+  joinOperator: string;
+}
+interface Option {
+  label: string;
+  value: string;
+  count?: number;
+  icon?: React.FC<React.SVGProps<SVGSVGElement>>;
+}
+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-simple-filters.d.ts
+interface AutoTableSimpleFiltersProps<TData> {
+  table: Table<TData>;
+  shallow?: boolean;
+  filters?: ExtendedColumnFilter<TData>[];
+  onFiltersChange?: (filters: ExtendedColumnFilter<TData>[]) => void;
+}
+declare function AutoTableSimpleFilters<TData>({
+  table,
+  shallow,
+  filters: externalFilters,
+  onFiltersChange
+}: AutoTableSimpleFiltersProps<TData>): react_jsx_runtime8.JSX.Element | null;
+//#endregion
+//#region src/components/auto-crud/form-modal.d.ts
+type ModalVariant = "dialog" | "sheet";
+//#endregion
+//#region src/components/auto-crud/crud-form-modal.d.ts
+interface CrudFormModalProps<T extends z.ZodObject<z.ZodRawShape>> {
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+  mode: "create" | "edit";
+  schema: T;
+  initialValues?: Partial<z.infer<T>>;
+  onSubmit: (values: z.infer<T>) => void | Promise<void>;
+  loading?: boolean;
+  variant?: ModalVariant;
+  overrides?: FormSchemaOverrides;
+  title?: string;
+  /** Label 对齐方式 */
+  labelAlign?: "left" | "top" | "right";
+  /** Label 宽度（labelAlign 为 left 时有效） */
+  labelWidth?: number | string;
+}
+declare function CrudFormModal<T extends z.ZodObject<z.ZodRawShape>>({
+  open,
+  onOpenChange,
+  mode,
+  schema,
+  initialValues,
+  onSubmit,
+  loading,
+  variant,
+  overrides,
+  title,
+  labelAlign,
+  labelWidth
+}: CrudFormModalProps<T>): react_jsx_runtime8.JSX.Element;
+//#endregion
+//#region src/components/data-table/data-table.d.ts
+interface DataTableProps<TData> extends React$1.ComponentProps<"div"> {
+  table: Table<TData>;
+  actionBar?: React$1.ReactNode;
+}
+declare function DataTable<TData>({
+  table,
+  actionBar,
+  children,
+  className,
+  ...props
+}: DataTableProps<TData>): react_jsx_runtime8.JSX.Element;
+//#endregion
+//#region src/components/data-table/data-table-advanced-toolbar.d.ts
+interface DataTableAdvancedToolbarProps<TData> extends React$1.ComponentProps<"div"> {
+  table: Table<TData>;
+}
+declare function DataTableAdvancedToolbar<TData>({
+  table,
+  children,
+  className,
+  ...props
+}: DataTableAdvancedToolbarProps<TData>): react_jsx_runtime8.JSX.Element;
+//#endregion
+//#region src/components/data-table/data-table-column-header.d.ts
+interface DataTableColumnHeaderProps<TData, TValue> extends React.ComponentProps<typeof DropdownMenuTrigger> {
+  column: Column<TData, TValue>;
+  label: string;
+}
+declare function DataTableColumnHeader<TData, TValue>({
+  column,
+  label,
+  className,
+  ...props
+}: DataTableColumnHeaderProps<TData, TValue>): react_jsx_runtime8.JSX.Element;
+//#endregion
+//#region src/components/data-table/data-table-faceted-filter.d.ts
+interface DataTableFacetedFilterProps<TData, TValue> {
+  column?: Column<TData, TValue>;
+  title?: string;
+  options: Option[];
+  multiple?: boolean;
+}
+declare function DataTableFacetedFilter<TData, TValue>({
+  column,
+  title,
+  options,
+  multiple
+}: DataTableFacetedFilterProps<TData, TValue>): react_jsx_runtime8.JSX.Element;
+//#endregion
+//#region src/components/data-table/data-table-pagination.d.ts
+interface DataTablePaginationProps<TData> extends React.ComponentProps<"div"> {
+  table: Table<TData>;
+  pageSizeOptions?: number[];
+}
+declare function DataTablePagination<TData>({
+  table,
+  pageSizeOptions,
+  className,
+  ...props
+}: DataTablePaginationProps<TData>): react_jsx_runtime8.JSX.Element;
+//#endregion
+//#region src/components/data-table/data-table-toolbar.d.ts
+interface DataTableToolbarProps<TData> extends React$1.ComponentProps<"div"> {
+  table: Table<TData>;
+}
+declare function DataTableToolbar<TData>({
+  table,
+  children,
+  className,
+  ...props
+}: DataTableToolbarProps<TData>): react_jsx_runtime8.JSX.Element;
+//#endregion
+//#region src/components/data-table/data-table-view-options.d.ts
+interface DataTableViewOptionsProps<TData> extends React$1.ComponentProps<typeof PopoverContent> {
+  table: Table<TData>;
+  disabled?: boolean;
+}
+declare function DataTableViewOptions<TData>({
+  table,
+  disabled,
+  ...props
+}: DataTableViewOptionsProps<TData>): react_jsx_runtime8.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">> {
+  initialState?: Omit<Partial<TableState>, "sorting"> & {
+    sorting?: ExtendedColumnSort<TData>[];
+  };
+  queryKeys?: Partial<QueryKeys>;
+  history?: "push" | "replace";
+  debounceMs?: number;
+  throttleMs?: number;
+  clearOnDefault?: boolean;
+  enableAdvancedFilter?: boolean;
+  scroll?: boolean;
+  shallow?: boolean;
+  startTransition?: React$1.TransitionStartFunction;
+}
+declare function useDataTable<TData>(props: UseDataTableProps<TData>): {
+  table: _tanstack_react_table0.Table<TData>;
+  shallow: boolean;
+  debounceMs: number;
+  throttleMs: number;
+};
+//#endregion
+//#region src/hooks/use-readable-filters.d.ts
+type ColumnLike<TData> = Column<TData> | ColumnDef<TData, unknown> | {
+  id?: string;
+  accessorKey?: string;
+  meta?: {
+    variant?: FilterVariant$1;
+  };
+};
+interface UseReadableFiltersOptions extends UrlStateOptions {
+  debounceMs?: number;
+}
+declare function useReadableFilters<TData>(columns: ColumnLike<TData>[], options?: UseReadableFiltersOptions): [ExtendedColumnFilter<TData>[], (value: ExtendedColumnFilter<TData>[] | ((prev: ExtendedColumnFilter<TData>[]) => ExtendedColumnFilter<TData>[])) => void];
+//#endregion
+//#region src/lib/schema-bridge/zod-to-formily.d.ts
+/**
+ * 从 Zod Schema 创建 Formily Schema
+ */
+declare function createFormSchema<T extends z.ZodObject<z.ZodRawShape>>(schema: T, options?: CreateFormSchemaOptions): ISchema;
+/**
+ * 为编辑模式创建 Form Schema（排除 id, createdAt, updatedAt）
+ */
+declare function createEditFormSchema<T extends z.ZodObject<z.ZodRawShape>>(schema: T, options?: Omit<CreateFormSchemaOptions, "exclude">): ISchema;
+//#endregion
+//#region src/lib/schema-bridge/schema-adapter.d.ts
+/**
+ * 统一的 Schema 类型
+ */
+type UnifiedSchema = z.ZodObject<any> | JSONSchema | SimpleFieldsConfig;
+/**
+ * JSON Schema 类型
+ */
+interface JSONSchema {
+  type: "object";
+  properties: Record<string, JSONSchemaProperty>;
+  required?: string[];
+}
+interface JSONSchemaProperty {
+  type: "string" | "number" | "boolean" | "array" | "object";
+  title?: string;
+  description?: string;
+  enum?: any[];
+  format?: string;
+  default?: any;
+  minimum?: number;
+  maximum?: number;
+  minLength?: number;
+  maxLength?: number;
+  pattern?: string;
+}
+/**
+ * 简化字段配置
+ */
+interface SimpleFieldsConfig {
+  [key: string]: SimpleFieldConfig;
+}
+interface SimpleFieldConfig {
+  type: "string" | "number" | "boolean" | "select" | "multiselect" | "date" | "datetime" | "textarea" | "email" | "url";
+  label?: string;
+  description?: string;
+  required?: boolean;
+  default?: any;
+  options?: Array<string | {
+    label: string;
+    value: any;
+  }>;
+  placeholder?: string;
+  min?: number;
+  max?: number;
+  minLength?: number;
+  maxLength?: number;
+  pattern?: RegExp;
+}
+/**
+ * 内部统一的字段定义
+ */
+interface UnifiedField {
+  name: string;
+  type: string;
+  label?: string;
+  description?: string;
+  required?: boolean;
+  default?: any;
+  validation?: any;
+  options?: Array<{
+    label: string;
+    value: any;
+  }>;
+  component?: string;
+  componentProps?: Record<string, any>;
+}
+/**
+ * Schema 适配器 - 将各种格式转换为统一格式
+ */
+declare class SchemaAdapter {
+  /**
+   * 检测 Schema 类型
+   */
+  static detectType(schema: UnifiedSchema): "zod" | "json" | "simple";
+  /**
+   * 转换为统一格式
+   */
+  static toUnified(schema: UnifiedSchema): UnifiedField[];
+  /**
+   * 从 Zod Schema 转换
+   */
+  private static fromZod;
+  /**
+   * 从 JSON Schema 转换
+   */
+  private static fromJSON;
+  /**
+   * 从简化配置转换
+   */
+  private static fromSimple;
+  /**
+   * 解析 Zod 字段（简化版，复用现有逻辑）
+   */
+  private static parseZodField;
+  /**
+   * 标准化选项格式
+   */
+  private static normalizeOptions;
+  /**
+   * 转换为 Formily Schema
+   */
+  static toFormily(fields: UnifiedField[]): ISchema;
+}
+//#endregion
+//#region src/lib/data-source.d.ts
+/**
+ * 数据源抽象接口
+ * 支持任意后端实现（REST API, tRPC, GraphQL 等）
+ */
+/**
+ * 列表查询参数
+ */
+interface ListParams {
+  page: number;
+  perPage: number;
+  sort?: Array<{
+    id: string;
+    desc: boolean;
+  }>;
+  filters?: Array<{
+    id: string;
+    value: any;
+    operator?: string;
+  }>;
+}
+/**
+ * 列表查询结果
+ */
+interface ListResult<T> {
+  data: T[];
+  total: number;
+  page: number;
+  perPage: number;
+}
+/**
+ * 数据源接口
+ *
+ * @example
+ * ```typescript
+ * // 使用自己项目的请求封装
+ * const taskDataSource: DataSource<Task> = {
+ *   list: (params) => request.post("/api/tasks/list", params),
+ *   get: (id) => request.get(`/api/tasks/${id}`),
+ *   create: (data) => request.post("/api/tasks", data),
+ *   update: (id, data) => request.put(`/api/tasks/${id}`, data),
+ *   delete: (id) => request.delete(`/api/tasks/${id}`),
+ * };
+ * ```
+ */
+interface DataSource<T = any> {
+  /**
+   * 列表查询（分页、排序、过滤）
+   */
+  list(params: ListParams): Promise<ListResult<T>>;
+  /**
+   * 获取单条记录
+   */
+  get(id: string | number): Promise<T>;
+  /**
+   * 创建记录
+   */
+  create(data: Partial<T>): Promise<T>;
+  /**
+   * 更新记录
+   */
+  update(id: string | number, data: Partial<T>): Promise<T>;
+  /**
+   * 删除记录
+   */
+  delete(id: string | number): Promise<void>;
+  /**
+   * 批量删除（可选）
+   */
+  deleteMany?(ids: Array<string | number>): Promise<void>;
+}
+/**
+ * tRPC 路由适配器
+ * 将 tRPC 路由转换为 DataSource 接口
+ *
+ * @example
+ * ```typescript
+ * import { createTRPCDataSource } from "@wordrhyme/auto-crud";
+ *
+ * const taskDataSource = createTRPCDataSource(trpc.tasks);
+ *
+ * <AutoCrudTable schema={schema} dataSource={taskDataSource} />
+ * ```
+ */
+declare function createTRPCDataSource<T = any>(router: any): DataSource<T>;
+/**
+ * 内存数据源（用于测试/演示）
+ *
+ * @example
+ * ```typescript
+ * const mockDataSource = createMemoryDataSource([
+ *   { id: 1, title: "Task 1", status: "todo" },
+ *   { id: 2, title: "Task 2", status: "done" },
+ * ]);
+ *
+ * <AutoCrudTable schema={schema} dataSource={mockDataSource} />
+ * ```
+ */
+declare function createMemoryDataSource<T extends {
+  id: string | number;
+}>(initialData?: T[]): DataSource<T>;
+//#endregion
+//#region src/lib/utils.d.ts
+declare function cn(...inputs: ClassValue[]): string;
+//#endregion
+//#region src/lib/format.d.ts
+declare function formatDate(date: Date | string | number | undefined, opts?: Intl.DateTimeFormatOptions): string;
+//#endregion
+//#region src/lib/humanize.d.ts
+/**
+ * 将字符串转为人类可读格式
+ *
+ * @example
+ * humanize("createdAt") // "Created At"
+ * humanize("user_name") // "User Name"
+ * humanize("firstName") // "First Name"
+ */
+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 };