gt-tanstack-start 11.0.11 → 11.0.12

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # gt-tanstack-start
 
+## 11.0.12
+
+### Patch Changes
+
+- [#1941](https://github.com/generaltranslation/gt/pull/1941) [`7fef71d`](https://github.com/generaltranslation/gt/commit/7fef71de88a770bd5e14ec9f62cdac91671b3d2f) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - Add request-scoped server middleware and server-only translation helpers for TanStack Start.
+
+- Updated dependencies []:
+  - @generaltranslation/react-core@11.0.12
+  - gt-react@11.0.12
+
 ## 11.0.11
 
 ### Patch Changes

package/dist/{index.d.mts → index.client.d.mts}

@@ -6,4 +6,4 @@ import { Branch, Currency, DateTime, Derive, GTProvider, LocaleSelector, Num, Pl
 declare function parseLocale(): string;
 //#endregion
 export { Branch, Currency, DateTime, Derive, GTProvider, LocaleSelector, Num, Plural, RelativeTime, T, Var, declareVar, decodeMsg, decodeOptions, decodeVars, derive, getTranslationsSnapshot, gtFallback, initializeGT, mFallback, msg, parseLocale, t, useCustomMapping, useDefaultLocale, useEnableI18n, useFormatLocales, useGT, useLocale, useLocaleSelector, useLocales, useMessages, useSetEnableI18n, useSetLocale, useTranslations };
-//# sourceMappingURL=index.d.mts.map
+//# sourceMappingURL=index.client.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.client.d.mts","names":[],"sources":["../src/functions/parseLocale.ts"],"mappings":";;;;;iBAkBgB,WAAA,CAAA"}

package/dist/index.client.mjs

@@ -0,0 +1,140 @@
+import { createIsomorphicFn } from "@tanstack/react-start";
+import { getRequest, setCookie } from "@tanstack/react-start/server";
+import { getI18nConfig } from "@generaltranslation/react-core/pure";
+import { createGlobalSingleton, getCookieValue, parseAcceptLanguage } from "gt-i18n/internal";
+import { Branch, Currency, DateTime, Derive, GTProvider, LocaleSelector, Num, Plural, RelativeTime, T, Var, declareVar, decodeMsg, decodeOptions, decodeVars, derive, getTranslationsSnapshot, gtFallback, initializeGT, mFallback, msg, t, useCustomMapping, useDefaultLocale, useEnableI18n, useFormatLocales, useGT, useLocale, useLocaleSelector, useLocales, useMessages, useSetEnableI18n, useSetLocale, useTranslations } from "gt-react";
+//#region ../core/dist/api-BOEGbEF6.mjs
+function ensureSentence(text) {
+	const trimmed = text.trim();
+	if (!trimmed) return "";
+	return /[.!?)]$/.test(trimmed) ? trimmed : `${trimmed}.`;
+}
+function stripSentence(text) {
+	const trimmed = text.trim();
+	let end = trimmed.length;
+	while (end > 0) {
+		const char = trimmed[end - 1];
+		if (char !== "." && char !== "!" && char !== "?") break;
+		end -= 1;
+	}
+	return trimmed.slice(0, end);
+}
+function lowercaseFirstWord(text) {
+	return text.replace(/^[A-Z][a-z]/, (match) => match.toLowerCase());
+}
+function formatDetails(details) {
+	if (!details) return "";
+	const detailText = Array.isArray(details) ? details.join(", ") : details;
+	if (!detailText.trim()) return "";
+	return ensureSentence(`Details: ${detailText}`);
+}
+function createDiagnosticMessage({ source, severity, whatHappened, reassurance, why, fix, wayOut, details, docsUrl }) {
+	const prefix = source ? severity ? `${source} ${severity}:` : `${source}:` : severity ? `${severity}:` : "";
+	const whatAndWhy = why ? `${stripSentence(whatHappened)} because ${lowercaseFirstWord(stripSentence(why))}` : whatHappened;
+	const shouldCombineWayOut = !!fix && !!wayOut && /^[a-z]/.test(stripSentence(wayOut));
+	const messageParts = [
+		whatAndWhy,
+		reassurance,
+		shouldCombineWayOut ? `${stripSentence(fix)}, or ${lowercaseFirstWord(stripSentence(wayOut))}` : fix,
+		shouldCombineWayOut ? void 0 : wayOut,
+		formatDetails(details)
+	].filter((part) => !!part).map(ensureSentence);
+	if (docsUrl) messageParts.push(`Learn more: ${docsUrl}`);
+	const message = messageParts.join(" ");
+	return prefix ? `${prefix} ${message}` : message;
+}
+//#endregion
+//#region src/condition-store/singleton.ts
+const conditionStoreNotInitializedError = createDiagnosticMessage({
+	source: "gt-tanstack-start",
+	severity: "Error",
+	whatHappened: "Cannot read GT server request state before initialization",
+	why: "initializeGT() has not initialized the TanStack Start server condition store",
+	fix: "Call initializeGT() from 'gt-tanstack-start' during application setup before using gtMiddleware or server APIs."
+});
+const conditionStoreSingleton = createGlobalSingleton({
+	namespace: "tanstackStart",
+	key: "conditionStore",
+	source: "gt-tanstack-start",
+	notInitialized: () => conditionStoreNotInitializedError
+});
+const getConditionStore = conditionStoreSingleton.get;
+conditionStoreSingleton.set;
+const isConditionStoreInitialized = conditionStoreSingleton.isInitialized;
+//#endregion
+//#region src/functions/requestConditions.ts
+const localeCookieOptions = {
+	path: "/",
+	sameSite: "lax",
+	maxAge: 3600 * 24 * 365
+};
+const noLocaleCandidatesWarning = createDiagnosticMessage({
+	source: "gt-tanstack-start",
+	severity: "Warning",
+	whatHappened: "No locale preference was found for the current request",
+	reassurance: "GT will use the configured default locale",
+	why: "neither the locale cookie nor the Accept-Language header supplied a supported locale candidate"
+});
+function resolveRequestConditions(request, localeConfig) {
+	const i18nConfig = getI18nConfig();
+	const cookieHeader = request.headers.get("cookie");
+	const localeCandidates = [];
+	const cookieLocale = getCookieValue(cookieHeader, i18nConfig.getLocaleCookieName());
+	if (cookieLocale) localeCandidates.push(cookieLocale);
+	localeCandidates.push(...parseAcceptLanguage(request.headers.get("accept-language")));
+	if (localeCandidates.length === 0) console.warn(noLocaleCandidatesWarning);
+	const locale = i18nConfig.resolveSupportedLocale(localeCandidates, localeConfig ?? {
+		defaultLocale: i18nConfig.getDefaultLocale(),
+		locales: i18nConfig.getLocales(),
+		customMapping: i18nConfig.getCustomMapping()
+	});
+	setCookie(i18nConfig.getLocaleCookieName(), locale, localeCookieOptions);
+	const enableI18nCookie = getCookieValue(cookieHeader, i18nConfig.getEnableI18nCookieName());
+	return {
+		locale,
+		region: getCookieValue(cookieHeader, i18nConfig.getRegionCookieName()) || void 0,
+		enableI18n: enableI18nCookie === void 0 ? true : enableI18nCookie === "true"
+	};
+}
+//#endregion
+//#region src/functions/parseLocale.ts
+const determineLocale = createIsomorphicFn().server(determineLocaleServer).client(determineLocaleClient);
+/**
+* Resolve the user's locale for the current TanStack Start request or browser.
+*/
+function parseLocale() {
+	const i18nConfig = getI18nConfig();
+	return determineLocale({
+		defaultLocale: i18nConfig.getDefaultLocale(),
+		locales: i18nConfig.getLocales(),
+		customMapping: i18nConfig.getCustomMapping()
+	});
+}
+function determineLocaleServer({ defaultLocale, locales, customMapping }) {
+	if (isConditionStoreInitialized()) {
+		const conditionStore = getConditionStore();
+		if (conditionStore.hasActiveScope()) return conditionStore.getLocale();
+	}
+	return resolveRequestConditions(getRequest(), {
+		defaultLocale,
+		locales,
+		customMapping
+	}).locale;
+}
+function determineLocaleClient({ defaultLocale, locales, customMapping }) {
+	const i18nConfig = getI18nConfig();
+	const localeCookieName = i18nConfig.getLocaleCookieName();
+	const candidates = [];
+	const cookie = getCookieValue(document.cookie, localeCookieName);
+	if (cookie) candidates.push(cookie);
+	if (candidates.length === 0) console.warn("gt-tanstack-start(client): no locales could be determined for this request");
+	return i18nConfig.resolveSupportedLocale(candidates, {
+		defaultLocale,
+		locales,
+		customMapping
+	});
+}
+//#endregion
+export { Branch, Currency, DateTime, Derive, GTProvider, LocaleSelector, Num, Plural, RelativeTime, T, Var, declareVar, decodeMsg, decodeOptions, decodeVars, derive, getTranslationsSnapshot, gtFallback, initializeGT, mFallback, msg, parseLocale, t, useCustomMapping, useDefaultLocale, useEnableI18n, useFormatLocales, useGT, useLocale, useLocaleSelector, useLocales, useMessages, useSetEnableI18n, useSetLocale, useTranslations };
+
+//# sourceMappingURL=index.client.mjs.map

package/dist/index.client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.client.mjs","names":[],"sources":["../../core/dist/api-BOEGbEF6.mjs","../src/condition-store/singleton.ts","../src/functions/requestConditions.ts","../src/functions/parseLocale.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 { createDiagnosticMessage } from 'generaltranslation/internal';\nimport { createGlobalSingleton } from 'gt-i18n/internal';\nimport type { AsyncLocalConditionStore } from './AsyncLocalConditionStore';\n\nconst conditionStoreNotInitializedError = createDiagnosticMessage({\n  source: 'gt-tanstack-start',\n  severity: 'Error',\n  whatHappened: 'Cannot read GT server request state before initialization',\n  why: 'initializeGT() has not initialized the TanStack Start server condition store',\n  fix: \"Call initializeGT() from 'gt-tanstack-start' during application setup before using gtMiddleware or server APIs.\",\n});\n\nconst conditionStoreSingleton = createGlobalSingleton<AsyncLocalConditionStore>(\n  {\n    namespace: 'tanstackStart',\n    key: 'conditionStore',\n    source: 'gt-tanstack-start',\n    notInitialized: () => conditionStoreNotInitializedError,\n  }\n);\n\nexport const getConditionStore = conditionStoreSingleton.get;\nexport const setConditionStore = conditionStoreSingleton.set;\nexport const isConditionStoreInitialized =\n  conditionStoreSingleton.isInitialized;\n","import { setCookie } from '@tanstack/react-start/server';\nimport {\n  getI18nConfig,\n  type I18nConfigParams,\n} from '@generaltranslation/react-core/pure';\nimport { createDiagnosticMessage } from 'generaltranslation/internal';\nimport { getCookieValue, parseAcceptLanguage } from 'gt-i18n/internal';\nimport type { RequestConditions } from '../condition-store/AsyncLocalConditionStore';\n\nexport const localeCookieOptions = {\n  path: '/',\n  sameSite: 'lax' as const,\n  maxAge: 60 * 60 * 24 * 365,\n};\n\nconst noLocaleCandidatesWarning = createDiagnosticMessage({\n  source: 'gt-tanstack-start',\n  severity: 'Warning',\n  whatHappened: 'No locale preference was found for the current request',\n  reassurance: 'GT will use the configured default locale',\n  why: 'neither the locale cookie nor the Accept-Language header supplied a supported locale candidate',\n});\n\nexport function resolveRequestConditions(\n  request: Request,\n  localeConfig?: I18nConfigParams\n): RequestConditions {\n  const i18nConfig = getI18nConfig();\n  const cookieHeader = request.headers.get('cookie');\n  const localeCandidates: string[] = [];\n  const cookieLocale = getCookieValue(\n    cookieHeader,\n    i18nConfig.getLocaleCookieName()\n  );\n  if (cookieLocale) localeCandidates.push(cookieLocale);\n  localeCandidates.push(\n    ...parseAcceptLanguage(request.headers.get('accept-language'))\n  );\n\n  if (localeCandidates.length === 0) {\n    console.warn(noLocaleCandidatesWarning);\n  }\n\n  const locale = i18nConfig.resolveSupportedLocale(\n    localeCandidates,\n    localeConfig ?? {\n      defaultLocale: i18nConfig.getDefaultLocale(),\n      locales: i18nConfig.getLocales(),\n      customMapping: i18nConfig.getCustomMapping(),\n    }\n  );\n\n  setCookie(i18nConfig.getLocaleCookieName(), locale, localeCookieOptions);\n\n  const enableI18nCookie = getCookieValue(\n    cookieHeader,\n    i18nConfig.getEnableI18nCookieName()\n  );\n\n  return {\n    locale,\n    region:\n      getCookieValue(cookieHeader, i18nConfig.getRegionCookieName()) ||\n      undefined,\n    enableI18n:\n      enableI18nCookie === undefined ? true : enableI18nCookie === 'true',\n  };\n}\n","import { createIsomorphicFn } from '@tanstack/react-start';\nimport { getRequest } from '@tanstack/react-start/server';\nimport { getI18nConfig } from '@generaltranslation/react-core/pure';\nimport { getCookieValue } from 'gt-i18n/internal';\nimport type { LocaleResolverConfig } from 'gt-i18n/internal/types';\nimport {\n  getConditionStore,\n  isConditionStoreInitialized,\n} from '../condition-store/singleton';\nimport { resolveRequestConditions } from './requestConditions';\n\nexport const determineLocale = createIsomorphicFn()\n  .server(determineLocaleServer)\n  .client(determineLocaleClient);\n\n/**\n * Resolve the user's locale for the current TanStack Start request or browser.\n */\nexport function parseLocale(): string {\n  const i18nConfig = getI18nConfig();\n  return determineLocale({\n    defaultLocale: i18nConfig.getDefaultLocale(),\n    locales: i18nConfig.getLocales(),\n    customMapping: i18nConfig.getCustomMapping(),\n  });\n}\n\nfunction determineLocaleServer({\n  defaultLocale,\n  locales,\n  customMapping,\n}: LocaleResolverConfig) {\n  if (isConditionStoreInitialized()) {\n    const conditionStore = getConditionStore();\n    if (conditionStore.hasActiveScope()) {\n      return conditionStore.getLocale();\n    }\n  }\n\n  return resolveRequestConditions(getRequest(), {\n    defaultLocale,\n    locales,\n    customMapping,\n  }).locale;\n}\n\nfunction determineLocaleClient({\n  defaultLocale,\n  locales,\n  customMapping,\n}: LocaleResolverConfig) {\n  const i18nConfig = getI18nConfig();\n  const localeCookieName = i18nConfig.getLocaleCookieName();\n  const candidates: string[] = [];\n\n  const cookie = getCookieValue(document.cookie, localeCookieName);\n  if (cookie) candidates.push(cookie);\n\n  if (candidates.length === 0) {\n    console.warn(\n      'gt-tanstack-start(client): no locales could be determined for this request'\n    );\n  }\n\n  return i18nConfig.resolveSupportedLocale(candidates, {\n    defaultLocale,\n    locales,\n    customMapping,\n  });\n}\n"],"mappings":"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"}

package/dist/{index.d.cts → index.server.d.mts}

@@ -1,10 +1,14 @@
-import { Branch, Currency, DateTime, Derive, GTProvider, LocaleSelector, Num, Plural, RelativeTime, T, Var, declareVar, decodeMsg, decodeOptions, decodeVars, derive, getTranslationsSnapshot, gtFallback, initializeGT, mFallback, msg, t, useCustomMapping, useDefaultLocale, useEnableI18n, useFormatLocales, useGT, useLocale, useLocaleSelector, useLocales, useMessages, useSetEnableI18n, useSetLocale, useTranslations } from "gt-react";
-
+import { Branch, Currency, DateTime, Derive, GTProvider, LocaleSelector, Num, Plural, RelativeTime, T, Var, declareVar, decodeMsg, decodeOptions, decodeVars, derive, getTranslationsSnapshot, gtFallback, initializeGT as initializeGT$1, mFallback, msg, t, useCustomMapping, useDefaultLocale, useEnableI18n, useFormatLocales, useGT, useLocale, useLocaleSelector, useLocales, useMessages, useSetEnableI18n, useSetLocale, useTranslations } from "gt-react";
 //#region src/functions/parseLocale.d.ts
 /**
  * Resolve the user's locale for the current TanStack Start request or browser.
  */
 declare function parseLocale(): string;
 //#endregion
+//#region src/setup/initializeGT.d.ts
+type InitializeGTParams = Parameters<typeof initializeGT$1>[0];
+/** Initialize GT and its server request condition store. */
+declare function initializeGT(config: InitializeGTParams): void;
+//#endregion
 export { Branch, Currency, DateTime, Derive, GTProvider, LocaleSelector, Num, Plural, RelativeTime, T, Var, declareVar, decodeMsg, decodeOptions, decodeVars, derive, getTranslationsSnapshot, gtFallback, initializeGT, mFallback, msg, parseLocale, t, useCustomMapping, useDefaultLocale, useEnableI18n, useFormatLocales, useGT, useLocale, useLocaleSelector, useLocales, useMessages, useSetEnableI18n, useSetLocale, useTranslations };
-//# sourceMappingURL=index.d.cts.map
+//# sourceMappingURL=index.server.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.server.d.mts","names":[],"sources":["../src/functions/parseLocale.ts","../src/setup/initializeGT.ts"],"mappings":";;;;;iBAkBgB,WAAA,CAAA;;;KCdX,kBAAA,GAAqB,UAAA,QAAkB,cAAA;;iBAG5B,YAAA,CAAa,MAAA,EAAQ,kBAAA"}

package/dist/index.server.mjs

@@ -0,0 +1,184 @@
+import { createIsomorphicFn } from "@tanstack/react-start";
+import { getRequest, setCookie } from "@tanstack/react-start/server";
+import { getI18nConfig } from "@generaltranslation/react-core/pure";
+import { createGlobalSingleton, getCookieValue, parseAcceptLanguage } from "gt-i18n/internal";
+import { Branch, Currency, DateTime, Derive, GTProvider, LocaleSelector, Num, Plural, RelativeTime, T, Var, declareVar, decodeMsg, decodeOptions, decodeVars, derive, getTranslationsSnapshot, gtFallback, initializeGT as initializeGT$1, mFallback, msg, t, useCustomMapping, useDefaultLocale, useEnableI18n, useFormatLocales, useGT, useLocale, useLocaleSelector, useLocales, useMessages, useSetEnableI18n, useSetLocale, useTranslations } from "gt-react";
+import { AsyncLocalStorage } from "node:async_hooks";
+//#region ../core/dist/api-BOEGbEF6.mjs
+function ensureSentence(text) {
+	const trimmed = text.trim();
+	if (!trimmed) return "";
+	return /[.!?)]$/.test(trimmed) ? trimmed : `${trimmed}.`;
+}
+function stripSentence(text) {
+	const trimmed = text.trim();
+	let end = trimmed.length;
+	while (end > 0) {
+		const char = trimmed[end - 1];
+		if (char !== "." && char !== "!" && char !== "?") break;
+		end -= 1;
+	}
+	return trimmed.slice(0, end);
+}
+function lowercaseFirstWord(text) {
+	return text.replace(/^[A-Z][a-z]/, (match) => match.toLowerCase());
+}
+function formatDetails(details) {
+	if (!details) return "";
+	const detailText = Array.isArray(details) ? details.join(", ") : details;
+	if (!detailText.trim()) return "";
+	return ensureSentence(`Details: ${detailText}`);
+}
+function createDiagnosticMessage({ source, severity, whatHappened, reassurance, why, fix, wayOut, details, docsUrl }) {
+	const prefix = source ? severity ? `${source} ${severity}:` : `${source}:` : severity ? `${severity}:` : "";
+	const whatAndWhy = why ? `${stripSentence(whatHappened)} because ${lowercaseFirstWord(stripSentence(why))}` : whatHappened;
+	const shouldCombineWayOut = !!fix && !!wayOut && /^[a-z]/.test(stripSentence(wayOut));
+	const messageParts = [
+		whatAndWhy,
+		reassurance,
+		shouldCombineWayOut ? `${stripSentence(fix)}, or ${lowercaseFirstWord(stripSentence(wayOut))}` : fix,
+		shouldCombineWayOut ? void 0 : wayOut,
+		formatDetails(details)
+	].filter((part) => !!part).map(ensureSentence);
+	if (docsUrl) messageParts.push(`Learn more: ${docsUrl}`);
+	const message = messageParts.join(" ");
+	return prefix ? `${prefix} ${message}` : message;
+}
+//#endregion
+//#region src/condition-store/singleton.ts
+const conditionStoreNotInitializedError = createDiagnosticMessage({
+	source: "gt-tanstack-start",
+	severity: "Error",
+	whatHappened: "Cannot read GT server request state before initialization",
+	why: "initializeGT() has not initialized the TanStack Start server condition store",
+	fix: "Call initializeGT() from 'gt-tanstack-start' during application setup before using gtMiddleware or server APIs."
+});
+const conditionStoreSingleton = createGlobalSingleton({
+	namespace: "tanstackStart",
+	key: "conditionStore",
+	source: "gt-tanstack-start",
+	notInitialized: () => conditionStoreNotInitializedError
+});
+const getConditionStore = conditionStoreSingleton.get;
+const setConditionStore = conditionStoreSingleton.set;
+const isConditionStoreInitialized = conditionStoreSingleton.isInitialized;
+//#endregion
+//#region src/functions/requestConditions.ts
+const localeCookieOptions = {
+	path: "/",
+	sameSite: "lax",
+	maxAge: 3600 * 24 * 365
+};
+const noLocaleCandidatesWarning = createDiagnosticMessage({
+	source: "gt-tanstack-start",
+	severity: "Warning",
+	whatHappened: "No locale preference was found for the current request",
+	reassurance: "GT will use the configured default locale",
+	why: "neither the locale cookie nor the Accept-Language header supplied a supported locale candidate"
+});
+function resolveRequestConditions(request, localeConfig) {
+	const i18nConfig = getI18nConfig();
+	const cookieHeader = request.headers.get("cookie");
+	const localeCandidates = [];
+	const cookieLocale = getCookieValue(cookieHeader, i18nConfig.getLocaleCookieName());
+	if (cookieLocale) localeCandidates.push(cookieLocale);
+	localeCandidates.push(...parseAcceptLanguage(request.headers.get("accept-language")));
+	if (localeCandidates.length === 0) console.warn(noLocaleCandidatesWarning);
+	const locale = i18nConfig.resolveSupportedLocale(localeCandidates, localeConfig ?? {
+		defaultLocale: i18nConfig.getDefaultLocale(),
+		locales: i18nConfig.getLocales(),
+		customMapping: i18nConfig.getCustomMapping()
+	});
+	setCookie(i18nConfig.getLocaleCookieName(), locale, localeCookieOptions);
+	const enableI18nCookie = getCookieValue(cookieHeader, i18nConfig.getEnableI18nCookieName());
+	return {
+		locale,
+		region: getCookieValue(cookieHeader, i18nConfig.getRegionCookieName()) || void 0,
+		enableI18n: enableI18nCookie === void 0 ? true : enableI18nCookie === "true"
+	};
+}
+//#endregion
+//#region src/functions/parseLocale.ts
+const determineLocale = createIsomorphicFn().server(determineLocaleServer).client(determineLocaleClient);
+/**
+* Resolve the user's locale for the current TanStack Start request or browser.
+*/
+function parseLocale() {
+	const i18nConfig = getI18nConfig();
+	return determineLocale({
+		defaultLocale: i18nConfig.getDefaultLocale(),
+		locales: i18nConfig.getLocales(),
+		customMapping: i18nConfig.getCustomMapping()
+	});
+}
+function determineLocaleServer({ defaultLocale, locales, customMapping }) {
+	if (isConditionStoreInitialized()) {
+		const conditionStore = getConditionStore();
+		if (conditionStore.hasActiveScope()) return conditionStore.getLocale();
+	}
+	return resolveRequestConditions(getRequest(), {
+		defaultLocale,
+		locales,
+		customMapping
+	}).locale;
+}
+function determineLocaleClient({ defaultLocale, locales, customMapping }) {
+	const i18nConfig = getI18nConfig();
+	const localeCookieName = i18nConfig.getLocaleCookieName();
+	const candidates = [];
+	const cookie = getCookieValue(document.cookie, localeCookieName);
+	if (cookie) candidates.push(cookie);
+	if (candidates.length === 0) console.warn("gt-tanstack-start(client): no locales could be determined for this request");
+	return i18nConfig.resolveSupportedLocale(candidates, {
+		defaultLocale,
+		locales,
+		customMapping
+	});
+}
+//#endregion
+//#region src/condition-store/AsyncLocalConditionStore.ts
+const missingRequestScopeError = createDiagnosticMessage({
+	source: "gt-tanstack-start",
+	severity: "Error",
+	whatHappened: "Cannot read GT request state outside a request scope",
+	why: "the gt-tanstack-start request middleware has not initialized the ConditionStore for this request",
+	fix: "Register gtMiddleware from 'gt-tanstack-start/server' as global TanStack Start request middleware."
+});
+/**
+* Read-only ConditionStore backed by request-scoped AsyncLocalStorage.
+*/
+var AsyncLocalConditionStore = class {
+	constructor(config) {
+		this.config = config;
+		this.storage = new AsyncLocalStorage();
+		this.getLocale = () => this.getConditions().locale;
+		this.getRegion = () => this.getConditions().region;
+		this.getEnableI18n = () => this.getConditions().enableI18n;
+		this.setLocale = (_locale) => {};
+		this.setRegion = (_region) => {};
+		this.setEnableI18n = (_enableI18n) => {};
+	}
+	run(request, callback) {
+		const conditions = resolveRequestConditions(request, this.config);
+		return this.storage.run(conditions, callback);
+	}
+	hasActiveScope() {
+		return this.storage.getStore() !== void 0;
+	}
+	getConditions() {
+		const conditions = this.storage.getStore();
+		if (!conditions) throw new Error(missingRequestScopeError);
+		return conditions;
+	}
+};
+//#endregion
+//#region src/setup/initializeGT.ts
+/** Initialize GT and its server request condition store. */
+function initializeGT(config) {
+	initializeGT$1(config);
+	setConditionStore(new AsyncLocalConditionStore(config));
+}
+//#endregion
+export { Branch, Currency, DateTime, Derive, GTProvider, LocaleSelector, Num, Plural, RelativeTime, T, Var, declareVar, decodeMsg, decodeOptions, decodeVars, derive, getTranslationsSnapshot, gtFallback, initializeGT, mFallback, msg, parseLocale, t, useCustomMapping, useDefaultLocale, useEnableI18n, useFormatLocales, useGT, useLocale, useLocaleSelector, useLocales, useMessages, useSetEnableI18n, useSetLocale, useTranslations };
+
+//# sourceMappingURL=index.server.mjs.map

