import { type BoardId } from "./products.js";
import type { SearchHit } from "./types.js";
export type OfficialPath = {
    id: string;
    title: string;
    url: string;
    manual: string;
    why: string;
    query: RegExp;
    manuals: string[];
    scope: "named-manual" | "product" | "global";
    product?: RegExp;
    boards?: BoardId[];
};
/**
 * High-confidence official start pages. First match wins.
 * Add a row here when a real question has a known best-practice page.
 * Do not add a row when the official page is still ambiguous.
 */
export declare const OFFICIAL_PATHS: OfficialPath[];
export declare function matchOfficialPath(query: string, manual?: string): OfficialPath | undefined;
export declare function applyOfficialPath(hits: SearchHit[], path: OfficialPath | undefined, limit: number): SearchHit[];
export declare function searchGuidance(path?: OfficialPath): string;