gt-react 11.0.0-odysseus.9 → 11.0.0

package/CHANGELOG.md

@@ -1,5 +1,197 @@
 # gt-react
 
+## 11.0.0
+
+### Major Changes
+
+- [#1816](https://github.com/generaltranslation/gt/pull/1816) [`463a8db`](https://github.com/generaltranslation/gt/commit/463a8dbb03bde35f2f229dfdabfe117197d4527b) Thanks [@bgub](https://github.com/bgub)! - Add a config-aware `resolveCanonicalLocale` helper and remove the public `getGTClass` helper.
+
+- [#1439](https://github.com/generaltranslation/gt/pull/1439) [`e12fb17`](https://github.com/generaltranslation/gt/commit/e12fb17d41cfa5fa231e64fe70423434739ea985) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - Prepare Odysseus major releases for core runtime packages.
+
+- [#1816](https://github.com/generaltranslation/gt/pull/1816) [`463a8db`](https://github.com/generaltranslation/gt/commit/463a8dbb03bde35f2f229dfdabfe117197d4527b) Thanks [@bgub](https://github.com/bgub)! - Remove the deprecated `useGTClass` hook from public entry points.
+
+- [#1821](https://github.com/generaltranslation/gt/pull/1821) [`40db0c5`](https://github.com/generaltranslation/gt/commit/40db0c54a58e82d693d8a16d19fe5071baabecdc) Thanks [@bgub](https://github.com/bgub)! - Remove `useVersionId` from public package entrypoints.
+
+  The `getVersionId` helper remains available from public function entrypoints and `gt-i18n/internal`.
+
+- [#1439](https://github.com/generaltranslation/gt/pull/1439) [`8a2f7ee`](https://github.com/generaltranslation/gt/commit/8a2f7ee79f4b890fb1aaf47f42bb844334899793) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - Simplify translation option types. Replace deprecated inline and dictionary option aliases with `GTTranslationOptions`, use interpolation variables for dictionary `t()` options, and trim higher-level type exports to avoid exposing internal translation option fields.
+
+### Patch Changes
+
+- [#1439](https://github.com/generaltranslation/gt/pull/1439) [`37e0080`](https://github.com/generaltranslation/gt/commit/37e0080b2c072840cf6c0f1c66a8f0f3a54e17e5) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - Add default form and accessibility labels to LocaleSelector.
+
+- [#1439](https://github.com/generaltranslation/gt/pull/1439) [`5bfd0a7`](https://github.com/generaltranslation/gt/commit/5bfd0a73e286bf76ae26f9178171aeca1c53ecc5) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - Preserve browser locale cookie updates when changing locales.
+
+- [#1439](https://github.com/generaltranslation/gt/pull/1439) [`7a9dbe3`](https://github.com/generaltranslation/gt/commit/7a9dbe3c188787a39ee1de78f54c92dff470b502) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - Clean up stale package metadata and align TanStack Start package entry points.
+
+- [#1815](https://github.com/generaltranslation/gt/pull/1815) [`1212135`](https://github.com/generaltranslation/gt/commit/1212135e4e09ed754756cac2805bc3a139408dc1) Thanks [@bgub](https://github.com/bgub)! - Clean up the `@generaltranslation/react-core` public API surface.
+  - `@generaltranslation/react-core`: Removed dead dictionary helper exports and source files, stopped exporting JSX serialization internals from `/pure`, dropped internal singleton/plumbing exports from `/pure`, removed `useShouldTranslate` from `/hooks`, and kept only `internalInitializeGTSRA` for the server-rendered initializer.
+  - `gt-react`: Aliases `internalInitializeGTSRA` locally from the RSC entrypoint so the public `initializeGT` export remains unchanged.
+  - `gt-next`: Replaced imports of removed react-core legacy types with equivalent local types.
+
+- [#1439](https://github.com/generaltranslation/gt/pull/1439) [`bd52e5e`](https://github.com/generaltranslation/gt/commit/bd52e5ef3fb38a63d9bac8a4af08ff93402c0749) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - Allow client i18n cache expiry to default to no expiry while preserving explicit cache expiry configuration.
+
+- [#1439](https://github.com/generaltranslation/gt/pull/1439) [`8d2e84e`](https://github.com/generaltranslation/gt/commit/8d2e84e5083bb740815004bec90eaa341be7aff5) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - Preserve enableI18n hydration state from server props and request cookies.
+
+- [#1439](https://github.com/generaltranslation/gt/pull/1439) [`04b5064`](https://github.com/generaltranslation/gt/commit/04b50645675abb9e927a82056b249b50f0907fcc) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - Restore namespace scoping for getTranslations and server useTranslations.
+
+- [#1439](https://github.com/generaltranslation/gt/pull/1439) [`4335432`](https://github.com/generaltranslation/gt/commit/43354326beb16e13784b0c82faad447768bb8404) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - Use the shared runtime environment helper for browser cache dev-mode checks so `gt-react` typechecks without Vite ambient types.
+
+- [#1828](https://github.com/generaltranslation/gt/pull/1828) [`04c285c`](https://github.com/generaltranslation/gt/commit/04c285c7b44f5404918cd4c80336dddf412472e9) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - Fix shipped types for the initializeGT export.
+
+- [#1439](https://github.com/generaltranslation/gt/pull/1439) [`947fe0c`](https://github.com/generaltranslation/gt/commit/947fe0c97a2821a0980cd3e779252ea0078e80f8) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - Fix `useVersionId()` throwing and `useLocaleDirection()` requiring a locale argument in the client and server entrypoints.
+
+  `useVersionId()` now returns the current version id (instead of throwing the react-core "not implemented" error), and `useLocaleDirection()` once again accepts an optional locale that defaults to the current locale. The shared implementation now lives in `@generaltranslation/react-core/hooks`, so `gt-react` and `gt-react-native` use the same behavior; the RSC entrypoint keeps its stricter signatures.
+
+- [#1439](https://github.com/generaltranslation/gt/pull/1439) [`e026c42`](https://github.com/generaltranslation/gt/commit/e026c42bc137e9865b548daee7238e6a458a5662) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - Add default form and accessibility labels to RegionSelector.
+
+- [#1820](https://github.com/generaltranslation/gt/pull/1820) [`1f53e42`](https://github.com/generaltranslation/gt/commit/1f53e420e9a6475f85cf27e1cd0c9c89f4beeb36) Thanks [@bgub](https://github.com/bgub)! - Clean up the `gt-i18n` public API surface by removing dead subpaths, internal exports, and unused types.
+
+- [#1439](https://github.com/generaltranslation/gt/pull/1439) [`b3bb391`](https://github.com/generaltranslation/gt/commit/b3bb391d33041680e2d62b6a7c9b05662946544f) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - Store cookie names in I18nConfig so custom cookie names work before the condition store is initialized.
+  - `gt-i18n`: Removed the unused React locale cookie name from the shared GT config type.
+  - `@generaltranslation/react-core`: `ReactI18nConfig` now accepts `localeCookieName`, `regionCookieName`, and `enableI18nCookieName`, exposes getters that fall back to the default names, and exports the default storage names from the `pure` entrypoint.
+  - `gt-next`: Imports default cookie names from the React Core `pure` entrypoint instead of the removed React Core cookie constants subpath.
+  - `gt-react`: The browser condition store now resolves cookie names from `I18nConfig` instead of hardcoding the defaults, so custom cookie names passed to `initializeGT()` are honored for both reads and writes.
+  - `gt-react-native`: Native condition storage now resolves its store keys from `I18nConfig`, matching `gt-react` behavior.
+  - `gt-tanstack-start`: `parseLocale()` reads and writes the locale cookie using the configured cookie name instead of the default.
+
+- [#1439](https://github.com/generaltranslation/gt/pull/1439) [`d48604e`](https://github.com/generaltranslation/gt/commit/d48604e2171aa84c76873cacb6eb8d43c2f17546) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - Trigger an odysseus prerelease patch for all publishable packages.
+
+- [#1817](https://github.com/generaltranslation/gt/pull/1817) [`7744c55`](https://github.com/generaltranslation/gt/commit/7744c557d37c85ce3626681410cc0cd622374ecf) Thanks [@bgub](https://github.com/bgub)! - Remove RSC-only render internals from the `gt-react` react-server entry while keeping the compiler-injected internal translation exports available. The react-server declaration surface now also includes `RenderPipeline` and `RenderPreparedT`, matching the other `gt-react` entries.
+
+- [#1439](https://github.com/generaltranslation/gt/pull/1439) [`97dc7f4`](https://github.com/generaltranslation/gt/commit/97dc7f4818476a319a54b1519e994a62d5a9a3a5) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - Remove default exports from package entrypoints and internal source modules.
+
+  Use named imports for affected public entrypoints, including `import { plugin } from 'gt-react-native/plugin'`. The `gt-next/link` entrypoint keeps its default export to match `next/link`.
+
+- [#1439](https://github.com/generaltranslation/gt/pull/1439) [`85a0c19`](https://github.com/generaltranslation/gt/commit/85a0c1998a6500233affd8c1987551170584c782) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - Remove the deprecated `internalInitializeGTSPA` export from `@generaltranslation/react-core/pure` and the downstream `gt-react` server/types surfaces. Use `initializeGTSPA` from `gt-react` for browser SPA initialization.
+
+- [#1439](https://github.com/generaltranslation/gt/pull/1439) [`c5364f9`](https://github.com/generaltranslation/gt/commit/c5364f977ffb4b387ad39206e6ed626bbeec56f3) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - Slim the i18n cache event surface by replacing the generic EventEmitter base class with a single cache-miss listener and removing unused cache helper methods.
+
+- [#1439](https://github.com/generaltranslation/gt/pull/1439) [`2c46baf`](https://github.com/generaltranslation/gt/commit/2c46baf137400613495e3fe2865865b5506edece) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - Persist TanStack Start locale resolution through the browser locale cookie.
+  Allow React i18n config checks to work across bundled react-core entrypoints.
+
+- [#1439](https://github.com/generaltranslation/gt/pull/1439) [`2ca78ec`](https://github.com/generaltranslation/gt/commit/2ca78ec4805639c10c7b200c8dee660b55eddf15) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - Read Vite runtime credentials during React initialization while keeping dev API keys out of production bundles.
+
+- [#1439](https://github.com/generaltranslation/gt/pull/1439) [`195f009`](https://github.com/generaltranslation/gt/commit/195f00910c2a675a6f9da327e19e3d3c5e44e26b) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - fix: make singleton not-initialized errors consistent and descriptive, and stop error paths from masking the original failure when I18nConfig is also uninitialized
+
+- Updated dependencies [[`463a8db`](https://github.com/generaltranslation/gt/commit/463a8dbb03bde35f2f229dfdabfe117197d4527b), [`37e0080`](https://github.com/generaltranslation/gt/commit/37e0080b2c072840cf6c0f1c66a8f0f3a54e17e5), [`8870496`](https://github.com/generaltranslation/gt/commit/88704963eb74e81401994681ce7cdae3ba91b6c0), [`1212135`](https://github.com/generaltranslation/gt/commit/1212135e4e09ed754756cac2805bc3a139408dc1), [`04f419d`](https://github.com/generaltranslation/gt/commit/04f419d65e69db3eb4adb8ee6299c0ddee153135), [`b72c30b`](https://github.com/generaltranslation/gt/commit/b72c30bc603562310a51b656fb003f1486315a8a), [`72e9e16`](https://github.com/generaltranslation/gt/commit/72e9e1643797be8e4ae1453897fd0b023fce2674), [`42a440f`](https://github.com/generaltranslation/gt/commit/42a440ff3420bdbdb35ed24f9a5af1c9040eaf66), [`fd22c68`](https://github.com/generaltranslation/gt/commit/fd22c68978af50ce519dc06c7b887d3fa67181ae), [`bea8233`](https://github.com/generaltranslation/gt/commit/bea8233d8b055980483cb2e226157f6adcbd8c2b), [`8870496`](https://github.com/generaltranslation/gt/commit/88704963eb74e81401994681ce7cdae3ba91b6c0), [`5736d58`](https://github.com/generaltranslation/gt/commit/5736d585b8285ef56cc6f412799308969ac786c0), [`04b5064`](https://github.com/generaltranslation/gt/commit/04b50645675abb9e927a82056b249b50f0907fcc), [`947fe0c`](https://github.com/generaltranslation/gt/commit/947fe0c97a2821a0980cd3e779252ea0078e80f8), [`5adeede`](https://github.com/generaltranslation/gt/commit/5adeede157922d547a33a078d0f527f572c9a8b4), [`328795b`](https://github.com/generaltranslation/gt/commit/328795bf730296658a57b7132bbd1e0bbff2fd62), [`1f53e42`](https://github.com/generaltranslation/gt/commit/1f53e420e9a6475f85cf27e1cd0c9c89f4beeb36), [`b3bb391`](https://github.com/generaltranslation/gt/commit/b3bb391d33041680e2d62b6a7c9b05662946544f), [`d48604e`](https://github.com/generaltranslation/gt/commit/d48604e2171aa84c76873cacb6eb8d43c2f17546), [`88f3a2e`](https://github.com/generaltranslation/gt/commit/88f3a2e0f304fdd19891afac0b41954edc9497c6), [`e12fb17`](https://github.com/generaltranslation/gt/commit/e12fb17d41cfa5fa231e64fe70423434739ea985), [`44bc998`](https://github.com/generaltranslation/gt/commit/44bc998abf813ea4a96ade6c2632e1143034bd45), [`5752fe8`](https://github.com/generaltranslation/gt/commit/5752fe81bf5b5deaae878638e0de99959bf719be), [`b7d44dc`](https://github.com/generaltranslation/gt/commit/b7d44dc2d79ac3332a0ed55da0ba130b6896f756), [`9561761`](https://github.com/generaltranslation/gt/commit/9561761c3ab72a5e39327415b3274eccc63f4ffe), [`72c6a85`](https://github.com/generaltranslation/gt/commit/72c6a85cc3ca025ebdeb006dbdd865e935ec77ae), [`3d95277`](https://github.com/generaltranslation/gt/commit/3d95277a057b28fffc73b3fa616210bdcb447e85), [`97dc7f4`](https://github.com/generaltranslation/gt/commit/97dc7f4818476a319a54b1519e994a62d5a9a3a5), [`c1e0a0f`](https://github.com/generaltranslation/gt/commit/c1e0a0f837da440eeed84af10b553dee24bfc936), [`85a0c19`](https://github.com/generaltranslation/gt/commit/85a0c1998a6500233affd8c1987551170584c782), [`693288d`](https://github.com/generaltranslation/gt/commit/693288d632c42b923920a2fdd9ae2babc1bc28f5), [`463a8db`](https://github.com/generaltranslation/gt/commit/463a8dbb03bde35f2f229dfdabfe117197d4527b), [`e343775`](https://github.com/generaltranslation/gt/commit/e343775d8a41ce3eea03dd319b90497a9744cc4f), [`40db0c5`](https://github.com/generaltranslation/gt/commit/40db0c54a58e82d693d8a16d19fe5071baabecdc), [`8a2f7ee`](https://github.com/generaltranslation/gt/commit/8a2f7ee79f4b890fb1aaf47f42bb844334899793), [`c5364f9`](https://github.com/generaltranslation/gt/commit/c5364f977ffb4b387ad39206e6ed626bbeec56f3), [`2e85ebd`](https://github.com/generaltranslation/gt/commit/2e85ebd1528a4f99a8e36e1d8d6714a639040596), [`2c46baf`](https://github.com/generaltranslation/gt/commit/2c46baf137400613495e3fe2865865b5506edece), [`d5cf2d3`](https://github.com/generaltranslation/gt/commit/d5cf2d34f412ad49e8b2818fe788b870a5964d65), [`9e78cf0`](https://github.com/generaltranslation/gt/commit/9e78cf07db58bfe6063bcd0b217553176c9681bd), [`4986567`](https://github.com/generaltranslation/gt/commit/498656728741898a56ae348a536107bd92f95c04), [`795edc8`](https://github.com/generaltranslation/gt/commit/795edc8a2b3e91fc9801d726f4b5cd6fbbc98fb0), [`d863bcf`](https://github.com/generaltranslation/gt/commit/d863bcf05770c336c98b2b2fae8534c90f00df51), [`11ecf87`](https://github.com/generaltranslation/gt/commit/11ecf876a1221b9dbce9fc0c0f0804101558c8a7), [`03bae6d`](https://github.com/generaltranslation/gt/commit/03bae6d3b4791107781cb800c1ae7ac4f675705c), [`5d42608`](https://github.com/generaltranslation/gt/commit/5d426089f04f37dd7369620e9db3e6512f06eee8), [`9804aa4`](https://github.com/generaltranslation/gt/commit/9804aa460c07ec36d2e667d79a839720a1e011e8), [`338e5e8`](https://github.com/generaltranslation/gt/commit/338e5e8a42354c7d288d9be960ebd1d58adfd402), [`8834c51`](https://github.com/generaltranslation/gt/commit/8834c518ac84259706f2b603fd024ad13a9072ee), [`2ca78ec`](https://github.com/generaltranslation/gt/commit/2ca78ec4805639c10c7b200c8dee660b55eddf15), [`195f009`](https://github.com/generaltranslation/gt/commit/195f00910c2a675a6f9da327e19e3d3c5e44e26b)]:
+  - gt-i18n@1.0.0
+  - @generaltranslation/react-core@11.0.0
+  - generaltranslation@9.0.0
+  - @generaltranslation/format@0.1.2
+  - @generaltranslation/supported-locales@2.1.2
+
+## 11.0.0-odysseus.16
+
+### Major Changes
+
+- 463a8db: Add a config-aware `resolveCanonicalLocale` helper and remove the public `getGTClass` helper.
+- 463a8db: Remove the deprecated `useGTClass` hook from public entry points.
+- 40db0c5: Remove `useVersionId` from public package entrypoints.
+
+  The `getVersionId` helper remains available from public function entrypoints and `gt-i18n/internal`.
+
+### Patch Changes
+
+- 1f53e42: Clean up the `gt-i18n` public API surface by removing dead subpaths, internal exports, and unused types.
+- 7744c55: Remove RSC-only render internals from the `gt-react` react-server entry while keeping the compiler-injected internal translation exports available. The react-server declaration surface now also includes `RenderPipeline` and `RenderPreparedT`, matching the other `gt-react` entries.
+- Updated dependencies [463a8db]
+- Updated dependencies [b72c30b]
+- Updated dependencies [bea8233]
+- Updated dependencies [5736d58]
+- Updated dependencies [1f53e42]
+- Updated dependencies [463a8db]
+- Updated dependencies [e343775]
+- Updated dependencies [40db0c5]
+- Updated dependencies [d5cf2d3]
+  - gt-i18n@1.0.0-odysseus.9
+  - @generaltranslation/react-core@11.0.0-odysseus.16
+  - generaltranslation@9.0.0-odysseus.6
+  - @generaltranslation/supported-locales@2.1.2-odysseus.6
+
+## 11.0.0-odysseus.15
+
+### Patch Changes
+
+- 8d2e84e: Preserve enableI18n hydration state from server props and request cookies.
+- c5364f9: Slim the i18n cache event surface by replacing the generic EventEmitter base class with a single cache-miss listener and removing unused cache helper methods.
+- 195f009: fix: make singleton not-initialized errors consistent and descriptive, and stop error paths from masking the original failure when I18nConfig is also uninitialized
+- Updated dependencies [04f419d]
+- Updated dependencies [72e9e16]
+- Updated dependencies [42a440f]
+- Updated dependencies [5adeede]
+- Updated dependencies [c5364f9]
+- Updated dependencies [2e85ebd]
+- Updated dependencies [195f009]
+  - @generaltranslation/react-core@11.0.0-odysseus.15
+  - generaltranslation@9.0.0-odysseus.5
+  - gt-i18n@1.0.0-odysseus.8
+  - @generaltranslation/supported-locales@2.1.2-odysseus.5
+
+## 11.0.0-odysseus.14
+
+### Patch Changes
+
+- 0cd7813: Store cookie names in I18nConfig so custom cookie names work before the condition store is initialized.
+  - `gt-i18n`: Removed the unused React locale cookie name from the shared GT config type.
+  - `@generaltranslation/react-core`: `ReactI18nConfig` now accepts `localeCookieName`, `regionCookieName`, and `enableI18nCookieName`, exposes getters that fall back to the default names, and exports the default storage names from the `pure` entrypoint.
+  - `gt-next`: Imports default cookie names from the React Core `pure` entrypoint instead of the removed React Core cookie constants subpath.
+  - `gt-react`: The browser condition store now resolves cookie names from `I18nConfig` instead of hardcoding the defaults, so custom cookie names passed to `initializeGT()` are honored for both reads and writes.
+  - `gt-react-native`: Native condition storage now resolves its store keys from `I18nConfig`, matching `gt-react` behavior.
+  - `gt-tanstack-start`: `parseLocale()` reads and writes the locale cookie using the configured cookie name instead of the default.
+
+- Updated dependencies [ab61565]
+- Updated dependencies [0cd7813]
+  - gt-i18n@1.0.0-odysseus.7
+  - @generaltranslation/react-core@11.0.0-odysseus.14
+
+## 11.0.0-odysseus.13
+
+### Patch Changes
+
+- a2b9677: Restore namespace scoping for getTranslations and server useTranslations.
+- 41371e0: Read Vite runtime credentials during React initialization while keeping dev API keys out of production bundles.
+- Updated dependencies [a2b9677]
+- Updated dependencies [41371e0]
+  - gt-i18n@1.0.0-odysseus.6
+  - @generaltranslation/react-core@11.0.0-odysseus.13
+
+## 11.0.0-odysseus.12
+
+### Patch Changes
+
+- Updated dependencies [7be23bc]
+  - @generaltranslation/react-core@11.0.0-odysseus.12
+
+## 11.0.0-odysseus.11
+
+### Patch Changes
+
+- @generaltranslation/react-core@11.0.0-odysseus.11
+
+## 11.0.0-odysseus.10
+
+### Patch Changes
+
+- 07f74f0: Clean up stale package metadata and align TanStack Start package entry points.
+- ee34fea: Use the shared runtime environment helper for browser cache dev-mode checks so `gt-react` typechecks without Vite ambient types.
+- bcba6fd: Fix `useVersionId()` throwing and `useLocaleDirection()` requiring a locale argument in the client and server entrypoints.
+
+  `useVersionId()` now returns the current version id (instead of throwing the react-core "not implemented" error), and `useLocaleDirection()` once again accepts an optional locale that defaults to the current locale. The shared implementation now lives in `@generaltranslation/react-core/hooks`, so `gt-react` and `gt-react-native` use the same behavior; the RSC entrypoint keeps its stricter signatures.
+
+- 288c9f8: Remove the deprecated `internalInitializeGTSPA` export from `@generaltranslation/react-core/pure` and the downstream `gt-react` server/types surfaces. Use `initializeGTSPA` from `gt-react` for browser SPA initialization.
+- Updated dependencies [432fa49]
+- Updated dependencies [432fa49]
+- Updated dependencies [bcba6fd]
+- Updated dependencies [933916e]
+- Updated dependencies [b7b3eaf]
+- Updated dependencies [dfb5fc9]
+- Updated dependencies [4a5f8e8]
+- Updated dependencies [288c9f8]
+- Updated dependencies [083d306]
+  - gt-i18n@1.0.0-odysseus.5
+  - @generaltranslation/react-core@11.0.0-odysseus.10
+
 ## 11.0.0-odysseus.9
 
 ### Patch Changes
@@ -154,6 +346,68 @@
 
 ### Patch Changes
 
+- Updated dependencies [[`cc4edc1`](https://github.com/generaltranslation/gt/commit/cc4edc1e40d9977125bf6d053fb7f8cdbdd40b05)]:
+  - @generaltranslation/supported-locales@2.1.0
+  - gt-i18n@0.9.4
+  - @generaltranslation/react-core@1.8.20
+
+## 10.20.5
+
+### Patch Changes
+
+- Updated dependencies [[`6945a98`](https://github.com/generaltranslation/gt/commit/6945a9871ea260dd999dcb2246c48b21134721f6)]:
+  - @generaltranslation/react-core@1.8.25
+  - generaltranslation@8.2.19
+  - gt-i18n@0.9.9
+  - @generaltranslation/supported-locales@2.1.5
+
+## 10.20.4
+
+### Patch Changes
+
+- Updated dependencies [[`a2a3dd0`](https://github.com/generaltranslation/gt/commit/a2a3dd0bcdce9abe360c406a12fc6bb3bc3ca181)]:
+  - @generaltranslation/supported-locales@2.1.4
+  - gt-i18n@0.9.8
+  - @generaltranslation/react-core@1.8.24
+
+## 10.20.3
+
+### Patch Changes
+
+- Updated dependencies [[`9709a2f`](https://github.com/generaltranslation/gt/commit/9709a2f2b97b9d8239298e39bb31e57692bbffd8)]:
+  - generaltranslation@8.2.18
+  - gt-i18n@0.9.7
+  - @generaltranslation/react-core@1.8.23
+  - @generaltranslation/supported-locales@2.1.3
+
+## 10.20.2
+
+### Patch Changes
+
+- Updated dependencies [[`3197028`](https://github.com/generaltranslation/gt/commit/319702855a7b129f95217d41be9f2402680a2f01)]:
+  - generaltranslation@8.2.17
+  - gt-i18n@0.9.6
+  - @generaltranslation/react-core@1.8.22
+  - @generaltranslation/supported-locales@2.1.2
+
+## 10.20.1
+
+## 10.20.0
+
+## 10.19.19
+
+### Patch Changes
+
+- Updated dependencies [[`e041312`](https://github.com/generaltranslation/gt/commit/e04131263dd61e469db977bcc196dc1283e773d0)]:
+  - generaltranslation@8.2.16
+  - gt-i18n@0.9.5
+  - @generaltranslation/react-core@1.8.21
+  - @generaltranslation/supported-locales@2.1.1
+
+## 10.19.18
+
+### Patch Changes
+
 - Updated dependencies [[`cc4edc1`](https://github.com/generaltranslation/gt/commit/cc4edc1e40d9977125bf6d053fb7f8cdbdd40b05)]:
   - @generaltranslation/supported-locales@2.1.0
   - gt-i18n@0.9.4

package/dist/index.client.cjs

@@ -201,7 +201,7 @@ function deleteExpiredEntries(cache, now = Date.now()) {
 	for (const key of Object.keys(cache)) if (cache[key].exp <= now) delete cache[key];
 }
 //#endregion
-//#region ../core/dist/base64-r7YWJYWt.mjs
+//#region ../core/dist/api-BOEGbEF6.mjs
 function ensureSentence(text) {
 	const trimmed = text.trim();
 	if (!trimmed) return "";
@@ -265,7 +265,7 @@ var BrowserI18nCache = class extends gt_i18n_internal.I18nCache {
 			...DEFAULT_HTML_TAG_OPTIONS,
 			...htmlTagOptions
 		};
-		if (devHotReloadEnabled) this.subscribe("translations-cache-miss", ({ locale, hash, translation }) => {
+		if (devHotReloadEnabled) this.onTranslationsCacheMiss = ({ locale, hash, translation }) => {
 			const cache = localStorageCaches[locale];
 			if (cache) cache.write(hash, translation);
 			else localStorageCaches[locale] = new LocalStorageTranslationCache({
@@ -273,7 +273,7 @@ var BrowserI18nCache = class extends gt_i18n_internal.I18nCache {
 				projectId,
 				init: { [hash]: translation }
 			});
-		});
+		};
 	}
 	/**
 	* Whether dev hot reload JSX (Suspense-based <T>) is active
@@ -287,7 +287,7 @@ var BrowserI18nCache = class extends gt_i18n_internal.I18nCache {
 	* Returns undefined if not in development mode.
 	*/
 	getLocalStorageTranslationCache(locale, init) {
-		if (!{}?.DEV) return void 0;
+		if ((0, gt_i18n_internal.getRuntimeEnvironment)() !== "development") return void 0;
 		if (!this._localStorageCaches[locale]) this._localStorageCaches[locale] = new LocalStorageTranslationCache({
 			locale,
 			projectId: this.config.projectId,
@@ -375,27 +375,6 @@ function readBrowserLocale(localeCookieName) {
 	return candidates;
 }
 //#endregion
-//#region src/cookie-names.ts
-/**
-* Cookie name for tracking the user's selected locale.
-*/
-const defaultLocaleCookieName = "generaltranslation.locale";
-/**
-* Cookie name for tracking the user's selected region.
-*/
-const defaultRegionCookieName = "generaltranslation.region";
-/**
-* Cookie name for persisting the enableI18n feature flag.
-*/
-const defaultEnableI18nCookieName = "generaltranslation.enable-i18n";
-/**
-* Cookie name for tracking the locale reset
-* Used by gt-next middleware
-*
-* TODO: remove this cookie when come up with better solution
-*/
-const defaultResetLocaleCookieName = "generaltranslation.locale-reset";
-//#endregion
 //#region src/condition-store/BrowserConditionStore.ts
 /**
 * Condition store implementation for Browser.
@@ -403,18 +382,18 @@ const defaultResetLocaleCookieName = "generaltranslation.locale-reset";
 var BrowserConditionStore = class {
 	constructor(config) {
 		this.getLocale = () => {
-			return getBrowserLocale(this.localeCookieName, this.customGetLocale);
+			return getBrowserLocale(this.customGetLocale);
 		};
 		this.setLocale = (locale) => {
 			this.updateLocale(locale);
 			setCookieValue({
-				cookieName: defaultResetLocaleCookieName,
+				cookieName: _generaltranslation_react_core_pure.defaultResetLocaleCookieName,
 				value: "true"
 			});
 			this.reload();
 		};
 		this.getRegion = () => {
-			const cookieRegion = getCookieValue({ cookieName: this.regionCookieName });
+			const cookieRegion = getCookieValue({ cookieName: (0, _generaltranslation_react_core_pure.getI18nConfig)().getRegionCookieName() });
 			if (cookieRegion) return cookieRegion;
 			return this.customGetRegion?.();
 		};
@@ -423,7 +402,7 @@ var BrowserConditionStore = class {
 			this.reload();
 		};
 		this.getEnableI18n = () => {
-			const cookieEnableI18n = getCookieValue({ cookieName: this.enableI18nCookieName });
+			const cookieEnableI18n = getCookieValue({ cookieName: (0, _generaltranslation_react_core_pure.getI18nConfig)().getEnableI18nCookieName() });
 			if (cookieEnableI18n === void 0) return this.customGetEnableI18n?.() ?? true;
 			return cookieEnableI18n === "true";
 		};
@@ -432,21 +411,21 @@ var BrowserConditionStore = class {
 			this.reload();
 		};
 		this.updateLocale = (locale) => {
-			const i18nConfig = (0, gt_i18n_internal.getI18nConfig)();
+			const i18nConfig = (0, _generaltranslation_react_core_pure.getI18nConfig)();
 			setCookieValue({
-				cookieName: this.localeCookieName,
-				value: i18nConfig.determineLocale(locale) || i18nConfig.getDefaultLocale()
+				cookieName: i18nConfig.getLocaleCookieName(),
+				value: i18nConfig.resolveSupportedLocale(locale)
 			});
 		};
 		this.updateRegion = (region) => {
 			setCookieValue({
-				cookieName: this.regionCookieName,
+				cookieName: (0, _generaltranslation_react_core_pure.getI18nConfig)().getRegionCookieName(),
 				value: region ?? ""
 			});
 		};
 		this.updateEnableI18n = (enableI18n) => {
 			setCookieValue({
-				cookieName: this.enableI18nCookieName,
+				cookieName: (0, _generaltranslation_react_core_pure.getI18nConfig)().getEnableI18nCookieName(),
 				value: enableI18n ? "true" : "false"
 			});
 		};
@@ -458,35 +437,39 @@ var BrowserConditionStore = class {
 			};
 			this.customReload(state);
 		};
+		const i18nConfig = (0, _generaltranslation_react_core_pure.getI18nConfig)();
 		this.customReload = config._reload ?? (() => typeof window !== "undefined" ? window.location.reload() : void 0);
 		this.customGetLocale = config._getLocale;
 		this.customGetRegion = config._getRegion;
 		this.customGetEnableI18n = config._getEnableI18n;
-		this.localeCookieName = config.localeCookieName ?? "generaltranslation.locale";
-		this.regionCookieName = config.regionCookieName ?? "generaltranslation.region";
-		this.enableI18nCookieName = config.enableI18nCookieName ?? "generaltranslation.enable-i18n";
-		const i18nConfig = (0, gt_i18n_internal.getI18nConfig)();
 		setCookieValue({
-			cookieName: this.localeCookieName,
-			value: i18nConfig.determineLocale(config.locale) || i18nConfig.getDefaultLocale()
+			cookieName: i18nConfig.getLocaleCookieName(),
+			value: i18nConfig.resolveSupportedLocale(config.locale)
 		});
 		if (config.region !== void 0) setCookieValue({
-			cookieName: this.regionCookieName,
+			cookieName: i18nConfig.getRegionCookieName(),
 			value: config.region
 		});
 		this.updateEnableI18n(config.enableI18n ?? true);
 	}
 };
-function getBrowserLocale(cookieName, getLocale) {
-	const candidates = readBrowserLocale(cookieName);
+function getBrowserLocale(getLocale) {
+	const i18nConfig = (0, _generaltranslation_react_core_pure.getI18nConfig)();
+	const candidates = readBrowserLocale(i18nConfig.getLocaleCookieName());
 	if (getLocale) candidates.push(getLocale());
-	const i18nConfig = (0, gt_i18n_internal.getI18nConfig)();
-	return i18nConfig.determineLocale(candidates) || i18nConfig.getDefaultLocale();
+	return i18nConfig.resolveSupportedLocale(candidates);
 }
 //#endregion
 //#region src/condition-store/singleton-operations.ts
-const { setConditionStore: setReadonlyConditionStore, isConditionStoreInitialized: isReadonlyConditionStoreInitialized } = (0, gt_i18n_internal.createConditionStoreSingleton)("ReadonlyConditionStore is not initialized.");
-const { getConditionStore: getBrowserConditionStore, setConditionStore: setBrowserConditionStore, isConditionStoreInitialized: isBrowserConditionStoreInitialized } = (0, gt_i18n_internal.createConditionStoreSingleton)("BrowserConditionStore is not initialized.");
+const conditionStoreNotInitializedError = createDiagnosticMessage({
+	source: "gt-react",
+	severity: "Error",
+	whatHappened: "Cannot read GT runtime context before it has been initialized",
+	why: "the internal ConditionStore singleton is unavailable",
+	fix: "Call initializeGT() (or initializeGTSPA() in SPA apps) before rendering and add a <GTProvider> at the root of your component tree."
+});
+const { setConditionStore: setReadonlyConditionStore, isConditionStoreInitialized: isReadonlyConditionStoreInitialized } = (0, gt_i18n_internal.createConditionStoreSingleton)(conditionStoreNotInitializedError);
+const { getConditionStore: getBrowserConditionStore, setConditionStore: setBrowserConditionStore, isConditionStoreInitialized: isBrowserConditionStoreInitialized } = (0, gt_i18n_internal.createConditionStoreSingleton)(conditionStoreNotInitializedError);
 //#endregion
 //#region src/condition-store/createBrowserConditionStore.ts
 /**
@@ -494,8 +477,11 @@ const { getConditionStore: getBrowserConditionStore, setConditionStore: setBrows
 *
 * This exists so we can keep the locale param as required in the constructor
 *
-* We want the values that we read from the cookies to override as this
-* persists state across page reloads
+* Server-provided props are the first candidates for hydration consistency.
+* Cookies fill in missing values to persist state across page reloads.
+*
+* Cookie names come from the I18nConfig singleton so custom names passed to
+* initializeGT() apply here without being threaded through provider props.
 */
 function createOrUpdateBrowserConditionStore(config) {
 	const locale = determineLocale(config);
@@ -510,9 +496,6 @@ function createOrUpdateBrowserConditionStore(config) {
 	}
 	const conditionStore = new BrowserConditionStore({
 		...config,
-		localeCookieName: defaultLocaleCookieName,
-		regionCookieName: defaultRegionCookieName,
-		enableI18nCookieName: defaultEnableI18nCookieName,
 		locale,
 		region,
 		enableI18n
@@ -520,26 +503,64 @@ function createOrUpdateBrowserConditionStore(config) {
 	setBrowserConditionStore(conditionStore);
 	return conditionStore;
 }
-function determineLocale({ localeCookieName = defaultLocaleCookieName, _getLocale: getLocale, locale }) {
+function determineLocale({ _getLocale: getLocale, locale }) {
+	const i18nConfig = (0, _generaltranslation_react_core_pure.getI18nConfig)();
 	const candidates = [];
 	if (locale) candidates.push(...Array.isArray(locale) ? locale : [locale]);
 	if (getLocale) candidates.push(getLocale());
-	candidates.push(...readBrowserLocale(localeCookieName));
-	return resolveLocale(candidates);
+	candidates.push(...readBrowserLocale(i18nConfig.getLocaleCookieName()));
+	return i18nConfig.resolveSupportedLocale(candidates);
 }
-function resolveLocale(candidates) {
-	const i18nConfig = (0, gt_i18n_internal.getI18nConfig)();
-	return i18nConfig.determineLocale(candidates) || i18nConfig.getDefaultLocale();
+function determineRegion({ _getRegion: getRegion, region }) {
+	return getCookieValue({ cookieName: (0, _generaltranslation_react_core_pure.getI18nConfig)().getRegionCookieName() }) || getRegion?.() || region;
 }
-function determineRegion({ regionCookieName = defaultRegionCookieName, _getRegion: getRegion, region }) {
-	return getCookieValue({ cookieName: regionCookieName }) || getRegion?.() || region;
-}
-function determineEnableI18n({ enableI18n, enableI18nCookieName = defaultEnableI18nCookieName, _getEnableI18n: getEnableI18n }) {
-	const cookieEnableI18n = getCookieValue({ cookieName: enableI18nCookieName });
-	if (cookieEnableI18n === void 0) return getEnableI18n?.() ?? enableI18n ?? true;
+function determineEnableI18n({ enableI18n, _getEnableI18n: getEnableI18n }) {
+	if (enableI18n !== void 0) return enableI18n;
+	const cookieEnableI18n = getCookieValue({ cookieName: (0, _generaltranslation_react_core_pure.getI18nConfig)().getEnableI18nCookieName() });
+	if (cookieEnableI18n === void 0) return getEnableI18n?.() ?? true;
 	return cookieEnableI18n === "true";
 }
 //#endregion
+//#region src/setup/runtimeCredentials.ts
+function addRuntimeCredentials(config) {
+	const credentials = getRuntimeCredentials();
+	return {
+		...config,
+		projectId: config.projectId || credentials.projectId,
+		devApiKey: config.devApiKey || credentials.devApiKey
+	};
+}
+function getRuntimeCredentials() {
+	return {
+		projectId: readImportMetaVite(() => ({}).env?.VITE_GT_PROJECT_ID) || readProcessEnvViteProjectId(),
+		devApiKey: (0, gt_i18n_internal.getRuntimeEnvironment)() === "development" ? readImportMetaVite(() => ({}).env?.DEV ? {}.env?.VITE_GT_DEV_API_KEY : void 0) || readProcessEnvViteDevApiKey() : void 0
+	};
+}
+function readImportMetaVite(readValue) {
+	try {
+		return normalizeEnvValue(readValue());
+	} catch {
+		return;
+	}
+}
+function readProcessEnvViteProjectId() {
+	try {
+		return normalizeEnvValue(process.env.VITE_GT_PROJECT_ID);
+	} catch {
+		return;
+	}
+}
+function readProcessEnvViteDevApiKey() {
+	try {
+		return normalizeEnvValue(process.env.VITE_GT_DEV_API_KEY);
+	} catch {
+		return;
+	}
+}
+function normalizeEnvValue(value) {
+	return value || void 0;
+}
+//#endregion
 //#region src/setup/initializeGTSPA.ts
 /**
 * Initialize GT for an SPA
@@ -550,12 +571,12 @@ function determineEnableI18n({ enableI18n, enableI18nCookieName = defaultEnableI
 * This is SPA for browser runtime
 */
 async function initializeGTSPA(config) {
-	(0, gt_i18n_internal.setupGTServicesEnabled)(config);
-	(0, _generaltranslation_react_core_pure.initializeI18nConfig)(config, "SPA");
-	(0, _generaltranslation_react_core_pure.setReactI18nCache)(new BrowserI18nCache(config));
-	createOrUpdateBrowserConditionStore(config);
+	const runtimeConfig = addRuntimeCredentials(config);
+	(0, _generaltranslation_react_core_pure.initializeI18nConfig)(runtimeConfig, "SPA");
+	(0, _generaltranslation_react_core_pure.setReactI18nCache)(new BrowserI18nCache(runtimeConfig));
+	createOrUpdateBrowserConditionStore(runtimeConfig);
 	(0, _generaltranslation_react_core_pure.setI18nStore)(new _generaltranslation_react_core_pure.I18nStore());
-	await (0, _generaltranslation_react_core_pure.getTranslationsSnapshot)((0, _generaltranslation_react_core_pure.getReadonlyConditionStoreWithFallback)().getLocale());
+	await (0, _generaltranslation_react_core_pure.getTranslationsSnapshot)((0, _generaltranslation_react_core_pure.getReadonlyConditionStore)().getLocale());
 }
 //#endregion
 //#region src/setup/initializeGTSRAClient.ts
@@ -563,10 +584,10 @@ async function initializeGTSPA(config) {
 * Initialize GT for client-side rendering.
 */
 function initializeGTSRAClient(config) {
-	(0, _generaltranslation_react_core_pure.internalInitializeGTSRA)({
+	(0, _generaltranslation_react_core_pure.internalInitializeGTSRA)(addRuntimeCredentials({
 		cacheExpiryTime: null,
 		...config
-	});
+	}));
 }
 //#endregion
 //#region src/hooks/conditions-store.ts
@@ -853,9 +874,6 @@ Object.defineProperty(exports, "decodeVars", {
 		return _generaltranslation_react_core_pure.decodeVars;
 	}
 });
-exports.defaultEnableI18nCookieName = defaultEnableI18nCookieName;
-exports.defaultLocaleCookieName = defaultLocaleCookieName;
-exports.defaultRegionCookieName = defaultRegionCookieName;
 Object.defineProperty(exports, "derive", {
 	enumerable: true,
 	get: function() {
@@ -874,12 +892,6 @@ Object.defineProperty(exports, "getFormatLocales", {
 		return _generaltranslation_react_core_pure.getFormatLocales;
 	}
 });
-Object.defineProperty(exports, "getGTClass", {
-	enumerable: true,
-	get: function() {
-		return _generaltranslation_react_core_pure.getGTClass;
-	}
-});
 Object.defineProperty(exports, "getLocaleProperties", {
 	enumerable: true,
 	get: function() {
@@ -930,6 +942,12 @@ Object.defineProperty(exports, "msg", {
 		return _generaltranslation_react_core_pure.msg;
 	}
 });
+Object.defineProperty(exports, "resolveCanonicalLocale", {
+	enumerable: true,
+	get: function() {
+		return _generaltranslation_react_core_pure.resolveCanonicalLocale;
+	}
+});
 Object.defineProperty(exports, "setReactI18nCache", {
 	enumerable: true,
 	get: function() {
@@ -972,12 +990,6 @@ Object.defineProperty(exports, "useGT", {
 		return _generaltranslation_react_core_hooks.useGT;
 	}
 });
-Object.defineProperty(exports, "useGTClass", {
-	enumerable: true,
-	get: function() {
-		return _generaltranslation_react_core_hooks.useGTClass;
-	}
-});
 Object.defineProperty(exports, "useLocale", {
 	enumerable: true,
 	get: function() {
@@ -1025,11 +1037,5 @@ Object.defineProperty(exports, "useTranslations", {
 		return _generaltranslation_react_core_hooks.useTranslations;
 	}
 });
-Object.defineProperty(exports, "useVersionId", {
-	enumerable: true,
-	get: function() {
-		return _generaltranslation_react_core_hooks.useVersionId;
-	}
-});
 
 //# sourceMappingURL=index.client.cjs.map