/** BCP-47 locale code (e.g. "ja", "en", "vi"). */
export type LocaleCode = string;

/** Map of locale codes to translated strings. */
export type LocaleMap = Record<LocaleCode, string>;

/** A plain string or a locale map for multi-language support. */
export type LocalizedString = string | LocaleMap;

/** Locale settings for multi-language support. */
export interface LocaleConfig {
  /** Supported locale codes (e.g. ["ja", "en", "vi"]). */
  locales?: LocaleCode[];
  /** Default locale code. */
  defaultLocale?: string;
  /** Fallback locale when translation is missing. */
  fallbackLocale?: string;
}