import { S as CustomMapping, _ as VariableType, a as HTML_CONTENT_PROPS, b as getRegionProperties, c as I18nextMessage, d as JsxChildren, f as JsxElement, g as Variable, h as StringMessage, i as GTProp, l as IcuMessage, m as StringFormat, n as Content, o as HtmlContentPropKeysRecord, p as StringContent, r as DataFormat, s as HtmlContentPropValuesRecord, t as FormatVariables, u as JsxChild, v as CutoffFormatOptions, x as LocaleProperties, y as CustomRegionMapping } from "./types-CbRDetV3.cjs";

//#region src/LocaleConfig.d.ts
type LocaleConfigConstructorParams = {
  defaultLocale?: string;
  locales?: string[];
  customMapping?: CustomMapping;
};
type LocalesOption$1 = {
  locales?: string | string[];
};
type WithLocales<T = object> = T & LocalesOption$1;
/**
 * LocaleConfig contains the locale and formatting primitives exposed through
 * the core entrypoint.
 *
 * It intentionally does not store project IDs, API keys, runtime URLs, or any
 * translation credentials. It only stores locale metadata needed to resolve
 * aliases, choose formatting fallbacks, and format values with Intl.
 */
declare class LocaleConfig {
  readonly defaultLocale: string;
  readonly locales: string[];
  readonly customMapping?: CustomMapping;
  private resolutionScope?;
  private getResolutionScope;
  private isResolutionScopeCurrent;
  private buildResolutionScope;
  constructor({
    defaultLocale,
    locales,
    customMapping
  }?: LocaleConfigConstructorParams);
  private getFormattingLocales;
  formatNum(value: number, targetLocale?: string, options?: WithLocales<Intl.NumberFormatOptions>): string;
  formatDateTime(value: Date, targetLocale?: string, options?: WithLocales<Intl.DateTimeFormatOptions>): string;
  formatCurrency(value: number, currency: string, targetLocale?: string, options?: WithLocales<Intl.NumberFormatOptions>): string;
  formatRelativeTime(value: number, unit: Intl.RelativeTimeFormatUnit, targetLocale?: string, options?: WithLocales<Intl.RelativeTimeFormatOptions>): string;
  formatRelativeTimeFromDate(date: Date, targetLocale?: string, options?: WithLocales<Intl.RelativeTimeFormatOptions & {
    baseDate?: Date;
  }>): string;
  formatCutoff(value: string, targetLocale?: string, options?: WithLocales<CutoffFormatOptions>): string;
  formatMessage(message: string, targetLocale?: string, options?: WithLocales<{
    variables?: FormatVariables;
    dataFormat?: StringFormat;
  }>): string;
  formatList(array: Array<string | number>, targetLocale?: string, options?: WithLocales<Intl.ListFormatOptions>): string;
  formatListToParts<T>(array: Array<T>, targetLocale?: string, options?: WithLocales<Intl.ListFormatOptions>): (string | T)[];
  getLocaleName(locale: string): string;
  getLocaleEmoji(locale: string): string;
  getLocaleProperties(locale: string): LocaleProperties;
  requiresTranslation(targetLocale: string, sourceLocale?: string, approvedLocales?: string[] | undefined): boolean;
  /**
   * NOTE: consider moving LocaleCandidates type to this package, and
   * determineLocale could accept that as a parameter.
   */
  determineLocale(locales: string | string[], approvedLocales?: string[]): string | undefined;
  getLocaleDirection(locale: string): "ltr" | "rtl";
  isValidLocale(locale: string): boolean;
  resolveCanonicalLocale(locale: string): string;
  resolveAliasLocale(locale: string): string;
  standardizeLocale(locale: string): string;
  isSameDialect(...locales: (string | string[])[]): boolean;
  isSameLanguage(...locales: (string | string[])[]): boolean;
  isSupersetLocale(superLocale: string, subLocale: string): boolean;
}
//#endregion
//#region src/core.d.ts
type LocalesOption = {
  locales?: string | string[];
};
type MessageFormatOptions = LocalesOption & {
  variables?: FormatVariables;
  dataFormat?: StringFormat;
};
/**
 * Core formatting and locale helpers.
 *
 * This entry point exposes deterministic locale and formatting primitives. It
 * does not export the GT service client, project credentials, network
 * translation methods, file APIs, or other server/service concerns from the
 * root `generaltranslation` facade.
 *
 * This entry point is intended for framework and shared packages that need
 * locale metadata or formatting behavior without pulling in the full
 * translation API surface.
 */
