gt-react 9.2.23 → 9.2.25-alpha.0

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 (85) hide show
  1. package/CHANGELOG.md +10 -0
  2. package/dist/client.cjs.min.cjs +3 -3
  3. package/dist/client.d.ts +84 -67
  4. package/dist/client.d.ts.map +1 -1
  5. package/dist/client.esm.min.mjs +3 -3
  6. package/dist/dictionaries/getDictionaryEntry.d.ts +4 -0
  7. package/dist/dictionaries/getDictionaryEntry.d.ts.map +1 -0
  8. package/dist/{provider/helpers → dictionaries}/getEntryAndMetadata.d.ts +1 -1
  9. package/dist/dictionaries/getEntryAndMetadata.d.ts.map +1 -0
  10. package/dist/{provider/helpers → dictionaries}/loadDictionaryHelper.d.ts +1 -1
  11. package/dist/dictionaries/loadDictionaryHelper.d.ts.map +1 -0
  12. package/dist/{provider/helpers → dictionaries}/mergeDictionaries.d.ts +1 -1
  13. package/dist/dictionaries/mergeDictionaries.d.ts.map +1 -0
  14. package/dist/hooks/useGTClass.d.ts +3 -0
  15. package/dist/hooks/useGTClass.d.ts.map +1 -0
  16. package/dist/hooks/useLocaleSelector.d.ts.map +1 -1
  17. package/dist/index.cjs.min.cjs +3 -3
  18. package/dist/index.d.ts +2 -1
  19. package/dist/index.d.ts.map +1 -1
  20. package/dist/index.esm.min.mjs +3 -3
  21. package/dist/internal.d.ts +10 -9
  22. package/dist/internal.d.ts.map +1 -1
  23. package/dist/provider/ClientProvider.d.ts +2 -2
  24. package/dist/provider/ClientProvider.d.ts.map +1 -1
  25. package/dist/provider/GTContext.d.ts +1 -1
  26. package/dist/provider/GTContext.d.ts.map +1 -1
  27. package/dist/provider/GTProvider.d.ts +2 -27
  28. package/dist/provider/GTProvider.d.ts.map +1 -1
  29. package/dist/provider/hooks/useCreateInternalUseDictFunction.d.ts.map +1 -0
  30. package/dist/{hooks/internal → provider/hooks}/useCreateInternalUseGTFunction.d.ts.map +1 -1
  31. package/dist/{hooks/internal → provider/hooks}/useDetermineLocale.d.ts.map +1 -1
  32. package/dist/provider/hooks/useErrorChecks.d.ts +9 -0
  33. package/dist/provider/hooks/useErrorChecks.d.ts.map +1 -0
  34. package/dist/provider/hooks/useLoadDictionary.d.ts +9 -0
  35. package/dist/provider/hooks/useLoadDictionary.d.ts.map +1 -0
  36. package/dist/provider/hooks/useLoadTranslations.d.ts +15 -0
  37. package/dist/provider/hooks/useLoadTranslations.d.ts.map +1 -0
  38. package/dist/provider/hooks/useLocaleData.d.ts +14 -0
  39. package/dist/provider/hooks/useLocaleData.d.ts.map +1 -0
  40. package/dist/{hooks/internal → provider/hooks}/useRuntimeTranslation.d.ts +2 -2
  41. package/dist/provider/hooks/useRuntimeTranslation.d.ts.map +1 -0
  42. package/dist/rendering/defaultRenderSettings.d.ts +6 -0
  43. package/dist/rendering/defaultRenderSettings.d.ts.map +1 -0
  44. package/dist/{provider/helpers → rendering}/getGTProp.d.ts +1 -1
  45. package/dist/rendering/getGTProp.d.ts.map +1 -0
  46. package/dist/rendering/isVariableObject.d.ts +3 -0
  47. package/dist/rendering/isVariableObject.d.ts.map +1 -0
  48. package/dist/{provider/rendering → rendering}/renderDefaultChildren.d.ts +1 -1
  49. package/dist/rendering/renderDefaultChildren.d.ts.map +1 -0
  50. package/dist/rendering/renderSkeleton.d.ts.map +1 -0
  51. package/dist/{provider/rendering → rendering}/renderTranslatedChildren.d.ts +1 -1
  52. package/dist/rendering/renderTranslatedChildren.d.ts.map +1 -0
  53. package/dist/rendering/renderVariable.d.ts +4 -0
  54. package/dist/rendering/renderVariable.d.ts.map +1 -0
  55. package/dist/types/config.d.ts +52 -0
  56. package/dist/types/config.d.ts.map +1 -1
  57. package/dist/types/{providers.d.ts → context.d.ts} +4 -25
  58. package/dist/types/context.d.ts.map +1 -0
  59. package/dist/ui/LocaleSelector.d.ts +5 -1
  60. package/dist/ui/LocaleSelector.d.ts.map +1 -1
  61. package/package.json +3 -3
  62. package/dist/hooks/internal/useCreateInternalUseDictFunction.d.ts.map +0 -1
  63. package/dist/hooks/internal/useRuntimeTranslation.d.ts.map +0 -1
  64. package/dist/provider/helpers/getDictionaryEntry.d.ts +0 -4
  65. package/dist/provider/helpers/getDictionaryEntry.d.ts.map +0 -1
  66. package/dist/provider/helpers/getEntryAndMetadata.d.ts.map +0 -1
  67. package/dist/provider/helpers/getGTProp.d.ts.map +0 -1
  68. package/dist/provider/helpers/isValidDictionaryEntry.d.ts +0 -11
  69. package/dist/provider/helpers/isValidDictionaryEntry.d.ts.map +0 -1
  70. package/dist/provider/helpers/isVariableObject.d.ts +0 -3
  71. package/dist/provider/helpers/isVariableObject.d.ts.map +0 -1
  72. package/dist/provider/helpers/loadDictionaryHelper.d.ts.map +0 -1
  73. package/dist/provider/helpers/mergeDictionaries.d.ts.map +0 -1
  74. package/dist/provider/rendering/defaultRenderSettings.d.ts +0 -6
  75. package/dist/provider/rendering/defaultRenderSettings.d.ts.map +0 -1
  76. package/dist/provider/rendering/renderDefaultChildren.d.ts.map +0 -1
  77. package/dist/provider/rendering/renderSkeleton.d.ts.map +0 -1
  78. package/dist/provider/rendering/renderTranslatedChildren.d.ts.map +0 -1
  79. package/dist/provider/rendering/renderVariable.d.ts +0 -4
  80. package/dist/provider/rendering/renderVariable.d.ts.map +0 -1
  81. package/dist/types/providers.d.ts.map +0 -1
  82. /package/dist/{hooks/internal → provider/hooks}/useCreateInternalUseDictFunction.d.ts +0 -0
  83. /package/dist/{hooks/internal → provider/hooks}/useCreateInternalUseGTFunction.d.ts +0 -0
  84. /package/dist/{hooks/internal → provider/hooks}/useDetermineLocale.d.ts +0 -0
  85. /package/dist/{provider/rendering → rendering}/renderSkeleton.d.ts +0 -0
