@generaltranslation/react-core 11.0.0-odysseus.14 → 11.0.0-odysseus.16

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # @generaltranslation/react-core
 
+## 11.0.0-odysseus.16
+
+### Major Changes
+
+- 463a8db: Add a config-aware `resolveCanonicalLocale` helper and remove the public `getGTClass` helper.
+- 463a8db: Remove the deprecated `useGTClass` hook from public entry points.
+- 40db0c5: Remove `useVersionId` from public package entrypoints.
+
+  The `getVersionId` helper remains available from public function entrypoints and `gt-i18n/internal`.
+
+### Patch Changes
+
+- bea8233: Statically gate dev hot-reload code paths (tracked resolver invalidation, missing-translation queue, T hot-reload fallbacks, getGT dev preload) behind `process.env.NODE_ENV !== 'production'` so bundlers can drop them from production builds. Behavior is unchanged: the existing runtime `isDevHotReloadEnabled()` check still applies in development.
+- 5736d58: Use production no-op stubs for dev hot-reload hooks so bundlers can drop more dev-only hot-reload code.
+- 1f53e42: Clean up the `gt-i18n` public API surface by removing dead subpaths, internal exports, and unused types.
+- e343775: Remove the accidental `useShouldTranslate` export from `@generaltranslation/react-core/hooks`. The hook is an internal implementation detail and was never meant to be public.
+- Updated dependencies [463a8db]
+- Updated dependencies [b72c30b]
+- Updated dependencies [bea8233]
+- Updated dependencies [1f53e42]
+- Updated dependencies [d5cf2d3]
+  - gt-i18n@1.0.0-odysseus.9
+  - generaltranslation@9.0.0-odysseus.6
+  - @generaltranslation/supported-locales@2.1.2-odysseus.6
+
+## 11.0.0-odysseus.15
+
+### Patch Changes
+
+- 04f419d: Fix source interpolation for default-locale string helpers.
+  Clarify that `tx()` does not apply ICU formatting by default.
+- 72e9e16: Split the runtime surface of the GT class (locale management, formatting, runtime translation) into a GTRuntime base class exported from the new `generaltranslation/runtime` entry point. The SDK runtime (gt-i18n's I18nConfig, gt-next middleware) now constructs GTRuntime, so production browser bundles no longer ship the project/file management API client (enqueueFiles, uploads, downloads, etc.). The GT class extends GTRuntime and keeps its full API for the CLI and other tooling. Also import getLocaleProperties from @generaltranslation/format directly in react-core so client bundles don't reach the full core entry.
+- 195f009: fix: make singleton not-initialized errors consistent and descriptive, and stop error paths from masking the original failure when I18nConfig is also uninitialized
+- Updated dependencies [72e9e16]
+- Updated dependencies [42a440f]
+- Updated dependencies [5adeede]
+- Updated dependencies [c5364f9]
+- Updated dependencies [2e85ebd]
+- Updated dependencies [195f009]
+  - generaltranslation@9.0.0-odysseus.5
+  - gt-i18n@1.0.0-odysseus.8
+  - @generaltranslation/supported-locales@2.1.2-odysseus.5
+
 ## 11.0.0-odysseus.14
 
 ### Patch Changes

package/dist/components/branches/Plural.shared.cjs

@@ -1,2 +1,2 @@
-const e=require(`../../utils/plurals/getPluralBranch.cjs`),t=require(`../../hooks/utils/getFormatLocales.cjs`);function n({_enableI18n:n,_locale:r,children:i,n:a,locales:o=[],...s}){let c=t.getFormatLocales({locale:r,enableI18n:n,localesProp:o});return typeof a==`number`&&e.getPluralBranch(a,c,s)||i}exports.renderPlural=n;
+const e=require(`../../hooks/utils/getFormatLocales.cjs`),t=require(`../../utils/plurals/getPluralBranch.cjs`);function n({_enableI18n:n,_locale:r,children:i,n:a,locales:o=[],...s}){let c=e.getFormatLocales({locale:r,enableI18n:n,localesProp:o});return typeof a==`number`?t.getPluralBranch(a,c,s)??i:i}exports.renderPlural=n;
 //# sourceMappingURL=Plural.shared.cjs.map

package/dist/components/branches/Plural.shared.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"Plural.shared.cjs","names":["getFormatLocales","getPluralBranch"],"sources":["../../../src/components/branches/Plural.shared.ts"],"sourcesContent":["import { getPluralBranch } from '../../utils/plurals/getPluralBranch';\nimport type { ReactNode } from 'react';\nimport { getFormatLocales } from '../../hooks/utils/getFormatLocales';\n\n// Pure render logic shared by the hook-based and RSC implementations. This\n// module must stay free of hook/context imports so it can be reached from the\n// components-rsc entrypoint.\n\ntype PluralProps = {\n  children?: ReactNode;\n  n: number;\n  locales?: string[];\n  _locale?: string;\n  _enableI18n?: boolean;\n  [key: string]: ReactNode;\n};\n\ntype ResolvedPluralProps = PluralProps & {\n  _locale: string;\n  _enableI18n: boolean;\n};\n\nfunction renderPlural({\n  _enableI18n,\n  _locale,\n  children,\n  n,\n  locales: localesProp = [],\n  ...branches\n}: ResolvedPluralProps): ReactNode {\n  const locales = getFormatLocales({\n    locale: _locale,\n    enableI18n: _enableI18n,\n    localesProp,\n  });\n  if (typeof n !== 'number') {\n    return children;\n  }\n  return getPluralBranch(n, locales, branches) || children;\n}\n\nexport { renderPlural };\nexport type { PluralProps, ResolvedPluralProps };\n"],"mappings":"+GAsBA,SAAS,EAAa,CACpB,cACA,UACA,WACA,IACA,QAAS,EAAc,EAAE,CACzB,GAAG,GAC8B,CACjC,IAAM,EAAUA,EAAAA,iBAAiB,CAC/B,OAAQ,EACR,WAAY,EACZ,cACD,CAAC,CAIF,OAHI,OAAO,GAAM,UAGVC,EAAAA,gBAAgB,EAAG,EAAS,EAAS,EAFnC"}
+{"version":3,"file":"Plural.shared.cjs","names":["getFormatLocales","getPluralBranch"],"sources":["../../../src/components/branches/Plural.shared.ts"],"sourcesContent":["import { getPluralBranch } from '../../utils/plurals/getPluralBranch';\nimport type { ReactNode } from 'react';\nimport { getFormatLocales } from '../../hooks/utils/getFormatLocales';\n\n// Pure render logic shared by the hook-based and RSC implementations. This\n// module must stay free of hook/context imports so it can be reached from the\n// components-rsc entrypoint.\n\ntype PluralProps = {\n  children?: ReactNode;\n  n: number;\n  locales?: string[];\n  _locale?: string;\n  _enableI18n?: boolean;\n  [key: string]: ReactNode;\n};\n\ntype ResolvedPluralProps = PluralProps & {\n  _locale: string;\n  _enableI18n: boolean;\n};\n\nfunction renderPlural({\n  _enableI18n,\n  _locale,\n  children,\n  n,\n  locales: localesProp = [],\n  ...branches\n}: ResolvedPluralProps): ReactNode {\n  const locales = getFormatLocales({\n    locale: _locale,\n    enableI18n: _enableI18n,\n    localesProp,\n  });\n  if (typeof n !== 'number') {\n    return children;\n  }\n  const resolvedBranch = getPluralBranch(n, locales, branches);\n  return resolvedBranch != null ? resolvedBranch : children;\n}\n\nexport { renderPlural };\nexport type { PluralProps, ResolvedPluralProps };\n"],"mappings":"+GAsBA,SAAS,EAAa,CACpB,cACA,UACA,WACA,IACA,QAAS,EAAc,EAAE,CACzB,GAAG,GAC8B,CACjC,IAAM,EAAUA,EAAAA,iBAAiB,CAC/B,OAAQ,EACR,WAAY,EACZ,cACD,CAAC,CAKF,OAJI,OAAO,GAAM,SAGMC,EAAAA,gBAAgB,EAAG,EAAS,EAC5C,EAA0C,EAHxC"}

package/dist/components/branches/Plural.shared.mjs

@@ -1,2 +1,2 @@
-import{getPluralBranch as e}from"../../utils/plurals/getPluralBranch.mjs";import{getFormatLocales as t}from"../../hooks/utils/getFormatLocales.mjs";function n({_enableI18n:n,_locale:r,children:i,n:a,locales:o=[],...s}){let c=t({locale:r,enableI18n:n,localesProp:o});return typeof a==`number`&&e(a,c,s)||i}export{n as renderPlural};
+import{getFormatLocales as e}from"../../hooks/utils/getFormatLocales.mjs";import{getPluralBranch as t}from"../../utils/plurals/getPluralBranch.mjs";function n({_enableI18n:n,_locale:r,children:i,n:a,locales:o=[],...s}){let c=e({locale:r,enableI18n:n,localesProp:o});return typeof a==`number`?t(a,c,s)??i:i}export{n as renderPlural};
 //# sourceMappingURL=Plural.shared.mjs.map

package/dist/components/branches/Plural.shared.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Plural.shared.mjs","names":[],"sources":["../../../src/components/branches/Plural.shared.ts"],"sourcesContent":["import { getPluralBranch } from '../../utils/plurals/getPluralBranch';\nimport type { ReactNode } from 'react';\nimport { getFormatLocales } from '../../hooks/utils/getFormatLocales';\n\n// Pure render logic shared by the hook-based and RSC implementations. This\n// module must stay free of hook/context imports so it can be reached from the\n// components-rsc entrypoint.\n\ntype PluralProps = {\n  children?: ReactNode;\n  n: number;\n  locales?: string[];\n  _locale?: string;\n  _enableI18n?: boolean;\n  [key: string]: ReactNode;\n};\n\ntype ResolvedPluralProps = PluralProps & {\n  _locale: string;\n  _enableI18n: boolean;\n};\n\nfunction renderPlural({\n  _enableI18n,\n  _locale,\n  children,\n  n,\n  locales: localesProp = [],\n  ...branches\n}: ResolvedPluralProps): ReactNode {\n  const locales = getFormatLocales({\n    locale: _locale,\n    enableI18n: _enableI18n,\n    localesProp,\n  });\n  if (typeof n !== 'number') {\n    return children;\n  }\n  return getPluralBranch(n, locales, branches) || children;\n}\n\nexport { renderPlural };\nexport type { PluralProps, ResolvedPluralProps };\n"],"mappings":"oJAsBA,SAAS,EAAa,CACpB,cACA,UACA,WACA,IACA,QAAS,EAAc,EAAE,CACzB,GAAG,GAC8B,CACjC,IAAM,EAAU,EAAiB,CAC/B,OAAQ,EACR,WAAY,EACZ,cACD,CAAC,CAIF,OAHI,OAAO,GAAM,UAGV,EAAgB,EAAG,EAAS,EAAS,EAFnC"}
+{"version":3,"file":"Plural.shared.mjs","names":[],"sources":["../../../src/components/branches/Plural.shared.ts"],"sourcesContent":["import { getPluralBranch } from '../../utils/plurals/getPluralBranch';\nimport type { ReactNode } from 'react';\nimport { getFormatLocales } from '../../hooks/utils/getFormatLocales';\n\n// Pure render logic shared by the hook-based and RSC implementations. This\n// module must stay free of hook/context imports so it can be reached from the\n// components-rsc entrypoint.\n\ntype PluralProps = {\n  children?: ReactNode;\n  n: number;\n  locales?: string[];\n  _locale?: string;\n  _enableI18n?: boolean;\n  [key: string]: ReactNode;\n};\n\ntype ResolvedPluralProps = PluralProps & {\n  _locale: string;\n  _enableI18n: boolean;\n};\n\nfunction renderPlural({\n  _enableI18n,\n  _locale,\n  children,\n  n,\n  locales: localesProp = [],\n  ...branches\n}: ResolvedPluralProps): ReactNode {\n  const locales = getFormatLocales({\n    locale: _locale,\n    enableI18n: _enableI18n,\n    localesProp,\n  });\n  if (typeof n !== 'number') {\n    return children;\n  }\n  const resolvedBranch = getPluralBranch(n, locales, branches);\n  return resolvedBranch != null ? resolvedBranch : children;\n}\n\nexport { renderPlural };\nexport type { PluralProps, ResolvedPluralProps };\n"],"mappings":"oJAsBA,SAAS,EAAa,CACpB,cACA,UACA,WACA,IACA,QAAS,EAAc,EAAE,CACzB,GAAG,GAC8B,CACjC,IAAM,EAAU,EAAiB,CAC/B,OAAQ,EACR,WAAY,EACZ,cACD,CAAC,CAKF,OAJI,OAAO,GAAM,SAGM,EAAgB,EAAG,EAAS,EAC5C,EAA0C,EAHxC"}

package/dist/components/helpers/InternalLocaleSelector.cjs

@@ -1,2 +1,2 @@
-const e=require(`../../_virtual/_rolldown/runtime.cjs`);let t=require(`react`);t=e.__toESM(t);let n=require(`react/jsx-runtime`);function r(e){return e?e.charAt(0).toUpperCase()+(e.length>1?e.slice(1):``):``}function i(e){if(!e)return;let t={};for(let n in e)t[n]={name:e[n]};return t}function a({locale:e,locales:t,customNames:a,customMapping:o=i(a),setLocale:s,getLocaleProperties:c,...l}){let u=e=>{if(o&&o[e]){if(typeof o[e]==`string`)return o[e];if(o[e].name)return o[e].name}return r(c(e).nativeNameWithRegionCode)};return!t||t.length===0||!s?null:(0,n.jsxs)(`select`,{name:`generaltranslation-locale`,"aria-label":`General Translation locale selector`,...l,value:e||``,onChange:e=>s(e.target.value),children:[!e&&(0,n.jsx)(`option`,{value:``}),t.map(e=>(0,n.jsx)(`option`,{value:e,suppressHydrationWarning:!0,children:u(e)},e))]})}exports.InternalLocaleSelector=a;
+const e=require(`../../_virtual/_rolldown/runtime.cjs`);let t=require(`react/jsx-runtime`),n=require(`react`);n=e.__toESM(n);function r(e){return e?e.charAt(0).toUpperCase()+(e.length>1?e.slice(1):``):``}function i(e){if(!e)return;let t={};for(let n in e)t[n]={name:e[n]};return t}function a({locale:e,locales:n,customNames:a,customMapping:o=i(a),setLocale:s,getLocaleProperties:c,...l}){let u=e=>{if(o&&o[e]){if(typeof o[e]==`string`)return o[e];if(o[e].name)return o[e].name}return r(c(e).nativeNameWithRegionCode)};return!n||n.length===0||!s?null:(0,t.jsxs)(`select`,{name:`generaltranslation-locale`,"aria-label":`General Translation locale selector`,...l,value:e||``,onChange:e=>s(e.target.value),children:[!e&&(0,t.jsx)(`option`,{value:``}),n.map(e=>(0,t.jsx)(`option`,{value:e,suppressHydrationWarning:!0,children:u(e)},e))]})}exports.InternalLocaleSelector=a;
 //# sourceMappingURL=InternalLocaleSelector.cjs.map

package/dist/components/helpers/InternalLocaleSelector.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"InternalLocaleSelector.cjs","names":[],"sources":["../../../src/components/helpers/InternalLocaleSelector.tsx"],"sourcesContent":["import React from 'react';\nimport { CustomMapping, LocaleProperties } from 'generaltranslation/types';\n\n/**\n * Capitalizes the first letter of a string if applicable.\n * For strings that do not use capitalization, it returns the string unchanged.\n * @param {string} str - The string to capitalize.\n * @returns {string} The string with the first letter capitalized if applicable.\n */\nfunction capitalizeName(str: string): string {\n  if (!str) return '';\n  return str.charAt(0).toUpperCase() + (str.length > 1 ? str.slice(1) : '');\n}\n\n/**\n * Internal helper to convert deprecated customNames prop to the new customMapping format.\n * Used for backward compatibility with previous LocaleSelector API.\n * @param {object} customNames - Mapping of locale to display name.\n * @returns {CustomMapping | undefined} The converted mapping or undefined.\n * @internal\n */\nfunction _convertCustomNamesToMapping(\n  customNames?: { [key: string]: string } | undefined\n): CustomMapping | undefined {\n  if (!customNames) return undefined;\n  const result: CustomMapping = {};\n  for (const locale in customNames) {\n    result[locale] = { name: customNames[locale] };\n  }\n  return result;\n}\n\n/**\n * A dropdown component that allows users to select a locale.\n * @param {string} locale - The currently selected locale.\n * @param {string[]} locales - The list of all available locales.\n * @param {function} setLocale - Function to update the current locale.\n * @param {function} getLocaleProperties - Function to retrieve properties for a given locale.\n * @param {object} [customNames] - (deprecated) An optional object to map locales to custom names. Use `customMapping` instead.\n * @param {CustomMapping} [customMapping] - An optional object to map locales to custom display names, emojis, or other properties.\n * @returns {React.ReactElement | null} The rendered locale dropdown component or null to prevent rendering.\n *\n * @internal\n */\nexport function InternalLocaleSelector({\n  locale,\n  locales,\n  customNames,\n  customMapping = _convertCustomNamesToMapping(customNames),\n  setLocale,\n  getLocaleProperties,\n  ...props\n}: {\n  locale: string;\n  locales: string[];\n  customNames?: { [key: string]: string };\n  customMapping?: CustomMapping;\n  setLocale: (locale: string) => void;\n  getLocaleProperties: (locale: string) => LocaleProperties;\n  [key: string]: any;\n}): React.JSX.Element | null {\n  // Get display name\n  const getDisplayName = (locale: string) => {\n    if (customMapping && customMapping[locale]) {\n      if (typeof customMapping[locale] === 'string')\n        return customMapping[locale];\n      if (customMapping[locale].name) return customMapping[locale].name;\n    }\n    return capitalizeName(getLocaleProperties(locale).nativeNameWithRegionCode);\n  };\n\n  // If no locales are returned, just render nothing or handle gracefully\n  if (!locales || locales.length === 0 || !setLocale) {\n    return null;\n  }\n\n  return (\n    <select\n      name='generaltranslation-locale'\n      aria-label='General Translation locale selector'\n      {...props}\n      // Fallback to an empty string if currentLocale is undefined\n      value={locale || ''}\n      onChange={(e) => setLocale(e.target.value)}\n    >\n      {/* Optional fallback for when no locale is set */}\n      {!locale && <option value='' />}\n\n      {locales.map((locale) => (\n        <option key={locale} value={locale} suppressHydrationWarning>\n          {getDisplayName(locale)}\n        </option>\n      ))}\n    </select>\n  );\n}\n"],"mappings":"iIASA,SAAS,EAAe,EAAqB,CAE3C,OADK,EACE,EAAI,OAAO,EAAE,CAAC,aAAa,EAAI,EAAI,OAAS,EAAI,EAAI,MAAM,EAAE,CAAG,IADrD,GAWnB,SAAS,EACP,EAC2B,CAC3B,GAAI,CAAC,EAAa,OAClB,IAAM,EAAwB,EAAE,CAChC,IAAK,IAAM,KAAU,EACnB,EAAO,GAAU,CAAE,KAAM,EAAY,GAAS,CAEhD,OAAO,EAeT,SAAgB,EAAuB,CACrC,SACA,UACA,cACA,gBAAgB,EAA6B,EAAY,CACzD,YACA,sBACA,GAAG,GASwB,CAE3B,IAAM,EAAkB,GAAmB,CACzC,GAAI,GAAiB,EAAc,GAAS,CAC1C,GAAI,OAAO,EAAc,IAAY,SACnC,OAAO,EAAc,GACvB,GAAI,EAAc,GAAQ,KAAM,OAAO,EAAc,GAAQ,KAE/D,OAAO,EAAe,EAAoB,EAAO,CAAC,yBAAyB,EAQ7E,MAJI,CAAC,GAAW,EAAQ,SAAW,GAAK,CAAC,EAChC,MAIP,EAAA,EAAA,MAAC,SAAD,CACE,KAAK,4BACL,aAAW,sCACX,GAAI,EAEJ,MAAO,GAAU,GACjB,SAAW,GAAM,EAAU,EAAE,OAAO,MAAM,UAN5C,CASG,CAAC,IAAU,EAAA,EAAA,KAAC,SAAD,CAAQ,MAAM,GAAK,CAAA,CAE9B,EAAQ,IAAK,IACZ,EAAA,EAAA,KAAC,SAAD,CAAqB,MAAO,EAAQ,yBAAA,YACjC,EAAe,EAAO,CAChB,CAFI,EAEJ,CACT,CACK"}
+{"version":3,"file":"InternalLocaleSelector.cjs","names":[],"sources":["../../../src/components/helpers/InternalLocaleSelector.tsx"],"sourcesContent":["import React from 'react';\nimport { CustomMapping, LocaleProperties } from 'generaltranslation/types';\n\n/**\n * Capitalizes the first letter of a string if applicable.\n * For strings that do not use capitalization, it returns the string unchanged.\n * @param {string} str - The string to capitalize.\n * @returns {string} The string with the first letter capitalized if applicable.\n */\nfunction capitalizeName(str: string): string {\n  if (!str) return '';\n  return str.charAt(0).toUpperCase() + (str.length > 1 ? str.slice(1) : '');\n}\n\n/**\n * Internal helper to convert deprecated customNames prop to the new customMapping format.\n * Used for backward compatibility with previous LocaleSelector API.\n * @param {object} customNames - Mapping of locale to display name.\n * @returns {CustomMapping | undefined} The converted mapping or undefined.\n * @internal\n */\nfunction _convertCustomNamesToMapping(\n  customNames?: { [key: string]: string } | undefined\n): CustomMapping | undefined {\n  if (!customNames) return undefined;\n  const result: CustomMapping = {};\n  for (const locale in customNames) {\n    result[locale] = { name: customNames[locale] };\n  }\n  return result;\n}\n\n/**\n * A dropdown component that allows users to select a locale.\n * @param {string} locale - The currently selected locale.\n * @param {string[]} locales - The list of all available locales.\n * @param {function} setLocale - Function to update the current locale.\n * @param {function} getLocaleProperties - Function to retrieve properties for a given locale.\n * @param {object} [customNames] - (deprecated) An optional object to map locales to custom names. Use `customMapping` instead.\n * @param {CustomMapping} [customMapping] - An optional object to map locales to custom display names, emojis, or other properties.\n * @returns {React.ReactElement | null} The rendered locale dropdown component or null to prevent rendering.\n *\n * @internal\n */\nexport function InternalLocaleSelector({\n  locale,\n  locales,\n  customNames,\n  customMapping = _convertCustomNamesToMapping(customNames),\n  setLocale,\n  getLocaleProperties,\n  ...props\n}: {\n  locale: string;\n  locales: string[];\n  customNames?: { [key: string]: string };\n  customMapping?: CustomMapping;\n  setLocale: (locale: string) => void;\n  getLocaleProperties: (locale: string) => LocaleProperties;\n  [key: string]: any;\n}): React.JSX.Element | null {\n  // Get display name\n  const getDisplayName = (locale: string) => {\n    if (customMapping && customMapping[locale]) {\n      if (typeof customMapping[locale] === 'string')\n        return customMapping[locale];\n      if (customMapping[locale].name) return customMapping[locale].name;\n    }\n    return capitalizeName(getLocaleProperties(locale).nativeNameWithRegionCode);\n  };\n\n  // If no locales are returned, just render nothing or handle gracefully\n  if (!locales || locales.length === 0 || !setLocale) {\n    return null;\n  }\n\n  return (\n    <select\n      name='generaltranslation-locale'\n      aria-label='General Translation locale selector'\n      {...props}\n      // Fallback to an empty string if currentLocale is undefined\n      value={locale || ''}\n      onChange={(e) => setLocale(e.target.value)}\n    >\n      {/* Optional fallback for when no locale is set */}\n      {!locale && <option value='' />}\n\n      {locales.map((locale) => (\n        <option key={locale} value={locale} suppressHydrationWarning>\n          {getDisplayName(locale)}\n        </option>\n      ))}\n    </select>\n  );\n}\n"],"mappings":"6HASA,SAAS,EAAe,EAAqB,CAE3C,OADK,EACE,EAAI,OAAO,EAAE,CAAC,aAAa,EAAI,EAAI,OAAS,EAAI,EAAI,MAAM,EAAE,CAAG,IADrD,GAWnB,SAAS,EACP,EAC2B,CAC3B,GAAI,CAAC,EAAa,OAClB,IAAM,EAAwB,EAAE,CAChC,IAAK,IAAM,KAAU,EACnB,EAAO,GAAU,CAAE,KAAM,EAAY,GAAS,CAEhD,OAAO,EAeT,SAAgB,EAAuB,CACrC,SACA,UACA,cACA,gBAAgB,EAA6B,EAAY,CACzD,YACA,sBACA,GAAG,GASwB,CAE3B,IAAM,EAAkB,GAAmB,CACzC,GAAI,GAAiB,EAAc,GAAS,CAC1C,GAAI,OAAO,EAAc,IAAY,SACnC,OAAO,EAAc,GACvB,GAAI,EAAc,GAAQ,KAAM,OAAO,EAAc,GAAQ,KAE/D,OAAO,EAAe,EAAoB,EAAO,CAAC,yBAAyB,EAQ7E,MAJI,CAAC,GAAW,EAAQ,SAAW,GAAK,CAAC,EAChC,MAIP,EAAA,EAAA,MAAC,SAAD,CACE,KAAK,4BACL,aAAW,sCACX,GAAI,EAEJ,MAAO,GAAU,GACjB,SAAW,GAAM,EAAU,EAAE,OAAO,MAAM,UAN5C,CASG,CAAC,IAAU,EAAA,EAAA,KAAC,SAAD,CAAQ,MAAM,GAAK,CAAA,CAE9B,EAAQ,IAAK,IACZ,EAAA,EAAA,KAAC,SAAD,CAAqB,MAAO,EAAQ,yBAAA,YACjC,EAAe,EAAO,CAChB,CAFI,EAEJ,CACT,CACK"}

