gt-react 10.19.15 β†’ 10.19.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (170) hide show
  1. package/CHANGELOG.md +13 -0
  2. package/dist/browser.cjs +10789 -0
  3. package/dist/browser.cjs.map +1 -0
  4. package/dist/browser.d.cts +732 -0
  5. package/dist/browser.d.cts.map +1 -0
  6. package/dist/browser.d.mts +734 -0
  7. package/dist/browser.d.mts.map +1 -0
  8. package/dist/browser.mjs +10751 -0
  9. package/dist/browser.mjs.map +1 -0
  10. package/dist/client.cjs +3356 -0
  11. package/dist/client.cjs.map +1 -0
  12. package/dist/client.d.cts +249 -0
  13. package/dist/client.d.cts.map +1 -0
  14. package/dist/client.d.mts +250 -0
  15. package/dist/client.d.mts.map +1 -0
  16. package/dist/client.mjs +3296 -0
  17. package/dist/client.mjs.map +1 -0
  18. package/dist/index.cjs +3509 -0
  19. package/dist/index.cjs.map +1 -0
  20. package/dist/index.d.cts +377 -0
  21. package/dist/index.d.cts.map +1 -0
  22. package/dist/index.d.mts +376 -0
  23. package/dist/index.d.mts.map +1 -0
  24. package/dist/index.mjs +3453 -0
  25. package/dist/index.mjs.map +1 -0
  26. package/dist/internal.cjs +3954 -0
  27. package/dist/internal.cjs.map +1 -0
  28. package/dist/internal.d.cts +1118 -0
  29. package/dist/internal.d.cts.map +1 -0
  30. package/dist/internal.d.mts +1118 -0
  31. package/dist/internal.d.mts.map +1 -0
  32. package/dist/internal.mjs +3893 -0
  33. package/dist/internal.mjs.map +1 -0
  34. package/dist/macros.cjs +6139 -0
  35. package/dist/macros.cjs.map +1 -0
  36. package/dist/macros.d.cts +25 -0
  37. package/dist/macros.d.cts.map +1 -0
  38. package/dist/macros.d.mts +25 -0
  39. package/dist/macros.d.mts.map +1 -0
  40. package/dist/macros.mjs +6140 -0
  41. package/dist/macros.mjs.map +1 -0
  42. package/package.json +60 -40
  43. package/dist/browser-types.d.ts +0 -5
  44. package/dist/browser-types.d.ts.map +0 -1
  45. package/dist/browser.cjs.min.cjs +0 -2
  46. package/dist/browser.cjs.min.cjs.map +0 -1
  47. package/dist/browser.d.ts +0 -4
  48. package/dist/browser.d.ts.map +0 -1
  49. package/dist/browser.esm.min.mjs +0 -2
  50. package/dist/browser.esm.min.mjs.map +0 -1
  51. package/dist/client.cjs.min.cjs +0 -2
  52. package/dist/client.cjs.min.cjs.map +0 -1
  53. package/dist/client.d.ts +0 -6
  54. package/dist/client.d.ts.map +0 -1
  55. package/dist/client.esm.min.mjs +0 -2
  56. package/dist/client.esm.min.mjs.map +0 -1
  57. package/dist/i18n-context/browser-i18n-manager/BrowserConditionStore.d.ts +0 -32
  58. package/dist/i18n-context/browser-i18n-manager/BrowserConditionStore.d.ts.map +0 -1
  59. package/dist/i18n-context/browser-i18n-manager/BrowserI18nManager.d.ts +0 -42
  60. package/dist/i18n-context/browser-i18n-manager/BrowserI18nManager.d.ts.map +0 -1
  61. package/dist/i18n-context/browser-i18n-manager/LocalStorageTranslationCache.d.ts +0 -90
  62. package/dist/i18n-context/browser-i18n-manager/LocalStorageTranslationCache.d.ts.map +0 -1
  63. package/dist/i18n-context/browser-i18n-manager/singleton-operations.d.ts +0 -9
  64. package/dist/i18n-context/browser-i18n-manager/singleton-operations.d.ts.map +0 -1
  65. package/dist/i18n-context/browser-i18n-manager/utils/constants.d.ts +0 -3
  66. package/dist/i18n-context/browser-i18n-manager/utils/constants.d.ts.map +0 -1
  67. package/dist/i18n-context/browser-i18n-manager/utils/cookies.d.ts +0 -19
  68. package/dist/i18n-context/browser-i18n-manager/utils/cookies.d.ts.map +0 -1
  69. package/dist/i18n-context/browser-i18n-manager/utils/determineLocale.d.ts +0 -15
  70. package/dist/i18n-context/browser-i18n-manager/utils/determineLocale.d.ts.map +0 -1
  71. package/dist/i18n-context/browser-i18n-manager/utils/types.d.ts +0 -14
  72. package/dist/i18n-context/browser-i18n-manager/utils/types.d.ts.map +0 -1
  73. package/dist/i18n-context/functions/branching/GtInternalBranch.d.ts +0 -29
  74. package/dist/i18n-context/functions/branching/GtInternalBranch.d.ts.map +0 -1
  75. package/dist/i18n-context/functions/branching/GtInternalPlural.d.ts +0 -30
  76. package/dist/i18n-context/functions/branching/GtInternalPlural.d.ts.map +0 -1
  77. package/dist/i18n-context/functions/branching/index.d.ts +0 -3
  78. package/dist/i18n-context/functions/branching/index.d.ts.map +0 -1
  79. package/dist/i18n-context/functions/derivation/GtInternalDerive.d.ts +0 -31
  80. package/dist/i18n-context/functions/derivation/GtInternalDerive.d.ts.map +0 -1
  81. package/dist/i18n-context/functions/derivation/index.d.ts +0 -2
  82. package/dist/i18n-context/functions/derivation/index.d.ts.map +0 -1
  83. package/dist/i18n-context/functions/html-tag-operations.d.ts +0 -19
  84. package/dist/i18n-context/functions/html-tag-operations.d.ts.map +0 -1
  85. package/dist/i18n-context/functions/index.d.ts +0 -8
  86. package/dist/i18n-context/functions/index.d.ts.map +0 -1
  87. package/dist/i18n-context/functions/locale-operations.d.ts +0 -11
  88. package/dist/i18n-context/functions/locale-operations.d.ts.map +0 -1
  89. package/dist/i18n-context/functions/translation/GtInternalRuntimeTranslateJsx.d.ts +0 -11
  90. package/dist/i18n-context/functions/translation/GtInternalRuntimeTranslateJsx.d.ts.map +0 -1
  91. package/dist/i18n-context/functions/translation/GtInternalRuntimeTranslateString.d.ts +0 -11
  92. package/dist/i18n-context/functions/translation/GtInternalRuntimeTranslateString.d.ts.map +0 -1
  93. package/dist/i18n-context/functions/translation/GtInternalTranslateJsx.d.ts +0 -33
  94. package/dist/i18n-context/functions/translation/GtInternalTranslateJsx.d.ts.map +0 -1
  95. package/dist/i18n-context/functions/translation/index.d.ts +0 -5
  96. package/dist/i18n-context/functions/translation/index.d.ts.map +0 -1
  97. package/dist/i18n-context/functions/translation/t.d.ts +0 -25
  98. package/dist/i18n-context/functions/translation/t.d.ts.map +0 -1
  99. package/dist/i18n-context/functions/translation/types.d.ts +0 -21
  100. package/dist/i18n-context/functions/translation/types.d.ts.map +0 -1
  101. package/dist/i18n-context/functions/variables/GtInternalCurrency.d.ts +0 -28
  102. package/dist/i18n-context/functions/variables/GtInternalCurrency.d.ts.map +0 -1
  103. package/dist/i18n-context/functions/variables/GtInternalDateTime.d.ts +0 -26
  104. package/dist/i18n-context/functions/variables/GtInternalDateTime.d.ts.map +0 -1
  105. package/dist/i18n-context/functions/variables/GtInternalNum.d.ts +0 -26
  106. package/dist/i18n-context/functions/variables/GtInternalNum.d.ts.map +0 -1
  107. package/dist/i18n-context/functions/variables/GtInternalRelativeTime.d.ts +0 -35
  108. package/dist/i18n-context/functions/variables/GtInternalRelativeTime.d.ts.map +0 -1
  109. package/dist/i18n-context/functions/variables/GtInternalVar.d.ts +0 -23
  110. package/dist/i18n-context/functions/variables/GtInternalVar.d.ts.map +0 -1
  111. package/dist/i18n-context/functions/variables/index.d.ts +0 -6
  112. package/dist/i18n-context/functions/variables/index.d.ts.map +0 -1
  113. package/dist/i18n-context/functions/variables/utils/computeVar.d.ts +0 -9
  114. package/dist/i18n-context/functions/variables/utils/computeVar.d.ts.map +0 -1
  115. package/dist/i18n-context/functions/variables/utils/renderVariable.d.ts +0 -15
  116. package/dist/i18n-context/functions/variables/utils/renderVariable.d.ts.map +0 -1
  117. package/dist/i18n-context/setup/bootstrap.d.ts +0 -22
  118. package/dist/i18n-context/setup/bootstrap.d.ts.map +0 -1
  119. package/dist/i18n-context/setup/index.d.ts +0 -3
  120. package/dist/i18n-context/setup/index.d.ts.map +0 -1
  121. package/dist/i18n-context/setup/initializeGT.d.ts +0 -7
  122. package/dist/i18n-context/setup/initializeGT.d.ts.map +0 -1
  123. package/dist/i18n-context/setup/types.d.ts +0 -19
  124. package/dist/i18n-context/setup/types.d.ts.map +0 -1
  125. package/dist/i18n-context/ui/LocaleSelector.d.ts +0 -18
  126. package/dist/i18n-context/ui/LocaleSelector.d.ts.map +0 -1
  127. package/dist/i18n-context/utils/enforceBrowser.d.ts +0 -7
  128. package/dist/i18n-context/utils/enforceBrowser.d.ts.map +0 -1
  129. package/dist/index.cjs.min.cjs +0 -2
  130. package/dist/index.cjs.min.cjs.map +0 -1
  131. package/dist/index.d.ts +0 -8
  132. package/dist/index.d.ts.map +0 -1
  133. package/dist/index.esm.min.mjs +0 -2
  134. package/dist/index.esm.min.mjs.map +0 -1
  135. package/dist/internal.cjs.min.cjs +0 -2
  136. package/dist/internal.cjs.min.cjs.map +0 -1
  137. package/dist/internal.d.ts +0 -7
  138. package/dist/internal.d.ts.map +0 -1
  139. package/dist/internal.esm.min.mjs +0 -2
  140. package/dist/internal.esm.min.mjs.map +0 -1
  141. package/dist/macros.cjs.min.cjs +0 -2
  142. package/dist/macros.cjs.min.cjs.map +0 -1
  143. package/dist/macros.d.ts +0 -22
  144. package/dist/macros.d.ts.map +0 -1
  145. package/dist/macros.esm.min.mjs +0 -2
  146. package/dist/macros.esm.min.mjs.map +0 -1
  147. package/dist/react-context/provider/ClientProvider.d.ts +0 -4
  148. package/dist/react-context/provider/ClientProvider.d.ts.map +0 -1
  149. package/dist/react-context/provider/GTProvider.d.ts +0 -29
  150. package/dist/react-context/provider/GTProvider.d.ts.map +0 -1
  151. package/dist/react-context/provider/helpers/isSSREnabled.d.ts +0 -2
  152. package/dist/react-context/provider/helpers/isSSREnabled.d.ts.map +0 -1
  153. package/dist/react-context/provider/hooks/locales/useDetermineLocale.d.ts +0 -5
  154. package/dist/react-context/provider/hooks/locales/useDetermineLocale.d.ts.map +0 -1
  155. package/dist/react-context/provider/hooks/useEnableI18n.d.ts +0 -10
  156. package/dist/react-context/provider/hooks/useEnableI18n.d.ts.map +0 -1
  157. package/dist/react-context/provider/hooks/useRegionState.d.ts +0 -9
  158. package/dist/react-context/provider/hooks/useRegionState.d.ts.map +0 -1
  159. package/dist/react-context/types/config.d.ts +0 -67
  160. package/dist/react-context/types/config.d.ts.map +0 -1
  161. package/dist/react-context/ui/LocaleSelector.d.ts +0 -18
  162. package/dist/react-context/ui/LocaleSelector.d.ts.map +0 -1
  163. package/dist/react-context/ui/RegionSelector.d.ts +0 -38
  164. package/dist/react-context/ui/RegionSelector.d.ts.map +0 -1
  165. package/dist/react-context/utils/readAuthFromEnv.d.ts +0 -9
  166. package/dist/react-context/utils/readAuthFromEnv.d.ts.map +0 -1
  167. package/dist/shared/InternalLocaleSelector.d.ts +0 -26
  168. package/dist/shared/InternalLocaleSelector.d.ts.map +0 -1
  169. package/dist/shared/messages.d.ts +0 -11
  170. package/dist/shared/messages.d.ts.map +0 -1
