import type { DataRecord, DataRecordFilterGroup, ProcessListOptions, ProcessSingleOptions, SortExpr, SortFn } from '../types/index.js';
/** 从单条对象中摘取指定字段，支持通过 `.` 访问子字段，保留嵌套结构。 */
export declare function pickFieldsSingle(data: DataRecord, fields: string[]): DataRecord;
/** 对列表中的每条对象摘取指定字段。 */
export declare function pickFields(data: DataRecord[], fields: string[]): DataRecord[];
/** 按条件组过滤列表，多组之间按 AND 组合。 */
export declare function filterData(data: DataRecord[], filterGroups: DataRecordFilterGroup[]): DataRecord[];
/**
 * 对列表做大小写不敏感的模糊匹配。
 *
 * 每个 `keywordGroups` 元素是一个关键词组，组内以逗号分隔为 AND；多个组之间按 OR 组合。
 * 引号内的逗号视为关键词内容，不作为分隔符。
 */
export declare function searchData(data: DataRecord[], keywordGroups: string[], searchFields?: string[]): DataRecord[];
/**
 * 对列表排序，返回新数组（不修改入参）。
 *
 * `sortFields` 的每个元素可以是 `字段:asc|desc`（兼容 `字段_asc|desc`）或自定义比较函数，按先后顺序生效；
 * 数值字段按数字比较，否则按字符串 `localeCompare`。
 */
export declare function sortData(data: DataRecord[], sortFields: (SortExpr | SortFn)[]): DataRecord[];
/** 处理单条对象：按 转换 → 摘取 的顺序执行。 */
export declare function processData(data: DataRecord, options: ProcessSingleOptions): DataRecord;
/** 处理列表：按 转换 → 过滤 → 搜索 → 排序 → 限制数量 → 摘取 的顺序执行。 */
export declare function processData(data: DataRecord[], options: ProcessListOptions): DataRecord[];