/**
 * 为 pgTable 登记列注释，供 EPS / 自动筛选 / PG COMMENT 同步。
 * 自动合并 `BASE_COLUMN_COMMENTS`，业务字段可覆盖。
 *
 * @example
 * export const baseMenu = columnComments(pgTable(...), {
 *   name: '名称',
 *   router: '路由',
 * })
 */
export declare function columnComments<T extends object>(table: T, comments?: Record<string, string>): T;
export declare function getColumnComments(table: object): Record<string, string>;
/** 已登记的表（schema import 后可用） */
export declare function listColumnCommentTables(): object[];
/** Bun.SQL 最小接口（避免 core 强耦合 bun 类型） */
type PgCommentSql = {
    (strings: TemplateStringsArray, ...values: unknown[]): Promise<unknown>;
    unsafe: (query: string) => Promise<unknown>;
};
/**
 * 将 columnComments 与 PG 现有注释 diff，仅对差异列执行 COMMENT ON COLUMN。
 * - 未变 → 不写
 * - 新表 / 新列 / 文案变更 → 只更新对应列
 */
export declare function syncColumnCommentsToPg(sql: PgCommentSql): Promise<number>;
export {};