package/dist/components/helpers/InternalLocaleSelector.mjs

@@ -1,2 +1,2 @@
-import"react";import{jsx as e,jsxs as t}from"react/jsx-runtime";function n(e){return e?e.charAt(0).toUpperCase()+(e.length>1?e.slice(1):``):``}function r(e){if(!e)return;let t={};for(let n in e)t[n]={name:e[n]};return t}function i({locale:i,locales:a,customNames:o,customMapping:s=r(o),setLocale:c,getLocaleProperties:l,...u}){let d=e=>{if(s&&s[e]){if(typeof s[e]==`string`)return s[e];if(s[e].name)return s[e].name}return n(l(e).nativeNameWithRegionCode)};return!a||a.length===0||!c?null:t(`select`,{name:`generaltranslation-locale`,"aria-label":`General Translation locale selector`,...u,value:i||``,onChange:e=>c(e.target.value),children:[!i&&e(`option`,{value:``}),a.map(t=>e(`option`,{value:t,suppressHydrationWarning:!0,children:d(t)},t))]})}export{i as InternalLocaleSelector};
+import{jsx as e,jsxs as t}from"react/jsx-runtime";import"react";function n(e){return e?e.charAt(0).toUpperCase()+(e.length>1?e.slice(1):``):``}function r(e){if(!e)return;let t={};for(let n in e)t[n]={name:e[n]};return t}function i({locale:i,locales:a,customNames:o,customMapping:s=r(o),setLocale:c,getLocaleProperties:l,...u}){let d=e=>{if(s&&s[e]){if(typeof s[e]==`string`)return s[e];if(s[e].name)return s[e].name}return n(l(e).nativeNameWithRegionCode)};return!a||a.length===0||!c?null:t(`select`,{name:`generaltranslation-locale`,"aria-label":`General Translation locale selector`,...u,value:i||``,onChange:e=>c(e.target.value),children:[!i&&e(`option`,{value:``}),a.map(t=>e(`option`,{value:t,suppressHydrationWarning:!0,children:d(t)},t))]})}export{i as InternalLocaleSelector};
 //# sourceMappingURL=InternalLocaleSelector.mjs.map

package/dist/components/helpers/InternalRegionSelector.cjs

@@ -1,2 +1,2 @@
-const e=require(`../../_virtual/_rolldown/runtime.cjs`);let t=require(`react`);t=e.__toESM(t);let n=require(`react/jsx-runtime`);function r({region:e,regions:t,regionData:r,setRegion:i,placeholder:a,...o}){return!t||t.length===0||!i?null:(0,n.jsxs)(`select`,{name:`generaltranslation-region`,"aria-label":`General Translation region selector`,...o,value:e||``,onChange:e=>i(e.target.value),children:[!e&&(0,n.jsx)(`option`,{value:``,suppressHydrationWarning:!0,children:a||``},`placeholder`),t.map(e=>(0,n.jsx)(`option`,{value:e,suppressHydrationWarning:!0,children:r.get(e)?.name??e},e))]})}exports.InternalRegionSelector=r;
+const e=require(`../../_virtual/_rolldown/runtime.cjs`);let t=require(`react/jsx-runtime`),n=require(`react`);n=e.__toESM(n);function r({region:e,regions:n,regionData:r,setRegion:i,placeholder:a,...o}){return!n||n.length===0||!i?null:(0,t.jsxs)(`select`,{name:`generaltranslation-region`,"aria-label":`General Translation region selector`,...o,value:e||``,onChange:e=>i(e.target.value),children:[!e&&(0,t.jsx)(`option`,{value:``,suppressHydrationWarning:!0,children:a||``},`placeholder`),n.map(e=>(0,t.jsx)(`option`,{value:e,suppressHydrationWarning:!0,children:r.get(e)?.name??e},e))]})}exports.InternalRegionSelector=r;
 //# sourceMappingURL=InternalRegionSelector.cjs.map

package/dist/components/helpers/InternalRegionSelector.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"InternalRegionSelector.cjs","names":[],"sources":["../../../src/components/helpers/InternalRegionSelector.tsx"],"sourcesContent":["import React, { ReactNode } from 'react';\nimport type { RegionData } from '../../hooks/useInternalRegionSelector';\n\n/**\n * A dropdown component that allows users to select a region.\n * @param {string | undefined} region - The currently selected region.\n * @param {string[]} regions - The ordered list of available region codes.\n * @param {Map<string, RegionData>} regionData - Map of region codes to their display data (name, emoji, locale).\n * @param {function} setRegion - Function to update the current region.\n * @param {React.ReactNode} [placeholder] - Optional placeholder node to display as the first option when no region is selected.\n * @returns {React.ReactElement | null} The rendered region dropdown component or null to prevent rendering.\n *\n * @internal\n */\nexport function InternalRegionSelector({\n  region,\n  regions,\n  regionData,\n  setRegion,\n  placeholder,\n  ...props\n}: {\n  region: string | undefined;\n  regions: string[];\n  regionData: Map<string, RegionData>;\n  setRegion: (region: string) => void;\n  placeholder?: ReactNode;\n  [key: string]: any;\n}): React.JSX.Element | null {\n  // If no regions are returned, just render nothing or handle gracefully\n  if (!regions || regions.length === 0 || !setRegion) {\n    return null;\n  }\n\n  return (\n    <select\n      name='generaltranslation-region'\n      aria-label='General Translation region selector'\n      {...props}\n      // Fallback to an empty string if no region is set\n      value={region || ''}\n      onChange={(e) => setRegion(e.target.value)}\n    >\n      {/* Optional placeholder for when no region is set */}\n      {!region && (\n        <option key='placeholder' value='' suppressHydrationWarning>\n          {placeholder || ''}\n        </option>\n      )}\n\n      {regions.map((r) => (\n        <option key={r} value={r} suppressHydrationWarning>\n          {regionData.get(r)?.name ?? r}\n        </option>\n      ))}\n    </select>\n  );\n}\n"],"mappings":"iIAcA,SAAgB,EAAuB,CACrC,SACA,UACA,aACA,YACA,cACA,GAAG,GAQwB,CAM3B,MAJI,CAAC,GAAW,EAAQ,SAAW,GAAK,CAAC,EAChC,MAIP,EAAA,EAAA,MAAC,SAAD,CACE,KAAK,4BACL,aAAW,sCACX,GAAI,EAEJ,MAAO,GAAU,GACjB,SAAW,GAAM,EAAU,EAAE,OAAO,MAAM,UAN5C,CASG,CAAC,IACA,EAAA,EAAA,KAAC,SAAD,CAA0B,MAAM,GAAG,yBAAA,YAChC,GAAe,GACT,CAFG,cAEH,CAGV,EAAQ,IAAK,IACZ,EAAA,EAAA,KAAC,SAAD,CAAgB,MAAO,EAAG,yBAAA,YACvB,EAAW,IAAI,EAAE,EAAE,MAAQ,EACrB,CAFI,EAEJ,CACT,CACK"}
+{"version":3,"file":"InternalRegionSelector.cjs","names":[],"sources":["../../../src/components/helpers/InternalRegionSelector.tsx"],"sourcesContent":["import React, { ReactNode } from 'react';\nimport type { RegionData } from '../../hooks/useInternalRegionSelector';\n\n/**\n * A dropdown component that allows users to select a region.\n * @param {string | undefined} region - The currently selected region.\n * @param {string[]} regions - The ordered list of available region codes.\n * @param {Map<string, RegionData>} regionData - Map of region codes to their display data (name, emoji, locale).\n * @param {function} setRegion - Function to update the current region.\n * @param {React.ReactNode} [placeholder] - Optional placeholder node to display as the first option when no region is selected.\n * @returns {React.ReactElement | null} The rendered region dropdown component or null to prevent rendering.\n *\n * @internal\n */\nexport function InternalRegionSelector({\n  region,\n  regions,\n  regionData,\n  setRegion,\n  placeholder,\n  ...props\n}: {\n  region: string | undefined;\n  regions: string[];\n  regionData: Map<string, RegionData>;\n  setRegion: (region: string) => void;\n  placeholder?: ReactNode;\n  [key: string]: any;\n}): React.JSX.Element | null {\n  // If no regions are returned, just render nothing or handle gracefully\n  if (!regions || regions.length === 0 || !setRegion) {\n    return null;\n  }\n\n  return (\n    <select\n      name='generaltranslation-region'\n      aria-label='General Translation region selector'\n      {...props}\n      // Fallback to an empty string if no region is set\n      value={region || ''}\n      onChange={(e) => setRegion(e.target.value)}\n    >\n      {/* Optional placeholder for when no region is set */}\n      {!region && (\n        <option key='placeholder' value='' suppressHydrationWarning>\n          {placeholder || ''}\n        </option>\n      )}\n\n      {regions.map((r) => (\n        <option key={r} value={r} suppressHydrationWarning>\n          {regionData.get(r)?.name ?? r}\n        </option>\n      ))}\n    </select>\n  );\n}\n"],"mappings":"6HAcA,SAAgB,EAAuB,CACrC,SACA,UACA,aACA,YACA,cACA,GAAG,GAQwB,CAM3B,MAJI,CAAC,GAAW,EAAQ,SAAW,GAAK,CAAC,EAChC,MAIP,EAAA,EAAA,MAAC,SAAD,CACE,KAAK,4BACL,aAAW,sCACX,GAAI,EAEJ,MAAO,GAAU,GACjB,SAAW,GAAM,EAAU,EAAE,OAAO,MAAM,UAN5C,CASG,CAAC,IACA,EAAA,EAAA,KAAC,SAAD,CAA0B,MAAM,GAAG,yBAAA,YAChC,GAAe,GACT,CAFG,cAEH,CAGV,EAAQ,IAAK,IACZ,EAAA,EAAA,KAAC,SAAD,CAAgB,MAAO,EAAG,yBAAA,YACvB,EAAW,IAAI,EAAE,EAAE,MAAQ,EACrB,CAFI,EAEJ,CACT,CACK"}

package/dist/components/helpers/InternalRegionSelector.mjs

@@ -1,2 +1,2 @@
-import"react";import{jsx as e,jsxs as t}from"react/jsx-runtime";function n({region:n,regions:r,regionData:i,setRegion:a,placeholder:o,...s}){return!r||r.length===0||!a?null:t(`select`,{name:`generaltranslation-region`,"aria-label":`General Translation region selector`,...s,value:n||``,onChange:e=>a(e.target.value),children:[!n&&e(`option`,{value:``,suppressHydrationWarning:!0,children:o||``},`placeholder`),r.map(t=>e(`option`,{value:t,suppressHydrationWarning:!0,children:i.get(t)?.name??t},t))]})}export{n as InternalRegionSelector};
+import{jsx as e,jsxs as t}from"react/jsx-runtime";import"react";function n({region:n,regions:r,regionData:i,setRegion:a,placeholder:o,...s}){return!r||r.length===0||!a?null:t(`select`,{name:`generaltranslation-region`,"aria-label":`General Translation region selector`,...s,value:n||``,onChange:e=>a(e.target.value),children:[!n&&e(`option`,{value:``,suppressHydrationWarning:!0,children:o||``},`placeholder`),r.map(t=>e(`option`,{value:t,suppressHydrationWarning:!0,children:i.get(t)?.name??t},t))]})}export{n as InternalRegionSelector};
 //# sourceMappingURL=InternalRegionSelector.mjs.map

package/dist/components/translation/T.cjs

@@ -1,2 +1,2 @@
-require(`../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../hooks/external-store.cjs`),t=require(`../../utils/rendering/renderPipeline.cjs`),n=require(`../../utils/translation/usePrepareT.cjs`);let r=require(`react`),i=require(`gt-i18n/internal`);function a(e){return s(e)}function o(e){return s(e)}a._gtt=`translate-client`,o._gtt=`translate-client-automatic`;function s({children:a,_locale:o,_enableI18n:s,_renderPreparedT:c=t.renderPreparedT,...l}){let{defaultLocale:u,locale:d,enableI18n:f,targetOptions:p,taggedSourceChildren:m,sourceJsxChildren:h,shouldTranslate:g}=n.usePrepareT({sourceChildren:a,params:l,_locale:o,_enableI18n:s}),_=e.useTranslate({locale:d,message:h,options:p}),v=(0,r.useRef)(null);if((0,i.getI18nConfig)().isDevHotReloadEnabled()&&_==null&&v.current!=null&&g)return v.current;let y=c({taggedSourceChildren:m,targetJsxChildren:_,locale:d,defaultLocale:u,enableI18n:f,shouldTranslate:g});return v.current=y,y}exports.GtInternalTranslateJsx=o,exports.T=a;
+require(`../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../hooks/external-store.cjs`),t=require(`../../utils/rendering/renderPipeline.cjs`),n=require(`../../utils/translation/usePrepareT.cjs`);let r=require(`gt-i18n/internal`),i=require(`react`);function a(e){return s(e)}function o(e){return s(e)}a._gtt=`translate-client`,o._gtt=`translate-client-automatic`;function s({children:a,_locale:o,_enableI18n:s,_renderPreparedT:c=t.renderPreparedT,...l}){let{defaultLocale:u,locale:d,enableI18n:f,targetOptions:p,taggedSourceChildren:m,sourceJsxChildren:h,shouldTranslate:g}=n.usePrepareT({sourceChildren:a,params:l,_locale:o,_enableI18n:s}),_=e.useTranslate({locale:d,message:h,options:p}),v=(0,i.useRef)(null);if(process.env.NODE_ENV!==`production`&&(0,r.getI18nConfig)().isDevHotReloadEnabled()&&_==null&&v.current!=null&&g)return v.current;let y=c({taggedSourceChildren:m,targetJsxChildren:_,locale:d,defaultLocale:u,enableI18n:f,shouldTranslate:g});return v.current=y,y}exports.GtInternalTranslateJsx=o,exports.T=a;
 //# sourceMappingURL=T.cjs.map