/**
 * Formats a string with cutoff behavior, applying a terminator when the string exceeds the maximum character limit.
 *
 * This standalone function provides cutoff formatting functionality without requiring a GT instance.
 * The locales parameter is required for proper terminator selection based on the target language.
 *
 * @param {string} value - The string value to format with cutoff behavior.
 * @param {Object} [options] - Configuration options for cutoff formatting.
 * @param {string | string[]} [options.locales] - The locales to use for terminator selection.
 * @param {number} [options.maxChars] - The maximum number of characters to display.
 * - Undefined values are treated as no cutoff.
 * - Negative values follow .slice() behavior and terminator will be added before the value.
 * - 0 will result in an empty string.
 * - If cutoff results in an empty string, no terminator is added.
 * @param {CutoffFormatStyle} [options.style='ellipsis'] - The style of the terminator.
 * @param {string} [options.terminator] - Optional override the terminator to use.
 * @param {string} [options.separator] - Optional override the separator to use between the terminator and the value.
 * - If no terminator is provided, then separator is ignored.
 * @returns {string} The formatted string with terminator applied if cutoff occurs.
 *
 * @example
 * formatCutoff('Hello, world!', { locales: 'en-US', maxChars: 8 });
 * // Returns: 'Hello, …'
 *
 * @example
 * formatCutoff('Hello, world!', { locales: 'en-US', maxChars: -3 });
 * // Returns: '…d!'
 *
 * @example
 * formatCutoff('Very long text that needs cutting', {
 *   locales: 'en-US',
 *   maxChars: 15,
 *   style: 'ellipsis',
 *   separator: ' '
 * });
 * // Returns: 'Very long tex …'
 */
declare function formatCutoff(value: string, options?: LocalesOption & CutoffFormatOptions): string;
/**
 * Formats a message according to the specified locales and options.
 *
 * @param {string} message - The message to format.
 * @param {Object} [options] - Configuration options for message formatting.
 * @param {string | string[]} [options.locales] - The locales to use for formatting.
 * @param {FormatVariables} [options.variables] - The variables to use for formatting.
 * @param {StringFormat} [options.dataFormat='ICU'] - The format of the message. When STRING, the message is returned as is.
 * @returns {string} The formatted message.
 *
 * @example
 * formatMessage('Hello {name}', { variables: { name: 'John' } });
 * // Returns: "Hello John"
 *
 * @example
 * formatMessage('Hello {name}', {
 *   locales: ['fr'],
 *   variables: { name: 'John' }
 * });
 */
declare function formatMessage(message: string, options?: MessageFormatOptions): string;
/**
 * Formats a number according to the specified locales and options.
 * @param {Object} params - The parameters for the number formatting.
 * @param {number} params.value - The number to format.
 * @param {Intl.NumberFormatOptions} [params.options] - Additional options for number formatting.
 * @param {string | string[]} [params.options.locales] - The locales to use for formatting.
 * @returns {string} The formatted number.
 */
declare function formatNum(number: number, options?: LocalesOption & Intl.NumberFormatOptions): string;
/**
 * Formats a date according to the specified languages and options.
 * @param {Object} params - The parameters for the date formatting.
 * @param {Date} params.value - The date to format.
 * @param {Intl.DateTimeFormatOptions} [params.options] - Additional options for date formatting.
 * @param {string | string[]} [params.options.locales] - The languages to use for formatting.
 * @returns {string} The formatted date.
 */
declare function formatDateTime(date: Date, options?: LocalesOption & Intl.DateTimeFormatOptions): string;
/**
 * Formats a currency value according to the specified languages, currency, and options.
 * @param {Object} params - The parameters for the currency formatting.
 * @param {number} params.value - The currency value to format.
 * @param {string} params.currency - The currency code (e.g., 'USD').
 * @param {Intl.NumberFormatOptions} [params.options={}] - Additional options for currency formatting.
 * @param {string | string[]} [params.options.locales] - The locale codes to use for formatting.
 * @returns {string} The formatted currency value.
 */
