import { StochasticOptions } from '../../schemas/StochasticOptionsSchema';
import { StochasticResult } from '../../schemas/StochasticResultSchema';
/**
 * Calculate Stochastic Oscillator
 *
 * The Stochastic Oscillator compares the closing price to the price range over a given period.
 * It consists of two lines:
 * 1. %K = ((Current Close - Lowest Low) / (Highest High - Lowest Low)) * 100
 * 2. %D = Simple Moving Average of %K
 *
 * Values range from 0 to 100:
 * - Above 80: Overbought (potential sell signal)
 * - Below 20: Oversold (potential buy signal)
 *
 * @param options - Stochastic calculation options
 * @returns Stochastic result with %K, %D, highest highs, lowest lows, and metadata
 *
 * @example
 * ```typescript
 * const result = calculateStochastic({
 *   high: [102, 103, 101, 104, 105],
 *   low: [98, 99, 97, 100, 101],
 *   close: [100, 102, 100, 103, 104],
 *   kPeriod: 14,
 *   dPeriod: 3
 * });
 *
 * console.log(result.percentK);  // %K values (0-100)
 * console.log(result.percentD);  // %D values (0-100)
 * ```
 */
export declare function calculateStochastic(options: StochasticOptions): StochasticResult;