package/dist/components/translation/T.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"T.cjs","names":["renderPreparedT","usePrepareT","useTranslate"],"sources":["../../../src/components/translation/T.tsx"],"sourcesContent":["import { useTranslate } from '../../hooks/external-store';\nimport { getI18nConfig } from 'gt-i18n/internal';\nimport { useRef, type ReactNode } from 'react';\nimport { renderPreparedT } from '../../utils/rendering/renderPipeline';\nimport type { TProps } from '../../utils/translation/prepareT.shared';\nimport { usePrepareT } from '../../utils/translation/usePrepareT';\n\n// ===== Component ===== //\n\n/**\n * External-store version of the `<T>` component.\n */\nfunction T(props: TProps): ReactNode {\n  return useComputeT(props);\n}\n\nfunction GtInternalTranslateJsx(props: TProps): ReactNode {\n  return useComputeT(props);\n}\n\n/** @internal _gtt - The GT transformation for the component. */\nT._gtt = 'translate-client';\nGtInternalTranslateJsx._gtt = 'translate-client-automatic';\n\nexport { GtInternalTranslateJsx, T };\n\n/**\n * Render logic\n */\nfunction useComputeT({\n  children: sourceChildren,\n  _locale,\n  _enableI18n,\n  _renderPreparedT = renderPreparedT,\n  ...params\n}: TProps): ReactNode {\n  // Prepare our source children for rendering\n  const {\n    defaultLocale,\n    locale,\n    enableI18n,\n    targetOptions,\n    taggedSourceChildren,\n    sourceJsxChildren,\n    shouldTranslate,\n  } = usePrepareT({\n    sourceChildren,\n    params,\n    _locale,\n    _enableI18n,\n  });\n\n  // Lookup translation in cache\n  const targetJsxChildren = useTranslate({\n    locale,\n    message: sourceJsxChildren,\n    options: targetOptions,\n  });\n\n  // Tx hot reload: render previous translation while loading new one\n  // TODO: account for success vs loading vs failed request states\n  const prev = useRef<ReactNode | null>(null);\n  if (\n    getI18nConfig().isDevHotReloadEnabled() &&\n    targetJsxChildren == null &&\n    prev.current != null &&\n    shouldTranslate\n  ) {\n    return prev.current;\n  }\n\n  const result = _renderPreparedT({\n    taggedSourceChildren,\n    targetJsxChildren,\n    locale,\n    defaultLocale,\n    enableI18n,\n    shouldTranslate,\n  });\n\n  // record previous result\n  prev.current = result;\n\n  return result;\n}\n"],"mappings":"kQAYA,SAAS,EAAE,EAA0B,CACnC,OAAO,EAAY,EAAM,CAG3B,SAAS,EAAuB,EAA0B,CACxD,OAAO,EAAY,EAAM,CAI3B,EAAE,KAAO,mBACT,EAAuB,KAAO,6BAO9B,SAAS,EAAY,CACnB,SAAU,EACV,UACA,cACA,mBAAmBA,EAAAA,gBACnB,GAAG,GACiB,CAEpB,GAAM,CACJ,gBACA,SACA,aACA,gBACA,uBACA,oBACA,mBACEC,EAAAA,YAAY,CACd,iBACA,SACA,UACA,cACD,CAAC,CAGI,EAAoBC,EAAAA,aAAa,CACrC,SACA,QAAS,EACT,QAAS,EACV,CAAC,CAII,GAAA,EAAA,EAAA,QAAgC,KAAK,CAC3C,IAAA,EAAA,EAAA,gBACiB,CAAC,uBAAuB,EACvC,GAAqB,MACrB,EAAK,SAAW,MAChB,EAEA,OAAO,EAAK,QAGd,IAAM,EAAS,EAAiB,CAC9B,uBACA,oBACA,SACA,gBACA,aACA,kBACD,CAAC,CAKF,MAFA,GAAK,QAAU,EAER"}
+{"version":3,"file":"T.cjs","names":["renderPreparedT","usePrepareT","useTranslate"],"sources":["../../../src/components/translation/T.tsx"],"sourcesContent":["import { useTranslate } from '../../hooks/external-store';\nimport { getI18nConfig } from 'gt-i18n/internal';\nimport { useRef, type ReactNode } from 'react';\nimport { renderPreparedT } from '../../utils/rendering/renderPipeline';\nimport type { TProps } from '../../utils/translation/prepareT.shared';\nimport { usePrepareT } from '../../utils/translation/usePrepareT';\n\n// ===== Component ===== //\n\n/**\n * External-store version of the `<T>` component.\n */\nfunction T(props: TProps): ReactNode {\n  return useComputeT(props);\n}\n\nfunction GtInternalTranslateJsx(props: TProps): ReactNode {\n  return useComputeT(props);\n}\n\n/** @internal _gtt - The GT transformation for the component. */\nT._gtt = 'translate-client';\nGtInternalTranslateJsx._gtt = 'translate-client-automatic';\n\nexport { GtInternalTranslateJsx, T };\n\n/**\n * Render logic\n */\nfunction useComputeT({\n  children: sourceChildren,\n  _locale,\n  _enableI18n,\n  _renderPreparedT = renderPreparedT,\n  ...params\n}: TProps): ReactNode {\n  // Prepare our source children for rendering\n  const {\n    defaultLocale,\n    locale,\n    enableI18n,\n    targetOptions,\n    taggedSourceChildren,\n    sourceJsxChildren,\n    shouldTranslate,\n  } = usePrepareT({\n    sourceChildren,\n    params,\n    _locale,\n    _enableI18n,\n  });\n\n  // Lookup translation in cache\n  const targetJsxChildren = useTranslate({\n    locale,\n    message: sourceJsxChildren,\n    options: targetOptions,\n  });\n\n  // Tx hot reload: render previous translation while loading new one\n  // TODO: account for success vs loading vs failed request states\n  const prev = useRef<ReactNode | null>(null);\n  if (\n    process.env.NODE_ENV !== 'production' &&\n    getI18nConfig().isDevHotReloadEnabled() &&\n    targetJsxChildren == null &&\n    prev.current != null &&\n    shouldTranslate\n  ) {\n    return prev.current;\n  }\n\n  const result = _renderPreparedT({\n    taggedSourceChildren,\n    targetJsxChildren,\n    locale,\n    defaultLocale,\n    enableI18n,\n    shouldTranslate,\n  });\n\n  // record previous result\n  prev.current = result;\n\n  return result;\n}\n"],"mappings":"kQAYA,SAAS,EAAE,EAA0B,CACnC,OAAO,EAAY,EAAM,CAG3B,SAAS,EAAuB,EAA0B,CACxD,OAAO,EAAY,EAAM,CAI3B,EAAE,KAAO,mBACT,EAAuB,KAAO,6BAO9B,SAAS,EAAY,CACnB,SAAU,EACV,UACA,cACA,mBAAmBA,EAAAA,gBACnB,GAAG,GACiB,CAEpB,GAAM,CACJ,gBACA,SACA,aACA,gBACA,uBACA,oBACA,mBACEC,EAAAA,YAAY,CACd,iBACA,SACA,UACA,cACD,CAAC,CAGI,EAAoBC,EAAAA,aAAa,CACrC,SACA,QAAS,EACT,QAAS,EACV,CAAC,CAII,GAAA,EAAA,EAAA,QAAgC,KAAK,CAC3C,GACE,QAAQ,IAAI,WAAa,eAAA,EAAA,EAAA,gBACV,CAAC,uBAAuB,EACvC,GAAqB,MACrB,EAAK,SAAW,MAChB,EAEA,OAAO,EAAK,QAGd,IAAM,EAAS,EAAiB,CAC9B,uBACA,oBACA,SACA,gBACA,aACA,kBACD,CAAC,CAKF,MAFA,GAAK,QAAU,EAER"}

package/dist/components/translation/T.mjs

@@ -1,2 +1,2 @@
-import{useTranslate as e}from"../../hooks/external-store.mjs";import{renderPreparedT as t}from"../../utils/rendering/renderPipeline.mjs";import{usePrepareT as n}from"../../utils/translation/usePrepareT.mjs";import{useRef as r}from"react";import{getI18nConfig as i}from"gt-i18n/internal";function a(e){return s(e)}function o(e){return s(e)}a._gtt=`translate-client`,o._gtt=`translate-client-automatic`;function s({children:a,_locale:o,_enableI18n:s,_renderPreparedT:c=t,...l}){let{defaultLocale:u,locale:d,enableI18n:f,targetOptions:p,taggedSourceChildren:m,sourceJsxChildren:h,shouldTranslate:g}=n({sourceChildren:a,params:l,_locale:o,_enableI18n:s}),_=e({locale:d,message:h,options:p}),v=r(null);if(i().isDevHotReloadEnabled()&&_==null&&v.current!=null&&g)return v.current;let y=c({taggedSourceChildren:m,targetJsxChildren:_,locale:d,defaultLocale:u,enableI18n:f,shouldTranslate:g});return v.current=y,y}export{o as GtInternalTranslateJsx,a as T};
+import{useTranslate as e}from"../../hooks/external-store.mjs";import{renderPreparedT as t}from"../../utils/rendering/renderPipeline.mjs";import{usePrepareT as n}from"../../utils/translation/usePrepareT.mjs";import{getI18nConfig as r}from"gt-i18n/internal";import{useRef as i}from"react";function a(e){return s(e)}function o(e){return s(e)}a._gtt=`translate-client`,o._gtt=`translate-client-automatic`;function s({children:a,_locale:o,_enableI18n:s,_renderPreparedT:c=t,...l}){let{defaultLocale:u,locale:d,enableI18n:f,targetOptions:p,taggedSourceChildren:m,sourceJsxChildren:h,shouldTranslate:g}=n({sourceChildren:a,params:l,_locale:o,_enableI18n:s}),_=e({locale:d,message:h,options:p}),v=i(null);if(process.env.NODE_ENV!==`production`&&r().isDevHotReloadEnabled()&&_==null&&v.current!=null&&g)return v.current;let y=c({taggedSourceChildren:m,targetJsxChildren:_,locale:d,defaultLocale:u,enableI18n:f,shouldTranslate:g});return v.current=y,y}export{o as GtInternalTranslateJsx,a as T};
 //# sourceMappingURL=T.mjs.map

package/dist/components/translation/T.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"T.mjs","names":[],"sources":["../../../src/components/translation/T.tsx"],"sourcesContent":["import { useTranslate } from '../../hooks/external-store';\nimport { getI18nConfig } from 'gt-i18n/internal';\nimport { useRef, type ReactNode } from 'react';\nimport { renderPreparedT } from '../../utils/rendering/renderPipeline';\nimport type { TProps } from '../../utils/translation/prepareT.shared';\nimport { usePrepareT } from '../../utils/translation/usePrepareT';\n\n// ===== Component ===== //\n\n/**\n * External-store version of the `<T>` component.\n */\nfunction T(props: TProps): ReactNode {\n  return useComputeT(props);\n}\n\nfunction GtInternalTranslateJsx(props: TProps): ReactNode {\n  return useComputeT(props);\n}\n\n/** @internal _gtt - The GT transformation for the component. */\nT._gtt = 'translate-client';\nGtInternalTranslateJsx._gtt = 'translate-client-automatic';\n\nexport { GtInternalTranslateJsx, T };\n\n/**\n * Render logic\n */\nfunction useComputeT({\n  children: sourceChildren,\n  _locale,\n  _enableI18n,\n  _renderPreparedT = renderPreparedT,\n  ...params\n}: TProps): ReactNode {\n  // Prepare our source children for rendering\n  const {\n    defaultLocale,\n    locale,\n    enableI18n,\n    targetOptions,\n    taggedSourceChildren,\n    sourceJsxChildren,\n    shouldTranslate,\n  } = usePrepareT({\n    sourceChildren,\n    params,\n    _locale,\n    _enableI18n,\n  });\n\n  // Lookup translation in cache\n  const targetJsxChildren = useTranslate({\n    locale,\n    message: sourceJsxChildren,\n    options: targetOptions,\n  });\n\n  // Tx hot reload: render previous translation while loading new one\n  // TODO: account for success vs loading vs failed request states\n  const prev = useRef<ReactNode | null>(null);\n  if (\n    getI18nConfig().isDevHotReloadEnabled() &&\n    targetJsxChildren == null &&\n    prev.current != null &&\n    shouldTranslate\n  ) {\n    return prev.current;\n  }\n\n  const result = _renderPreparedT({\n    taggedSourceChildren,\n    targetJsxChildren,\n    locale,\n    defaultLocale,\n    enableI18n,\n    shouldTranslate,\n  });\n\n  // record previous result\n  prev.current = result;\n\n  return result;\n}\n"],"mappings":"+RAYA,SAAS,EAAE,EAA0B,CACnC,OAAO,EAAY,EAAM,CAG3B,SAAS,EAAuB,EAA0B,CACxD,OAAO,EAAY,EAAM,CAI3B,EAAE,KAAO,mBACT,EAAuB,KAAO,6BAO9B,SAAS,EAAY,CACnB,SAAU,EACV,UACA,cACA,mBAAmB,EACnB,GAAG,GACiB,CAEpB,GAAM,CACJ,gBACA,SACA,aACA,gBACA,uBACA,oBACA,mBACE,EAAY,CACd,iBACA,SACA,UACA,cACD,CAAC,CAGI,EAAoB,EAAa,CACrC,SACA,QAAS,EACT,QAAS,EACV,CAAC,CAII,EAAO,EAAyB,KAAK,CAC3C,GACE,GAAe,CAAC,uBAAuB,EACvC,GAAqB,MACrB,EAAK,SAAW,MAChB,EAEA,OAAO,EAAK,QAGd,IAAM,EAAS,EAAiB,CAC9B,uBACA,oBACA,SACA,gBACA,aACA,kBACD,CAAC,CAKF,MAFA,GAAK,QAAU,EAER"}
+{"version":3,"file":"T.mjs","names":[],"sources":["../../../src/components/translation/T.tsx"],"sourcesContent":["import { useTranslate } from '../../hooks/external-store';\nimport { getI18nConfig } from 'gt-i18n/internal';\nimport { useRef, type ReactNode } from 'react';\nimport { renderPreparedT } from '../../utils/rendering/renderPipeline';\nimport type { TProps } from '../../utils/translation/prepareT.shared';\nimport { usePrepareT } from '../../utils/translation/usePrepareT';\n\n// ===== Component ===== //\n\n/**\n * External-store version of the `<T>` component.\n */\nfunction T(props: TProps): ReactNode {\n  return useComputeT(props);\n}\n\nfunction GtInternalTranslateJsx(props: TProps): ReactNode {\n  return useComputeT(props);\n}\n\n/** @internal _gtt - The GT transformation for the component. */\nT._gtt = 'translate-client';\nGtInternalTranslateJsx._gtt = 'translate-client-automatic';\n\nexport { GtInternalTranslateJsx, T };\n\n/**\n * Render logic\n */\nfunction useComputeT({\n  children: sourceChildren,\n  _locale,\n  _enableI18n,\n  _renderPreparedT = renderPreparedT,\n  ...params\n}: TProps): ReactNode {\n  // Prepare our source children for rendering\n  const {\n    defaultLocale,\n    locale,\n    enableI18n,\n    targetOptions,\n    taggedSourceChildren,\n    sourceJsxChildren,\n    shouldTranslate,\n  } = usePrepareT({\n    sourceChildren,\n    params,\n    _locale,\n    _enableI18n,\n  });\n\n  // Lookup translation in cache\n  const targetJsxChildren = useTranslate({\n    locale,\n    message: sourceJsxChildren,\n    options: targetOptions,\n  });\n\n  // Tx hot reload: render previous translation while loading new one\n  // TODO: account for success vs loading vs failed request states\n  const prev = useRef<ReactNode | null>(null);\n  if (\n    process.env.NODE_ENV !== 'production' &&\n    getI18nConfig().isDevHotReloadEnabled() &&\n    targetJsxChildren == null &&\n    prev.current != null &&\n    shouldTranslate\n  ) {\n    return prev.current;\n  }\n\n  const result = _renderPreparedT({\n    taggedSourceChildren,\n    targetJsxChildren,\n    locale,\n    defaultLocale,\n    enableI18n,\n    shouldTranslate,\n  });\n\n  // record previous result\n  prev.current = result;\n\n  return result;\n}\n"],"mappings":"+RAYA,SAAS,EAAE,EAA0B,CACnC,OAAO,EAAY,EAAM,CAG3B,SAAS,EAAuB,EAA0B,CACxD,OAAO,EAAY,EAAM,CAI3B,EAAE,KAAO,mBACT,EAAuB,KAAO,6BAO9B,SAAS,EAAY,CACnB,SAAU,EACV,UACA,cACA,mBAAmB,EACnB,GAAG,GACiB,CAEpB,GAAM,CACJ,gBACA,SACA,aACA,gBACA,uBACA,oBACA,mBACE,EAAY,CACd,iBACA,SACA,UACA,cACD,CAAC,CAGI,EAAoB,EAAa,CACrC,SACA,QAAS,EACT,QAAS,EACV,CAAC,CAII,EAAO,EAAyB,KAAK,CAC3C,GACE,QAAQ,IAAI,WAAa,cACzB,GAAe,CAAC,uBAAuB,EACvC,GAAqB,MACrB,EAAK,SAAW,MAChB,EAEA,OAAO,EAAK,QAGd,IAAM,EAAS,EAAiB,CAC9B,uBACA,oBACA,SACA,gBACA,aACA,kBACD,CAAC,CAKF,MAFA,GAAK,QAAU,EAER"}

package/dist/components/translation/T.rsc.cjs

@@ -1,2 +1,2 @@
-require(`../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../i18n-cache/singleton-operations.cjs`),t=require(`../../utils/translation/prepareT.shared.cjs`),n=require(`../../utils/rendering/renderPipeline.rsc.cjs`);let r=require(`gt-i18n/internal`);async function i({children:i,_locale:a,_enableI18n:o,_renderPreparedT:s=n.renderPreparedT,...c}){let l=a,u=o,d=(0,r.getI18nConfig)().getDefaultLocale(),f=u&&(0,r.getI18nConfig)().requiresTranslation(l),p=t.prepareT({sourceChildren:i,params:c,locale:l});if(!f)return s({...p,targetJsxChildren:void 0,locale:l,defaultLocale:d,enableI18n:u,shouldTranslate:f});let m,h=e.getReactI18nCache();return m=(0,r.getI18nConfig)().isDevHotReloadEnabled()?await h.lookupTranslationWithFallback(l,p.sourceJsxChildren,p.targetOptions):(await h.getLookupTranslation(l))(p.sourceJsxChildren,p.targetOptions),s({...p,targetJsxChildren:m,locale:l,defaultLocale:d,enableI18n:u,shouldTranslate:f})}i._gtt=`translate-server`,exports.RscT=i;
+require(`../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../i18n-cache/singleton-operations.cjs`),t=require(`../../utils/translation/prepareT.shared.cjs`),n=require(`../../utils/rendering/renderPipeline.rsc.cjs`);let r=require(`gt-i18n/internal`);async function i({children:i,_locale:a,_enableI18n:o,_renderPreparedT:s=n.renderPreparedT,...c}){let l=a,u=o,d=(0,r.getI18nConfig)().getDefaultLocale(),f=u&&(0,r.getI18nConfig)().requiresTranslation(l),p=t.prepareT({sourceChildren:i,params:c,locale:l});if(!f)return s({...p,targetJsxChildren:void 0,locale:l,defaultLocale:d,enableI18n:u,shouldTranslate:f});let m,h=e.getReactI18nCache();return m=process.env.NODE_ENV!==`production`&&(0,r.getI18nConfig)().isDevHotReloadEnabled()?await h.lookupTranslationWithFallback(l,p.sourceJsxChildren,p.targetOptions):(await h.getLookupTranslation(l))(p.sourceJsxChildren,p.targetOptions),s({...p,targetJsxChildren:m,locale:l,defaultLocale:d,enableI18n:u,shouldTranslate:f})}i._gtt=`translate-server`,exports.RscT=i;
 //# sourceMappingURL=T.rsc.cjs.map

