/**
 * Path matching and predicate composition for file scanning and watching.
 *
 * {@link toPathMatcher} compiles globs into {@link Predicate} values from
 * shared-core (`and` / `or` / `negate`) for use by {@link findFiles} and
 * {@link watchFiles}.
 *
 * @module
 */
import { type Predicate, type PredicateFunction } from "@dbx-tools/shared-core";
export type PathMatchPredicate = PredicateFunction<string>;
/** A composable path test (`true` == match). */
export type PathMatcher = Predicate<string>;
/**
 * Anything {@link toPathMatcher} accepts: a glob string (compiled with
 * `dot: true`), or a custom `(path) => boolean`.
 */
export type PathMatchInput = PathMatchPredicate | string;
/** Compiles path match inputs to predicate functions for `.and()` / `.or()`. */
export declare function pathMatchTests(...inputs: readonly (PathMatchInput | null | undefined)[]): readonly PathMatchPredicate[];
/**
 * Combines one or more patterns into a single {@link PathMatcher} (OR'd).
 * Strings are compiled with `dot: true`; predicates are used as-is;
 * `null`/`undefined` entries are skipped. With no matching patterns the result
 * always returns `false`.
 *
 * @param patterns - Globs and/or predicates to OR together.
 */
export declare function toPathMatcher(...inputs: readonly (PathMatchInput | null | undefined)[]): PathMatcher;