@better-i18n/use-intl 0.1.8 → 0.2.0

package/dist/provider.js

@@ -0,0 +1,138 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createI18nCore } from "@better-i18n/core";
+import { useEffect, useMemo, useState } from "react";
+import { IntlProvider } from "use-intl";
+import { BetterI18nContext } from "./context.js";
+/**
+ * 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 function BetterI18nProvider({ children, project, locale: propLocale, messages: propMessages, timeZone, now, onError, cdnBaseUrl, debug, logLevel, fetch: customFetch, storage, staticData, fetchTimeout, retryCount, initialLanguages, getMessageFallback: customGetMessageFallback, }) {
+    // Locale is controlled by props (from URL/router)
+    const locale = propLocale;
+    // clientMessages is only used in CSR mode (when propMessages is not provided).
+    // In SSG/SSR mode, propMessages comes from the loader and is used directly —
+    // synchronous derivation avoids the useEffect delay that causes white flash on hydration.
+    const [clientMessages, setClientMessages] = useState();
+    const messages = propMessages ?? clientMessages;
+    const [languages, setLanguages] = useState(initialLanguages ?? []);
+    const [isLoadingMessages, setIsLoadingMessages] = useState(propMessages === undefined);
+    const [isLoadingLanguages, setIsLoadingLanguages] = useState(!initialLanguages);
+    // Create i18n core instance
+    const i18nCore = useMemo(() => createI18nCore({
+        project,
+        defaultLocale: locale,
+        cdnBaseUrl,
+        debug,
+        logLevel,
+        fetch: customFetch,
+        storage,
+        staticData,
+        fetchTimeout,
+        retryCount,
+    }), [project, locale, cdnBaseUrl, debug, logLevel, customFetch, storage, staticData, fetchTimeout, retryCount]);
+    // Load languages on mount — skip if SSR already provided them
+    useEffect(() => {
+        if (initialLanguages)
+            return;
+        let cancelled = false;
+        const loadLanguages = async () => {
+            try {
+                const langs = await i18nCore.getLanguages();
+                if (!cancelled) {
+                    setLanguages(langs);
+                }
+            }
+            catch (error) {
+                console.error("[better-i18n] Failed to load languages:", error);
+            }
+            finally {
+                if (!cancelled) {
+                    setIsLoadingLanguages(false);
+                }
+            }
+        };
+        loadLanguages();
+        return () => {
+            cancelled = true;
+        };
+    }, [i18nCore, initialLanguages]);
+    // Load messages when locale changes and no pre-loaded messages available
+    useEffect(() => {
+        // Skip if we already have messages for this render
+        if (propMessages) {
+            return;
+        }
+        let cancelled = false;
+        const loadMessages = async () => {
+            setIsLoadingMessages(true);
+            try {
+                const msgs = await i18nCore.getMessages(locale);
+                if (!cancelled) {
+                    setClientMessages(msgs);
+                }
+            }
+            catch (error) {
+                console.error(`[better-i18n] Failed to load messages for locale "${locale}":`, error);
+            }
+            finally {
+                if (!cancelled) {
+                    setIsLoadingMessages(false);
+                }
+            }
+        };
+        loadMessages();
+        return () => {
+            cancelled = true;
+        };
+    }, [locale, i18nCore, propMessages]);
+    // Context value (read-only locale - use useLocaleRouter for navigation)
+    const contextValue = useMemo(() => ({
+        locale,
+        languages,
+        isLoadingLanguages,
+        isLoadingMessages,
+        project,
+    }), [locale, languages, isLoadingLanguages, isLoadingMessages, project]);
+    if (!messages) {
+        // Render children with empty messages instead of blanking the screen.
+        // This converts a full DOM structural mismatch (null vs full tree)
+        // into a text content mismatch — React recovers silently and re-renders
+        // once the loader delivers real messages.
+        return (_jsx(BetterI18nContext.Provider, { value: contextValue, children: _jsx(IntlProvider, { locale: locale, messages: {}, timeZone: timeZone, onError: () => { }, getMessageFallback: customGetMessageFallback, children: children }) }));
+    }
+    return (_jsx(BetterI18nContext.Provider, { value: contextValue, children: _jsx(IntlProvider, { locale: locale, messages: messages, timeZone: timeZone, now: now, onError: onError ?? (() => { }), getMessageFallback: customGetMessageFallback, children: children }) }));
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,79 @@
+import type { I18nCoreConfig, LanguageOption } from "@better-i18n/core";
+import { createFormatter } from "use-intl/core";
+import type { Messages } from "./types.js";
+export interface GetMessagesConfig extends Omit<I18nCoreConfig, "defaultLocale"> {
+    /**
+     * Locale to fetch messages for
+     */
+    locale: string;
+}
+/**
+ * Fetch messages for a locale (server-side)
+ */
+export declare function getMessages(config: GetMessagesConfig): Promise<Messages>;
+/**
+ * Fetch available locales (server-side)
+ */
+export declare function getLocales(config: Omit<I18nCoreConfig, "defaultLocale"> & {
+    defaultLocale?: string;
+}): Promise<string[]>;
+/**
+ * Fetch available languages with metadata (server-side)
+ */
+export declare function getLanguages(config: Omit<I18nCoreConfig, "defaultLocale"> & {
+    defaultLocale?: string;
+}): Promise<LanguageOption[]>;
+/**
+ * Create a translator function for use outside React (server-side)
+ */
+export declare function createServerTranslator(config: {
+    locale: string;
+    messages: Messages;
+    namespace?: string;
+}): import("use-intl")._Translator<{
+    [x: string]: any;
+}, string>;
+/**
+ * Create a formatter for use outside React (server-side)
+ */
+export declare function createServerFormatter(config: {
+    locale: string;
+    timeZone?: string;
+    now?: Date;
+}): ReturnType<typeof createFormatter>;
+export { createTranslator, createFormatter } from "use-intl/core";
+/**
+ * Parse an RFC 5646 Accept-Language header value into a prioritized list of language tags.
+ *
+ * @example
+ * parseAcceptLanguage("tr-TR,tr;q=0.9,en-US;q=0.8,en;q=0.7")
+ * // → ["tr-TR", "tr", "en-US", "en"]
+ */
+export declare function parseAcceptLanguage(header: string | null | undefined): string[];
+/**
+ * Find the best matching locale from a parsed language list against available locales.
+ * Matching strategy (in order):
+ * 1. Exact match: "tr-TR" → "tr-TR"
+ * 2. Base language match: "tr-TR" → "tr"
+ * 3. Region expansion: "tr" matches "tr-TR" (first available variant)
+ *
+ * Returns null if no match found.
+ */
+export declare function matchLocale(languages: string[], availableLocales: string[]): string | null;
+/**
+ * Detect best locale from Accept-Language header (server) or navigator.languages (client).
+ *
+ * - Server (Web Request): reads `request.headers.get('accept-language')`
+ * - Server (Express/Hono/etc.): pass `acceptLanguage` header string directly
+ * - Client: reads `navigator.languages` / `navigator.language`
+ *
+ * Falls back to `defaultLocale` if no match is found.
+ */
+export declare function detectLocale(options: {
+    request?: Request | null;
+    /** Directly pass an Accept-Language header string (e.g. from Express/Hono req.headers) */
+    acceptLanguage?: string | null;
+    availableLocales: string[];
+    defaultLocale: string;
+}): string;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAoB,MAAM,eAAe,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAC7C,cAAc,EACd,eAAe,CAChB;IACC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,QAAQ,CAAC,CAqBnB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,GAAG;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GACzE,OAAO,CAAC,MAAM,EAAE,CAAC,CAenB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,GAAG;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GACzE,OAAO,CAAC,cAAc,EAAE,CAAC,CAe3B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;;WAQA;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAMrC;AAED,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAElE;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,CAoB/E;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EAAE,EACnB,gBAAgB,EAAE,MAAM,EAAE,GACzB,MAAM,GAAG,IAAI,CAcf;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE;IACpC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,0FAA0F;IAC1F,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,MAAM,CAiBT"}