package/dist/components/translation/T.rsc.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"T.rsc.cjs","names":["renderPreparedT","prepareT","getReactI18nCache"],"sources":["../../../src/components/translation/T.rsc.tsx"],"sourcesContent":["import { getI18nConfig } from 'gt-i18n/internal';\nimport type { ReactNode } from 'react';\nimport { getReactI18nCache } from '../../i18n-cache/singleton-operations';\nimport { renderPreparedT } from '../../utils/rendering/renderPipeline.rsc';\nimport {\n  prepareT,\n  type ResolvedTProps,\n} from '../../utils/translation/prepareT.shared';\nimport { JsxChildren } from '@generaltranslation/format/types';\n\n// RSC implementation: request conditions are passed explicitly instead of\n// being read from hooks. This module must stay free of hook/context imports\n// so it can be exported from the components-rsc entrypoint.\n\nasync function RscT({\n  children: sourceChildren,\n  _locale,\n  _enableI18n,\n  // TODO: don't expose to consumer, this should be thru an internal path\n  _renderPreparedT = renderPreparedT,\n  ...params\n}: ResolvedTProps): Promise<ReactNode> {\n  const locale = _locale;\n  const enableI18n = _enableI18n;\n  const defaultLocale = getI18nConfig().getDefaultLocale();\n  const shouldTranslate =\n    enableI18n && getI18nConfig().requiresTranslation(locale);\n  const prepared = prepareT({\n    sourceChildren,\n    params,\n    locale,\n  });\n\n  if (!shouldTranslate) {\n    return _renderPreparedT({\n      ...prepared,\n      targetJsxChildren: undefined,\n      locale,\n      defaultLocale,\n      enableI18n,\n      shouldTranslate,\n    });\n  }\n\n  let targetJsxChildren: JsxChildren | undefined;\n  const i18nCache = getReactI18nCache();\n  if (getI18nConfig().isDevHotReloadEnabled()) {\n    targetJsxChildren = await i18nCache.lookupTranslationWithFallback(\n      locale,\n      prepared.sourceJsxChildren,\n      prepared.targetOptions\n    );\n  } else {\n    const lookupTranslation = await i18nCache.getLookupTranslation(locale);\n    targetJsxChildren = lookupTranslation(\n      prepared.sourceJsxChildren,\n      prepared.targetOptions\n    );\n  }\n\n  return _renderPreparedT({\n    ...prepared,\n    targetJsxChildren,\n    locale,\n    defaultLocale,\n    enableI18n,\n    shouldTranslate,\n  });\n}\n\n/** @internal _gtt - The GT transformation for the component. */\nRscT._gtt = 'translate-server';\n\n// ===== Exports ===== //\n\nexport { RscT };\n"],"mappings":"kQAcA,eAAe,EAAK,CAClB,SAAU,EACV,UACA,cAEA,mBAAmBA,EAAAA,gBACnB,GAAG,GACkC,CACrC,IAAM,EAAS,EACT,EAAa,EACb,GAAA,EAAA,EAAA,gBAA+B,CAAC,kBAAkB,CAClD,EACJ,IAAA,EAAA,EAAA,gBAA6B,CAAC,oBAAoB,EAAO,CACrD,EAAWC,EAAAA,SAAS,CACxB,iBACA,SACA,SACD,CAAC,CAEF,GAAI,CAAC,EACH,OAAO,EAAiB,CACtB,GAAG,EACH,kBAAmB,IAAA,GACnB,SACA,gBACA,aACA,kBACD,CAAC,CAGJ,IAAI,EACE,EAAYC,EAAAA,mBAAmB,CAerC,MAdA,CAQE,GARF,EAAA,EAAA,gBAAmB,CAAC,uBAAuB,CACrB,MAAM,EAAU,8BAClC,EACA,EAAS,kBACT,EAAS,cACV,EAGmB,MADY,EAAU,qBAAqB,EAAO,EAEpE,EAAS,kBACT,EAAS,cACV,CAGI,EAAiB,CACtB,GAAG,EACH,oBACA,SACA,gBACA,aACA,kBACD,CAAC,CAIJ,EAAK,KAAO"}
+{"version":3,"file":"T.rsc.cjs","names":["renderPreparedT","prepareT","getReactI18nCache"],"sources":["../../../src/components/translation/T.rsc.tsx"],"sourcesContent":["import { getI18nConfig } from 'gt-i18n/internal';\nimport type { ReactNode } from 'react';\nimport { getReactI18nCache } from '../../i18n-cache/singleton-operations';\nimport { renderPreparedT } from '../../utils/rendering/renderPipeline.rsc';\nimport {\n  prepareT,\n  type ResolvedTProps,\n} from '../../utils/translation/prepareT.shared';\nimport { JsxChildren } from '@generaltranslation/format/types';\n\n// RSC implementation: request conditions are passed explicitly instead of\n// being read from hooks. This module must stay free of hook/context imports\n// so it can be exported from the components-rsc entrypoint.\n\nasync function RscT({\n  children: sourceChildren,\n  _locale,\n  _enableI18n,\n  // TODO: don't expose to consumer, this should be thru an internal path\n  _renderPreparedT = renderPreparedT,\n  ...params\n}: ResolvedTProps): Promise<ReactNode> {\n  const locale = _locale;\n  const enableI18n = _enableI18n;\n  const defaultLocale = getI18nConfig().getDefaultLocale();\n  const shouldTranslate =\n    enableI18n && getI18nConfig().requiresTranslation(locale);\n  const prepared = prepareT({\n    sourceChildren,\n    params,\n    locale,\n  });\n\n  if (!shouldTranslate) {\n    return _renderPreparedT({\n      ...prepared,\n      targetJsxChildren: undefined,\n      locale,\n      defaultLocale,\n      enableI18n,\n      shouldTranslate,\n    });\n  }\n\n  let targetJsxChildren: JsxChildren | undefined;\n  const i18nCache = getReactI18nCache();\n  if (\n    process.env.NODE_ENV !== 'production' &&\n    getI18nConfig().isDevHotReloadEnabled()\n  ) {\n    targetJsxChildren = await i18nCache.lookupTranslationWithFallback(\n      locale,\n      prepared.sourceJsxChildren,\n      prepared.targetOptions\n    );\n  } else {\n    const lookupTranslation = await i18nCache.getLookupTranslation(locale);\n    targetJsxChildren = lookupTranslation(\n      prepared.sourceJsxChildren,\n      prepared.targetOptions\n    );\n  }\n\n  return _renderPreparedT({\n    ...prepared,\n    targetJsxChildren,\n    locale,\n    defaultLocale,\n    enableI18n,\n    shouldTranslate,\n  });\n}\n\n/** @internal _gtt - The GT transformation for the component. */\nRscT._gtt = 'translate-server';\n\n// ===== Exports ===== //\n\nexport { RscT };\n"],"mappings":"kQAcA,eAAe,EAAK,CAClB,SAAU,EACV,UACA,cAEA,mBAAmBA,EAAAA,gBACnB,GAAG,GACkC,CACrC,IAAM,EAAS,EACT,EAAa,EACb,GAAA,EAAA,EAAA,gBAA+B,CAAC,kBAAkB,CAClD,EACJ,IAAA,EAAA,EAAA,gBAA6B,CAAC,oBAAoB,EAAO,CACrD,EAAWC,EAAAA,SAAS,CACxB,iBACA,SACA,SACD,CAAC,CAEF,GAAI,CAAC,EACH,OAAO,EAAiB,CACtB,GAAG,EACH,kBAAmB,IAAA,GACnB,SACA,gBACA,aACA,kBACD,CAAC,CAGJ,IAAI,EACE,EAAYC,EAAAA,mBAAmB,CAkBrC,MAjBA,CAWE,EAVA,QAAQ,IAAI,WAAa,eAAA,EAAA,EAAA,gBACV,CAAC,uBAAuB,CAEnB,MAAM,EAAU,8BAClC,EACA,EAAS,kBACT,EAAS,cACV,EAGmB,MADY,EAAU,qBAAqB,EAAO,EAEpE,EAAS,kBACT,EAAS,cACV,CAGI,EAAiB,CACtB,GAAG,EACH,oBACA,SACA,gBACA,aACA,kBACD,CAAC,CAIJ,EAAK,KAAO"}

package/dist/components/translation/T.rsc.mjs

@@ -1,2 +1,2 @@
-import{getReactI18nCache as e}from"../../i18n-cache/singleton-operations.mjs";import{prepareT as t}from"../../utils/translation/prepareT.shared.mjs";import{renderPreparedT as n}from"../../utils/rendering/renderPipeline.rsc.mjs";import{getI18nConfig as r}from"gt-i18n/internal";async function i({children:i,_locale:a,_enableI18n:o,_renderPreparedT:s=n,...c}){let l=a,u=o,d=r().getDefaultLocale(),f=u&&r().requiresTranslation(l),p=t({sourceChildren:i,params:c,locale:l});if(!f)return s({...p,targetJsxChildren:void 0,locale:l,defaultLocale:d,enableI18n:u,shouldTranslate:f});let m,h=e();return m=r().isDevHotReloadEnabled()?await h.lookupTranslationWithFallback(l,p.sourceJsxChildren,p.targetOptions):(await h.getLookupTranslation(l))(p.sourceJsxChildren,p.targetOptions),s({...p,targetJsxChildren:m,locale:l,defaultLocale:d,enableI18n:u,shouldTranslate:f})}i._gtt=`translate-server`;export{i as RscT};
+import{getReactI18nCache as e}from"../../i18n-cache/singleton-operations.mjs";import{prepareT as t}from"../../utils/translation/prepareT.shared.mjs";import{renderPreparedT as n}from"../../utils/rendering/renderPipeline.rsc.mjs";import{getI18nConfig as r}from"gt-i18n/internal";async function i({children:i,_locale:a,_enableI18n:o,_renderPreparedT:s=n,...c}){let l=a,u=o,d=r().getDefaultLocale(),f=u&&r().requiresTranslation(l),p=t({sourceChildren:i,params:c,locale:l});if(!f)return s({...p,targetJsxChildren:void 0,locale:l,defaultLocale:d,enableI18n:u,shouldTranslate:f});let m,h=e();return m=process.env.NODE_ENV!==`production`&&r().isDevHotReloadEnabled()?await h.lookupTranslationWithFallback(l,p.sourceJsxChildren,p.targetOptions):(await h.getLookupTranslation(l))(p.sourceJsxChildren,p.targetOptions),s({...p,targetJsxChildren:m,locale:l,defaultLocale:d,enableI18n:u,shouldTranslate:f})}i._gtt=`translate-server`;export{i as RscT};
 //# sourceMappingURL=T.rsc.mjs.map

package/dist/components/translation/T.rsc.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"T.rsc.mjs","names":[],"sources":["../../../src/components/translation/T.rsc.tsx"],"sourcesContent":["import { getI18nConfig } from 'gt-i18n/internal';\nimport type { ReactNode } from 'react';\nimport { getReactI18nCache } from '../../i18n-cache/singleton-operations';\nimport { renderPreparedT } from '../../utils/rendering/renderPipeline.rsc';\nimport {\n  prepareT,\n  type ResolvedTProps,\n} from '../../utils/translation/prepareT.shared';\nimport { JsxChildren } from '@generaltranslation/format/types';\n\n// RSC implementation: request conditions are passed explicitly instead of\n// being read from hooks. This module must stay free of hook/context imports\n// so it can be exported from the components-rsc entrypoint.\n\nasync function RscT({\n  children: sourceChildren,\n  _locale,\n  _enableI18n,\n  // TODO: don't expose to consumer, this should be thru an internal path\n  _renderPreparedT = renderPreparedT,\n  ...params\n}: ResolvedTProps): Promise<ReactNode> {\n  const locale = _locale;\n  const enableI18n = _enableI18n;\n  const defaultLocale = getI18nConfig().getDefaultLocale();\n  const shouldTranslate =\n    enableI18n && getI18nConfig().requiresTranslation(locale);\n  const prepared = prepareT({\n    sourceChildren,\n    params,\n    locale,\n  });\n\n  if (!shouldTranslate) {\n    return _renderPreparedT({\n      ...prepared,\n      targetJsxChildren: undefined,\n      locale,\n      defaultLocale,\n      enableI18n,\n      shouldTranslate,\n    });\n  }\n\n  let targetJsxChildren: JsxChildren | undefined;\n  const i18nCache = getReactI18nCache();\n  if (getI18nConfig().isDevHotReloadEnabled()) {\n    targetJsxChildren = await i18nCache.lookupTranslationWithFallback(\n      locale,\n      prepared.sourceJsxChildren,\n      prepared.targetOptions\n    );\n  } else {\n    const lookupTranslation = await i18nCache.getLookupTranslation(locale);\n    targetJsxChildren = lookupTranslation(\n      prepared.sourceJsxChildren,\n      prepared.targetOptions\n    );\n  }\n\n  return _renderPreparedT({\n    ...prepared,\n    targetJsxChildren,\n    locale,\n    defaultLocale,\n    enableI18n,\n    shouldTranslate,\n  });\n}\n\n/** @internal _gtt - The GT transformation for the component. */\nRscT._gtt = 'translate-server';\n\n// ===== Exports ===== //\n\nexport { RscT };\n"],"mappings":"qRAcA,eAAe,EAAK,CAClB,SAAU,EACV,UACA,cAEA,mBAAmB,EACnB,GAAG,GACkC,CACrC,IAAM,EAAS,EACT,EAAa,EACb,EAAgB,GAAe,CAAC,kBAAkB,CAClD,EACJ,GAAc,GAAe,CAAC,oBAAoB,EAAO,CACrD,EAAW,EAAS,CACxB,iBACA,SACA,SACD,CAAC,CAEF,GAAI,CAAC,EACH,OAAO,EAAiB,CACtB,GAAG,EACH,kBAAmB,IAAA,GACnB,SACA,gBACA,aACA,kBACD,CAAC,CAGJ,IAAI,EACE,EAAY,GAAmB,CAerC,MAdA,CAQE,EARE,GAAe,CAAC,uBAAuB,CACrB,MAAM,EAAU,8BAClC,EACA,EAAS,kBACT,EAAS,cACV,EAGmB,MADY,EAAU,qBAAqB,EAAO,EAEpE,EAAS,kBACT,EAAS,cACV,CAGI,EAAiB,CACtB,GAAG,EACH,oBACA,SACA,gBACA,aACA,kBACD,CAAC,CAIJ,EAAK,KAAO"}
+{"version":3,"file":"T.rsc.mjs","names":[],"sources":["../../../src/components/translation/T.rsc.tsx"],"sourcesContent":["import { getI18nConfig } from 'gt-i18n/internal';\nimport type { ReactNode } from 'react';\nimport { getReactI18nCache } from '../../i18n-cache/singleton-operations';\nimport { renderPreparedT } from '../../utils/rendering/renderPipeline.rsc';\nimport {\n  prepareT,\n  type ResolvedTProps,\n} from '../../utils/translation/prepareT.shared';\nimport { JsxChildren } from '@generaltranslation/format/types';\n\n// RSC implementation: request conditions are passed explicitly instead of\n// being read from hooks. This module must stay free of hook/context imports\n// so it can be exported from the components-rsc entrypoint.\n\nasync function RscT({\n  children: sourceChildren,\n  _locale,\n  _enableI18n,\n  // TODO: don't expose to consumer, this should be thru an internal path\n  _renderPreparedT = renderPreparedT,\n  ...params\n}: ResolvedTProps): Promise<ReactNode> {\n  const locale = _locale;\n  const enableI18n = _enableI18n;\n  const defaultLocale = getI18nConfig().getDefaultLocale();\n  const shouldTranslate =\n    enableI18n && getI18nConfig().requiresTranslation(locale);\n  const prepared = prepareT({\n    sourceChildren,\n    params,\n    locale,\n  });\n\n  if (!shouldTranslate) {\n    return _renderPreparedT({\n      ...prepared,\n      targetJsxChildren: undefined,\n      locale,\n      defaultLocale,\n      enableI18n,\n      shouldTranslate,\n    });\n  }\n\n  let targetJsxChildren: JsxChildren | undefined;\n  const i18nCache = getReactI18nCache();\n  if (\n    process.env.NODE_ENV !== 'production' &&\n    getI18nConfig().isDevHotReloadEnabled()\n  ) {\n    targetJsxChildren = await i18nCache.lookupTranslationWithFallback(\n      locale,\n      prepared.sourceJsxChildren,\n      prepared.targetOptions\n    );\n  } else {\n    const lookupTranslation = await i18nCache.getLookupTranslation(locale);\n    targetJsxChildren = lookupTranslation(\n      prepared.sourceJsxChildren,\n      prepared.targetOptions\n    );\n  }\n\n  return _renderPreparedT({\n    ...prepared,\n    targetJsxChildren,\n    locale,\n    defaultLocale,\n    enableI18n,\n    shouldTranslate,\n  });\n}\n\n/** @internal _gtt - The GT transformation for the component. */\nRscT._gtt = 'translate-server';\n\n// ===== Exports ===== //\n\nexport { RscT };\n"],"mappings":"qRAcA,eAAe,EAAK,CAClB,SAAU,EACV,UACA,cAEA,mBAAmB,EACnB,GAAG,GACkC,CACrC,IAAM,EAAS,EACT,EAAa,EACb,EAAgB,GAAe,CAAC,kBAAkB,CAClD,EACJ,GAAc,GAAe,CAAC,oBAAoB,EAAO,CACrD,EAAW,EAAS,CACxB,iBACA,SACA,SACD,CAAC,CAEF,GAAI,CAAC,EACH,OAAO,EAAiB,CACtB,GAAG,EACH,kBAAmB,IAAA,GACnB,SACA,gBACA,aACA,kBACD,CAAC,CAGJ,IAAI,EACE,EAAY,GAAmB,CAkBrC,MAjBA,CAWE,EAVA,QAAQ,IAAI,WAAa,cACzB,GAAe,CAAC,uBAAuB,CAEnB,MAAM,EAAU,8BAClC,EACA,EAAS,kBACT,EAAS,cACV,EAGmB,MADY,EAAU,qBAAqB,EAAO,EAEpE,EAAS,kBACT,EAAS,cACV,CAGI,EAAiB,CACtB,GAAG,EACH,oBACA,SACA,gBACA,aACA,kBACD,CAAC,CAIJ,EAAK,KAAO"}

package/dist/components-rsc.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./utils/plurals/getPluralBranch.cjs`),t=require(`./hooks/utils/getFormatLocales.cjs`),n=require(`./i18n-cache/singleton-operations.cjs`),r=require(`./functions/helpers/getTranslationsSnapshot.cjs`),i=require(`./condition-store/singleton-operations.cjs`),a=require(`./hooks/utils/getShouldTranslate.cjs`),o=require(`./functions/translation/t.cjs`),s=require(`./utils/rendering/createRenderVariable.cjs`),c=require(`./utils/rendering/createRenderPipeline.cjs`),l=require(`./setup/initializeGTSRA.cjs`),u=require(`./components/branches/Branch.cjs`),d=require(`./components/derivation/Derive.cjs`),f=require(`./components/variables/Var.cjs`),p=require(`./utils/translation/prepareT.shared.cjs`),m=require(`./components/branches/Plural.rsc.cjs`),h=require(`./components/variables/Currency.rsc.cjs`),g=require(`./components/variables/DateTime.rsc.cjs`),_=require(`./components/variables/Num.rsc.cjs`),v=require(`./components/variables/RelativeTime.rsc.cjs`),y=require(`./utils/rendering/renderPipeline.rsc.cjs`),b=require(`./components/translation/T.rsc.cjs`),x=require(`./components/translation/Tx.rsc.cjs`);exports.Branch=u.Branch,exports.Currency=h.RscCurrency,exports.DateTime=g.RscDateTime,exports.Derive=d.Derive,exports.GtInternalBranch=u.GtInternalBranch,exports.GtInternalCurrency=h.RscGtInternalCurrency,exports.GtInternalDateTime=g.RscGtInternalDateTime,exports.GtInternalDerive=d.GtInternalDerive,exports.GtInternalNum=_.RscGtInternalNum,exports.GtInternalPlural=m.RscGtInternalPlural,exports.GtInternalRelativeTime=v.RscGtInternalRelativeTime,exports.GtInternalVar=f.GtInternalVar,exports.Num=_.RscNum,exports.Plural=m.RscPlural,exports.RelativeTime=v.RscRelativeTime,exports.T=b.RscT,exports.Tx=x.RscTx,exports.Var=f.Var,exports.createRenderPipeline=c.createRenderPipeline,exports.createRenderVariable=s.createRenderVariable,exports.getFormatLocales=t.getFormatLocales,exports.getPluralBranch=e.getPluralBranch,exports.getReactI18nCache=n.getReactI18nCache,exports.getReadonlyConditionStoreWithFallback=i.getReadonlyConditionStoreWithFallback,exports.getShouldTranslate=a.getShouldTranslate,exports.getTranslationsSnapshot=r.getTranslationsSnapshot,exports.internalInitializeGTSRA=l.internalInitializeGTSRA,exports.prepareT=p.prepareT,exports.renderDefaultChildren=y.renderDefaultChildren,exports.renderPreparedT=y.renderPreparedT,exports.renderTranslatedChildren=y.renderTranslatedChildren,exports.renderVariable=y.renderVariable,exports.setReactI18nCache=n.setReactI18nCache,exports.t=o.t;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./hooks/utils/getFormatLocales.cjs`),t=require(`./i18n-cache/singleton-operations.cjs`),n=require(`./functions/helpers/getTranslationsSnapshot.cjs`),r=require(`./condition-store/singleton-operations.cjs`),i=require(`./hooks/utils/getShouldTranslate.cjs`),a=require(`./functions/translation/t.cjs`),o=require(`./utils/rendering/createRenderVariable.cjs`),s=require(`./utils/plurals/getPluralBranch.cjs`),c=require(`./utils/rendering/createRenderPipeline.cjs`),l=require(`./setup/initializeGTSRA.cjs`),u=require(`./components/branches/Branch.cjs`),d=require(`./components/derivation/Derive.cjs`),f=require(`./components/variables/Var.cjs`),p=require(`./utils/translation/prepareT.shared.cjs`),m=require(`./components/branches/Plural.rsc.cjs`),h=require(`./components/variables/Currency.rsc.cjs`),g=require(`./components/variables/DateTime.rsc.cjs`),_=require(`./components/variables/Num.rsc.cjs`),v=require(`./components/variables/RelativeTime.rsc.cjs`),y=require(`./utils/rendering/renderPipeline.rsc.cjs`),b=require(`./components/translation/T.rsc.cjs`),x=require(`./components/translation/Tx.rsc.cjs`);exports.Branch=u.Branch,exports.Currency=h.RscCurrency,exports.DateTime=g.RscDateTime,exports.Derive=d.Derive,exports.GtInternalBranch=u.GtInternalBranch,exports.GtInternalCurrency=h.RscGtInternalCurrency,exports.GtInternalDateTime=g.RscGtInternalDateTime,exports.GtInternalDerive=d.GtInternalDerive,exports.GtInternalNum=_.RscGtInternalNum,exports.GtInternalPlural=m.RscGtInternalPlural,exports.GtInternalRelativeTime=v.RscGtInternalRelativeTime,exports.GtInternalVar=f.GtInternalVar,exports.Num=_.RscNum,exports.Plural=m.RscPlural,exports.RelativeTime=v.RscRelativeTime,exports.T=b.RscT,exports.Tx=x.RscTx,exports.Var=f.Var,exports.createRenderPipeline=c.createRenderPipeline,exports.createRenderVariable=o.createRenderVariable,exports.getFormatLocales=e.getFormatLocales,exports.getPluralBranch=s.getPluralBranch,exports.getReactI18nCache=t.getReactI18nCache,exports.getReadonlyConditionStore=r.getConditionStore,exports.getShouldTranslate=i.getShouldTranslate,exports.getTranslationsSnapshot=n.getTranslationsSnapshot,exports.internalInitializeGTSRA=l.internalInitializeGTSRA,exports.prepareT=p.prepareT,exports.renderDefaultChildren=y.renderDefaultChildren,exports.renderPreparedT=y.renderPreparedT,exports.renderTranslatedChildren=y.renderTranslatedChildren,exports.renderVariable=y.renderVariable,exports.setReactI18nCache=t.setReactI18nCache,exports.t=a.t;