declare function formatCurrency(value: number, currency: string, options?: LocalesOption & Intl.NumberFormatOptions): string;
/**
 * Formats a list of items according to the specified locales and options.
 * @param {Object} params - The parameters for the list formatting.
 * @param {Array<string | number>} params.value - The list of items to format.
 * @param {Intl.ListFormatOptions} [params.options={}] - Additional options for list formatting.
 * @param {string | string[]} [params.options.locales] - The locales to use for formatting.
 * @returns {string} The formatted list.
 */
declare function formatList(array: Array<string | number>, options?: LocalesOption & Intl.ListFormatOptions): string;
/**
 * Formats a list of items according to the specified locales and options.
 * @param {Array<T>} array - The list of items to format.
 * @param {Object} [options] - Additional options for list formatting.
 * @param {string | string[]} [options.locales] - The locales to use for formatting.
 * @param {Intl.ListFormatOptions} [options] - Additional Intl.ListFormat options.
 * @returns {Array<T | string>} The formatted list parts.
 */
declare function formatListToParts<T>(array: Array<T>, options?: LocalesOption & Intl.ListFormatOptions): Array<T | string>;
/**
 * Formats a relative time value according to the specified locales and options.
 * @param {Object} params - The parameters for the relative time formatting.
 * @param {number} params.value - The relative time value to format.
 * @param {Intl.RelativeTimeFormatUnit} params.unit - The unit of time (e.g., 'second', 'minute', 'hour', 'day', 'week', 'month', 'year').
 * @param {Intl.RelativeTimeFormatOptions} [params.options={}] - Additional options for relative time formatting.
 * @param {string | string[]} [params.options.locales] - The locales to use for formatting.
 * @returns {string} The formatted relative time string.
 */
declare function formatRelativeTime(value: number, unit: Intl.RelativeTimeFormatUnit, options?: LocalesOption & Omit<Intl.RelativeTimeFormatOptions, 'locales'>): string;
/**
 * Formats a relative time string from a Date, automatically selecting the best unit.
 * @param {Date} date - The date to format relative to now.
 * @param {Object} [options] - Formatting options.
 * @param {string | string[]} [options.locales] - The locales to use for formatting.
 * @param {Intl.RelativeTimeFormatOptions} [options] - Additional Intl.RelativeTimeFormat options.
 * @returns {string} The formatted relative time string (e.g., "2 hours ago", "in 3 days").
 */
declare function formatRelativeTimeFromDate(date: Date, options?: LocalesOption & Omit<Intl.RelativeTimeFormatOptions, 'locales'> & {
  baseDate?: Date;
}): string;
/**
 * Checks if a given BCP 47 locale code is valid.
 *
 * @param {string} locale - The BCP 47 locale code to validate.
 * @param {CustomMapping} [customMapping] - The custom mapping to use for validation.
 * @returns {boolean} True if the BCP 47 code is valid, false otherwise.
 *
 * @example
 * isValidLocale('en-US');
 * // Returns: true
 *
 * @example
 * isValidLocale('en_US');
 * // Returns: false
 */
declare function isValidLocale(locale: string, customMapping?: CustomMapping): boolean;
/**
 * Resolves the canonical locale for a given locale.
 *
 * @param {string} locale - The locale to resolve the canonical locale for.
 * @param {CustomMapping} [customMapping] - The custom mapping to use for resolving the canonical locale.
 * @returns {string} The canonical locale, or the input locale when no canonical mapping exists.
 *
 * @example
 * resolveCanonicalLocale('en-US');
 * // Returns: 'en-US'
 *
 * @example
 * resolveCanonicalLocale('en', { en: 'en-US' });
 * // Returns: 'en-US'
 */
