/**
 * Canonical Player Name Resolver
 *
 * Loads the ESPN-reconciled player list and provides fast O(1) name
 * normalization. When a forecast pipeline produces "Jimmy Butler", this
 * resolves it to "Jimmy Butler III" (the ESPN canonical form).
 *
 * Loads once at import time from rainmaker_players.json, which is kept
 * fresh by the roster-reconciler cron (3 AM ET daily).
 */
/**
 * Resolve a player name to its ESPN canonical form.
 * Returns the canonical name if found, otherwise returns the original unchanged.
 *
 * @param name   Raw player name from Grok/PIFF/SGO output
 * @param league Optional league key for scoped lookup (e.g. 'nba', 'nfl')
 */
export declare function resolveCanonicalName(name: string, league?: string): string;
/**
 * Force reload the canonical name map (e.g. after roster-reconciler runs).
 */
export declare function reloadCanonicalNames(): void;
/**
 * Get the current ESPN roster for a team.
 * Returns player names sorted alphabetically, or empty array if unknown.
 *
 * @param teamShort  Team abbreviation (e.g. "LAC", "CLE")
 * @param league     League key (e.g. "nba", "nfl")
 */
export declare function getTeamRoster(teamShort: string, league: string): string[];
/**
 * Resolve a team full name to its abbreviation.
 * e.g. "Atlanta Hawks" → "ATL"
 */
export declare function getTeamAbbr(teamFullName: string, league: string): string;
/**
 * Resolve a team abbreviation to its full name.
 * e.g. "ATL" → "Atlanta Hawks"
 */
export declare function getTeamName(teamShort: string, league: string): string;
/**
 * Check if a player is on a specific team according to ESPN.
 * Useful for validating LLM output against real rosters.
 */
export declare function isPlayerOnTeam(playerName: string, teamShort: string, league: string): boolean;
/**
 * Format a team roster as a prompt section for LLM injection.
 * Returns top players (by position grouping) to keep prompt concise.
 */
export declare function formatRosterForPrompt(teamShort: string, teamName: string, league: string): string;
//# sourceMappingURL=canonical-names.d.ts.map