gt-react 10.19.15 → 10.19.17

package/dist/client.d.cts

@@ -0,0 +1,248 @@
+import { JSX, ReactNode } from "react";
+import { Branch, Currency, DateTime, Derive, GTProvider, Num, Plural, RelativeTime, Static, T, Var, declareStatic, declareVar, decodeMsg, decodeOptions, decodeVars, derive, gtFallback, mFallback, msg, useDefaultLocale, useGT, useGTClass, useLocale, useLocaleDirection, useLocaleProperties, useLocaleSelector, useLocales, useMessages, useRegion, useRegionSelector, useSetLocale, useTranslations, useVersionId } from "@generaltranslation/react-core";
+
+//#region ../react-core/dist/types.d.ts
+//#endregion
+//#region src/locales/getRegionProperties.d.ts
+//#endregion
+//#region src/types-dir/jsx/variables.d.ts
+type VariableType = 'v' | 'n' | 'd' | 'c' | 'rt';
+/**
+ * Variables are used to store the variable name and type.
+ */
+type Variable = {
+  k: string;
+  i?: number;
+  v?: VariableType;
+}; //#endregion
+//#region src/types-dir/jsx/content.d.ts
+/**
+ * Map of data-_gt properties to their corresponding React props
+ */
+declare const HTML_CONTENT_PROPS: {
+  readonly pl: "placeholder";
+  readonly ti: "title";
+  readonly alt: "alt";
+  readonly arl: "aria-label";
+  readonly arb: "aria-labelledby";
+  readonly ard: "aria-describedby";
+};
+type HtmlContentPropKeysRecord = Partial<Record<keyof typeof HTML_CONTENT_PROPS, string>>;
+/**
+ * GTProp is an internal property used to contain data for translating and rendering elements.
+ * note, transformations are only read on the server side if they are 'plural' or 'branch'
+ */
+type GTProp = {
+  b?: Record<string, JsxChildren>;
+  t?: 'p' | 'b';
+} & HtmlContentPropKeysRecord;
+type JsxElement = {
+  t?: string;
+  i?: number;
+  d?: GTProp;
+  c?: JsxChildren;
+};
+type JsxChild = string | JsxElement | Variable;
+/**
+ * The format of the string content
+ */
+/**
+ * String format content.
+ */
+/**
+ * A content type representing JSX elements.
+ */
+type JsxChildren = JsxChild | JsxChild[];
+/**
+ * A content type representing ICU messages.
+ */
+//#endregion
+//#region ../core/dist/types-CdRgQtET.d.cts
+/**
+ * For dictionaries, we have Entry and MetaEntry
+ */
+type Entry = string;
+type MetaEntry = {
+  $context?: string;
+  $maxChars?: number;
+  $_hash?: string;
+  [key: string]: unknown;
+};
+type DictionaryEntry = Entry | [Entry] | [Entry, MetaEntry];
+type Dictionary = {
+  [key: string]: Dictionary | DictionaryEntry;
+} | (Dictionary | DictionaryEntry)[];
+/**
+ * Translated content types
+ * TODO: move these types to JsxElement etc from generaltranslation/types
+ * remember to omit the t property (tag name) from the translated element
+ */
+type TranslatedElement = {
+  i?: number;
+  d?: GTProp;
+  c?: TranslatedChildren;
+};
+type TranslatedChild = TranslatedElement | string | Variable;
+type TranslatedChildren = TranslatedChild | TranslatedChild[];
+type Translations = {
+  [hash: string]: TranslatedChildren | null;
+};
+/**
+ * @deprecated use {@link Dictionary}
+ */
+type RenderMethod = 'skeleton' | 'replace' | 'default';
+//#endregion
+//#region ../format/dist/types-COaQnqVZ.d.cts
+//#region src/locales/customLocaleMapping.d.ts
+type CustomMapping = Record<string, string | Partial<LocaleProperties>>; //#endregion
+//#region src/locales/getLocaleProperties.d.ts
+type LocaleProperties = {
+  code: string;
+  name: string;
+  nativeName: string;
+  languageCode: string;
+  languageName: string;
+  nativeLanguageName: string;
+  nameWithRegionCode: string;
+  nativeNameWithRegionCode: string;
+  regionCode: string;
+  regionName: string;
+  nativeRegionName: string;
+  scriptCode: string;
+  scriptName: string;
+  nativeScriptName: string;
+  maximizedCode: string;
+  maximizedName: string;
+  nativeMaximizedName: string;
+  minimizedCode: string;
+  minimizedName: string;
+  nativeMinimizedName: string;
+  emoji: string;
+}; //#endregion
+//#region src/locales/getRegionProperties.d.ts
+//#endregion
+//#region src/react-context/types/config.d.ts
+type ClientProviderProps = {
+  children: ReactNode;
+  dictionary: Dictionary;
+  dictionaryTranslations: Dictionary;
+  translations: Translations;
+  locale: string;
+  locales: string[];
+  region?: string;
+  _versionId?: string;
+  dictionaryEnabled?: boolean;
+  defaultLocale: string;
+  translationRequired: boolean;
+  dialectTranslationRequired: boolean;
+  renderSettings: {
+    method: RenderMethod;
+    timeout?: number;
+  };
+  developmentApiEnabled: boolean;
+  projectId?: string;
+  devApiKey?: string;
+  runtimeUrl?: string | null;
+  gtServicesEnabled?: boolean;
+  localeCookieName?: string;
+  resetLocaleCookieName: string;
+  regionCookieName?: string;
+  customMapping?: CustomMapping;
+  environment: 'development' | 'production' | 'test';
+  reloadServer: () => void;
+};
+//#endregion
+//#region src/react-context/provider/ClientProvider.d.ts
+declare function ClientProvider({
+  children,
+  dictionary: _dictionary,
+  dictionaryTranslations: _dictionaryTranslations,
+  translations: _translations,
+  locale: _locale,
+  region: _region,
+  _versionId,
+  defaultLocale,
+  translationRequired,
+  dialectTranslationRequired,
+  locales,
+  renderSettings,
+  projectId,
+  devApiKey,
+  runtimeUrl,
+  developmentApiEnabled,
+  resetLocaleCookieName,
+  localeCookieName,
+  regionCookieName,
+  customMapping,
+  environment,
+  reloadServer
+}: ClientProviderProps): JSX.Element;
+//#endregion
+//#region src/react-context/ui/LocaleSelector.d.ts
+/**
+ * A dropdown component that allows users to select a locale.
+ * @param {string[]} [locales] - An optional list of locales to use for the dropdown. If not provided, the list of locales from the `<GTProvider>` context is used.
+ * @param {object} [customNames] - (deprecated) An optional object to map locales to custom names. Use `customMapping` instead.
+ * @param {CustomMapping} [customMapping] - An optional object to map locales to custom display names, emojis, or other properties.
+ * @returns {React.ReactElement | null} The rendered locale dropdown component or null to prevent rendering.
+ */
+declare function LocaleSelector({
+  locales: _locales,
+  ...props
+}: {
+  locales?: string[];
+  customNames?: {
+    [key: string]: string;
+  };
+  customMapping?: CustomMapping;
+  [key: string]: unknown;
+}): JSX.Element | null;
+//#endregion
+//#region src/react-context/ui/RegionSelector.d.ts
+/**
+ * A dropdown component that allows users to select a region.
+ *
+ * @param {string[]} [regions] - An optional array of ISO 3166 region codes to display. If not provided, regions are inferred from supported locales in the `<GTProvider>` context.
+ * @param {React.ReactNode} [placeholder] - Optional placeholder node to display as the first option when no region is selected.
+ * @param {object} [customMapping] - An optional object to map region codes to custom display names, emojis, or associated locales. The value can be a string (display name) or an object with `name`, `emoji`, and/or `locale` properties.
+ * @param {boolean} [prioritizeCurrentLocaleRegion] - If true, the region corresponding to the current locale is prioritized in the list.
+ * @param {boolean} [sortRegionsAlphabetically] - If true, regions are sorted alphabetically by display name.
+ * @param {boolean} [asLocaleSelector=false] - If true, selecting a region will also update the locale to the region's associated locale.
+ * @param {object} [props] - Additional props to pass to the underlying `<select>` element.
+ * @returns {React.JSX.Element | null} The rendered region dropdown component or null if no regions are available.
+ *
+ * @example
+ * ```tsx
+ * <RegionSelector
+ *   regions={['US', 'CA']}
+ *   customMapping={{ US: { name: "United States", emoji: "🇺🇸" } }}
+ *   placeholder="Select a region"
+ * />
+ * ```
+ */
+declare function RegionSelector<Regions extends string[]>({
+  regions: _regions,
+  placeholder,
+  customMapping,
+  prioritizeCurrentLocaleRegion,
+  sortRegionsAlphabetically,
+  asLocaleSelector,
+  ...props
+}: {
+  regions?: Regions;
+  placeholder?: ReactNode;
+  customMapping?: {
+    [region: string]: string | {
+      name?: string;
+      locale?: string;
+      emoji?: string;
+    };
+  };
+  prioritizeCurrentLocaleRegion?: boolean;
+  sortRegionsAlphabetically?: boolean;
+  asLocaleSelector?: boolean;
+  [key: string]: unknown;
+}): JSX.Element;
+//#endregion
+export { Branch, ClientProvider, Currency, DateTime, Derive, GTProvider, LocaleSelector, Num, Plural, RegionSelector, RelativeTime, Static, T, Var, declareStatic, declareVar, decodeMsg, decodeOptions, decodeVars, derive, gtFallback, mFallback, msg, useDefaultLocale, useGT, useGTClass, useLocale, useLocaleDirection, useLocaleProperties, useLocaleSelector, useLocales, useMessages, useRegion, useRegionSelector, useSetLocale, useTranslations, useVersionId };
+//# sourceMappingURL=client.d.cts.map

