/**
 * useTokenCount Hook
 *
 * React hook for estimating token counts.
 *
 * @module
 */
/**
 * Token count options.
 */
export interface UseTokenCountOptions {
    /** Text to count tokens for */
    text?: string;
    /** Model to use for estimation */
    model?: string;
    /** Custom tokenizer function */
    tokenizer?: (text: string) => number;
    /** Debounce delay in ms */
    debounceMs?: number;
}
/**
 * Token count return value.
 */
export interface UseTokenCountReturn {
    /** Estimated token count */
    tokenCount: number;
    /** Characters count */
    characterCount: number;
    /** Word count */
    wordCount: number;
    /** Whether estimation is in progress */
    isEstimating: boolean;
    /** Count tokens for text */
    countTokens: (text: string) => number;
}
/**
 * useTokenCount - React hook for estimating token counts.
 *
 * Provides real-time token estimation for text input,
 * useful for staying within model context limits.
 *
 * @example
 * ```tsx
 * import { useTokenCount } from 'ai.matey.react.hooks';
 *
 * function TokenCounter() {
 *   const [text, setText] = useState('');
 *   const { tokenCount, characterCount, wordCount } = useTokenCount({ text });
 *
 *   return (
 *     <div>
 *       <textarea value={text} onChange={(e) => setText(e.target.value)} />
 *       <p>Tokens: ~{tokenCount} | Words: {wordCount} | Characters: {characterCount}</p>
 *     </div>
 *   );
 * }
 * ```
 */
export declare function useTokenCount(options?: UseTokenCountOptions): UseTokenCountReturn;
/**
 * Model-specific token limits (context windows).
 *
 * Static fallback for models the shared model registry does not know;
 * the registry in `ai.matey.utils` is consulted first, so registering a
 * model there also fixes token counting here.
 */
export declare const MODEL_TOKEN_LIMITS: Record<string, number>;
/**
 * Get token limit for a model.
 *
 * Consults the shared model registry first, then this module's static
 * table (exact match, then prefix/substring match).
 */
export declare function getModelTokenLimit(model: string): number | undefined;
//# sourceMappingURL=use-token-count.d.ts.map