intor 2.2.11 → 2.2.13

package/dist/react/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var React6 = require('react');
+var React7 = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 var logry = require('logry');
 var Keyv = require('keyv');
@@ -27,25 +27,76 @@ function _interopNamespace(e) {
   return Object.freeze(n);
 }
 
-var React6__namespace = /*#__PURE__*/_interopNamespace(React6);
+var React7__namespace = /*#__PURE__*/_interopNamespace(React7);
 var Keyv__default = /*#__PURE__*/_interopDefault(Keyv);
 var merge__default = /*#__PURE__*/_interopDefault(merge);
 
 // src/client/react/contexts/intor-provider/intor-provider.tsx
-var ConfigContext = React6__namespace.createContext(void 0);
+var ConfigContext = React7__namespace.createContext(void 0);
 function ConfigProvider({
   value: { config, pathname },
   children
 }) {
-  const value = React6__namespace.useMemo(() => ({ config, pathname }), [config, pathname]);
+  const value = React7__namespace.useMemo(() => ({ config, pathname }), [config, pathname]);
   return /* @__PURE__ */ jsxRuntime.jsx(ConfigContext.Provider, { value, children });
 }
 function useConfig() {
-  const context = React6__namespace.useContext(ConfigContext);
+  const context = React7__namespace.useContext(ConfigContext);
   if (!context) throw new Error("useConfig must be used within ConfigProvider");
   return context;
 }
 
