@tolgee/react 5.33.2 → 5.33.3-prerelease.2efc0e6b.0

package/dist/tolgee-react.umd.min.js.map

@@ -1 +1 @@
-{"version":3,"file":"tolgee-react.umd.min.js","sources":["../src/useTolgeeSSR.ts","../src/TolgeeProvider.tsx","../src/GlobalContextPlugin.tsx","../src/useTolgeeContext.ts","../src/hooks.ts","../src/useTranslateInternal.ts","../src/tagsTools.tsx","../src/TBase.tsx","../src/T.tsx","../src/useTolgee.ts","../src/useTranslate.ts"],"sourcesContent":["import {\n  getTranslateProps,\n  TolgeeInstance,\n  TolgeeStaticData,\n} from '@tolgee/web';\nimport { useEffect, useMemo, useState } from 'react';\n\nfunction getTolgeeWithDeactivatedWrapper(\n  tolgee: TolgeeInstance\n): TolgeeInstance {\n  return {\n    ...tolgee,\n    t(...args) {\n      // @ts-ignore\n      const props = getTranslateProps(...args);\n      return tolgee.t({ ...props, noWrap: true });\n    },\n  };\n}\n\n/**\n * Updates tolgee static data and language, to be ready right away for the first render\n * and therefore compatible with SSR.\n *\n * It also ensures that the first render is done without wrapping and so it avoids\n * \"client different than server\" issues.\n * *\n * @param tolgeeInstance initialized Tolgee instance\n * @param language language that is obtained outside of Tolgee on the server and client\n * @param staticData static data for the language\n * @param enabled if set to false, no action is taken\n */\nexport function useTolgeeSSR(\n  tolgeeInstance: TolgeeInstance,\n  language?: string,\n  staticData?: TolgeeStaticData | undefined,\n  enabled = true\n) {\n  const [noWrappingTolgee] = useState(() =>\n    getTolgeeWithDeactivatedWrapper(tolgeeInstance)\n  );\n\n  const [initialRender, setInitialRender] = useState(enabled);\n\n  useEffect(() => {\n    setInitialRender(false);\n  }, []);\n\n  useMemo(() => {\n    if (enabled) {\n      // we have to prepare tolgee before rendering children\n      // so translations are available right away\n      // events emitting must be off, to not trigger re-render while rendering\n      tolgeeInstance.setEmitterActive(false);\n      tolgeeInstance.addStaticData(staticData);\n      tolgeeInstance.changeLanguage(language!);\n      tolgeeInstance.setEmitterActive(true);\n    }\n  }, [language, staticData, tolgeeInstance]);\n\n  useState(() => {\n    // running this function only on first render\n    if (!tolgeeInstance.isLoaded() && enabled) {\n      // warning user, that static data provided are not sufficient\n      // for proper SSR render\n      const missingRecords = tolgeeInstance\n        .getRequiredRecords(language)\n        .map(({ namespace, language }) =>\n          namespace ? `${namespace}:${language}` : language\n        )\n        .filter((key) => !staticData?.[key]);\n\n      // eslint-disable-next-line no-console\n      console.warn(\n        `Tolgee: Missing records in \"staticData\" for proper SSR functionality: ${missingRecords.map((key) => `\"${key}\"`).join(', ')}`\n      );\n    }\n  });\n\n  return initialRender ? noWrappingTolgee : tolgeeInstance;\n}\n","import React, { Suspense, useEffect, useState } from 'react';\nimport { TolgeeInstance, TolgeeStaticData } from '@tolgee/web';\nimport { ReactOptions, TolgeeReactContext } from './types';\nimport { useTolgeeSSR } from './useTolgeeSSR';\n\nexport const DEFAULT_REACT_OPTIONS: ReactOptions = {\n  useSuspense: true,\n};\n\nlet ProviderInstance: React.Context<TolgeeReactContext | undefined>;\n\nexport const getProviderInstance = () => {\n  if (!ProviderInstance) {\n    ProviderInstance = React.createContext<TolgeeReactContext | undefined>(\n      undefined\n    );\n  }\n\n  return ProviderInstance;\n};\n\nlet LAST_TOLGEE_INSTANCE: TolgeeInstance | undefined = undefined;\n\nexport type SSROptions = {\n  /**\n   * Hard set language to this value, use together with `staticData`\n   */\n  language?: string;\n  /**\n   * If provided, static data will be hard set to Tolgee cache for initial render\n   */\n  staticData?: TolgeeStaticData;\n};\n\nexport interface TolgeeProviderProps {\n  children?: React.ReactNode;\n  tolgee: TolgeeInstance;\n  options?: ReactOptions;\n  fallback?: React.ReactNode;\n  /**\n   * use this option if you use SSR\n   *\n   * You can pass staticData and language\n   * which will be set to tolgee instance for the initial render\n   *\n   * Don't switch between ssr and non-ssr dynamically\n   */\n  ssr?: SSROptions | boolean;\n}\n\nexport const TolgeeProvider: React.FC<TolgeeProviderProps> = ({\n  tolgee,\n  options,\n  children,\n  fallback,\n  ssr,\n}) => {\n  // prevent restarting tolgee unnecesarly\n  // however if the instance change on hot-reloading\n  // we want to restart\n  useEffect(() => {\n    if (LAST_TOLGEE_INSTANCE?.run !== tolgee.run) {\n      if (LAST_TOLGEE_INSTANCE) {\n        LAST_TOLGEE_INSTANCE.stop();\n      }\n      LAST_TOLGEE_INSTANCE = tolgee;\n      tolgee\n        .run()\n        .catch((e) => {\n          // eslint-disable-next-line no-console\n          console.error(e);\n        })\n        .finally(() => {\n          setLoading(false);\n        });\n    }\n  }, [tolgee]);\n\n  let tolgeeSSR = tolgee;\n\n  const { language, staticData } = (\n    typeof ssr !== 'object' ? {} : ssr\n  ) as SSROptions;\n  tolgeeSSR = useTolgeeSSR(tolgee, language, staticData, Boolean(ssr));\n\n  const [loading, setLoading] = useState(!tolgeeSSR.isLoaded());\n\n  const optionsWithDefault = { ...DEFAULT_REACT_OPTIONS, ...options };\n\n  const TolgeeProviderContext = getProviderInstance();\n\n  if (optionsWithDefault.useSuspense) {\n    return (\n      <TolgeeProviderContext.Provider\n        value={{ tolgee: tolgeeSSR, options: optionsWithDefault }}\n      >\n        {loading ? (\n          fallback\n        ) : (\n          <Suspense fallback={fallback || null}>{children}</Suspense>\n        )}\n      </TolgeeProviderContext.Provider>\n    );\n  }\n\n  return (\n    <TolgeeProviderContext.Provider\n      value={{ tolgee: tolgeeSSR, options: optionsWithDefault }}\n    >\n      {loading ? fallback : children}\n    </TolgeeProviderContext.Provider>\n  );\n};\n","import type { TolgeePlugin } from '@tolgee/web';\nimport { DEFAULT_REACT_OPTIONS } from './TolgeeProvider';\nimport type { ReactOptions, TolgeeReactContext } from './types';\n\nlet globalContext: TolgeeReactContext | undefined;\n\nexport const GlobalContextPlugin =\n  (options?: Partial<ReactOptions>): TolgeePlugin =>\n  (tolgee) => {\n    globalContext = {\n      tolgee,\n      options: { ...DEFAULT_REACT_OPTIONS, ...options },\n    };\n    return tolgee;\n  };\n\nexport function getGlobalContext() {\n  return globalContext;\n}\n","import { useContext } from 'react';\nimport { getGlobalContext } from './GlobalContextPlugin';\nimport { getProviderInstance } from './TolgeeProvider';\n\nexport const useTolgeeContext = () => {\n  const TolgeeProviderContext = getProviderInstance();\n  const context = useContext(TolgeeProviderContext) || getGlobalContext();\n  if (!context) {\n    throw new Error(\n      \"Couldn't find tolgee instance, did you forgot to use `TolgeeProvider`?\"\n    );\n  }\n  return context;\n};\n","import { useCallback, useState } from 'react';\n\nexport const useRerender = () => {\n  const [instance, setCounter] = useState(0);\n\n  const rerender = useCallback(() => {\n    setCounter((num) => num + 1);\n  }, [setCounter]);\n  return { instance, rerender };\n};\n","import { useCallback, useEffect, useRef } from 'react';\nimport {\n  SubscriptionSelective,\n  TranslateProps,\n  NsFallback,\n  getFallbackArray,\n  getFallback,\n} from '@tolgee/web';\n\nimport { useTolgeeContext } from './useTolgeeContext';\nimport { ReactOptions } from './types';\nimport { useRerender } from './hooks';\n\nexport const useTranslateInternal = (\n  ns?: NsFallback,\n  options?: ReactOptions\n) => {\n  const { tolgee, options: defaultOptions } = useTolgeeContext();\n  const namespaces = getFallback(ns);\n  const namespacesJoined = getFallbackArray(namespaces).join(':');\n\n  const currentOptions = {\n    ...defaultOptions,\n    ...options,\n  };\n\n  // dummy state to enable re-rendering\n  const { rerender, instance } = useRerender();\n\n  const subscriptionRef = useRef<SubscriptionSelective>();\n\n  const subscriptionQueue = useRef([] as NsFallback[]);\n  subscriptionQueue.current = [];\n\n  const subscribeToNs = (ns: NsFallback) => {\n    subscriptionQueue.current.push(ns);\n    subscriptionRef.current?.subscribeNs(ns);\n  };\n\n  const isLoaded = tolgee.isLoaded(namespaces);\n\n  useEffect(() => {\n    const subscription = tolgee.onNsUpdate(rerender);\n    subscriptionRef.current = subscription;\n    subscription.subscribeNs(namespaces);\n    subscriptionQueue.current.forEach((ns) => {\n      subscription!.subscribeNs(ns);\n    });\n\n    return () => {\n      subscription.unsubscribe();\n    };\n  }, [namespacesJoined, tolgee]);\n\n  useEffect(() => {\n    tolgee.addActiveNs(namespaces);\n    return () => tolgee.removeActiveNs(namespaces);\n  }, [namespacesJoined, tolgee]);\n\n  const t = useCallback(\n    (props: TranslateProps<any>) => {\n      const fallbackNs = props.ns ?? namespaces?.[0];\n      subscribeToNs(fallbackNs);\n      return tolgee.t({ ...props, ns: fallbackNs }) as any;\n    },\n    [tolgee, instance]\n  );\n\n  if (currentOptions.useSuspense && !isLoaded) {\n    throw tolgee.addActiveNs(namespaces, true);\n  }\n\n  return { t, isLoading: !isLoaded };\n};\n","import { TranslateParams } from '@tolgee/web';\nimport React from 'react';\n\nimport { ParamsTags } from './types';\n\nfunction unwrapSingleElementArray(value: any) {\n  if (Array.isArray(value) && value.length === 1) {\n    return value[0];\n  } else {\n    return value;\n  }\n}\n\nexport const wrapTagHandlers = (\n  params: TranslateParams<ParamsTags> | undefined\n) => {\n  if (!params) {\n    return undefined;\n  }\n\n  const result: any = {};\n\n  Object.entries(params || {}).forEach(([key, value]) => {\n    if (typeof value === 'function') {\n      result[key] = (chunk: any) => {\n        return value(addReactKeys(chunk));\n      };\n    } else if (React.isValidElement(value as any)) {\n      const el = value as React.ReactElement;\n      result[key] = (chunk: any) => {\n        return el.props.children === undefined && chunk?.length\n          ? React.cloneElement(el, {}, addReactKeys(chunk))\n          : React.cloneElement(el);\n      };\n    } else {\n      result[key] = value;\n    }\n  });\n\n  return result;\n};\n\nexport const addReactKeys = (\n  children: React.ReactNode | React.ReactNode[] | undefined\n) => {\n  const val = unwrapSingleElementArray(children);\n  if (Array.isArray(val)) {\n    return val.map((item, i) => (\n      <React.Fragment key={i}>{item}</React.Fragment>\n    ));\n  } else {\n    return val;\n  }\n};\n","import React from 'react';\nimport { addReactKeys, wrapTagHandlers } from './tagsTools';\nimport type { PropsWithKeyName, TBaseInterface } from './types';\n\nexport const TBase: TBaseInterface = (props) => {\n  const key = (props as PropsWithKeyName).keyName || props.children;\n  if (key === undefined) {\n    // eslint-disable-next-line no-console\n    console.error('T component: keyName not defined');\n  }\n  const defaultValue =\n    props.defaultValue ||\n    ((props as PropsWithKeyName).keyName ? props.children : undefined);\n\n  const translation = addReactKeys(\n    props.t({\n      key: key!,\n      params: wrapTagHandlers(props.params),\n      defaultValue,\n      noWrap: props.noWrap,\n      ns: props.ns,\n      language: props.language,\n    })\n  );\n\n  return <>{translation}</>;\n};\n","import React from 'react';\nimport { ParamsTags, TProps } from './types';\n\nimport { useTranslateInternal } from './useTranslateInternal';\nimport { TFnType } from '@tolgee/web';\nimport { TBase } from './TBase';\n\ninterface TInterface {\n  (props: TProps): JSX.Element;\n}\n\nexport const T: TInterface = (props) => {\n  const { t } = useTranslateInternal();\n\n  return <TBase t={t as TFnType<ParamsTags>} {...props} />;\n};\n","import { TolgeeEvent, TolgeeInstance } from '@tolgee/web';\nimport { useEffect } from 'react';\nimport { useRerender } from './hooks';\nimport { useTolgeeContext } from './useTolgeeContext';\n\nexport const useTolgee = (events?: TolgeeEvent[]): TolgeeInstance => {\n  const { tolgee } = useTolgeeContext();\n\n  const { rerender } = useRerender();\n\n  useEffect(() => {\n    const listeners = events?.map((e) => tolgee.on(e, rerender));\n    return () => {\n      listeners?.forEach((listener) => listener.unsubscribe());\n    };\n  }, [events?.join(':')]);\n\n  return tolgee;\n};\n","import { useCallback } from 'react';\nimport {\n  TFnType,\n  getTranslateProps,\n  DefaultParamType,\n  TranslationKey,\n} from '@tolgee/web';\n\nimport { useTranslateInternal } from './useTranslateInternal';\nimport { ReactOptions } from './types';\n\nexport interface UseTranslateResult {\n  t: TFnType<DefaultParamType, string, TranslationKey>;\n  isLoading: boolean;\n}\n\nexport const useTranslate = (\n  ns?: string[] | string,\n  options?: ReactOptions\n): UseTranslateResult => {\n  const { t: tInternal, isLoading } = useTranslateInternal(ns, options);\n\n  const t = useCallback(\n    (...params: any) => {\n      // @ts-ignore\n      const props = getTranslateProps(...params);\n      return tInternal(props);\n    },\n    [tInternal]\n  );\n\n  return { t, isLoading };\n};\n"],"names":["useTolgeeSSR","tolgeeInstance","language","staticData","enabled","noWrappingTolgee","useState","getTolgeeWithDeactivatedWrapper","tolgee","Object","assign","t","args","props","getTranslateProps","noWrap","initialRender","setInitialRender","useEffect","useMemo","setEmitterActive","addStaticData","changeLanguage","isLoaded","missingRecords","getRequiredRecords","map","namespace","filter","key","console","warn","join","DEFAULT_REACT_OPTIONS","useSuspense","ProviderInstance","getProviderInstance","React","createContext","undefined","LAST_TOLGEE_INSTANCE","globalContext","useTolgeeContext","TolgeeProviderContext","context","useContext","Error","useRerender","instance","setCounter","rerender","useCallback","num","useTranslateInternal","ns","options","defaultOptions","namespaces","getFallback","namespacesJoined","getFallbackArray","currentOptions","subscriptionRef","useRef","subscriptionQueue","current","subscription","onNsUpdate","subscribeNs","forEach","unsubscribe","addActiveNs","removeActiveNs","fallbackNs","_a","push","subscribeToNs","isLoading","wrapTagHandlers","params","result","entries","value","chunk","addReactKeys","isValidElement","el","children","length","cloneElement","val","Array","isArray","item","i","Fragment","TBase","keyName","error","defaultValue","translation","createElement","fallback","ssr","run","stop","catch","e","finally","setLoading","tolgeeSSR","Boolean","loading","optionsWithDefault","Provider","Suspense","events","listeners","on","listener","tInternal"],"mappings":"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"}
+{"version":3,"file":"tolgee-react.umd.min.js","sources":["../src/useTolgeeSSR.ts","../src/TolgeeProvider.tsx","../src/GlobalContextPlugin.tsx","../src/useTolgeeContext.ts","../src/hooks.ts","../src/useTranslateInternal.ts","../src/tagsTools.tsx","../src/TBase.tsx","../src/T.tsx","../src/useTolgee.ts","../src/useTranslate.ts"],"sourcesContent":["import {\n  CachePublicRecord,\n  getTranslateProps,\n  TolgeeInstance,\n  TolgeeStaticData,\n} from '@tolgee/web';\nimport { useEffect, useMemo, useState } from 'react';\n\nfunction getTolgeeWithDeactivatedWrapper(\n  tolgee: TolgeeInstance\n): TolgeeInstance {\n  return {\n    ...tolgee,\n    t(...args) {\n      // @ts-ignore\n      const props = getTranslateProps(...args);\n      return tolgee.t({ ...props, noWrap: true });\n    },\n  };\n}\n\n/**\n * Updates tolgee static data and language, to be ready right away for the first render\n * and therefore compatible with SSR.\n *\n * It also ensures that the first render is done without wrapping and so it avoids\n * \"client different than server\" issues.\n * *\n * @param tolgeeInstance initialized Tolgee instance\n * @param language language that is obtained outside of Tolgee on the server and client\n * @param staticData static data for the language\n * @param enabled if set to false, no action is taken\n */\nexport function useTolgeeSSR(\n  tolgeeInstance: TolgeeInstance,\n  language?: string,\n  data?: TolgeeStaticData | CachePublicRecord[] | undefined,\n  enabled = true\n) {\n  const [noWrappingTolgee] = useState(() =>\n    getTolgeeWithDeactivatedWrapper(tolgeeInstance)\n  );\n\n  const [initialRender, setInitialRender] = useState(enabled);\n\n  useEffect(() => {\n    setInitialRender(false);\n  }, []);\n\n  useMemo(() => {\n    if (enabled) {\n      // we have to prepare tolgee before rendering children\n      // so translations are available right away\n      // events emitting must be off, to not trigger re-render while rendering\n      tolgeeInstance.setEmitterActive(false);\n      tolgeeInstance.addStaticData(data);\n      tolgeeInstance.changeLanguage(language!);\n      tolgeeInstance.setEmitterActive(true);\n    }\n  }, [language, data, tolgeeInstance]);\n\n  useState(() => {\n    // running this function only on first render\n    if (!tolgeeInstance.isLoaded() && enabled) {\n      // warning user, that static data provided are not sufficient\n      // for proper SSR render\n      const requiredRecords = tolgeeInstance.getRequiredDescriptors(language);\n      const providedRecords = tolgeeInstance.getAllRecords();\n      const missingRecords = requiredRecords\n        .map(({ namespace, language }) =>\n          namespace ? `${namespace}:${language}` : language\n        )\n        .filter((key) => !providedRecords.find((r) => r?.cacheKey === key));\n\n      // eslint-disable-next-line no-console\n      console.warn(\n        `Tolgee: Missing records in \"staticData\" for proper SSR functionality: ${missingRecords.map((key) => `\"${key}\"`).join(', ')}`\n      );\n    }\n  });\n\n  return initialRender ? noWrappingTolgee : tolgeeInstance;\n}\n","import React, { Suspense, useEffect, useState } from 'react';\nimport { TolgeeInstance, TolgeeStaticDataProp } from '@tolgee/web';\nimport { ReactOptions, TolgeeReactContext } from './types';\nimport { useTolgeeSSR } from './useTolgeeSSR';\n\nexport const DEFAULT_REACT_OPTIONS: ReactOptions = {\n  useSuspense: false,\n};\n\nlet ProviderInstance: React.Context<TolgeeReactContext | undefined>;\n\nexport const getProviderInstance = () => {\n  if (!ProviderInstance) {\n    ProviderInstance = React.createContext<TolgeeReactContext | undefined>(\n      undefined\n    );\n  }\n\n  return ProviderInstance;\n};\n\nlet LAST_TOLGEE_INSTANCE: TolgeeInstance | undefined = undefined;\n\nexport type SSROptions = {\n  /**\n   * Hard set language to this value, use together with `staticData`\n   */\n  language?: string;\n  /**\n   * If provided, static data will be hard set to Tolgee cache for initial render\n   */\n  staticData?: TolgeeStaticDataProp;\n};\n\nexport interface TolgeeProviderProps {\n  children?: React.ReactNode;\n  tolgee: TolgeeInstance;\n  options?: ReactOptions;\n  fallback?: React.ReactNode;\n  /**\n   * use this option if you use SSR\n   *\n   * You can pass staticData and language\n   * which will be set to tolgee instance for the initial render\n   *\n   * Don't switch between ssr and non-ssr dynamically\n   */\n  ssr?: SSROptions | boolean;\n}\n\nexport const TolgeeProvider: React.FC<TolgeeProviderProps> = ({\n  tolgee,\n  options,\n  children,\n  fallback,\n  ssr,\n}) => {\n  // prevent restarting tolgee unnecesarly\n  // however if the instance change on hot-reloading\n  // we want to restart\n  useEffect(() => {\n    if (LAST_TOLGEE_INSTANCE?.run !== tolgee.run) {\n      if (LAST_TOLGEE_INSTANCE) {\n        LAST_TOLGEE_INSTANCE.stop();\n      }\n      LAST_TOLGEE_INSTANCE = tolgee;\n      tolgee\n        .run()\n        .catch((e) => {\n          // eslint-disable-next-line no-console\n          console.error(e);\n        })\n        .finally(() => {\n          setLoading(false);\n        });\n    }\n  }, [tolgee]);\n\n  let tolgeeSSR = tolgee;\n\n  const { language, staticData } = (\n    typeof ssr !== 'object' ? {} : ssr\n  ) as SSROptions;\n  tolgeeSSR = useTolgeeSSR(tolgee, language, staticData, Boolean(ssr));\n\n  const [loading, setLoading] = useState(!tolgeeSSR.isLoaded());\n\n  const optionsWithDefault = { ...DEFAULT_REACT_OPTIONS, ...options };\n\n  const TolgeeProviderContext = getProviderInstance();\n\n  if (optionsWithDefault.useSuspense) {\n    return (\n      <TolgeeProviderContext.Provider\n        value={{ tolgee: tolgeeSSR, options: optionsWithDefault }}\n      >\n        {loading ? (\n          fallback\n        ) : (\n          <Suspense fallback={fallback || null}>{children}</Suspense>\n        )}\n      </TolgeeProviderContext.Provider>\n    );\n  }\n\n  return (\n    <TolgeeProviderContext.Provider\n      value={{ tolgee: tolgeeSSR, options: optionsWithDefault }}\n    >\n      {loading ? fallback : children}\n    </TolgeeProviderContext.Provider>\n  );\n};\n","import type { TolgeePlugin } from '@tolgee/web';\nimport { DEFAULT_REACT_OPTIONS } from './TolgeeProvider';\nimport type { ReactOptions, TolgeeReactContext } from './types';\n\nlet globalContext: TolgeeReactContext | undefined;\n\nexport const GlobalContextPlugin =\n  (options?: Partial<ReactOptions>): TolgeePlugin =>\n  (tolgee) => {\n    globalContext = {\n      tolgee,\n      options: { ...DEFAULT_REACT_OPTIONS, ...options },\n    };\n    return tolgee;\n  };\n\nexport function getGlobalContext() {\n  return globalContext;\n}\n","import { useContext } from 'react';\nimport { getGlobalContext } from './GlobalContextPlugin';\nimport { getProviderInstance } from './TolgeeProvider';\n\nexport const useTolgeeContext = () => {\n  const TolgeeProviderContext = getProviderInstance();\n  const context = useContext(TolgeeProviderContext) || getGlobalContext();\n  if (!context) {\n    throw new Error(\n      \"Couldn't find tolgee instance, did you forgot to use `TolgeeProvider`?\"\n    );\n  }\n  return context;\n};\n","import { useCallback, useState } from 'react';\n\nexport const useRerender = () => {\n  const [instance, setCounter] = useState(0);\n\n  const rerender = useCallback(() => {\n    setCounter((num) => num + 1);\n  }, [setCounter]);\n  return { instance, rerender };\n};\n","import { useCallback, useEffect, useRef } from 'react';\nimport {\n  TranslateProps,\n  NsFallback,\n  getFallbackArray,\n  getFallback,\n} from '@tolgee/web';\n\nimport { useTolgeeContext } from './useTolgeeContext';\nimport { ReactOptions } from './types';\nimport { useRerender } from './hooks';\n\nexport const useTranslateInternal = (\n  ns?: NsFallback,\n  options?: ReactOptions\n) => {\n  const { tolgee, options: defaultOptions } = useTolgeeContext();\n  const namespaces = getFallback(ns);\n  const namespacesJoined = getFallbackArray(namespaces).join(':');\n\n  const currentOptions = {\n    ...defaultOptions,\n    ...options,\n  };\n\n  // dummy state to enable re-rendering\n  const { rerender, instance } = useRerender();\n\n  const subscriptionQueue = useRef([] as NsFallback[]);\n  subscriptionQueue.current = [];\n\n  const isLoaded = tolgee.isLoaded(namespaces);\n\n  useEffect(() => {\n    const subscription = tolgee.on('update', rerender);\n\n    return () => {\n      subscription.unsubscribe();\n    };\n  }, [namespacesJoined, tolgee]);\n\n  useEffect(() => {\n    tolgee.addActiveNs(namespaces);\n    return () => tolgee.removeActiveNs(namespaces);\n  }, [namespacesJoined, tolgee]);\n\n  const t = useCallback(\n    (props: TranslateProps<any>) => {\n      const fallbackNs = props.ns ?? namespaces?.[0];\n      return tolgee.t({ ...props, ns: fallbackNs }) as any;\n    },\n    [tolgee, instance]\n  );\n\n  if (currentOptions.useSuspense && !isLoaded) {\n    throw tolgee.addActiveNs(namespaces, true);\n  }\n\n  return { t, isLoading: !isLoaded };\n};\n","import { TranslateParams } from '@tolgee/web';\nimport React from 'react';\n\nimport { ParamsTags } from './types';\n\nfunction unwrapSingleElementArray(value: any) {\n  if (Array.isArray(value) && value.length === 1) {\n    return value[0];\n  } else {\n    return value;\n  }\n}\n\nexport const wrapTagHandlers = (\n  params: TranslateParams<ParamsTags> | undefined\n) => {\n  if (!params) {\n    return undefined;\n  }\n\n  const result: any = {};\n\n  Object.entries(params || {}).forEach(([key, value]) => {\n    if (typeof value === 'function') {\n      result[key] = (chunk: any) => {\n        return value(addReactKeys(chunk));\n      };\n    } else if (React.isValidElement(value as any)) {\n      const el = value as React.ReactElement;\n      result[key] = (chunk: any) => {\n        return el.props.children === undefined && chunk?.length\n          ? React.cloneElement(el, {}, addReactKeys(chunk))\n          : React.cloneElement(el);\n      };\n    } else {\n      result[key] = value;\n    }\n  });\n\n  return result;\n};\n\nexport const addReactKeys = (\n  children: React.ReactNode | React.ReactNode[] | undefined\n) => {\n  const val = unwrapSingleElementArray(children);\n  if (Array.isArray(val)) {\n    return val.map((item, i) => (\n      <React.Fragment key={i}>{item}</React.Fragment>\n    ));\n  } else {\n    return val;\n  }\n};\n","import React from 'react';\nimport { addReactKeys, wrapTagHandlers } from './tagsTools';\nimport type { PropsWithKeyName, TBaseInterface } from './types';\n\nexport const TBase: TBaseInterface = (props) => {\n  const key = (props as PropsWithKeyName).keyName || props.children;\n  if (key === undefined) {\n    // eslint-disable-next-line no-console\n    console.error('T component: keyName not defined');\n  }\n  const defaultValue =\n    props.defaultValue ||\n    ((props as PropsWithKeyName).keyName ? props.children : undefined);\n\n  const translation = addReactKeys(\n    props.t({\n      key: key!,\n      params: wrapTagHandlers(props.params),\n      defaultValue,\n      noWrap: props.noWrap,\n      ns: props.ns,\n      language: props.language,\n    })\n  );\n\n  return <>{translation}</>;\n};\n","import React from 'react';\nimport { ParamsTags, TProps } from './types';\n\nimport { useTranslateInternal } from './useTranslateInternal';\nimport { TFnType } from '@tolgee/web';\nimport { TBase } from './TBase';\n\ninterface TInterface {\n  (props: TProps): JSX.Element;\n}\n\nexport const T: TInterface = (props) => {\n  const { t } = useTranslateInternal();\n\n  return <TBase t={t as TFnType<ParamsTags>} {...props} />;\n};\n","import { TolgeeEvent, TolgeeInstance } from '@tolgee/web';\nimport { useEffect } from 'react';\nimport { useRerender } from './hooks';\nimport { useTolgeeContext } from './useTolgeeContext';\n\nexport const useTolgee = (events?: TolgeeEvent[]): TolgeeInstance => {\n  const { tolgee } = useTolgeeContext();\n\n  const { rerender } = useRerender();\n\n  useEffect(() => {\n    const listeners = events?.map((e) => tolgee.on(e, rerender));\n    return () => {\n      listeners?.forEach((listener) => listener.unsubscribe());\n    };\n  }, [events?.join(':')]);\n\n  return tolgee;\n};\n","import { useCallback } from 'react';\nimport {\n  TFnType,\n  getTranslateProps,\n  DefaultParamType,\n  TranslationKey,\n} from '@tolgee/web';\n\nimport { useTranslateInternal } from './useTranslateInternal';\nimport { ReactOptions } from './types';\n\nexport interface UseTranslateResult {\n  t: TFnType<DefaultParamType, string, TranslationKey>;\n  isLoading: boolean;\n}\n\nexport const useTranslate = (\n  ns?: string[] | string,\n  options?: ReactOptions\n): UseTranslateResult => {\n  const { t: tInternal, isLoading } = useTranslateInternal(ns, options);\n\n  const t = useCallback(\n    (...params: any) => {\n      // @ts-ignore\n      const props = getTranslateProps(...params);\n      return tInternal(props);\n    },\n    [tInternal]\n  );\n\n  return { t, isLoading };\n};\n"],"names":["useTolgeeSSR","tolgeeInstance","language","data","enabled","noWrappingTolgee","useState","getTolgeeWithDeactivatedWrapper","tolgee","Object","assign","t","args","props","getTranslateProps","noWrap","initialRender","setInitialRender","useEffect","useMemo","setEmitterActive","addStaticData","changeLanguage","isLoaded","requiredRecords","getRequiredDescriptors","providedRecords","getAllRecords","missingRecords","map","namespace","filter","key","find","r","cacheKey","console","warn","join","DEFAULT_REACT_OPTIONS","useSuspense","ProviderInstance","getProviderInstance","React","createContext","undefined","LAST_TOLGEE_INSTANCE","globalContext","useTolgeeContext","TolgeeProviderContext","context","useContext","Error","useRerender","instance","setCounter","rerender","useCallback","num","useTranslateInternal","ns","options","defaultOptions","namespaces","getFallback","namespacesJoined","getFallbackArray","currentOptions","useRef","current","subscription","on","unsubscribe","addActiveNs","removeActiveNs","fallbackNs","_a","isLoading","wrapTagHandlers","params","result","entries","forEach","value","chunk","addReactKeys","isValidElement","el","children","length","cloneElement","val","Array","isArray","item","i","Fragment","TBase","keyName","error","defaultValue","translation","createElement","fallback","ssr","run","stop","catch","e","finally","setLoading","tolgeeSSR","staticData","Boolean","loading","optionsWithDefault","Provider","Suspense","events","listeners","listener","tInternal"],"mappings":"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"}

