gt-react 10.2.0 → 10.2.2-alpha.0

package/dist/client.d.ts

@@ -29,19 +29,7 @@ type TranslatedElement = {
 type TranslatedChild = TranslatedElement | string | Variable;
 type TranslatedChildren = TranslatedChild | TranslatedChild[];
 type Translations = {
-    [hash: string]: TranslatedChildren;
-};
-/**
- * Mapping of hashes to translation result status.
- */
-type TranslationsStatus = {
-    [hash: string]: {
-        status: 'success' | 'loading';
-    } | {
-        status: 'error';
-        code?: number;
-        error?: string;
-    };
+    [hash: string]: TranslatedChildren | null;
 };
 type CustomLoader = (locale: string) => Promise<any>;
 type RenderMethod = 'skeleton' | 'replace' | 'default';
@@ -49,6 +37,7 @@ type DictionaryTranslationOptions = Record<string, any>;
 type InlineTranslationOptions = DictionaryTranslationOptions & {
     $context?: string;
     $id?: string;
+    $_hash?: string;
 };
 type VariableProps = {
     variableType: VariableType;
@@ -59,6 +48,13 @@ type VariableProps = {
 type RenderVariable = ({ variableType, variableValue, variableOptions, locales, }: Omit<VariableProps, 'variableName'> & {
     locales: string[];
 }) => React__default.JSX.Element;
+type _Message = {
+    message: string;
+    $id?: string;
+    $context?: string;
+    $_hash?: string;
+};
+type _Messages = _Message[];
 
 type TranslateIcuCallback = (params: {
     source: string;
@@ -68,7 +64,6 @@ type TranslateIcuCallback = (params: {
         context?: string;
     } & Record<string, any>;
 }) => Promise<TranslatedChildren>;
-type TranslateI18nextCallback = TranslateIcuCallback;
 type TranslateChildrenCallback = (params: {
     source: JsxChildren | undefined;
     targetLocale: string;
@@ -80,12 +75,13 @@ type TranslateChildrenCallback = (params: {
 
 type GTContextType = {
     gt: GT;
-    registerI18nextForTranslation: TranslateI18nextCallback;
     registerIcuForTranslation: TranslateIcuCallback;
     registerJsxForTranslation: TranslateChildrenCallback;
-    _internalUseGTFunction: (string: string, options?: InlineTranslationOptions) => string;
-    _internalUseTranslationsFunction: (id: string, options?: DictionaryTranslationOptions) => string;
-    runtimeTranslationEnabled: boolean;
+    _tFunction: (message: string, options?: InlineTranslationOptions, preloadedTranslations?: Translations) => string;
+    _filterMessagesForPreload: (_messages: _Messages) => _Messages;
+    _preloadMessages: (_messages: _Messages) => Promise<Translations>;
+    _dictionaryFunction: (id: string, options?: DictionaryTranslationOptions) => string;
+    developmentApiEnabled: boolean;
     locale: string;
     locales: string[];
     setLocale: (locale: string) => void;
@@ -93,7 +89,6 @@ type GTContextType = {
     region: string | undefined;
     setRegion: (region: string | undefined) => void;
     translations: Translations | null;
-    translationsStatus: TranslationsStatus | null;
     translationRequired: boolean;
     dialectTranslationRequired: boolean;
     renderSettings: {
@@ -105,7 +100,8 @@ type GTContextType = {
 
 declare const GTContext: React$1.Context<GTContextType | undefined>;
 
-declare function useRuntimeTranslation({ gt, locale, versionId, defaultLocale, runtimeUrl, renderSettings, setTranslations, setTranslationsStatus, ...globalMetadata }: {
+declare function useRuntimeTranslation({ gt, locale, versionId, // kept for API compatibility (not used)
+defaultLocale, runtimeUrl, renderSettings, setTranslations, ...additionalMetadata }: {
     gt: GT;
     locale: string;
     versionId?: string;
@@ -116,13 +112,11 @@ declare function useRuntimeTranslation({ gt, locale, versionId, defaultLocale, r
         timeout?: number;
     };
     setTranslations: React$1.Dispatch<React$1.SetStateAction<Translations | null>>;
-    setTranslationsStatus: React$1.Dispatch<React$1.SetStateAction<TranslationsStatus | null>>;
     [key: string]: any;
 }): {
-    registerI18nextForTranslation: TranslateI18nextCallback;
     registerIcuForTranslation: TranslateIcuCallback;
     registerJsxForTranslation: TranslateChildrenCallback;
-    runtimeTranslationEnabled: boolean;
+    developmentApiEnabled: boolean;
 };
 
 declare const renderVariable: RenderVariable;
@@ -175,8 +169,7 @@ type GTProviderProps = {
 type ClientProviderProps = {
     children: any;
     dictionary: Dictionary;
-    initialTranslations: Translations;
-    initialTranslationsStatus: TranslationsStatus;
+    translations: Translations;
     locale: string;
     locales: string[];
     region?: string;
@@ -189,7 +182,7 @@ type ClientProviderProps = {
         method: RenderMethod;
         timeout?: number;
     };
-    runtimeTranslationEnabled: boolean;
+    developmentApiEnabled: boolean;
     projectId?: string;
     devApiKey?: string;
     runtimeUrl?: string | null;
@@ -200,7 +193,7 @@ type ClientProviderProps = {
     customMapping?: CustomMapping;
 };
 
-declare function ClientProvider({ children, dictionary, initialTranslations, initialTranslationsStatus, locale: _locale, region: _region, _versionId, defaultLocale, translationRequired, dialectTranslationRequired, locales, renderSettings, projectId, devApiKey, runtimeUrl, runtimeTranslationEnabled, resetLocaleCookieName, localeCookieName, regionCookieName, customMapping, }: ClientProviderProps): React$1.JSX.Element;
+declare function ClientProvider({ children, dictionary, translations: _translations, locale: _locale, region: _region, _versionId, defaultLocale, translationRequired, dialectTranslationRequired, locales, renderSettings, projectId, devApiKey, runtimeUrl, developmentApiEnabled, resetLocaleCookieName, localeCookieName, regionCookieName, customMapping, }: ClientProviderProps): React$1.JSX.Element;
 
 /**
  * The `<Branch>` component dynamically renders a specified branch of content or a fallback child component.
@@ -290,9 +283,10 @@ declare namespace Plural {
  * </>);
  *
  */
-declare function useGT(): (string: string, options?: Record<string, any> & {
+declare function useGT(_messages?: _Messages): (string: string, options?: Record<string, any> & {
     $id?: string;
     $context?: string;
+    $_hash?: string;
 }) => string;
 
 /**
@@ -363,12 +357,13 @@ declare function useLocale(): string;
  *
  * @throws {Error} If a plural translation is requested but the `n` option is not provided.
  */
-declare function T({ children, id, context, ...options }: {
+declare function T({ children, id, context, _hash, ...options }: {
     children: any;
     id?: string;
     context?: string;
+    _hash?: string;
     [key: string]: any;
-}): React__default.JSX.Element | null;
+}): React__default.JSX.Element | undefined;
 declare namespace T {
     var _gtt: string;
 }
@@ -730,4 +725,18 @@ declare function useRegionSelector({ regions: _regions, customMapping, prioritiz
     setLocale: (locale: string) => void;
 };
 
-export { Branch, ClientProvider, Currency, DateTime, GTContext, GTProvider, LocaleSelector, Num, Plural, RegionSelector, T, Var, renderVariable, useDefaultLocale, useGT, useGTClass, useLocale, useLocaleProperties, useLocaleSelector, useLocales, useRegion, useRegionSelector, useRuntimeTranslation, useSetLocale, useTranslations };
+/**
+ * Retrieves the text direction ('ltr' or 'rtl') for the current or specified locale from the `<GTProvider>` context.
+ *
+ * If no locale is provided, the direction for the current user's locale is returned.
+ *
+ * @param {string} [locale] - Optional locale code (e.g., 'ar', 'en-US'). If omitted, uses the current locale from context.
+ * @returns {'ltr' | 'rtl'} The text direction for the locale: 'rtl' for right-to-left languages, otherwise 'ltr'.
+ *
+ * @example
+ * const dir = useLocaleDirection(); // e.g., 'ltr'
+ * const arabicDir = useLocaleDirection('ar'); // 'rtl'
+ */
+declare function useLocaleDirection(locale?: string): 'ltr' | 'rtl';
+
+export { Branch, ClientProvider, Currency, DateTime, GTContext, GTProvider, LocaleSelector, Num, Plural, RegionSelector, T, Var, renderVariable, useDefaultLocale, useGT, useGTClass, useLocale, useLocaleDirection, useLocaleProperties, useLocaleSelector, useLocales, useRegion, useRegionSelector, useRuntimeTranslation, useSetLocale, useTranslations };

package/dist/client.d.ts.map

@@ -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,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,eAAe,MAAM,qCAAqC,CAAC;AAClE,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,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;AACrE,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,EACL,SAAS,EACT,UAAU,EACV,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,KAAK,EACL,eAAe,EACf,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,mBAAmB,EACnB,CAAC,EACD,GAAG,EACH,GAAG,EACH,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,MAAM,EACN,cAAc,EACd,cAAc,GACf,CAAC"}
+{"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,eAAe,MAAM,qCAAqC,CAAC;AAClE,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,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;AACrE,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,OAAO,EACL,SAAS,EACT,UAAU,EACV,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,KAAK,EACL,eAAe,EACf,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAClB,CAAC,EACD,GAAG,EACH,GAAG,EACH,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,MAAM,EACN,cAAc,EACd,cAAc,GACf,CAAC"}