@better-i18n/use-intl 0.1.7 → 0.1.18

package/README.md

@@ -93,11 +93,18 @@ Main provider that combines Better i18n CDN with use-intl.
   timeZone="Europe/Berlin" // Optional: Timezone for formatting
   now={new Date()}         // Optional: Current time (SSR)
   onLocaleChange={(l) => {}} // Optional: Locale change callback
+  // Fallback & Resilience
+  storage={storageAdapter}   // Optional: Persistent cache (localStorage, etc.)
+  staticData={bundledData}   // Optional: Bundled translations as last-resort
+  fetchTimeout={10000}       // Optional: CDN timeout in ms (default: 10s)
+  retryCount={1}             // Optional: CDN retry attempts (default: 1)
 >
   {children}
 </BetterI18nProvider>
 ```
 
+See [`@better-i18n/core`](https://www.npmjs.com/package/@better-i18n/core) for storage adapters and fallback chain details.
+
 ### Hooks
 
 #### `useTranslations(namespace?)`

package/dist/__tests__/provider-config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provider-config.test.d.ts.map

package/dist/__tests__/provider-config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-config.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/provider-config.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/provider-config.test.js

@@ -0,0 +1,79 @@
+import { describe, it, expect } from "vitest";
+// ─── Test fixtures ──────────────────────────────────────────────────
+const mockStorage = {
+    get: async () => null,
+    set: async () => { },
+};
+const mockStaticData = {
+    en: { common: { hello: "Hello" } },
+    tr: { common: { hello: "Merhaba" } },
+};
+// ─── Tests ──────────────────────────────────────────────────────────
+describe("BetterI18nProviderConfig — fallback fields", () => {
+    it("accepts storage field", () => {
+        const config = {
+            project: "acme/dashboard",
+            locale: "en",
+            storage: mockStorage,
+        };
+        expect(config.storage).toBe(mockStorage);
+    });
+    it("accepts staticData field", () => {
+        const config = {
+            project: "acme/dashboard",
+            locale: "en",
+            staticData: mockStaticData,
+        };
+        expect(config.staticData).toBe(mockStaticData);
+    });
+    it("accepts fetchTimeout field", () => {
+        const config = {
+            project: "acme/dashboard",
+            locale: "en",
+            fetchTimeout: 5000,
+        };
+        expect(config.fetchTimeout).toBe(5000);
+    });
+    it("accepts retryCount field", () => {
+        const config = {
+            project: "acme/dashboard",
+            locale: "en",
+            retryCount: 3,
+        };
+        expect(config.retryCount).toBe(3);
+    });
+    it("accepts all fallback fields together", () => {
+        const config = {
+            project: "acme/dashboard",
+            locale: "en",
+            storage: mockStorage,
+            staticData: mockStaticData,
+            fetchTimeout: 7000,
+            retryCount: 2,
+        };
+        expect(config.storage).toBe(mockStorage);
+        expect(config.staticData).toBe(mockStaticData);
+        expect(config.fetchTimeout).toBe(7000);
+        expect(config.retryCount).toBe(2);
+    });
+    it("works without any fallback fields (backward compat)", () => {
+        const config = {
+            project: "acme/dashboard",
+            locale: "en",
+        };
+        expect(config.storage).toBeUndefined();
+        expect(config.staticData).toBeUndefined();
+        expect(config.fetchTimeout).toBeUndefined();
+        expect(config.retryCount).toBeUndefined();
+    });
+    it("supports lazy staticData function", () => {
+        const lazyStaticData = async () => mockStaticData;
+        const config = {
+            project: "acme/dashboard",
+            locale: "en",
+            staticData: lazyStaticData,
+        };
+        expect(config.staticData).toBe(lazyStaticData);
+    });
+});
+//# sourceMappingURL=provider-config.test.js.map

package/dist/__tests__/provider-config.test.js.map

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

package/dist/components.d.ts

@@ -0,0 +1,44 @@
+import type { ComponentProps, ReactNode } from "react";
+export interface LanguageSwitcherProps extends Omit<ComponentProps<"select">, "value" | "onChange" | "children"> {
+    /**
+     * Render function for custom option display
+     */
+    renderOption?: (language: {
+        code: string;
+        name?: string;
+        nativeName?: string;
+        flagUrl?: string | null;
+        isDefault?: boolean;
+    }) => ReactNode;
+    /**
+     * Label for loading state
+     */
+    loadingLabel?: string;
+}
+/**
+ * Pre-built language switcher component with router integration
+ *
+ * Uses useLocaleRouter() internally for proper SPA navigation.
+ * Locale changes trigger router navigation, which re-executes loaders.
+ *
+ * @example
+ * ```tsx
+ * // Basic usage - just works!
+ * <LanguageSwitcher />
+ *
+ * // With custom styling
+ * <LanguageSwitcher className="my-select" />
+ *
+ * // Custom option rendering
+ * <LanguageSwitcher
+ *   renderOption={(lang) => (
+ *     <>
+ *       {lang.flagUrl && <img src={lang.flagUrl} alt="" />}
+ *       {lang.nativeName}
+ *     </>
+ *   )}
+ * />
+ * ```
+ */
+export declare function LanguageSwitcher({ renderOption, loadingLabel, ...props }: LanguageSwitcherProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=components.d.ts.map

package/dist/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../src/components.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvD,MAAM,WAAW,qBACf,SAAQ,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;IACzE;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE;QACxB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,KAAK,SAAS,CAAC;IAEhB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,YAAY,EACZ,YAA2B,EAC3B,GAAG,KAAK,EACT,EAAE,qBAAqB,2CAqBvB"}

package/dist/components.js

@@ -0,0 +1,38 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useLocaleRouter } from "./hooks/useLocaleRouter.js";
+import { useLanguages } from "./hooks.js";
+/**
+ * Pre-built language switcher component with router integration
+ *
+ * Uses useLocaleRouter() internally for proper SPA navigation.
+ * Locale changes trigger router navigation, which re-executes loaders.
+ *
+ * @example
+ * ```tsx
+ * // Basic usage - just works!
+ * <LanguageSwitcher />
+ *
+ * // With custom styling
+ * <LanguageSwitcher className="my-select" />
+ *
+ * // Custom option rendering
+ * <LanguageSwitcher
+ *   renderOption={(lang) => (
+ *     <>
+ *       {lang.flagUrl && <img src={lang.flagUrl} alt="" />}
+ *       {lang.nativeName}
+ *     </>
+ *   )}
+ * />
+ * ```
+ */
+export function LanguageSwitcher({ renderOption, loadingLabel = "Loading...", ...props }) {
+    const { locale, navigate, isReady } = useLocaleRouter();
+    const { languages } = useLanguages();
+    if (!isReady) {
+        return (_jsx("select", { disabled: true, ...props, children: _jsx("option", { children: loadingLabel }) }));
+    }
+    return (_jsx("select", { value: locale, onChange: (e) => navigate(e.target.value), ...props, children: languages.map((lang) => (_jsx("option", { value: lang.code, children: renderOption ? renderOption(lang) : lang.nativeName || lang.code }, lang.code))) }));
+}
+//# sourceMappingURL=components.js.map

package/dist/components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.js","sourceRoot":"","sources":["../src/components.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAqB1C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAC/B,YAAY,EACZ,YAAY,GAAG,YAAY,EAC3B,GAAG,KAAK,EACc;IACtB,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,eAAe,EAAE,CAAC;IACxD,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,EAAE,CAAC;IAErC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CACL,iBAAQ,QAAQ,WAAK,KAAK,YACxB,2BAAS,YAAY,GAAU,GACxB,CACV,CAAC;IACJ,CAAC;IAED,OAAO,CACL,iBAAQ,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAM,KAAK,YACxE,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CACvB,iBAAwB,KAAK,EAAE,IAAI,CAAC,IAAI,YACrC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,IADtD,IAAI,CAAC,IAAI,CAEb,CACV,CAAC,GACK,CACV,CAAC;AACJ,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,43 @@
+import type { BetterI18nContextValue } from "./types.js";
+/**
+ * Context for Better i18n specific state
+ */
+export declare const BetterI18nContext: import("react").Context<BetterI18nContextValue | null>;
+/**
+ * Hook to access Better i18n context
+ *
+ * Note: For locale switching, use useLocaleRouter() which integrates with TanStack Router.
+ *
+ * @example
+ * ```tsx
+ * function LanguageInfo() {
+ *   const { locale, languages, isLoadingLanguages } = useBetterI18n()
+ *
+ *   if (isLoadingLanguages) return <div>Loading...</div>
+ *
+ *   return (
+ *     <div>
+ *       Current: {locale}
+ *       Available: {languages.map(l => l.code).join(', ')}
+ *     </div>
+ *   )
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // For language switching with proper router navigation:
+ * import { useLocaleRouter } from '@better-i18n/use-intl'
+ *
+ * function LanguageSwitcher() {
+ *   const { locale, locales, navigate } = useLocaleRouter()
+ *   return (
+ *     <select value={locale} onChange={(e) => navigate(e.target.value)}>
+ *       {locales.map((loc) => <option key={loc} value={loc}>{loc}</option>)}
+ *     </select>
+ *   )
+ * }
+ * ```
+ */
+export declare function useBetterI18n(): BetterI18nContextValue;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,iBAAiB,wDAE7B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,aAAa,IAAI,sBAAsB,CAUtD"}

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,12 @@
+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 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;AAG7D,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,16 @@
+// 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";
+// 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;AAUnD,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"}