package/dist/useTolgeeSSR.d.ts

@@ -1,4 +1,4 @@
-import { TolgeeInstance, TolgeeStaticData } from '@tolgee/web';
+import { CachePublicRecord, TolgeeInstance, TolgeeStaticData } from '@tolgee/web';
 /**
  * Updates tolgee static data and language, to be ready right away for the first render
  * and therefore compatible with SSR.
@@ -11,4 +11,4 @@ import { TolgeeInstance, TolgeeStaticData } from '@tolgee/web';
  * @param staticData static data for the language
  * @param enabled if set to false, no action is taken
  */
-export declare function useTolgeeSSR(tolgeeInstance: TolgeeInstance, language?: string, staticData?: TolgeeStaticData | undefined, enabled?: boolean): TolgeeInstance;
+export declare function useTolgeeSSR(tolgeeInstance: TolgeeInstance, language?: string, data?: TolgeeStaticData | CachePublicRecord[] | undefined, enabled?: boolean): TolgeeInstance;

package/lib/TolgeeProvider.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { TolgeeInstance, TolgeeStaticData } from '@tolgee/web';
+import { TolgeeInstance, TolgeeStaticDataProp } from '@tolgee/web';
 import { ReactOptions, TolgeeReactContext } from './types';
 export declare const DEFAULT_REACT_OPTIONS: ReactOptions;
 export declare const getProviderInstance: () => React.Context<TolgeeReactContext | undefined>;
