/**
 * Matcher helpers for hooks that support a `matcher` field in settings.json.
 *
 * Claude Code matcher strings are exact/pipe-list matchers for plain
 * tokens, match-all for `*` or the empty string, and JavaScript regular
 * expressions only when they contain other characters. These helpers mirror
 * those semantics so individual hooks can branch on whether the incoming
 * event matches. They are NOT required — the `matcher` field in settings.json
 * filters hooks at Claude Code's side before the process is even spawned.
 * Use these when you dispatch many events from one script and need to
 * branch within a single handler.
 *
 * @since 0.1.0
 */
import type * as Effect from 'effect/Effect';
/**
 * Compile a matcher pattern into a tester function. String patterns follow
 * Claude Code's current matcher rules: `*` and `""` match all, strings made
 * only from letters/digits/`_`/`|` are exact values or `|`-separated exact
 * lists, and strings containing any other character are JavaScript regexes.
 *
 * @category Matcher
 * @since 0.1.0
 * @example
 * ```ts
 * import { Hook } from 'effect-claudecode'
 *
 * const isBash = Hook.matchTool('Bash')
 * const isEditOrWrite = Hook.matchTool('Edit|Write')
 * const isMcp = Hook.matchTool('mcp__.*')
 *
 * isBash('Bash')       // true
 * isBash('Bash(git)')  // false — exact match
 * isMcp('mcp__foo')    // true
 * ```
 */
export declare const matchValue: (pattern: string | RegExp) => ((name: string) => boolean);
/**
 * Test whether a matcher pattern matches a value, one-shot.
 *
 * @category Matcher
 * @since 0.1.0
 */
export declare const testValue: (pattern: string | RegExp, name: string) => boolean;
/**
 * Build a handler that runs only when the selected matcher value matches.
 *
 * @internal
 */
export declare const handleMatcher: <I, O, E, R>(config: {
    readonly matcher: string | RegExp;
    readonly select: (input: I) => string;
    readonly onMatch: (input: I) => Effect.Effect<O, E, R>;
    readonly onMismatch: (input: I) => Effect.Effect<O, E, R>;
}) => ((input: I) => Effect.Effect<O, E, R>);
/**
 * Alias for `matchValue(...)` when matching `tool_name`.
 *
 * @category Matcher
 * @since 0.1.0
 */
export declare const matchTool: (pattern: string | RegExp) => ((name: string) => boolean);
/**
 * Compile a FileChanged matcher into a tester. Claude Code splits
 * FileChanged matcher strings on `|` and treats each segment as a literal
 * basename rather than a regular expression. `*` and `""` still match all.
 *
 * @category Matcher
 * @since 0.1.0
 */
export declare const matchFileName: (pattern: string | RegExp) => ((name: string) => boolean);
/**
 * Test whether a regex pattern matches a tool name, one-shot.
 *
 * @category Matcher
 * @since 0.1.0
 */
export declare const testTool: (pattern: string | RegExp, name: string) => boolean;
//# sourceMappingURL=Matcher.d.ts.map