+// src/shared/utils/client/build-cookie-string.ts
+var buildCookieString = (cookie, locale) => {
+  const parts = [`${cookie.name}=${encodeURIComponent(locale)}`];
+  if (cookie.maxAge) {
+    const expires = new Date(Date.now() + cookie.maxAge * 1e3).toUTCString();
+    parts.push(`expires=${expires}`, `max-age=${cookie.maxAge}`);
+  }
+  parts.push(`path=${cookie.path ?? "/"}`);
+  if (cookie.domain) {
+    parts.push(`domain=${cookie.domain}`);
+  }
+  if (cookie.sameSite) {
+    parts.push(
+      `SameSite=${cookie.sameSite[0].toUpperCase()}${cookie.sameSite.slice(1).toLowerCase()}`
+    );
+  }
+  if (cookie.secure !== false) {
+    parts.push(`Secure`);
+  }
+  return parts.join("; ");
+};
+
+// src/shared/utils/client/set-locale-cookie-browser.ts
+var setLocaleCookieBrowser = ({
+  cookie,
+  locale
+}) => {
+  if (typeof document === "undefined") return;
+  if (!cookie.enabled || !cookie.autoSetCookie) return;
+  const cookieString = buildCookieString(cookie, locale);
+  document.cookie = cookieString;
+};
+
+// src/client/react/contexts/locale/utils/use-init-locale-cookie.ts
+var useInitLocaleCookie = ({
+  config,
+  locale
+}) => {
+  React7__namespace.useEffect(() => {
+    if (typeof document === "undefined") return;
+    const { cookie, routing } = config;
+    const { firstVisit } = routing;
+    const cookies = document.cookie.split(";").map((c) => c.trim());
+    const isCookieExists = cookies.some((c) => c.startsWith(`${cookie.name}=`));
+    if (isCookieExists) return;
+    if (!firstVisit.redirect) return;
+    if (!cookie.enabled || !cookie.autoSetCookie) return;
+    setLocaleCookieBrowser({ cookie, locale });
+  }, []);
+};
+
 // src/config/constants/cache.constants.ts
 var DEFAULT_CACHE_OPTIONS = {
   enabled: process.env.NODE_ENV === "production",
@@ -358,19 +409,19 @@ var useRefetchMessages = ({
   setLoadedMessages,
   setIsLoadingMessages
 }) => {
-  const { messages: staticMessages } = config;
-  const namespaces = React6__namespace.useMemo(() => {
-    if (!config.loader) return [];
+  const { messages: staticMessages, loader } = config;
+  const namespaces = React7__namespace.useMemo(() => {
+    if (!loader) return [];
     return resolveNamespaces({ config, pathname });
   }, [config, pathname]);
-  const refetchMessages = React6__namespace.useCallback(
+  const refetchMessages = React7__namespace.useCallback(
     async (newLocale) => {
-      if (config.loader?.type === "remote") {
+      if (loader?.type === "remote") {
         setIsLoadingMessages(true);
         const loadedMessages = await loadRemoteMessages({
-          rootDir: config.loader.rootDir,
-          remoteUrl: config.loader.remoteUrl,
-          remoteHeaders: config.loader.remoteHeaders,
+          rootDir: loader.rootDir,
+          remoteUrl: loader.remoteUrl,
+          remoteHeaders: loader.remoteHeaders,
           locale: newLocale,
           fallbackLocales: config.fallbackLocales[newLocale] || [],
           namespaces,
@@ -385,8 +436,9 @@ var useRefetchMessages = ({
       }
     },
     [
-      config.loader,
+      loader,
       config.fallbackLocales,
+      config.cache,
       config.id,
       setIsLoadingMessages,
       namespaces,
@@ -396,21 +448,21 @@ var useRefetchMessages = ({
   );
   return { refetchMessages };
 };
-var MessagesContext = React6__namespace.createContext(void 0);
+var MessagesContext = React7__namespace.createContext(void 0);
 function MessagesProvider({
   value: { messages = {} },
   children
 }) {
   const { config, pathname } = useConfig();
-  const [loadedMessages, setLoadedMessages] = React6__namespace.useState(null);
-  const [isLoadingMessages, setIsLoadingMessages] = React6__namespace.useState(false);
+  const [loadedMessages, setLoadedMessages] = React7__namespace.useState(null);
+  const [isLoadingMessages, setIsLoadingMessages] = React7__namespace.useState(false);
   const { refetchMessages } = useRefetchMessages({
     config,
     pathname,
     setLoadedMessages,
     setIsLoadingMessages
   });
-  const value = React6__namespace.useMemo(
+  const value = React7__namespace.useMemo(
     () => ({
       messages: loadedMessages || messages,
       isLoading: isLoadingMessages,
@@ -423,128 +475,61 @@ function MessagesProvider({
   return /* @__PURE__ */ jsxRuntime.jsx(MessagesContext.Provider, { value, children });
 }
 function useMessages() {
-  const context = React6__namespace.useContext(MessagesContext);
+  const context = React7__namespace.useContext(MessagesContext);
   if (!context)
     throw new Error("useMessages must be used within a MessagesProvider");
   return context;
 }
-
-// src/client/react/contexts/locale/utils/use-init-lazy-load.ts
-var useInitLazyLoad = ({
-  loaderOptions,
-  currentLocale
-}) => {
-  const { refetchMessages } = useMessages();
-  const lazyLoad = !!loaderOptions?.lazyLoad;
-  const isFirstLoadedRef = React6__namespace.useRef(false);
-  React6__namespace.useEffect(() => {
-    if (lazyLoad && !isFirstLoadedRef.current) {
-      void refetchMessages(currentLocale);
-      isFirstLoadedRef.current = true;
-    }
-  }, [lazyLoad, currentLocale, refetchMessages, isFirstLoadedRef]);
-};
-
-// src/shared/utils/client/build-cookie-string.ts
-var buildCookieString = (cookie, locale) => {
-  const parts = [`${cookie.name}=${encodeURIComponent(locale)}`];
-  if (cookie.maxAge) {
-    const expires = new Date(Date.now() + cookie.maxAge * 1e3).toUTCString();
-    parts.push(`expires=${expires}`, `max-age=${cookie.maxAge}`);
-  }
-  parts.push(`path=${cookie.path ?? "/"}`);
-  if (cookie.domain) {
-    parts.push(`domain=${cookie.domain}`);
-  }
-  if (cookie.sameSite) {
-    parts.push(
-      `SameSite=${cookie.sameSite[0].toUpperCase()}${cookie.sameSite.slice(1).toLowerCase()}`
-    );
-  }
-  if (cookie.secure !== false) {
-    parts.push(`Secure`);
-  }
-  return parts.join("; ");
-};
-
-// src/shared/utils/client/set-locale-cookie-browser.ts
-var setLocaleCookieBrowser = ({
-  cookie,
-  locale
-}) => {
-  if (globalThis.window === void 0) return;
-  if (cookie.disabled || !cookie.autoSetCookie) return;
-  const cookieString = buildCookieString(cookie, locale);
-  document.cookie = cookieString;
-};
-
-// src/client/react/contexts/locale/utils/use-init-locale-cookie.ts
-var useInitLocaleCookie = ({
-  config,
-  locale
-}) => {
-  React6__namespace.useEffect(() => {
-    if (typeof document === "undefined") return;
-    const { cookie, routing } = config;
-    const { firstVisit } = routing;
-    const cookies = document.cookie.split(";").map((c) => c.trim());
-    const isCookieExists = cookies.some((c) => c.startsWith(`${cookie.name}=`));
-    if (isCookieExists) return;
-    if (!firstVisit.redirect) return;
-    if (cookie.disabled || !cookie.autoSetCookie) return;
-    setLocaleCookieBrowser({ cookie, locale });
-  }, []);
-};
-var LocaleContext = React6__namespace.createContext(void 0);
+var LocaleContext = React7__namespace.createContext(void 0);
 
 // src/client/react/contexts/locale/utils/change-locale.ts
 var changeLocale = ({
   currentLocale,
   newLocale,
-  loaderOptions,
+  loader,
   cookie,
   setLocale,
   refetchMessages
 }) => {
   if (typeof document === "undefined") return;
-  const loaderType = loaderOptions?.type;
+  const { type } = loader || {};
   if (newLocale === currentLocale) return;
-  if (loaderType === "local") {
+  if (type === "local") {
     console.warn(
-      `[Intor] You are using dynamic local to switch languages. Please make sure to use the wrapped <Link> component to trigger a page reload, ensuring that the translation data is dynamically updated.`
+      `[Intor] You are using "loader type: local" to switch languages. Please make sure to use the wrapped <Link> component to trigger a page reload, ensuring that the translation data is dynamically updated.`
     );
   }
   setLocale(newLocale);
   setLocaleCookieBrowser({ cookie, locale: newLocale });
   document.documentElement.lang = newLocale;
-  if (loaderType === "remote" && refetchMessages) {
+  if (type === "remote" && refetchMessages) {
     void refetchMessages(newLocale);
   }
 };
 function LocaleProvider({
-  value: { initialLocale },
+  value: { initialLocale, onLocaleChange },
   children
 }) {
   const { config } = useConfig();
   const { refetchMessages } = useMessages();
-  const { loader: loaderOptions, cookie } = config;
-  const [currentLocale, setCurrentLocale] = React6__namespace.useState(initialLocale);
-  useInitLazyLoad({ loaderOptions, currentLocale });
+  const { loader, cookie } = config;
+  const [currentLocale, setCurrentLocale] = React7__namespace.useState(initialLocale);
   useInitLocaleCookie({ config, locale: initialLocale });
-  const setLocale = React6__namespace.useCallback(
-    (newLocale) => {
+  const setLocale = React7__namespace.useCallback(
+    async (newLocale) => {
       changeLocale({
         currentLocale,
         newLocale,
-        loaderOptions,
+        loader,
         cookie,
         setLocale: setCurrentLocale,
         refetchMessages
       });
+      onLocaleChange?.(newLocale);
     },
-    [currentLocale, loaderOptions, cookie, refetchMessages]
+    [currentLocale, loader, cookie, refetchMessages, onLocaleChange]
   );
-  const value = React6__namespace.useMemo(
+  const value = React7__namespace.useMemo(
     () => ({
       locale: currentLocale,
       setLocale
@@ -554,66 +539,56 @@ function LocaleProvider({
   return /* @__PURE__ */ jsxRuntime.jsx(LocaleContext.Provider, { value, children });
 }
 function useLocale() {
-  const context = React6__namespace.useContext(LocaleContext);
+  const context = React7__namespace.useContext(LocaleContext);
   if (!context)
     throw new Error("useLocale must be used within a LocaleProvider");
   return context;
 }
-var TranslateHandlersContext = React6__namespace.createContext(void 0);
+var TranslateHandlersContext = React7__namespace.createContext(void 0);
 var TranslateHandlersProvider = ({
-  children,
-  handlers
+  handlers,
+  children
 }) => {
-  const value = handlers;
-  return /* @__PURE__ */ jsxRuntime.jsx(TranslateHandlersContext.Provider, { value, children });
+  return /* @__PURE__ */ jsxRuntime.jsx(TranslateHandlersContext.Provider, { value: { handlers }, children });
 };
 function useTranslateHandlers() {
-  const context = React6__namespace.useContext(TranslateHandlersContext);
+  const context = React7__namespace.useContext(TranslateHandlersContext);
   return context;
 }
-var useInitLoadingState = (config) => {
-  const lazyLoad = !!config.loader?.lazyLoad;
-  const [isCsr, setIsCsr] = React6__namespace.useState(false);
-  React6__namespace.useEffect(() => {
-    setIsCsr(true);
-  }, []);
-  const isBeforeCSRLoading = lazyLoad && !isCsr;
-  return isBeforeCSRLoading;
-};
-var TranslatorContext = React6__namespace.createContext(void 0);
-var EMPTY_OBJECT = Object.freeze({});
-function TranslatorProvider({ children }) {
+var TranslatorContext = React7__namespace.createContext(void 0);
+function TranslatorProvider({
+  value: { isLoading: externalIsLoading },
+  children
+}) {
   const { config } = useConfig();
-  const { messages, isLoading } = useMessages();
+  const { messages, isLoading: internalIsLoading } = useMessages();
   const { locale } = useLocale();
-  const translatorHandlers = useTranslateHandlers();
+  const { handlers } = useTranslateHandlers();
   const { fallbackLocales, translator: translatorOptions } = config;
-  const isBeforeCSRLoading = useInitLoadingState(config);
-  const value = React6__namespace.useMemo(() => {
-    const translator = new intorTranslator.Translator({
-      messages: messages || EMPTY_OBJECT,
+  const isLoading = Boolean(externalIsLoading ?? internalIsLoading);
+  const translator = React7__namespace.useMemo(() => {
+    return new intorTranslator.Translator({
+      messages,
       locale,
+      isLoading,
       fallbackLocales,
       loadingMessage: translatorOptions?.loadingMessage,
       placeholder: translatorOptions?.placeholder,
-      handlers: translatorHandlers
+      handlers
     });
-    translator.setLoading(isBeforeCSRLoading || isLoading);
-    return { translator };
   }, [
-    fallbackLocales,
-    isBeforeCSRLoading,
-    isLoading,
-    locale,
     messages,
-    translatorHandlers,
+    locale,
+    isLoading,
+    fallbackLocales,
+    handlers,
     translatorOptions?.loadingMessage,
     translatorOptions?.placeholder
   ]);
-  return /* @__PURE__ */ jsxRuntime.jsx(TranslatorContext.Provider, { value, children });
+  return /* @__PURE__ */ jsxRuntime.jsx(TranslatorContext.Provider, { value: { translator }, children });
 }
 function useTranslator() {
-  const context = React6__namespace.useContext(TranslatorContext);
+  const context = React7__namespace.useContext(TranslatorContext);
   if (!context)
     throw new Error(
       "useTranslator must be used within IntorTranslatorProvider"
@@ -621,10 +596,17 @@ function useTranslator() {
   return context;
 }
 var IntorProvider = ({
-  value: { config, pathname = "", initialLocale, messages = config.messages },
+  value: {
+    config,
+    pathname = "",
+    initialLocale,
+    messages = config.messages,
+    onLocaleChange,
+    isLoading
+  },
   children
 }) => {
-  return /* @__PURE__ */ jsxRuntime.jsx(ConfigProvider, { value: { config, pathname }, children: /* @__PURE__ */ jsxRuntime.jsx(MessagesProvider, { value: { messages }, children: /* @__PURE__ */ jsxRuntime.jsx(LocaleProvider, { value: { initialLocale }, children: /* @__PURE__ */ jsxRuntime.jsx(TranslatorProvider, { children }) }) }) });
+  return /* @__PURE__ */ jsxRuntime.jsx(ConfigProvider, { value: { config, pathname }, children: /* @__PURE__ */ jsxRuntime.jsx(MessagesProvider, { value: { messages }, children: /* @__PURE__ */ jsxRuntime.jsx(LocaleProvider, { value: { initialLocale, onLocaleChange }, children: /* @__PURE__ */ jsxRuntime.jsx(TranslatorProvider, { value: { isLoading }, children }) }) }) });
 };
 
 // src/client/react/hooks/use-translator.ts

package/dist/react/index.d.cts

@@ -4,8 +4,8 @@ import { Locale, LocaleMessages, FallbackLocalesMap, TranslateHandlers, ScopedLe
 import * as React from 'react';
 
 type CookieRawOptions = {
-    /** Completely disable cookie usage (no read, no write, no lookup by name) - default: false */
-    disabled?: boolean;
+    /** Enable cookie usage (read/write) - default: true */
+    enabled?: boolean;
     /** Allow the system to automatically set cookies - default: true */
     autoSetCookie?: boolean;
     /** default: "intor.i18n.locale" */
@@ -53,7 +53,6 @@ type BaseLoaderOptions = {
     namespaces?: string[];
     routeNamespaces?: RouteNamespaces;
     concurrency?: number;
-    lazyLoad?: boolean;
 };
 type LocalLoader = BaseLoaderOptions & {
     type: "local";
@@ -90,6 +89,7 @@ type RoutingRawOptions = {
 type RoutingResolvedOptions = Required<RoutingRawOptions>;
 
 type CacheRawOptions = {
+    /** default: process.env.NODE_ENV === "production" */
     enabled?: boolean;
     /** default: 60\*60\*1000 (1 hour) */
     ttl?: number;
@@ -125,18 +125,20 @@ interface IntorProviderProps {
         initialLocale: Locale;
         pathname?: string;
         messages?: Readonly<LocaleMessages>;
+        onLocaleChange?: (newLocale: string) => Promise<void> | void;
+        isLoading?: boolean;
     };
     children: React.ReactNode;
 }
 
-declare const IntorProvider: ({ value: { config, pathname, initialLocale, messages }, children, }: IntorProviderProps) => react_jsx_runtime.JSX.Element;
+declare const IntorProvider: ({ value: { config, pathname, initialLocale, messages, onLocaleChange, isLoading, }, children, }: IntorProviderProps) => react_jsx_runtime.JSX.Element;
 
 type TranslateHandlersProviderProps = {
-    children: React.ReactNode;
     handlers: TranslateHandlers;
+    children: React.ReactNode;
 };
 
-declare const TranslateHandlersProvider: ({ children, handlers, }: TranslateHandlersProviderProps) => react_jsx_runtime.JSX.Element;
+declare const TranslateHandlersProvider: ({ handlers, children, }: TranslateHandlersProviderProps) => react_jsx_runtime.JSX.Element;
 
 declare const PREFIX_PLACEHOLDER = "{locale}";
 

package/dist/react/index.d.ts

@@ -4,8 +4,8 @@ import { Locale, LocaleMessages, FallbackLocalesMap, TranslateHandlers, ScopedLe
 import * as React from 'react';
 
 type CookieRawOptions = {
-    /** Completely disable cookie usage (no read, no write, no lookup by name) - default: false */
-    disabled?: boolean;
+    /** Enable cookie usage (read/write) - default: true */
+    enabled?: boolean;
     /** Allow the system to automatically set cookies - default: true */
     autoSetCookie?: boolean;
     /** default: "intor.i18n.locale" */
@@ -53,7 +53,6 @@ type BaseLoaderOptions = {
     namespaces?: string[];
     routeNamespaces?: RouteNamespaces;
     concurrency?: number;
-    lazyLoad?: boolean;
 };
 type LocalLoader = BaseLoaderOptions & {
     type: "local";
@@ -90,6 +89,7 @@ type RoutingRawOptions = {
 type RoutingResolvedOptions = Required<RoutingRawOptions>;
 
 type CacheRawOptions = {
+    /** default: process.env.NODE_ENV === "production" */
     enabled?: boolean;
     /** default: 60\*60\*1000 (1 hour) */
     ttl?: number;
@@ -125,18 +125,20 @@ interface IntorProviderProps {
         initialLocale: Locale;
         pathname?: string;
         messages?: Readonly<LocaleMessages>;
+        onLocaleChange?: (newLocale: string) => Promise<void> | void;
+        isLoading?: boolean;
     };
     children: React.ReactNode;
 }
 
-declare const IntorProvider: ({ value: { config, pathname, initialLocale, messages }, children, }: IntorProviderProps) => react_jsx_runtime.JSX.Element;
+declare const IntorProvider: ({ value: { config, pathname, initialLocale, messages, onLocaleChange, isLoading, }, children, }: IntorProviderProps) => react_jsx_runtime.JSX.Element;
 
 type TranslateHandlersProviderProps = {
-    children: React.ReactNode;
     handlers: TranslateHandlers;
+    children: React.ReactNode;
 };
 
-declare const TranslateHandlersProvider: ({ children, handlers, }: TranslateHandlersProviderProps) => react_jsx_runtime.JSX.Element;
+declare const TranslateHandlersProvider: ({ handlers, children, }: TranslateHandlersProviderProps) => react_jsx_runtime.JSX.Element;
 
 declare const PREFIX_PLACEHOLDER = "{locale}";