package/dist/client.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.cts","names":["React","ReactNode","GT","CustomMapping","LocaleProperties","Partial","Record","code","name","nativeName","languageCode","languageName","nativeLanguageName","nameWithRegionCode","nativeNameWithRegionCode","regionCode","regionName","nativeRegionName","scriptCode","scriptName","nativeScriptName","maximizedCode","maximizedName","nativeMaximizedName","minimizedCode","minimizedName","nativeMinimizedName","emoji","VariableType","Variable","k","i","v","HTML_CONTENT_PROPS","pl","ti","alt","arl","arb","ard","HtmlContentPropKeysRecord","GTProp","JsxChildren","b","t","JsxElement","d","c","JsxChild","StringFormat","DataFormat","TransformationPrefix","VariableTransformationSuffix","InjectionType","BaseTranslationOptions","DictionaryTranslationOptions","InlineTranslationOptions","$context","$id","$format","$locale","$_locales","$_hash","$maxChars","$_source","RuntimeTranslationOptions","Omit","SyncResolutionFunctionWithFallback","message","options","GTFunctionType","MFunctionType","T","encodedMsg","GTTag","TaggedChildren","id","injectionType","transformation","branches","variableType","TaggedElementProps","Key","children","branch","n","key","TaggedElement","ReactElement","TaggedChild","Exclude","Entry","MetaEntry","DictionaryEntry","Dictionary","FlattenedDictionary","TranslatedElement","TranslatedChildren","TranslatedChild","Translations","hash","DictionaryContent","DictionaryObject","LocalesDictionary","locale","CustomLoader","Promise","RenderMethod","RelativeTimeFormatOptions","Intl","RelativeTimeFormatUnit","Date","unit","baseDate","VariableProps","NumberFormatOptions","DateTimeFormatOptions","variableValue","variableOptions","variableName","RenderVariable","locales","_Message","_Messages","TranslateIcuCallback","source","targetLocale","metadata","context","maxChars","params","TranslateChildrenCallback","GTContextType","gt","registerIcuForTranslation","registerJsxForTranslation","_gtFunction","preloadedTranslations","_mFunction","_filterMessagesForPreload","_messages","_preloadMessages","_dictionaryFunction","_dictionaryObjFunction","idWithParent","developmentApiEnabled","setLocale","defaultLocale","region","setRegion","translations","translationRequired","dialectTranslationRequired","renderSettings","method","timeout","projectId","_versionId","AuthFromEnvParams","devApiKey","AuthFromEnvReturn","UseDetermineLocaleParams","enableI18n","localeCookieName","ssr","customMapping","reloadOnLocaleUpdate","UseDetermineLocaleReturn","UseRegionStateParams","_region","regionCookieName","UseRegionStateReturn","UseEnableI18nParams","enableI18nCookieName","enableI18nLoaded","UseEnableI18nReturn","LocaleSelectorProps","customNames","RegionSelectorProps","Regions","regions","placeholder","prioritizeCurrentLocaleRegion","sortRegionsAlphabetically","GTConfig","dictionary","runtimeUrl","cacheUrl","modelProvider","InternalGTProviderProps","loadDictionary","loadTranslations","config","fallback","environment","readAuthFromEnv","useDetermineLocale","useRegionState","useEnableI18n","Metadata","CustomMapping","LocaleProperties","Partial","Record","code","name","nativeName","languageCode","languageName","nativeLanguageName","nameWithRegionCode","nativeNameWithRegionCode","regionCode","regionName","nativeRegionName","scriptCode","scriptName","nativeScriptName","maximizedCode","maximizedName","nativeMaximizedName","minimizedCode","minimizedName","nativeMinimizedName","emoji","CustomRegionMapping","region","locale","getRegionProperties","defaultLocale","customMapping","CutoffFormatStyle","TerminatorOptions","terminator","separator","CutoffFormatOptions","maxChars","style","VariableType","Variable","k","i","v","HTML_CONTENT_PROPS","pl","ti","alt","arl","arb","ard","HtmlContentPropKeysRecord","HtmlContentPropValuesRecord","GTProp","JsxChildren","b","t","JsxElement","d","c","JsxChild","StringFormat","DataFormat","StringContent","IcuMessage","StringMessage","I18nextMessage","Content","FormatVariables","Date","S","_","a","f","g","h","l","m","n","o","p","r","s","u","x","y"],"sources":["../../react-core/dist/types.d.ts","../../format/dist/types-COaQnqVZ.d.cts","../src/react-context/types/config.ts","../src/react-context/provider/ClientProvider.tsx","../src/react-context/ui/LocaleSelector.tsx","../src/react-context/ui/RegionSelector.tsx"],"mappings":"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"}