package/dist/index.server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.server.mjs","names":[],"sources":["../../core/dist/api-BOEGbEF6.mjs","../src/condition-store/singleton.ts","../src/functions/requestConditions.ts","../src/functions/parseLocale.ts","../src/condition-store/AsyncLocalConditionStore.ts","../src/setup/initializeGT.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 { createDiagnosticMessage } from 'generaltranslation/internal';\nimport { createGlobalSingleton } from 'gt-i18n/internal';\nimport type { AsyncLocalConditionStore } from './AsyncLocalConditionStore';\n\nconst conditionStoreNotInitializedError = createDiagnosticMessage({\n  source: 'gt-tanstack-start',\n  severity: 'Error',\n  whatHappened: 'Cannot read GT server request state before initialization',\n  why: 'initializeGT() has not initialized the TanStack Start server condition store',\n  fix: \"Call initializeGT() from 'gt-tanstack-start' during application setup before using gtMiddleware or server APIs.\",\n});\n\nconst conditionStoreSingleton = createGlobalSingleton<AsyncLocalConditionStore>(\n  {\n    namespace: 'tanstackStart',\n    key: 'conditionStore',\n    source: 'gt-tanstack-start',\n    notInitialized: () => conditionStoreNotInitializedError,\n  }\n);\n\nexport const getConditionStore = conditionStoreSingleton.get;\nexport const setConditionStore = conditionStoreSingleton.set;\nexport const isConditionStoreInitialized =\n  conditionStoreSingleton.isInitialized;\n","import { setCookie } from '@tanstack/react-start/server';\nimport {\n  getI18nConfig,\n  type I18nConfigParams,\n} from '@generaltranslation/react-core/pure';\nimport { createDiagnosticMessage } from 'generaltranslation/internal';\nimport { getCookieValue, parseAcceptLanguage } from 'gt-i18n/internal';\nimport type { RequestConditions } from '../condition-store/AsyncLocalConditionStore';\n\nexport const localeCookieOptions = {\n  path: '/',\n  sameSite: 'lax' as const,\n  maxAge: 60 * 60 * 24 * 365,\n};\n\nconst noLocaleCandidatesWarning = createDiagnosticMessage({\n  source: 'gt-tanstack-start',\n  severity: 'Warning',\n  whatHappened: 'No locale preference was found for the current request',\n  reassurance: 'GT will use the configured default locale',\n  why: 'neither the locale cookie nor the Accept-Language header supplied a supported locale candidate',\n});\n\nexport function resolveRequestConditions(\n  request: Request,\n  localeConfig?: I18nConfigParams\n): RequestConditions {\n  const i18nConfig = getI18nConfig();\n  const cookieHeader = request.headers.get('cookie');\n  const localeCandidates: string[] = [];\n  const cookieLocale = getCookieValue(\n    cookieHeader,\n    i18nConfig.getLocaleCookieName()\n  );\n  if (cookieLocale) localeCandidates.push(cookieLocale);\n  localeCandidates.push(\n    ...parseAcceptLanguage(request.headers.get('accept-language'))\n  );\n\n  if (localeCandidates.length === 0) {\n    console.warn(noLocaleCandidatesWarning);\n  }\n\n  const locale = i18nConfig.resolveSupportedLocale(\n    localeCandidates,\n    localeConfig ?? {\n      defaultLocale: i18nConfig.getDefaultLocale(),\n      locales: i18nConfig.getLocales(),\n      customMapping: i18nConfig.getCustomMapping(),\n    }\n  );\n\n  setCookie(i18nConfig.getLocaleCookieName(), locale, localeCookieOptions);\n\n  const enableI18nCookie = getCookieValue(\n    cookieHeader,\n    i18nConfig.getEnableI18nCookieName()\n  );\n\n  return {\n    locale,\n    region:\n      getCookieValue(cookieHeader, i18nConfig.getRegionCookieName()) ||\n      undefined,\n    enableI18n:\n      enableI18nCookie === undefined ? true : enableI18nCookie === 'true',\n  };\n}\n","import { createIsomorphicFn } from '@tanstack/react-start';\nimport { getRequest } from '@tanstack/react-start/server';\nimport { getI18nConfig } from '@generaltranslation/react-core/pure';\nimport { getCookieValue } from 'gt-i18n/internal';\nimport type { LocaleResolverConfig } from 'gt-i18n/internal/types';\nimport {\n  getConditionStore,\n  isConditionStoreInitialized,\n} from '../condition-store/singleton';\nimport { resolveRequestConditions } from './requestConditions';\n\nexport const determineLocale = createIsomorphicFn()\n  .server(determineLocaleServer)\n  .client(determineLocaleClient);\n\n/**\n * Resolve the user's locale for the current TanStack Start request or browser.\n */\nexport function parseLocale(): string {\n  const i18nConfig = getI18nConfig();\n  return determineLocale({\n    defaultLocale: i18nConfig.getDefaultLocale(),\n    locales: i18nConfig.getLocales(),\n    customMapping: i18nConfig.getCustomMapping(),\n  });\n}\n\nfunction determineLocaleServer({\n  defaultLocale,\n  locales,\n  customMapping,\n}: LocaleResolverConfig) {\n  if (isConditionStoreInitialized()) {\n    const conditionStore = getConditionStore();\n    if (conditionStore.hasActiveScope()) {\n      return conditionStore.getLocale();\n    }\n  }\n\n  return resolveRequestConditions(getRequest(), {\n    defaultLocale,\n    locales,\n    customMapping,\n  }).locale;\n}\n\nfunction determineLocaleClient({\n  defaultLocale,\n  locales,\n  customMapping,\n}: LocaleResolverConfig) {\n  const i18nConfig = getI18nConfig();\n  const localeCookieName = i18nConfig.getLocaleCookieName();\n  const candidates: string[] = [];\n\n  const cookie = getCookieValue(document.cookie, localeCookieName);\n  if (cookie) candidates.push(cookie);\n\n  if (candidates.length === 0) {\n    console.warn(\n      'gt-tanstack-start(client): no locales could be determined for this request'\n    );\n  }\n\n  return i18nConfig.resolveSupportedLocale(candidates, {\n    defaultLocale,\n    locales,\n    customMapping,\n  });\n}\n","import { AsyncLocalStorage } from 'node:async_hooks';\nimport type { I18nConfigParams } from '@generaltranslation/react-core/pure';\nimport { createDiagnosticMessage } from 'generaltranslation/internal';\nimport type { ReadonlyConditionStoreInterface } from 'gt-i18n/internal/types';\nimport { resolveRequestConditions } from '../functions/requestConditions';\n\nexport type RequestConditions = {\n  locale: string;\n  region?: string;\n  enableI18n: boolean;\n};\n\nconst missingRequestScopeError = createDiagnosticMessage({\n  source: 'gt-tanstack-start',\n  severity: 'Error',\n  whatHappened: 'Cannot read GT request state outside a request scope',\n  why: 'the gt-tanstack-start request middleware has not initialized the ConditionStore for this request',\n  fix: \"Register gtMiddleware from 'gt-tanstack-start/server' as global TanStack Start request middleware.\",\n});\n\n/**\n * Read-only ConditionStore backed by request-scoped AsyncLocalStorage.\n */\nexport class AsyncLocalConditionStore implements ReadonlyConditionStoreInterface {\n  private readonly storage = new AsyncLocalStorage<RequestConditions>();\n\n  constructor(private readonly config: I18nConfigParams) {}\n\n  run<T>(request: Request, callback: () => T): T {\n    const conditions = resolveRequestConditions(request, this.config);\n    return this.storage.run(conditions, callback);\n  }\n\n  hasActiveScope(): boolean {\n    return this.storage.getStore() !== undefined;\n  }\n\n  getLocale = (): string => this.getConditions().locale;\n\n  getRegion = (): string | undefined => this.getConditions().region;\n\n  getEnableI18n = (): boolean => this.getConditions().enableI18n;\n\n  setLocale = (_locale: string): void => {};\n\n  setRegion = (_region: string | undefined): void => {};\n\n  setEnableI18n = (_enableI18n: boolean): void => {};\n\n  private getConditions(): RequestConditions {\n    const conditions = this.storage.getStore();\n    if (!conditions) throw new Error(missingRequestScopeError);\n    return conditions;\n  }\n}\n","import { initializeGT as initializeReactGT } from 'gt-react';\nimport { AsyncLocalConditionStore } from '../condition-store/AsyncLocalConditionStore';\nimport { setConditionStore } from '../condition-store/singleton';\n\ntype InitializeGTParams = Parameters<typeof initializeReactGT>[0];\n\n/** Initialize GT and its server request condition store. */\nexport function initializeGT(config: InitializeGTParams): void {\n  initializeReactGT(config);\n  setConditionStore(new AsyncLocalConditionStore(config));\n}\n"],"mappings":"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"}