package/dist/server.js

@@ -0,0 +1,156 @@
+import { createI18nCore } from "@better-i18n/core";
+import { createFormatter, createTranslator } from "use-intl/core";
+/**
+ * Fetch messages for a locale (server-side)
+ */
+export async function getMessages(config) {
+    const i18n = createI18nCore({
+        project: config.project,
+        defaultLocale: config.locale,
+        cdnBaseUrl: config.cdnBaseUrl,
+        debug: config.debug,
+        logLevel: config.logLevel,
+        fetch: config.fetch,
+        storage: config.storage,
+        staticData: config.staticData,
+        fetchTimeout: config.fetchTimeout,
+        retryCount: config.retryCount,
+    });
+    const messages = (await i18n.getMessages(config.locale));
+    // better-i18n convention: JSON matches exact namespace structure.
+    // if CDN returns { "hero": { "title": "..." } }, use-intl expects exactly that
+    // if it's deeply nested, use-intl also handles nested objects.
+    return messages;
+}
+/**
+ * Fetch available locales (server-side)
+ */
+export async function getLocales(config) {
+    const i18n = createI18nCore({
+        project: config.project,
+        defaultLocale: config.defaultLocale || "en",
+        cdnBaseUrl: config.cdnBaseUrl,
+        debug: config.debug,
+        logLevel: config.logLevel,
+        fetch: config.fetch,
+        storage: config.storage,
+        staticData: config.staticData,
+        fetchTimeout: config.fetchTimeout,
+        retryCount: config.retryCount,
+    });
+    return i18n.getLocales();
+}
+/**
+ * Fetch available languages with metadata (server-side)
+ */
+export async function getLanguages(config) {
+    const i18n = createI18nCore({
+        project: config.project,
+        defaultLocale: config.defaultLocale || "en",
+        cdnBaseUrl: config.cdnBaseUrl,
+        debug: config.debug,
+        logLevel: config.logLevel,
+        fetch: config.fetch,
+        storage: config.storage,
+        staticData: config.staticData,
+        fetchTimeout: config.fetchTimeout,
+        retryCount: config.retryCount,
+    });
+    return i18n.getLanguages();
+}
+/**
+ * Create a translator function for use outside React (server-side)
+ */
+export function createServerTranslator(config) {
+    return createTranslator({
+        locale: config.locale,
+        messages: config.messages,
+        namespace: config.namespace,
+    });
+}
+/**
+ * Create a formatter for use outside React (server-side)
+ */
+export function createServerFormatter(config) {
+    return createFormatter({
+        locale: config.locale,
+        timeZone: config.timeZone,
+        now: config.now,
+    });
+}
+export { createTranslator, createFormatter } from "use-intl/core";
+/**
+ * Parse an RFC 5646 Accept-Language header value into a prioritized list of language tags.
+ *
+ * @example
+ * parseAcceptLanguage("tr-TR,tr;q=0.9,en-US;q=0.8,en;q=0.7")
+ * // → ["tr-TR", "tr", "en-US", "en"]
+ */
+export function parseAcceptLanguage(header) {
+    if (!header)
+        return [];
+    return (header
+        .split(",")
+        .map((entry) => {
+        const [tag, qPart] = entry.trim().split(";");
+        const language = tag?.trim();
+        if (!language || language === "*")
+            return null;
+        const q = qPart ? parseFloat(qPart.trim().replace("q=", "")) : 1.0;
+        const quality = Number.isNaN(q) ? 1.0 : q;
+        return { language, quality };
+    })
+        .filter((item) => item !== null)
+        .sort((a, b) => b.quality - a.quality)
+        .map((item) => item.language));
+}
+/**
+ * Find the best matching locale from a parsed language list against available locales.
+ * Matching strategy (in order):
+ * 1. Exact match: "tr-TR" → "tr-TR"
+ * 2. Base language match: "tr-TR" → "tr"
+ * 3. Region expansion: "tr" matches "tr-TR" (first available variant)
+ *
+ * Returns null if no match found.
+ */
+export function matchLocale(languages, availableLocales) {
+    for (const lang of languages) {
+        if (availableLocales.includes(lang))
+            return lang;
+        const base = lang.split("-")[0];
+        if (base && availableLocales.includes(base))
+            return base;
+        const expanded = availableLocales.find((l) => l === base || l.startsWith(`${base}-`));
+        if (expanded)
+            return expanded;
+    }
+    return null;
+}
+/**
+ * Detect best locale from Accept-Language header (server) or navigator.languages (client).
+ *
+ * - Server (Web Request): reads `request.headers.get('accept-language')`
+ * - Server (Express/Hono/etc.): pass `acceptLanguage` header string directly
+ * - Client: reads `navigator.languages` / `navigator.language`
+ *
+ * Falls back to `defaultLocale` if no match is found.
+ */
+export function detectLocale(options) {
+    const languages = [];
+    if (options.request) {
+        languages.push(...parseAcceptLanguage(options.request.headers.get("accept-language")));
+    }
+    else if (options.acceptLanguage !== undefined) {
+        languages.push(...parseAcceptLanguage(options.acceptLanguage));
+    }
+    else if (typeof navigator !== "undefined") {
+        const navLangs = Array.isArray(navigator.languages)
+            ? [...navigator.languages]
+            : navigator.language
+                ? [navigator.language]
+                : [];
+        languages.push(...navLangs);
+    }
+    return matchLocale(languages, options.availableLocales) ?? options.defaultLocale;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,71 @@
+import type { I18nCoreConfig, LanguageOption } from "@better-i18n/core";
+import type { ComponentProps } from "react";
+import type { IntlProvider } from "use-intl";
+/**
+ * Messages type (compatible with use-intl)
+ */
+export type Messages = ComponentProps<typeof IntlProvider>["messages"];
+/**
+ * Configuration for BetterI18nProvider
+ */
+export interface BetterI18nProviderConfig extends Omit<I18nCoreConfig, "defaultLocale"> {
+    /**
+     * Current locale
+     */
+    locale: string;
+    /**
+     * Pre-loaded messages (for SSR hydration)
+     */
+    messages?: Messages;
+    /**
+     * Timezone for date/time formatting
+     * @default undefined (uses browser timezone)
+     */
+    timeZone?: string;
+    /**
+     * Current date/time (useful for SSR to prevent hydration mismatches)
+     */
+    now?: Date;
+    /**
+     * Error handler for missing translations
+     */
+    onError?: ComponentProps<typeof IntlProvider>["onError"];
+}
+/**
+ * Better i18n context value
+ *
+ * Note: Locale is read-only. Use useLocaleRouter().navigate() for locale changes
+ * to ensure proper router integration.
+ */
+export interface BetterI18nContextValue {
+    /**
+     * Current locale (read-only - use useLocaleRouter().navigate() to change)
+     */
+    locale: string;
+    /**
+     * Available languages with metadata from CDN manifest
+     */
+    languages: LanguageOption[];
+    /**
+     * Whether languages are still loading from CDN
+     */
+    isLoadingLanguages: boolean;
+    /**
+     * Whether messages are still loading
+     */
+    isLoadingMessages: boolean;
+    /**
+     * Project identifier
+     */
+    project: string;
+}
+/**
+ * Server-side configuration for getMessages
+ */
+export interface GetMessagesConfig extends I18nCoreConfig {
+    /**
+     * Locale to fetch messages for
+     */
+    locale: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,YAAY,CAAC,CAAC,UAAU,CAAC,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,wBACf,SAAQ,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC;IAC7C;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,GAAG,CAAC,EAAE,IAAI,CAAC;IAEX;;OAEG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC,OAAO,YAAY,CAAC,CAAC,SAAS,CAAC,CAAC;CAC1D;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,SAAS,EAAE,cAAc,EAAE,CAAC;IAE5B;;OAEG;IACH,kBAAkB,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,iBAAiB,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@better-i18n/use-intl",
-  "version": "0.1.8",
+  "version": "0.2.0",
   "description": "Better i18n integration for use-intl (React, TanStack Start)",
   "license": "MIT",
   "repository": {
@@ -13,16 +13,28 @@
   },
   "homepage": "https://github.com/better-i18n/better-i18n/tree/main/packages/use-intl",
   "type": "module",
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts",
-    "./server": "./src/server.ts",
-    "./middleware": "./src/middleware/index.ts",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "bun": "./src/index.ts",
+      "default": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "bun": "./src/server.ts",
+      "default": "./dist/server.js"
+    },
+    "./middleware": {
+      "types": "./dist/middleware/index.d.ts",
+      "bun": "./src/middleware/index.ts",
+      "default": "./dist/middleware/index.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
-    "src",
+    "dist",
     "package.json",
     "README.md"
   ],
@@ -41,10 +53,11 @@
   "scripts": {
     "build": "tsc",
     "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist"
+    "clean": "rm -rf dist",
+    "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@better-i18n/core": "0.1.8"
+    "@better-i18n/core": "^0.3.0"
   },
   "peerDependencies": {
     "react": ">=18.0.0",

package/src/components.tsx

@@ -1,76 +0,0 @@
-"use client";
-
-import type { ComponentProps, ReactNode } from "react";
-import { useLocaleRouter } from "./hooks/useLocaleRouter";
-import { useLanguages } from "./hooks";
-
-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 function LanguageSwitcher({
-  renderOption,
-  loadingLabel = "Loading...",
-  ...props
-}: LanguageSwitcherProps) {
-  const { locale, navigate, isReady } = useLocaleRouter();
-  const { languages } = useLanguages();
-
-  if (!isReady) {
-    return (
-      <select disabled {...props}>
-        <option>{loadingLabel}</option>
-      </select>
-    );
-  }
-
-  return (
-    <select value={locale} onChange={(e) => navigate(e.target.value)} {...props}>
-      {languages.map((lang) => (
-        <option key={lang.code} value={lang.code}>
-          {renderOption ? renderOption(lang) : lang.nativeName || lang.code}
-        </option>
-      ))}
-    </select>
-  );
-}