declare function resolveCanonicalLocale(locale: string, customMapping?: CustomMapping): string;
/**
 * Standardizes a BCP 47 locale code to ensure correct formatting.
 *
 * @param {string} locale - The BCP 47 locale code to standardize.
 * @returns {string} The standardized BCP 47 locale code, or the input string if it cannot be standardized.
 *
 * @example
 * standardizeLocale('en-us');
 * // Returns: 'en-US'
 *
 * @example
 * standardizeLocale('not a locale');
 * // Returns: 'not a locale'
 */
declare function standardizeLocale(locale: string): string;
/**
 * Retrieves the display name of locale code using Intl.DisplayNames.
 *
 * @param {string} locale - A BCP-47 locale code.
 * @param {string} [defaultLocale] - The default locale to use for formatting.
 * @param {CustomMapping} [customMapping] - A custom mapping of locale codes to their names.
 * @returns {string} The display name corresponding to the code.
 */
declare function getLocaleName(locale: string, defaultLocale?: string, customMapping?: CustomMapping): string;
/**
 * Retrieves an emoji based on a given locale code, taking into account region, language, and specific exceptions.
 *
 * This function uses the locale's region (if present) to select an emoji or falls back on default emojis for certain languages.
 *
 * @param locale - A string representing the locale code (e.g., 'en-US', 'fr-CA').
 * @param {CustomMapping} [customMapping] - A custom mapping of locale codes to their names.
 * @returns The emoji representing the locale or its region, or a default emoji if no specific match is found.
 */
declare function getLocaleEmoji(locale: string, customMapping?: CustomMapping): string;
/**
 * Generates linguistic details for a given locale code.
 *
 * This function returns information about the locale,
 * script, and region of a given language code both in a standard form and in a maximized form (with likely script and region).
 * The function provides these names in both your default language and native forms, and an associated emoji.
 *
 * @param {string} locale - The locale code to get properties for (e.g., "de-AT").
 * @param {string} [defaultLocale] - The default locale to use for formatting.
 * @param {CustomMapping} [customMapping] - A custom mapping of locale codes to their names.
 * @returns {LocaleProperties} - An object containing detailed information about the locale.
 *
 * @property {string} code - The full locale code, e.g., "de-AT".
 * @property {string} name - Language name in the default display language, e.g., "Austrian German".
 * @property {string} nativeName - Language name in the locale's native language, e.g., "Österreichisches Deutsch".
 * @property {string} languageCode - The base language code, e.g., "de".
 * @property {string} languageName - The language name in the default display language, e.g., "German".
 * @property {string} nativeLanguageName - The language name in the native language, e.g., "Deutsch".
 * @property {string} nameWithRegionCode - Language name with region in the default language, e.g., "German (AT)".
 * @property {string} nativeNameWithRegionCode - Language name with region in the native language, e.g., "Deutsch (AT)".
 * @property {string} regionCode - The region code from maximization, e.g., "AT".
 * @property {string} regionName - The region name in the default display language, e.g., "Austria".
 * @property {string} nativeRegionName - The region name in the native language, e.g., "Österreich".
 * @property {string} scriptCode - The script code from maximization, e.g., "Latn".
 * @property {string} scriptName - The script name in the default display language, e.g., "Latin".
 * @property {string} nativeScriptName - The script name in the native language, e.g., "Lateinisch".
 * @property {string} maximizedCode - The maximized locale code, e.g., "de-Latn-AT".
 * @property {string} maximizedName - Maximized locale name with likely script in the default language, e.g., "Austrian German (Latin)".
 * @property {string} nativeMaximizedName - Maximized locale name in the native language, e.g., "Österreichisches Deutsch (Lateinisch)".
 * @property {string} minimizedCode - Minimized locale code, e.g., "de-AT" (or "de" for "de-DE").
 * @property {string} minimizedName - Minimized language name in the default language, e.g., "Austrian German".
 * @property {string} nativeMinimizedName - Minimized language name in the native language, e.g., "Österreichisches Deutsch".
 * @property {string} emoji - The emoji associated with the locale's region, if applicable.
 */