@@ -11,7 +11,7 @@ export type SSROptions = {
     /**
      * If provided, static data will be hard set to Tolgee cache for initial render
      */
-    staticData?: TolgeeStaticData;
+    staticData?: TolgeeStaticDataProp;
 };
 export interface TolgeeProviderProps {
     children?: React.ReactNode;

package/lib/createServerInstance.d.ts

@@ -1,13 +1,14 @@
-import { TFnType } from '@tolgee/web';
-import { TProps } from './types';
 import React from 'react';
+import { TFnType } from '@tolgee/web';
 import { TolgeeInstance } from '@tolgee/web';
+import { TProps } from './types';
 export type CreateServerInstanceOptions = {
     createTolgee: (locale: string) => Promise<TolgeeInstance>;
     getLocale: () => Promise<string>;
 };
 export declare const createServerInstance: ({ createTolgee, getLocale, }: CreateServerInstanceOptions) => {
     getTolgeeInstance: (locale: string) => Promise<TolgeeInstance>;
+    getTolgeeStaticInstance: (locale: string) => Promise<TolgeeInstance>;
     getTolgee: () => Promise<TolgeeInstance>;
     getTranslate: () => Promise<TFnType<import("@tolgee/web").DefaultParamType, string, import("@tolgee/web").TranslationKey>>;
     T: (props: TProps) => Promise<React.JSX.Element>;

package/lib/useTolgeeSSR.d.ts

@@ -1,4 +1,4 @@
-import { TolgeeInstance, TolgeeStaticData } from '@tolgee/web';
+import { CachePublicRecord, TolgeeInstance, TolgeeStaticData } from '@tolgee/web';
 /**
  * Updates tolgee static data and language, to be ready right away for the first render
  * and therefore compatible with SSR.
@@ -11,4 +11,4 @@ import { TolgeeInstance, TolgeeStaticData } from '@tolgee/web';
  * @param staticData static data for the language
  * @param enabled if set to false, no action is taken
  */
-export declare function useTolgeeSSR(tolgeeInstance: TolgeeInstance, language?: string, staticData?: TolgeeStaticData | undefined, enabled?: boolean): TolgeeInstance;
+export declare function useTolgeeSSR(tolgeeInstance: TolgeeInstance, language?: string, data?: TolgeeStaticData | CachePublicRecord[] | undefined, enabled?: boolean): TolgeeInstance;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tolgee/react",
-  "version": "5.33.2",
+  "version": "5.33.3-prerelease.2efc0e6b.0",
   "description": "React implementation for Tolgee localization framework",
   "main": "./dist/tolgee-react.cjs.js",
   "module": "./dist/tolgee-react.esm.js",
@@ -38,7 +38,7 @@
     "react": "^16.14.0 || ^17.0.1 || ^18.1.0 || ^19"
   },
   "dependencies": {
-    "@tolgee/web": "5.33.2"
+    "@tolgee/web": "5.33.3-prerelease.2efc0e6b.0"
   },
   "devDependencies": {
     "@rollup/plugin-node-resolve": "^14.1.0",
@@ -46,8 +46,8 @@
     "@testing-library/dom": "^8.7.2",
     "@testing-library/jest-dom": "^5.11.4",
     "@testing-library/react": "^14.3.1",
-    "@tolgee/format-icu": "5.33.2",
-    "@tolgee/testing": "5.33.2",
+    "@tolgee/format-icu": "5.33.3-prerelease.2efc0e6b.0",
+    "@tolgee/testing": "5.33.3-prerelease.2efc0e6b.0",
     "@types/jest": "^27.0.2",
     "@types/node": "^17.0.8",
     "@types/react": "^18.3.16",
@@ -88,5 +88,5 @@
     "access": "public"
   },
   "sideEffects": false,
-  "gitHead": "73467e06c29511cafab7e7162cef8ac4a36ff507"
+  "gitHead": "799332abc27675f19c1b722ac063cbe2451f500e"
 }

