/**
 * Simple debounced directory watcher for dev auto-restart.
 */
import { type FSWatcher } from 'fs';
/**
 * Watch a directory recursively for changes and invoke a callback (debounced).
 * Returns the FSWatcher handle for cleanup.
 */
export declare function watchDirectory(dir: string, onChange: () => void, debounceMs?: number): FSWatcher;
/**
 * Resolve the watch directory from CLI arg.
 * Empty string → auto-detect from process.argv[1] (entry script directory).
 */
export declare function resolveWatchDir(watchArg: string): string;
//# sourceMappingURL=file-watcher.d.ts.map