declare function getLocaleProperties(locale: string, defaultLocale?: string, customMapping?: CustomMapping): LocaleProperties;
/**
 * Determines whether a translation is required based on the source and target locales.
 *
 * - If the target locale is not specified, the function returns `false`, as translation is not needed.
 * - If the source and target locale are the same, returns `false`, indicating that no translation is necessary.
 * - If the `approvedLocales` array is provided, and the target locale is not within that array, the function also returns `false`.
 * - Otherwise, it returns `true`, meaning that a translation is required.
 *
 * @param {string} sourceLocale - The locale code for the original content (BCP 47 locale code).
 * @param {string} targetLocale - The locale code of the language to translate the content into (BCP 47 locale code).
 * @param {string[]} [approvedLocale] - An optional array of approved target locales.
 *
 * @returns {boolean} - Returns `true` if translation is required, otherwise `false`.
 */
declare function requiresTranslation(sourceLocale: string, targetLocale: string, approvedLocales?: string[], customMapping?: CustomMapping): boolean;
/**
 * Determines the best matching locale from the provided approved locales list.
 * @param {string | string[]} locales - A single locale or an array of locales sorted in preference order.
 * @param {string[]} [approvedLocales=this.locales] - An array of approved locales, also sorted by preference.
 * @returns {string | undefined} - The best matching locale from the approvedLocales list, or undefined if no match is found.
 */
declare function determineLocale(locales: string | string[], approvedLocales?: string[] | undefined, customMapping?: CustomMapping | undefined): string | undefined;
/**
 * Get the text direction for a given locale code using the Intl.Locale API.
 *
 * @param {string} locale - A BCP-47 locale code.
 * @returns {string} 'rtl' if the locale is right-to-left; otherwise 'ltr'.
 */
declare function getLocaleDirection(locale: string): 'ltr' | 'rtl';
/**
 * Resolves the alias locale for a given locale.
 * @param {string} locale - The locale to resolve the alias locale for
 * @param {CustomMapping} [customMapping] - The custom mapping to use for resolving the alias locale
 * @returns {string} The alias locale
 */
declare function resolveAliasLocale(locale: string, customMapping?: CustomMapping): string;
/**
 * Checks if multiple BCP 47 locale codes represent the same dialect.
 * @param {string[]} locales - The BCP 47 locale codes to compare.
 * @returns {boolean} True if all BCP 47 codes represent the same dialect, false otherwise.
 */
declare function isSameDialect(...locales: (string | string[])[]): boolean;
/**
 * Checks if multiple BCP 47 locale codes represent the same language.
 * @param {string[]} locales - The BCP 47 locale codes to compare.
 * @returns {boolean} True if all BCP 47 codes represent the same language, false otherwise.
 */
declare function isSameLanguage(...locales: (string | string[])[]): boolean;
/**
 * Checks if a locale is a superset of another locale.
 * A subLocale is a subset of superLocale if it is an extension of superLocale or are otherwise identical.
 *
 * @param {string} superLocale - The locale to check if it is a superset of the other locale.
 * @param {string} subLocale - The locale to check if it is a subset of the other locale.
 * @returns {boolean} True if the first locale is a superset of the second locale, false otherwise.
 */
declare function isSupersetLocale(superLocale: string, subLocale: string): boolean;
//#endregion
export { type Content, type CustomMapping, type CustomRegionMapping, type CutoffFormatOptions, type DataFormat, type FormatVariables, type GTProp, HTML_CONTENT_PROPS, type HtmlContentPropKeysRecord, type HtmlContentPropValuesRecord, type I18nextMessage, type IcuMessage, type JsxChild, type JsxChildren, type JsxElement, LocaleConfig, type LocaleConfigConstructorParams, type LocaleProperties, type StringContent, type StringFormat, type StringMessage, type Variable, type VariableType, determineLocale, formatCurrency, formatCutoff, formatDateTime, formatList, formatListToParts, formatMessage, formatNum, formatRelativeTime, formatRelativeTimeFromDate, getLocaleDirection, getLocaleEmoji, getLocaleName, getLocaleProperties, getRegionProperties, isSameDialect, isSameLanguage, isSupersetLocale, isValidLocale, requiresTranslation, resolveAliasLocale, resolveCanonicalLocale, standardizeLocale };
//# sourceMappingURL=index.d.cts.map