package/src/TolgeeProvider.tsx

@@ -1,10 +1,10 @@
 import React, { Suspense, useEffect, useState } from 'react';
-import { TolgeeInstance, TolgeeStaticData } from '@tolgee/web';
+import { TolgeeInstance, TolgeeStaticDataProp } from '@tolgee/web';
 import { ReactOptions, TolgeeReactContext } from './types';
 import { useTolgeeSSR } from './useTolgeeSSR';
 
 export const DEFAULT_REACT_OPTIONS: ReactOptions = {
-  useSuspense: true,
+  useSuspense: false,
 };
 
 let ProviderInstance: React.Context<TolgeeReactContext | undefined>;
@@ -29,7 +29,7 @@ export type SSROptions = {
   /**
    * If provided, static data will be hard set to Tolgee cache for initial render
    */
-  staticData?: TolgeeStaticData;
+  staticData?: TolgeeStaticDataProp;
 };
 
 export interface TolgeeProviderProps {

package/src/__integration/namespaces.spec.tsx

@@ -36,7 +36,7 @@ describe('useTranslations namespaces', () => {
   beforeEach(async () => {
     staticDataMock = mockStaticDataAsync();
     tolgee = Tolgee()
-      .use(GlobalContextPlugin({ useSuspense: false }))
+      .use(GlobalContextPlugin())
       .use(DevTools())
       .use(FormatIcu())
       .init({
@@ -49,9 +49,7 @@ describe('useTranslations namespaces', () => {
 
     await act(async () => {
       const runPromise = tolgee.run();
-      staticDataMock.resolvablePromises.cs.resolve();
-      staticDataMock.resolvablePromises.en.resolve();
-      staticDataMock.resolvablePromises['en:fallback'].resolve();
+      staticDataMock.resolvePending();
       await runPromise;
       render(<TestComponent />);
     });
@@ -63,7 +61,7 @@ describe('useTranslations namespaces', () => {
 
   it('loads namespace after render', async () => {
     expect(screen.queryByTestId('loading')).toContainHTML('Loading...');
-    staticDataMock.resolveAll();
+    staticDataMock.resolvePending();
     await waitFor(() => {
       expect(screen.queryByTestId('loading')).toBeFalsy();
       expect(screen.queryByTestId('test')).toContainHTML('Český test');
@@ -72,7 +70,7 @@ describe('useTranslations namespaces', () => {
   });
 
   it('works with english fallback', async () => {
-    staticDataMock.resolveAll();
+    staticDataMock.resolvePending();
     await waitFor(() => {
       expect(screen.queryByTestId('test_english_fallback')).toContainHTML(
         'Test english fallback'
@@ -85,7 +83,7 @@ describe('useTranslations namespaces', () => {
 
   it('works with ns fallback', async () => {
     expect(screen.queryByTestId('ns_fallback')).toContainHTML('fallback');
-    staticDataMock.resolveAll();
+    staticDataMock.resolvePending();
     await waitFor(() => {
       expect(screen.queryByTestId('ns_fallback')).toContainHTML('Fallback');
       expect(screen.queryByTestId('ns_fallback')).toHaveAttribute('_tolgee');
@@ -98,7 +96,7 @@ describe('useTranslations namespaces', () => {
     );
     await act(async () => {
       const changePromise = tolgee.changeLanguage('en');
-      staticDataMock.resolveAll();
+      staticDataMock.resolvePending();
       await changePromise;
     });
     expect(screen.queryByTestId('ns_fallback')).toContainHTML(
@@ -107,7 +105,7 @@ describe('useTranslations namespaces', () => {
   });
 
   it('works with default value', async () => {
-    staticDataMock.resolveAll();
+    staticDataMock.resolvePending();
     await waitFor(() => {
       expect(screen.queryByTestId('non_existant')).toContainHTML(
         'Non existant'

package/src/__integration/useTolgee.spec.tsx

@@ -5,6 +5,7 @@ import { render, screen, waitFor } from '@testing-library/react';
 import { Tolgee, TolgeeEvent, TolgeeInstance } from '@tolgee/web';
 import { FormatIcu } from '@tolgee/format-icu';
 import { mockStaticDataAsync } from '@tolgee/testing/mockStaticData';
+import { wait } from '@tolgee/testing/wait';
 
 const API_URL = 'http://localhost';
 
@@ -66,6 +67,7 @@ describe('useTranslation hook integration', () => {
     checkState({ initialLoad: 'true' });
 
     await act(async () => {
+      await wait(0);
       staticDataMock.resolvablePromises.cs.resolve();
       await runPromise;
     });
@@ -74,6 +76,7 @@ describe('useTranslation hook integration', () => {
     });
     await act(async () => {
       tolgee.changeLanguage('en');
+      await wait(0);
       staticDataMock.resolvablePromises.en.resolve();
     });
     await waitFor(() => {
@@ -90,6 +93,7 @@ describe('useTranslation hook integration', () => {
     checkState({ language: 'cs' });
     await act(async () => {
       tolgee.changeLanguage('en');
+      await wait(0);
       staticDataMock.resolvablePromises.en.resolve();
     });
     checkState({ language: 'en' });
@@ -104,6 +108,7 @@ describe('useTranslation hook integration', () => {
     checkState({ language: 'cs', pendingLanguage: 'cs' });
     await act(async () => {
       tolgee.changeLanguage('en');
+      await wait(0);
       staticDataMock.resolvablePromises.en.resolve();
     });
     await waitFor(async () => {

package/src/createServerInstance.tsx

@@ -1,11 +1,11 @@
 // @ts-ignore
 import { cache } from 'react';
+import React from 'react';
 import { TFnType } from '@tolgee/web';
+import { TolgeeInstance } from '@tolgee/web';
 
 import { TBase } from './TBase';
 import { TProps, ParamsTags } from './types';
-import React from 'react';
-import { TolgeeInstance } from '@tolgee/web';
 
 export type CreateServerInstanceOptions = {
   createTolgee: (locale: string) => Promise<TolgeeInstance>;
@@ -16,11 +16,18 @@ export const createServerInstance = ({
   createTolgee,
   getLocale,
 }: CreateServerInstanceOptions) => {
-  const getTolgeeInstance = cache(async (locale: string) => {
-    const tolgee = await createTolgee(locale);
-    await tolgee.run();
-    return tolgee;
-  }) as (locale: string) => Promise<TolgeeInstance>;
+  const getTolgeeInstance: (locale: string) => Promise<TolgeeInstance> = cache(
+    async (locale: string) => {
+      const tolgee = await createTolgee(locale);
+      await tolgee.run();
+      return tolgee;
+    }
+  );
+
+  const getTolgeeStaticInstance: (locale: string) => Promise<TolgeeInstance> =
+    cache(async (locale: string): Promise<TolgeeInstance> => {
+      return createTolgee(locale);
+    });
 
   const getTolgee = async () => {
     const locale = await getLocale();
@@ -38,5 +45,11 @@ export const createServerInstance = ({
     return <TBase t={t as TFnType<ParamsTags>} {...props} />;
   }
 
-  return { getTolgeeInstance, getTolgee, getTranslate, T };
+  return {
+    getTolgeeInstance,
+    getTolgeeStaticInstance,
+    getTolgee,
+    getTranslate,
+    T,
+  };
 };

package/src/useTolgeeSSR.ts

@@ -1,4 +1,5 @@
 import {
+  CachePublicRecord,
   getTranslateProps,
   TolgeeInstance,
   TolgeeStaticData,
@@ -33,7 +34,7 @@ function getTolgeeWithDeactivatedWrapper(
 export function useTolgeeSSR(
   tolgeeInstance: TolgeeInstance,
   language?: string,
-  staticData?: TolgeeStaticData | undefined,
+  data?: TolgeeStaticData | CachePublicRecord[] | undefined,
   enabled = true
 ) {
   const [noWrappingTolgee] = useState(() =>
@@ -52,23 +53,24 @@ export function useTolgeeSSR(
       // so translations are available right away
       // events emitting must be off, to not trigger re-render while rendering
       tolgeeInstance.setEmitterActive(false);
-      tolgeeInstance.addStaticData(staticData);
+      tolgeeInstance.addStaticData(data);
       tolgeeInstance.changeLanguage(language!);
       tolgeeInstance.setEmitterActive(true);
     }
-  }, [language, staticData, tolgeeInstance]);
+  }, [language, data, tolgeeInstance]);
 
   useState(() => {
     // running this function only on first render
     if (!tolgeeInstance.isLoaded() && enabled) {
       // warning user, that static data provided are not sufficient
       // for proper SSR render
-      const missingRecords = tolgeeInstance
-        .getRequiredRecords(language)
+      const requiredRecords = tolgeeInstance.getRequiredDescriptors(language);
+      const providedRecords = tolgeeInstance.getAllRecords();
+      const missingRecords = requiredRecords
         .map(({ namespace, language }) =>
           namespace ? `${namespace}:${language}` : language
         )
-        .filter((key) => !staticData?.[key]);
+        .filter((key) => !providedRecords.find((r) => r?.cacheKey === key));
 
       // eslint-disable-next-line no-console
       console.warn(

package/src/useTranslateInternal.ts

@@ -1,6 +1,5 @@
 import { useCallback, useEffect, useRef } from 'react';
 import {
-  SubscriptionSelective,
   TranslateProps,
   NsFallback,
   getFallbackArray,
@@ -27,25 +26,13 @@ export const useTranslateInternal = (
   // dummy state to enable re-rendering
   const { rerender, instance } = useRerender();
 
-  const subscriptionRef = useRef<SubscriptionSelective>();
-
   const subscriptionQueue = useRef([] as NsFallback[]);
   subscriptionQueue.current = [];
 
-  const subscribeToNs = (ns: NsFallback) => {
-    subscriptionQueue.current.push(ns);
-    subscriptionRef.current?.subscribeNs(ns);
-  };
-
   const isLoaded = tolgee.isLoaded(namespaces);
 
   useEffect(() => {
-    const subscription = tolgee.onNsUpdate(rerender);
-    subscriptionRef.current = subscription;
-    subscription.subscribeNs(namespaces);
-    subscriptionQueue.current.forEach((ns) => {
-      subscription!.subscribeNs(ns);
-    });
+    const subscription = tolgee.on('update', rerender);
 
     return () => {
       subscription.unsubscribe();
@@ -60,7 +47,6 @@ export const useTranslateInternal = (
   const t = useCallback(
     (props: TranslateProps<any>) => {
       const fallbackNs = props.ns ?? namespaces?.[0];
-      subscribeToNs(fallbackNs);
       return tolgee.t({ ...props, ns: fallbackNs }) as any;
     },
     [tolgee, instance]