package/dist/client.d.mts

@@ -0,0 +1,249 @@
+import { JSX, ReactNode } from "react";
+import { GT } from "generaltranslation";
+import { Branch, Currency, DateTime, Derive, GTProvider, Num, Plural, RelativeTime, Static, T, Var, declareStatic, declareVar, decodeMsg, decodeOptions, decodeVars, derive, gtFallback, mFallback, msg, useDefaultLocale, useGT, useGTClass, useLocale, useLocaleDirection, useLocaleProperties, useLocaleSelector, useLocales, useMessages, useRegion, useRegionSelector, useSetLocale, useTranslations, useVersionId } from "@generaltranslation/react-core";
+
+//#region ../react-core/dist/types.d.ts
+//#endregion
+//#region src/locales/getRegionProperties.d.ts
+//#endregion
+//#region src/types-dir/jsx/variables.d.ts
+type VariableType = 'v' | 'n' | 'd' | 'c' | 'rt';
+/**
+ * Variables are used to store the variable name and type.
+ */
+type Variable = {
+  k: string;
+  i?: number;
+  v?: VariableType;
+}; //#endregion
+//#region src/types-dir/jsx/content.d.ts
+/**
+ * Map of data-_gt properties to their corresponding React props
+ */
+declare const HTML_CONTENT_PROPS: {
+  readonly pl: "placeholder";
+  readonly ti: "title";
+  readonly alt: "alt";
+  readonly arl: "aria-label";
+  readonly arb: "aria-labelledby";
+  readonly ard: "aria-describedby";
+};
+type HtmlContentPropKeysRecord = Partial<Record<keyof typeof HTML_CONTENT_PROPS, string>>;
+/**
+ * GTProp is an internal property used to contain data for translating and rendering elements.
+ * note, transformations are only read on the server side if they are 'plural' or 'branch'
+ */
+type GTProp = {
+  b?: Record<string, JsxChildren>;
+  t?: 'p' | 'b';
+} & HtmlContentPropKeysRecord;
+type JsxElement = {
+  t?: string;
+  i?: number;
+  d?: GTProp;
+  c?: JsxChildren;
+};
+type JsxChild = string | JsxElement | Variable;
+/**
+ * The format of the string content
+ */
+/**
+ * String format content.
+ */
+/**
+ * A content type representing JSX elements.
+ */
+type JsxChildren = JsxChild | JsxChild[];
+/**
+ * A content type representing ICU messages.
+ */
+//#endregion
+//#region ../core/dist/types-CdRgQtET.d.cts
+/**
+ * For dictionaries, we have Entry and MetaEntry
+ */
+type Entry = string;
+type MetaEntry = {
+  $context?: string;
+  $maxChars?: number;
+  $_hash?: string;
+  [key: string]: unknown;
+};
+type DictionaryEntry = Entry | [Entry] | [Entry, MetaEntry];
+type Dictionary = {
+  [key: string]: Dictionary | DictionaryEntry;
+} | (Dictionary | DictionaryEntry)[];
+/**
+ * Translated content types
+ * TODO: move these types to JsxElement etc from generaltranslation/types
+ * remember to omit the t property (tag name) from the translated element
+ */
+type TranslatedElement = {
+  i?: number;
+  d?: GTProp;
+  c?: TranslatedChildren;
+};
+type TranslatedChild = TranslatedElement | string | Variable;
+type TranslatedChildren = TranslatedChild | TranslatedChild[];
+type Translations = {
+  [hash: string]: TranslatedChildren | null;
+};
+/**
+ * @deprecated use {@link Dictionary}
+ */
+type RenderMethod = 'skeleton' | 'replace' | 'default';
+//#endregion
+//#region ../format/dist/types-COaQnqVZ.d.cts
+//#region src/locales/customLocaleMapping.d.ts
+type CustomMapping = Record<string, string | Partial<LocaleProperties>>; //#endregion
+//#region src/locales/getLocaleProperties.d.ts
+type LocaleProperties = {
+  code: string;
+  name: string;
+  nativeName: string;
+  languageCode: string;
+  languageName: string;
+  nativeLanguageName: string;
+  nameWithRegionCode: string;
+  nativeNameWithRegionCode: string;
+  regionCode: string;
+  regionName: string;
+  nativeRegionName: string;
+  scriptCode: string;
+  scriptName: string;
+  nativeScriptName: string;
+  maximizedCode: string;
+  maximizedName: string;
+  nativeMaximizedName: string;
+  minimizedCode: string;
+  minimizedName: string;
+  nativeMinimizedName: string;
+  emoji: string;
+}; //#endregion
+//#region src/locales/getRegionProperties.d.ts
+//#endregion
+//#region src/react-context/types/config.d.ts
+type ClientProviderProps = {
+  children: ReactNode;
+  dictionary: Dictionary;
+  dictionaryTranslations: Dictionary;
+  translations: Translations;
+  locale: string;
+  locales: string[];
+  region?: string;
+  _versionId?: string;
+  dictionaryEnabled?: boolean;
+  defaultLocale: string;
+  translationRequired: boolean;
+  dialectTranslationRequired: boolean;
+  renderSettings: {
+    method: RenderMethod;
+    timeout?: number;
+  };
+  developmentApiEnabled: boolean;
+  projectId?: string;
+  devApiKey?: string;
+  runtimeUrl?: string | null;
+  gtServicesEnabled?: boolean;
+  localeCookieName?: string;
+  resetLocaleCookieName: string;
+  regionCookieName?: string;
+  customMapping?: CustomMapping;
+  environment: 'development' | 'production' | 'test';
+  reloadServer: () => void;
+};
+//#endregion
+//#region src/react-context/provider/ClientProvider.d.ts
+declare function ClientProvider({
+  children,
+  dictionary: _dictionary,
+  dictionaryTranslations: _dictionaryTranslations,
+  translations: _translations,
+  locale: _locale,
+  region: _region,
+  _versionId,
+  defaultLocale,
+  translationRequired,
+  dialectTranslationRequired,
+  locales,
+  renderSettings,
+  projectId,
+  devApiKey,
+  runtimeUrl,
+  developmentApiEnabled,
+  resetLocaleCookieName,
+  localeCookieName,
+  regionCookieName,
+  customMapping,
+  environment,
+  reloadServer
+}: ClientProviderProps): JSX.Element;
+//#endregion
+//#region src/react-context/ui/LocaleSelector.d.ts
+/**
+ * A dropdown component that allows users to select a locale.
+ * @param {string[]} [locales] - An optional list of locales to use for the dropdown. If not provided, the list of locales from the `<GTProvider>` context is used.
+ * @param {object} [customNames] - (deprecated) An optional object to map locales to custom names. Use `customMapping` instead.
+ * @param {CustomMapping} [customMapping] - An optional object to map locales to custom display names, emojis, or other properties.
+ * @returns {React.ReactElement | null} The rendered locale dropdown component or null to prevent rendering.
+ */
+declare function LocaleSelector({
+  locales: _locales,
+  ...props
+}: {
+  locales?: string[];
+  customNames?: {
+    [key: string]: string;
+  };
+  customMapping?: CustomMapping;
+  [key: string]: unknown;
+}): JSX.Element | null;
+//#endregion
+//#region src/react-context/ui/RegionSelector.d.ts
+/**
+ * A dropdown component that allows users to select a region.
+ *
+ * @param {string[]} [regions] - An optional array of ISO 3166 region codes to display. If not provided, regions are inferred from supported locales in the `<GTProvider>` context.
+ * @param {React.ReactNode} [placeholder] - Optional placeholder node to display as the first option when no region is selected.
+ * @param {object} [customMapping] - An optional object to map region codes to custom display names, emojis, or associated locales. The value can be a string (display name) or an object with `name`, `emoji`, and/or `locale` properties.
+ * @param {boolean} [prioritizeCurrentLocaleRegion] - If true, the region corresponding to the current locale is prioritized in the list.
+ * @param {boolean} [sortRegionsAlphabetically] - If true, regions are sorted alphabetically by display name.
+ * @param {boolean} [asLocaleSelector=false] - If true, selecting a region will also update the locale to the region's associated locale.
+ * @param {object} [props] - Additional props to pass to the underlying `<select>` element.
+ * @returns {React.JSX.Element | null} The rendered region dropdown component or null if no regions are available.
+ *
+ * @example
+ * ```tsx
+ * <RegionSelector
+ *   regions={['US', 'CA']}
+ *   customMapping={{ US: { name: "United States", emoji: "🇺🇸" } }}
+ *   placeholder="Select a region"
+ * />
+ * ```
+ */
+declare function RegionSelector<Regions extends string[]>({
+  regions: _regions,
+  placeholder,
+  customMapping,
+  prioritizeCurrentLocaleRegion,
+  sortRegionsAlphabetically,
+  asLocaleSelector,
+  ...props
+}: {
+  regions?: Regions;
+  placeholder?: ReactNode;
+  customMapping?: {
+    [region: string]: string | {
+      name?: string;
+      locale?: string;
+      emoji?: string;
+    };
+  };
+  prioritizeCurrentLocaleRegion?: boolean;
+  sortRegionsAlphabetically?: boolean;
+  asLocaleSelector?: boolean;
+  [key: string]: unknown;
+}): JSX.Element;
+//#endregion
+export { Branch, ClientProvider, Currency, DateTime, Derive, GTProvider, LocaleSelector, Num, Plural, RegionSelector, RelativeTime, Static, T, Var, declareStatic, declareVar, decodeMsg, decodeOptions, decodeVars, derive, gtFallback, mFallback, msg, useDefaultLocale, useGT, useGTClass, useLocale, useLocaleDirection, useLocaleProperties, useLocaleSelector, useLocales, useMessages, useRegion, useRegionSelector, useSetLocale, useTranslations, useVersionId };
+//# sourceMappingURL=client.d.mts.map