package/dist/components-rsc.d.ts

@@ -20,13 +20,13 @@ import { RscT } from "./components/translation/T.rsc.js";
 import { RscTx } from "./components/translation/Tx.rsc.js";
 import { getTranslationsSnapshot } from "./functions/helpers/getTranslationsSnapshot.js";
 import { t } from "./functions/translation/t.js";
-import { getPluralBranch } from "./utils/plurals/getPluralBranch.js";
 import { getFormatLocales } from "./hooks/utils/getFormatLocales.js";
 import { createRenderVariable } from "./utils/rendering/createRenderVariable.js";
 import { RenderPipeline, createRenderPipeline } from "./utils/rendering/createRenderPipeline.js";
 import { getReactI18nCache, setReactI18nCache } from "./i18n-cache/singleton-operations.js";
 import { internalInitializeGTSRA } from "./setup/initializeGTSRA.js";
-import { getReadonlyConditionStoreWithFallback } from "./condition-store/singleton-operations.js";
+import { getConditionStore } from "./condition-store/singleton-operations.js";
+import { getPluralBranch } from "./utils/plurals/getPluralBranch.js";
 import { getShouldTranslate } from "./hooks/utils/getShouldTranslate.js";
 import { renderDefaultChildren, renderPreparedT, renderTranslatedChildren, renderVariable } from "./utils/rendering/renderPipeline.rsc.js";
-export { Branch, RscCurrency as Currency, type CurrencyProps, RscDateTime as DateTime, type DateTimeProps, Derive, GtInternalBranch, RscGtInternalCurrency as GtInternalCurrency, RscGtInternalDateTime as GtInternalDateTime, GtInternalDerive, RscGtInternalNum as GtInternalNum, RscGtInternalPlural as GtInternalPlural, RscGtInternalRelativeTime as GtInternalRelativeTime, GtInternalVar, type JsxTranslationOptions, RscNum as Num, type NumProps, RscPlural as Plural, type PluralProps, type PreparedT, RscRelativeTime as RelativeTime, type RelativeTimeFormatOptions, type RelativeTimeProps, type RenderDefaultChildrenArgs, type RenderPipeline, type RenderPreparedTParams, type RenderTranslatedChildrenArgs, type RenderVariable, type ResolvedCurrencyProps, type ResolvedDateTimeProps, type ResolvedNumProps, type ResolvedPluralProps, type ResolvedRelativeTimeProps, RscT as T, RscTx as Tx, Var, createRenderPipeline, createRenderVariable, getFormatLocales, getPluralBranch, getReactI18nCache, getReadonlyConditionStoreWithFallback, getShouldTranslate, getTranslationsSnapshot, internalInitializeGTSRA, prepareT, renderDefaultChildren, renderPreparedT, renderTranslatedChildren, renderVariable, setReactI18nCache, t };
+export { Branch, RscCurrency as Currency, type CurrencyProps, RscDateTime as DateTime, type DateTimeProps, Derive, GtInternalBranch, RscGtInternalCurrency as GtInternalCurrency, RscGtInternalDateTime as GtInternalDateTime, GtInternalDerive, RscGtInternalNum as GtInternalNum, RscGtInternalPlural as GtInternalPlural, RscGtInternalRelativeTime as GtInternalRelativeTime, GtInternalVar, type JsxTranslationOptions, RscNum as Num, type NumProps, RscPlural as Plural, type PluralProps, type PreparedT, RscRelativeTime as RelativeTime, type RelativeTimeFormatOptions, type RelativeTimeProps, type RenderDefaultChildrenArgs, type RenderPipeline, type RenderPreparedTParams, type RenderTranslatedChildrenArgs, type RenderVariable, type ResolvedCurrencyProps, type ResolvedDateTimeProps, type ResolvedNumProps, type ResolvedPluralProps, type ResolvedRelativeTimeProps, RscT as T, RscTx as Tx, Var, createRenderPipeline, createRenderVariable, getFormatLocales, getPluralBranch, getReactI18nCache, getConditionStore as getReadonlyConditionStore, getShouldTranslate, getTranslationsSnapshot, internalInitializeGTSRA, prepareT, renderDefaultChildren, renderPreparedT, renderTranslatedChildren, renderVariable, setReactI18nCache, t };

package/dist/components-rsc.mjs

@@ -1 +1 @@
-import{getPluralBranch as e}from"./utils/plurals/getPluralBranch.mjs";import{getFormatLocales as t}from"./hooks/utils/getFormatLocales.mjs";import{getReactI18nCache as n,setReactI18nCache as r}from"./i18n-cache/singleton-operations.mjs";import{getTranslationsSnapshot as i}from"./functions/helpers/getTranslationsSnapshot.mjs";import{getReadonlyConditionStoreWithFallback as a}from"./condition-store/singleton-operations.mjs";import{getShouldTranslate as o}from"./hooks/utils/getShouldTranslate.mjs";import{t as s}from"./functions/translation/t.mjs";import{createRenderVariable as c}from"./utils/rendering/createRenderVariable.mjs";import{createRenderPipeline as l}from"./utils/rendering/createRenderPipeline.mjs";import{internalInitializeGTSRA as u}from"./setup/initializeGTSRA.mjs";import{Branch as d,GtInternalBranch as f}from"./components/branches/Branch.mjs";import{Derive as p,GtInternalDerive as m}from"./components/derivation/Derive.mjs";import{GtInternalVar as h,Var as g}from"./components/variables/Var.mjs";import{prepareT as _}from"./utils/translation/prepareT.shared.mjs";import{RscGtInternalPlural as v,RscPlural as y}from"./components/branches/Plural.rsc.mjs";import{RscCurrency as b,RscGtInternalCurrency as x}from"./components/variables/Currency.rsc.mjs";import{RscDateTime as S,RscGtInternalDateTime as C}from"./components/variables/DateTime.rsc.mjs";import{RscGtInternalNum as w,RscNum as T}from"./components/variables/Num.rsc.mjs";import{RscGtInternalRelativeTime as E,RscRelativeTime as D}from"./components/variables/RelativeTime.rsc.mjs";import{renderDefaultChildren as O,renderPreparedT as k,renderTranslatedChildren as A,renderVariable as j}from"./utils/rendering/renderPipeline.rsc.mjs";import{RscT as M}from"./components/translation/T.rsc.mjs";import{RscTx as N}from"./components/translation/Tx.rsc.mjs";export{d as Branch,b as Currency,S as DateTime,p as Derive,f as GtInternalBranch,x as GtInternalCurrency,C as GtInternalDateTime,m as GtInternalDerive,w as GtInternalNum,v as GtInternalPlural,E as GtInternalRelativeTime,h as GtInternalVar,T as Num,y as Plural,D as RelativeTime,M as T,N as Tx,g as Var,l as createRenderPipeline,c as createRenderVariable,t as getFormatLocales,e as getPluralBranch,n as getReactI18nCache,a as getReadonlyConditionStoreWithFallback,o as getShouldTranslate,i as getTranslationsSnapshot,u as internalInitializeGTSRA,_ as prepareT,O as renderDefaultChildren,k as renderPreparedT,A as renderTranslatedChildren,j as renderVariable,r as setReactI18nCache,s as t};
+import{getFormatLocales as e}from"./hooks/utils/getFormatLocales.mjs";import{getReactI18nCache as t,setReactI18nCache as n}from"./i18n-cache/singleton-operations.mjs";import{getTranslationsSnapshot as r}from"./functions/helpers/getTranslationsSnapshot.mjs";import{getConditionStore as i}from"./condition-store/singleton-operations.mjs";import{getShouldTranslate as a}from"./hooks/utils/getShouldTranslate.mjs";import{t as o}from"./functions/translation/t.mjs";import{createRenderVariable as s}from"./utils/rendering/createRenderVariable.mjs";import{getPluralBranch as c}from"./utils/plurals/getPluralBranch.mjs";import{createRenderPipeline as l}from"./utils/rendering/createRenderPipeline.mjs";import{internalInitializeGTSRA as u}from"./setup/initializeGTSRA.mjs";import{Branch as d,GtInternalBranch as f}from"./components/branches/Branch.mjs";import{Derive as p,GtInternalDerive as m}from"./components/derivation/Derive.mjs";import{GtInternalVar as h,Var as g}from"./components/variables/Var.mjs";import{prepareT as _}from"./utils/translation/prepareT.shared.mjs";import{RscGtInternalPlural as v,RscPlural as y}from"./components/branches/Plural.rsc.mjs";import{RscCurrency as b,RscGtInternalCurrency as x}from"./components/variables/Currency.rsc.mjs";import{RscDateTime as S,RscGtInternalDateTime as C}from"./components/variables/DateTime.rsc.mjs";import{RscGtInternalNum as w,RscNum as T}from"./components/variables/Num.rsc.mjs";import{RscGtInternalRelativeTime as E,RscRelativeTime as D}from"./components/variables/RelativeTime.rsc.mjs";import{renderDefaultChildren as O,renderPreparedT as k,renderTranslatedChildren as A,renderVariable as j}from"./utils/rendering/renderPipeline.rsc.mjs";import{RscT as M}from"./components/translation/T.rsc.mjs";import{RscTx as N}from"./components/translation/Tx.rsc.mjs";export{d as Branch,b as Currency,S as DateTime,p as Derive,f as GtInternalBranch,x as GtInternalCurrency,C as GtInternalDateTime,m as GtInternalDerive,w as GtInternalNum,v as GtInternalPlural,E as GtInternalRelativeTime,h as GtInternalVar,T as Num,y as Plural,D as RelativeTime,M as T,N as Tx,g as Var,l as createRenderPipeline,s as createRenderVariable,e as getFormatLocales,c as getPluralBranch,t as getReactI18nCache,i as getReadonlyConditionStore,a as getShouldTranslate,r as getTranslationsSnapshot,u as internalInitializeGTSRA,_ as prepareT,O as renderDefaultChildren,k as renderPreparedT,A as renderTranslatedChildren,j as renderVariable,n as setReactI18nCache,o as t};

package/dist/condition-store/singleton-operations.cjs

@@ -1,2 +1,2 @@
-require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`../setup/i18nConfig.cjs`);let t=require(`generaltranslation/internal`),n=require(`gt-i18n/internal`);const{getConditionStore:r,setConditionStore:i,isConditionStoreInitialized:a}=(0,n.createConditionStoreSingleton)((0,t.createDiagnosticMessage)({source:`@generaltranslation/react-core`,severity:`Error`,whatHappened:`Cannot read GT runtime context before it has been initialized`,why:`The internal ConditionStore is unavailable`}));function o(){try{return r()}catch(r){let i=(0,n.getRuntimeEnvironment)(),a=e.getI18nConfig().getRenderStrategy(),o=(0,t.createDiagnosticMessage)({source:`@generaltranslation/react-core`,severity:`Error`,whatHappened:`Cannot access ConditionStore before it is initialized.`,details:(0,t.formatDiagnosticErrorDetails)(r),fix:a===`SPA`?`Initialize GT before reading GT runtime context.`:`Add a <GTProvider> at the root of your component tree.`,wayOut:i===`development`?void 0:a===`SPA`?`Request-specific values will fall back to the default configuration.`:`Request-specific values will fall back to the default configuration. This may cause hydration mismatches.`});if(i===`development`)throw Error(o);return console.error(o),{getLocale:()=>t.libraryDefaultLocale,getRegion:()=>void 0,getEnableI18n:()=>!0,setLocale:()=>{},setRegion:()=>{},setEnableI18n:()=>{}}}}exports.getReadonlyConditionStoreWithFallback=o,exports.isConditionStoreInitialized=a,exports.setConditionStore=i;
+require(`../_virtual/_rolldown/runtime.cjs`);let e=require(`gt-i18n/internal`),t=require(`generaltranslation/internal`);const{getConditionStore:n,setConditionStore:r,isConditionStoreInitialized:i}=(0,e.createConditionStoreSingleton)((0,t.createDiagnosticMessage)({source:`@generaltranslation/react-core`,severity:`Error`,whatHappened:`Cannot read GT runtime context before it has been initialized`,why:`The internal ConditionStore is unavailable`,fix:`Call initializeGT() during setup (gt-next runs this automatically) and add a <GTProvider> at the root of your component tree.`}));exports.getConditionStore=n,exports.isConditionStoreInitialized=i;
 //# sourceMappingURL=singleton-operations.cjs.map

package/dist/condition-store/singleton-operations.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"singleton-operations.cjs","names":["getI18nConfig","libraryDefaultLocale"],"sources":["../../src/condition-store/singleton-operations.ts"],"sourcesContent":["import {\n  createDiagnosticMessage,\n  formatDiagnosticErrorDetails,\n  libraryDefaultLocale,\n} from 'generaltranslation/internal';\nimport {\n  createConditionStoreSingleton,\n  getRuntimeEnvironment,\n} from 'gt-i18n/internal';\nimport type { ReadonlyConditionStoreInterface } from 'gt-i18n/internal/types';\nimport { getI18nConfig } from '../setup/i18nConfig';\n\nconst conditionStoreNotInitializedError = createDiagnosticMessage({\n  source: '@generaltranslation/react-core',\n  severity: 'Error',\n  whatHappened: 'Cannot read GT runtime context before it has been initialized',\n  why: 'The internal ConditionStore is unavailable',\n});\n\nconst { getConditionStore, setConditionStore, isConditionStoreInitialized } =\n  createConditionStoreSingleton<ReadonlyConditionStoreInterface>(\n    conditionStoreNotInitializedError\n  );\n\n/**\n * Opinionated decision: add a safety wrapper around the condition store to be more forgiving in production\n * TODO: perhaps this is how condition store should always be accessed\n */\nfunction getReadonlyConditionStoreWithFallback(): ReadonlyConditionStoreInterface {\n  try {\n    return getConditionStore();\n  } catch (error) {\n    // Error handling\n    const runtimeEnvironment = getRuntimeEnvironment();\n    const renderStrategy = getI18nConfig().getRenderStrategy();\n    const errorMessage = createDiagnosticMessage({\n      source: '@generaltranslation/react-core',\n      severity: 'Error',\n      whatHappened: 'Cannot access ConditionStore before it is initialized.',\n      details: formatDiagnosticErrorDetails(error),\n      fix:\n        renderStrategy === 'SPA'\n          ? 'Initialize GT before reading GT runtime context.'\n          : 'Add a <GTProvider> at the root of your component tree.',\n      wayOut:\n        runtimeEnvironment === 'development'\n          ? undefined\n          : renderStrategy === 'SPA'\n            ? 'Request-specific values will fall back to the default configuration.'\n            : 'Request-specific values will fall back to the default configuration. This may cause hydration mismatches.',\n    });\n\n    if (runtimeEnvironment === 'development') {\n      throw new Error(errorMessage);\n    } else {\n      console.error(errorMessage);\n    }\n\n    // Fallback to default configuration (important: do not set globally)\n    return {\n      getLocale: () => libraryDefaultLocale,\n      getRegion: () => undefined,\n      getEnableI18n: () => true,\n      setLocale: () => {},\n      setRegion: () => {},\n      setEnableI18n: () => {},\n    };\n  }\n}\n\nexport {\n  getReadonlyConditionStoreWithFallback,\n  setConditionStore as setReadonlyConditionStore,\n  isConditionStoreInitialized as isReadonlyConditionStoreInitialized,\n};\n"],"mappings":"mKAmBA,KAAM,CAAE,oBAAmB,oBAAmB,gCAAA,EAAA,EAAA,gCAAA,EAAA,EAAA,yBAPoB,CAChE,OAAQ,iCACR,SAAU,QACV,aAAc,gEACd,IAAK,6CACN,CAIoC,CAClC,CAMH,SAAS,GAAyE,CAChF,GAAI,CACF,OAAO,GAAmB,OACnB,EAAO,CAEd,IAAM,GAAA,EAAA,EAAA,wBAA4C,CAC5C,EAAiBA,EAAAA,eAAe,CAAC,mBAAmB,CACpD,GAAA,EAAA,EAAA,yBAAuC,CAC3C,OAAQ,iCACR,SAAU,QACV,aAAc,yDACd,SAAA,EAAA,EAAA,8BAAsC,EAAM,CAC5C,IACE,IAAmB,MACf,mDACA,yDACN,OACE,IAAuB,cACnB,IAAA,GACA,IAAmB,MACjB,uEACA,4GACT,CAAC,CAEF,GAAI,IAAuB,cACzB,MAAU,MAAM,EAAa,CAM/B,OAJE,QAAQ,MAAM,EAAa,CAItB,CACL,cAAiBC,EAAAA,qBACjB,cAAiB,IAAA,GACjB,kBAAqB,GACrB,cAAiB,GACjB,cAAiB,GACjB,kBAAqB,GACtB"}
+{"version":3,"file":"singleton-operations.cjs","names":[],"sources":["../../src/condition-store/singleton-operations.ts"],"sourcesContent":["import { createDiagnosticMessage } from 'generaltranslation/internal';\nimport { createConditionStoreSingleton } from 'gt-i18n/internal';\nimport type { ReadonlyConditionStoreInterface } from 'gt-i18n/internal/types';\n\nconst conditionStoreNotInitializedError = createDiagnosticMessage({\n  source: '@generaltranslation/react-core',\n  severity: 'Error',\n  whatHappened: 'Cannot read GT runtime context before it has been initialized',\n  why: 'The internal ConditionStore is unavailable',\n  fix: 'Call initializeGT() during setup (gt-next runs this automatically) and add a <GTProvider> at the root of your component tree.',\n});\n\nconst { getConditionStore, setConditionStore, isConditionStoreInitialized } =\n  createConditionStoreSingleton<ReadonlyConditionStoreInterface>(\n    conditionStoreNotInitializedError\n  );\n\nexport {\n  getConditionStore as getReadonlyConditionStore,\n  setConditionStore as setReadonlyConditionStore,\n  isConditionStoreInitialized as isReadonlyConditionStoreInitialized,\n};\n"],"mappings":"wHAYA,KAAM,CAAE,oBAAmB,oBAAmB,gCAAA,EAAA,EAAA,gCAAA,EAAA,EAAA,yBARoB,CAChE,OAAQ,iCACR,SAAU,QACV,aAAc,gEACd,IAAK,6CACL,IAAK,gIACN,CAIoC,CAClC"}

package/dist/condition-store/singleton-operations.d.ts

@@ -1,12 +1,7 @@
 import { ReadonlyConditionStoreInterface } from "gt-i18n/internal/types";
 
 //#region src/condition-store/singleton-operations.d.ts
-declare const setConditionStore: (next: ReadonlyConditionStoreInterface) => void, isConditionStoreInitialized: () => boolean;
-/**
- * Opinionated decision: add a safety wrapper around the condition store to be more forgiving in production
- * TODO: perhaps this is how condition store should always be accessed
- */
-declare function getReadonlyConditionStoreWithFallback(): ReadonlyConditionStoreInterface;
+declare const getConditionStore: () => ReadonlyConditionStoreInterface, setConditionStore: (next: ReadonlyConditionStoreInterface) => void, isConditionStoreInitialized: () => boolean;
 //#endregion
-export { getReadonlyConditionStoreWithFallback, setConditionStore };
+export { getConditionStore };
 //# sourceMappingURL=singleton-operations.d.ts.map

package/dist/condition-store/singleton-operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"singleton-operations.d.ts","names":[],"sources":["../../src/condition-store/singleton-operations.ts"],"mappings":";;;cAmB2B,iBAAA,GAAiB,IAAA,EAAA,+BAAA,WAAE,2BAAA;;AAVgC;;;iBAmBrE,qCAAA,CAAA,GAAyC,+BAAA"}
+{"version":3,"file":"singleton-operations.d.ts","names":[],"sources":["../../src/condition-store/singleton-operations.ts"],"mappings":";;;cAYQ,iBAAA,QAAiB,+BAAA,EAAE,iBAAA,GAAiB,IAAA,EAAA,+BAAA,WAAE,2BAAA"}

package/dist/condition-store/singleton-operations.mjs

