gt-react 11.0.2 → 11.0.4

package/dist/index.rsc.mjs

@@ -1,8 +1,28 @@
-import { GtInternalRuntimeTranslateJsx, GtInternalRuntimeTranslateString, getGT, getI18nConfig, getMessages, getTranslations } from "gt-i18n/internal";
+import { ReactI18nCache, declareVar, decodeMsg, decodeOptions, decodeVars, derive, getDefaultLocale, getI18nConfig, getLocaleProperties, getLocales, getVersionId, gtFallback, internalInitializeGTSRA as initializeGT, mFallback, msg, resolveCanonicalLocale } from "@generaltranslation/react-core/pure";
+import { GtInternalRuntimeTranslateJsx, GtInternalRuntimeTranslateString, getCookieValue, getGT, getI18nConfig as getI18nConfig$1, getMessages, getTranslations, parseAcceptLanguage } from "gt-i18n/internal";
 import { getLocale, getRegion } from "gt-i18n";
 import { use } from "react";
 import { Branch, Currency, DateTime, Derive, GtInternalVar, Num, Plural, RelativeTime, T, T as GtInternalTranslateJsx, Tx, Var, createRenderPipeline, getFormatLocales, getReactI18nCache, getTranslationsSnapshot, setReactI18nCache, t } from "@generaltranslation/react-core/components-rsc";