package/dist/client.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.mts","names":["React","ReactNode","GT","CustomMapping","LocaleProperties","Partial","Record","code","name","nativeName","languageCode","languageName","nativeLanguageName","nameWithRegionCode","nativeNameWithRegionCode","regionCode","regionName","nativeRegionName","scriptCode","scriptName","nativeScriptName","maximizedCode","maximizedName","nativeMaximizedName","minimizedCode","minimizedName","nativeMinimizedName","emoji","VariableType","Variable","k","i","v","HTML_CONTENT_PROPS","pl","ti","alt","arl","arb","ard","HtmlContentPropKeysRecord","GTProp","JsxChildren","b","t","JsxElement","d","c","JsxChild","StringFormat","DataFormat","TransformationPrefix","VariableTransformationSuffix","InjectionType","BaseTranslationOptions","DictionaryTranslationOptions","InlineTranslationOptions","$context","$id","$format","$locale","$_locales","$_hash","$maxChars","$_source","RuntimeTranslationOptions","Omit","SyncResolutionFunctionWithFallback","message","options","GTFunctionType","MFunctionType","T","encodedMsg","GTTag","TaggedChildren","id","injectionType","transformation","branches","variableType","TaggedElementProps","Key","children","branch","n","key","TaggedElement","ReactElement","TaggedChild","Exclude","Entry","MetaEntry","DictionaryEntry","Dictionary","FlattenedDictionary","TranslatedElement","TranslatedChildren","TranslatedChild","Translations","hash","DictionaryContent","DictionaryObject","LocalesDictionary","locale","CustomLoader","Promise","RenderMethod","RelativeTimeFormatOptions","Intl","RelativeTimeFormatUnit","Date","unit","baseDate","VariableProps","NumberFormatOptions","DateTimeFormatOptions","variableValue","variableOptions","variableName","RenderVariable","locales","_Message","_Messages","TranslateIcuCallback","source","targetLocale","metadata","context","maxChars","params","TranslateChildrenCallback","GTContextType","gt","registerIcuForTranslation","registerJsxForTranslation","_gtFunction","preloadedTranslations","_mFunction","_filterMessagesForPreload","_messages","_preloadMessages","_dictionaryFunction","_dictionaryObjFunction","idWithParent","developmentApiEnabled","setLocale","defaultLocale","region","setRegion","translations","translationRequired","dialectTranslationRequired","renderSettings","method","timeout","projectId","_versionId","AuthFromEnvParams","devApiKey","AuthFromEnvReturn","UseDetermineLocaleParams","enableI18n","localeCookieName","ssr","customMapping","reloadOnLocaleUpdate","UseDetermineLocaleReturn","UseRegionStateParams","_region","regionCookieName","UseRegionStateReturn","UseEnableI18nParams","enableI18nCookieName","enableI18nLoaded","UseEnableI18nReturn","LocaleSelectorProps","customNames","RegionSelectorProps","Regions","regions","placeholder","prioritizeCurrentLocaleRegion","sortRegionsAlphabetically","GTConfig","dictionary","runtimeUrl","cacheUrl","modelProvider","InternalGTProviderProps","loadDictionary","loadTranslations","config","fallback","environment","readAuthFromEnv","useDetermineLocale","useRegionState","useEnableI18n","Metadata","CustomMapping","LocaleProperties","Partial","Record","code","name","nativeName","languageCode","languageName","nativeLanguageName","nameWithRegionCode","nativeNameWithRegionCode","regionCode","regionName","nativeRegionName","scriptCode","scriptName","nativeScriptName","maximizedCode","maximizedName","nativeMaximizedName","minimizedCode","minimizedName","nativeMinimizedName","emoji","CustomRegionMapping","region","locale","getRegionProperties","defaultLocale","customMapping","CutoffFormatStyle","TerminatorOptions","terminator","separator","CutoffFormatOptions","maxChars","style","VariableType","Variable","k","i","v","HTML_CONTENT_PROPS","pl","ti","alt","arl","arb","ard","HtmlContentPropKeysRecord","HtmlContentPropValuesRecord","GTProp","JsxChildren","b","t","JsxElement","d","c","JsxChild","StringFormat","DataFormat","StringContent","IcuMessage","StringMessage","I18nextMessage","Content","FormatVariables","Date","S","_","a","f","g","h","l","m","n","o","p","r","s","u","x","y"],"sources":["../../react-core/dist/types.d.ts","../../format/dist/types-COaQnqVZ.d.cts","../src/react-context/types/config.ts","../src/react-context/provider/ClientProvider.tsx","../src/react-context/ui/LocaleSelector.tsx","../src/react-context/ui/RegionSelector.tsx"],"mappings":"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"}