@@ -1,2 +1,2 @@
-import{getI18nConfig as e}from"../setup/i18nConfig.mjs";import{createDiagnosticMessage as t,formatDiagnosticErrorDetails as n,libraryDefaultLocale as r}from"generaltranslation/internal";import{createConditionStoreSingleton as i,getRuntimeEnvironment as a}from"gt-i18n/internal";const{getConditionStore:o,setConditionStore:s,isConditionStoreInitialized:c}=i(t({source:`@generaltranslation/react-core`,severity:`Error`,whatHappened:`Cannot read GT runtime context before it has been initialized`,why:`The internal ConditionStore is unavailable`}));function l(){try{return o()}catch(i){let o=a(),s=e().getRenderStrategy(),c=t({source:`@generaltranslation/react-core`,severity:`Error`,whatHappened:`Cannot access ConditionStore before it is initialized.`,details:n(i),fix:s===`SPA`?`Initialize GT before reading GT runtime context.`:`Add a <GTProvider> at the root of your component tree.`,wayOut:o===`development`?void 0:s===`SPA`?`Request-specific values will fall back to the default configuration.`:`Request-specific values will fall back to the default configuration. This may cause hydration mismatches.`});if(o===`development`)throw Error(c);return console.error(c),{getLocale:()=>r,getRegion:()=>void 0,getEnableI18n:()=>!0,setLocale:()=>{},setRegion:()=>{},setEnableI18n:()=>{}}}}export{l as getReadonlyConditionStoreWithFallback,c as isConditionStoreInitialized,s as setConditionStore};
+import{createConditionStoreSingleton as e}from"gt-i18n/internal";import{createDiagnosticMessage as t}from"generaltranslation/internal";const{getConditionStore:n,setConditionStore:r,isConditionStoreInitialized:i}=e(t({source:`@generaltranslation/react-core`,severity:`Error`,whatHappened:`Cannot read GT runtime context before it has been initialized`,why:`The internal ConditionStore is unavailable`,fix:`Call initializeGT() during setup (gt-next runs this automatically) and add a <GTProvider> at the root of your component tree.`}));export{n as getConditionStore,i as isConditionStoreInitialized};
 //# sourceMappingURL=singleton-operations.mjs.map

package/dist/condition-store/singleton-operations.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"singleton-operations.mjs","names":["getI18nConfig"],"sources":["../../src/condition-store/singleton-operations.ts"],"sourcesContent":["import {\n  createDiagnosticMessage,\n  formatDiagnosticErrorDetails,\n  libraryDefaultLocale,\n} from 'generaltranslation/internal';\nimport {\n  createConditionStoreSingleton,\n  getRuntimeEnvironment,\n} from 'gt-i18n/internal';\nimport type { ReadonlyConditionStoreInterface } from 'gt-i18n/internal/types';\nimport { getI18nConfig } from '../setup/i18nConfig';\n\nconst conditionStoreNotInitializedError = createDiagnosticMessage({\n  source: '@generaltranslation/react-core',\n  severity: 'Error',\n  whatHappened: 'Cannot read GT runtime context before it has been initialized',\n  why: 'The internal ConditionStore is unavailable',\n});\n\nconst { getConditionStore, setConditionStore, isConditionStoreInitialized } =\n  createConditionStoreSingleton<ReadonlyConditionStoreInterface>(\n    conditionStoreNotInitializedError\n  );\n\n/**\n * Opinionated decision: add a safety wrapper around the condition store to be more forgiving in production\n * TODO: perhaps this is how condition store should always be accessed\n */\nfunction getReadonlyConditionStoreWithFallback(): ReadonlyConditionStoreInterface {\n  try {\n    return getConditionStore();\n  } catch (error) {\n    // Error handling\n    const runtimeEnvironment = getRuntimeEnvironment();\n    const renderStrategy = getI18nConfig().getRenderStrategy();\n    const errorMessage = createDiagnosticMessage({\n      source: '@generaltranslation/react-core',\n      severity: 'Error',\n      whatHappened: 'Cannot access ConditionStore before it is initialized.',\n      details: formatDiagnosticErrorDetails(error),\n      fix:\n        renderStrategy === 'SPA'\n          ? 'Initialize GT before reading GT runtime context.'\n          : 'Add a <GTProvider> at the root of your component tree.',\n      wayOut:\n        runtimeEnvironment === 'development'\n          ? undefined\n          : renderStrategy === 'SPA'\n            ? 'Request-specific values will fall back to the default configuration.'\n            : 'Request-specific values will fall back to the default configuration. This may cause hydration mismatches.',\n    });\n\n    if (runtimeEnvironment === 'development') {\n      throw new Error(errorMessage);\n    } else {\n      console.error(errorMessage);\n    }\n\n    // Fallback to default configuration (important: do not set globally)\n    return {\n      getLocale: () => libraryDefaultLocale,\n      getRegion: () => undefined,\n      getEnableI18n: () => true,\n      setLocale: () => {},\n      setRegion: () => {},\n      setEnableI18n: () => {},\n    };\n  }\n}\n\nexport {\n  getReadonlyConditionStoreWithFallback,\n  setConditionStore as setReadonlyConditionStore,\n  isConditionStoreInitialized as isReadonlyConditionStoreInitialized,\n};\n"],"mappings":"sRAmBA,KAAM,CAAE,oBAAmB,oBAAmB,+BAC5C,EARwC,EAAwB,CAChE,OAAQ,iCACR,SAAU,QACV,aAAc,gEACd,IAAK,6CACN,CAIoC,CAClC,CAMH,SAAS,GAAyE,CAChF,GAAI,CACF,OAAO,GAAmB,OACnB,EAAO,CAEd,IAAM,EAAqB,GAAuB,CAC5C,EAAiBA,GAAe,CAAC,mBAAmB,CACpD,EAAe,EAAwB,CAC3C,OAAQ,iCACR,SAAU,QACV,aAAc,yDACd,QAAS,EAA6B,EAAM,CAC5C,IACE,IAAmB,MACf,mDACA,yDACN,OACE,IAAuB,cACnB,IAAA,GACA,IAAmB,MACjB,uEACA,4GACT,CAAC,CAEF,GAAI,IAAuB,cACzB,MAAU,MAAM,EAAa,CAM/B,OAJE,QAAQ,MAAM,EAAa,CAItB,CACL,cAAiB,EACjB,cAAiB,IAAA,GACjB,kBAAqB,GACrB,cAAiB,GACjB,cAAiB,GACjB,kBAAqB,GACtB"}
+{"version":3,"file":"singleton-operations.mjs","names":[],"sources":["../../src/condition-store/singleton-operations.ts"],"sourcesContent":["import { createDiagnosticMessage } from 'generaltranslation/internal';\nimport { createConditionStoreSingleton } from 'gt-i18n/internal';\nimport type { ReadonlyConditionStoreInterface } from 'gt-i18n/internal/types';\n\nconst conditionStoreNotInitializedError = createDiagnosticMessage({\n  source: '@generaltranslation/react-core',\n  severity: 'Error',\n  whatHappened: 'Cannot read GT runtime context before it has been initialized',\n  why: 'The internal ConditionStore is unavailable',\n  fix: 'Call initializeGT() during setup (gt-next runs this automatically) and add a <GTProvider> at the root of your component tree.',\n});\n\nconst { getConditionStore, setConditionStore, isConditionStoreInitialized } =\n  createConditionStoreSingleton<ReadonlyConditionStoreInterface>(\n    conditionStoreNotInitializedError\n  );\n\nexport {\n  getConditionStore as getReadonlyConditionStore,\n  setConditionStore as setReadonlyConditionStore,\n  isConditionStoreInitialized as isReadonlyConditionStoreInitialized,\n};\n"],"mappings":"uIAYA,KAAM,CAAE,oBAAmB,oBAAmB,+BAC5C,EATwC,EAAwB,CAChE,OAAQ,iCACR,SAAU,QACV,aAAc,gEACd,IAAK,6CACL,IAAK,gIACN,CAIoC,CAClC"}

package/dist/context/InternalGTProvider.cjs

@@ -1,2 +1,2 @@
-require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`./context.cjs`);let t=require(`react`),n=require(`react/jsx-runtime`);const r=e.getGTContext();function i({children:e,translations:i,dictionaries:a,conditionStore:o,i18nStore:s,onMissingTranslation:c,onMissingDictionaryEntry:l,onMissingDictionaryObj:u}){let d=(0,t.useMemo)(()=>({translationsSnapshot:i,dictionariesSnapshot:a??{},i18nStore:s,conditionStore:o,onMissingTranslation:c,onMissingDictionaryEntry:l,onMissingDictionaryObj:u}),[i,a,s,o,c,l,u]);return(0,t.useEffect)(()=>{s.updateTranslations(i),s.updateDictionaries(a??{})},[i,a,s]),(0,n.jsx)(r.Provider,{value:d,children:e})}exports.InternalGTProvider=i;
+require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`./context.cjs`);let t=require(`react/jsx-runtime`),n=require(`react`);const r=e.getGTContext();function i({children:e,translations:i,dictionaries:a,conditionStore:o,i18nStore:s,onMissingTranslation:c,onMissingDictionaryEntry:l,onMissingDictionaryObj:u}){let d=(0,n.useMemo)(()=>({translationsSnapshot:i,dictionariesSnapshot:a??{},i18nStore:s,conditionStore:o,onMissingTranslation:c,onMissingDictionaryEntry:l,onMissingDictionaryObj:u}),[i,a,s,o,c,l,u]);return(0,n.useEffect)(()=>{s.updateTranslations(i),s.updateDictionaries(a??{})},[i,a,s]),(0,t.jsx)(r.Provider,{value:d,children:e})}exports.InternalGTProvider=i;
 //# sourceMappingURL=InternalGTProvider.cjs.map

package/dist/context/InternalGTProvider.mjs

@@ -1,2 +1,2 @@
-import{getGTContext as e}from"./context.mjs";import{useEffect as t,useMemo as n}from"react";import{jsx as r}from"react/jsx-runtime";const i=e();function a({children:e,translations:a,dictionaries:o,conditionStore:s,i18nStore:c,onMissingTranslation:l,onMissingDictionaryEntry:u,onMissingDictionaryObj:d}){let f=n(()=>({translationsSnapshot:a,dictionariesSnapshot:o??{},i18nStore:c,conditionStore:s,onMissingTranslation:l,onMissingDictionaryEntry:u,onMissingDictionaryObj:d}),[a,o,c,s,l,u,d]);return t(()=>{c.updateTranslations(a),c.updateDictionaries(o??{})},[a,o,c]),r(i.Provider,{value:f,children:e})}export{a as InternalGTProvider};
+import{getGTContext as e}from"./context.mjs";import{jsx as t}from"react/jsx-runtime";import{useEffect as n,useMemo as r}from"react";const i=e();function a({children:e,translations:a,dictionaries:o,conditionStore:s,i18nStore:c,onMissingTranslation:l,onMissingDictionaryEntry:u,onMissingDictionaryObj:d}){let f=r(()=>({translationsSnapshot:a,dictionariesSnapshot:o??{},i18nStore:c,conditionStore:s,onMissingTranslation:l,onMissingDictionaryEntry:u,onMissingDictionaryObj:d}),[a,o,c,s,l,u,d]);return n(()=>{c.updateTranslations(a),c.updateDictionaries(o??{})},[a,o,c]),t(i.Provider,{value:f,children:e})}export{a as InternalGTProvider};
 //# sourceMappingURL=InternalGTProvider.mjs.map

package/dist/context/context.cjs

@@ -1,2 +1,2 @@
-require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`../setup/i18nConfig.cjs`);let t=require(`generaltranslation/internal`),n=require(`react`);const r=(0,require(`gt-i18n/internal`).createGlobalSingleton)({namespace:`reactCore`,key:`gtContext`,source:`@generaltranslation/react-core`,notInitialized:()=>`GTContext has not been initialized.`});function i(){return r.isInitialized()||r.set((0,n.createContext)(void 0)),r.get()}function a(){let t=(0,n.useContext)(i());if(t||e.getI18nConfig().getRenderStrategy()===`SPA`)return t;throw Error(o())}function o(){return(0,t.createDiagnosticMessage)({source:`@generaltranslation/react-core`,severity:`Error`,whatHappened:`GT runtime context could not be read`,why:`GTContext was accessed outside of a <GTProvider>`,fix:`Add a <GTProvider> at the root of your component tree.`})}exports.getGTContext=i,exports.useGTContext=a;
+require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`../setup/i18nConfig.cjs`);let t=require(`gt-i18n/internal`),n=require(`generaltranslation/internal`),r=require(`react`);const i=(0,t.createGlobalSingleton)({namespace:`reactCore`,key:`gtContext`,source:`@generaltranslation/react-core`,notInitialized:()=>(0,n.createDiagnosticMessage)({source:`@generaltranslation/react-core`,severity:`Error`,whatHappened:`Cannot read GTContext before it has been initialized`,why:`the internal GTContext singleton is unavailable`,fix:`Add a <GTProvider> at the root of your component tree.`})});function a(){return i.isInitialized()||i.set((0,r.createContext)(void 0)),i.get()}function o(){let t=(0,r.useContext)(a());if(t||e.getI18nConfig().getRenderStrategy()===`SPA`)return t;throw Error(s())}function s(){return(0,n.createDiagnosticMessage)({source:`@generaltranslation/react-core`,severity:`Error`,whatHappened:`GT runtime context could not be read`,why:`GTContext was accessed outside of a <GTProvider>`,fix:`Add a <GTProvider> at the root of your component tree.`})}exports.getGTContext=a,exports.useGTContext=o;
 //# sourceMappingURL=context.cjs.map

package/dist/context/context.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"context.cjs","names":["getI18nConfig"],"sources":["../../src/context/context.ts"],"sourcesContent":["import {\n  Dictionary,\n  Hash,\n  Locale,\n  ReadonlyConditionStoreInterface,\n} from 'gt-i18n/internal/types';\nimport { Translation } from 'gt-i18n/types';\nimport { createDiagnosticMessage } from 'generaltranslation/internal';\nimport { createGlobalSingleton } from 'gt-i18n/internal';\nimport { createContext, useContext, type Context } from 'react';\nimport { I18nStore } from '../i18n-store/I18nStore';\nimport { getI18nConfig } from '../setup/i18nConfig';\nimport type {\n  OnMissingTranslation,\n  OnMissingDictionaryEntry,\n  OnMissingDictionaryObj,\n} from '../hooks/utils/missing-translation';\n\nexport type GTContextType = {\n  /**\n   * Source of truth for translations, streamed from server\n   * In SPA mode, these won't be accessible and translations\n   * can be accessed via useSyncExternalStore() directly\n   */\n  translationsSnapshot: Record<Locale, Record<Hash, Translation>>;\n  dictionariesSnapshot: Record<Locale, Dictionary>;\n  /**\n   * I18nStore allows us to sync state updates in ConditionStore and I18nCache\n   * with renders\n   */\n  i18nStore: I18nStore;\n  /**\n   * ConditionStore should always remain separate from i18nStore as\n   * it manages how we perform lookups\n   */\n  conditionStore: ReadonlyConditionStoreInterface;\n  /**\n   * Custom override behavior on missing translations\n   * Used for server triggering tx hmr b/c no access to useEffect\n   */\n  onMissingTranslation?: OnMissingTranslation;\n  onMissingDictionaryEntry?: OnMissingDictionaryEntry;\n  onMissingDictionaryObj?: OnMissingDictionaryObj;\n};\n\nconst gtContextSingleton = createGlobalSingleton<\n  Context<GTContextType | undefined>\n>({\n  namespace: 'reactCore',\n  key: 'gtContext',\n  source: '@generaltranslation/react-core',\n  notInitialized: () => 'GTContext has not been initialized.',\n});\n\nexport function getGTContext(): Context<GTContextType | undefined> {\n  // Lazily create the React context once and share it across instances.\n  if (!gtContextSingleton.isInitialized()) {\n    gtContextSingleton.set(createContext<GTContextType | undefined>(undefined));\n  }\n  return gtContextSingleton.get();\n}\n\nexport function useGTContext(): GTContextType | undefined {\n  const context = useContext(getGTContext());\n  if (context || getI18nConfig().getRenderStrategy() === 'SPA') {\n    return context;\n  }\n  /**\n   * TODO: in a separate PR, we should figure out how to make this more of a forgiving system\n   */\n  throw new Error(createMissingGTProviderError());\n}\n\nfunction createMissingGTProviderError(): string {\n  return createDiagnosticMessage({\n    source: '@generaltranslation/react-core',\n    severity: 'Error',\n    whatHappened: 'GT runtime context could not be read',\n    why: 'GTContext was accessed outside of a <GTProvider>',\n    fix: 'Add a <GTProvider> at the root of your component tree.',\n  });\n}\n"],"mappings":"wJA6CA,MAAM,GAAA,6BAAA,CAAA,uBAEJ,CACA,UAAW,YACX,IAAK,YACL,OAAQ,iCACR,mBAAsB,sCACvB,CAAC,CAEF,SAAgB,GAAmD,CAKjE,OAHK,EAAmB,eAAe,EACrC,EAAmB,KAAA,EAAA,EAAA,eAA6C,IAAA,GAAU,CAAC,CAEtE,EAAmB,KAAK,CAGjC,SAAgB,GAA0C,CACxD,IAAM,GAAA,EAAA,EAAA,YAAqB,GAAc,CAAC,CAC1C,GAAI,GAAWA,EAAAA,eAAe,CAAC,mBAAmB,GAAK,MACrD,OAAO,EAKT,MAAU,MAAM,GAA8B,CAAC,CAGjD,SAAS,GAAuC,CAC9C,OAAA,EAAA,EAAA,yBAA+B,CAC7B,OAAQ,iCACR,SAAU,QACV,aAAc,uCACd,IAAK,mDACL,IAAK,yDACN,CAAC"}
+{"version":3,"file":"context.cjs","names":["getI18nConfig"],"sources":["../../src/context/context.ts"],"sourcesContent":["import {\n  Dictionary,\n  Hash,\n  Locale,\n  ReadonlyConditionStoreInterface,\n} from 'gt-i18n/internal/types';\nimport { Translation } from 'gt-i18n/types';\nimport { createDiagnosticMessage } from 'generaltranslation/internal';\nimport { createGlobalSingleton } from 'gt-i18n/internal';\nimport { createContext, useContext, type Context } from 'react';\nimport { I18nStore } from '../i18n-store/I18nStore';\nimport { getI18nConfig } from '../setup/i18nConfig';\nimport type {\n  OnMissingTranslation,\n  OnMissingDictionaryEntry,\n  OnMissingDictionaryObj,\n} from '../hooks/utils/missing-translation';\n\nexport type GTContextType = {\n  /**\n   * Source of truth for translations, streamed from server\n   * In SPA mode, these won't be accessible and translations\n   * can be accessed via useSyncExternalStore() directly\n   */\n  translationsSnapshot: Record<Locale, Record<Hash, Translation>>;\n  dictionariesSnapshot: Record<Locale, Dictionary>;\n  /**\n   * I18nStore allows us to sync state updates in ConditionStore and I18nCache\n   * with renders\n   */\n  i18nStore: I18nStore;\n  /**\n   * ConditionStore should always remain separate from i18nStore as\n   * it manages how we perform lookups\n   */\n  conditionStore: ReadonlyConditionStoreInterface;\n  /**\n   * Custom override behavior on missing translations\n   * Used for server triggering tx hmr b/c no access to useEffect\n   */\n  onMissingTranslation?: OnMissingTranslation;\n  onMissingDictionaryEntry?: OnMissingDictionaryEntry;\n  onMissingDictionaryObj?: OnMissingDictionaryObj;\n};\n\nconst gtContextSingleton = createGlobalSingleton<\n  Context<GTContextType | undefined>\n>({\n  namespace: 'reactCore',\n  key: 'gtContext',\n  source: '@generaltranslation/react-core',\n  notInitialized: () =>\n    createDiagnosticMessage({\n      source: '@generaltranslation/react-core',\n      severity: 'Error',\n      whatHappened: 'Cannot read GTContext before it has been initialized',\n      why: 'the internal GTContext singleton is unavailable',\n      fix: 'Add a <GTProvider> at the root of your component tree.',\n    }),\n});\n\nexport function getGTContext(): Context<GTContextType | undefined> {\n  // Lazily create the React context once and share it across instances.\n  if (!gtContextSingleton.isInitialized()) {\n    gtContextSingleton.set(createContext<GTContextType | undefined>(undefined));\n  }\n  return gtContextSingleton.get();\n}\n\nexport function useGTContext(): GTContextType | undefined {\n  const context = useContext(getGTContext());\n  if (context || getI18nConfig().getRenderStrategy() === 'SPA') {\n    return context;\n  }\n  /**\n   * TODO: in a separate PR, we should figure out how to make this more of a forgiving system\n   */\n  throw new Error(createMissingGTProviderError());\n}\n\nfunction createMissingGTProviderError(): string {\n  return createDiagnosticMessage({\n    source: '@generaltranslation/react-core',\n    severity: 'Error',\n    whatHappened: 'GT runtime context could not be read',\n    why: 'GTContext was accessed outside of a <GTProvider>',\n    fix: 'Add a <GTProvider> at the root of your component tree.',\n  });\n}\n"],"mappings":"sLA6CA,MAAM,GAAA,EAAA,EAAA,uBAEJ,CACA,UAAW,YACX,IAAK,YACL,OAAQ,iCACR,oBAAA,EAAA,EAAA,yBAC0B,CACtB,OAAQ,iCACR,SAAU,QACV,aAAc,uDACd,IAAK,kDACL,IAAK,yDACN,CAAC,CACL,CAAC,CAEF,SAAgB,GAAmD,CAKjE,OAHK,EAAmB,eAAe,EACrC,EAAmB,KAAA,EAAA,EAAA,eAA6C,IAAA,GAAU,CAAC,CAEtE,EAAmB,KAAK,CAGjC,SAAgB,GAA0C,CACxD,IAAM,GAAA,EAAA,EAAA,YAAqB,GAAc,CAAC,CAC1C,GAAI,GAAWA,EAAAA,eAAe,CAAC,mBAAmB,GAAK,MACrD,OAAO,EAKT,MAAU,MAAM,GAA8B,CAAC,CAGjD,SAAS,GAAuC,CAC9C,OAAA,EAAA,EAAA,yBAA+B,CAC7B,OAAQ,iCACR,SAAU,QACV,aAAc,uCACd,IAAK,mDACL,IAAK,yDACN,CAAC"}

