import type { NormalisedSchema, ParsedFilters, ValidationResult, SuggestionHint } from '../types/types';
/**
 * generateSuggestions
 *
 * Produces schema-driven `SuggestionHint[]` without touching any product data.
 *
 * The engine runs four independent hint strategies:
 *
 * 1. **Invalid-value hints** — string filter value not in `valid_values`.
 *    Suggests the closest valid option(s) using edit-distance ranking.
 *
 * 2. **Out-of-range hints** — numeric filter value outside attribute `min`/`max`.
 *    Tells the user the acceptable range for that attribute.
 *
 * 3. **Alternative-category hints** — numeric dimension falls outside the
 *    selected category's `category_dimensions` range.
 *    Recommends other categories whose ranges fit the given value.
 *
 * 4. **General query hint** — when very few attributes were extracted (low
 *    coverage) the engine suggests being more specific.
 *
 * All hints carry a `field` (which attribute triggered them) and a
 * machine-readable `type` for programmatic handling in the host app.
 *
 * @param filters    - Structured filters from `parseQuery`
 * @param schema     - The normalised schema
 * @param validation - Validation result (used to avoid duplicate messages)
 * @param confidence - Parser confidence score from `parseQuery`
 * @returns          - Deduplicated array of `SuggestionHint`
 */
export declare function generateSuggestions(filters: ParsedFilters, schema: NormalisedSchema, validation: ValidationResult, confidence: number): SuggestionHint[];
//# sourceMappingURL=suggestionEngine.d.ts.map