package/dist/client.d.ts CHANGED
@@ -1,5 +1,10 @@
1
1
  import * as React$1 from 'react';
2
2
  import React__default from 'react';
3
+ import * as generaltranslation from 'generaltranslation';
4
+ import { GT } from 'generaltranslation';
5
+ import * as generaltranslation_types from 'generaltranslation/types';
6
+ import { CustomMapping } from 'generaltranslation/types';
7
+ import * as react_jsx_runtime from 'react/jsx-runtime';
3
8
 
4
9
  type Entry = string;
5
10
  type Metadata = {
@@ -82,6 +87,7 @@ type TranslateChildrenCallback = (params: {
82
87
  }) => Promise<TranslationSuccess | TranslationLoading | TranslationError>;
83
88
 
84
89
  type GTContextType = {
90
+ gt: GT;
85
91
  registerContentForTranslation: TranslateContentCallback;
86
92
  registerJsxForTranslation: TranslateChildrenCallback;
87
93
  _internalUseGTFunction: (string: string, options?: InlineTranslationOptions) => string;
@@ -100,6 +106,72 @@ type GTContextType = {
100
106
  };
101
107
  projectId?: string;
102
108
  };
109
+
110
+ declare const GTContext: React$1.Context<GTContextType | undefined>;
111
+
112
+ declare function useRuntimeTranslation({ projectId, devApiKey, locale, versionId, defaultLocale, runtimeUrl, renderSettings, setTranslations, ...globalMetadata }: {
113
+ projectId?: string;
114
+ devApiKey?: string;
115
+ locale: string;
116
+ versionId?: string;
117
+ defaultLocale?: string;
118
+ runtimeUrl?: string | null;
119
+ renderSettings: {
120
+ method: RenderMethod;
121
+ timeout?: number;
122
+ };
123
+ setTranslations: React$1.Dispatch<React$1.SetStateAction<any>>;
124
+ [key: string]: any;
125
+ }): {
126
+ registerContentForTranslation: TranslateContentCallback;
127
+ registerJsxForTranslation: TranslateChildrenCallback;
128
+ runtimeTranslationEnabled: boolean;
129
+ };
130
+
131
+ declare const renderVariable: RenderVariable;
132
+
133
+ type GTConfig = {
134
+ projectId?: string;
135
+ devApiKey?: string;
136
+ locales?: string[];
137
+ defaultLocale?: string;
138
+ dictionary?: string;
139
+ runtimeUrl?: string;
140
+ cacheUrl?: string;
141
+ renderSettings?: {
142
+ method: RenderMethod;
143
+ timeout?: number;
144
+ };
145
+ _versionId?: string;
146
+ ssr?: boolean;
147
+ localeCookieName?: string;
148
+ customMapping?: CustomMapping;
149
+ };
150
+ type GTProviderProps = {
151
+ children?: React.ReactNode;
152
+ projectId?: string;
153
+ devApiKey?: string;
154
+ dictionary?: any;
155
+ locales?: string[];
156
+ defaultLocale?: string;
157
+ locale?: string;
158
+ cacheUrl?: string;
159
+ runtimeUrl?: string;
160
+ renderSettings?: {
161
+ method: RenderMethod;
162
+ timeout?: number;
163
+ };
164
+ _versionId?: string;
165
+ ssr?: boolean;
166
+ localeCookieName?: string;
167
+ translations?: TranslationsObject | null;
168
+ loadDictionary?: CustomLoader;
169
+ loadTranslations?: CustomLoader;
170
+ config?: GTConfig;
171
+ fallback?: React.ReactNode;
172
+ customMapping?: CustomMapping;
173
+ [key: string]: any;
174
+ };
103
175
  type ClientProviderProps = {
104
176
  children: any;
105
177
  dictionary: Dictionary;
@@ -122,32 +194,10 @@ type ClientProviderProps = {
122
194
  gtServicesEnabled?: boolean;
123
195
  localeCookieName?: string;
124
196
  resetLocaleCookieName: string;
197
+ customMapping?: CustomMapping;
125
198
  };
126
199
 
127
- declare const GTContext: React$1.Context<GTContextType | undefined>;
128
-
129
- declare function useRuntimeTranslation({ projectId, devApiKey, locale, versionId, defaultLocale, runtimeUrl, renderSettings, setTranslations, runtimeTranslationEnabled, ...globalMetadata }: {
130
- projectId?: string;
131
- devApiKey?: string;
132
- locale: string;
133
- versionId?: string;
134
- defaultLocale?: string;
135
- runtimeUrl?: string | null;
136
- runtimeTranslationEnabled: boolean;
137
- renderSettings: {
138
- method: RenderMethod;
139
- timeout?: number;
140
- };
141
- setTranslations: React$1.Dispatch<React$1.SetStateAction<any>>;
142
- [key: string]: any;
143
- }): {
144
- registerContentForTranslation: TranslateContentCallback;
145
- registerJsxForTranslation: TranslateChildrenCallback;
146
- };
147
-
148
- declare const renderVariable: RenderVariable;
149
-
150
- declare function ClientProvider({ children, dictionary, initialTranslations, locale: _locale, _versionId, defaultLocale, translationRequired, dialectTranslationRequired, locales, renderSettings, projectId, devApiKey, runtimeUrl, runtimeTranslationEnabled, resetLocaleCookieName, localeCookieName, }: ClientProviderProps): React$1.JSX.Element;
200
+ declare function ClientProvider({ children, dictionary, initialTranslations, locale: _locale, _versionId, defaultLocale, translationRequired, dialectTranslationRequired, locales, renderSettings, projectId, devApiKey, runtimeUrl, runtimeTranslationEnabled, resetLocaleCookieName, localeCookieName, customMapping, }: ClientProviderProps): React$1.JSX.Element;
151
201
 
152
202
  /**
153
203
  * The `<Branch>` component dynamically renders a specified branch of content or a fallback child component.
@@ -433,30 +483,17 @@ declare namespace Var {
433
483
  /**
434
484
  * A dropdown component that allows users to select a locale.
435
485
  * @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.
486
+ * @param {object} customNames - An optional object to map locales to custom names.
436
487
  * @returns {React.ReactElement | null} The rendered locale dropdown component or null to prevent rendering.
437
488
  */
438
- declare function LocaleSelector({ locales: _locales, ...props }: {
489
+ declare function LocaleSelector({ locales: _locales, customNames, ...props }: {
439
490
  locales?: string[];
491
+ customNames?: {
492
+ [key: string]: string;
493
+ };
440
494
  [key: string]: any;
441
495
  }): React__default.JSX.Element | null;
442
496
 
443
- type GTConfig = {
444
- projectId?: string;
445
- devApiKey?: string;
446
- locales?: string[];
447
- defaultLocale?: string;
448
- dictionary?: string;
449
- runtimeUrl?: string;
450
- cacheUrl?: string;
451
- renderSettings?: {
452
- method: RenderMethod;
453
- timeout?: number;
454
- };
455
- _versionId?: string;
456
- ssr?: boolean;
457
- localeCookieName?: string;
458
- };
459
-
460
497
  /**
461
498
  * Provides General Translation context to its children, which can then access `useGT`, `useLocale`, and `useDefaultLocale`.
462
499
  *
@@ -479,30 +516,7 @@ type GTConfig = {
479
516
  *
480
517
  * @returns {JSX.Element} The provider component for General Translation context.
481
518
  */
482
- declare function GTProvider({ children, config, projectId: _projectId, devApiKey: _devApiKey, dictionary: _dictionary, locales, defaultLocale, cacheUrl, runtimeUrl, renderSettings, ssr, localeCookieName, locale: _locale, loadDictionary, loadTranslations, fallback, translations: _translations, _versionId, ...metadata }: {
483
- children?: React__default.ReactNode;
484
- projectId?: string;
485
- devApiKey?: string;
486
- dictionary?: any;
487
- locales?: string[];
488
- defaultLocale?: string;
489
- locale?: string;
490
- cacheUrl?: string;
491
- runtimeUrl?: string;
492
- renderSettings?: {
493
- method: RenderMethod;
494
- timeout?: number;
495
- };
496
- _versionId?: string;
497
- ssr?: boolean;
498
- localeCookieName?: string;
499
- translations?: TranslationsObject | null;
500
- loadDictionary?: CustomLoader;
501
- loadTranslations?: CustomLoader;
502
- config?: GTConfig;
503
- fallback?: React__default.ReactNode;
504
- [key: string]: any;
505
- }): React__default.JSX.Element;
519
+ declare function GTProvider({ children, config, projectId: _projectId, devApiKey: _devApiKey, dictionary: _dictionary, locales, defaultLocale, cacheUrl, runtimeUrl, renderSettings, ssr, localeCookieName, locale: _locale, loadDictionary, loadTranslations, fallback, translations: _translations, _versionId, customMapping, ...metadata }: GTProviderProps): react_jsx_runtime.JSX.Element;
506
520
 
507
521
  /**
508
522
  * Sets the user's locale in the `<GTProvider>` context.
@@ -538,4 +552,7 @@ declare function useLocaleSelector(locales?: string[]): {
538
552
  setLocale: (locale: string) => void;
539
553
  };
540
554
 
541
- export { Branch, ClientProvider, Currency, DateTime, GTContext, GTProvider, LocaleSelector, Num, Plural, T, Var, renderVariable, useDefaultLocale, useDict, useGT, useLocale, useLocaleSelector, useLocales, useRuntimeTranslation, useSetLocale };
555
+ declare function useGTClass(): generaltranslation.GT;
556
+ declare function useLocaleProperties(locale: string): generaltranslation_types.LocaleProperties;
557
+
558
+ export { Branch, ClientProvider, Currency, DateTime, GTContext, GTProvider, LocaleSelector, Num, Plural, T, Var, renderVariable, useDefaultLocale, useDict, useGT, useGTClass, useLocale, useLocaleProperties, useLocaleSelector, useLocales, useRuntimeTranslation, useSetLocale };
@@ -1 +1 @@
1
- {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,qBAAqB,MAAM,wCAAwC,CAAC;AAC3E,OAAO,cAAc,MAAM,qCAAqC,CAAC;AACjE,OAAO,cAAc,MAAM,2BAA2B,CAAC;AACvD,OAAO,MAAM,MAAM,mBAAmB,CAAC;AACvC,OAAO,MAAM,MAAM,2BAA2B,CAAC;AAC/C,OAAO,KAAK,MAAM,2BAA2B,CAAC;AAC9C,OAAO,gBAAgB,MAAM,0BAA0B,CAAC;AACxD,OAAO,OAAO,MAAM,6BAA6B,CAAC;AAClD,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,CAAC,MAAM,wBAAwB,CAAC;AACvC,OAAO,QAAQ,MAAM,sBAAsB,CAAC;AAC5C,OAAO,QAAQ,MAAM,sBAAsB,CAAC;AAC5C,OAAO,GAAG,MAAM,iBAAiB,CAAC;AAClC,OAAO,GAAG,MAAM,iBAAiB,CAAC;AAClC,OAAO,cAAc,MAAM,qBAAqB,CAAC;AACjD,OAAO,UAAU,MAAM,uBAAuB,CAAC;AAC/C,OAAO,YAAY,MAAM,sBAAsB,CAAC;AAChD,OAAO,UAAU,MAAM,oBAAoB,CAAC;AAC5C,OAAO,iBAAiB,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EACL,SAAS,EACT,UAAU,EACV,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,KAAK,EACL,OAAO,EACP,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,CAAC,EACD,GAAG,EACH,GAAG,EACH,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,MAAM,EACN,cAAc,GACf,CAAC"}
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,qBAAqB,MAAM,wCAAwC,CAAC;AAC3E,OAAO,cAAc,MAAM,4BAA4B,CAAC;AACxD,OAAO,cAAc,MAAM,2BAA2B,CAAC;AACvD,OAAO,MAAM,MAAM,mBAAmB,CAAC;AACvC,OAAO,MAAM,MAAM,2BAA2B,CAAC;AAC/C,OAAO,KAAK,MAAM,2BAA2B,CAAC;AAC9C,OAAO,gBAAgB,MAAM,0BAA0B,CAAC;AACxD,OAAO,OAAO,MAAM,6BAA6B,CAAC;AAClD,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,CAAC,MAAM,wBAAwB,CAAC;AACvC,OAAO,QAAQ,MAAM,sBAAsB,CAAC;AAC5C,OAAO,QAAQ,MAAM,sBAAsB,CAAC;AAC5C,OAAO,GAAG,MAAM,iBAAiB,CAAC;AAClC,OAAO,GAAG,MAAM,iBAAiB,CAAC;AAClC,OAAO,cAAc,MAAM,qBAAqB,CAAC;AACjD,OAAO,UAAU,MAAM,uBAAuB,CAAC;AAC/C,OAAO,YAAY,MAAM,sBAAsB,CAAC;AAChD,OAAO,UAAU,MAAM,oBAAoB,CAAC;AAC5C,OAAO,iBAAiB,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAErE,OAAO,EACL,SAAS,EACT,UAAU,EACV,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,KAAK,EACL,OAAO,EACP,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,UAAU,EACV,mBAAmB,EACnB,CAAC,EACD,GAAG,EACH,GAAG,EACH,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,MAAM,EACN,cAAc,GACf,CAAC"}