@better-i18n/use-intl 0.1.8 → 0.2.0

package/{src/context.tsx → dist/context.js}

@@ -1,15 +1,9 @@
 "use client";
-
 import { createContext, useContext } from "react";
-import type { BetterI18nContextValue } from "./types";
-
 /**
  * Context for Better i18n specific state
  */
-export const BetterI18nContext = createContext<BetterI18nContextValue | null>(
-  null
-);
-
+export const BetterI18nContext = createContext(null);
 /**
  * Hook to access Better i18n context
  *
@@ -46,14 +40,11 @@ export const BetterI18nContext = createContext<BetterI18nContextValue | null>(
  * }
  * ```
  */
-export function useBetterI18n(): BetterI18nContextValue {
-  const context = useContext(BetterI18nContext);
-
-  if (!context) {
-    throw new Error(
-      "[better-i18n] useBetterI18n must be used within a BetterI18nProvider"
-    );
-  }
-
-  return context;
+export function useBetterI18n() {
+    const context = useContext(BetterI18nContext);
+    if (!context) {
+        throw new Error("[better-i18n] useBetterI18n must be used within a BetterI18nProvider");
+    }
+    return context;
 }
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAGlD;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAC5C,IAAI,CACL,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAE9C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,sEAAsE,CACvE,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/hooks/useLocaleRouter.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Return type for useLocaleRouter hook
+ */
+export interface UseLocaleRouterReturn {
+    /**
+     * Current locale (extracted from URL or default)
+     */
+    locale: string;
+    /**
+     * Available locales from CDN manifest
+     */
+    locales: string[];
+    /**
+     * Default locale (no URL prefix)
+     */
+    defaultLocale: string;
+    /**
+     * Navigate to the same page with a new locale
+     * Uses TanStack Router's navigate() for proper SPA navigation
+     */
+    navigate: (locale: string) => void;
+    /**
+     * Get a localized path for link building
+     * @param path - The path to localize
+     * @param locale - Target locale (optional, uses current if not specified)
+     */
+    localePath: (path: string, locale?: string) => string;
+    /**
+     * Whether languages have been loaded from CDN
+     */
+    isReady: boolean;
+}
+/**
+ * Hook for router-integrated locale navigation
+ *
+ * This hook provides a navigation-first approach to locale switching:
+ * - Locale changes trigger proper router navigation
+ * - Loaders re-execute with the new locale
+ * - No state synchronization issues
+ * - Works with TanStack Router's file-based routing
+ *
+ * @example
+ * ```tsx
+ * function LanguageSwitcher() {
+ *   const { locale, locales, navigate, isReady } = useLocaleRouter();
+ *
+ *   if (!isReady) return <Skeleton />;
+ *
+ *   return (
+ *     <select value={locale} onChange={(e) => navigate(e.target.value)}>
+ *       {locales.map((loc) => (
+ *         <option key={loc} value={loc}>{loc}</option>
+ *       ))}
+ *     </select>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Building localized links
+ * function Navigation() {
+ *   const { localePath } = useLocaleRouter();
+ *
+ *   return (
+ *     <nav>
+ *       <Link to={localePath('/about')}>About</Link>
+ *       <Link to={localePath('/contact', 'tr')}>İletişim (TR)</Link>
+ *     </nav>
+ *   );
+ * }
+ * ```
+ */
+export declare function useLocaleRouter(): UseLocaleRouterReturn;
+//# sourceMappingURL=useLocaleRouter.d.ts.map

package/dist/hooks/useLocaleRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLocaleRouter.d.ts","sourceRoot":"","sources":["../../src/hooks/useLocaleRouter.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAEnC;;;;OAIG;IACH,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAEtD;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,eAAe,IAAI,qBAAqB,CAuDvD"}

package/dist/hooks/useLocaleRouter.js

@@ -0,0 +1,89 @@
+"use client";
+import { useCallback, useMemo } from "react";
+import { useRouter, useLocation } from "@tanstack/react-router";
+import { getLocaleFromPath, replaceLocaleInPath, addLocalePrefix, } from "@better-i18n/core";
+import { useBetterI18n } from "../context.js";
+/**
+ * Hook for router-integrated locale navigation
+ *
+ * This hook provides a navigation-first approach to locale switching:
+ * - Locale changes trigger proper router navigation
+ * - Loaders re-execute with the new locale
+ * - No state synchronization issues
+ * - Works with TanStack Router's file-based routing
+ *
+ * @example
+ * ```tsx
+ * function LanguageSwitcher() {
+ *   const { locale, locales, navigate, isReady } = useLocaleRouter();
+ *
+ *   if (!isReady) return <Skeleton />;
+ *
+ *   return (
+ *     <select value={locale} onChange={(e) => navigate(e.target.value)}>
+ *       {locales.map((loc) => (
+ *         <option key={loc} value={loc}>{loc}</option>
+ *       ))}
+ *     </select>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Building localized links
+ * function Navigation() {
+ *   const { localePath } = useLocaleRouter();
+ *
+ *   return (
+ *     <nav>
+ *       <Link to={localePath('/about')}>About</Link>
+ *       <Link to={localePath('/contact', 'tr')}>İletişim (TR)</Link>
+ *     </nav>
+ *   );
+ * }
+ * ```
+ */
+export function useLocaleRouter() {
+    const router = useRouter();
+    const location = useLocation();
+    const { languages, isLoadingLanguages } = useBetterI18n();
+    // Build config from CDN manifest
+    const config = useMemo(() => ({
+        locales: languages.map((lang) => lang.code),
+        defaultLocale: languages.find((l) => l.isDefault)?.code || "en",
+    }), [languages]);
+    // Get effective locale from URL (handles default without prefix)
+    const locale = useMemo(() => {
+        // If no languages loaded yet, extract from path manually
+        if (languages.length === 0) {
+            const segments = location.pathname.split("/").filter(Boolean);
+            const firstSegment = segments[0];
+            // Check if it looks like a locale code (2 letters)
+            if (firstSegment && /^[a-z]{2}$/i.test(firstSegment)) {
+                return firstSegment;
+            }
+            return "en"; // fallback
+        }
+        return getLocaleFromPath(location.pathname, config);
+    }, [location.pathname, config, languages]);
+    // Navigate to same page with new locale (SPA navigation!)
+    const navigate = useCallback((newLocale) => {
+        const newPath = replaceLocaleInPath(location.pathname, newLocale, config);
+        router.navigate({ to: newPath });
+    }, [location.pathname, config, router]);
+    // Get localized path for links
+    const localePath = useCallback((path, targetLocale) => {
+        const loc = targetLocale || locale;
+        return addLocalePrefix(path, loc, config);
+    }, [locale, config]);
+    return {
+        locale,
+        locales: config.locales,
+        defaultLocale: config.defaultLocale,
+        navigate,
+        localePath,
+        isReady: !isLoadingLanguages && config.locales.length > 0,
+    };
+}
+//# sourceMappingURL=useLocaleRouter.js.map

package/dist/hooks/useLocaleRouter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLocaleRouter.js","sourceRoot":"","sources":["../../src/hooks/useLocaleRouter.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,GAEhB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAwC9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,EAAE,SAAS,EAAE,kBAAkB,EAAE,GAAG,aAAa,EAAE,CAAC;IAE1D,iCAAiC;IACjC,MAAM,MAAM,GAAiB,OAAO,CAClC,GAAG,EAAE,CAAC,CAAC;QACL,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;QAC3C,aAAa,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,IAAI,IAAI,IAAI;KAChE,CAAC,EACF,CAAC,SAAS,CAAC,CACZ,CAAC;IAEF,iEAAiE;IACjE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE;QAC1B,yDAAyD;QACzD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC9D,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YACjC,mDAAmD;YACnD,IAAI,YAAY,IAAI,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;gBACrD,OAAO,YAAY,CAAC;YACtB,CAAC;YACD,OAAO,IAAI,CAAC,CAAC,WAAW;QAC1B,CAAC;QACD,OAAO,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACtD,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAE3C,0DAA0D;IAC1D,MAAM,QAAQ,GAAG,WAAW,CAC1B,CAAC,SAAiB,EAAE,EAAE;QACpB,MAAM,OAAO,GAAG,mBAAmB,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QAC1E,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACnC,CAAC,EACD,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CACpC,CAAC;IAEF,+BAA+B;IAC/B,MAAM,UAAU,GAAG,WAAW,CAC5B,CAAC,IAAY,EAAE,YAAqB,EAAE,EAAE;QACtC,MAAM,GAAG,GAAG,YAAY,IAAI,MAAM,CAAC;QACnC,OAAO,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC,EACD,CAAC,MAAM,EAAE,MAAM,CAAC,CACjB,CAAC;IAEF,OAAO;QACL,MAAM;QACN,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,QAAQ;QACR,UAAU;QACV,OAAO,EAAE,CAAC,kBAAkB,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;KAC1D,CAAC;AACJ,CAAC"}

package/dist/hooks.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Hook to get available languages from CDN manifest
+ *
+ * @example
+ * ```tsx
+ * function LanguageList() {
+ *   const { languages, isLoading } = useLanguages()
+ *
+ *   if (isLoading) return <div>Loading...</div>
+ *
+ *   return (
+ *     <ul>
+ *       {languages.map((lang) => (
+ *         <li key={lang.code}>
+ *           {lang.nativeName} ({lang.code})
+ *         </li>
+ *       ))}
+ *     </ul>
+ *   )
+ * }
+ * ```
+ */
+export declare function useLanguages(): {
+    languages: import("@better-i18n/core").LanguageOption[];
+    isLoading: boolean;
+};
+/**
+ * Hook to get current locale (read-only)
+ *
+ * For locale switching with proper router navigation, use useLocaleRouter() instead.
+ *
+ * @example
+ * ```tsx
+ * function LocaleDisplay() {
+ *   const { locale, isLoading } = useLocale()
+ *
+ *   if (isLoading) return <div>Loading...</div>
+ *
+ *   return <span>Current locale: {locale}</span>
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // For locale switching, use useLocaleRouter:
+ * import { useLocaleRouter } from '@better-i18n/use-intl'
+ *
+ * function LocaleSwitcher() {
+ *   const { locale, navigate } = useLocaleRouter()
+ *   return (
+ *     <button onClick={() => navigate(locale === 'en' ? 'tr' : 'en')}>
+ *       Toggle: {locale}
+ *     </button>
+ *   )
+ * }
+ * ```
+ */
+export declare function useLocale(): {
+    locale: string;
+    isLoading: boolean;
+};
+export { useTranslations, useFormatter, useMessages, useNow, useTimeZone, useLocale as useIntlLocale, } from "use-intl";
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY;;;EAO3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,SAAS;;;EAOxB;AAGD,OAAO,EACL,eAAe,EACf,YAAY,EACZ,WAAW,EACX,MAAM,EACN,WAAW,EACX,SAAS,IAAI,aAAa,GAC3B,MAAM,UAAU,CAAC"}

package/{src/hooks.ts → dist/hooks.js}

@@ -1,7 +1,5 @@
 "use client";
-
-import { useBetterI18n } from "./context";
-
+import { useBetterI18n } from "./context.js";
 /**
  * Hook to get available languages from CDN manifest
  *
@@ -25,14 +23,12 @@ import { useBetterI18n } from "./context";
  * ```
  */
 export function useLanguages() {
-  const { languages, isLoadingLanguages } = useBetterI18n();
-
-  return {
-    languages,
-    isLoading: isLoadingLanguages,
-  };
+    const { languages, isLoadingLanguages } = useBetterI18n();
+    return {
+        languages,
+        isLoading: isLoadingLanguages,
+    };
 }
-
 /**
  * Hook to get current locale (read-only)
  *
@@ -65,20 +61,12 @@ export function useLanguages() {
  * ```
  */
 export function useLocale() {
-  const { locale, isLoadingMessages } = useBetterI18n();
-
-  return {
-    locale,
-    isLoading: isLoadingMessages,
-  };
+    const { locale, isLoadingMessages } = useBetterI18n();
+    return {
+        locale,
+        isLoading: isLoadingMessages,
+    };
 }
-
 // Re-export use-intl hooks for convenience
-export {
-  useTranslations,
-  useFormatter,
-  useMessages,
-  useNow,
-  useTimeZone,
-  useLocale as useIntlLocale,
-} from "use-intl";
+export { useTranslations, useFormatter, useMessages, useNow, useTimeZone, useLocale as useIntlLocale, } from "use-intl";
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,EAAE,SAAS,EAAE,kBAAkB,EAAE,GAAG,aAAa,EAAE,CAAC;IAE1D,OAAO;QACL,SAAS;QACT,SAAS,EAAE,kBAAkB;KAC9B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,GAAG,aAAa,EAAE,CAAC;IAEtD,OAAO;QACL,MAAM;QACN,SAAS,EAAE,iBAAiB;KAC7B,CAAC;AACJ,CAAC;AAED,2CAA2C;AAC3C,OAAO,EACL,eAAe,EACf,YAAY,EACZ,WAAW,EACX,MAAM,EACN,WAAW,EACX,SAAS,IAAI,aAAa,GAC3B,MAAM,UAAU,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { BetterI18nProvider } from "./provider.js";
+export type { BetterI18nProviderProps } from "./provider.js";
+export { useBetterI18n } from "./context.js";
+export { useLanguages, useLocale, useTranslations, useFormatter, useMessages, useNow, useTimeZone, } from "./hooks.js";
+export { useLocaleRouter } from "./hooks/useLocaleRouter.js";
+export type { UseLocaleRouterReturn } from "./hooks/useLocaleRouter.js";
+export { LanguageSwitcher } from "./components.js";
+export type { LanguageSwitcherProps } from "./components.js";
+export { LocaleDropdown } from "./components/locale-dropdown.js";
+export type { LocaleDropdownProps, LocaleDropdownRenderContext, } from "./components/locale-dropdown.js";
+export type { Messages, BetterI18nProviderConfig, BetterI18nContextValue, } from "./types.js";
+export { extractLocale, getLocaleFromPath, hasLocalePrefix, removeLocalePrefix, addLocalePrefix, replaceLocaleInPath, createLocalePath, type LocaleConfig, } from "@better-i18n/core";
+export { IntlProvider } from "use-intl";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,YAAY,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAG7D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EACL,YAAY,EACZ,SAAS,EAET,eAAe,EACf,YAAY,EACZ,WAAW,EACX,MAAM,EACN,WAAW,GACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,YAAY,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,YAAY,EACV,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,iCAAiC,CAAC;AAGzC,YAAY,EACV,QAAQ,EACR,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,YAAY,GAClB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+// Provider
+export { BetterI18nProvider } from "./provider.js";
+// Context & Hooks
+export { useBetterI18n } from "./context.js";
+export { useLanguages, useLocale, 
+// Re-exported from use-intl
+useTranslations, useFormatter, useMessages, useNow, useTimeZone, } from "./hooks.js";
+// Router Integration (TanStack Router)
+export { useLocaleRouter } from "./hooks/useLocaleRouter.js";
+// Components
+export { LanguageSwitcher } from "./components.js";
+export { LocaleDropdown } from "./components/locale-dropdown.js";
+// Re-export locale utilities from core (convenience)
+export { extractLocale, getLocaleFromPath, hasLocalePrefix, removeLocalePrefix, addLocalePrefix, replaceLocaleInPath, createLocalePath, } from "@better-i18n/core";
+// Re-export commonly used use-intl components
+export { IntlProvider } from "use-intl";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGnD,kBAAkB;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EACL,YAAY,EACZ,SAAS;AACT,4BAA4B;AAC5B,eAAe,EACf,YAAY,EACZ,WAAW,EACX,MAAM,EACN,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,uCAAuC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAG7D,aAAa;AACb,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGnD,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAajE,qDAAqD;AACrD,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,GAEjB,MAAM,mBAAmB,CAAC;AAE3B,8CAA8C;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/middleware/index.d.ts

@@ -0,0 +1,3 @@
+import type { I18nMiddlewareConfig } from "@better-i18n/core";
+export declare function createBetterI18nMiddleware(config: I18nMiddlewareConfig): any;
+//# sourceMappingURL=index.d.ts.map

package/dist/middleware/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,oBAAoB,OAsGtE"}

package/dist/middleware/index.js

@@ -0,0 +1,68 @@
+// @ts-expect-error - internal workspace dependency
+import { createMiddleware } from "@tanstack/react-router";
+// @ts-expect-error - internal workspace dependency
+import { detectLocale, getLocales } from "@better-i18n/core";
+export function createBetterI18nMiddleware(config) {
+    const { project, defaultLocale, localePrefix = "as-needed", detection = {} } = config;
+    const { cookie = true, browserLanguage = true, cookieName = "locale", cookieMaxAge = 31536000, } = detection;
+    return createMiddleware().server(async ({ next, request, }) => {
+        // 1. Fetch available locales from CDN (cached)
+        const availableLocales = await getLocales({ project });
+        // 2. Extract locale indicators
+        const url = new URL(request.url);
+        const pathSegment = url.pathname.split("/")[1];
+        const hasLocaleInPath = !!pathSegment && availableLocales.includes(pathSegment);
+        // Dynamic imports for TanStack Start server functions to avoid bundling them in client
+        // @ts-ignore - optional runtime dependency, types may not be available
+        const startServer = await import("@tanstack/react-start/server");
+        const getCookie = startServer.getCookie;
+        const setCookie = startServer.setCookie;
+        const getRequestHeader = startServer.getRequestHeader;
+        const cookieLocale = cookie ? getCookie(cookieName) : null;
+        const headerLocale = browserLanguage
+            ? getRequestHeader("accept-language")?.split(",")[0]?.split("-")[0]
+            : null;
+        // 3. Detect locale using core logic
+        const result = detectLocale({
+            project,
+            defaultLocale,
+            pathLocale: pathSegment,
+            cookieLocale,
+            headerLocale,
+            availableLocales,
+        });
+        // 4. Redirect if locale prefix is needed but missing
+        //    Skip API routes and paths that already have a locale prefix
+        const isApiRoute = url.pathname.startsWith("/api/");
+        if (localePrefix !== "never" &&
+            !hasLocaleInPath &&
+            !isApiRoute &&
+            result.detectedFrom !== "path") {
+            const shouldRedirect = localePrefix === "always" ||
+                (localePrefix === "as-needed" && result.locale !== defaultLocale);
+            if (shouldRedirect) {
+                const redirectUrl = new URL(`/${result.locale}${url.pathname}`, url.origin);
+                redirectUrl.search = url.search;
+                // Build redirect response with locale cookie
+                const headers = new Headers({
+                    Location: redirectUrl.toString(),
+                });
+                if (cookie && result.shouldSetCookie) {
+                    headers.set("Set-Cookie", `${cookieName}=${result.locale}; Path=/; Max-Age=${cookieMaxAge}; SameSite=Lax`);
+                }
+                return new Response(null, { status: 302, headers });
+            }
+        }
+        // 5. Set cookie if needed (non-redirect path)
+        if (cookie && result.shouldSetCookie) {
+            setCookie(cookieName, result.locale, {
+                path: "/",
+                maxAge: cookieMaxAge,
+                sameSite: "lax",
+            });
+        }
+        // 6. Pass locale to route context
+        return next({ context: { locale: result.locale } });
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/middleware/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"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"}

package/dist/provider.d.ts

@@ -0,0 +1,51 @@
+import type { LanguageOption } from "@better-i18n/core";
+import { type ReactNode } from "react";
+import type { BetterI18nProviderConfig } from "./types.js";
+export interface BetterI18nProviderProps extends BetterI18nProviderConfig {
+    children: ReactNode;
+    /** Pre-loaded languages from SSR loader — skips loading state on first render */
+    initialLanguages?: LanguageOption[];
+    /** Custom fallback when a message key is missing */
+    getMessageFallback?: (info: {
+        error: Error;
+        key: string;
+        namespace?: string;
+    }) => string;
+}
+/**
+ * Provider component that combines Better i18n CDN with use-intl
+ *
+ * The locale is controlled externally (from URL/router). Use useLocaleRouter()
+ * for locale switching with proper router integration.
+ *
+ * @example
+ * ```tsx
+ * // Basic usage (CSR - fetches messages on client)
+ * function App() {
+ *   return (
+ *     <BetterI18nProvider
+ *       project="acme/dashboard"
+ *       locale="en"
+ *     >
+ *       <MyComponent />
+ *     </BetterI18nProvider>
+ *   )
+ * }
+ *
+ * // TanStack Router SSR usage (pre-loaded messages from loader)
+ * function RootComponent() {
+ *   const { messages, locale } = Route.useLoaderData()
+ *   return (
+ *     <BetterI18nProvider
+ *       project="acme/dashboard"
+ *       locale={locale}
+ *       messages={messages}
+ *     >
+ *       <Outlet />
+ *     </BetterI18nProvider>
+ *   )
+ * }
+ * ```
+ */
+export declare function BetterI18nProvider({ children, project, locale: propLocale, messages: propMessages, timeZone, now, onError, cdnBaseUrl, debug, logLevel, fetch: customFetch, storage, staticData, fetchTimeout, retryCount, initialLanguages, getMessageFallback: customGetMessageFallback, }: BetterI18nProviderProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAgC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGrE,OAAO,KAAK,EAAE,wBAAwB,EAAY,MAAM,YAAY,CAAC;AAErE,MAAM,WAAW,uBAAwB,SAAQ,wBAAwB;IACvE,QAAQ,EAAE,SAAS,CAAC;IACpB,iFAAiF;IACjF,gBAAgB,CAAC,EAAE,cAAc,EAAE,CAAC;IACpC,oDAAoD;IACpD,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE;QAC1B,KAAK,EAAE,KAAK,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,KAAK,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,OAAO,EACP,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,YAAY,EACtB,QAAQ,EACR,GAAG,EACH,OAAO,EACP,UAAU,EACV,KAAK,EACL,QAAQ,EACR,KAAK,EAAE,WAAW,EAClB,OAAO,EACP,UAAU,EACV,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAAE,wBAAwB,GAC7C,EAAE,uBAAuB,2CA4IzB"}