package/dist/server.d.mts

@@ -0,0 +1,25 @@
+import * as _$_tanstack_react_start0 from "@tanstack/react-start";
+import * as _$gt_i18n_types0 from "gt-i18n/types";
+import { Message } from "gt-i18n/types";
+
+//#region src/middleware/gtMiddleware.d.ts
+/**
+ * Establish request-scoped GT conditions for SSR, server routes, and server
+ * functions.
+ */
+declare const gtMiddleware: _$_tanstack_react_start0.RequestMiddlewareAfterServer<{}, undefined, undefined>;
+//#endregion
+//#region src/functions/server.d.ts
+/** Return the locale associated with the current server request. */
+declare const getLocale: () => string;
+/** Return whether internationalization is enabled for the current request. */
+declare const getEnableI18n: () => boolean;
+/** Return a string translation function for the current server request. */
+declare const getGT: (messages?: Message[]) => Promise<_$gt_i18n_types0.SyncResolutionFunctionWithFallback>;
+/** Return a registered-message translation function for the current request. */
+declare const getMessages: () => Promise<_$gt_i18n_types0.MFunctionType>;
+/** Return a dictionary translation function for the current server request. */
+declare const getTranslations: (rootId?: string) => Promise<_$gt_i18n_types0.TFunctionType>;
+//#endregion
+export { getEnableI18n, getGT, getLocale, getMessages, getTranslations, gtMiddleware };
+//# sourceMappingURL=server.d.mts.map

