/**
 * @license
 * Copyright 2026 HopCode Team team
 * SPDX-License-Identifier: Apache-2.0
 */
import { type SupportedLanguage, getLanguageNameFromLocale } from './languages.js';
export type { SupportedLanguage };
export { getLanguageNameFromLocale };
/**
 * Get the path to the user's custom locales directory.
 * Users can place custom language packs (e.g., es.js, fr.js) in this directory.
 * @returns The path to ~/.hopcode/locales
 */
export declare function getUserLocalesDirectory(): string;
export declare function detectSystemLanguage(): SupportedLanguage;
export declare function setLanguage(lang: SupportedLanguage | 'auto'): void;
export declare function setLanguageAsync(lang: SupportedLanguage | 'auto'): Promise<void>;
export declare function getCurrentLanguage(): SupportedLanguage;
export declare function t(key: string, params?: Record<string, string>): string;
/**
 * Get a translation that is an array of strings.
 * @param key The translation key
 * @returns The array of strings, or an empty array if not found or not an array
 */
export declare function ta(key: string): string[];
export declare function initializeI18n(lang?: SupportedLanguage | 'auto'): Promise<void>;