package/dist/context/context.mjs

@@ -1,2 +1,2 @@
-import{getI18nConfig as e}from"../setup/i18nConfig.mjs";import{createDiagnosticMessage as t}from"generaltranslation/internal";import{createContext as n,useContext as r}from"react";import{createGlobalSingleton as i}from"gt-i18n/internal";const a=i({namespace:`reactCore`,key:`gtContext`,source:`@generaltranslation/react-core`,notInitialized:()=>`GTContext has not been initialized.`});function o(){return a.isInitialized()||a.set(n(void 0)),a.get()}function s(){let t=r(o());if(t||e().getRenderStrategy()===`SPA`)return t;throw Error(c())}function c(){return t({source:`@generaltranslation/react-core`,severity:`Error`,whatHappened:`GT runtime context could not be read`,why:`GTContext was accessed outside of a <GTProvider>`,fix:`Add a <GTProvider> at the root of your component tree.`})}export{o as getGTContext,s as useGTContext};
+import{getI18nConfig as e}from"../setup/i18nConfig.mjs";import{createGlobalSingleton as t}from"gt-i18n/internal";import{createDiagnosticMessage as n}from"generaltranslation/internal";import{createContext as r,useContext as i}from"react";const a=t({namespace:`reactCore`,key:`gtContext`,source:`@generaltranslation/react-core`,notInitialized:()=>n({source:`@generaltranslation/react-core`,severity:`Error`,whatHappened:`Cannot read GTContext before it has been initialized`,why:`the internal GTContext singleton is unavailable`,fix:`Add a <GTProvider> at the root of your component tree.`})});function o(){return a.isInitialized()||a.set(r(void 0)),a.get()}function s(){let t=i(o());if(t||e().getRenderStrategy()===`SPA`)return t;throw Error(c())}function c(){return n({source:`@generaltranslation/react-core`,severity:`Error`,whatHappened:`GT runtime context could not be read`,why:`GTContext was accessed outside of a <GTProvider>`,fix:`Add a <GTProvider> at the root of your component tree.`})}export{o as getGTContext,s as useGTContext};
 //# sourceMappingURL=context.mjs.map

package/dist/context/context.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"context.mjs","names":["getI18nConfig"],"sources":["../../src/context/context.ts"],"sourcesContent":["import {\n  Dictionary,\n  Hash,\n  Locale,\n  ReadonlyConditionStoreInterface,\n} from 'gt-i18n/internal/types';\nimport { Translation } from 'gt-i18n/types';\nimport { createDiagnosticMessage } from 'generaltranslation/internal';\nimport { createGlobalSingleton } from 'gt-i18n/internal';\nimport { createContext, useContext, type Context } from 'react';\nimport { I18nStore } from '../i18n-store/I18nStore';\nimport { getI18nConfig } from '../setup/i18nConfig';\nimport type {\n  OnMissingTranslation,\n  OnMissingDictionaryEntry,\n  OnMissingDictionaryObj,\n} from '../hooks/utils/missing-translation';\n\nexport type GTContextType = {\n  /**\n   * Source of truth for translations, streamed from server\n   * In SPA mode, these won't be accessible and translations\n   * can be accessed via useSyncExternalStore() directly\n   */\n  translationsSnapshot: Record<Locale, Record<Hash, Translation>>;\n  dictionariesSnapshot: Record<Locale, Dictionary>;\n  /**\n   * I18nStore allows us to sync state updates in ConditionStore and I18nCache\n   * with renders\n   */\n  i18nStore: I18nStore;\n  /**\n   * ConditionStore should always remain separate from i18nStore as\n   * it manages how we perform lookups\n   */\n  conditionStore: ReadonlyConditionStoreInterface;\n  /**\n   * Custom override behavior on missing translations\n   * Used for server triggering tx hmr b/c no access to useEffect\n   */\n  onMissingTranslation?: OnMissingTranslation;\n  onMissingDictionaryEntry?: OnMissingDictionaryEntry;\n  onMissingDictionaryObj?: OnMissingDictionaryObj;\n};\n\nconst gtContextSingleton = createGlobalSingleton<\n  Context<GTContextType | undefined>\n>({\n  namespace: 'reactCore',\n  key: 'gtContext',\n  source: '@generaltranslation/react-core',\n  notInitialized: () => 'GTContext has not been initialized.',\n});\n\nexport function getGTContext(): Context<GTContextType | undefined> {\n  // Lazily create the React context once and share it across instances.\n  if (!gtContextSingleton.isInitialized()) {\n    gtContextSingleton.set(createContext<GTContextType | undefined>(undefined));\n  }\n  return gtContextSingleton.get();\n}\n\nexport function useGTContext(): GTContextType | undefined {\n  const context = useContext(getGTContext());\n  if (context || getI18nConfig().getRenderStrategy() === 'SPA') {\n    return context;\n  }\n  /**\n   * TODO: in a separate PR, we should figure out how to make this more of a forgiving system\n   */\n  throw new Error(createMissingGTProviderError());\n}\n\nfunction createMissingGTProviderError(): string {\n  return createDiagnosticMessage({\n    source: '@generaltranslation/react-core',\n    severity: 'Error',\n    whatHappened: 'GT runtime context could not be read',\n    why: 'GTContext was accessed outside of a <GTProvider>',\n    fix: 'Add a <GTProvider> at the root of your component tree.',\n  });\n}\n"],"mappings":"6OA6CA,MAAM,EAAqB,EAEzB,CACA,UAAW,YACX,IAAK,YACL,OAAQ,iCACR,mBAAsB,sCACvB,CAAC,CAEF,SAAgB,GAAmD,CAKjE,OAHK,EAAmB,eAAe,EACrC,EAAmB,IAAI,EAAyC,IAAA,GAAU,CAAC,CAEtE,EAAmB,KAAK,CAGjC,SAAgB,GAA0C,CACxD,IAAM,EAAU,EAAW,GAAc,CAAC,CAC1C,GAAI,GAAWA,GAAe,CAAC,mBAAmB,GAAK,MACrD,OAAO,EAKT,MAAU,MAAM,GAA8B,CAAC,CAGjD,SAAS,GAAuC,CAC9C,OAAO,EAAwB,CAC7B,OAAQ,iCACR,SAAU,QACV,aAAc,uCACd,IAAK,mDACL,IAAK,yDACN,CAAC"}
+{"version":3,"file":"context.mjs","names":["getI18nConfig"],"sources":["../../src/context/context.ts"],"sourcesContent":["import {\n  Dictionary,\n  Hash,\n  Locale,\n  ReadonlyConditionStoreInterface,\n} from 'gt-i18n/internal/types';\nimport { Translation } from 'gt-i18n/types';\nimport { createDiagnosticMessage } from 'generaltranslation/internal';\nimport { createGlobalSingleton } from 'gt-i18n/internal';\nimport { createContext, useContext, type Context } from 'react';\nimport { I18nStore } from '../i18n-store/I18nStore';\nimport { getI18nConfig } from '../setup/i18nConfig';\nimport type {\n  OnMissingTranslation,\n  OnMissingDictionaryEntry,\n  OnMissingDictionaryObj,\n} from '../hooks/utils/missing-translation';\n\nexport type GTContextType = {\n  /**\n   * Source of truth for translations, streamed from server\n   * In SPA mode, these won't be accessible and translations\n   * can be accessed via useSyncExternalStore() directly\n   */\n  translationsSnapshot: Record<Locale, Record<Hash, Translation>>;\n  dictionariesSnapshot: Record<Locale, Dictionary>;\n  /**\n   * I18nStore allows us to sync state updates in ConditionStore and I18nCache\n   * with renders\n   */\n  i18nStore: I18nStore;\n  /**\n   * ConditionStore should always remain separate from i18nStore as\n   * it manages how we perform lookups\n   */\n  conditionStore: ReadonlyConditionStoreInterface;\n  /**\n   * Custom override behavior on missing translations\n   * Used for server triggering tx hmr b/c no access to useEffect\n   */\n  onMissingTranslation?: OnMissingTranslation;\n  onMissingDictionaryEntry?: OnMissingDictionaryEntry;\n  onMissingDictionaryObj?: OnMissingDictionaryObj;\n};\n\nconst gtContextSingleton = createGlobalSingleton<\n  Context<GTContextType | undefined>\n>({\n  namespace: 'reactCore',\n  key: 'gtContext',\n  source: '@generaltranslation/react-core',\n  notInitialized: () =>\n    createDiagnosticMessage({\n      source: '@generaltranslation/react-core',\n      severity: 'Error',\n      whatHappened: 'Cannot read GTContext before it has been initialized',\n      why: 'the internal GTContext singleton is unavailable',\n      fix: 'Add a <GTProvider> at the root of your component tree.',\n    }),\n});\n\nexport function getGTContext(): Context<GTContextType | undefined> {\n  // Lazily create the React context once and share it across instances.\n  if (!gtContextSingleton.isInitialized()) {\n    gtContextSingleton.set(createContext<GTContextType | undefined>(undefined));\n  }\n  return gtContextSingleton.get();\n}\n\nexport function useGTContext(): GTContextType | undefined {\n  const context = useContext(getGTContext());\n  if (context || getI18nConfig().getRenderStrategy() === 'SPA') {\n    return context;\n  }\n  /**\n   * TODO: in a separate PR, we should figure out how to make this more of a forgiving system\n   */\n  throw new Error(createMissingGTProviderError());\n}\n\nfunction createMissingGTProviderError(): string {\n  return createDiagnosticMessage({\n    source: '@generaltranslation/react-core',\n    severity: 'Error',\n    whatHappened: 'GT runtime context could not be read',\n    why: 'GTContext was accessed outside of a <GTProvider>',\n    fix: 'Add a <GTProvider> at the root of your component tree.',\n  });\n}\n"],"mappings":"6OA6CA,MAAM,EAAqB,EAEzB,CACA,UAAW,YACX,IAAK,YACL,OAAQ,iCACR,mBACE,EAAwB,CACtB,OAAQ,iCACR,SAAU,QACV,aAAc,uDACd,IAAK,kDACL,IAAK,yDACN,CAAC,CACL,CAAC,CAEF,SAAgB,GAAmD,CAKjE,OAHK,EAAmB,eAAe,EACrC,EAAmB,IAAI,EAAyC,IAAA,GAAU,CAAC,CAEtE,EAAmB,KAAK,CAGjC,SAAgB,GAA0C,CACxD,IAAM,EAAU,EAAW,GAAc,CAAC,CAC1C,GAAI,GAAWA,GAAe,CAAC,mBAAmB,GAAK,MACrD,OAAO,EAKT,MAAU,MAAM,GAA8B,CAAC,CAGjD,SAAS,GAAuC,CAC9C,OAAO,EAAwB,CAC7B,OAAQ,iCACR,SAAU,QACV,aAAc,uCACd,IAAK,mDACL,IAAK,yDACN,CAAC"}

package/dist/functions/translation/t.cjs

@@ -1,2 +1,2 @@
-require(`../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../i18n-cache/singleton-operations.cjs`),t=require(`../../setup/i18nConfig.cjs`),n=require(`../../condition-store/singleton-operations.cjs`),r=require(`../../hooks/utils/getShouldTranslate.cjs`);let i=require(`generaltranslation/internal`),a=require(`gt-i18n/internal`);const o=(e,...t)=>{if(d(e),typeof e==`string`){let n=t.at(0);return s(n?.$locale??f(),e,n)}return c(e,t)};function s(n,i,o={}){let s=e.getReactI18nCache(),c=t.getI18nConfig().getDefaultLocale();if(!r.getShouldTranslate())return(0,a.interpolateMessage)({options:o,source:i,sourceLocale:c});let l=(0,a.createLookupOptions)(n,o,`ICU`);return(0,a.interpolateMessage)({source:i,target:s.lookupTranslation(l.$locale,i,l),options:l,sourceLocale:c})}function c(t,n){let r=f(),i=u(t,n),a=e.getReactI18nCache().lookupTranslation(r,i,{$format:`STRING`});if(a)return a;let{message:o,variables:c}=l(t,n);return s(r,o,c)}function l(e,t){let n=[],r={},i=0;for(let a=0;a<e.length;a++)if(n.push(e[a]),a<t.length){let e=i.toString();n.push(`{${e}}`),r[e]=t[a],i++}return{message:n.join(``),variables:r}}function u(e,t){return e.map((e,n)=>e+(t[n]??``)).join(``)}function d(e){let r=t.getI18nConfig().getRenderStrategy()===`server-render`,o=!n.isConditionStoreInitialized();if(!r||!o)return;let s=typeof e==`string`?e:e.join(``),c=(0,i.createDiagnosticMessage)({source:`@generaltranslation/react-core`,severity:`Error`,whatHappened:`Using the t() function at the module level is forbidden in server-rendered applications.`,fix:`Either move the t() invocation into a request-time scope or register the string with the msg() function and translate with an m() function. Ensure that you have added the <GTProvider> at the root of your component tree.`,wayOut:(0,a.getRuntimeEnvironment)()===`development`?void 0:`Falling back to defaultLocale value.`,details:`Message: "${s}"`});if((0,a.getRuntimeEnvironment)()===`development`)throw Error(c);console.error(c)}function f(){return n.getReadonlyConditionStoreWithFallback().getLocale()}exports.t=o;
+require(`../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../i18n-cache/singleton-operations.cjs`),t=require(`../../setup/i18nConfig.cjs`),n=require(`../../condition-store/singleton-operations.cjs`),r=require(`../../hooks/utils/getShouldTranslate.cjs`);let i=require(`gt-i18n/internal`),a=require(`generaltranslation/internal`);const o=(e,...t)=>{if(d(e),typeof e==`string`){let n=t.at(0),r=n?.$locale??f();return s(r,e,(0,i.createLookupOptions)(r,n??{},`ICU`))}return c(e,t)};function s(n,a,o={}){let s=e.getReactI18nCache(),c=t.getI18nConfig().getDefaultLocale();if(!r.getShouldTranslate())return(0,i.interpolateMessage)({options:o,source:a,sourceLocale:c});let l=(0,i.createLookupOptions)(n,o,`ICU`);return(0,i.interpolateMessage)({source:a,target:s.lookupTranslation(l.$locale,a,l),options:l,sourceLocale:c})}function c(t,n){let r=f(),i=u(t,n),a=e.getReactI18nCache().lookupTranslation(r,i,{$format:`STRING`});if(a)return a;let{message:o,variables:c}=l(t,n);return s(r,o,c)}function l(e,t){let n=[],r={},i=0;for(let a=0;a<e.length;a++)if(n.push(e[a]),a<t.length){let e=i.toString();n.push(`{${e}}`),r[e]=t[a],i++}return{message:n.join(``),variables:r}}function u(e,t){return e.map((e,n)=>e+(t[n]??``)).join(``)}function d(e){let r=t.getI18nConfig().getRenderStrategy()===`server-render`,o=!n.isConditionStoreInitialized();if(!r||!o)return;let s=typeof e==`string`?e:e.join(``),c=(0,a.createDiagnosticMessage)({source:`@generaltranslation/react-core`,severity:`Error`,whatHappened:`Using the t() function at the module level is forbidden in server-rendered applications.`,fix:`Either move the t() invocation into a request-time scope or register the string with the msg() function and translate with an m() function. Ensure that you have added the <GTProvider> at the root of your component tree.`,wayOut:(0,i.getRuntimeEnvironment)()===`development`?void 0:`Falling back to defaultLocale value.`,details:`Message: "${s}"`});if((0,i.getRuntimeEnvironment)()===`development`)throw Error(c);console.error(c)}function f(){return n.getConditionStore().getLocale()}exports.t=o;
 //# sourceMappingURL=t.cjs.map