package/dist/server.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.mts","names":[],"sources":["../src/middleware/gtMiddleware.ts","../src/functions/server.ts"],"mappings":";;;;;;;;;cAOa,YAAA,EAEX,wBAAA,CAFuB,4BAAA;;;;cCGZ,SAAA;;cAKA,aAAA;ADRb;AAAA,cCaa,KAAA,GAAK,QAAA,GAAwC,OAAA,OAAS,OAAA,CAAF,gBAAA,CAAE,kCAAA;;cAYtD,WAAA,QAAW,OAAA,CAMtB,gBAAA,CANsB,aAAA;;cASX,eAAA,GAAe,MAAA,cAA4C,OAAA,CAOtE,gBAAA,CAPsE,aAAA"}

package/dist/server.mjs

@@ -0,0 +1,108 @@
+import { createMiddleware, createServerOnlyFn } from "@tanstack/react-start";
+import { createGlobalSingleton, getGTInternal, getMessagesInternal, getTranslationsInternal } from "gt-i18n/internal";
+//#region ../core/dist/api-BOEGbEF6.mjs
+function ensureSentence(text) {
+	const trimmed = text.trim();
+	if (!trimmed) return "";
+	return /[.!?)]$/.test(trimmed) ? trimmed : `${trimmed}.`;
+}
+function stripSentence(text) {
+	const trimmed = text.trim();
+	let end = trimmed.length;
+	while (end > 0) {
+		const char = trimmed[end - 1];
+		if (char !== "." && char !== "!" && char !== "?") break;
+		end -= 1;
+	}
+	return trimmed.slice(0, end);
+}
+function lowercaseFirstWord(text) {
+	return text.replace(/^[A-Z][a-z]/, (match) => match.toLowerCase());
+}
+function formatDetails(details) {
+	if (!details) return "";
+	const detailText = Array.isArray(details) ? details.join(", ") : details;
+	if (!detailText.trim()) return "";
+	return ensureSentence(`Details: ${detailText}`);
+}
+function createDiagnosticMessage({ source, severity, whatHappened, reassurance, why, fix, wayOut, details, docsUrl }) {
+	const prefix = source ? severity ? `${source} ${severity}:` : `${source}:` : severity ? `${severity}:` : "";
+	const whatAndWhy = why ? `${stripSentence(whatHappened)} because ${lowercaseFirstWord(stripSentence(why))}` : whatHappened;
+	const shouldCombineWayOut = !!fix && !!wayOut && /^[a-z]/.test(stripSentence(wayOut));
+	const messageParts = [
+		whatAndWhy,
+		reassurance,
+		shouldCombineWayOut ? `${stripSentence(fix)}, or ${lowercaseFirstWord(stripSentence(wayOut))}` : fix,
+		shouldCombineWayOut ? void 0 : wayOut,
+		formatDetails(details)
+	].filter((part) => !!part).map(ensureSentence);
+	if (docsUrl) messageParts.push(`Learn more: ${docsUrl}`);
+	const message = messageParts.join(" ");
+	return prefix ? `${prefix} ${message}` : message;
+}
+//#endregion
+//#region src/condition-store/singleton.ts
+const conditionStoreNotInitializedError = createDiagnosticMessage({
+	source: "gt-tanstack-start",
+	severity: "Error",
+	whatHappened: "Cannot read GT server request state before initialization",
+	why: "initializeGT() has not initialized the TanStack Start server condition store",
+	fix: "Call initializeGT() from 'gt-tanstack-start' during application setup before using gtMiddleware or server APIs."
+});
+const conditionStoreSingleton = createGlobalSingleton({
+	namespace: "tanstackStart",
+	key: "conditionStore",
+	source: "gt-tanstack-start",
+	notInitialized: () => conditionStoreNotInitializedError
+});
+const getConditionStore = conditionStoreSingleton.get;
+conditionStoreSingleton.set;
+conditionStoreSingleton.isInitialized;
+//#endregion
+//#region src/middleware/gtMiddleware.ts
+/**
+* Establish request-scoped GT conditions for SSR, server routes, and server
+* functions.
+*/
+const gtMiddleware = createMiddleware().server(({ request, next }) => {
+	return getConditionStore().run(request, () => next());
+});
+//#endregion
+//#region src/functions/server.ts
+/** Return the locale associated with the current server request. */
+const getLocale = createServerOnlyFn(() => {
+	return getConditionStore().getLocale();
+});
+/** Return whether internationalization is enabled for the current request. */
+const getEnableI18n = createServerOnlyFn(() => {
+	return getConditionStore().getEnableI18n();
+});
+/** Return a string translation function for the current server request. */
+const getGT = createServerOnlyFn(async (messages) => {
+	const conditionStore = getConditionStore();
+	return getGTInternal({
+		locale: conditionStore.getLocale(),
+		enableI18n: conditionStore.getEnableI18n()
+	}, messages);
+});
+/** Return a registered-message translation function for the current request. */
+const getMessages = createServerOnlyFn(async () => {
+	const conditionStore = getConditionStore();
+	return getMessagesInternal({
+		locale: conditionStore.getLocale(),
+		enableI18n: conditionStore.getEnableI18n()
+	});
+});
+/** Return a dictionary translation function for the current server request. */
+const getTranslations = createServerOnlyFn(async (rootId) => {
+	const conditionStore = getConditionStore();
+	return getTranslationsInternal({
+		locale: conditionStore.getLocale(),
+		enableI18n: conditionStore.getEnableI18n(),
+		rootId
+	});
+});
+//#endregion
+export { getEnableI18n, getGT, getLocale, getMessages, getTranslations, gtMiddleware };
+
+//# sourceMappingURL=server.mjs.map

