@better-i18n/use-intl 0.1.8 → 0.2.0

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/locale-dropdown.d.ts

@@ -0,0 +1,62 @@
+import { type ReactNode } from "react";
+import type { LanguageOption } from "@better-i18n/core";
+import { type ResolvedFlag } from "@better-i18n/core";
+export interface LocaleDropdownRenderContext {
+    language: LanguageOption;
+    isActive: boolean;
+    flag: ResolvedFlag;
+    label: string;
+}
+export interface LocaleDropdownProps {
+    /** Display variant. "styled" = inline styles + CSS custom properties, "unstyled" = no styles (data attributes only). @default "styled" */
+    variant?: "styled" | "unstyled";
+    /** Additional className on the root wrapper. */
+    className?: string;
+    /** Additional className on the trigger button. */
+    triggerClassName?: string;
+    /** Additional className on the dropdown menu. */
+    menuClassName?: string;
+    /** Show flag icon/emoji. @default true */
+    showFlag?: boolean;
+    /** Show native language name. @default true */
+    showNativeName?: boolean;
+    /** Show locale code (e.g., "EN"). @default true */
+    showLocaleCode?: boolean;
+    /** Custom render for the trigger button. */
+    renderTrigger?: (ctx: {
+        language: LanguageOption | undefined;
+        isOpen: boolean;
+        isLoading: boolean;
+        flag: ResolvedFlag | null;
+        label: string;
+    }) => ReactNode;
+    /** Custom render for each menu item. */
+    renderItem?: (ctx: LocaleDropdownRenderContext) => ReactNode;
+}
+/**
+ * Styled locale dropdown with flag icons, keyboard navigation, and
+ * full CSS customization via custom properties or data attributes.
+ *
+ * Uses `useLocaleRouter()` and `useLanguages()` internally — works
+ * out of the box inside `<BetterI18nProvider>` with TanStack Router.
+ *
+ * @example
+ * ```tsx
+ * // Zero config — styled mode
+ * <LocaleDropdown />
+ *
+ * // Headless mode for full custom styling
+ * <LocaleDropdown variant="unstyled" className="my-dropdown" />
+ *
+ * // Custom render
+ * <LocaleDropdown
+ *   renderItem={({ language, isActive, flag, label }) => (
+ *     <div className={isActive ? "active" : ""}>
+ *       {flag.type === "emoji" ? flag.emoji : null} {label}
+ *     </div>
+ *   )}
+ * />
+ * ```
+ */
+export declare function LocaleDropdown({ variant, className, triggerClassName, menuClassName, showFlag, showNativeName, showLocaleCode, renderTrigger, renderItem, }: LocaleDropdownProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=locale-dropdown.d.ts.map

package/dist/components/locale-dropdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-dropdown.d.ts","sourceRoot":"","sources":["../../src/components/locale-dropdown.tsx"],"names":[],"mappings":"AAEA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAC;AA+N3B,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,0IAA0I;IAC1I,OAAO,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IAChC,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mDAAmD;IACnD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE;QACpB,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAC;QACrC,MAAM,EAAE,OAAO,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC;QACnB,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;QAC1B,KAAK,EAAE,MAAM,CAAC;KACf,KAAK,SAAS,CAAC;IAChB,wCAAwC;IACxC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,2BAA2B,KAAK,SAAS,CAAC;CAC9D;AAID;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,CAAC,EAC7B,OAAkB,EAClB,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,QAAe,EACf,cAAqB,EACrB,cAAqB,EACrB,aAAa,EACb,UAAU,GACX,EAAE,mBAAmB,2CAuRrB"}

package/dist/components/locale-dropdown.js

@@ -0,0 +1,298 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useMemo, useRef, useState, } from "react";
+import { getLanguageLabel, resolveFlag, } from "@better-i18n/core";
+import { useLocaleRouter } from "../hooks/useLocaleRouter.js";
+import { useLanguages } from "../hooks.js";
+// ─── Inline SVG Icons ────────────────────────────────────────────────
+function GlobeIcon() {
+    return (_jsxs("svg", { width: "16", height: "16", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "square", "aria-hidden": "true", children: [_jsx("path", { d: "M21 12C21 16.9706 16.9706 21 12 21C7.02944 21 3 16.9706 3 12C3 7.02944 7.02944 3 12 3C16.9706 3 21 7.02944 21 12Z" }), _jsx("path", { d: "M21 12H3" }), _jsx("path", { d: "M12 21C10.067 21 8.5 16.9706 8.5 12C8.5 7.02944 10.067 3 12 3C13.933 3 15.5 7.02944 15.5 12C15.5 16.9706 13.933 21 12 21Z" })] }));
+}
+function ChevronDownIcon({ style }) {
+    return (_jsx("svg", { width: "16", height: "16", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", style: style, children: _jsx("path", { d: "M20 9L13.4142 15.5858C12.6332 16.3668 11.3669 16.3668 10.5858 15.5858L4 9" }) }));
+}
+function CheckIcon() {
+    return (_jsx("svg", { width: "16", height: "16", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: _jsx("path", { d: "M6 12l4.243 4.243L18.485 8" }) }));
+}
+// ─── Flag Component ──────────────────────────────────────────────────
+function FlagDisplay({ flag, label, }) {
+    const [hasError, setHasError] = useState(false);
+    useEffect(() => {
+        setHasError(false);
+    }, [flag.type === "url" ? flag.url : null]);
+    if (flag.type === "url" && !hasError) {
+        return (_jsx("img", { src: flag.url, alt: label, style: { width: 20, height: 16, borderRadius: 2, objectFit: "cover" }, loading: "lazy", onError: () => setHasError(true) }));
+    }
+    if (flag.type === "emoji" || (flag.type === "url" && hasError)) {
+        const emoji = flag.type === "emoji" ? flag.emoji : null;
+        if (emoji) {
+            return (_jsx("span", { style: {
+                    display: "inline-flex",
+                    alignItems: "center",
+                    justifyContent: "center",
+                    width: 20,
+                    height: 16,
+                    fontSize: 14,
+                    lineHeight: 1,
+                }, "aria-hidden": "true", children: emoji }));
+        }
+    }
+    return (_jsx("span", { style: { color: "var(--better-locale-code-text, #9ca3af)" }, children: _jsx(GlobeIcon, {}) }));
+}
+// ─── Styles ──────────────────────────────────────────────────────────
+const styles = {
+    trigger: {
+        display: "inline-flex",
+        alignItems: "center",
+        gap: 8,
+        padding: "var(--better-locale-trigger-padding, 6px 10px)",
+        borderRadius: "var(--better-locale-trigger-radius, 8px)",
+        border: "var(--better-locale-trigger-border, 1px solid transparent)",
+        background: "var(--better-locale-trigger-bg, transparent)",
+        color: "var(--better-locale-text, #374151)",
+        fontSize: 14,
+        fontWeight: 500,
+        cursor: "pointer",
+        transition: "background 0.15s, border-color 0.15s",
+        lineHeight: 1,
+        fontFamily: "inherit",
+    },
+    triggerDisabled: {
+        opacity: 0.7,
+        cursor: "default",
+    },
+    menu: {
+        position: "absolute",
+        right: 0,
+        top: "calc(100% + 4px)",
+        minWidth: 200,
+        maxHeight: "70vh",
+        overflowY: "auto",
+        borderRadius: 12,
+        border: "1px solid var(--better-locale-border, #e5e7eb)",
+        background: "var(--better-locale-menu-bg, #ffffff)",
+        boxShadow: "0 4px 24px rgba(0, 0, 0, 0.12)",
+        padding: 0,
+        zIndex: 50,
+        listStyle: "none",
+        margin: 0,
+    },
+    item: {
+        display: "flex",
+        alignItems: "center",
+        gap: 12,
+        width: "100%",
+        padding: "8px 14px",
+        border: "none",
+        background: "transparent",
+        color: "var(--better-locale-text, #374151)",
+        fontSize: 14,
+        cursor: "pointer",
+        transition: "background 0.1s",
+        textAlign: "left",
+        fontFamily: "inherit",
+        lineHeight: 1.2,
+    },
+    itemActive: {
+        background: "var(--better-locale-active-bg, #f9fafb)",
+    },
+    itemHovered: {
+        background: "var(--better-locale-hover-bg, #f3f4f6)",
+    },
+    label: {
+        flex: 1,
+        textAlign: "left",
+    },
+    code: {
+        fontSize: 10,
+        fontFamily: "monospace",
+        textTransform: "uppercase",
+        color: "var(--better-locale-code-text, #9ca3af)",
+        letterSpacing: "0.05em",
+    },
+    check: {
+        color: "var(--better-locale-accent, currentColor)",
+        flexShrink: 0,
+    },
+    skeleton: {
+        display: "inline-flex",
+        alignItems: "center",
+        gap: 8,
+        padding: "6px 10px",
+        borderRadius: 8,
+        border: "1px solid transparent",
+        background: "transparent",
+    },
+    skeletonFlag: {
+        width: 20,
+        height: 18,
+        borderRadius: 3,
+        background: "var(--better-locale-border, #e5e7eb)",
+        animation: "better-locale-pulse 1.5s ease-in-out infinite",
+        flexShrink: 0,
+    },
+    skeletonText: {
+        width: 56,
+        height: 18,
+        borderRadius: 4,
+        background: "var(--better-locale-border, #e5e7eb)",
+        animation: "better-locale-pulse 1.5s ease-in-out infinite",
+    },
+};
+// ─── Component ───────────────────────────────────────────────────────
+/**
+ * Styled locale dropdown with flag icons, keyboard navigation, and
+ * full CSS customization via custom properties or data attributes.
+ *
+ * Uses `useLocaleRouter()` and `useLanguages()` internally — works
+ * out of the box inside `<BetterI18nProvider>` with TanStack Router.
+ *
+ * @example
+ * ```tsx
+ * // Zero config — styled mode
+ * <LocaleDropdown />
+ *
+ * // Headless mode for full custom styling
+ * <LocaleDropdown variant="unstyled" className="my-dropdown" />
+ *
+ * // Custom render
+ * <LocaleDropdown
+ *   renderItem={({ language, isActive, flag, label }) => (
+ *     <div className={isActive ? "active" : ""}>
+ *       {flag.type === "emoji" ? flag.emoji : null} {label}
+ *     </div>
+ *   )}
+ * />
+ * ```
+ */
+export function LocaleDropdown({ variant = "styled", className, triggerClassName, menuClassName, showFlag = true, showNativeName = true, showLocaleCode = true, renderTrigger, renderItem, }) {
+    const { locale, navigate, isReady } = useLocaleRouter();
+    const { languages, isLoading } = useLanguages();
+    const [isOpen, setIsOpen] = useState(false);
+    const [focusIndex, setFocusIndex] = useState(-1);
+    const containerRef = useRef(null);
+    const menuRef = useRef(null);
+    const isStyled = variant === "styled";
+    const currentLanguage = useMemo(() => languages.find((l) => l.code === locale), [languages, locale]);
+    const currentLabel = currentLanguage
+        ? getLanguageLabel(currentLanguage)
+        : locale.toUpperCase();
+    const currentFlag = currentLanguage ? resolveFlag(currentLanguage) : null;
+    const canToggle = languages.length > 1;
+    // Close on outside click
+    useEffect(() => {
+        if (!isOpen)
+            return;
+        function handleClick(e) {
+            if (containerRef.current &&
+                !containerRef.current.contains(e.target)) {
+                setIsOpen(false);
+            }
+        }
+        document.addEventListener("mousedown", handleClick);
+        return () => document.removeEventListener("mousedown", handleClick);
+    }, [isOpen]);
+    // Keyboard navigation
+    const handleKeyDown = useCallback((e) => {
+        if (!isOpen) {
+            if (e.key === "ArrowDown" || e.key === "Enter" || e.key === " ") {
+                e.preventDefault();
+                setIsOpen(true);
+                setFocusIndex(0);
+            }
+            return;
+        }
+        switch (e.key) {
+            case "Escape":
+                e.preventDefault();
+                setIsOpen(false);
+                setFocusIndex(-1);
+                break;
+            case "ArrowDown":
+                e.preventDefault();
+                setFocusIndex((prev) => prev < languages.length - 1 ? prev + 1 : 0);
+                break;
+            case "ArrowUp":
+                e.preventDefault();
+                setFocusIndex((prev) => prev > 0 ? prev - 1 : languages.length - 1);
+                break;
+            case "Enter":
+            case " ": {
+                e.preventDefault();
+                const lang = languages[focusIndex];
+                if (lang) {
+                    navigate(lang.code);
+                    setIsOpen(false);
+                    setFocusIndex(-1);
+                }
+                break;
+            }
+            case "Home":
+                e.preventDefault();
+                setFocusIndex(0);
+                break;
+            case "End":
+                e.preventDefault();
+                setFocusIndex(languages.length - 1);
+                break;
+        }
+    }, [isOpen, focusIndex, languages, navigate]);
+    // Scroll focused item into view
+    useEffect(() => {
+        if (focusIndex >= 0 && menuRef.current) {
+            const items = menuRef.current.querySelectorAll("[data-better-locale-item]");
+            items[focusIndex]?.scrollIntoView({ block: "nearest" });
+        }
+    }, [focusIndex]);
+    // Loading skeleton
+    if (!isReady || isLoading) {
+        if (renderTrigger) {
+            return (_jsx("div", { "data-better-locale-dropdown": true, className: className, children: renderTrigger({
+                    language: undefined,
+                    isOpen: false,
+                    isLoading: true,
+                    flag: null,
+                    label: "",
+                }) }));
+        }
+        return (_jsxs("div", { "data-better-locale-dropdown": true, className: className, children: [_jsxs("div", { "aria-busy": "true", "data-better-locale-trigger": true, className: triggerClassName, style: isStyled ? styles.skeleton : undefined, children: [_jsx("span", { style: isStyled ? styles.skeletonFlag : undefined }), _jsx("span", { style: isStyled ? styles.skeletonText : undefined })] }), isStyled && (_jsx("style", { children: `@keyframes better-locale-pulse { 0%, 100% { opacity: 1; } 50% { opacity: 0.4; } }` }))] }));
+    }
+    return (_jsxs("div", { ref: containerRef, "data-better-locale-dropdown": true, className: className, style: { position: "relative", display: "inline-block" }, children: [renderTrigger ? (_jsx("div", { onClick: () => canToggle && setIsOpen(!isOpen), onKeyDown: handleKeyDown, role: "button", tabIndex: 0, "aria-haspopup": "listbox", "aria-expanded": isOpen, "data-better-locale-trigger": true, className: triggerClassName, children: renderTrigger({
+                    language: currentLanguage,
+                    isOpen,
+                    isLoading: false,
+                    flag: currentFlag,
+                    label: currentLabel,
+                }) })) : (_jsxs("button", { type: "button", onClick: () => canToggle && setIsOpen(!isOpen), onKeyDown: handleKeyDown, "aria-haspopup": "listbox", "aria-expanded": isOpen, "aria-label": "Select language", disabled: !canToggle, "data-better-locale-trigger": true, className: triggerClassName, style: isStyled
+                    ? {
+                        ...styles.trigger,
+                        ...(!canToggle ? styles.triggerDisabled : {}),
+                    }
+                    : undefined, children: [showFlag && currentFlag && (_jsx(FlagDisplay, { flag: currentFlag, label: currentLabel })), showNativeName && _jsx("span", { children: currentLabel }), canToggle && (_jsx(ChevronDownIcon, { style: {
+                            transition: "transform 0.2s",
+                            transform: isOpen ? "rotate(180deg)" : "rotate(0deg)",
+                            color: "var(--better-locale-code-text, #9ca3af)",
+                        } }))] })), isOpen && canToggle && (_jsx("ul", { ref: menuRef, role: "listbox", "aria-label": "Available languages", "data-better-locale-menu": true, className: menuClassName, style: isStyled ? styles.menu : undefined, children: languages.map((language, index) => {
+                    const label = getLanguageLabel(language);
+                    const isActive = language.code === locale;
+                    const isFocused = index === focusIndex;
+                    const flag = resolveFlag(language);
+                    if (renderItem) {
+                        return (_jsx("li", { role: "option", "aria-selected": isActive, "data-better-locale-item": true, "data-active": isActive || undefined, "data-focused": isFocused || undefined, onClick: () => {
+                                navigate(language.code);
+                                setIsOpen(false);
+                            }, onMouseEnter: () => setFocusIndex(index), style: { cursor: "pointer" }, children: renderItem({ language, isActive, flag, label }) }, language.code));
+                    }
+                    return (_jsxs("li", { role: "option", "aria-selected": isActive, "data-better-locale-item": true, "data-active": isActive || undefined, "data-focused": isFocused || undefined, onClick: () => {
+                            navigate(language.code);
+                            setIsOpen(false);
+                        }, onMouseEnter: () => setFocusIndex(index), style: isStyled
+                            ? {
+                                ...styles.item,
+                                ...(isActive ? styles.itemActive : {}),
+                                ...(isFocused ? styles.itemHovered : {}),
+                            }
+                            : undefined, children: [showFlag && _jsx(FlagDisplay, { flag: flag, label: label }), _jsx("span", { style: isStyled ? styles.label : undefined, children: showNativeName ? label : language.code.toUpperCase() }), showLocaleCode && (_jsx("span", { style: isStyled ? styles.code : undefined, children: language.code })), isActive && (_jsx("span", { style: isStyled ? styles.check : undefined, children: _jsx(CheckIcon, {}) }))] }, language.code));
+                }) })), isStyled && isOpen && (_jsx("style", { children: `@keyframes better-locale-pulse { 0%, 100% { opacity: 1; } 50% { opacity: 0.5; } }` }))] }));
+}
+//# sourceMappingURL=locale-dropdown.js.map

package/dist/components/locale-dropdown.js.map

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