import { registerMatcher, unregisterMatcher, type BuiltInMatchMode, type FilterMatcher, type FilterRule } from '@primereact/hooks/use-filter';
export { registerMatcher, unregisterMatcher };
export type TreeFilterMode = 'lenient' | 'strict';
export interface TreeNodeLike {
    key?: string | number;
    data?: Record<string, unknown>;
    children?: TreeNodeLike[];
}
export interface UseTreeFilterOptions<TNode extends TreeNodeLike, TMode extends string = BuiltInMatchMode> {
    nodes: TNode[];
    rules?: FilterRule<TMode>[];
    defaultRules?: FilterRule<TMode>[];
    /**
     * Shorthand for the single-field case. When set, the hook synthesizes a single
     * `{ field, value, matchMode }` rule. Ignored when `rules` / `defaultRules` is provided.
     */
    field?: string | string[];
    /** Controlled value for the shorthand `field`. Omit to let the hook own the state. */
    value?: unknown;
    /** Initial value when the hook owns the state. */
    defaultValue?: unknown;
    /** Fires when the shorthand `value` changes. */
    onValueChange?: (value: unknown) => void;
    /** Match mode for the shorthand `field`. Defaults to `'contains'`. */
    matchMode?: TMode;
    matchers?: Partial<Record<TMode, FilterMatcher>> & Record<string, FilterMatcher>;
    filterMode?: TreeFilterMode;
    filterLocale?: string;
    filterDelay?: number;
    /** When true, `filteredNodes` is returned as-is; the consumer fetches filtered data itself. */
    lazy?: boolean;
    /** Fires after rules settle (honours `filterDelay`). The consumer is expected to fetch filtered tree data. */
    onLazyLoad?: (event: LazyTreeFilterEvent<TMode>) => void;
    onRulesChange?: (rules: FilterRule<TMode>[]) => void;
}
export interface LazyTreeFilterEvent<TMode extends string = string> {
    rules: FilterRule<TMode>[];
    filterMode: TreeFilterMode;
    filterLocale?: string;
}
export interface UseTreeFilterReturn<TNode extends TreeNodeLike, TMode extends string = string> {
    rules: FilterRule<TMode>[];
    filteredNodes: TNode[];
    isFiltered: boolean;
    setRules: (rules: FilterRule<TMode>[]) => void;
    value: unknown;
    setValue: (value: unknown) => void;
    clearAll: () => void;
    match: (node: TNode) => boolean;
    matchers: Readonly<Record<string, FilterMatcher>>;
}
export declare function useTreeFilter<TNode extends TreeNodeLike, TMode extends string = BuiltInMatchMode>(options: UseTreeFilterOptions<TNode, TMode>): UseTreeFilterReturn<TNode, TMode>;