package/dist/server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.mjs","names":[],"sources":["../../core/dist/api-BOEGbEF6.mjs","../src/condition-store/singleton.ts","../src/middleware/gtMiddleware.ts","../src/functions/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 { createDiagnosticMessage } from 'generaltranslation/internal';\nimport { createGlobalSingleton } from 'gt-i18n/internal';\nimport type { AsyncLocalConditionStore } from './AsyncLocalConditionStore';\n\nconst conditionStoreNotInitializedError = createDiagnosticMessage({\n  source: 'gt-tanstack-start',\n  severity: 'Error',\n  whatHappened: 'Cannot read GT server request state before initialization',\n  why: 'initializeGT() has not initialized the TanStack Start server condition store',\n  fix: \"Call initializeGT() from 'gt-tanstack-start' during application setup before using gtMiddleware or server APIs.\",\n});\n\nconst conditionStoreSingleton = createGlobalSingleton<AsyncLocalConditionStore>(\n  {\n    namespace: 'tanstackStart',\n    key: 'conditionStore',\n    source: 'gt-tanstack-start',\n    notInitialized: () => conditionStoreNotInitializedError,\n  }\n);\n\nexport const getConditionStore = conditionStoreSingleton.get;\nexport const setConditionStore = conditionStoreSingleton.set;\nexport const isConditionStoreInitialized =\n  conditionStoreSingleton.isInitialized;\n","import { createMiddleware } from '@tanstack/react-start';\nimport { getConditionStore } from '../condition-store/singleton';\n\n/**\n * Establish request-scoped GT conditions for SSR, server routes, and server\n * functions.\n */\nexport const gtMiddleware = createMiddleware().server(({ request, next }) => {\n  return getConditionStore().run(request, () => next());\n});\n","import { createServerOnlyFn } from '@tanstack/react-start';\nimport {\n  getGTInternal,\n  getMessagesInternal,\n  getTranslationsInternal,\n} from 'gt-i18n/internal';\nimport type { Message } from 'gt-i18n/types';\nimport { getConditionStore } from '../condition-store/singleton';\n\n/** Return the locale associated with the current server request. */\nexport const getLocale = createServerOnlyFn((): string => {\n  return getConditionStore().getLocale();\n});\n\n/** Return whether internationalization is enabled for the current request. */\nexport const getEnableI18n = createServerOnlyFn((): boolean => {\n  return getConditionStore().getEnableI18n();\n});\n\n/** Return a string translation function for the current server request. */\nexport const getGT = createServerOnlyFn(async (messages?: Message[]) => {\n  const conditionStore = getConditionStore();\n  return getGTInternal(\n    {\n      locale: conditionStore.getLocale(),\n      enableI18n: conditionStore.getEnableI18n(),\n    },\n    messages\n  );\n});\n\n/** Return a registered-message translation function for the current request. */\nexport const getMessages = createServerOnlyFn(async () => {\n  const conditionStore = getConditionStore();\n  return getMessagesInternal({\n    locale: conditionStore.getLocale(),\n    enableI18n: conditionStore.getEnableI18n(),\n  });\n});\n\n/** Return a dictionary translation function for the current server request. */\nexport const getTranslations = createServerOnlyFn(async (rootId?: string) => {\n  const conditionStore = getConditionStore();\n  return getTranslationsInternal({\n    locale: conditionStore.getLocale(),\n    enableI18n: conditionStore.getEnableI18n(),\n    rootId,\n  });\n});\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;;;;AC1C1C,MAAM,oCAAoC,wBAAwB;CAChE,QAAQ;CACR,UAAU;CACV,cAAc;CACd,KAAK;CACL,KAAK;CACN,CAAC;AAEF,MAAM,0BAA0B,sBAC9B;CACE,WAAW;CACX,KAAK;CACL,QAAQ;CACR,sBAAsB;CACvB,CACF;AAED,MAAa,oBAAoB,wBAAwB;AACxB,wBAAwB;AAEvD,wBAAwB;;;;;;;ACjB1B,MAAa,eAAe,kBAAkB,CAAC,QAAQ,EAAE,SAAS,WAAW;AAC3E,QAAO,mBAAmB,CAAC,IAAI,eAAe,MAAM,CAAC;EACrD;;;;ACCF,MAAa,YAAY,yBAAiC;AACxD,QAAO,mBAAmB,CAAC,WAAW;EACtC;;AAGF,MAAa,gBAAgB,yBAAkC;AAC7D,QAAO,mBAAmB,CAAC,eAAe;EAC1C;;AAGF,MAAa,QAAQ,mBAAmB,OAAO,aAAyB;CACtE,MAAM,iBAAiB,mBAAmB;AAC1C,QAAO,cACL;EACE,QAAQ,eAAe,WAAW;EAClC,YAAY,eAAe,eAAe;EAC3C,EACD,SACD;EACD;;AAGF,MAAa,cAAc,mBAAmB,YAAY;CACxD,MAAM,iBAAiB,mBAAmB;AAC1C,QAAO,oBAAoB;EACzB,QAAQ,eAAe,WAAW;EAClC,YAAY,eAAe,eAAe;EAC3C,CAAC;EACF;;AAGF,MAAa,kBAAkB,mBAAmB,OAAO,WAAoB;CAC3E,MAAM,iBAAiB,mBAAmB;AAC1C,QAAO,wBAAwB;EAC7B,QAAQ,eAAe,WAAW;EAClC,YAAY,eAAe,eAAe;EAC1C;EACD,CAAC;EACF"}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "gt-tanstack-start",
-  "version": "11.0.11",
+  "version": "11.0.12",
   "description": "TanStack Start integration for General Translation",
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.cts",
+  "main": "./dist/index.server.mjs",
+  "module": "./dist/index.server.mjs",
+  "types": "./dist/index.server.d.mts",
   "files": [
     "dist",
     "CHANGELOG.md"
@@ -16,9 +16,9 @@
     "@tanstack/react-start": ">=1.159.0"
   },
   "dependencies": {
-    "gt-react": "11.0.11",
+    "gt-react": "11.0.12",
+    "@generaltranslation/react-core": "11.0.12",
     "gt-i18n": "1.0.7",
-    "@generaltranslation/react-core": "11.0.11",
     "generaltranslation": "9.0.3"
   },
   "repository": {
@@ -41,15 +41,32 @@
   },
   "exports": {
     ".": {
-      "require": {
-        "types": "./dist/index.d.cts",
-        "default": "./dist/index.cjs"
+      "browser": {
+        "import": {
+          "types": "./dist/index.client.d.mts",
+          "default": "./dist/index.client.mjs"
+        },
+        "default": "./dist/index.client.mjs"
       },
       "import": {
-        "types": "./dist/index.d.mts",
-        "default": "./dist/index.mjs"
+        "types": "./dist/index.server.d.mts",
+        "default": "./dist/index.server.mjs"
       },
-      "default": "./dist/index.mjs"
+      "default": "./dist/index.server.mjs"
+    },
+    "./server": {
+      "import": {
+        "types": "./dist/server.d.mts",
+        "default": "./dist/server.mjs"
+      },
+      "default": "./dist/server.mjs"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "server": [
+        "./dist/server.d.mts"
+      ]
     }
   },
   "keywords": [

package/dist/index.cjs

@@ -1,260 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-let _tanstack_react_start = require("@tanstack/react-start");
-let _tanstack_react_start_server = require("@tanstack/react-start/server");
-let _generaltranslation_react_core_pure = require("@generaltranslation/react-core/pure");
-let gt_i18n_internal = require("gt-i18n/internal");
-let gt_react = require("gt-react");
-//#region src/functions/parseLocale.ts
-const determineLocale = (0, _tanstack_react_start.createIsomorphicFn)().server(determineLocaleServer).client(determineLocaleClient);
-/**
-* Resolve the user's locale for the current TanStack Start request or browser.
-*/
-function parseLocale() {
-	const i18nConfig = (0, _generaltranslation_react_core_pure.getI18nConfig)();
-	return determineLocale({
-		defaultLocale: i18nConfig.getDefaultLocale(),
-		locales: i18nConfig.getLocales(),
-		customMapping: i18nConfig.getCustomMapping()
-	});
-}
-function determineLocaleServer({ defaultLocale, locales, customMapping }) {
-	const i18nConfig = (0, _generaltranslation_react_core_pure.getI18nConfig)();
-	const localeCookieName = i18nConfig.getLocaleCookieName();
-	const candidates = [];
-	const cookie = (0, _tanstack_react_start_server.getCookie)(localeCookieName);
-	if (cookie) candidates.push(cookie);
-	candidates.push(...(0, gt_i18n_internal.parseAcceptLanguage)((0, _tanstack_react_start_server.getRequestHeader)("accept-language")));
-	if (candidates.length === 0) console.warn("gt-tanstack-start(server): no locales could be determined for this request");
-	const locale = i18nConfig.resolveSupportedLocale(candidates, {
-		defaultLocale,
-		locales,
-		customMapping
-	});
-	(0, _tanstack_react_start_server.setCookie)(localeCookieName, locale, {
-		path: "/",
-		sameSite: "lax",
-		maxAge: 3600 * 24 * 365
-	});
-	return locale;
-}
-function determineLocaleClient({ defaultLocale, locales, customMapping }) {
-	const i18nConfig = (0, _generaltranslation_react_core_pure.getI18nConfig)();
-	const localeCookieName = i18nConfig.getLocaleCookieName();
-	const candidates = [];
-	const cookie = (0, gt_i18n_internal.getCookieValue)(document.cookie, localeCookieName);
-	if (cookie) candidates.push(cookie);
-	if (candidates.length === 0) console.warn("gt-tanstack-start(client): no locales could be determined for this request");
-	return i18nConfig.resolveSupportedLocale(candidates, {
-		defaultLocale,
-		locales,
-		customMapping
-	});
-}
-//#endregion
-Object.defineProperty(exports, "Branch", {
-	enumerable: true,
-	get: function() {
-		return gt_react.Branch;
-	}
-});
-Object.defineProperty(exports, "Currency", {
-	enumerable: true,
-	get: function() {
-		return gt_react.Currency;
-	}
-});
-Object.defineProperty(exports, "DateTime", {
-	enumerable: true,
-	get: function() {
-		return gt_react.DateTime;
-	}
-});
-Object.defineProperty(exports, "Derive", {
-	enumerable: true,
-	get: function() {
-		return gt_react.Derive;
-	}
-});
-Object.defineProperty(exports, "GTProvider", {
-	enumerable: true,
-	get: function() {
-		return gt_react.GTProvider;
-	}
-});
-Object.defineProperty(exports, "LocaleSelector", {
-	enumerable: true,
-	get: function() {
-		return gt_react.LocaleSelector;
-	}
-});
-Object.defineProperty(exports, "Num", {
-	enumerable: true,
-	get: function() {
-		return gt_react.Num;
-	}
-});
-Object.defineProperty(exports, "Plural", {
-	enumerable: true,
-	get: function() {
-		return gt_react.Plural;
-	}
-});
-Object.defineProperty(exports, "RelativeTime", {
-	enumerable: true,
-	get: function() {
-		return gt_react.RelativeTime;
-	}
-});
-Object.defineProperty(exports, "T", {
-	enumerable: true,
-	get: function() {
-		return gt_react.T;
-	}
-});
-Object.defineProperty(exports, "Var", {
-	enumerable: true,
-	get: function() {
-		return gt_react.Var;
-	}
-});
-Object.defineProperty(exports, "declareVar", {
-	enumerable: true,
-	get: function() {
-		return gt_react.declareVar;
-	}
-});
-Object.defineProperty(exports, "decodeMsg", {
-	enumerable: true,
-	get: function() {
-		return gt_react.decodeMsg;
-	}
-});
-Object.defineProperty(exports, "decodeOptions", {
-	enumerable: true,
-	get: function() {
-		return gt_react.decodeOptions;
-	}
-});
-Object.defineProperty(exports, "decodeVars", {
-	enumerable: true,
-	get: function() {
-		return gt_react.decodeVars;
-	}
-});
-Object.defineProperty(exports, "derive", {
-	enumerable: true,
-	get: function() {
-		return gt_react.derive;
-	}
-});
-Object.defineProperty(exports, "getTranslationsSnapshot", {
-	enumerable: true,
-	get: function() {
-		return gt_react.getTranslationsSnapshot;
-	}
-});
-Object.defineProperty(exports, "gtFallback", {
-	enumerable: true,
-	get: function() {
-		return gt_react.gtFallback;
-	}
-});
-Object.defineProperty(exports, "initializeGT", {
-	enumerable: true,
-	get: function() {
-		return gt_react.initializeGT;
-	}
-});
-Object.defineProperty(exports, "mFallback", {
-	enumerable: true,
-	get: function() {
-		return gt_react.mFallback;
-	}
-});
-Object.defineProperty(exports, "msg", {
-	enumerable: true,
-	get: function() {
-		return gt_react.msg;
-	}
-});
-exports.parseLocale = parseLocale;
-Object.defineProperty(exports, "t", {
-	enumerable: true,
-	get: function() {
-		return gt_react.t;
-	}
-});
-Object.defineProperty(exports, "useCustomMapping", {
-	enumerable: true,
-	get: function() {
-		return gt_react.useCustomMapping;
-	}
-});
-Object.defineProperty(exports, "useDefaultLocale", {
-	enumerable: true,
-	get: function() {
-		return gt_react.useDefaultLocale;
-	}
-});
-Object.defineProperty(exports, "useEnableI18n", {
-	enumerable: true,
-	get: function() {
-		return gt_react.useEnableI18n;
-	}
-});
-Object.defineProperty(exports, "useFormatLocales", {
-	enumerable: true,
-	get: function() {
-		return gt_react.useFormatLocales;
-	}
-});
-Object.defineProperty(exports, "useGT", {
-	enumerable: true,
-	get: function() {
-		return gt_react.useGT;
-	}
-});
-Object.defineProperty(exports, "useLocale", {
-	enumerable: true,
-	get: function() {
-		return gt_react.useLocale;
-	}
-});
-Object.defineProperty(exports, "useLocaleSelector", {
-	enumerable: true,
-	get: function() {
-		return gt_react.useLocaleSelector;
-	}
-});
-Object.defineProperty(exports, "useLocales", {
-	enumerable: true,
-	get: function() {
-		return gt_react.useLocales;
-	}
-});
-Object.defineProperty(exports, "useMessages", {
-	enumerable: true,
-	get: function() {
-		return gt_react.useMessages;
-	}
-});
-Object.defineProperty(exports, "useSetEnableI18n", {
-	enumerable: true,
-	get: function() {
-		return gt_react.useSetEnableI18n;
-	}
-});
-Object.defineProperty(exports, "useSetLocale", {
-	enumerable: true,
-	get: function() {
-		return gt_react.useSetLocale;
-	}
-});
-Object.defineProperty(exports, "useTranslations", {
-	enumerable: true,
-	get: function() {
-		return gt_react.useTranslations;
-	}
-});
-
-//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../src/functions/parseLocale.ts"],"sourcesContent":["import { createIsomorphicFn } from '@tanstack/react-start';\nimport {\n  getRequestHeader,\n  getCookie,\n  setCookie,\n} from '@tanstack/react-start/server';\nimport { getI18nConfig } from '@generaltranslation/react-core/pure';\nimport { getCookieValue, parseAcceptLanguage } from 'gt-i18n/internal';\nimport type { LocaleResolverConfig } from 'gt-i18n/internal/types';\n\nexport const determineLocale = createIsomorphicFn()\n  .server(determineLocaleServer)\n  .client(determineLocaleClient);\n\n/**\n * Resolve the user's locale for the current TanStack Start request or browser.\n */\nexport function parseLocale(): string {\n  const i18nConfig = getI18nConfig();\n  return determineLocale({\n    defaultLocale: i18nConfig.getDefaultLocale(),\n    locales: i18nConfig.getLocales(),\n    customMapping: i18nConfig.getCustomMapping(),\n  });\n}\n\nfunction determineLocaleServer({\n  defaultLocale,\n  locales,\n  customMapping,\n}: LocaleResolverConfig) {\n  const i18nConfig = getI18nConfig();\n  const localeCookieName = i18nConfig.getLocaleCookieName();\n  const candidates: string[] = [];\n\n  const cookie = getCookie(localeCookieName);\n  if (cookie) candidates.push(cookie);\n\n  candidates.push(...parseAcceptLanguage(getRequestHeader('accept-language')));\n\n  if (candidates.length === 0) {\n    console.warn(\n      'gt-tanstack-start(server): no locales could be determined for this request'\n    );\n  }\n\n  const locale = i18nConfig.resolveSupportedLocale(candidates, {\n    defaultLocale,\n    locales,\n    customMapping,\n  });\n\n  setCookie(localeCookieName, locale, {\n    path: '/',\n    sameSite: 'lax',\n    maxAge: 60 * 60 * 24 * 365,\n  });\n\n  return locale;\n}\n\nfunction determineLocaleClient({\n  defaultLocale,\n  locales,\n  customMapping,\n}: LocaleResolverConfig) {\n  const i18nConfig = getI18nConfig();\n  const localeCookieName = i18nConfig.getLocaleCookieName();\n  const candidates: string[] = [];\n\n  const cookie = getCookieValue(document.cookie, localeCookieName);\n  if (cookie) candidates.push(cookie);\n\n  if (candidates.length === 0) {\n    console.warn(\n      'gt-tanstack-start(client): no locales could be determined for this request'\n    );\n  }\n\n  return i18nConfig.resolveSupportedLocale(candidates, {\n    defaultLocale,\n    locales,\n    customMapping,\n  });\n}\n"],"mappings":";;;;;;;AAUA,MAAa,mBAAA,GAAA,sBAAA,qBAAsC,CAChD,OAAO,sBAAsB,CAC7B,OAAO,sBAAsB;;;;AAKhC,SAAgB,cAAsB;CACpC,MAAM,cAAA,GAAA,oCAAA,gBAA4B;AAClC,QAAO,gBAAgB;EACrB,eAAe,WAAW,kBAAkB;EAC5C,SAAS,WAAW,YAAY;EAChC,eAAe,WAAW,kBAAkB;EAC7C,CAAC;;AAGJ,SAAS,sBAAsB,EAC7B,eACA,SACA,iBACuB;CACvB,MAAM,cAAA,GAAA,oCAAA,gBAA4B;CAClC,MAAM,mBAAmB,WAAW,qBAAqB;CACzD,MAAM,aAAuB,EAAE;CAE/B,MAAM,UAAA,GAAA,6BAAA,WAAmB,iBAAiB;AAC1C,KAAI,OAAQ,YAAW,KAAK,OAAO;AAEnC,YAAW,KAAK,IAAA,GAAA,iBAAA,sBAAA,GAAA,6BAAA,kBAAwC,kBAAkB,CAAC,CAAC;AAE5E,KAAI,WAAW,WAAW,EACxB,SAAQ,KACN,6EACD;CAGH,MAAM,SAAS,WAAW,uBAAuB,YAAY;EAC3D;EACA;EACA;EACD,CAAC;AAEF,EAAA,GAAA,6BAAA,WAAU,kBAAkB,QAAQ;EAClC,MAAM;EACN,UAAU;EACV,QAAQ,OAAU,KAAK;EACxB,CAAC;AAEF,QAAO;;AAGT,SAAS,sBAAsB,EAC7B,eACA,SACA,iBACuB;CACvB,MAAM,cAAA,GAAA,oCAAA,gBAA4B;CAClC,MAAM,mBAAmB,WAAW,qBAAqB;CACzD,MAAM,aAAuB,EAAE;CAE/B,MAAM,UAAA,GAAA,iBAAA,gBAAwB,SAAS,QAAQ,iBAAiB;AAChE,KAAI,OAAQ,YAAW,KAAK,OAAO;AAEnC,KAAI,WAAW,WAAW,EACxB,SAAQ,KACN,6EACD;AAGH,QAAO,WAAW,uBAAuB,YAAY;EACnD;EACA;EACA;EACD,CAAC"}

package/dist/index.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/functions/parseLocale.ts"],"mappings":";;;;;;iBAiBgB,WAAA,CAAA"}

package/dist/index.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/functions/parseLocale.ts"],"mappings":";;;;;iBAiBgB,WAAA,CAAA"}

package/dist/index.mjs

@@ -1,55 +0,0 @@
-import { createIsomorphicFn } from "@tanstack/react-start";
-import { getCookie, getRequestHeader, setCookie } from "@tanstack/react-start/server";
-import { getI18nConfig } from "@generaltranslation/react-core/pure";
-import { getCookieValue, parseAcceptLanguage } from "gt-i18n/internal";
-import { Branch, Currency, DateTime, Derive, GTProvider, LocaleSelector, Num, Plural, RelativeTime, T, Var, declareVar, decodeMsg, decodeOptions, decodeVars, derive, getTranslationsSnapshot, gtFallback, initializeGT, mFallback, msg, t, useCustomMapping, useDefaultLocale, useEnableI18n, useFormatLocales, useGT, useLocale, useLocaleSelector, useLocales, useMessages, useSetEnableI18n, useSetLocale, useTranslations } from "gt-react";
-//#region src/functions/parseLocale.ts
-const determineLocale = createIsomorphicFn().server(determineLocaleServer).client(determineLocaleClient);
-/**
-* Resolve the user's locale for the current TanStack Start request or browser.
-*/
-function parseLocale() {
-	const i18nConfig = getI18nConfig();
-	return determineLocale({
-		defaultLocale: i18nConfig.getDefaultLocale(),
-		locales: i18nConfig.getLocales(),
-		customMapping: i18nConfig.getCustomMapping()
-	});
-}
-function determineLocaleServer({ defaultLocale, locales, customMapping }) {
-	const i18nConfig = getI18nConfig();
-	const localeCookieName = i18nConfig.getLocaleCookieName();
-	const candidates = [];
-	const cookie = getCookie(localeCookieName);
-	if (cookie) candidates.push(cookie);
-	candidates.push(...parseAcceptLanguage(getRequestHeader("accept-language")));
-	if (candidates.length === 0) console.warn("gt-tanstack-start(server): no locales could be determined for this request");
-	const locale = i18nConfig.resolveSupportedLocale(candidates, {
-		defaultLocale,
-		locales,
-		customMapping
-	});
-	setCookie(localeCookieName, locale, {
-		path: "/",
-		sameSite: "lax",
-		maxAge: 3600 * 24 * 365
-	});
-	return locale;
-}
-function determineLocaleClient({ defaultLocale, locales, customMapping }) {
-	const i18nConfig = getI18nConfig();
-	const localeCookieName = i18nConfig.getLocaleCookieName();
-	const candidates = [];
-	const cookie = getCookieValue(document.cookie, localeCookieName);
-	if (cookie) candidates.push(cookie);
-	if (candidates.length === 0) console.warn("gt-tanstack-start(client): no locales could be determined for this request");
-	return i18nConfig.resolveSupportedLocale(candidates, {
-		defaultLocale,
-		locales,
-		customMapping
-	});
-}
-//#endregion
-export { Branch, Currency, DateTime, Derive, GTProvider, LocaleSelector, Num, Plural, RelativeTime, T, Var, declareVar, decodeMsg, decodeOptions, decodeVars, derive, getTranslationsSnapshot, gtFallback, initializeGT, mFallback, msg, parseLocale, t, useCustomMapping, useDefaultLocale, useEnableI18n, useFormatLocales, useGT, useLocale, useLocaleSelector, useLocales, useMessages, useSetEnableI18n, useSetLocale, useTranslations };
-
-//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/functions/parseLocale.ts"],"sourcesContent":["import { createIsomorphicFn } from '@tanstack/react-start';\nimport {\n  getRequestHeader,\n  getCookie,\n  setCookie,\n} from '@tanstack/react-start/server';\nimport { getI18nConfig } from '@generaltranslation/react-core/pure';\nimport { getCookieValue, parseAcceptLanguage } from 'gt-i18n/internal';\nimport type { LocaleResolverConfig } from 'gt-i18n/internal/types';\n\nexport const determineLocale = createIsomorphicFn()\n  .server(determineLocaleServer)\n  .client(determineLocaleClient);\n\n/**\n * Resolve the user's locale for the current TanStack Start request or browser.\n */\nexport function parseLocale(): string {\n  const i18nConfig = getI18nConfig();\n  return determineLocale({\n    defaultLocale: i18nConfig.getDefaultLocale(),\n    locales: i18nConfig.getLocales(),\n    customMapping: i18nConfig.getCustomMapping(),\n  });\n}\n\nfunction determineLocaleServer({\n  defaultLocale,\n  locales,\n  customMapping,\n}: LocaleResolverConfig) {\n  const i18nConfig = getI18nConfig();\n  const localeCookieName = i18nConfig.getLocaleCookieName();\n  const candidates: string[] = [];\n\n  const cookie = getCookie(localeCookieName);\n  if (cookie) candidates.push(cookie);\n\n  candidates.push(...parseAcceptLanguage(getRequestHeader('accept-language')));\n\n  if (candidates.length === 0) {\n    console.warn(\n      'gt-tanstack-start(server): no locales could be determined for this request'\n    );\n  }\n\n  const locale = i18nConfig.resolveSupportedLocale(candidates, {\n    defaultLocale,\n    locales,\n    customMapping,\n  });\n\n  setCookie(localeCookieName, locale, {\n    path: '/',\n    sameSite: 'lax',\n    maxAge: 60 * 60 * 24 * 365,\n  });\n\n  return locale;\n}\n\nfunction determineLocaleClient({\n  defaultLocale,\n  locales,\n  customMapping,\n}: LocaleResolverConfig) {\n  const i18nConfig = getI18nConfig();\n  const localeCookieName = i18nConfig.getLocaleCookieName();\n  const candidates: string[] = [];\n\n  const cookie = getCookieValue(document.cookie, localeCookieName);\n  if (cookie) candidates.push(cookie);\n\n  if (candidates.length === 0) {\n    console.warn(\n      'gt-tanstack-start(client): no locales could be determined for this request'\n    );\n  }\n\n  return i18nConfig.resolveSupportedLocale(candidates, {\n    defaultLocale,\n    locales,\n    customMapping,\n  });\n}\n"],"mappings":";;;;;;AAUA,MAAa,kBAAkB,oBAAoB,CAChD,OAAO,sBAAsB,CAC7B,OAAO,sBAAsB;;;;AAKhC,SAAgB,cAAsB;CACpC,MAAM,aAAa,eAAe;AAClC,QAAO,gBAAgB;EACrB,eAAe,WAAW,kBAAkB;EAC5C,SAAS,WAAW,YAAY;EAChC,eAAe,WAAW,kBAAkB;EAC7C,CAAC;;AAGJ,SAAS,sBAAsB,EAC7B,eACA,SACA,iBACuB;CACvB,MAAM,aAAa,eAAe;CAClC,MAAM,mBAAmB,WAAW,qBAAqB;CACzD,MAAM,aAAuB,EAAE;CAE/B,MAAM,SAAS,UAAU,iBAAiB;AAC1C,KAAI,OAAQ,YAAW,KAAK,OAAO;AAEnC,YAAW,KAAK,GAAG,oBAAoB,iBAAiB,kBAAkB,CAAC,CAAC;AAE5E,KAAI,WAAW,WAAW,EACxB,SAAQ,KACN,6EACD;CAGH,MAAM,SAAS,WAAW,uBAAuB,YAAY;EAC3D;EACA;EACA;EACD,CAAC;AAEF,WAAU,kBAAkB,QAAQ;EAClC,MAAM;EACN,UAAU;EACV,QAAQ,OAAU,KAAK;EACxB,CAAC;AAEF,QAAO;;AAGT,SAAS,sBAAsB,EAC7B,eACA,SACA,iBACuB;CACvB,MAAM,aAAa,eAAe;CAClC,MAAM,mBAAmB,WAAW,qBAAqB;CACzD,MAAM,aAAuB,EAAE;CAE/B,MAAM,SAAS,eAAe,SAAS,QAAQ,iBAAiB;AAChE,KAAI,OAAQ,YAAW,KAAK,OAAO;AAEnC,KAAI,WAAW,WAAW,EACxB,SAAQ,KACN,6EACD;AAGH,QAAO,WAAW,uBAAuB,YAAY;EACnD;EACA;EACA;EACD,CAAC"}