@@ -0,0 +1,377 @@
1
+ import React$1, { ReactNode } from "react";
2
+ import { Branch, Currency, DateTime, Derive, 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";
3
+
4
+ //#region ../react-core/dist/types.d.ts
5
+ //#region ../format/dist/types-UnF22q9r.d.cts
6
+ //#region src/locales/customLocaleMapping.d.ts
7
+ type CustomMapping$1 = Record<string, string | Partial<LocaleProperties$1>>; //#endregion
8
+ //#region src/locales/getLocaleProperties.d.ts
9
+ type LocaleProperties$1 = {
10
+ code: string;
11
+ name: string;
12
+ nativeName: string;
13
+ languageCode: string;
14
+ languageName: string;
15
+ nativeLanguageName: string;
16
+ nameWithRegionCode: string;
17
+ nativeNameWithRegionCode: string;
18
+ regionCode: string;
19
+ regionName: string;
20
+ nativeRegionName: string;
21
+ scriptCode: string;
22
+ scriptName: string;
23
+ nativeScriptName: string;
24
+ maximizedCode: string;
25
+ maximizedName: string;
26
+ nativeMaximizedName: string;
27
+ minimizedCode: string;
28
+ minimizedName: string;
29
+ nativeMinimizedName: string;
30
+ emoji: string;
31
+ }; //#endregion
32
+ //#region src/locales/getRegionProperties.d.ts
33
+ //#endregion
34
+ //#region src/types-dir/jsx/variables.d.ts
35
+ type VariableType = 'v' | 'n' | 'd' | 'c' | 'rt';
36
+ /**
37
+ * Variables are used to store the variable name and type.
38
+ */
39
+ type Variable = {
40
+ k: string;
41
+ i?: number;
42
+ v?: VariableType;
43
+ }; //#endregion
44
+ //#region src/types-dir/jsx/content.d.ts
45
+ /**
46
+ * Map of data-_gt properties to their corresponding React props
47
+ */
48
+ declare const HTML_CONTENT_PROPS: {
49
+ readonly pl: "placeholder";
50
+ readonly ti: "title";
51
+ readonly alt: "alt";
52
+ readonly arl: "aria-label";
53
+ readonly arb: "aria-labelledby";
54
+ readonly ard: "aria-describedby";
55
+ };
56
+ type HtmlContentPropKeysRecord = Partial<Record<keyof typeof HTML_CONTENT_PROPS, string>>;
57
+ /**
58
+ * GTProp is an internal property used to contain data for translating and rendering elements.
59
+ * note, transformations are only read on the server side if they are 'plural' or 'branch'
60
+ */
61
+ type GTProp = {
62
+ b?: Record<string, JsxChildren>;
63
+ t?: 'p' | 'b';
64
+ } & HtmlContentPropKeysRecord;
65
+ type JsxElement = {
66
+ t?: string;
67
+ i?: number;
68
+ d?: GTProp;
69
+ c?: JsxChildren;
70
+ };
71
+ type JsxChild = string | JsxElement | Variable;
72
+ /**
73
+ * The format of the string content
74
+ */
75
+ type StringFormat = 'ICU' | 'I18NEXT' | 'STRING';
76
+ /**
77
+ * The format of the content.
78
+ */
79
+ type DataFormat = 'JSX' | StringFormat;
80
+ /**
81
+ * String format content.
82
+ */
83
+ /**
84
+ * A content type representing JSX elements.
85
+ */
86
+ type JsxChildren = JsxChild | JsxChild[];
87
+ /**
88
+ * A content type representing ICU messages.
89
+ */
90
+ //#endregion
91
+ //#region ../core/dist/types-YrrGRHBP.d.cts
92
+ //#endregion
93
+ //#region src/types.d.ts
94
+ /**
95
+ * @deprecated Use {@link Content} instead.
96
+ */
97
+ //#endregion
98
+ //#region ../i18n/dist/options-D0Lnxv2X.d.cts
99
+ //#region src/translation-functions/types/options.d.ts
100
+ type BaseTranslationOptions = Record<string, unknown>;
101
+ type DictionaryTranslationOptions = BaseTranslationOptions;
102
+ /**
103
+ * Options for string resolution
104
+ * Used by the gt() function
105
+ */
106
+ type InlineTranslationOptions = BaseTranslationOptions & {
107
+ $context?: string;
108
+ $id?: string; /** The data format for the message (e.g., 'ICU', 'STRING'). Defaults to 'ICU'. */
109
+ $format?: StringFormat; /** The locale to use for formatting the message. */
110
+ $locale?: string;
111
+ /**
112
+ * @deprecated use {@link $locale} instead
113
+ */
114
+ $_locales?: string | string[];
115
+ $_hash?: string;
116
+ $maxChars?: number; /** @deprecated use {@link EncodedTranslationOptions} instead */
117
+ $_source?: string;
118
+ };
119
+ /**
120
+ * Options for string resolution
121
+ * Used by the m() function
122
+ */
123
+ /**
124
+ * Options for runtime translation
125
+ * Used by the tx() function
126
+ */
127
+ type RuntimeTranslationOptions = {
128
+ $locale?: string;
129
+ $format?: DataFormat;
130
+ } & Omit<InlineTranslationOptions, '$id' | '$format'>;
131
+ /**
132
+ * Options for JSX translation
133
+ * Used by the resolveJsxTranslation() function
134
+ */
135
+ //#endregion
136
+ //#region ../i18n/dist/functions-DI1QpQoC.d.cts
137
+ /**
138
+ * Synchronous resolution function type
139
+ * @param {string} message - The message to translate.
140
+ * @param {InlineTranslationOptions} options - The options for the translation.
141
+ * @returns {string} The translated message.
142
+ *
143
+ * @important This is base type for user API
144
+ *
145
+ * TODO: next major version, this should be <T extends string | null | undefined>(message: T, options?: InlineTranslationOptions) => T extends string ? string : T;
146
+ */
147
+ /**
148
+ * For dictionaries, we have Entry and MetaEntry
149
+ */
150
+ type Entry = string;
151
+ type MetaEntry = {
152
+ $context?: string;
153
+ $maxChars?: number;
154
+ $_hash?: string;
155
+ [key: string]: unknown;
156
+ };
157
+ type DictionaryEntry = Entry | [Entry] | [Entry, MetaEntry];
158
+ type Dictionary = {
159
+ [key: string]: Dictionary | DictionaryEntry;
160
+ } | (Dictionary | DictionaryEntry)[];
161
+ /**
162
+ * Translated content types
163
+ * TODO: move these types to JsxElement etc from generaltranslation/types
164
+ * remember to omit the t property (tag name) from the translated element
165
+ */
166
+ type TranslatedElement = {
167
+ i?: number;
168
+ d?: GTProp;
169
+ c?: TranslatedChildren;
170
+ };
171
+ type TranslatedChild = TranslatedElement | string | Variable;
172
+ type TranslatedChildren = TranslatedChild | TranslatedChild[];
173
+ type Translations = {
174
+ [hash: string]: TranslatedChildren | null;
175
+ };
176
+ /**
177
+ * @deprecated use {@link Dictionary}
178
+ */
179
+ type CustomLoader = (locale: string) => Promise<unknown>;
180
+ type RenderMethod = 'skeleton' | 'replace' | 'default';
181
+ //#endregion
182
+ //#region src/provider/hooks/locales/types.d.ts
183
+ type UseDetermineLocaleParams = {
184
+ defaultLocale: string;
185
+ locales: string[];
186
+ enableI18n: boolean;
187
+ locale?: string;
188
+ localeCookieName?: string;
189
+ ssr?: boolean;
190
+ customMapping?: CustomMapping$1;
191
+ reloadOnLocaleUpdate?: boolean;
192
+ };
193
+ type UseDetermineLocaleReturn = [string, (locale: string) => void]; //#endregion
194
+ //#region src/provider/hooks/types.d.ts
195
+ //#endregion
196
+ //#region src/types-dir/config.d.ts
197
+ type GTConfig = {
198
+ projectId?: string;
199
+ devApiKey?: string;
200
+ locales?: string[];
201
+ defaultLocale?: string;
202
+ dictionary?: string;
203
+ runtimeUrl?: string | null;
204
+ cacheUrl?: string | null;
205
+ renderSettings?: {
206
+ method: RenderMethod;
207
+ timeout?: number;
208
+ };
209
+ _versionId?: string;
210
+ ssr?: boolean;
211
+ localeCookieName?: string;
212
+ customMapping?: CustomMapping$1;
213
+ modelProvider?: string;
214
+ enableI18n?: boolean;
215
+ };
216
+ //#endregion
217
+ //#region ../format/dist/types-UnF22q9r.d.cts
218
+ //#region src/locales/customLocaleMapping.d.ts
219
+ type CustomMapping = Record<string, string | Partial<LocaleProperties>>; //#endregion
220
+ //#region src/locales/getLocaleProperties.d.ts
221
+ type LocaleProperties = {
222
+ code: string;
223
+ name: string;
224
+ nativeName: string;
225
+ languageCode: string;
226
+ languageName: string;
227
+ nativeLanguageName: string;
228
+ nameWithRegionCode: string;
229
+ nativeNameWithRegionCode: string;
230
+ regionCode: string;
231
+ regionName: string;
232
+ nativeRegionName: string;
233
+ scriptCode: string;
234
+ scriptName: string;
235
+ nativeScriptName: string;
236
+ maximizedCode: string;
237
+ maximizedName: string;
238
+ nativeMaximizedName: string;
239
+ minimizedCode: string;
240
+ minimizedName: string;
241
+ nativeMinimizedName: string;
242
+ emoji: string;
243
+ }; //#endregion
244
+ //#region src/locales/getRegionProperties.d.ts
245
+ //#endregion
246
+ //#region src/react-context/types/config.d.ts
247
+ type GTProviderProps = {
248
+ children?: React.ReactNode;
249
+ projectId?: string;
250
+ devApiKey?: string;
251
+ dictionary?: Dictionary;
252
+ locales?: string[];
253
+ defaultLocale?: string;
254
+ locale?: string;
255
+ region?: string;
256
+ cacheUrl?: string | null;
257
+ runtimeUrl?: string | null;
258
+ renderSettings?: {
259
+ method: RenderMethod;
260
+ timeout?: number;
261
+ };
262
+ _versionId?: string;
263
+ ssr?: boolean;
264
+ localeCookieName?: string;
265
+ translations?: Translations | null;
266
+ loadDictionary?: CustomLoader;
267
+ loadTranslations?: CustomLoader;
268
+ config?: GTConfig;
269
+ fallback?: React.ReactNode;
270
+ customMapping?: CustomMapping;
271
+ modelProvider?: string;
272
+ enableI18n?: boolean;
273
+ enableI18nLoaded?: boolean;
274
+ /**
275
+ * @internal - internal use only
276
+ * TODO: this should have a separate export for internal use
277
+ */
278
+ useDetermineLocale?: (params: UseDetermineLocaleParams) => UseDetermineLocaleReturn;
279
+ reloadOnLocaleUpdate?: boolean;
280
+ [key: string]: unknown;
281
+ };
282
+ //#endregion
283
+ //#region src/react-context/provider/GTProvider.d.ts
284
+ /**
285
+ * Provides General Translation context to its children, which can then access `useGT`, `useLocale`, and `useDefaultLocale`.
286
+ *
287
+ * @param {React.ReactNode} children - The children components that will use the translation context.
288
+ * @param {string} [projectId] - The project ID required for General Translation cloud services.
289
+ * @param {Dictionary} [dictionary=defaultDictionary] - The translation dictionary for the project.
290
+ * @param {string[]} [locales] - The list of approved locales for the project.
291
+ * @param {string} [defaultLocale=libraryDefaultLocale] - The default locale to use if no other locale is found.
292
+ * @param {string} [locale] - The current locale, if already set.
293
+ * @param {string} [cacheUrl='https://cdn.gtx.dev'] - The URL of the cache service for fetching translations.
294
+ * @param {string} [runtimeUrl='https://runtime.gtx.dev'] - The URL of the runtime service for fetching translations.
295
+ * @param {RenderSettings} [renderSettings=defaultRenderSettings] - The settings for rendering translations.
296
+ * @param {string} [_versionId] - The version ID for fetching translations.
297
+ * @param {string} [devApiKey] - The API key for development environments.
298
+ * @param {object} [metadata] - Additional metadata to pass to the context.
299
+ * @param {boolean} [ssr=isSSREnabled()] - Whether to enable server-side rendering.
300
+ * @param {string} [localeCookieName=defaultLocaleCookieName] - The name of the cookie to store the locale.
301
+ * @param {boolean} [enableI18n=true] - Whether to enable i18n.
302
+ * @param {boolean|undefined} [enableI18nLoaded=undefined] - Flag to indicate if the enableI18n flag is finished loading asynchronously. Undefined means flag is loaded synchronously.
303
+ * @param {Translations | null} [translations=null] - The translations to use for the context.
304
+ * @param {React.ReactNode} [fallback = undefined] - Custom fallback to display while loading
305
+ *
306
+ * @returns {JSX.Element} The provider component for General Translation context.
307
+ */
308
+ declare function GTProvider(props: GTProviderProps): React$1.JSX.Element;
309
+ //#endregion
310
+ //#region src/react-context/ui/LocaleSelector.d.ts
311
+ /**
312
+ * A dropdown component that allows users to select a locale.
313
+ * @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.
314
+ * @param {object} [customNames] - (deprecated) An optional object to map locales to custom names. Use `customMapping` instead.
315
+ * @param {CustomMapping} [customMapping] - An optional object to map locales to custom display names, emojis, or other properties.
316
+ * @returns {React.ReactElement | null} The rendered locale dropdown component or null to prevent rendering.
317
+ */
318
+ declare function LocaleSelector({
319
+ locales: _locales,
320
+ ...props
321
+ }: {
322
+ locales?: string[];
323
+ customNames?: {
324
+ [key: string]: string;
325
+ };
326
+ customMapping?: CustomMapping;
327
+ [key: string]: unknown;
328
+ }): React$1.JSX.Element | null;
329
+ //#endregion
330
+ //#region src/react-context/ui/RegionSelector.d.ts
331
+ /**
332
+ * A dropdown component that allows users to select a region.
333
+ *
334
+ * @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.
335
+ * @param {React.ReactNode} [placeholder] - Optional placeholder node to display as the first option when no region is selected.
336
+ * @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.
337
+ * @param {boolean} [prioritizeCurrentLocaleRegion] - If true, the region corresponding to the current locale is prioritized in the list.
338
+ * @param {boolean} [sortRegionsAlphabetically] - If true, regions are sorted alphabetically by display name.
339
+ * @param {boolean} [asLocaleSelector=false] - If true, selecting a region will also update the locale to the region's associated locale.
340
+ * @param {object} [props] - Additional props to pass to the underlying `<select>` element.
341
+ * @returns {React.JSX.Element | null} The rendered region dropdown component or null if no regions are available.
342
+ *
343
+ * @example
344
+ * ```tsx
345
+ * <RegionSelector
346
+ * regions={['US', 'CA']}
347
+ * customMapping={{ US: { name: "United States", emoji: "πŸ‡ΊπŸ‡Έ" } }}
348
+ * placeholder="Select a region"
349
+ * />
350
+ * ```
351
+ */
352
+ declare function RegionSelector<Regions extends string[]>({
353
+ regions: _regions,
354
+ placeholder,
355
+ customMapping,
356
+ prioritizeCurrentLocaleRegion,
357
+ sortRegionsAlphabetically,
358
+ asLocaleSelector,
359
+ ...props
360
+ }: {
361
+ regions?: Regions;
362
+ placeholder?: ReactNode;
363
+ customMapping?: {
364
+ [region: string]: string | {
365
+ name?: string;
366
+ locale?: string;
367
+ emoji?: string;
368
+ };
369
+ };
370
+ prioritizeCurrentLocaleRegion?: boolean;
371
+ sortRegionsAlphabetically?: boolean;
372
+ asLocaleSelector?: boolean;
373
+ [key: string]: unknown;
374
+ }): React$1.JSX.Element | null;
375
+ //#endregion
376
+ export { Branch, Currency, DateTime, Derive, type DictionaryTranslationOptions, GTProvider, type InlineTranslationOptions, LocaleSelector, Num, Plural, RegionSelector, RelativeTime, type RuntimeTranslationOptions, 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 };
377
+ //# sourceMappingURL=index.d.cts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.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","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","_","a","f","g","h","l","m","n","o","p","r","s","u","x","y"],"sources":["../../react-core/dist/types.d.ts","../../format/dist/types-UnF22q9r.d.cts","../src/react-context/types/config.ts","../src/react-context/provider/GTProvider.tsx","../src/react-context/ui/LocaleSelector.tsx","../src/react-context/ui/RegionSelector.tsx"],"mappings":"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"}