-import { ReactI18nCache, declareVar, decodeMsg, decodeOptions, decodeVars, derive, getDefaultLocale, getLocaleProperties, getLocales, getVersionId, gtFallback, internalInitializeGTSRA as initializeGT, mFallback, msg, resolveCanonicalLocale } from "@generaltranslation/react-core/pure";
+//#region src/functions/parseLocale.ts
+/**
+* Resolve the user's locale from a Web Request.
+*
+* The configured locale cookie takes precedence over the Accept-Language
+* header. If neither contains a supported locale, the configured default
+* locale is returned.
+*
+* This is intended for incoming server requests. A Request created in the
+* browser does not automatically include document cookies or Accept-Language.
+*/
+function parseLocale(request) {
+	const i18nConfig = getI18nConfig();
+	const candidates = [];
+	const cookieLocale = getCookieValue(request.headers.get("cookie"), i18nConfig.getLocaleCookieName());
+	if (cookieLocale) candidates.push(cookieLocale);
+	candidates.push(...parseAcceptLanguage(request.headers.get("accept-language")));
+	return i18nConfig.resolveSupportedLocale(candidates);
+}
+//#endregion
 //#region ../core/dist/api-BOEGbEF6.mjs
 function ensureSentence(text) {
 	const trimmed = text.trim();
@@ -78,21 +98,21 @@ function useRegion() {
 	return getRegion();
 }
 function useLocales() {
-	return getI18nConfig().getLocales();
+	return getI18nConfig$1().getLocales();
 }
 function useLocaleDirection(locale) {
-	return getI18nConfig().getGTClass().getLocaleDirection(locale);
+	return getI18nConfig$1().getGTClass().getLocaleDirection(locale);
 }
 function useLocaleProperties(locale) {
-	return getI18nConfig().getGTClass().getLocaleProperties(locale);
+	return getI18nConfig$1().getGTClass().getLocaleProperties(locale);
 }
 function useDefaultLocale() {
-	return getI18nConfig().getDefaultLocale();
+	return getI18nConfig$1().getDefaultLocale();
 }
 function useCustomMapping() {
-	return getI18nConfig().getCustomMapping();
+	return getI18nConfig$1().getCustomMapping();
 }
 //#endregion
-export { Branch, Currency, DateTime, Derive, GTProvider, GtInternalRuntimeTranslateJsx, GtInternalRuntimeTranslateString, GtInternalTranslateJsx, GtInternalVar, LocaleSelector, Num, Plural, ReactI18nCache, RegionSelector, RelativeTime, T, Tx, Var, createRenderPipeline, declareVar, decodeMsg, decodeOptions, decodeVars, derive, getDefaultLocale, getFormatLocales, getLocaleProperties, getLocales, getReactI18nCache, getTranslationsSnapshot, getVersionId, gtFallback, initializeGT, mFallback, msg, resolveCanonicalLocale, setReactI18nCache, t, useCustomMapping, useDefaultLocale, useGT, useLocale, useLocaleDirection, useLocaleProperties, useLocales, useMessages, useRegion, useTranslations };
+export { Branch, Currency, DateTime, Derive, GTProvider, GtInternalRuntimeTranslateJsx, GtInternalRuntimeTranslateString, GtInternalTranslateJsx, GtInternalVar, LocaleSelector, Num, Plural, ReactI18nCache, RegionSelector, RelativeTime, T, Tx, Var, createRenderPipeline, declareVar, decodeMsg, decodeOptions, decodeVars, derive, getDefaultLocale, getFormatLocales, getLocaleProperties, getLocales, getReactI18nCache, getTranslationsSnapshot, getVersionId, gtFallback, initializeGT, mFallback, msg, parseLocale, resolveCanonicalLocale, setReactI18nCache, t, useCustomMapping, useDefaultLocale, useGT, useLocale, useLocaleDirection, useLocaleProperties, useLocales, useMessages, useRegion, useTranslations };
 
 //# sourceMappingURL=index.rsc.mjs.map

package/dist/index.rsc.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.rsc.mjs","names":[],"sources":["../../core/dist/api-BOEGbEF6.mjs","../src/index.rsc.ts"],"sourcesContent":["//#region src/settings/settings.ts\nconst libraryDefaultLocale = \"en\";\nconst defaultTimeout = 6e4;\n//#endregion\n//#region src/logging/diagnostics.ts\nfunction ensureSentence(text) {\n\tconst trimmed = text.trim();\n\tif (!trimmed) return \"\";\n\treturn /[.!?)]$/.test(trimmed) ? trimmed : `${trimmed}.`;\n}\nfunction stripSentence(text) {\n\tconst trimmed = text.trim();\n\tlet end = trimmed.length;\n\twhile (end > 0) {\n\t\tconst char = trimmed[end - 1];\n\t\tif (char !== \".\" && char !== \"!\" && char !== \"?\") break;\n\t\tend -= 1;\n\t}\n\treturn trimmed.slice(0, end);\n}\nfunction lowercaseFirstWord(text) {\n\treturn text.replace(/^[A-Z][a-z]/, (match) => match.toLowerCase());\n}\nfunction formatDetails(details) {\n\tif (!details) return \"\";\n\tconst detailText = Array.isArray(details) ? details.join(\", \") : details;\n\tif (!detailText.trim()) return \"\";\n\treturn ensureSentence(`Details: ${detailText}`);\n}\nfunction formatDiagnosticErrorDetails(error) {\n\tif (error == null) return void 0;\n\treturn String(error);\n}\nfunction createDiagnosticMessage({ source, severity, whatHappened, reassurance, why, fix, wayOut, details, docsUrl }) {\n\tconst prefix = source ? severity ? `${source} ${severity}:` : `${source}:` : severity ? `${severity}:` : \"\";\n\tconst whatAndWhy = why ? `${stripSentence(whatHappened)} because ${lowercaseFirstWord(stripSentence(why))}` : whatHappened;\n\tconst shouldCombineWayOut = !!fix && !!wayOut && /^[a-z]/.test(stripSentence(wayOut));\n\tconst messageParts = [\n\t\twhatAndWhy,\n\t\treassurance,\n\t\tshouldCombineWayOut ? `${stripSentence(fix)}, or ${lowercaseFirstWord(stripSentence(wayOut))}` : fix,\n\t\tshouldCombineWayOut ? void 0 : wayOut,\n\t\tformatDetails(details)\n\t].filter((part) => !!part).map(ensureSentence);\n\tif (docsUrl) messageParts.push(`Learn more: ${docsUrl}`);\n\tconst message = messageParts.join(\" \");\n\treturn prefix ? `${prefix} ${message}` : message;\n}\n//#endregion\n//#region src/settings/settingsUrls.ts\nconst defaultCacheUrl = \"https://cdn.gtx.dev\";\nconst defaultBaseUrl = \"https://api2.gtx.dev\";\nconst defaultRuntimeApiUrl = \"https://runtime2.gtx.dev\";\n//#endregion\n//#region src/translate/api.ts\nconst API_VERSION = \"2026-03-06.v1\";\n//#endregion\nexport { createDiagnosticMessage as a, libraryDefaultLocale as c, defaultRuntimeApiUrl as i, defaultBaseUrl as n, formatDiagnosticErrorDetails as o, defaultCacheUrl as r, defaultTimeout as s, API_VERSION as t };\n\n//# sourceMappingURL=api-BOEGbEF6.mjs.map","// React Server Component context surface.\n\nimport { createDiagnosticMessage } from 'generaltranslation/internal';\nimport { CustomMapping } from 'generaltranslation/types';\nimport {\n  getGT,\n  getI18nConfig,\n  getMessages,\n  getTranslations,\n} from 'gt-i18n/internal';\nimport { getLocale, getRegion } from 'gt-i18n';\nimport { use } from 'react';\n\n// ===== Error for client components ===== //\nfunction failClientComponent(componentName: string) {\n  throw new Error(\n    createDiagnosticMessage({\n      source: 'gt-react',\n      severity: 'Error',\n      whatHappened: `${componentName} cannot be consumed via the RSC entry point`,\n      fix: 'Import this component from a client or server runtime entry point instead.',\n    })\n  );\n}\n\nexport function GTProvider() {\n  return failClientComponent('GTProvider');\n}\nexport function LocaleSelector() {\n  return failClientComponent('LocaleSelector');\n}\nexport function RegionSelector() {\n  return failClientComponent('RegionSelector');\n}\n\n// ===== Components ===== //\nexport {\n  Branch,\n  Currency,\n  DateTime,\n  Derive,\n  Num,\n  Plural,\n  RelativeTime,\n  T,\n  Var,\n  Tx,\n} from '@generaltranslation/react-core/components-rsc';\n\n// ===== Hooks (cannot reference context) ===== //\n\nexport function useGT() {\n  return use(getGT());\n}\nexport function useTranslations(rootId?: string) {\n  return use(getTranslations(rootId));\n}\nexport function useMessages() {\n  return use(getMessages());\n}\nexport function useLocale() {\n  return getLocale();\n}\nexport function useRegion() {\n  return getRegion();\n}\nexport function useLocales() {\n  return getI18nConfig().getLocales();\n}\nexport function useLocaleDirection(locale: string) {\n  return getI18nConfig().getGTClass().getLocaleDirection(locale);\n}\nexport function useLocaleProperties(locale: string) {\n  return getI18nConfig().getGTClass().getLocaleProperties(locale);\n}\nexport function useDefaultLocale(): string {\n  return getI18nConfig().getDefaultLocale();\n}\nexport function useCustomMapping(): CustomMapping {\n  return getI18nConfig().getCustomMapping();\n}\n// ===== Internal Components ===== //\nexport {\n  T as GtInternalTranslateJsx,\n  GtInternalVar,\n} from '@generaltranslation/react-core/components-rsc';\n\n// ===== Render Helpers ===== //\nexport { createRenderPipeline } from '@generaltranslation/react-core/components-rsc';\n\n// ===== Translation Helpers ===== //\nexport {\n  getFormatLocales,\n  getTranslationsSnapshot,\n  t,\n} from '@generaltranslation/react-core/components-rsc';\n\n// ===== Internal ===== //\nexport {\n  getReactI18nCache,\n  setReactI18nCache,\n} from '@generaltranslation/react-core/components-rsc';\n\n// ===== Functions ===== //\nexport {\n  decodeMsg,\n  decodeOptions,\n  decodeVars,\n  declareVar,\n  derive,\n  gtFallback,\n  mFallback,\n  msg,\n  getDefaultLocale,\n  getLocaleProperties,\n  getLocales,\n  resolveCanonicalLocale,\n  getVersionId,\n} from '@generaltranslation/react-core/pure';\n\n// ===== Setup ===== //\nexport { internalInitializeGTSRA as initializeGT } from '@generaltranslation/react-core/pure';\n\n// ===== Types ===== //\nexport type {\n  CurrencyProps,\n  DateTimeProps,\n  JsxTranslationOptions,\n  NumProps,\n  PluralProps,\n  PreparedT,\n  RelativeTimeFormatOptions,\n  RelativeTimeProps,\n  RenderVariable,\n  ResolvedCurrencyProps,\n  ResolvedDateTimeProps,\n  ResolvedNumProps,\n  ResolvedPluralProps,\n  ResolvedRelativeTimeProps,\n} from '@generaltranslation/react-core/components-rsc';\n\nexport type {\n  RenderPipeline,\n  RenderPreparedT,\n} from '@generaltranslation/react-core/pure';\n\nexport type { SharedGTProviderProps } from './provider/GTProviderProps';\nexport {\n  GtInternalRuntimeTranslateJsx,\n  GtInternalRuntimeTranslateString,\n} from 'gt-i18n/internal';\nexport type {\n  GTTranslationOptions,\n  RuntimeTranslationOptions,\n} from 'gt-i18n/types';\nexport type {\n  SyncResolutionFunction,\n  SyncResolutionFunctionWithFallback,\n} from 'gt-i18n/types';\n\n// ===== Singletons ===== //\nexport {\n  ReactI18nCache,\n  type ReactI18nCacheParams,\n} from '@generaltranslation/react-core/pure';\n"],"mappings":";;;;;;AAKA,SAAS,eAAe,MAAM;CAC7B,MAAM,UAAU,KAAK,MAAM;AAC3B,KAAI,CAAC,QAAS,QAAO;AACrB,QAAO,UAAU,KAAK,QAAQ,GAAG,UAAU,GAAG,QAAQ;;AAEvD,SAAS,cAAc,MAAM;CAC5B,MAAM,UAAU,KAAK,MAAM;CAC3B,IAAI,MAAM,QAAQ;AAClB,QAAO,MAAM,GAAG;EACf,MAAM,OAAO,QAAQ,MAAM;AAC3B,MAAI,SAAS,OAAO,SAAS,OAAO,SAAS,IAAK;AAClD,SAAO;;AAER,QAAO,QAAQ,MAAM,GAAG,IAAI;;AAE7B,SAAS,mBAAmB,MAAM;AACjC,QAAO,KAAK,QAAQ,gBAAgB,UAAU,MAAM,aAAa,CAAC;;AAEnE,SAAS,cAAc,SAAS;AAC/B,KAAI,CAAC,QAAS,QAAO;CACrB,MAAM,aAAa,MAAM,QAAQ,QAAQ,GAAG,QAAQ,KAAK,KAAK,GAAG;AACjE,KAAI,CAAC,WAAW,MAAM,CAAE,QAAO;AAC/B,QAAO,eAAe,YAAY,aAAa;;AAMhD,SAAS,wBAAwB,EAAE,QAAQ,UAAU,cAAc,aAAa,KAAK,KAAK,QAAQ,SAAS,WAAW;CACrH,MAAM,SAAS,SAAS,WAAW,GAAG,OAAO,GAAG,SAAS,KAAK,GAAG,OAAO,KAAK,WAAW,GAAG,SAAS,KAAK;CACzG,MAAM,aAAa,MAAM,GAAG,cAAc,aAAa,CAAC,WAAW,mBAAmB,cAAc,IAAI,CAAC,KAAK;CAC9G,MAAM,sBAAsB,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,SAAS,KAAK,cAAc,OAAO,CAAC;CACrF,MAAM,eAAe;EACpB;EACA;EACA,sBAAsB,GAAG,cAAc,IAAI,CAAC,OAAO,mBAAmB,cAAc,OAAO,CAAC,KAAK;EACjG,sBAAsB,KAAK,IAAI;EAC/B,cAAc,QAAQ;EACtB,CAAC,QAAQ,SAAS,CAAC,CAAC,KAAK,CAAC,IAAI,eAAe;AAC9C,KAAI,QAAS,cAAa,KAAK,eAAe,UAAU;CACxD,MAAM,UAAU,aAAa,KAAK,IAAI;AACtC,QAAO,SAAS,GAAG,OAAO,GAAG,YAAY;;;;AChC1C,SAAS,oBAAoB,eAAuB;AAClD,OAAM,IAAI,MACR,wBAAwB;EACtB,QAAQ;EACR,UAAU;EACV,cAAc,GAAG,cAAc;EAC/B,KAAK;EACN,CAAC,CACH;;AAGH,SAAgB,aAAa;AAC3B,QAAO,oBAAoB,aAAa;;AAE1C,SAAgB,iBAAiB;AAC/B,QAAO,oBAAoB,iBAAiB;;AAE9C,SAAgB,iBAAiB;AAC/B,QAAO,oBAAoB,iBAAiB;;AAmB9C,SAAgB,QAAQ;AACtB,QAAO,IAAI,OAAO,CAAC;;AAErB,SAAgB,gBAAgB,QAAiB;AAC/C,QAAO,IAAI,gBAAgB,OAAO,CAAC;;AAErC,SAAgB,cAAc;AAC5B,QAAO,IAAI,aAAa,CAAC;;AAE3B,SAAgB,YAAY;AAC1B,QAAO,WAAW;;AAEpB,SAAgB,YAAY;AAC1B,QAAO,WAAW;;AAEpB,SAAgB,aAAa;AAC3B,QAAO,eAAe,CAAC,YAAY;;AAErC,SAAgB,mBAAmB,QAAgB;AACjD,QAAO,eAAe,CAAC,YAAY,CAAC,mBAAmB,OAAO;;AAEhE,SAAgB,oBAAoB,QAAgB;AAClD,QAAO,eAAe,CAAC,YAAY,CAAC,oBAAoB,OAAO;;AAEjE,SAAgB,mBAA2B;AACzC,QAAO,eAAe,CAAC,kBAAkB;;AAE3C,SAAgB,mBAAkC;AAChD,QAAO,eAAe,CAAC,kBAAkB"}
+{"version":3,"file":"index.rsc.mjs","names":["getI18nConfig"],"sources":["../src/functions/parseLocale.ts","../../core/dist/api-BOEGbEF6.mjs","../src/index.rsc.ts"],"sourcesContent":["import { getI18nConfig } from '@generaltranslation/react-core/pure';\nimport { getCookieValue, parseAcceptLanguage } from 'gt-i18n/internal';\n\ntype RequestWithHeaders = Pick<Request, 'headers'>;\n\n/**\n * Resolve the user's locale from a Web Request.\n *\n * The configured locale cookie takes precedence over the Accept-Language\n * header. If neither contains a supported locale, the configured default\n * locale is returned.\n *\n * This is intended for incoming server requests. A Request created in the\n * browser does not automatically include document cookies or Accept-Language.\n */\nexport function parseLocale(request: RequestWithHeaders): string {\n  const i18nConfig = getI18nConfig();\n  const candidates: string[] = [];\n  const cookieLocale = getCookieValue(\n    request.headers.get('cookie'),\n    i18nConfig.getLocaleCookieName()\n  );\n\n  if (cookieLocale) {\n    candidates.push(cookieLocale);\n  }\n\n  candidates.push(\n    ...parseAcceptLanguage(request.headers.get('accept-language'))\n  );\n\n  return i18nConfig.resolveSupportedLocale(candidates);\n}\n","//#region src/settings/settings.ts\nconst libraryDefaultLocale = \"en\";\nconst defaultTimeout = 6e4;\n//#endregion\n//#region src/logging/diagnostics.ts\nfunction ensureSentence(text) {\n\tconst trimmed = text.trim();\n\tif (!trimmed) return \"\";\n\treturn /[.!?)]$/.test(trimmed) ? trimmed : `${trimmed}.`;\n}\nfunction stripSentence(text) {\n\tconst trimmed = text.trim();\n\tlet end = trimmed.length;\n\twhile (end > 0) {\n\t\tconst char = trimmed[end - 1];\n\t\tif (char !== \".\" && char !== \"!\" && char !== \"?\") break;\n\t\tend -= 1;\n\t}\n\treturn trimmed.slice(0, end);\n}\nfunction lowercaseFirstWord(text) {\n\treturn text.replace(/^[A-Z][a-z]/, (match) => match.toLowerCase());\n}\nfunction formatDetails(details) {\n\tif (!details) return \"\";\n\tconst detailText = Array.isArray(details) ? details.join(\", \") : details;\n\tif (!detailText.trim()) return \"\";\n\treturn ensureSentence(`Details: ${detailText}`);\n}\nfunction formatDiagnosticErrorDetails(error) {\n\tif (error == null) return void 0;\n\treturn String(error);\n}\nfunction createDiagnosticMessage({ source, severity, whatHappened, reassurance, why, fix, wayOut, details, docsUrl }) {\n\tconst prefix = source ? severity ? `${source} ${severity}:` : `${source}:` : severity ? `${severity}:` : \"\";\n\tconst whatAndWhy = why ? `${stripSentence(whatHappened)} because ${lowercaseFirstWord(stripSentence(why))}` : whatHappened;\n\tconst shouldCombineWayOut = !!fix && !!wayOut && /^[a-z]/.test(stripSentence(wayOut));\n\tconst messageParts = [\n\t\twhatAndWhy,\n\t\treassurance,\n\t\tshouldCombineWayOut ? `${stripSentence(fix)}, or ${lowercaseFirstWord(stripSentence(wayOut))}` : fix,\n\t\tshouldCombineWayOut ? void 0 : wayOut,\n\t\tformatDetails(details)\n\t].filter((part) => !!part).map(ensureSentence);\n\tif (docsUrl) messageParts.push(`Learn more: ${docsUrl}`);\n\tconst message = messageParts.join(\" \");\n\treturn prefix ? `${prefix} ${message}` : message;\n}\n//#endregion\n//#region src/settings/settingsUrls.ts\nconst defaultCacheUrl = \"https://cdn.gtx.dev\";\nconst defaultBaseUrl = \"https://api2.gtx.dev\";\nconst defaultRuntimeApiUrl = \"https://runtime2.gtx.dev\";\n//#endregion\n//#region src/translate/api.ts\nconst API_VERSION = \"2026-03-06.v1\";\n//#endregion\nexport { createDiagnosticMessage as a, libraryDefaultLocale as c, defaultRuntimeApiUrl as i, defaultBaseUrl as n, formatDiagnosticErrorDetails as o, defaultCacheUrl as r, defaultTimeout as s, API_VERSION as t };\n\n//# sourceMappingURL=api-BOEGbEF6.mjs.map","// React Server Component context surface.\n\nexport { parseLocale } from './functions/parseLocale';\n\nimport { createDiagnosticMessage } from 'generaltranslation/internal';\nimport { CustomMapping } from 'generaltranslation/types';\nimport {\n  getGT,\n  getI18nConfig,\n  getMessages,\n  getTranslations,\n} from 'gt-i18n/internal';\nimport { getLocale, getRegion } from 'gt-i18n';\nimport { use } from 'react';\n\n// ===== Error for client components ===== //\nfunction failClientComponent(componentName: string) {\n  throw new Error(\n    createDiagnosticMessage({\n      source: 'gt-react',\n      severity: 'Error',\n      whatHappened: `${componentName} cannot be consumed via the RSC entry point`,\n      fix: 'Import this component from a client or server runtime entry point instead.',\n    })\n  );\n}\n\nexport function GTProvider() {\n  return failClientComponent('GTProvider');\n}\nexport function LocaleSelector() {\n  return failClientComponent('LocaleSelector');\n}\nexport function RegionSelector() {\n  return failClientComponent('RegionSelector');\n}\n\n// ===== Components ===== //\nexport {\n  Branch,\n  Currency,\n  DateTime,\n  Derive,\n  Num,\n  Plural,\n  RelativeTime,\n  T,\n  Var,\n  Tx,\n} from '@generaltranslation/react-core/components-rsc';\n\n// ===== Hooks (cannot reference context) ===== //\n\nexport function useGT() {\n  return use(getGT());\n}\nexport function useTranslations(rootId?: string) {\n  return use(getTranslations(rootId));\n}\nexport function useMessages() {\n  return use(getMessages());\n}\nexport function useLocale() {\n  return getLocale();\n}\nexport function useRegion() {\n  return getRegion();\n}\nexport function useLocales() {\n  return getI18nConfig().getLocales();\n}\nexport function useLocaleDirection(locale: string) {\n  return getI18nConfig().getGTClass().getLocaleDirection(locale);\n}\nexport function useLocaleProperties(locale: string) {\n  return getI18nConfig().getGTClass().getLocaleProperties(locale);\n}\nexport function useDefaultLocale(): string {\n  return getI18nConfig().getDefaultLocale();\n}\nexport function useCustomMapping(): CustomMapping {\n  return getI18nConfig().getCustomMapping();\n}\n// ===== Internal Components ===== //\nexport {\n  T as GtInternalTranslateJsx,\n  GtInternalVar,\n} from '@generaltranslation/react-core/components-rsc';\n\n// ===== Render Helpers ===== //\nexport { createRenderPipeline } from '@generaltranslation/react-core/components-rsc';\n\n// ===== Translation Helpers ===== //\nexport {\n  getFormatLocales,\n  getTranslationsSnapshot,\n  t,\n} from '@generaltranslation/react-core/components-rsc';\n\n// ===== Internal ===== //\nexport {\n  getReactI18nCache,\n  setReactI18nCache,\n} from '@generaltranslation/react-core/components-rsc';\n\n// ===== Functions ===== //\nexport {\n  decodeMsg,\n  decodeOptions,\n  decodeVars,\n  declareVar,\n  derive,\n  gtFallback,\n  mFallback,\n  msg,\n  getDefaultLocale,\n  getLocaleProperties,\n  getLocales,\n  resolveCanonicalLocale,\n  getVersionId,\n} from '@generaltranslation/react-core/pure';\n\n// ===== Setup ===== //\nexport { internalInitializeGTSRA as initializeGT } from '@generaltranslation/react-core/pure';\n\n// ===== Types ===== //\nexport type {\n  CurrencyProps,\n  DateTimeProps,\n  JsxTranslationOptions,\n  NumProps,\n  PluralProps,\n  PreparedT,\n  RelativeTimeFormatOptions,\n  RelativeTimeProps,\n  RenderVariable,\n  ResolvedCurrencyProps,\n  ResolvedDateTimeProps,\n  ResolvedNumProps,\n  ResolvedPluralProps,\n  ResolvedRelativeTimeProps,\n} from '@generaltranslation/react-core/components-rsc';\n\nexport type {\n  RenderPipeline,\n  RenderPreparedT,\n} from '@generaltranslation/react-core/pure';\n\nexport type { SharedGTProviderProps } from './provider/GTProviderProps';\nexport {\n  GtInternalRuntimeTranslateJsx,\n  GtInternalRuntimeTranslateString,\n} from 'gt-i18n/internal';\nexport type {\n  GTTranslationOptions,\n  RuntimeTranslationOptions,\n} from 'gt-i18n/types';\nexport type {\n  SyncResolutionFunction,\n  SyncResolutionFunctionWithFallback,\n} from 'gt-i18n/types';\n\n// ===== Singletons ===== //\nexport {\n  ReactI18nCache,\n  type ReactI18nCacheParams,\n} from '@generaltranslation/react-core/pure';\n"],"mappings":"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"}

package/dist/index.server.cjs

@@ -95,6 +95,26 @@ function initializeGTSRA(config) {
 	(0, _generaltranslation_react_core_pure.internalInitializeGTSRA)(addRuntimeCredentials(config));
 }
 //#endregion
+//#region src/functions/parseLocale.ts
+/**
+* Resolve the user's locale from a Web Request.
+*
+* The configured locale cookie takes precedence over the Accept-Language
+* header. If neither contains a supported locale, the configured default
+* locale is returned.
+*
+* This is intended for incoming server requests. A Request created in the
+* browser does not automatically include document cookies or Accept-Language.
+*/
+function parseLocale(request) {
+	const i18nConfig = (0, _generaltranslation_react_core_pure.getI18nConfig)();
+	const candidates = [];
+	const cookieLocale = (0, gt_i18n_internal.getCookieValue)(request.headers.get("cookie"), i18nConfig.getLocaleCookieName());
+	if (cookieLocale) candidates.push(cookieLocale);
+	candidates.push(...(0, gt_i18n_internal.parseAcceptLanguage)(request.headers.get("accept-language")));
+	return i18nConfig.resolveSupportedLocale(candidates);
+}
+//#endregion
 //#region src/hooks/conditions-store.ts
 /**
 * Returns a function that sets the locale
@@ -478,6 +498,7 @@ Object.defineProperty(exports, "msg", {
 		return _generaltranslation_react_core_pure.msg;
 	}
 });
+exports.parseLocale = parseLocale;
 Object.defineProperty(exports, "resolveCanonicalLocale", {
 	enumerable: true,
 	get: function() {

package/dist/index.server.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.server.cjs","names":["ReadonlyConditionStore","I18nStore","InternalGTProvider","InternalLocaleSelector","InternalRegionSelector"],"sources":["../../core/dist/api-BOEGbEF6.mjs","../src/setup/runtimeCredentials.ts","../src/setup/initializeGTSRA.ts","../src/hooks/conditions-store.ts","../src/components/useLocaleSelector.ts","../src/components/useRegionSelector.ts","../src/hooks/useHandleMissingTranslations.ts","../src/provider/ServerGTProvider.tsx","../src/components/LocaleSelector.tsx","../src/components/RegionSelector.tsx","../src/index.server.ts"],"sourcesContent":["//#region src/settings/settings.ts\nconst libraryDefaultLocale = \"en\";\nconst defaultTimeout = 6e4;\n//#endregion\n//#region src/logging/diagnostics.ts\nfunction ensureSentence(text) {\n\tconst trimmed = text.trim();\n\tif (!trimmed) return \"\";\n\treturn /[.!?)]$/.test(trimmed) ? trimmed : `${trimmed}.`;\n}\nfunction stripSentence(text) {\n\tconst trimmed = text.trim();\n\tlet end = trimmed.length;\n\twhile (end > 0) {\n\t\tconst char = trimmed[end - 1];\n\t\tif (char !== \".\" && char !== \"!\" && char !== \"?\") break;\n\t\tend -= 1;\n\t}\n\treturn trimmed.slice(0, end);\n}\nfunction lowercaseFirstWord(text) {\n\treturn text.replace(/^[A-Z][a-z]/, (match) => match.toLowerCase());\n}\nfunction formatDetails(details) {\n\tif (!details) return \"\";\n\tconst detailText = Array.isArray(details) ? details.join(\", \") : details;\n\tif (!detailText.trim()) return \"\";\n\treturn ensureSentence(`Details: ${detailText}`);\n}\nfunction formatDiagnosticErrorDetails(error) {\n\tif (error == null) return void 0;\n\treturn String(error);\n}\nfunction createDiagnosticMessage({ source, severity, whatHappened, reassurance, why, fix, wayOut, details, docsUrl }) {\n\tconst prefix = source ? severity ? `${source} ${severity}:` : `${source}:` : severity ? `${severity}:` : \"\";\n\tconst whatAndWhy = why ? `${stripSentence(whatHappened)} because ${lowercaseFirstWord(stripSentence(why))}` : whatHappened;\n\tconst shouldCombineWayOut = !!fix && !!wayOut && /^[a-z]/.test(stripSentence(wayOut));\n\tconst messageParts = [\n\t\twhatAndWhy,\n\t\treassurance,\n\t\tshouldCombineWayOut ? `${stripSentence(fix)}, or ${lowercaseFirstWord(stripSentence(wayOut))}` : fix,\n\t\tshouldCombineWayOut ? void 0 : wayOut,\n\t\tformatDetails(details)\n\t].filter((part) => !!part).map(ensureSentence);\n\tif (docsUrl) messageParts.push(`Learn more: ${docsUrl}`);\n\tconst message = messageParts.join(\" \");\n\treturn prefix ? `${prefix} ${message}` : message;\n}\n//#endregion\n//#region src/settings/settingsUrls.ts\nconst defaultCacheUrl = \"https://cdn.gtx.dev\";\nconst defaultBaseUrl = \"https://api2.gtx.dev\";\nconst defaultRuntimeApiUrl = \"https://runtime2.gtx.dev\";\n//#endregion\n//#region src/translate/api.ts\nconst API_VERSION = \"2026-03-06.v1\";\n//#endregion\nexport { createDiagnosticMessage as a, libraryDefaultLocale as c, defaultRuntimeApiUrl as i, defaultBaseUrl as n, formatDiagnosticErrorDetails as o, defaultCacheUrl as r, defaultTimeout as s, API_VERSION as t };\n\n//# sourceMappingURL=api-BOEGbEF6.mjs.map","import { getRuntimeEnvironment } from 'gt-i18n/internal';\nimport type { I18nConfigParams } from 'gt-i18n/internal/types';\n\ntype RuntimeCredentials = Pick<I18nConfigParams, 'projectId' | 'devApiKey'>;\ntype RuntimeEnv = {\n  DEV?: boolean;\n  VITE_GT_PROJECT_ID?: string;\n  VITE_GT_DEV_API_KEY?: string;\n};\n\nexport function addRuntimeCredentials<T extends RuntimeCredentials>(\n  config: T\n): T {\n  const credentials = getRuntimeCredentials();\n  return {\n    ...config,\n    projectId: config.projectId || credentials.projectId,\n    devApiKey: config.devApiKey || credentials.devApiKey,\n  };\n}\n\nfunction getRuntimeCredentials(): RuntimeCredentials {\n  return {\n    projectId:\n      readImportMetaVite(\n        () =>\n          (\n            import.meta as ImportMeta & {\n              env?: RuntimeEnv;\n            }\n          ).env?.VITE_GT_PROJECT_ID\n      ) || readProcessEnvViteProjectId(),\n    devApiKey:\n      getRuntimeEnvironment() === 'development'\n        ? readImportMetaVite(() =>\n            (import.meta as ImportMeta & { env?: RuntimeEnv }).env?.DEV\n              ? (import.meta as ImportMeta & { env?: RuntimeEnv }).env\n                  ?.VITE_GT_DEV_API_KEY\n              : undefined\n          ) || readProcessEnvViteDevApiKey()\n        : undefined,\n  };\n}\n\nfunction readImportMetaVite(\n  readValue: () => string | undefined\n): string | undefined {\n  try {\n    return normalizeEnvValue(readValue());\n  } catch {\n    return undefined;\n  }\n}\n\nfunction readProcessEnvViteProjectId(): string | undefined {\n  try {\n    return normalizeEnvValue(process.env.VITE_GT_PROJECT_ID);\n  } catch {\n    return undefined;\n  }\n}\n\nfunction readProcessEnvViteDevApiKey(): string | undefined {\n  try {\n    return normalizeEnvValue(process.env.VITE_GT_DEV_API_KEY);\n  } catch {\n    return undefined;\n  }\n}\n\nfunction normalizeEnvValue(value: string | undefined): string | undefined {\n  return value || undefined;\n}\n","import {\n  internalInitializeGTSRA,\n  type I18nConfigParams,\n  type ReactI18nCacheParams,\n} from '@generaltranslation/react-core/pure';\nimport { addRuntimeCredentials } from './runtimeCredentials';\n\n/**\n * Initialize GT for server-rendered React runtimes.\n */\nexport function initializeGTSRA(\n  config: I18nConfigParams & ReactI18nCacheParams\n): void {\n  internalInitializeGTSRA(addRuntimeCredentials(config));\n}\n","import { useCallback } from 'react';\nimport { useConditionStore } from '@generaltranslation/react-core/hooks';\n\n/**\n * Returns a function that sets the locale\n */\nexport function useSetLocale() {\n  const conditionStore = useConditionStore();\n  return useCallback(\n    (locale: string) => {\n      conditionStore.setLocale(locale);\n    },\n    [conditionStore]\n  );\n}\n\n/**\n * Returns a function that sets the region\n */\nexport function useSetRegion() {\n  const conditionStore = useConditionStore();\n  return useCallback(\n    (region: string | undefined) => {\n      conditionStore.setRegion(region);\n    },\n    [conditionStore]\n  );\n}\n\n/**\n * Returns a function that sets the enableI18n flag in the condition store.\n */\nexport function useSetEnableI18n() {\n  const conditionStore = useConditionStore();\n  return useCallback(\n    (enableI18n: boolean) => {\n      conditionStore.setEnableI18n(enableI18n);\n    },\n    [conditionStore]\n  );\n}\n","import { useSetLocale } from '../hooks/conditions-store';\nimport { useInternalLocaleSelector } from '@generaltranslation/react-core/hooks';\n\n/**\n * Gets the list of properties for using a locale selector.\n * Provides locale management utilities for the application.\n *\n * @param locales an optional list of locales to use for the drop down. These locales must be a subset of the locales provided by the `<GTProvider>` context. When not provided, the list of locales from the `<GTProvider>` context is used.\n *\n * @returns {Object} An object containing locale-related utilities:\n * @returns {string} return.locale - The currently selected locale.\n * @returns {string[]} return.locales - The list of all available locales.\n * @returns {function} return.setLocale - Function to update the current locale.\n * @returns {(locale: string) => LocaleProperties} return.getLocaleProperties - Function to retrieve properties for a given locale.\n */\nexport function useLocaleSelector(locales?: string[]) {\n  const setLocale = useSetLocale();\n  return { setLocale, ...useInternalLocaleSelector(locales) };\n}\n","import { useSetLocale, useSetRegion } from '../hooks/conditions-store';\nimport { useInternalRegionSelector } from '@generaltranslation/react-core/hooks';\nimport type { InternalRegionSelectorOptions } from '@generaltranslation/react-core/hooks';\n\n/**\n * Gets the list of properties for using a region selector.\n * Provides region management utilities for the application.\n *\n * @param {Object} [options] - Optional configuration object.\n * @param {string[]} [options.regions] - An optional array of ISO 3166 region codes to display. If not provided, regions are inferred from supported locales.\n * @param {Object} [options.customMapping] - Optional mapping to override region display names, emojis, or associated locales.\n * @param {boolean} [options.prioritizeCurrentLocaleRegion=true] - If true, the region corresponding to the current locale is prioritized in the list.\n * @param {boolean} [options.sortRegionsAlphabetically=true] - If true, regions are sorted alphabetically by display name.\n *\n * @returns {Object} An object containing region-related utilities:\n * @returns {string | undefined} return.region - The currently selected region code.\n * @returns {function} return.setRegion - Function to update the current region.\n * @returns {string[]} return.regions - The ordered list of available region codes.\n * @returns {Map<string, RegionData>} return.regionData - Map of region codes to their display data (name, emoji, locale).\n * @returns {string} return.locale - The current locale.\n * @returns {function} return.setLocale - Function to update the current locale.\n */\nexport function useRegionSelector(options?: InternalRegionSelectorOptions) {\n  const setRegion = useSetRegion();\n  const setLocale = useSetLocale();\n  return { setRegion, setLocale, ...useInternalRegionSelector(options) };\n}\n","'server-only';\n\nimport {\n  OnMissingDictionaryEntry,\n  OnMissingDictionaryObj,\n  OnMissingTranslation,\n} from '@generaltranslation/react-core/pure';\nimport { I18nStore } from '@generaltranslation/react-core/components';\nimport { useMemo } from 'react';\n\n/**\n * Returns handle missing translation callback for server runtime\n * These DO get invoked during server render which is not pure, but this\n * is acceptable for dev hot reload because we MUST trigger a translate\n * call on the server to persist translations\n */\nexport function useHandleMissingTranslations(i18nStore: I18nStore): {\n  onMissingTranslation: OnMissingTranslation;\n  onMissingDictionaryEntry: OnMissingDictionaryEntry;\n  onMissingDictionaryObj: OnMissingDictionaryObj;\n} {\n  return useMemo(\n    () => ({\n      onMissingTranslation: (lookup) => i18nStore.translate(lookup),\n      onMissingDictionaryEntry: (lookup) =>\n        i18nStore.translateDictionaryEntry(lookup),\n      onMissingDictionaryObj: (lookup) =>\n        i18nStore.translateDictionaryObject(lookup),\n    }),\n    [i18nStore]\n  );\n}\n","import {\n  I18nStore,\n  InternalGTProvider,\n} from '@generaltranslation/react-core/components';\nimport { ReadonlyConditionStore } from '@generaltranslation/react-core/pure';\nimport { useMemo, useRef } from 'react';\nimport type { SharedGTProviderProps } from './GTProviderProps';\nimport { useHandleMissingTranslations } from '../hooks/useHandleMissingTranslations';\n\n/**\n * Consumes snapshot from server\n * Implementation for server-side only\n */\nexport function ServerGTProvider({\n  locale,\n  region,\n  enableI18n,\n  ...props\n}: SharedGTProviderProps) {\n  const conditionStore = useMemo(() => {\n    return new ReadonlyConditionStore({ locale, region, enableI18n });\n  }, [locale, region, enableI18n]);\n\n  const i18nStoreRef = useRef<I18nStore | null>(null);\n  if (i18nStoreRef.current == null) {\n    i18nStoreRef.current = new I18nStore();\n  }\n\n  const {\n    onMissingTranslation,\n    onMissingDictionaryEntry,\n    onMissingDictionaryObj,\n  } = useHandleMissingTranslations(i18nStoreRef.current);\n\n  return (\n    <InternalGTProvider\n      {...props}\n      conditionStore={conditionStore}\n      i18nStore={i18nStoreRef.current}\n      onMissingTranslation={onMissingTranslation}\n      onMissingDictionaryEntry={onMissingDictionaryEntry}\n      onMissingDictionaryObj={onMissingDictionaryObj}\n    />\n  );\n}\n","import type React from 'react';\nimport { InternalLocaleSelector } from '@generaltranslation/react-core/components';\nimport { CustomMapping } from 'generaltranslation/types';\nimport { useLocaleSelector } from './useLocaleSelector';\n\n/**\n * A dropdown component that allows users to select a locale.\n * @param {string[]} [locales] - An optional list of locales to use for the dropdown. If not provided, the list of locales from the `<GTProvider>` context is used.\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 */\nexport function LocaleSelector({\n  locales: _locales,\n  ...props\n}: LocaleSelectorProps): React.JSX.Element | null {\n  // Get locale selector properties\n  const { locale, locales, getLocaleProperties, setLocale } =\n    useLocaleSelector(_locales);\n\n  return (\n    <InternalLocaleSelector\n      locale={locale}\n      locales={locales}\n      setLocale={setLocale}\n      getLocaleProperties={getLocaleProperties}\n      {...props}\n    />\n  );\n}\n\nexport type LocaleSelectorProps = {\n  locales?: string[];\n  customNames?: { [key: string]: string };\n  customMapping?: CustomMapping;\n  [key: string]: any;\n};\n","import type React from 'react';\nimport type { ReactNode } from 'react';\nimport { InternalRegionSelector } from '@generaltranslation/react-core/components';\nimport { useRegionSelector } from './useRegionSelector';\n\n/**\n * A dropdown component that allows users to select a region.\n * @param {string[]} [regions] - An optional array of ISO 3166 region codes to display. If not provided, regions are inferred from the supported locales in the `<GTProvider>` context.\n * @param {React.ReactNode} [placeholder] - Optional placeholder node to display as the first option when no region is selected.\n * @param {object} [customMapping] - An optional object to map region codes to custom display names, emojis, or associated locales.\n * @param {boolean} [prioritizeCurrentLocaleRegion] - If true, the region corresponding to the current locale is prioritized in the list.\n * @param {boolean} [sortRegionsAlphabetically] - If true, regions are sorted alphabetically by display name.\n * @param {boolean} [asLocaleSelector=false] - If true, selecting a region will also update the locale to the region's associated locale.\n * @returns {React.ReactElement | null} The rendered region dropdown component or null to prevent rendering.\n *\n * @example\n * ```tsx\n * <RegionSelector\n *   regions={['US', 'CA']}\n *   customMapping={{ US: { name: \"United States\", emoji: \"🇺🇸\" } }}\n *   placeholder=\"Select a region\"\n * />\n * ```\n */\nexport function RegionSelector({\n  regions: _regions,\n  customMapping,\n  prioritizeCurrentLocaleRegion,\n  sortRegionsAlphabetically,\n  asLocaleSelector = false,\n  ...props\n}: RegionSelectorProps): React.JSX.Element | null {\n  // Get region selector properties\n  const { region, regions, regionData, locale, setRegion, setLocale } =\n    useRegionSelector({\n      regions: _regions,\n      customMapping,\n      prioritizeCurrentLocaleRegion,\n      sortRegionsAlphabetically,\n    });\n\n  const changeRegion = (region: string) => {\n    if (asLocaleSelector) {\n      const regionLocale = regionData.get(region)?.locale;\n      // setRegion reloads the page; update the locale cookie first\n      if (regionLocale && locale !== regionLocale) setLocale(regionLocale);\n    }\n    setRegion(region);\n  };\n\n  return (\n    <InternalRegionSelector\n      region={region}\n      regions={regions}\n      regionData={regionData}\n      setRegion={changeRegion}\n      {...props}\n    />\n  );\n}\n\nexport type RegionSelectorProps = {\n  regions?: string[];\n  placeholder?: ReactNode;\n  customMapping?: {\n    [region: string]:\n      | string\n      | { name?: string; emoji?: string; locale?: string };\n  };\n  prioritizeCurrentLocaleRegion?: boolean;\n  sortRegionsAlphabetically?: boolean;\n  asLocaleSelector?: boolean;\n  [key: string]: any;\n};\n","'use client';\n\nimport { createDiagnosticMessage } from 'generaltranslation/internal';\nimport type { ReactNode } from 'react';\nimport type { TxProps } from './utils/TxProps';\n\n// SSR/context-capable React runtime surface. This entrypoint may import hooks,\n// providers, and context modules, so it must be consumed as a client boundary by\n// React Server Component frameworks.\n\nexport { initializeGTSRA as initializeGT } from './setup/initializeGTSRA';\nexport { useLocaleSelector } from './components/useLocaleSelector';\nexport { useRegionSelector } from './components/useRegionSelector';\nexport {\n  useSetLocale,\n  useSetRegion,\n  useSetEnableI18n,\n} from './hooks/conditions-store';\n\ntype InitializeGTSPA = typeof import('./setup/initializeGTSPA').initializeGTSPA;\n\nexport const initializeGTSPA: InitializeGTSPA = async () => {\n  throw new Error(\n    createDiagnosticMessage({\n      source: 'gt-react',\n      severity: 'Error',\n      whatHappened:\n        'initializeGTSPA() cannot be called from the server runtime entry point',\n      why: 'initializeGTSPA() initializes browser-only SPA state and translation cache behavior.',\n      fix: 'Use initializeGT() for server-rendered React runtimes or import initializeGTSPA from the browser entry point.',\n    })\n  );\n};\n\n// ===== Components ===== //\nexport { ServerGTProvider as GTProvider } from './provider/ServerGTProvider';\nexport { LocaleSelector } from './components/LocaleSelector';\nexport { RegionSelector } from './components/RegionSelector';\n\n// ===== Components ===== //\nexport {\n  Branch,\n  Plural,\n  Derive,\n  GtInternalTranslateJsx,\n  GtInternalVar,\n  T,\n  Currency,\n  DateTime,\n  RelativeTime,\n  Var,\n  Num,\n} from '@generaltranslation/react-core/components';\n\nexport async function Tx(_props: TxProps): Promise<ReactNode> {\n  throw new Error('Tx is only supported via RSC');\n}\n\n// ===== Hooks ===== //\nexport {\n  useLocale,\n  useRegion,\n  useCustomMapping,\n  useDefaultLocale,\n  useEnableI18n,\n  useLocales,\n  useFormatLocales,\n  useGT,\n  useMessages,\n  useTranslations,\n  useLocaleDirection,\n  useLocaleProperties,\n} from '@generaltranslation/react-core/hooks';\n\n// ===== Functions ===== //\nexport {\n  msg,\n  decodeMsg,\n  decodeOptions,\n  derive,\n  declareVar,\n  decodeVars,\n  mFallback,\n  gtFallback,\n  getFormatLocales,\n  getDefaultLocale,\n  getLocaleProperties,\n  getLocales,\n  resolveCanonicalLocale,\n  getReactI18nCache,\n  getTranslationsSnapshot,\n  getVersionId,\n  createRenderPipeline,\n  setReactI18nCache,\n  t,\n} from '@generaltranslation/react-core/pure';\n\nexport type {\n  RenderPipeline,\n  RenderPreparedT,\n} from '@generaltranslation/react-core/pure';\n\nexport type { SharedGTProviderProps } from './provider/GTProviderProps';\nexport {\n  GtInternalRuntimeTranslateJsx,\n  GtInternalRuntimeTranslateString,\n} from 'gt-i18n/internal';\nexport type {\n  GTTranslationOptions,\n  RuntimeTranslationOptions,\n} from 'gt-i18n/types';\nexport type {\n  SyncResolutionFunction,\n  SyncResolutionFunctionWithFallback,\n} from 'gt-i18n/types';\n\n// ===== Singletons ===== //\nexport {\n  ReactI18nCache,\n  type ReactI18nCacheParams,\n} from '@generaltranslation/react-core/pure';\n"],"mappings":"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"}
+{"version":3,"file":"index.server.cjs","names":["ReadonlyConditionStore","I18nStore","InternalGTProvider","InternalLocaleSelector","InternalRegionSelector"],"sources":["../../core/dist/api-BOEGbEF6.mjs","../src/setup/runtimeCredentials.ts","../src/setup/initializeGTSRA.ts","../src/functions/parseLocale.ts","../src/hooks/conditions-store.ts","../src/components/useLocaleSelector.ts","../src/components/useRegionSelector.ts","../src/hooks/useHandleMissingTranslations.ts","../src/provider/ServerGTProvider.tsx","../src/components/LocaleSelector.tsx","../src/components/RegionSelector.tsx","../src/index.server.ts"],"sourcesContent":["//#region src/settings/settings.ts\nconst libraryDefaultLocale = \"en\";\nconst defaultTimeout = 6e4;\n//#endregion\n//#region src/logging/diagnostics.ts\nfunction ensureSentence(text) {\n\tconst trimmed = text.trim();\n\tif (!trimmed) return \"\";\n\treturn /[.!?)]$/.test(trimmed) ? trimmed : `${trimmed}.`;\n}\nfunction stripSentence(text) {\n\tconst trimmed = text.trim();\n\tlet end = trimmed.length;\n\twhile (end > 0) {\n\t\tconst char = trimmed[end - 1];\n\t\tif (char !== \".\" && char !== \"!\" && char !== \"?\") break;\n\t\tend -= 1;\n\t}\n\treturn trimmed.slice(0, end);\n}\nfunction lowercaseFirstWord(text) {\n\treturn text.replace(/^[A-Z][a-z]/, (match) => match.toLowerCase());\n}\nfunction formatDetails(details) {\n\tif (!details) return \"\";\n\tconst detailText = Array.isArray(details) ? details.join(\", \") : details;\n\tif (!detailText.trim()) return \"\";\n\treturn ensureSentence(`Details: ${detailText}`);\n}\nfunction formatDiagnosticErrorDetails(error) {\n\tif (error == null) return void 0;\n\treturn String(error);\n}\nfunction createDiagnosticMessage({ source, severity, whatHappened, reassurance, why, fix, wayOut, details, docsUrl }) {\n\tconst prefix = source ? severity ? `${source} ${severity}:` : `${source}:` : severity ? `${severity}:` : \"\";\n\tconst whatAndWhy = why ? `${stripSentence(whatHappened)} because ${lowercaseFirstWord(stripSentence(why))}` : whatHappened;\n\tconst shouldCombineWayOut = !!fix && !!wayOut && /^[a-z]/.test(stripSentence(wayOut));\n\tconst messageParts = [\n\t\twhatAndWhy,\n\t\treassurance,\n\t\tshouldCombineWayOut ? `${stripSentence(fix)}, or ${lowercaseFirstWord(stripSentence(wayOut))}` : fix,\n\t\tshouldCombineWayOut ? void 0 : wayOut,\n\t\tformatDetails(details)\n\t].filter((part) => !!part).map(ensureSentence);\n\tif (docsUrl) messageParts.push(`Learn more: ${docsUrl}`);\n\tconst message = messageParts.join(\" \");\n\treturn prefix ? `${prefix} ${message}` : message;\n}\n//#endregion\n//#region src/settings/settingsUrls.ts\nconst defaultCacheUrl = \"https://cdn.gtx.dev\";\nconst defaultBaseUrl = \"https://api2.gtx.dev\";\nconst defaultRuntimeApiUrl = \"https://runtime2.gtx.dev\";\n//#endregion\n//#region src/translate/api.ts\nconst API_VERSION = \"2026-03-06.v1\";\n//#endregion\nexport { createDiagnosticMessage as a, libraryDefaultLocale as c, defaultRuntimeApiUrl as i, defaultBaseUrl as n, formatDiagnosticErrorDetails as o, defaultCacheUrl as r, defaultTimeout as s, API_VERSION as t };\n\n//# sourceMappingURL=api-BOEGbEF6.mjs.map","import { getRuntimeEnvironment } from 'gt-i18n/internal';\nimport type { I18nConfigParams } from 'gt-i18n/internal/types';\n\ntype RuntimeCredentials = Pick<I18nConfigParams, 'projectId' | 'devApiKey'>;\ntype RuntimeEnv = {\n  DEV?: boolean;\n  VITE_GT_PROJECT_ID?: string;\n  VITE_GT_DEV_API_KEY?: string;\n};\n\nexport function addRuntimeCredentials<T extends RuntimeCredentials>(\n  config: T\n): T {\n  const credentials = getRuntimeCredentials();\n  return {\n    ...config,\n    projectId: config.projectId || credentials.projectId,\n    devApiKey: config.devApiKey || credentials.devApiKey,\n  };\n}\n\nfunction getRuntimeCredentials(): RuntimeCredentials {\n  return {\n    projectId:\n      readImportMetaVite(\n        () =>\n          (\n            import.meta as ImportMeta & {\n              env?: RuntimeEnv;\n            }\n          ).env?.VITE_GT_PROJECT_ID\n      ) || readProcessEnvViteProjectId(),\n    devApiKey:\n      getRuntimeEnvironment() === 'development'\n        ? readImportMetaVite(() =>\n            (import.meta as ImportMeta & { env?: RuntimeEnv }).env?.DEV\n              ? (import.meta as ImportMeta & { env?: RuntimeEnv }).env\n                  ?.VITE_GT_DEV_API_KEY\n              : undefined\n          ) || readProcessEnvViteDevApiKey()\n        : undefined,\n  };\n}\n\nfunction readImportMetaVite(\n  readValue: () => string | undefined\n): string | undefined {\n  try {\n    return normalizeEnvValue(readValue());\n  } catch {\n    return undefined;\n  }\n}\n\nfunction readProcessEnvViteProjectId(): string | undefined {\n  try {\n    return normalizeEnvValue(process.env.VITE_GT_PROJECT_ID);\n  } catch {\n    return undefined;\n  }\n}\n\nfunction readProcessEnvViteDevApiKey(): string | undefined {\n  try {\n    return normalizeEnvValue(process.env.VITE_GT_DEV_API_KEY);\n  } catch {\n    return undefined;\n  }\n}\n\nfunction normalizeEnvValue(value: string | undefined): string | undefined {\n  return value || undefined;\n}\n","import {\n  internalInitializeGTSRA,\n  type I18nConfigParams,\n  type ReactI18nCacheParams,\n} from '@generaltranslation/react-core/pure';\nimport { addRuntimeCredentials } from './runtimeCredentials';\n\n/**\n * Initialize GT for server-rendered React runtimes.\n */\nexport function initializeGTSRA(\n  config: I18nConfigParams & ReactI18nCacheParams\n): void {\n  internalInitializeGTSRA(addRuntimeCredentials(config));\n}\n","import { getI18nConfig } from '@generaltranslation/react-core/pure';\nimport { getCookieValue, parseAcceptLanguage } from 'gt-i18n/internal';\n\ntype RequestWithHeaders = Pick<Request, 'headers'>;\n\n/**\n * Resolve the user's locale from a Web Request.\n *\n * The configured locale cookie takes precedence over the Accept-Language\n * header. If neither contains a supported locale, the configured default\n * locale is returned.\n *\n * This is intended for incoming server requests. A Request created in the\n * browser does not automatically include document cookies or Accept-Language.\n */\nexport function parseLocale(request: RequestWithHeaders): string {\n  const i18nConfig = getI18nConfig();\n  const candidates: string[] = [];\n  const cookieLocale = getCookieValue(\n    request.headers.get('cookie'),\n    i18nConfig.getLocaleCookieName()\n  );\n\n  if (cookieLocale) {\n    candidates.push(cookieLocale);\n  }\n\n  candidates.push(\n    ...parseAcceptLanguage(request.headers.get('accept-language'))\n  );\n\n  return i18nConfig.resolveSupportedLocale(candidates);\n}\n","import { useCallback } from 'react';\nimport { useConditionStore } from '@generaltranslation/react-core/hooks';\n\n/**\n * Returns a function that sets the locale\n */\nexport function useSetLocale() {\n  const conditionStore = useConditionStore();\n  return useCallback(\n    (locale: string) => {\n      conditionStore.setLocale(locale);\n    },\n    [conditionStore]\n  );\n}\n\n/**\n * Returns a function that sets the region\n */\nexport function useSetRegion() {\n  const conditionStore = useConditionStore();\n  return useCallback(\n    (region: string | undefined) => {\n      conditionStore.setRegion(region);\n    },\n    [conditionStore]\n  );\n}\n\n/**\n * Returns a function that sets the enableI18n flag in the condition store.\n */\nexport function useSetEnableI18n() {\n  const conditionStore = useConditionStore();\n  return useCallback(\n    (enableI18n: boolean) => {\n      conditionStore.setEnableI18n(enableI18n);\n    },\n    [conditionStore]\n  );\n}\n","import { useSetLocale } from '../hooks/conditions-store';\nimport { useInternalLocaleSelector } from '@generaltranslation/react-core/hooks';\n\n/**\n * Gets the list of properties for using a locale selector.\n * Provides locale management utilities for the application.\n *\n * @param locales an optional list of locales to use for the drop down. These locales must be a subset of the locales provided by the `<GTProvider>` context. When not provided, the list of locales from the `<GTProvider>` context is used.\n *\n * @returns {Object} An object containing locale-related utilities:\n * @returns {string} return.locale - The currently selected locale.\n * @returns {string[]} return.locales - The list of all available locales.\n * @returns {function} return.setLocale - Function to update the current locale.\n * @returns {(locale: string) => LocaleProperties} return.getLocaleProperties - Function to retrieve properties for a given locale.\n */\nexport function useLocaleSelector(locales?: string[]) {\n  const setLocale = useSetLocale();\n  return { setLocale, ...useInternalLocaleSelector(locales) };\n}\n","import { useSetLocale, useSetRegion } from '../hooks/conditions-store';\nimport { useInternalRegionSelector } from '@generaltranslation/react-core/hooks';\nimport type { InternalRegionSelectorOptions } from '@generaltranslation/react-core/hooks';\n\n/**\n * Gets the list of properties for using a region selector.\n * Provides region management utilities for the application.\n *\n * @param {Object} [options] - Optional configuration object.\n * @param {string[]} [options.regions] - An optional array of ISO 3166 region codes to display. If not provided, regions are inferred from supported locales.\n * @param {Object} [options.customMapping] - Optional mapping to override region display names, emojis, or associated locales.\n * @param {boolean} [options.prioritizeCurrentLocaleRegion=true] - If true, the region corresponding to the current locale is prioritized in the list.\n * @param {boolean} [options.sortRegionsAlphabetically=true] - If true, regions are sorted alphabetically by display name.\n *\n * @returns {Object} An object containing region-related utilities:\n * @returns {string | undefined} return.region - The currently selected region code.\n * @returns {function} return.setRegion - Function to update the current region.\n * @returns {string[]} return.regions - The ordered list of available region codes.\n * @returns {Map<string, RegionData>} return.regionData - Map of region codes to their display data (name, emoji, locale).\n * @returns {string} return.locale - The current locale.\n * @returns {function} return.setLocale - Function to update the current locale.\n */\nexport function useRegionSelector(options?: InternalRegionSelectorOptions) {\n  const setRegion = useSetRegion();\n  const setLocale = useSetLocale();\n  return { setRegion, setLocale, ...useInternalRegionSelector(options) };\n}\n","'server-only';\n\nimport {\n  OnMissingDictionaryEntry,\n  OnMissingDictionaryObj,\n  OnMissingTranslation,\n} from '@generaltranslation/react-core/pure';\nimport { I18nStore } from '@generaltranslation/react-core/components';\nimport { useMemo } from 'react';\n\n/**\n * Returns handle missing translation callback for server runtime\n * These DO get invoked during server render which is not pure, but this\n * is acceptable for dev hot reload because we MUST trigger a translate\n * call on the server to persist translations\n */\nexport function useHandleMissingTranslations(i18nStore: I18nStore): {\n  onMissingTranslation: OnMissingTranslation;\n  onMissingDictionaryEntry: OnMissingDictionaryEntry;\n  onMissingDictionaryObj: OnMissingDictionaryObj;\n} {\n  return useMemo(\n    () => ({\n      onMissingTranslation: (lookup) => i18nStore.translate(lookup),\n      onMissingDictionaryEntry: (lookup) =>\n        i18nStore.translateDictionaryEntry(lookup),\n      onMissingDictionaryObj: (lookup) =>\n        i18nStore.translateDictionaryObject(lookup),\n    }),\n    [i18nStore]\n  );\n}\n","import {\n  I18nStore,\n  InternalGTProvider,\n} from '@generaltranslation/react-core/components';\nimport { ReadonlyConditionStore } from '@generaltranslation/react-core/pure';\nimport { useMemo, useRef } from 'react';\nimport type { SharedGTProviderProps } from './GTProviderProps';\nimport { useHandleMissingTranslations } from '../hooks/useHandleMissingTranslations';\n\n/**\n * Consumes snapshot from server\n * Implementation for server-side only\n */\nexport function ServerGTProvider({\n  locale,\n  region,\n  enableI18n,\n  ...props\n}: SharedGTProviderProps) {\n  const conditionStore = useMemo(() => {\n    return new ReadonlyConditionStore({ locale, region, enableI18n });\n  }, [locale, region, enableI18n]);\n\n  const i18nStoreRef = useRef<I18nStore | null>(null);\n  if (i18nStoreRef.current == null) {\n    i18nStoreRef.current = new I18nStore();\n  }\n\n  const {\n    onMissingTranslation,\n    onMissingDictionaryEntry,\n    onMissingDictionaryObj,\n  } = useHandleMissingTranslations(i18nStoreRef.current);\n\n  return (\n    <InternalGTProvider\n      {...props}\n      conditionStore={conditionStore}\n      i18nStore={i18nStoreRef.current}\n      onMissingTranslation={onMissingTranslation}\n      onMissingDictionaryEntry={onMissingDictionaryEntry}\n      onMissingDictionaryObj={onMissingDictionaryObj}\n    />\n  );\n}\n","import type React from 'react';\nimport { InternalLocaleSelector } from '@generaltranslation/react-core/components';\nimport { CustomMapping } from 'generaltranslation/types';\nimport { useLocaleSelector } from './useLocaleSelector';\n\n/**\n * A dropdown component that allows users to select a locale.\n * @param {string[]} [locales] - An optional list of locales to use for the dropdown. If not provided, the list of locales from the `<GTProvider>` context is used.\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 */\nexport function LocaleSelector({\n  locales: _locales,\n  ...props\n}: LocaleSelectorProps): React.JSX.Element | null {\n  // Get locale selector properties\n  const { locale, locales, getLocaleProperties, setLocale } =\n    useLocaleSelector(_locales);\n\n  return (\n    <InternalLocaleSelector\n      locale={locale}\n      locales={locales}\n      setLocale={setLocale}\n      getLocaleProperties={getLocaleProperties}\n      {...props}\n    />\n  );\n}\n\nexport type LocaleSelectorProps = {\n  locales?: string[];\n  customNames?: { [key: string]: string };\n  customMapping?: CustomMapping;\n  [key: string]: any;\n};\n","import type React from 'react';\nimport type { ReactNode } from 'react';\nimport { InternalRegionSelector } from '@generaltranslation/react-core/components';\nimport { useRegionSelector } from './useRegionSelector';\n\n/**\n * A dropdown component that allows users to select a region.\n * @param {string[]} [regions] - An optional array of ISO 3166 region codes to display. If not provided, regions are inferred from the supported locales in the `<GTProvider>` context.\n * @param {React.ReactNode} [placeholder] - Optional placeholder node to display as the first option when no region is selected.\n * @param {object} [customMapping] - An optional object to map region codes to custom display names, emojis, or associated locales.\n * @param {boolean} [prioritizeCurrentLocaleRegion] - If true, the region corresponding to the current locale is prioritized in the list.\n * @param {boolean} [sortRegionsAlphabetically] - If true, regions are sorted alphabetically by display name.\n * @param {boolean} [asLocaleSelector=false] - If true, selecting a region will also update the locale to the region's associated locale.\n * @returns {React.ReactElement | null} The rendered region dropdown component or null to prevent rendering.\n *\n * @example\n * ```tsx\n * <RegionSelector\n *   regions={['US', 'CA']}\n *   customMapping={{ US: { name: \"United States\", emoji: \"🇺🇸\" } }}\n *   placeholder=\"Select a region\"\n * />\n * ```\n */\nexport function RegionSelector({\n  regions: _regions,\n  customMapping,\n  prioritizeCurrentLocaleRegion,\n  sortRegionsAlphabetically,\n  asLocaleSelector = false,\n  ...props\n}: RegionSelectorProps): React.JSX.Element | null {\n  // Get region selector properties\n  const { region, regions, regionData, locale, setRegion, setLocale } =\n    useRegionSelector({\n      regions: _regions,\n      customMapping,\n      prioritizeCurrentLocaleRegion,\n      sortRegionsAlphabetically,\n    });\n\n  const changeRegion = (region: string) => {\n    if (asLocaleSelector) {\n      const regionLocale = regionData.get(region)?.locale;\n      // setRegion reloads the page; update the locale cookie first\n      if (regionLocale && locale !== regionLocale) setLocale(regionLocale);\n    }\n    setRegion(region);\n  };\n\n  return (\n    <InternalRegionSelector\n      region={region}\n      regions={regions}\n      regionData={regionData}\n      setRegion={changeRegion}\n      {...props}\n    />\n  );\n}\n\nexport type RegionSelectorProps = {\n  regions?: string[];\n  placeholder?: ReactNode;\n  customMapping?: {\n    [region: string]:\n      | string\n      | { name?: string; emoji?: string; locale?: string };\n  };\n  prioritizeCurrentLocaleRegion?: boolean;\n  sortRegionsAlphabetically?: boolean;\n  asLocaleSelector?: boolean;\n  [key: string]: any;\n};\n","'use client';\n\nimport { createDiagnosticMessage } from 'generaltranslation/internal';\nimport type { ReactNode } from 'react';\nimport type { TxProps } from './utils/TxProps';\n\n// SSR/context-capable React runtime surface. This entrypoint may import hooks,\n// providers, and context modules, so it must be consumed as a client boundary by\n// React Server Component frameworks.\n\nexport { initializeGTSRA as initializeGT } from './setup/initializeGTSRA';\nexport { parseLocale } from './functions/parseLocale';\nexport { useLocaleSelector } from './components/useLocaleSelector';\nexport { useRegionSelector } from './components/useRegionSelector';\nexport {\n  useSetLocale,\n  useSetRegion,\n  useSetEnableI18n,\n} from './hooks/conditions-store';\n\ntype InitializeGTSPA = typeof import('./setup/initializeGTSPA').initializeGTSPA;\n\nexport const initializeGTSPA: InitializeGTSPA = async () => {\n  throw new Error(\n    createDiagnosticMessage({\n      source: 'gt-react',\n      severity: 'Error',\n      whatHappened:\n        'initializeGTSPA() cannot be called from the server runtime entry point',\n      why: 'initializeGTSPA() initializes browser-only SPA state and translation cache behavior.',\n      fix: 'Use initializeGT() for server-rendered React runtimes or import initializeGTSPA from the browser entry point.',\n    })\n  );\n};\n\n// ===== Components ===== //\nexport { ServerGTProvider as GTProvider } from './provider/ServerGTProvider';\nexport { LocaleSelector } from './components/LocaleSelector';\nexport { RegionSelector } from './components/RegionSelector';\n\n// ===== Components ===== //\nexport {\n  Branch,\n  Plural,\n  Derive,\n  GtInternalTranslateJsx,\n  GtInternalVar,\n  T,\n  Currency,\n  DateTime,\n  RelativeTime,\n  Var,\n  Num,\n} from '@generaltranslation/react-core/components';\n\nexport async function Tx(_props: TxProps): Promise<ReactNode> {\n  throw new Error('Tx is only supported via RSC');\n}\n\n// ===== Hooks ===== //\nexport {\n  useLocale,\n  useRegion,\n  useCustomMapping,\n  useDefaultLocale,\n  useEnableI18n,\n  useLocales,\n  useFormatLocales,\n  useGT,\n  useMessages,\n  useTranslations,\n  useLocaleDirection,\n  useLocaleProperties,\n} from '@generaltranslation/react-core/hooks';\n\n// ===== Functions ===== //\nexport {\n  msg,\n  decodeMsg,\n  decodeOptions,\n  derive,\n  declareVar,\n  decodeVars,\n  mFallback,\n  gtFallback,\n  getFormatLocales,\n  getDefaultLocale,\n  getLocaleProperties,\n  getLocales,\n  resolveCanonicalLocale,\n  getReactI18nCache,\n  getTranslationsSnapshot,\n  getVersionId,\n  createRenderPipeline,\n  setReactI18nCache,\n  t,\n} from '@generaltranslation/react-core/pure';\n\nexport type {\n  RenderPipeline,\n  RenderPreparedT,\n} from '@generaltranslation/react-core/pure';\n\nexport type { SharedGTProviderProps } from './provider/GTProviderProps';\nexport {\n  GtInternalRuntimeTranslateJsx,\n  GtInternalRuntimeTranslateString,\n} from 'gt-i18n/internal';\nexport type {\n  GTTranslationOptions,\n  RuntimeTranslationOptions,\n} from 'gt-i18n/types';\nexport type {\n  SyncResolutionFunction,\n  SyncResolutionFunctionWithFallback,\n} from 'gt-i18n/types';\n\n// ===== Singletons ===== //\nexport {\n  ReactI18nCache,\n  type ReactI18nCacheParams,\n} from '@generaltranslation/react-core/pure';\n"],"mappings":";;;;;;;;;AAKA,SAAS,eAAe,MAAM;CAC7B,MAAM,UAAU,KAAK,MAAM;AAC3B,KAAI,CAAC,QAAS,QAAO;AACrB,QAAO,UAAU,KAAK,QAAQ,GAAG,UAAU,GAAG,QAAQ;;AAEvD,SAAS,cAAc,MAAM;CAC5B,MAAM,UAAU,KAAK,MAAM;CAC3B,IAAI,MAAM,QAAQ;AAClB,QAAO,MAAM,GAAG;EACf,MAAM,OAAO,QAAQ,MAAM;AAC3B,MAAI,SAAS,OAAO,SAAS,OAAO,SAAS,IAAK;AAClD,SAAO;;AAER,QAAO,QAAQ,MAAM,GAAG,IAAI;;AAE7B,SAAS,mBAAmB,MAAM;AACjC,QAAO,KAAK,QAAQ,gBAAgB,UAAU,MAAM,aAAa,CAAC;;AAEnE,SAAS,cAAc,SAAS;AAC/B,KAAI,CAAC,QAAS,QAAO;CACrB,MAAM,aAAa,MAAM,QAAQ,QAAQ,GAAG,QAAQ,KAAK,KAAK,GAAG;AACjE,KAAI,CAAC,WAAW,MAAM,CAAE,QAAO;AAC/B,QAAO,eAAe,YAAY,aAAa;;AAMhD,SAAS,wBAAwB,EAAE,QAAQ,UAAU,cAAc,aAAa,KAAK,KAAK,QAAQ,SAAS,WAAW;CACrH,MAAM,SAAS,SAAS,WAAW,GAAG,OAAO,GAAG,SAAS,KAAK,GAAG,OAAO,KAAK,WAAW,GAAG,SAAS,KAAK;CACzG,MAAM,aAAa,MAAM,GAAG,cAAc,aAAa,CAAC,WAAW,mBAAmB,cAAc,IAAI,CAAC,KAAK;CAC9G,MAAM,sBAAsB,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,SAAS,KAAK,cAAc,OAAO,CAAC;CACrF,MAAM,eAAe;EACpB;EACA;EACA,sBAAsB,GAAG,cAAc,IAAI,CAAC,OAAO,mBAAmB,cAAc,OAAO,CAAC,KAAK;EACjG,sBAAsB,KAAK,IAAI;EAC/B,cAAc,QAAQ;EACtB,CAAC,QAAQ,SAAS,CAAC,CAAC,KAAK,CAAC,IAAI,eAAe;AAC9C,KAAI,QAAS,cAAa,KAAK,eAAe,UAAU;CACxD,MAAM,UAAU,aAAa,KAAK,IAAI;AACtC,QAAO,SAAS,GAAG,OAAO,GAAG,YAAY;;;;ACpC1C,SAAgB,sBACd,QACG;CACH,MAAM,cAAc,uBAAuB;AAC3C,QAAO;EACL,GAAG;EACH,WAAW,OAAO,aAAa,YAAY;EAC3C,WAAW,OAAO,aAAa,YAAY;EAC5C;;AAGH,SAAS,wBAA4C;AACnD,QAAO;EACL,WACE,0BAAA,EAAA,EAMM,KAAK,mBACV,IAAI,6BAA6B;EACpC,YAAA,GAAA,iBAAA,wBACyB,KAAK,gBACxB,0BAAA,EAAA,EACqD,KAAK,MAAA,EAAA,CACD,KAC/C,sBACJ,KAAA,EACL,IAAI,6BAA6B,GAClC,KAAA;EACP;;AAGH,SAAS,mBACP,WACoB;AACpB,KAAI;AACF,SAAO,kBAAkB,WAAW,CAAC;SAC/B;AACN;;;AAIJ,SAAS,8BAAkD;AACzD,KAAI;AACF,SAAO,kBAAkB,QAAQ,IAAI,mBAAmB;SAClD;AACN;;;AAIJ,SAAS,8BAAkD;AACzD,KAAI;AACF,SAAO,kBAAkB,QAAQ,IAAI,oBAAoB;SACnD;AACN;;;AAIJ,SAAS,kBAAkB,OAA+C;AACxE,QAAO,SAAS,KAAA;;;;;;;AC7DlB,SAAgB,gBACd,QACM;AACN,EAAA,GAAA,oCAAA,yBAAwB,sBAAsB,OAAO,CAAC;;;;;;;;;;;;;;ACExD,SAAgB,YAAY,SAAqC;CAC/D,MAAM,cAAA,GAAA,oCAAA,gBAA4B;CAClC,MAAM,aAAuB,EAAE;CAC/B,MAAM,gBAAA,GAAA,iBAAA,gBACJ,QAAQ,QAAQ,IAAI,SAAS,EAC7B,WAAW,qBAAqB,CACjC;AAED,KAAI,aACF,YAAW,KAAK,aAAa;AAG/B,YAAW,KACT,IAAA,GAAA,iBAAA,qBAAuB,QAAQ,QAAQ,IAAI,kBAAkB,CAAC,CAC/D;AAED,QAAO,WAAW,uBAAuB,WAAW;;;;;;;ACzBtD,SAAgB,eAAe;CAC7B,MAAM,kBAAA,GAAA,qCAAA,oBAAoC;AAC1C,SAAA,GAAA,MAAA,cACG,WAAmB;AAClB,iBAAe,UAAU,OAAO;IAElC,CAAC,eAAe,CACjB;;;;;AAMH,SAAgB,eAAe;CAC7B,MAAM,kBAAA,GAAA,qCAAA,oBAAoC;AAC1C,SAAA,GAAA,MAAA,cACG,WAA+B;AAC9B,iBAAe,UAAU,OAAO;IAElC,CAAC,eAAe,CACjB;;;;;AAMH,SAAgB,mBAAmB;CACjC,MAAM,kBAAA,GAAA,qCAAA,oBAAoC;AAC1C,SAAA,GAAA,MAAA,cACG,eAAwB;AACvB,iBAAe,cAAc,WAAW;IAE1C,CAAC,eAAe,CACjB;;;;;;;;;;;;;;;;ACxBH,SAAgB,kBAAkB,SAAoB;AAEpD,QAAO;EAAE,WADS,cACA;EAAE,IAAA,GAAA,qCAAA,2BAA6B,QAAQ;EAAE;;;;;;;;;;;;;;;;;;;;;;ACK7D,SAAgB,kBAAkB,SAAyC;AAGzE,QAAO;EAAE,WAFS,cAEA;EAAE,WADF,cACW;EAAE,IAAA,GAAA,qCAAA,2BAA6B,QAAQ;EAAE;;;;;;;;;;ACTxE,SAAgB,6BAA6B,WAI3C;AACA,SAAA,GAAA,MAAA,gBACS;EACL,uBAAuB,WAAW,UAAU,UAAU,OAAO;EAC7D,2BAA2B,WACzB,UAAU,yBAAyB,OAAO;EAC5C,yBAAyB,WACvB,UAAU,0BAA0B,OAAO;EAC9C,GACD,CAAC,UAAU,CACZ;;;;;;;;ACjBH,SAAgB,iBAAiB,EAC/B,QACA,QACA,YACA,GAAG,SACqB;CACxB,MAAM,kBAAA,GAAA,MAAA,eAA+B;AACnC,SAAO,IAAIA,oCAAAA,uBAAuB;GAAE;GAAQ;GAAQ;GAAY,CAAC;IAChE;EAAC;EAAQ;EAAQ;EAAW,CAAC;CAEhC,MAAM,gBAAA,GAAA,MAAA,QAAwC,KAAK;AACnD,KAAI,aAAa,WAAW,KAC1B,cAAa,UAAU,IAAIC,0CAAAA,WAAW;CAGxC,MAAM,EACJ,sBACA,0BACA,2BACE,6BAA6B,aAAa,QAAQ;AAEtD,QACE,iBAAA,GAAA,kBAAA,KAACC,0CAAAA,oBAAD;EACE,GAAI;EACY;EAChB,WAAW,aAAa;EACF;EACI;EACF;EACxB,CAAA;;;;;;;;;;;AC9BN,SAAgB,eAAe,EAC7B,SAAS,UACT,GAAG,SAC6C;CAEhD,MAAM,EAAE,QAAQ,SAAS,qBAAqB,cAC5C,kBAAkB,SAAS;AAE7B,QACE,iBAAA,GAAA,kBAAA,KAACC,0CAAAA,wBAAD;EACU;EACC;EACE;EACU;EACrB,GAAI;EACJ,CAAA;;;;;;;;;;;;;;;;;;;;;;;ACHN,SAAgB,eAAe,EAC7B,SAAS,UACT,eACA,+BACA,2BACA,mBAAmB,OACnB,GAAG,SAC6C;CAEhD,MAAM,EAAE,QAAQ,SAAS,YAAY,QAAQ,WAAW,cACtD,kBAAkB;EAChB,SAAS;EACT;EACA;EACA;EACD,CAAC;CAEJ,MAAM,gBAAgB,WAAmB;AACvC,MAAI,kBAAkB;GACpB,MAAM,eAAe,WAAW,IAAI,OAAO,EAAE;AAE7C,OAAI,gBAAgB,WAAW,aAAc,WAAU,aAAa;;AAEtE,YAAU,OAAO;;AAGnB,QACE,iBAAA,GAAA,kBAAA,KAACC,0CAAAA,wBAAD;EACU;EACC;EACG;EACZ,WAAW;EACX,GAAI;EACJ,CAAA;;;;ACnCN,MAAa,kBAAmC,YAAY;AAC1D,OAAM,IAAI,MACR,wBAAwB;EACtB,QAAQ;EACR,UAAU;EACV,cACE;EACF,KAAK;EACL,KAAK;EACN,CAAC,CACH;;AAuBH,eAAsB,GAAG,QAAqC;AAC5D,OAAM,IAAI,MAAM,+BAA+B"}

package/dist/index.server.d.cts

@@ -82,6 +82,20 @@ type TxProps = Record<string, ReactNode> & {
  */
 declare function initializeGTSRA(config: I18nConfigParams & ReactI18nCacheParams$1): void;
 //#endregion
+//#region src/functions/parseLocale.d.ts
+type RequestWithHeaders = Pick<Request, 'headers'>;
+/**
+ * Resolve the user's locale from a Web Request.
+ *
+ * The configured locale cookie takes precedence over the Accept-Language
+ * header. If neither contains a supported locale, the configured default
+ * locale is returned.
+ *
+ * This is intended for incoming server requests. A Request created in the
+ * browser does not automatically include document cookies or Accept-Language.
+ */
+declare function parseLocale(request: RequestWithHeaders): string;
+//#endregion
 //#region ../format/dist/types-COaQnqVZ.d.cts
 //#region src/locales/customLocaleMapping.d.ts
 type CustomMapping = Record<string, string | Partial<LocaleProperties>>; //#endregion
@@ -267,5 +281,5 @@ type InitializeGTSPA = typeof initializeGTSPA$1;
 declare const initializeGTSPA: InitializeGTSPA;
 declare function Tx(_props: TxProps): Promise<ReactNode>;
 //#endregion
-export { Branch, Currency, DateTime, Derive, ServerGTProvider as GTProvider, type GTTranslationOptions, GtInternalRuntimeTranslateJsx, GtInternalRuntimeTranslateString, GtInternalTranslateJsx, GtInternalVar, LocaleSelector, Num, Plural, ReactI18nCache, type ReactI18nCacheParams, RegionSelector, RelativeTime, type RenderPipeline, type RenderPreparedT, type RuntimeTranslationOptions, type SharedGTProviderProps, type SyncResolutionFunction, type SyncResolutionFunctionWithFallback, T, Tx, Var, createRenderPipeline, declareVar, decodeMsg, decodeOptions, decodeVars, derive, getDefaultLocale, getFormatLocales, getLocaleProperties, getLocales, getReactI18nCache, getTranslationsSnapshot, getVersionId, gtFallback, initializeGTSRA as initializeGT, initializeGTSPA, mFallback, msg, resolveCanonicalLocale, setReactI18nCache, t, useCustomMapping, useDefaultLocale, useEnableI18n, useFormatLocales, useGT, useLocale, useLocaleDirection, useLocaleProperties, useLocaleSelector, useLocales, useMessages, useRegion, useRegionSelector, useSetEnableI18n, useSetLocale, useSetRegion, useTranslations };
+export { Branch, Currency, DateTime, Derive, ServerGTProvider as GTProvider, type GTTranslationOptions, GtInternalRuntimeTranslateJsx, GtInternalRuntimeTranslateString, GtInternalTranslateJsx, GtInternalVar, LocaleSelector, Num, Plural, ReactI18nCache, type ReactI18nCacheParams, RegionSelector, RelativeTime, type RenderPipeline, type RenderPreparedT, type RuntimeTranslationOptions, type SharedGTProviderProps, type SyncResolutionFunction, type SyncResolutionFunctionWithFallback, T, Tx, Var, createRenderPipeline, declareVar, decodeMsg, decodeOptions, decodeVars, derive, getDefaultLocale, getFormatLocales, getLocaleProperties, getLocales, getReactI18nCache, getTranslationsSnapshot, getVersionId, gtFallback, initializeGTSRA as initializeGT, initializeGTSPA, mFallback, msg, parseLocale, resolveCanonicalLocale, setReactI18nCache, t, useCustomMapping, useDefaultLocale, useEnableI18n, useFormatLocales, useGT, useLocale, useLocaleDirection, useLocaleProperties, useLocaleSelector, useLocales, useMessages, useRegion, useRegionSelector, useSetEnableI18n, useSetLocale, useSetRegion, useTranslations };
 //# sourceMappingURL=index.server.d.cts.map

package/dist/index.server.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.server.d.cts","names":["CustomMapping","LocaleProperties","Partial","Record","code","name","nativeName","languageCode","languageName","nativeLanguageName","nameWithRegionCode","nativeNameWithRegionCode","regionCode","regionName","nativeRegionName","scriptCode","scriptName","nativeScriptName","maximizedCode","maximizedName","nativeMaximizedName","minimizedCode","minimizedName","nativeMinimizedName","emoji","CustomRegionMapping","region","locale","getRegionProperties","defaultLocale","customMapping","CutoffFormatStyle","TerminatorOptions","terminator","separator","CutoffFormatOptions","maxChars","style","VariableType","Variable","k","i","v","HTML_CONTENT_PROPS","pl","ti","alt","arl","arb","ard","HtmlContentPropKeysRecord","HtmlContentPropValuesRecord","GTProp","JsxChildren","b","t","JsxElement","d","c","JsxChild","StringFormat","DataFormat","StringContent","IcuMessage","StringMessage","I18nextMessage","Content","FormatVariables","Date","S","_","a","f","g","h","l","m","n","o","p","r","s","u","x","y"],"sources":["../src/i18n-cache/types.ts","../src/i18n-cache/BrowserI18nCache.ts","../src/condition-store/BrowserConditionStore.ts","../src/condition-store/createBrowserConditionStore.ts","../src/setup/initializeGTSPA.ts","../src/utils/TxProps.ts","../src/setup/initializeGTSRA.ts","../../format/dist/types-COaQnqVZ.d.cts","../src/components/useLocaleSelector.ts","../src/components/useRegionSelector.ts","../src/hooks/conditions-store.ts","../src/provider/GTProviderProps.ts","../src/provider/ServerGTProvider.tsx","../src/components/LocaleSelector.tsx","../src/components/RegionSelector.tsx","../src/index.server.ts"],"mappings":"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"}
+{"version":3,"file":"index.server.d.cts","names":["CustomMapping","LocaleProperties","Partial","Record","code","name","nativeName","languageCode","languageName","nativeLanguageName","nameWithRegionCode","nativeNameWithRegionCode","regionCode","regionName","nativeRegionName","scriptCode","scriptName","nativeScriptName","maximizedCode","maximizedName","nativeMaximizedName","minimizedCode","minimizedName","nativeMinimizedName","emoji","CustomRegionMapping","region","locale","getRegionProperties","defaultLocale","customMapping","CutoffFormatStyle","TerminatorOptions","terminator","separator","CutoffFormatOptions","maxChars","style","VariableType","Variable","k","i","v","HTML_CONTENT_PROPS","pl","ti","alt","arl","arb","ard","HtmlContentPropKeysRecord","HtmlContentPropValuesRecord","GTProp","JsxChildren","b","t","JsxElement","d","c","JsxChild","StringFormat","DataFormat","StringContent","IcuMessage","StringMessage","I18nextMessage","Content","FormatVariables","Date","S","_","a","f","g","h","l","m","n","o","p","r","s","u","x","y"],"sources":["../src/i18n-cache/types.ts","../src/i18n-cache/BrowserI18nCache.ts","../src/condition-store/BrowserConditionStore.ts","../src/condition-store/createBrowserConditionStore.ts","../src/setup/initializeGTSPA.ts","../src/utils/TxProps.ts","../src/setup/initializeGTSRA.ts","../src/functions/parseLocale.ts","../../format/dist/types-COaQnqVZ.d.cts","../src/components/useLocaleSelector.ts","../src/components/useRegionSelector.ts","../src/hooks/conditions-store.ts","../src/provider/GTProviderProps.ts","../src/provider/ServerGTProvider.tsx","../src/components/LocaleSelector.tsx","../src/components/RegionSelector.tsx","../src/index.server.ts"],"mappings":"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"}

package/dist/index.server.d.mts

@@ -82,6 +82,20 @@ type TxProps = Record<string, ReactNode> & {
  */
 declare function initializeGTSRA(config: I18nConfigParams & ReactI18nCacheParams$1): void;
 //#endregion
+//#region src/functions/parseLocale.d.ts
+type RequestWithHeaders = Pick<Request, 'headers'>;
+/**
+ * Resolve the user's locale from a Web Request.
+ *
+ * The configured locale cookie takes precedence over the Accept-Language
+ * header. If neither contains a supported locale, the configured default
+ * locale is returned.
+ *
+ * This is intended for incoming server requests. A Request created in the
+ * browser does not automatically include document cookies or Accept-Language.
+ */
+declare function parseLocale(request: RequestWithHeaders): string;
+//#endregion
 //#region ../format/dist/types-COaQnqVZ.d.cts
 //#region src/locales/customLocaleMapping.d.ts
 type CustomMapping = Record<string, string | Partial<LocaleProperties>>; //#endregion
@@ -267,5 +281,5 @@ type InitializeGTSPA = typeof initializeGTSPA$1;
 declare const initializeGTSPA: InitializeGTSPA;
 declare function Tx(_props: TxProps): Promise<ReactNode>;
 //#endregion
-export { Branch, Currency, DateTime, Derive, ServerGTProvider as GTProvider, type GTTranslationOptions, GtInternalRuntimeTranslateJsx, GtInternalRuntimeTranslateString, GtInternalTranslateJsx, GtInternalVar, LocaleSelector, Num, Plural, ReactI18nCache, type ReactI18nCacheParams, RegionSelector, RelativeTime, type RenderPipeline, type RenderPreparedT, type RuntimeTranslationOptions, type SharedGTProviderProps, type SyncResolutionFunction, type SyncResolutionFunctionWithFallback, T, Tx, Var, createRenderPipeline, declareVar, decodeMsg, decodeOptions, decodeVars, derive, getDefaultLocale, getFormatLocales, getLocaleProperties, getLocales, getReactI18nCache, getTranslationsSnapshot, getVersionId, gtFallback, initializeGTSRA as initializeGT, initializeGTSPA, mFallback, msg, resolveCanonicalLocale, setReactI18nCache, t, useCustomMapping, useDefaultLocale, useEnableI18n, useFormatLocales, useGT, useLocale, useLocaleDirection, useLocaleProperties, useLocaleSelector, useLocales, useMessages, useRegion, useRegionSelector, useSetEnableI18n, useSetLocale, useSetRegion, useTranslations };
+export { Branch, Currency, DateTime, Derive, ServerGTProvider as GTProvider, type GTTranslationOptions, GtInternalRuntimeTranslateJsx, GtInternalRuntimeTranslateString, GtInternalTranslateJsx, GtInternalVar, LocaleSelector, Num, Plural, ReactI18nCache, type ReactI18nCacheParams, RegionSelector, RelativeTime, type RenderPipeline, type RenderPreparedT, type RuntimeTranslationOptions, type SharedGTProviderProps, type SyncResolutionFunction, type SyncResolutionFunctionWithFallback, T, Tx, Var, createRenderPipeline, declareVar, decodeMsg, decodeOptions, decodeVars, derive, getDefaultLocale, getFormatLocales, getLocaleProperties, getLocales, getReactI18nCache, getTranslationsSnapshot, getVersionId, gtFallback, initializeGTSRA as initializeGT, initializeGTSPA, mFallback, msg, parseLocale, resolveCanonicalLocale, setReactI18nCache, t, useCustomMapping, useDefaultLocale, useEnableI18n, useFormatLocales, useGT, useLocale, useLocaleDirection, useLocaleProperties, useLocaleSelector, useLocales, useMessages, useRegion, useRegionSelector, useSetEnableI18n, useSetLocale, useSetRegion, useTranslations };
 //# sourceMappingURL=index.server.d.mts.map

package/dist/index.server.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.server.d.mts","names":["CustomMapping","LocaleProperties","Partial","Record","code","name","nativeName","languageCode","languageName","nativeLanguageName","nameWithRegionCode","nativeNameWithRegionCode","regionCode","regionName","nativeRegionName","scriptCode","scriptName","nativeScriptName","maximizedCode","maximizedName","nativeMaximizedName","minimizedCode","minimizedName","nativeMinimizedName","emoji","CustomRegionMapping","region","locale","getRegionProperties","defaultLocale","customMapping","CutoffFormatStyle","TerminatorOptions","terminator","separator","CutoffFormatOptions","maxChars","style","VariableType","Variable","k","i","v","HTML_CONTENT_PROPS","pl","ti","alt","arl","arb","ard","HtmlContentPropKeysRecord","HtmlContentPropValuesRecord","GTProp","JsxChildren","b","t","JsxElement","d","c","JsxChild","StringFormat","DataFormat","StringContent","IcuMessage","StringMessage","I18nextMessage","Content","FormatVariables","Date","S","_","a","f","g","h","l","m","n","o","p","r","s","u","x","y"],"sources":["../src/i18n-cache/types.ts","../src/i18n-cache/BrowserI18nCache.ts","../src/condition-store/BrowserConditionStore.ts","../src/condition-store/createBrowserConditionStore.ts","../src/setup/initializeGTSPA.ts","../src/utils/TxProps.ts","../src/setup/initializeGTSRA.ts","../../format/dist/types-COaQnqVZ.d.cts","../src/components/useLocaleSelector.ts","../src/components/useRegionSelector.ts","../src/hooks/conditions-store.ts","../src/provider/GTProviderProps.ts","../src/provider/ServerGTProvider.tsx","../src/components/LocaleSelector.tsx","../src/components/RegionSelector.tsx","../src/index.server.ts"],"mappings":"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"}
+{"version":3,"file":"index.server.d.mts","names":["CustomMapping","LocaleProperties","Partial","Record","code","name","nativeName","languageCode","languageName","nativeLanguageName","nameWithRegionCode","nativeNameWithRegionCode","regionCode","regionName","nativeRegionName","scriptCode","scriptName","nativeScriptName","maximizedCode","maximizedName","nativeMaximizedName","minimizedCode","minimizedName","nativeMinimizedName","emoji","CustomRegionMapping","region","locale","getRegionProperties","defaultLocale","customMapping","CutoffFormatStyle","TerminatorOptions","terminator","separator","CutoffFormatOptions","maxChars","style","VariableType","Variable","k","i","v","HTML_CONTENT_PROPS","pl","ti","alt","arl","arb","ard","HtmlContentPropKeysRecord","HtmlContentPropValuesRecord","GTProp","JsxChildren","b","t","JsxElement","d","c","JsxChild","StringFormat","DataFormat","StringContent","IcuMessage","StringMessage","I18nextMessage","Content","FormatVariables","Date","S","_","a","f","g","h","l","m","n","o","p","r","s","u","x","y"],"sources":["../src/i18n-cache/types.ts","../src/i18n-cache/BrowserI18nCache.ts","../src/condition-store/BrowserConditionStore.ts","../src/condition-store/createBrowserConditionStore.ts","../src/setup/initializeGTSPA.ts","../src/utils/TxProps.ts","../src/setup/initializeGTSRA.ts","../src/functions/parseLocale.ts","../../format/dist/types-COaQnqVZ.d.cts","../src/components/useLocaleSelector.ts","../src/components/useRegionSelector.ts","../src/hooks/conditions-store.ts","../src/provider/GTProviderProps.ts","../src/provider/ServerGTProvider.tsx","../src/components/LocaleSelector.tsx","../src/components/RegionSelector.tsx","../src/index.server.ts"],"mappings":";;;;;;;;;;;;;;KAGY,SAAA;AAAA,KACA,SAAA;AAAA,KACA,aAAA;;;;;;KAOA,cAAA;EACV,iBAAA;EACA,gBAAA;AAAA;;;;;;KCIU,sBAAA,GAAyB,0BAAA;EACnC,cAAA,GAAiB,cAAA;AAAA;;;KCNd,oCAAA;EACH,MAAA;EACA,MAAA;EACA,UAAA;AAAA;AAAA,KAEU,UAAA,IAAc,KAAA,EAAO,oCAAA;;;AFfjC;;KEqBY,2BAAA,GAA8B,4BAAA;EACxC,UAAA,GAAa,SAAA;EACb,UAAA,GAAa,SAAA;EACb,cAAA,GAAiB,aAAA;EACjB,OAAA,GAAU,UAAA;AAAA;;;KCdA,iCAAA,GAAoC,IAAA,CAC9C,2BAAA;EAGA,MAAA,GAAS,gBAAA;EACT,UAAA;AAAA;;;;;;;;;;;iBCMoB,iBAAA,CACpB,MAAA,EAAQ,gBAAA,GACN,sBAAA,GACA,iCAAA,GAAiC,OAAA;;;KC1BzB,OAAA,GAAU,MAAA,SAAe,SAAA;EACnC,QAAA,EAAU,SAAA;EACV,OAAA;EACA,MAAA;EACA,QAAA;AAAA;;;;;;iBCIc,eAAA,CACd,MAAA,EAAQ,gBAAA,GAAmB,sBAAA;;;KCRxB,kBAAA,GAAqB,IAAA,CAAK,OAAA;;;;;;;;;;;iBAYf,WAAA,CAAY,OAAA,EAAS,kBAAA;;;;KCdhCA,aAAAA,GAAgBG,MAAAA,kBAAwBD,OAAAA,CAAQD,gBAAAA;AAAAA;AAAAA,KAGhDA,gBAAAA;EACHG,IAAAA;EACAC,IAAAA;EACAC,UAAAA;EACAC,YAAAA;EACAC,YAAAA;EACAC,kBAAAA;EACAC,kBAAAA;EACAC,wBAAAA;EACAC,UAAAA;EACAC,UAAAA;EACAC,gBAAAA;EACAC,UAAAA;EACAC,UAAAA;EACAC,gBAAAA;EACAC,aAAAA;EACAC,aAAAA;EACAC,mBAAAA;EACAC,aAAAA;EACAC,aAAAA;EACAC,mBAAAA;EACAC,KAAAA;AAAAA;AAAAA;;;;;;;;;;;;;;ARtBF;iBSYgB,iBAAA,CAAkB,OAAA;;;2CAAD,gBAAA;;;;;;;;;;;;;;;ATZjC;;;;;AACA;;;iBUkBgB,iBAAA,CAAkB,OAAA,GAAU,6BAAA;;;0BAA6B,uCAAA,CAAA,UAAA;;;;;;;;;;;iBChBzD,YAAA,CAAA,IAAY,MAAA;;;;iBAaZ,YAAA,CAAA,IAAY,MAAA;;;;iBAaZ,gBAAA,CAAA,IAAgB,UAAA;;;;;;;;;KCvBpB,qBAAA,GAAwB,IAAA,CAClC,uBAAA,oCAGA,IAAA,CAAK,2BAAA;EACH,MAAA;AAAA;;;;;;;iBCDY,gBAAA,CAAA;EACd,MAAA;EACA,MAAA;EACA,UAAA;EAAA,GACG;AAAA,GACF,qBAAA,GAAqB,oBAAA,CAAA,GAAA,CAAA,OAAA;;;;;;;;;;iBCNR,cAAA,CAAA;EACd,OAAA,EAAS,QAAA;EAAA,GACN;AAAA,GACF,mBAAA,GAAsB,KAAA,CAAM,GAAA,CAAI,OAAA;AAAA,KAgBvB,mBAAA;EACV,OAAA;EACA,WAAA;IAAA,CAAiB,GAAA;EAAA;EACjB,aAAA,GAAgB,aAAA;EAAA,CACf,GAAA;AAAA;;;;;;;;;;;;AdhCH;;;;;AACA;;;;;iBeoBgB,cAAA,CAAA;EACd,OAAA,EAAS,QAAA;EACT,aAAA;EACA,6BAAA;EACA,yBAAA;EACA,gBAAA;EAAA,GACG;AAAA,GACF,mBAAA,GAAsB,KAAA,CAAM,GAAA,CAAI,OAAA;AAAA,KA8BvB,mBAAA;EACV,OAAA;EACA,WAAA,GAAc,SAAA;EACd,aAAA;IAAA,CACG,MAAA;MAEK,IAAA;MAAe,KAAA;MAAgB,MAAA;IAAA;EAAA;EAEvC,6BAAA;EACA,yBAAA;EACA,gBAAA;EAAA,CACC,GAAA;AAAA;;;KCpDE,eAAA,UAAe,iBAAA;AAAA,cAEP,eAAA,EAAiB,eAAA;AAAA,iBAiCR,EAAA,CAAG,MAAA,EAAQ,OAAA,GAAU,OAAA,CAAQ,SAAA"}

package/dist/index.server.mjs

@@ -1,6 +1,6 @@
 "use client";
-import { ReactI18nCache, ReadonlyConditionStore, createRenderPipeline, declareVar, decodeMsg, decodeOptions, decodeVars, derive, getDefaultLocale, getFormatLocales, getLocaleProperties, getLocales, getReactI18nCache, getTranslationsSnapshot, getVersionId, gtFallback, internalInitializeGTSRA, mFallback, msg, resolveCanonicalLocale, setReactI18nCache, t } from "@generaltranslation/react-core/pure";
-import { GtInternalRuntimeTranslateJsx, GtInternalRuntimeTranslateString, getRuntimeEnvironment } from "gt-i18n/internal";
+import { ReactI18nCache, ReadonlyConditionStore, createRenderPipeline, declareVar, decodeMsg, decodeOptions, decodeVars, derive, getDefaultLocale, getFormatLocales, getI18nConfig, getLocaleProperties, getLocales, getReactI18nCache, getTranslationsSnapshot, getVersionId, gtFallback, internalInitializeGTSRA, mFallback, msg, resolveCanonicalLocale, setReactI18nCache, t } from "@generaltranslation/react-core/pure";
+import { GtInternalRuntimeTranslateJsx, GtInternalRuntimeTranslateString, getCookieValue, getRuntimeEnvironment, parseAcceptLanguage } from "gt-i18n/internal";
 import { useCallback, useMemo, useRef } from "react";
 import { useConditionStore, useCustomMapping, useDefaultLocale, useEnableI18n, useFormatLocales, useGT, useInternalLocaleSelector, useInternalRegionSelector, useLocale, useLocaleDirection, useLocaleProperties, useLocales, useMessages, useRegion, useTranslations } from "@generaltranslation/react-core/hooks";
 import { Branch, Currency, DateTime, Derive, GtInternalTranslateJsx, GtInternalVar, I18nStore, InternalGTProvider, InternalLocaleSelector, InternalRegionSelector, Num, Plural, RelativeTime, T, Var } from "@generaltranslation/react-core/components";
@@ -94,6 +94,26 @@ function initializeGTSRA(config) {
 	internalInitializeGTSRA(addRuntimeCredentials(config));
 }
 //#endregion
+//#region src/functions/parseLocale.ts
+/**
+* Resolve the user's locale from a Web Request.
+*
+* The configured locale cookie takes precedence over the Accept-Language
+* header. If neither contains a supported locale, the configured default
+* locale is returned.
+*
+* This is intended for incoming server requests. A Request created in the
+* browser does not automatically include document cookies or Accept-Language.
+*/
+function parseLocale(request) {
+	const i18nConfig = getI18nConfig();
+	const candidates = [];
+	const cookieLocale = getCookieValue(request.headers.get("cookie"), i18nConfig.getLocaleCookieName());
+	if (cookieLocale) candidates.push(cookieLocale);
+	candidates.push(...parseAcceptLanguage(request.headers.get("accept-language")));
+	return i18nConfig.resolveSupportedLocale(candidates);
+}
+//#endregion
 //#region src/hooks/conditions-store.ts
 /**
 * Returns a function that sets the locale
@@ -291,6 +311,6 @@ async function Tx(_props) {
 	throw new Error("Tx is only supported via RSC");
 }
 //#endregion
-export { Branch, Currency, DateTime, Derive, ServerGTProvider as GTProvider, GtInternalRuntimeTranslateJsx, GtInternalRuntimeTranslateString, GtInternalTranslateJsx, GtInternalVar, LocaleSelector, Num, Plural, ReactI18nCache, RegionSelector, RelativeTime, T, Tx, Var, createRenderPipeline, declareVar, decodeMsg, decodeOptions, decodeVars, derive, getDefaultLocale, getFormatLocales, getLocaleProperties, getLocales, getReactI18nCache, getTranslationsSnapshot, getVersionId, gtFallback, initializeGTSRA as initializeGT, initializeGTSPA, mFallback, msg, resolveCanonicalLocale, setReactI18nCache, t, useCustomMapping, useDefaultLocale, useEnableI18n, useFormatLocales, useGT, useLocale, useLocaleDirection, useLocaleProperties, useLocaleSelector, useLocales, useMessages, useRegion, useRegionSelector, useSetEnableI18n, useSetLocale, useSetRegion, useTranslations };
+export { Branch, Currency, DateTime, Derive, ServerGTProvider as GTProvider, GtInternalRuntimeTranslateJsx, GtInternalRuntimeTranslateString, GtInternalTranslateJsx, GtInternalVar, LocaleSelector, Num, Plural, ReactI18nCache, RegionSelector, RelativeTime, T, Tx, Var, createRenderPipeline, declareVar, decodeMsg, decodeOptions, decodeVars, derive, getDefaultLocale, getFormatLocales, getLocaleProperties, getLocales, getReactI18nCache, getTranslationsSnapshot, getVersionId, gtFallback, initializeGTSRA as initializeGT, initializeGTSPA, mFallback, msg, parseLocale, resolveCanonicalLocale, setReactI18nCache, t, useCustomMapping, useDefaultLocale, useEnableI18n, useFormatLocales, useGT, useLocale, useLocaleDirection, useLocaleProperties, useLocaleSelector, useLocales, useMessages, useRegion, useRegionSelector, useSetEnableI18n, useSetLocale, useSetRegion, useTranslations };
 
 //# sourceMappingURL=index.server.mjs.map

package/dist/index.server.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.server.mjs","names":[],"sources":["../../core/dist/api-BOEGbEF6.mjs","../src/setup/runtimeCredentials.ts","../src/setup/initializeGTSRA.ts","../src/hooks/conditions-store.ts","../src/components/useLocaleSelector.ts","../src/components/useRegionSelector.ts","../src/hooks/useHandleMissingTranslations.ts","../src/provider/ServerGTProvider.tsx","../src/components/LocaleSelector.tsx","../src/components/RegionSelector.tsx","../src/index.server.ts"],"sourcesContent":["//#region src/settings/settings.ts\nconst libraryDefaultLocale = \"en\";\nconst defaultTimeout = 6e4;\n//#endregion\n//#region src/logging/diagnostics.ts\nfunction ensureSentence(text) {\n\tconst trimmed = text.trim();\n\tif (!trimmed) return \"\";\n\treturn /[.!?)]$/.test(trimmed) ? trimmed : `${trimmed}.`;\n}\nfunction stripSentence(text) {\n\tconst trimmed = text.trim();\n\tlet end = trimmed.length;\n\twhile (end > 0) {\n\t\tconst char = trimmed[end - 1];\n\t\tif (char !== \".\" && char !== \"!\" && char !== \"?\") break;\n\t\tend -= 1;\n\t}\n\treturn trimmed.slice(0, end);\n}\nfunction lowercaseFirstWord(text) {\n\treturn text.replace(/^[A-Z][a-z]/, (match) => match.toLowerCase());\n}\nfunction formatDetails(details) {\n\tif (!details) return \"\";\n\tconst detailText = Array.isArray(details) ? details.join(\", \") : details;\n\tif (!detailText.trim()) return \"\";\n\treturn ensureSentence(`Details: ${detailText}`);\n}\nfunction formatDiagnosticErrorDetails(error) {\n\tif (error == null) return void 0;\n\treturn String(error);\n}\nfunction createDiagnosticMessage({ source, severity, whatHappened, reassurance, why, fix, wayOut, details, docsUrl }) {\n\tconst prefix = source ? severity ? `${source} ${severity}:` : `${source}:` : severity ? `${severity}:` : \"\";\n\tconst whatAndWhy = why ? `${stripSentence(whatHappened)} because ${lowercaseFirstWord(stripSentence(why))}` : whatHappened;\n\tconst shouldCombineWayOut = !!fix && !!wayOut && /^[a-z]/.test(stripSentence(wayOut));\n\tconst messageParts = [\n\t\twhatAndWhy,\n\t\treassurance,\n\t\tshouldCombineWayOut ? `${stripSentence(fix)}, or ${lowercaseFirstWord(stripSentence(wayOut))}` : fix,\n\t\tshouldCombineWayOut ? void 0 : wayOut,\n\t\tformatDetails(details)\n\t].filter((part) => !!part).map(ensureSentence);\n\tif (docsUrl) messageParts.push(`Learn more: ${docsUrl}`);\n\tconst message = messageParts.join(\" \");\n\treturn prefix ? `${prefix} ${message}` : message;\n}\n//#endregion\n//#region src/settings/settingsUrls.ts\nconst defaultCacheUrl = \"https://cdn.gtx.dev\";\nconst defaultBaseUrl = \"https://api2.gtx.dev\";\nconst defaultRuntimeApiUrl = \"https://runtime2.gtx.dev\";\n//#endregion\n//#region src/translate/api.ts\nconst API_VERSION = \"2026-03-06.v1\";\n//#endregion\nexport { createDiagnosticMessage as a, libraryDefaultLocale as c, defaultRuntimeApiUrl as i, defaultBaseUrl as n, formatDiagnosticErrorDetails as o, defaultCacheUrl as r, defaultTimeout as s, API_VERSION as t };\n\n//# sourceMappingURL=api-BOEGbEF6.mjs.map","import { getRuntimeEnvironment } from 'gt-i18n/internal';\nimport type { I18nConfigParams } from 'gt-i18n/internal/types';\n\ntype RuntimeCredentials = Pick<I18nConfigParams, 'projectId' | 'devApiKey'>;\ntype RuntimeEnv = {\n  DEV?: boolean;\n  VITE_GT_PROJECT_ID?: string;\n  VITE_GT_DEV_API_KEY?: string;\n};\n\nexport function addRuntimeCredentials<T extends RuntimeCredentials>(\n  config: T\n): T {\n  const credentials = getRuntimeCredentials();\n  return {\n    ...config,\n    projectId: config.projectId || credentials.projectId,\n    devApiKey: config.devApiKey || credentials.devApiKey,\n  };\n}\n\nfunction getRuntimeCredentials(): RuntimeCredentials {\n  return {\n    projectId:\n      readImportMetaVite(\n        () =>\n          (\n            import.meta as ImportMeta & {\n              env?: RuntimeEnv;\n            }\n          ).env?.VITE_GT_PROJECT_ID\n      ) || readProcessEnvViteProjectId(),\n    devApiKey:\n      getRuntimeEnvironment() === 'development'\n        ? readImportMetaVite(() =>\n            (import.meta as ImportMeta & { env?: RuntimeEnv }).env?.DEV\n              ? (import.meta as ImportMeta & { env?: RuntimeEnv }).env\n                  ?.VITE_GT_DEV_API_KEY\n              : undefined\n          ) || readProcessEnvViteDevApiKey()\n        : undefined,\n  };\n}\n\nfunction readImportMetaVite(\n  readValue: () => string | undefined\n): string | undefined {\n  try {\n    return normalizeEnvValue(readValue());\n  } catch {\n    return undefined;\n  }\n}\n\nfunction readProcessEnvViteProjectId(): string | undefined {\n  try {\n    return normalizeEnvValue(process.env.VITE_GT_PROJECT_ID);\n  } catch {\n    return undefined;\n  }\n}\n\nfunction readProcessEnvViteDevApiKey(): string | undefined {\n  try {\n    return normalizeEnvValue(process.env.VITE_GT_DEV_API_KEY);\n  } catch {\n    return undefined;\n  }\n}\n\nfunction normalizeEnvValue(value: string | undefined): string | undefined {\n  return value || undefined;\n}\n","import {\n  internalInitializeGTSRA,\n  type I18nConfigParams,\n  type ReactI18nCacheParams,\n} from '@generaltranslation/react-core/pure';\nimport { addRuntimeCredentials } from './runtimeCredentials';\n\n/**\n * Initialize GT for server-rendered React runtimes.\n */\nexport function initializeGTSRA(\n  config: I18nConfigParams & ReactI18nCacheParams\n): void {\n  internalInitializeGTSRA(addRuntimeCredentials(config));\n}\n","import { useCallback } from 'react';\nimport { useConditionStore } from '@generaltranslation/react-core/hooks';\n\n/**\n * Returns a function that sets the locale\n */\nexport function useSetLocale() {\n  const conditionStore = useConditionStore();\n  return useCallback(\n    (locale: string) => {\n      conditionStore.setLocale(locale);\n    },\n    [conditionStore]\n  );\n}\n\n/**\n * Returns a function that sets the region\n */\nexport function useSetRegion() {\n  const conditionStore = useConditionStore();\n  return useCallback(\n    (region: string | undefined) => {\n      conditionStore.setRegion(region);\n    },\n    [conditionStore]\n  );\n}\n\n/**\n * Returns a function that sets the enableI18n flag in the condition store.\n */\nexport function useSetEnableI18n() {\n  const conditionStore = useConditionStore();\n  return useCallback(\n    (enableI18n: boolean) => {\n      conditionStore.setEnableI18n(enableI18n);\n    },\n    [conditionStore]\n  );\n}\n","import { useSetLocale } from '../hooks/conditions-store';\nimport { useInternalLocaleSelector } from '@generaltranslation/react-core/hooks';\n\n/**\n * Gets the list of properties for using a locale selector.\n * Provides locale management utilities for the application.\n *\n * @param locales an optional list of locales to use for the drop down. These locales must be a subset of the locales provided by the `<GTProvider>` context. When not provided, the list of locales from the `<GTProvider>` context is used.\n *\n * @returns {Object} An object containing locale-related utilities:\n * @returns {string} return.locale - The currently selected locale.\n * @returns {string[]} return.locales - The list of all available locales.\n * @returns {function} return.setLocale - Function to update the current locale.\n * @returns {(locale: string) => LocaleProperties} return.getLocaleProperties - Function to retrieve properties for a given locale.\n */\nexport function useLocaleSelector(locales?: string[]) {\n  const setLocale = useSetLocale();\n  return { setLocale, ...useInternalLocaleSelector(locales) };\n}\n","import { useSetLocale, useSetRegion } from '../hooks/conditions-store';\nimport { useInternalRegionSelector } from '@generaltranslation/react-core/hooks';\nimport type { InternalRegionSelectorOptions } from '@generaltranslation/react-core/hooks';\n\n/**\n * Gets the list of properties for using a region selector.\n * Provides region management utilities for the application.\n *\n * @param {Object} [options] - Optional configuration object.\n * @param {string[]} [options.regions] - An optional array of ISO 3166 region codes to display. If not provided, regions are inferred from supported locales.\n * @param {Object} [options.customMapping] - Optional mapping to override region display names, emojis, or associated locales.\n * @param {boolean} [options.prioritizeCurrentLocaleRegion=true] - If true, the region corresponding to the current locale is prioritized in the list.\n * @param {boolean} [options.sortRegionsAlphabetically=true] - If true, regions are sorted alphabetically by display name.\n *\n * @returns {Object} An object containing region-related utilities:\n * @returns {string | undefined} return.region - The currently selected region code.\n * @returns {function} return.setRegion - Function to update the current region.\n * @returns {string[]} return.regions - The ordered list of available region codes.\n * @returns {Map<string, RegionData>} return.regionData - Map of region codes to their display data (name, emoji, locale).\n * @returns {string} return.locale - The current locale.\n * @returns {function} return.setLocale - Function to update the current locale.\n */\nexport function useRegionSelector(options?: InternalRegionSelectorOptions) {\n  const setRegion = useSetRegion();\n  const setLocale = useSetLocale();\n  return { setRegion, setLocale, ...useInternalRegionSelector(options) };\n}\n","'server-only';\n\nimport {\n  OnMissingDictionaryEntry,\n  OnMissingDictionaryObj,\n  OnMissingTranslation,\n} from '@generaltranslation/react-core/pure';\nimport { I18nStore } from '@generaltranslation/react-core/components';\nimport { useMemo } from 'react';\n\n/**\n * Returns handle missing translation callback for server runtime\n * These DO get invoked during server render which is not pure, but this\n * is acceptable for dev hot reload because we MUST trigger a translate\n * call on the server to persist translations\n */\nexport function useHandleMissingTranslations(i18nStore: I18nStore): {\n  onMissingTranslation: OnMissingTranslation;\n  onMissingDictionaryEntry: OnMissingDictionaryEntry;\n  onMissingDictionaryObj: OnMissingDictionaryObj;\n} {\n  return useMemo(\n    () => ({\n      onMissingTranslation: (lookup) => i18nStore.translate(lookup),\n      onMissingDictionaryEntry: (lookup) =>\n        i18nStore.translateDictionaryEntry(lookup),\n      onMissingDictionaryObj: (lookup) =>\n        i18nStore.translateDictionaryObject(lookup),\n    }),\n    [i18nStore]\n  );\n}\n","import {\n  I18nStore,\n  InternalGTProvider,\n} from '@generaltranslation/react-core/components';\nimport { ReadonlyConditionStore } from '@generaltranslation/react-core/pure';\nimport { useMemo, useRef } from 'react';\nimport type { SharedGTProviderProps } from './GTProviderProps';\nimport { useHandleMissingTranslations } from '../hooks/useHandleMissingTranslations';\n\n/**\n * Consumes snapshot from server\n * Implementation for server-side only\n */\nexport function ServerGTProvider({\n  locale,\n  region,\n  enableI18n,\n  ...props\n}: SharedGTProviderProps) {\n  const conditionStore = useMemo(() => {\n    return new ReadonlyConditionStore({ locale, region, enableI18n });\n  }, [locale, region, enableI18n]);\n\n  const i18nStoreRef = useRef<I18nStore | null>(null);\n  if (i18nStoreRef.current == null) {\n    i18nStoreRef.current = new I18nStore();\n  }\n\n  const {\n    onMissingTranslation,\n    onMissingDictionaryEntry,\n    onMissingDictionaryObj,\n  } = useHandleMissingTranslations(i18nStoreRef.current);\n\n  return (\n    <InternalGTProvider\n      {...props}\n      conditionStore={conditionStore}\n      i18nStore={i18nStoreRef.current}\n      onMissingTranslation={onMissingTranslation}\n      onMissingDictionaryEntry={onMissingDictionaryEntry}\n      onMissingDictionaryObj={onMissingDictionaryObj}\n    />\n  );\n}\n","import type React from 'react';\nimport { InternalLocaleSelector } from '@generaltranslation/react-core/components';\nimport { CustomMapping } from 'generaltranslation/types';\nimport { useLocaleSelector } from './useLocaleSelector';\n\n/**\n * A dropdown component that allows users to select a locale.\n * @param {string[]} [locales] - An optional list of locales to use for the dropdown. If not provided, the list of locales from the `<GTProvider>` context is used.\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 */\nexport function LocaleSelector({\n  locales: _locales,\n  ...props\n}: LocaleSelectorProps): React.JSX.Element | null {\n  // Get locale selector properties\n  const { locale, locales, getLocaleProperties, setLocale } =\n    useLocaleSelector(_locales);\n\n  return (\n    <InternalLocaleSelector\n      locale={locale}\n      locales={locales}\n      setLocale={setLocale}\n      getLocaleProperties={getLocaleProperties}\n      {...props}\n    />\n  );\n}\n\nexport type LocaleSelectorProps = {\n  locales?: string[];\n  customNames?: { [key: string]: string };\n  customMapping?: CustomMapping;\n  [key: string]: any;\n};\n","import type React from 'react';\nimport type { ReactNode } from 'react';\nimport { InternalRegionSelector } from '@generaltranslation/react-core/components';\nimport { useRegionSelector } from './useRegionSelector';\n\n/**\n * A dropdown component that allows users to select a region.\n * @param {string[]} [regions] - An optional array of ISO 3166 region codes to display. If not provided, regions are inferred from the supported locales in the `<GTProvider>` context.\n * @param {React.ReactNode} [placeholder] - Optional placeholder node to display as the first option when no region is selected.\n * @param {object} [customMapping] - An optional object to map region codes to custom display names, emojis, or associated locales.\n * @param {boolean} [prioritizeCurrentLocaleRegion] - If true, the region corresponding to the current locale is prioritized in the list.\n * @param {boolean} [sortRegionsAlphabetically] - If true, regions are sorted alphabetically by display name.\n * @param {boolean} [asLocaleSelector=false] - If true, selecting a region will also update the locale to the region's associated locale.\n * @returns {React.ReactElement | null} The rendered region dropdown component or null to prevent rendering.\n *\n * @example\n * ```tsx\n * <RegionSelector\n *   regions={['US', 'CA']}\n *   customMapping={{ US: { name: \"United States\", emoji: \"🇺🇸\" } }}\n *   placeholder=\"Select a region\"\n * />\n * ```\n */\nexport function RegionSelector({\n  regions: _regions,\n  customMapping,\n  prioritizeCurrentLocaleRegion,\n  sortRegionsAlphabetically,\n  asLocaleSelector = false,\n  ...props\n}: RegionSelectorProps): React.JSX.Element | null {\n  // Get region selector properties\n  const { region, regions, regionData, locale, setRegion, setLocale } =\n    useRegionSelector({\n      regions: _regions,\n      customMapping,\n      prioritizeCurrentLocaleRegion,\n      sortRegionsAlphabetically,\n    });\n\n  const changeRegion = (region: string) => {\n    if (asLocaleSelector) {\n      const regionLocale = regionData.get(region)?.locale;\n      // setRegion reloads the page; update the locale cookie first\n      if (regionLocale && locale !== regionLocale) setLocale(regionLocale);\n    }\n    setRegion(region);\n  };\n\n  return (\n    <InternalRegionSelector\n      region={region}\n      regions={regions}\n      regionData={regionData}\n      setRegion={changeRegion}\n      {...props}\n    />\n  );\n}\n\nexport type RegionSelectorProps = {\n  regions?: string[];\n  placeholder?: ReactNode;\n  customMapping?: {\n    [region: string]:\n      | string\n      | { name?: string; emoji?: string; locale?: string };\n  };\n  prioritizeCurrentLocaleRegion?: boolean;\n  sortRegionsAlphabetically?: boolean;\n  asLocaleSelector?: boolean;\n  [key: string]: any;\n};\n","'use client';\n\nimport { createDiagnosticMessage } from 'generaltranslation/internal';\nimport type { ReactNode } from 'react';\nimport type { TxProps } from './utils/TxProps';\n\n// SSR/context-capable React runtime surface. This entrypoint may import hooks,\n// providers, and context modules, so it must be consumed as a client boundary by\n// React Server Component frameworks.\n\nexport { initializeGTSRA as initializeGT } from './setup/initializeGTSRA';\nexport { useLocaleSelector } from './components/useLocaleSelector';\nexport { useRegionSelector } from './components/useRegionSelector';\nexport {\n  useSetLocale,\n  useSetRegion,\n  useSetEnableI18n,\n} from './hooks/conditions-store';\n\ntype InitializeGTSPA = typeof import('./setup/initializeGTSPA').initializeGTSPA;\n\nexport const initializeGTSPA: InitializeGTSPA = async () => {\n  throw new Error(\n    createDiagnosticMessage({\n      source: 'gt-react',\n      severity: 'Error',\n      whatHappened:\n        'initializeGTSPA() cannot be called from the server runtime entry point',\n      why: 'initializeGTSPA() initializes browser-only SPA state and translation cache behavior.',\n      fix: 'Use initializeGT() for server-rendered React runtimes or import initializeGTSPA from the browser entry point.',\n    })\n  );\n};\n\n// ===== Components ===== //\nexport { ServerGTProvider as GTProvider } from './provider/ServerGTProvider';\nexport { LocaleSelector } from './components/LocaleSelector';\nexport { RegionSelector } from './components/RegionSelector';\n\n// ===== Components ===== //\nexport {\n  Branch,\n  Plural,\n  Derive,\n  GtInternalTranslateJsx,\n  GtInternalVar,\n  T,\n  Currency,\n  DateTime,\n  RelativeTime,\n  Var,\n  Num,\n} from '@generaltranslation/react-core/components';\n\nexport async function Tx(_props: TxProps): Promise<ReactNode> {\n  throw new Error('Tx is only supported via RSC');\n}\n\n// ===== Hooks ===== //\nexport {\n  useLocale,\n  useRegion,\n  useCustomMapping,\n  useDefaultLocale,\n  useEnableI18n,\n  useLocales,\n  useFormatLocales,\n  useGT,\n  useMessages,\n  useTranslations,\n  useLocaleDirection,\n  useLocaleProperties,\n} from '@generaltranslation/react-core/hooks';\n\n// ===== Functions ===== //\nexport {\n  msg,\n  decodeMsg,\n  decodeOptions,\n  derive,\n  declareVar,\n  decodeVars,\n  mFallback,\n  gtFallback,\n  getFormatLocales,\n  getDefaultLocale,\n  getLocaleProperties,\n  getLocales,\n  resolveCanonicalLocale,\n  getReactI18nCache,\n  getTranslationsSnapshot,\n  getVersionId,\n  createRenderPipeline,\n  setReactI18nCache,\n  t,\n} from '@generaltranslation/react-core/pure';\n\nexport type {\n  RenderPipeline,\n  RenderPreparedT,\n} from '@generaltranslation/react-core/pure';\n\nexport type { SharedGTProviderProps } from './provider/GTProviderProps';\nexport {\n  GtInternalRuntimeTranslateJsx,\n  GtInternalRuntimeTranslateString,\n} from 'gt-i18n/internal';\nexport type {\n  GTTranslationOptions,\n  RuntimeTranslationOptions,\n} from 'gt-i18n/types';\nexport type {\n  SyncResolutionFunction,\n  SyncResolutionFunctionWithFallback,\n} from 'gt-i18n/types';\n\n// ===== Singletons ===== //\nexport {\n  ReactI18nCache,\n  type ReactI18nCacheParams,\n} from '@generaltranslation/react-core/pure';\n"],"mappings":"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"}
+{"version":3,"file":"index.server.mjs","names":[],"sources":["../../core/dist/api-BOEGbEF6.mjs","../src/setup/runtimeCredentials.ts","../src/setup/initializeGTSRA.ts","../src/functions/parseLocale.ts","../src/hooks/conditions-store.ts","../src/components/useLocaleSelector.ts","../src/components/useRegionSelector.ts","../src/hooks/useHandleMissingTranslations.ts","../src/provider/ServerGTProvider.tsx","../src/components/LocaleSelector.tsx","../src/components/RegionSelector.tsx","../src/index.server.ts"],"sourcesContent":["//#region src/settings/settings.ts\nconst libraryDefaultLocale = \"en\";\nconst defaultTimeout = 6e4;\n//#endregion\n//#region src/logging/diagnostics.ts\nfunction ensureSentence(text) {\n\tconst trimmed = text.trim();\n\tif (!trimmed) return \"\";\n\treturn /[.!?)]$/.test(trimmed) ? trimmed : `${trimmed}.`;\n}\nfunction stripSentence(text) {\n\tconst trimmed = text.trim();\n\tlet end = trimmed.length;\n\twhile (end > 0) {\n\t\tconst char = trimmed[end - 1];\n\t\tif (char !== \".\" && char !== \"!\" && char !== \"?\") break;\n\t\tend -= 1;\n\t}\n\treturn trimmed.slice(0, end);\n}\nfunction lowercaseFirstWord(text) {\n\treturn text.replace(/^[A-Z][a-z]/, (match) => match.toLowerCase());\n}\nfunction formatDetails(details) {\n\tif (!details) return \"\";\n\tconst detailText = Array.isArray(details) ? details.join(\", \") : details;\n\tif (!detailText.trim()) return \"\";\n\treturn ensureSentence(`Details: ${detailText}`);\n}\nfunction formatDiagnosticErrorDetails(error) {\n\tif (error == null) return void 0;\n\treturn String(error);\n}\nfunction createDiagnosticMessage({ source, severity, whatHappened, reassurance, why, fix, wayOut, details, docsUrl }) {\n\tconst prefix = source ? severity ? `${source} ${severity}:` : `${source}:` : severity ? `${severity}:` : \"\";\n\tconst whatAndWhy = why ? `${stripSentence(whatHappened)} because ${lowercaseFirstWord(stripSentence(why))}` : whatHappened;\n\tconst shouldCombineWayOut = !!fix && !!wayOut && /^[a-z]/.test(stripSentence(wayOut));\n\tconst messageParts = [\n\t\twhatAndWhy,\n\t\treassurance,\n\t\tshouldCombineWayOut ? `${stripSentence(fix)}, or ${lowercaseFirstWord(stripSentence(wayOut))}` : fix,\n\t\tshouldCombineWayOut ? void 0 : wayOut,\n\t\tformatDetails(details)\n\t].filter((part) => !!part).map(ensureSentence);\n\tif (docsUrl) messageParts.push(`Learn more: ${docsUrl}`);\n\tconst message = messageParts.join(\" \");\n\treturn prefix ? `${prefix} ${message}` : message;\n}\n//#endregion\n//#region src/settings/settingsUrls.ts\nconst defaultCacheUrl = \"https://cdn.gtx.dev\";\nconst defaultBaseUrl = \"https://api2.gtx.dev\";\nconst defaultRuntimeApiUrl = \"https://runtime2.gtx.dev\";\n//#endregion\n//#region src/translate/api.ts\nconst API_VERSION = \"2026-03-06.v1\";\n//#endregion\nexport { createDiagnosticMessage as a, libraryDefaultLocale as c, defaultRuntimeApiUrl as i, defaultBaseUrl as n, formatDiagnosticErrorDetails as o, defaultCacheUrl as r, defaultTimeout as s, API_VERSION as t };\n\n//# sourceMappingURL=api-BOEGbEF6.mjs.map","import { getRuntimeEnvironment } from 'gt-i18n/internal';\nimport type { I18nConfigParams } from 'gt-i18n/internal/types';\n\ntype RuntimeCredentials = Pick<I18nConfigParams, 'projectId' | 'devApiKey'>;\ntype RuntimeEnv = {\n  DEV?: boolean;\n  VITE_GT_PROJECT_ID?: string;\n  VITE_GT_DEV_API_KEY?: string;\n};\n\nexport function addRuntimeCredentials<T extends RuntimeCredentials>(\n  config: T\n): T {\n  const credentials = getRuntimeCredentials();\n  return {\n    ...config,\n    projectId: config.projectId || credentials.projectId,\n    devApiKey: config.devApiKey || credentials.devApiKey,\n  };\n}\n\nfunction getRuntimeCredentials(): RuntimeCredentials {\n  return {\n    projectId:\n      readImportMetaVite(\n        () =>\n          (\n            import.meta as ImportMeta & {\n              env?: RuntimeEnv;\n            }\n          ).env?.VITE_GT_PROJECT_ID\n      ) || readProcessEnvViteProjectId(),\n    devApiKey:\n      getRuntimeEnvironment() === 'development'\n        ? readImportMetaVite(() =>\n            (import.meta as ImportMeta & { env?: RuntimeEnv }).env?.DEV\n              ? (import.meta as ImportMeta & { env?: RuntimeEnv }).env\n                  ?.VITE_GT_DEV_API_KEY\n              : undefined\n          ) || readProcessEnvViteDevApiKey()\n        : undefined,\n  };\n}\n\nfunction readImportMetaVite(\n  readValue: () => string | undefined\n): string | undefined {\n  try {\n    return normalizeEnvValue(readValue());\n  } catch {\n    return undefined;\n  }\n}\n\nfunction readProcessEnvViteProjectId(): string | undefined {\n  try {\n    return normalizeEnvValue(process.env.VITE_GT_PROJECT_ID);\n  } catch {\n    return undefined;\n  }\n}\n\nfunction readProcessEnvViteDevApiKey(): string | undefined {\n  try {\n    return normalizeEnvValue(process.env.VITE_GT_DEV_API_KEY);\n  } catch {\n    return undefined;\n  }\n}\n\nfunction normalizeEnvValue(value: string | undefined): string | undefined {\n  return value || undefined;\n}\n","import {\n  internalInitializeGTSRA,\n  type I18nConfigParams,\n  type ReactI18nCacheParams,\n} from '@generaltranslation/react-core/pure';\nimport { addRuntimeCredentials } from './runtimeCredentials';\n\n/**\n * Initialize GT for server-rendered React runtimes.\n */\nexport function initializeGTSRA(\n  config: I18nConfigParams & ReactI18nCacheParams\n): void {\n  internalInitializeGTSRA(addRuntimeCredentials(config));\n}\n","import { getI18nConfig } from '@generaltranslation/react-core/pure';\nimport { getCookieValue, parseAcceptLanguage } from 'gt-i18n/internal';\n\ntype RequestWithHeaders = Pick<Request, 'headers'>;\n\n/**\n * Resolve the user's locale from a Web Request.\n *\n * The configured locale cookie takes precedence over the Accept-Language\n * header. If neither contains a supported locale, the configured default\n * locale is returned.\n *\n * This is intended for incoming server requests. A Request created in the\n * browser does not automatically include document cookies or Accept-Language.\n */\nexport function parseLocale(request: RequestWithHeaders): string {\n  const i18nConfig = getI18nConfig();\n  const candidates: string[] = [];\n  const cookieLocale = getCookieValue(\n    request.headers.get('cookie'),\n    i18nConfig.getLocaleCookieName()\n  );\n\n  if (cookieLocale) {\n    candidates.push(cookieLocale);\n  }\n\n  candidates.push(\n    ...parseAcceptLanguage(request.headers.get('accept-language'))\n  );\n\n  return i18nConfig.resolveSupportedLocale(candidates);\n}\n","import { useCallback } from 'react';\nimport { useConditionStore } from '@generaltranslation/react-core/hooks';\n\n/**\n * Returns a function that sets the locale\n */\nexport function useSetLocale() {\n  const conditionStore = useConditionStore();\n  return useCallback(\n    (locale: string) => {\n      conditionStore.setLocale(locale);\n    },\n    [conditionStore]\n  );\n}\n\n/**\n * Returns a function that sets the region\n */\nexport function useSetRegion() {\n  const conditionStore = useConditionStore();\n  return useCallback(\n    (region: string | undefined) => {\n      conditionStore.setRegion(region);\n    },\n    [conditionStore]\n  );\n}\n\n/**\n * Returns a function that sets the enableI18n flag in the condition store.\n */\nexport function useSetEnableI18n() {\n  const conditionStore = useConditionStore();\n  return useCallback(\n    (enableI18n: boolean) => {\n      conditionStore.setEnableI18n(enableI18n);\n    },\n    [conditionStore]\n  );\n}\n","import { useSetLocale } from '../hooks/conditions-store';\nimport { useInternalLocaleSelector } from '@generaltranslation/react-core/hooks';\n\n/**\n * Gets the list of properties for using a locale selector.\n * Provides locale management utilities for the application.\n *\n * @param locales an optional list of locales to use for the drop down. These locales must be a subset of the locales provided by the `<GTProvider>` context. When not provided, the list of locales from the `<GTProvider>` context is used.\n *\n * @returns {Object} An object containing locale-related utilities:\n * @returns {string} return.locale - The currently selected locale.\n * @returns {string[]} return.locales - The list of all available locales.\n * @returns {function} return.setLocale - Function to update the current locale.\n * @returns {(locale: string) => LocaleProperties} return.getLocaleProperties - Function to retrieve properties for a given locale.\n */\nexport function useLocaleSelector(locales?: string[]) {\n  const setLocale = useSetLocale();\n  return { setLocale, ...useInternalLocaleSelector(locales) };\n}\n","import { useSetLocale, useSetRegion } from '../hooks/conditions-store';\nimport { useInternalRegionSelector } from '@generaltranslation/react-core/hooks';\nimport type { InternalRegionSelectorOptions } from '@generaltranslation/react-core/hooks';\n\n/**\n * Gets the list of properties for using a region selector.\n * Provides region management utilities for the application.\n *\n * @param {Object} [options] - Optional configuration object.\n * @param {string[]} [options.regions] - An optional array of ISO 3166 region codes to display. If not provided, regions are inferred from supported locales.\n * @param {Object} [options.customMapping] - Optional mapping to override region display names, emojis, or associated locales.\n * @param {boolean} [options.prioritizeCurrentLocaleRegion=true] - If true, the region corresponding to the current locale is prioritized in the list.\n * @param {boolean} [options.sortRegionsAlphabetically=true] - If true, regions are sorted alphabetically by display name.\n *\n * @returns {Object} An object containing region-related utilities:\n * @returns {string | undefined} return.region - The currently selected region code.\n * @returns {function} return.setRegion - Function to update the current region.\n * @returns {string[]} return.regions - The ordered list of available region codes.\n * @returns {Map<string, RegionData>} return.regionData - Map of region codes to their display data (name, emoji, locale).\n * @returns {string} return.locale - The current locale.\n * @returns {function} return.setLocale - Function to update the current locale.\n */\nexport function useRegionSelector(options?: InternalRegionSelectorOptions) {\n  const setRegion = useSetRegion();\n  const setLocale = useSetLocale();\n  return { setRegion, setLocale, ...useInternalRegionSelector(options) };\n}\n","'server-only';\n\nimport {\n  OnMissingDictionaryEntry,\n  OnMissingDictionaryObj,\n  OnMissingTranslation,\n} from '@generaltranslation/react-core/pure';\nimport { I18nStore } from '@generaltranslation/react-core/components';\nimport { useMemo } from 'react';\n\n/**\n * Returns handle missing translation callback for server runtime\n * These DO get invoked during server render which is not pure, but this\n * is acceptable for dev hot reload because we MUST trigger a translate\n * call on the server to persist translations\n */\nexport function useHandleMissingTranslations(i18nStore: I18nStore): {\n  onMissingTranslation: OnMissingTranslation;\n  onMissingDictionaryEntry: OnMissingDictionaryEntry;\n  onMissingDictionaryObj: OnMissingDictionaryObj;\n} {\n  return useMemo(\n    () => ({\n      onMissingTranslation: (lookup) => i18nStore.translate(lookup),\n      onMissingDictionaryEntry: (lookup) =>\n        i18nStore.translateDictionaryEntry(lookup),\n      onMissingDictionaryObj: (lookup) =>\n        i18nStore.translateDictionaryObject(lookup),\n    }),\n    [i18nStore]\n  );\n}\n","import {\n  I18nStore,\n  InternalGTProvider,\n} from '@generaltranslation/react-core/components';\nimport { ReadonlyConditionStore } from '@generaltranslation/react-core/pure';\nimport { useMemo, useRef } from 'react';\nimport type { SharedGTProviderProps } from './GTProviderProps';\nimport { useHandleMissingTranslations } from '../hooks/useHandleMissingTranslations';\n\n/**\n * Consumes snapshot from server\n * Implementation for server-side only\n */\nexport function ServerGTProvider({\n  locale,\n  region,\n  enableI18n,\n  ...props\n}: SharedGTProviderProps) {\n  const conditionStore = useMemo(() => {\n    return new ReadonlyConditionStore({ locale, region, enableI18n });\n  }, [locale, region, enableI18n]);\n\n  const i18nStoreRef = useRef<I18nStore | null>(null);\n  if (i18nStoreRef.current == null) {\n    i18nStoreRef.current = new I18nStore();\n  }\n\n  const {\n    onMissingTranslation,\n    onMissingDictionaryEntry,\n    onMissingDictionaryObj,\n  } = useHandleMissingTranslations(i18nStoreRef.current);\n\n  return (\n    <InternalGTProvider\n      {...props}\n      conditionStore={conditionStore}\n      i18nStore={i18nStoreRef.current}\n      onMissingTranslation={onMissingTranslation}\n      onMissingDictionaryEntry={onMissingDictionaryEntry}\n      onMissingDictionaryObj={onMissingDictionaryObj}\n    />\n  );\n}\n","import type React from 'react';\nimport { InternalLocaleSelector } from '@generaltranslation/react-core/components';\nimport { CustomMapping } from 'generaltranslation/types';\nimport { useLocaleSelector } from './useLocaleSelector';\n\n/**\n * A dropdown component that allows users to select a locale.\n * @param {string[]} [locales] - An optional list of locales to use for the dropdown. If not provided, the list of locales from the `<GTProvider>` context is used.\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 */\nexport function LocaleSelector({\n  locales: _locales,\n  ...props\n}: LocaleSelectorProps): React.JSX.Element | null {\n  // Get locale selector properties\n  const { locale, locales, getLocaleProperties, setLocale } =\n    useLocaleSelector(_locales);\n\n  return (\n    <InternalLocaleSelector\n      locale={locale}\n      locales={locales}\n      setLocale={setLocale}\n      getLocaleProperties={getLocaleProperties}\n      {...props}\n    />\n  );\n}\n\nexport type LocaleSelectorProps = {\n  locales?: string[];\n  customNames?: { [key: string]: string };\n  customMapping?: CustomMapping;\n  [key: string]: any;\n};\n","import type React from 'react';\nimport type { ReactNode } from 'react';\nimport { InternalRegionSelector } from '@generaltranslation/react-core/components';\nimport { useRegionSelector } from './useRegionSelector';\n\n/**\n * A dropdown component that allows users to select a region.\n * @param {string[]} [regions] - An optional array of ISO 3166 region codes to display. If not provided, regions are inferred from the supported locales in the `<GTProvider>` context.\n * @param {React.ReactNode} [placeholder] - Optional placeholder node to display as the first option when no region is selected.\n * @param {object} [customMapping] - An optional object to map region codes to custom display names, emojis, or associated locales.\n * @param {boolean} [prioritizeCurrentLocaleRegion] - If true, the region corresponding to the current locale is prioritized in the list.\n * @param {boolean} [sortRegionsAlphabetically] - If true, regions are sorted alphabetically by display name.\n * @param {boolean} [asLocaleSelector=false] - If true, selecting a region will also update the locale to the region's associated locale.\n * @returns {React.ReactElement | null} The rendered region dropdown component or null to prevent rendering.\n *\n * @example\n * ```tsx\n * <RegionSelector\n *   regions={['US', 'CA']}\n *   customMapping={{ US: { name: \"United States\", emoji: \"🇺🇸\" } }}\n *   placeholder=\"Select a region\"\n * />\n * ```\n */\nexport function RegionSelector({\n  regions: _regions,\n  customMapping,\n  prioritizeCurrentLocaleRegion,\n  sortRegionsAlphabetically,\n  asLocaleSelector = false,\n  ...props\n}: RegionSelectorProps): React.JSX.Element | null {\n  // Get region selector properties\n  const { region, regions, regionData, locale, setRegion, setLocale } =\n    useRegionSelector({\n      regions: _regions,\n      customMapping,\n      prioritizeCurrentLocaleRegion,\n      sortRegionsAlphabetically,\n    });\n\n  const changeRegion = (region: string) => {\n    if (asLocaleSelector) {\n      const regionLocale = regionData.get(region)?.locale;\n      // setRegion reloads the page; update the locale cookie first\n      if (regionLocale && locale !== regionLocale) setLocale(regionLocale);\n    }\n    setRegion(region);\n  };\n\n  return (\n    <InternalRegionSelector\n      region={region}\n      regions={regions}\n      regionData={regionData}\n      setRegion={changeRegion}\n      {...props}\n    />\n  );\n}\n\nexport type RegionSelectorProps = {\n  regions?: string[];\n  placeholder?: ReactNode;\n  customMapping?: {\n    [region: string]:\n      | string\n      | { name?: string; emoji?: string; locale?: string };\n  };\n  prioritizeCurrentLocaleRegion?: boolean;\n  sortRegionsAlphabetically?: boolean;\n  asLocaleSelector?: boolean;\n  [key: string]: any;\n};\n","'use client';\n\nimport { createDiagnosticMessage } from 'generaltranslation/internal';\nimport type { ReactNode } from 'react';\nimport type { TxProps } from './utils/TxProps';\n\n// SSR/context-capable React runtime surface. This entrypoint may import hooks,\n// providers, and context modules, so it must be consumed as a client boundary by\n// React Server Component frameworks.\n\nexport { initializeGTSRA as initializeGT } from './setup/initializeGTSRA';\nexport { parseLocale } from './functions/parseLocale';\nexport { useLocaleSelector } from './components/useLocaleSelector';\nexport { useRegionSelector } from './components/useRegionSelector';\nexport {\n  useSetLocale,\n  useSetRegion,\n  useSetEnableI18n,\n} from './hooks/conditions-store';\n\ntype InitializeGTSPA = typeof import('./setup/initializeGTSPA').initializeGTSPA;\n\nexport const initializeGTSPA: InitializeGTSPA = async () => {\n  throw new Error(\n    createDiagnosticMessage({\n      source: 'gt-react',\n      severity: 'Error',\n      whatHappened:\n        'initializeGTSPA() cannot be called from the server runtime entry point',\n      why: 'initializeGTSPA() initializes browser-only SPA state and translation cache behavior.',\n      fix: 'Use initializeGT() for server-rendered React runtimes or import initializeGTSPA from the browser entry point.',\n    })\n  );\n};\n\n// ===== Components ===== //\nexport { ServerGTProvider as GTProvider } from './provider/ServerGTProvider';\nexport { LocaleSelector } from './components/LocaleSelector';\nexport { RegionSelector } from './components/RegionSelector';\n\n// ===== Components ===== //\nexport {\n  Branch,\n  Plural,\n  Derive,\n  GtInternalTranslateJsx,\n  GtInternalVar,\n  T,\n  Currency,\n  DateTime,\n  RelativeTime,\n  Var,\n  Num,\n} from '@generaltranslation/react-core/components';\n\nexport async function Tx(_props: TxProps): Promise<ReactNode> {\n  throw new Error('Tx is only supported via RSC');\n}\n\n// ===== Hooks ===== //\nexport {\n  useLocale,\n  useRegion,\n  useCustomMapping,\n  useDefaultLocale,\n  useEnableI18n,\n  useLocales,\n  useFormatLocales,\n  useGT,\n  useMessages,\n  useTranslations,\n  useLocaleDirection,\n  useLocaleProperties,\n} from '@generaltranslation/react-core/hooks';\n\n// ===== Functions ===== //\nexport {\n  msg,\n  decodeMsg,\n  decodeOptions,\n  derive,\n  declareVar,\n  decodeVars,\n  mFallback,\n  gtFallback,\n  getFormatLocales,\n  getDefaultLocale,\n  getLocaleProperties,\n  getLocales,\n  resolveCanonicalLocale,\n  getReactI18nCache,\n  getTranslationsSnapshot,\n  getVersionId,\n  createRenderPipeline,\n  setReactI18nCache,\n  t,\n} from '@generaltranslation/react-core/pure';\n\nexport type {\n  RenderPipeline,\n  RenderPreparedT,\n} from '@generaltranslation/react-core/pure';\n\nexport type { SharedGTProviderProps } from './provider/GTProviderProps';\nexport {\n  GtInternalRuntimeTranslateJsx,\n  GtInternalRuntimeTranslateString,\n} from 'gt-i18n/internal';\nexport type {\n  GTTranslationOptions,\n  RuntimeTranslationOptions,\n} from 'gt-i18n/types';\nexport type {\n  SyncResolutionFunction,\n  SyncResolutionFunctionWithFallback,\n} from 'gt-i18n/types';\n\n// ===== Singletons ===== //\nexport {\n  ReactI18nCache,\n  type ReactI18nCacheParams,\n} from '@generaltranslation/react-core/pure';\n"],"mappings":"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"}