/** 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;
  /** Options emitted into the generated `config/translatable.php` (#281). */
  translatable?: LocaleTranslatableConfig;
}

/** Astrotomic options for the generated `config/translatable.php`. Omitted keys default to `true`. */
export interface LocaleTranslatableConfig {
  /** `to_array_always_loads_translations` (default true). */
  toArrayAlwaysLoadsTranslations?: boolean;
  /** `use_fallback` (default true). */
  useFallback?: boolean;
  /** `use_property_fallback` (default true). */
  usePropertyFallback?: boolean;
}