package/dist/functions/translation/t.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"t.cjs","names":["getReactI18nCache","getI18nConfig","getShouldTranslate","isReadonlyConditionStoreInitialized","getReadonlyConditionStoreWithFallback"],"sources":["../../../src/functions/translation/t.ts"],"sourcesContent":["import {\n  createLookupOptions,\n  getRuntimeEnvironment,\n  interpolateMessage,\n} from 'gt-i18n/internal';\nimport type { GTTranslationOptions, LookupOptionsFor } from 'gt-i18n/types';\nimport { getI18nConfig } from '../../setup/i18nConfig';\nimport {\n  getReadonlyConditionStoreWithFallback,\n  isReadonlyConditionStoreInitialized,\n} from '../../condition-store/singleton-operations';\nimport { StringContent, StringFormat } from 'generaltranslation/types';\nimport { getReactI18nCache } from '../../i18n-cache/singleton-operations';\nimport { getShouldTranslate } from '../../hooks/utils/getShouldTranslate';\nimport { createDiagnosticMessage } from 'generaltranslation/internal';\n\n/**\n * Translate a message\n * @param {string} message - The message to translate.\n * @param {GTTranslationOptions} [options] - The options for the translation.\n * @returns {string} The translated message.\n *\n * @example\n * t('Hello, world!'); // Translates 'Hello, world!'\n *\n * @example\n * t('Hello, {name}!', { name: 'John' }); // Translates 'Hello, John!'\n *\n * @example\n * t`Hello, ${name}` // Translate via tagged template literal\n *\n */\nexport const t: StringOrTemplateSyncResolutionFunction = (\n  messageOrStrings: string | TemplateStringsArray,\n  ...values: unknown[]\n) => {\n  // Warnings and errors\n  enforceSSRRules(messageOrStrings);\n\n  //  t(\"Hello, {name}!\", { name: \"John\" })\n  if (typeof messageOrStrings === 'string') {\n    const options = values.at(0) as GTTranslationOptions | undefined;\n    const locale = options?.$locale ?? getLocale();\n    return resolveStringContent(locale, messageOrStrings, options);\n  }\n\n  // t`Hello, ${name}`\n  return handleTaggedTemplateLiteralTranslation(messageOrStrings, values);\n};\n\n// ----- Helper Functions ----- //\n\nexport function resolveStringContent(\n  locale: string,\n  content: StringContent,\n  options: LookupOptionsFor<StringFormat> = {}\n): StringContent {\n  const i18nCache = getReactI18nCache();\n  const defaultLocale = getI18nConfig().getDefaultLocale();\n  if (!getShouldTranslate()) {\n    return interpolateMessage({\n      options,\n      source: content,\n      sourceLocale: defaultLocale,\n    });\n  }\n\n  const lookupOptions = createLookupOptions(locale, options, 'ICU');\n  const translation = i18nCache.lookupTranslation(\n    lookupOptions.$locale,\n    content,\n    lookupOptions\n  );\n  return interpolateMessage({\n    source: content,\n    target: translation,\n    options: lookupOptions,\n    sourceLocale: defaultLocale,\n  });\n}\n\n/**\n * Handle tagged template literal translation\n * @param messageOrStrings - The message or strings to translate.\n * @param values - The values to interpolate.\n * @returns The translated message.\n *\n * This is triggered when there has been no compiler transformation\n *\n * Try looking up interpolated template first\n * If not found, resolve uninterpolated message\n */\nfunction handleTaggedTemplateLiteralTranslation(\n  messageOrStrings: TemplateStringsArray,\n  values: unknown[]\n): string {\n  const locale = getLocale();\n  // for tagged template literals, there has been no compiler transformation\n  // (1) lookup interpolated template (aka derived message)\n  const interpolatedTemplate = interpolateTemplateLiteral(\n    messageOrStrings,\n    values\n  );\n  const i18nCache = getReactI18nCache();\n  const translatedInterpolatedTemplate = i18nCache.lookupTranslation(\n    locale,\n    interpolatedTemplate,\n    { $format: 'STRING' }\n  );\n  if (translatedInterpolatedTemplate) return translatedInterpolatedTemplate;\n\n  // (2) resolve uninterpolated message\n  const { message, variables } = extractInterpolatableValues(\n    messageOrStrings,\n    values\n  );\n  return resolveStringContent(locale, message, variables);\n}\n\n/**\n * Given a TemplateStringsArray, and values, return the uninterpolated message and variables.\n * @param strings - The template strings.\n * @param values - The values to interpolate.\n * @returns The interpolated message and variables.\n */\nfunction extractInterpolatableValues(\n  strings: TemplateStringsArray,\n  values: unknown[]\n): {\n  message: string;\n  variables: Record<string, unknown>;\n} {\n  // String parts\n  const parts: string[] = [];\n  // Variables\n  const variables: Record<string, unknown> = {};\n  let varIndex = 0;\n\n  for (let i = 0; i < strings.length; i++) {\n    // Add the cooked text from the quasi (use cooked to handle escape sequences)\n    parts.push(strings[i]);\n\n    // If there's a corresponding expression, create a variable placeholder\n    if (i < values.length) {\n      const key = varIndex.toString();\n      parts.push(`{${key}}`);\n      variables[key] = values[i];\n      varIndex++;\n    }\n  }\n\n  return {\n    message: parts.join(''),\n    variables,\n  };\n}\n\n/**\n * Interpolate a template literal\n * @param message - The message to interpolate.\n * @param variables - The variables to interpolate.\n * @returns The interpolated message.\n */\nfunction interpolateTemplateLiteral(\n  strings: TemplateStringsArray,\n  values: unknown[]\n): string {\n  return strings\n    .map((string, index) => {\n      return string + (values[index] ?? '');\n    })\n    .join('');\n}\n\n/**\n * Module-level t() only works for SPA.\n * We have to error or fallback in SSR.\n */\nfunction enforceSSRRules(messageOrStrings: string | TemplateStringsArray) {\n  const ssrEnabled = getI18nConfig().getRenderStrategy() === 'server-render';\n  const moduleLevel = !isReadonlyConditionStoreInitialized();\n  if (!ssrEnabled || !moduleLevel) return;\n\n  const message =\n    typeof messageOrStrings === 'string'\n      ? messageOrStrings\n      : messageOrStrings.join('');\n  const runtimeEnvironment = getRuntimeEnvironment();\n  const errorMessage = createDiagnosticMessage({\n    source: '@generaltranslation/react-core',\n    severity: 'Error',\n    whatHappened:\n      'Using the t() function at the module level is forbidden in server-rendered applications.',\n    fix: 'Either move the t() invocation into a request-time scope or register the string with the msg() function and translate with an m() function. Ensure that you have added the <GTProvider> at the root of your component tree.',\n    wayOut:\n      runtimeEnvironment === 'development'\n        ? undefined\n        : 'Falling back to defaultLocale value.',\n    details: `Message: \"${message}\"`,\n  });\n  if (getRuntimeEnvironment() === 'development') {\n    throw new Error(errorMessage);\n  } else {\n    console.error(errorMessage);\n  }\n}\n\nfunction getLocale(): string {\n  return getReadonlyConditionStoreWithFallback().getLocale();\n}\n\n/**\n * Overloaded type for the `t` function.\n * - Tagged template: t`Hello, ${name}` (transformed by the compiler plugin at build time)\n * - Function call: t(\"Hello, {name}\", { name: \"John\" })\n *\n * {@link TemplateSyncResolutionFunction}\n * {@link SyncResolutionFunction}\n */\ninterface StringOrTemplateSyncResolutionFunction {\n  (strings: TemplateStringsArray, ...values: unknown[]): string;\n  (message: string, options?: GTTranslationOptions): string;\n}\n\n/**\n * Type for the `t` function when used as a tagged template literal.\n * @param strings - The template strings.\n * @param values - The values to interpolate.\n * @returns The translated message.\n */\ntype TemplateSyncResolutionFunction = (\n  strings: TemplateStringsArray,\n  ...values: unknown[]\n) => string;\n"],"mappings":"kVAgCA,MAAa,GACX,EACA,GAAG,IACA,CAKH,GAHA,EAAgB,EAAiB,CAG7B,OAAO,GAAqB,SAAU,CACxC,IAAM,EAAU,EAAO,GAAG,EAAE,CAE5B,OAAO,EADQ,GAAS,SAAW,GAAW,CACV,EAAkB,EAAQ,CAIhE,OAAO,EAAuC,EAAkB,EAAO,EAKzE,SAAgB,EACd,EACA,EACA,EAA0C,EAAE,CAC7B,CACf,IAAM,EAAYA,EAAAA,mBAAmB,CAC/B,EAAgBC,EAAAA,eAAe,CAAC,kBAAkB,CACxD,GAAI,CAACC,EAAAA,oBAAoB,CACvB,OAAA,EAAA,EAAA,oBAA0B,CACxB,UACA,OAAQ,EACR,aAAc,EACf,CAAC,CAGJ,IAAM,GAAA,EAAA,EAAA,qBAAoC,EAAQ,EAAS,MAAM,CAMjE,OAAA,EAAA,EAAA,oBAA0B,CACxB,OAAQ,EACR,OAPkB,EAAU,kBAC5B,EAAc,QACd,EACA,EAImB,CACnB,QAAS,EACT,aAAc,EACf,CAAC,CAcJ,SAAS,EACP,EACA,EACQ,CACR,IAAM,EAAS,GAAW,CAGpB,EAAuB,EAC3B,EACA,EACD,CAEK,EADYF,EAAAA,mBAC8B,CAAC,kBAC/C,EACA,EACA,CAAE,QAAS,SAAU,CACtB,CACD,GAAI,EAAgC,OAAO,EAG3C,GAAM,CAAE,UAAS,aAAc,EAC7B,EACA,EACD,CACD,OAAO,EAAqB,EAAQ,EAAS,EAAU,CASzD,SAAS,EACP,EACA,EAIA,CAEA,IAAM,EAAkB,EAAE,CAEpB,EAAqC,EAAE,CACzC,EAAW,EAEf,IAAK,IAAI,EAAI,EAAG,EAAI,EAAQ,OAAQ,IAKlC,GAHA,EAAM,KAAK,EAAQ,GAAG,CAGlB,EAAI,EAAO,OAAQ,CACrB,IAAM,EAAM,EAAS,UAAU,CAC/B,EAAM,KAAK,IAAI,EAAI,GAAG,CACtB,EAAU,GAAO,EAAO,GACxB,IAIJ,MAAO,CACL,QAAS,EAAM,KAAK,GAAG,CACvB,YACD,CASH,SAAS,EACP,EACA,EACQ,CACR,OAAO,EACJ,KAAK,EAAQ,IACL,GAAU,EAAO,IAAU,IAClC,CACD,KAAK,GAAG,CAOb,SAAS,EAAgB,EAAiD,CACxE,IAAM,EAAaC,EAAAA,eAAe,CAAC,mBAAmB,GAAK,gBACrD,EAAc,CAACE,EAAAA,6BAAqC,CAC1D,GAAI,CAAC,GAAc,CAAC,EAAa,OAEjC,IAAM,EACJ,OAAO,GAAqB,SACxB,EACA,EAAiB,KAAK,GAAG,CAEzB,GAAA,EAAA,EAAA,yBAAuC,CAC3C,OAAQ,iCACR,SAAU,QACV,aACE,2FACF,IAAK,8NACL,QAAA,EAAA,EAAA,wBACoB,GAAK,cACnB,IAAA,GACA,uCACN,QAAS,aAAa,EAAQ,GAC/B,CAAC,CACF,IAAA,EAAA,EAAA,wBAA2B,GAAK,cAC9B,MAAU,MAAM,EAAa,CAE7B,QAAQ,MAAM,EAAa,CAI/B,SAAS,GAAoB,CAC3B,OAAOC,EAAAA,uCAAuC,CAAC,WAAW"}
+{"version":3,"file":"t.cjs","names":["getReactI18nCache","getI18nConfig","getShouldTranslate","isReadonlyConditionStoreInitialized","getReadonlyConditionStore"],"sources":["../../../src/functions/translation/t.ts"],"sourcesContent":["import {\n  createLookupOptions,\n  getRuntimeEnvironment,\n  interpolateMessage,\n} from 'gt-i18n/internal';\nimport type { GTTranslationOptions } from 'gt-i18n/types';\nimport type { LookupOptionsFor } from 'gt-i18n/internal/types';\nimport { getI18nConfig } from '../../setup/i18nConfig';\nimport {\n  getReadonlyConditionStore,\n  isReadonlyConditionStoreInitialized,\n} from '../../condition-store/singleton-operations';\nimport { StringContent, StringFormat } from 'generaltranslation/types';\nimport { getReactI18nCache } from '../../i18n-cache/singleton-operations';\nimport { getShouldTranslate } from '../../hooks/utils/getShouldTranslate';\nimport { createDiagnosticMessage } from 'generaltranslation/internal';\n\n/**\n * Translate a message\n * @param {string} message - The message to translate.\n * @param {GTTranslationOptions} [options] - The options for the translation.\n * @returns {string} The translated message.\n *\n * @example\n * t('Hello, world!'); // Translates 'Hello, world!'\n *\n * @example\n * t('Hello, {name}!', { name: 'John' }); // Translates 'Hello, John!'\n *\n * @example\n * t`Hello, ${name}` // Translate via tagged template literal\n *\n */\nexport const t: StringOrTemplateSyncResolutionFunction = (\n  messageOrStrings: string | TemplateStringsArray,\n  ...values: unknown[]\n) => {\n  // Warnings and errors\n  enforceSSRRules(messageOrStrings);\n\n  //  t(\"Hello, {name}!\", { name: \"John\" })\n  if (typeof messageOrStrings === 'string') {\n    const options = values.at(0) as GTTranslationOptions | undefined;\n    const locale = options?.$locale ?? getLocale();\n    return resolveStringContent(\n      locale,\n      messageOrStrings,\n      createLookupOptions(locale, options ?? {}, 'ICU')\n    );\n  }\n\n  // t`Hello, ${name}`\n  return handleTaggedTemplateLiteralTranslation(messageOrStrings, values);\n};\n\n// ----- Helper Functions ----- //\n\nexport function resolveStringContent(\n  locale: string,\n  content: StringContent,\n  options: LookupOptionsFor<StringFormat> = {}\n): StringContent {\n  const i18nCache = getReactI18nCache();\n  const defaultLocale = getI18nConfig().getDefaultLocale();\n  if (!getShouldTranslate()) {\n    return interpolateMessage({\n      options,\n      source: content,\n      sourceLocale: defaultLocale,\n    });\n  }\n\n  const lookupOptions = createLookupOptions(locale, options, 'ICU');\n  const translation = i18nCache.lookupTranslation(\n    lookupOptions.$locale,\n    content,\n    lookupOptions\n  );\n  return interpolateMessage({\n    source: content,\n    target: translation,\n    options: lookupOptions,\n    sourceLocale: defaultLocale,\n  });\n}\n\n/**\n * Handle tagged template literal translation\n * @param messageOrStrings - The message or strings to translate.\n * @param values - The values to interpolate.\n * @returns The translated message.\n *\n * This is triggered when there has been no compiler transformation\n *\n * Try looking up interpolated template first\n * If not found, resolve uninterpolated message\n */\nfunction handleTaggedTemplateLiteralTranslation(\n  messageOrStrings: TemplateStringsArray,\n  values: unknown[]\n): string {\n  const locale = getLocale();\n  // for tagged template literals, there has been no compiler transformation\n  // (1) lookup interpolated template (aka derived message)\n  const interpolatedTemplate = interpolateTemplateLiteral(\n    messageOrStrings,\n    values\n  );\n  const i18nCache = getReactI18nCache();\n  const translatedInterpolatedTemplate = i18nCache.lookupTranslation(\n    locale,\n    interpolatedTemplate,\n    { $format: 'STRING' }\n  );\n  if (translatedInterpolatedTemplate) return translatedInterpolatedTemplate;\n\n  // (2) resolve uninterpolated message\n  const { message, variables } = extractInterpolatableValues(\n    messageOrStrings,\n    values\n  );\n  return resolveStringContent(locale, message, variables);\n}\n\n/**\n * Given a TemplateStringsArray, and values, return the uninterpolated message and variables.\n * @param strings - The template strings.\n * @param values - The values to interpolate.\n * @returns The interpolated message and variables.\n */\nfunction extractInterpolatableValues(\n  strings: TemplateStringsArray,\n  values: unknown[]\n): {\n  message: string;\n  variables: Record<string, unknown>;\n} {\n  // String parts\n  const parts: string[] = [];\n  // Variables\n  const variables: Record<string, unknown> = {};\n  let varIndex = 0;\n\n  for (let i = 0; i < strings.length; i++) {\n    // Add the cooked text from the quasi (use cooked to handle escape sequences)\n    parts.push(strings[i]);\n\n    // If there's a corresponding expression, create a variable placeholder\n    if (i < values.length) {\n      const key = varIndex.toString();\n      parts.push(`{${key}}`);\n      variables[key] = values[i];\n      varIndex++;\n    }\n  }\n\n  return {\n    message: parts.join(''),\n    variables,\n  };\n}\n\n/**\n * Interpolate a template literal\n * @param message - The message to interpolate.\n * @param variables - The variables to interpolate.\n * @returns The interpolated message.\n */\nfunction interpolateTemplateLiteral(\n  strings: TemplateStringsArray,\n  values: unknown[]\n): string {\n  return strings\n    .map((string, index) => {\n      return string + (values[index] ?? '');\n    })\n    .join('');\n}\n\n/**\n * Module-level t() only works for SPA.\n * We have to error or fallback in SSR.\n */\nfunction enforceSSRRules(messageOrStrings: string | TemplateStringsArray) {\n  const ssrEnabled = getI18nConfig().getRenderStrategy() === 'server-render';\n  const moduleLevel = !isReadonlyConditionStoreInitialized();\n  if (!ssrEnabled || !moduleLevel) return;\n\n  const message =\n    typeof messageOrStrings === 'string'\n      ? messageOrStrings\n      : messageOrStrings.join('');\n  const runtimeEnvironment = getRuntimeEnvironment();\n  const errorMessage = createDiagnosticMessage({\n    source: '@generaltranslation/react-core',\n    severity: 'Error',\n    whatHappened:\n      'Using the t() function at the module level is forbidden in server-rendered applications.',\n    fix: 'Either move the t() invocation into a request-time scope or register the string with the msg() function and translate with an m() function. Ensure that you have added the <GTProvider> at the root of your component tree.',\n    wayOut:\n      runtimeEnvironment === 'development'\n        ? undefined\n        : 'Falling back to defaultLocale value.',\n    details: `Message: \"${message}\"`,\n  });\n  if (getRuntimeEnvironment() === 'development') {\n    throw new Error(errorMessage);\n  } else {\n    console.error(errorMessage);\n  }\n}\n\nfunction getLocale(): string {\n  return getReadonlyConditionStore().getLocale();\n}\n\n/**\n * Overloaded type for the `t` function.\n * - Tagged template: t`Hello, ${name}` (transformed by the compiler plugin at build time)\n * - Function call: t(\"Hello, {name}\", { name: \"John\" })\n *\n * {@link TemplateSyncResolutionFunction}\n * {@link SyncResolutionFunction}\n */\ninterface StringOrTemplateSyncResolutionFunction {\n  (strings: TemplateStringsArray, ...values: unknown[]): string;\n  (message: string, options?: GTTranslationOptions): string;\n}\n\n/**\n * Type for the `t` function when used as a tagged template literal.\n * @param strings - The template strings.\n * @param values - The values to interpolate.\n * @returns The translated message.\n */\ntype TemplateSyncResolutionFunction = (\n  strings: TemplateStringsArray,\n  ...values: unknown[]\n) => string;\n"],"mappings":"kVAiCA,MAAa,GACX,EACA,GAAG,IACA,CAKH,GAHA,EAAgB,EAAiB,CAG7B,OAAO,GAAqB,SAAU,CACxC,IAAM,EAAU,EAAO,GAAG,EAAE,CACtB,EAAS,GAAS,SAAW,GAAW,CAC9C,OAAO,EACL,EACA,GAAA,EAAA,EAAA,qBACoB,EAAQ,GAAW,EAAE,CAAE,MAAM,CAClD,CAIH,OAAO,EAAuC,EAAkB,EAAO,EAKzE,SAAgB,EACd,EACA,EACA,EAA0C,EAAE,CAC7B,CACf,IAAM,EAAYA,EAAAA,mBAAmB,CAC/B,EAAgBC,EAAAA,eAAe,CAAC,kBAAkB,CACxD,GAAI,CAACC,EAAAA,oBAAoB,CACvB,OAAA,EAAA,EAAA,oBAA0B,CACxB,UACA,OAAQ,EACR,aAAc,EACf,CAAC,CAGJ,IAAM,GAAA,EAAA,EAAA,qBAAoC,EAAQ,EAAS,MAAM,CAMjE,OAAA,EAAA,EAAA,oBAA0B,CACxB,OAAQ,EACR,OAPkB,EAAU,kBAC5B,EAAc,QACd,EACA,EAImB,CACnB,QAAS,EACT,aAAc,EACf,CAAC,CAcJ,SAAS,EACP,EACA,EACQ,CACR,IAAM,EAAS,GAAW,CAGpB,EAAuB,EAC3B,EACA,EACD,CAEK,EADYF,EAAAA,mBAC8B,CAAC,kBAC/C,EACA,EACA,CAAE,QAAS,SAAU,CACtB,CACD,GAAI,EAAgC,OAAO,EAG3C,GAAM,CAAE,UAAS,aAAc,EAC7B,EACA,EACD,CACD,OAAO,EAAqB,EAAQ,EAAS,EAAU,CASzD,SAAS,EACP,EACA,EAIA,CAEA,IAAM,EAAkB,EAAE,CAEpB,EAAqC,EAAE,CACzC,EAAW,EAEf,IAAK,IAAI,EAAI,EAAG,EAAI,EAAQ,OAAQ,IAKlC,GAHA,EAAM,KAAK,EAAQ,GAAG,CAGlB,EAAI,EAAO,OAAQ,CACrB,IAAM,EAAM,EAAS,UAAU,CAC/B,EAAM,KAAK,IAAI,EAAI,GAAG,CACtB,EAAU,GAAO,EAAO,GACxB,IAIJ,MAAO,CACL,QAAS,EAAM,KAAK,GAAG,CACvB,YACD,CASH,SAAS,EACP,EACA,EACQ,CACR,OAAO,EACJ,KAAK,EAAQ,IACL,GAAU,EAAO,IAAU,IAClC,CACD,KAAK,GAAG,CAOb,SAAS,EAAgB,EAAiD,CACxE,IAAM,EAAaC,EAAAA,eAAe,CAAC,mBAAmB,GAAK,gBACrD,EAAc,CAACE,EAAAA,6BAAqC,CAC1D,GAAI,CAAC,GAAc,CAAC,EAAa,OAEjC,IAAM,EACJ,OAAO,GAAqB,SACxB,EACA,EAAiB,KAAK,GAAG,CAEzB,GAAA,EAAA,EAAA,yBAAuC,CAC3C,OAAQ,iCACR,SAAU,QACV,aACE,2FACF,IAAK,8NACL,QAAA,EAAA,EAAA,wBACoB,GAAK,cACnB,IAAA,GACA,uCACN,QAAS,aAAa,EAAQ,GAC/B,CAAC,CACF,IAAA,EAAA,EAAA,wBAA2B,GAAK,cAC9B,MAAU,MAAM,EAAa,CAE7B,QAAQ,MAAM,EAAa,CAI/B,SAAS,GAAoB,CAC3B,OAAOC,EAAAA,mBAA2B,CAAC,WAAW"}

package/dist/functions/translation/t.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"t.d.ts","names":[],"sources":["../../../src/functions/translation/t.ts"],"mappings":";;;;AAgCA;;;;;AA+CC;;;;;;;;;cA/CY,CAAA,EAAG,sCAAA;;;;;;;;;UA2LN,sCAAA;EAAA,CACP,OAAA,EAAS,oBAAA,KAAyB,MAAA;EAAA,CAClC,OAAA,UAAiB,OAAA,GAAU,oBAAA;AAAA"}
+{"version":3,"file":"t.d.ts","names":[],"sources":["../../../src/functions/translation/t.ts"],"mappings":";;;;AAiCA;;;;;AAmDC;;;;;;;;;cAnDY,CAAA,EAAG,sCAAA;;;;;;;;;UA+LN,sCAAA;EAAA,CACP,OAAA,EAAS,oBAAA,KAAyB,MAAA;EAAA,CAClC,OAAA,UAAiB,OAAA,GAAU,oBAAA;AAAA"}