intor 2.2.8 → 2.2.9

package/dist/react/index.cjs

@@ -645,6 +645,23 @@ function useTranslator2(preKey) {
   };
 }
 
+// src/client/shared/utils/get-initial-locale.ts
+function getInitialLocale(config, cookieName = config.cookie.name) {
+  const { defaultLocale, supportedLocales } = config;
+  const match = document.cookie.match(
+    new RegExp(
+      `(?:^|; )${cookieName.replaceAll(/([.$?*|{}()[\]\\/+^])/g, String.raw`\$1`)}=([^;]*)`
+    )
+  );
+  const cookieLocale = match ? decodeURIComponent(match[1]) : null;
+  const browserLocale = navigator.languages?.[0] || navigator.language;
+  const locale = cookieLocale || browserLocale || defaultLocale;
+  const normalized = locale.toLowerCase();
+  const matched = supportedLocales.find((l) => l.toLowerCase() === normalized);
+  return matched ?? defaultLocale;
+}
+
 exports.IntorProvider = IntorProvider;
 exports.TranslateHandlersProvider = TranslateHandlersProvider;
+exports.getInitialLocale = getInitialLocale;
 exports.useTranslator = useTranslator2;

package/dist/react/index.d.cts

@@ -208,4 +208,15 @@ type TranslatorInstance<M, PK extends string | undefined = undefined> = {
 declare function useTranslator<CK extends GenConfigKeys = "__default__">(): TranslatorInstance<GenMessages<CK>>;
 declare function useTranslator<CK extends GenConfigKeys = "__default__", PK extends string = LocalizedNodeKeys<GenMessages<CK>>>(preKey: IfGen<PK, string>): TranslatorInstance<GenMessages<CK>, PK>;
 
-export { IntorProvider, type IntorProviderProps, TranslateHandlersProvider, type TranslateHandlersProviderProps, useTranslator };
+/**
+ * Get the initial locale from cookie, browser, or default.
+ *
+ * - This function is intended for client-side use only.
+ *
+ * @param {IntorResolvedConfig} config - The intor configuration.
+ * @param {string} [cookieName=config.cookie.name] - Optional cookie name to check.
+ * @returns {string} The matched locale or the default locale.
+ */
+declare function getInitialLocale(config: IntorResolvedConfig, cookieName?: string): string;
+
+export { IntorProvider, type IntorProviderProps, TranslateHandlersProvider, type TranslateHandlersProviderProps, getInitialLocale, useTranslator };

package/dist/react/index.d.ts

@@ -208,4 +208,15 @@ type TranslatorInstance<M, PK extends string | undefined = undefined> = {
 declare function useTranslator<CK extends GenConfigKeys = "__default__">(): TranslatorInstance<GenMessages<CK>>;
 declare function useTranslator<CK extends GenConfigKeys = "__default__", PK extends string = LocalizedNodeKeys<GenMessages<CK>>>(preKey: IfGen<PK, string>): TranslatorInstance<GenMessages<CK>, PK>;
 
-export { IntorProvider, type IntorProviderProps, TranslateHandlersProvider, type TranslateHandlersProviderProps, useTranslator };
+/**
+ * Get the initial locale from cookie, browser, or default.
+ *
+ * - This function is intended for client-side use only.
+ *
+ * @param {IntorResolvedConfig} config - The intor configuration.
+ * @param {string} [cookieName=config.cookie.name] - Optional cookie name to check.
+ * @returns {string} The matched locale or the default locale.
+ */
+declare function getInitialLocale(config: IntorResolvedConfig, cookieName?: string): string;
+
+export { IntorProvider, type IntorProviderProps, TranslateHandlersProvider, type TranslateHandlersProviderProps, getInitialLocale, useTranslator };

package/dist/react/index.js

@@ -619,4 +619,20 @@ function useTranslator2(preKey) {
   };
 }
 
-export { IntorProvider, TranslateHandlersProvider, useTranslator2 as useTranslator };
+// src/client/shared/utils/get-initial-locale.ts
+function getInitialLocale(config, cookieName = config.cookie.name) {
+  const { defaultLocale, supportedLocales } = config;
+  const match = document.cookie.match(
+    new RegExp(
+      `(?:^|; )${cookieName.replaceAll(/([.$?*|{}()[\]\\/+^])/g, String.raw`\$1`)}=([^;]*)`
+    )
+  );
+  const cookieLocale = match ? decodeURIComponent(match[1]) : null;
+  const browserLocale = navigator.languages?.[0] || navigator.language;
+  const locale = cookieLocale || browserLocale || defaultLocale;
+  const normalized = locale.toLowerCase();
+  const matched = supportedLocales.find((l) => l.toLowerCase() === normalized);
+  return matched ?? defaultLocale;
+}
+
+export { IntorProvider, TranslateHandlersProvider, getInitialLocale, useTranslator2 as useTranslator };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "intor",
-  "version": "2.2.8",
+  "version": "2.2.9",
   "description": "A modular and extensible i18n core designed for TypeScript and JavaScript projects. Intor enables custom translation logic with support for both frontend and backend environments, featuring runtime configuration, caching, adapters, and message loaders.",
   "author": "Yiming Liao",
   "license": "MIT",