@better-i18n/use-intl 0.1.0

package/README.md

@@ -0,0 +1,221 @@
+# @better-i18n/use-intl
+
+Better i18n integration for [use-intl](https://github.com/amannn/next-intl/tree/main/packages/use-intl) - perfect for React, TanStack Start, and any JavaScript framework.
+
+## Features
+
+- 🚀 **CDN-powered** - Fetch translations from Better i18n CDN
+- ⚡ **SSR Ready** - Full server-side rendering support for TanStack Start
+- 🔄 **Dynamic Loading** - Load messages on-demand per locale
+- 🎯 **Type Safe** - Full TypeScript support
+- 🪶 **Lightweight** - Built on use-intl (~2KB)
+
+## Installation
+
+```bash
+npm install @better-i18n/use-intl use-intl
+# or
+bun add @better-i18n/use-intl use-intl
+```
+
+## Quick Start
+
+### Client-Side (CSR)
+
+```tsx
+import { BetterI18nProvider, useTranslations } from '@better-i18n/use-intl'
+
+function App() {
+  return (
+    <BetterI18nProvider
+      project="your-org/your-project"
+      locale="en"
+    >
+      <HomePage />
+    </BetterI18nProvider>
+  )
+}
+
+function HomePage() {
+  const t = useTranslations('home')
+  return <h1>{t('title')}</h1>
+}
+```
+
+### Server-Side (TanStack Start)
+
+```tsx
+// routes/__root.tsx
+import { createRootRoute } from '@tanstack/react-router'
+import { BetterI18nProvider } from '@better-i18n/use-intl'
+import { getMessages } from '@better-i18n/use-intl/server'
+
+export const Route = createRootRoute({
+  loader: async ({ context }) => {
+    const messages = await getMessages({
+      project: 'your-org/your-project',
+      locale: context.locale,
+    })
+    return { messages }
+  },
+  component: RootComponent,
+})
+
+function RootComponent() {
+  const { messages } = Route.useLoaderData()
+  const { locale } = Route.useRouteContext()
+
+  return (
+    <BetterI18nProvider
+      project="your-org/your-project"
+      locale={locale}
+      messages={messages}
+    >
+      <Outlet />
+    </BetterI18nProvider>
+  )
+}
+```
+
+## API Reference
+
+### Components
+
+#### `<BetterI18nProvider>`
+
+Main provider that combines Better i18n CDN with use-intl.
+
+```tsx
+<BetterI18nProvider
+  project="org/project"    // Required: Better i18n project
+  locale="en"              // Required: Current locale
+  messages={messages}      // Optional: Pre-loaded messages (SSR)
+  timeZone="Europe/Berlin" // Optional: Timezone for formatting
+  now={new Date()}         // Optional: Current time (SSR)
+  onLocaleChange={(l) => {}} // Optional: Locale change callback
+>
+  {children}
+</BetterI18nProvider>
+```
+
+### Hooks
+
+#### `useTranslations(namespace?)`
+
+Access translations (re-exported from use-intl).
+
+```tsx
+const t = useTranslations('common')
+t('greeting', { name: 'World' }) // "Hello, World!"
+```
+
+#### `useLocale()`
+
+Get and set the current locale.
+
+```tsx
+const { locale, setLocale, isLoading } = useLocale()
+```
+
+#### `useLanguages()`
+
+Get available languages with metadata.
+
+```tsx
+const { languages, isLoading } = useLanguages()
+// [{ code: 'en', name: 'English', nativeName: 'English', flagUrl: '...' }]
+```
+
+#### `useBetterI18n()`
+
+Access the full Better i18n context.
+
+```tsx
+const { locale, setLocale, languages, isLoadingMessages, project } = useBetterI18n()
+```
+
+#### `useFormatter()`
+
+Format dates, numbers, and lists (re-exported from use-intl).
+
+```tsx
+const format = useFormatter()
+format.dateTime(new Date(), { dateStyle: 'full' })
+format.number(1000, { style: 'currency', currency: 'USD' })
+```
+
+### Server Utilities
+
+Import from `@better-i18n/use-intl/server`:
+
+#### `getMessages(config)`
+
+Fetch messages for SSR.
+
+```ts
+const messages = await getMessages({
+  project: 'org/project',
+  locale: 'en',
+})
+```
+
+#### `getLocales(config)`
+
+Get available locale codes.
+
+```ts
+const locales = await getLocales({ project: 'org/project' })
+// ['en', 'tr', 'de']
+```
+
+#### `getLanguages(config)`
+
+Get languages with metadata.
+
+```ts
+const languages = await getLanguages({ project: 'org/project' })
+```
+
+#### `createServerTranslator(config)`
+
+Create translator for non-React contexts (metadata, emails).
+
+```ts
+const t = createServerTranslator({ locale: 'en', messages })
+const title = t('page.title')
+```
+
+## Language Switcher Example
+
+```tsx
+import { useLocale, useLanguages } from '@better-i18n/use-intl'
+
+function LanguageSwitcher() {
+  const { locale, setLocale } = useLocale()
+  const { languages, isLoading } = useLanguages()
+
+  if (isLoading) return <span>Loading...</span>
+
+  return (
+    <select value={locale} onChange={(e) => setLocale(e.target.value)}>
+      {languages.map((lang) => (
+        <option key={lang.code} value={lang.code}>
+          {lang.nativeName}
+        </option>
+      ))}
+    </select>
+  )
+}
+```
+
+## TanStack Start Full Example
+
+See our [TanStack Start guide](/docs/react/tanstack-start) for a complete example with:
+- Locale middleware
+- URL-based locale detection
+- SEO-friendly routing
+- Hydration without mismatches
+
+## License
+
+MIT

package/dist/components.d.ts

@@ -0,0 +1,40 @@
+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;
+    }) => ReactNode;
+    /**
+     * Label for loading state
+     */
+    loadingLabel?: string;
+}
+/**
+ * Pre-built language switcher component
+ *
+ * @example
+ * ```tsx
+ * // Basic usage
+ * <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;AAGvD,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;KACzB,KAAK,SAAS,CAAC;IAEhB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,YAAY,EACZ,YAA2B,EAC3B,GAAG,KAAK,EACT,EAAE,qBAAqB,2CAoBvB"}

package/dist/components.js

@@ -0,0 +1,33 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useBetterI18n } from "./context";
+/**
+ * Pre-built language switcher component
+ *
+ * @example
+ * ```tsx
+ * // Basic usage
+ * <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, setLocale, languages, isLoadingLanguages } = useBetterI18n();
+    if (isLoadingLanguages) {
+        return (_jsx("select", { disabled: true, ...props, children: _jsx("option", { children: loadingLabel }) }));
+    }
+    return (_jsx("select", { value: locale, onChange: (e) => setLocale(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,aAAa,EAAE,MAAM,WAAW,CAAC;AAoB1C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAC/B,YAAY,EACZ,YAAY,GAAG,YAAY,EAC3B,GAAG,KAAK,EACc;IACtB,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,kBAAkB,EAAE,GAAG,aAAa,EAAE,CAAC;IAE7E,IAAI,kBAAkB,EAAE,CAAC;QACvB,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,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAM,KAAK,YACzE,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,27 @@
+import type { BetterI18nContextValue } from "./types";
+/**
+ * Context for Better i18n specific state
+ */
+export declare const BetterI18nContext: import("react").Context<BetterI18nContextValue | null>;
+/**
+ * Hook to access Better i18n context
+ *
+ * @example
+ * ```tsx
+ * function LanguageSwitcher() {
+ *   const { locale, setLocale, languages } = useBetterI18n()
+ *
+ *   return (
+ *     <select value={locale} onChange={(e) => setLocale(e.target.value)}>
+ *       {languages.map((lang) => (
+ *         <option key={lang.code} value={lang.code}>
+ *           {lang.nativeName}
+ *         </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,SAAS,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,iBAAiB,wDAE7B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,IAAI,sBAAsB,CAUtD"}

package/dist/context.js

@@ -0,0 +1,34 @@
+"use client";
+import { createContext, useContext } from "react";
+/**
+ * Context for Better i18n specific state
+ */
+export const BetterI18nContext = createContext(null);
+/**
+ * Hook to access Better i18n context
+ *
+ * @example
+ * ```tsx
+ * function LanguageSwitcher() {
+ *   const { locale, setLocale, languages } = useBetterI18n()
+ *
+ *   return (
+ *     <select value={locale} onChange={(e) => setLocale(e.target.value)}>
+ *       {languages.map((lang) => (
+ *         <option key={lang.code} value={lang.code}>
+ *           {lang.nativeName}
+ *         </option>
+ *       ))}
+ *     </select>
+ *   )
+ * }
+ * ```
+ */
+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;;;;;;;;;;;;;;;;;;;GAmBG;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.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Hook to get available languages
+ *
+ * @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("packages/i18n-core/dist").LanguageOption[];
+    isLoading: boolean;
+};
+/**
+ * Hook to get and set current locale
+ *
+ * @example
+ * ```tsx
+ * function LocaleSwitcher() {
+ *   const { locale, setLocale } = useLocale()
+ *
+ *   return (
+ *     <button onClick={() => setLocale(locale === 'en' ? 'tr' : 'en')}>
+ *       Current: {locale}
+ *     </button>
+ *   )
+ * }
+ * ```
+ */
+export declare function useLocale(): {
+    locale: string;
+    setLocale: (locale: string) => void;
+    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;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS;;;;EAQxB;AAGD,OAAO,EACL,eAAe,EACf,YAAY,EACZ,WAAW,EACX,MAAM,EACN,WAAW,EACX,SAAS,IAAI,aAAa,GAC3B,MAAM,UAAU,CAAC"}

package/dist/hooks.js

@@ -0,0 +1,58 @@
+"use client";
+import { useBetterI18n } from "./context";
+/**
+ * Hook to get available languages
+ *
+ * @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 function useLanguages() {
+    const { languages, isLoadingLanguages } = useBetterI18n();
+    return {
+        languages,
+        isLoading: isLoadingLanguages,
+    };
+}
+/**
+ * Hook to get and set current locale
+ *
+ * @example
+ * ```tsx
+ * function LocaleSwitcher() {
+ *   const { locale, setLocale } = useLocale()
+ *
+ *   return (
+ *     <button onClick={() => setLocale(locale === 'en' ? 'tr' : 'en')}>
+ *       Current: {locale}
+ *     </button>
+ *   )
+ * }
+ * ```
+ */
+export function useLocale() {
+    const { locale, setLocale, isLoadingMessages } = useBetterI18n();
+    return {
+        locale,
+        setLocale,
+        isLoading: isLoadingMessages,
+    };
+}
+// Re-export use-intl hooks for convenience
+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,WAAW,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;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;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,EAAE,GAAG,aAAa,EAAE,CAAC;IAEjE,OAAO;QACL,MAAM;QACN,SAAS;QACT,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,9 @@
+export { BetterI18nProvider } from "./provider";
+export type { BetterI18nProviderProps } from "./provider";
+export { useBetterI18n } from "./context";
+export { useLanguages, useLocale, useTranslations, useFormatter, useMessages, useNow, useTimeZone, } from "./hooks";
+export { LanguageSwitcher } from "./components";
+export type { LanguageSwitcherProps } from "./components";
+export type { Messages, BetterI18nProviderConfig, BetterI18nContextValue, } from "./types";
+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,YAAY,CAAC;AAChD,YAAY,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAG1D,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EACL,YAAY,EACZ,SAAS,EAET,eAAe,EACf,YAAY,EACZ,WAAW,EACX,MAAM,EACN,WAAW,GACZ,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAG1D,YAAY,EACV,QAAQ,EACR,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+// Provider
+export { BetterI18nProvider } from "./provider";
+// Context & Hooks
+export { useBetterI18n } from "./context";
+export { useLanguages, useLocale, 
+// Re-exported from use-intl
+useTranslations, useFormatter, useMessages, useNow, useTimeZone, } from "./hooks";
+// Components
+export { LanguageSwitcher } from "./components";
+// 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,YAAY,CAAC;AAGhD,kBAAkB;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EACL,YAAY,EACZ,SAAS;AACT,4BAA4B;AAC5B,eAAe,EACf,YAAY,EACZ,WAAW,EACX,MAAM,EACN,WAAW,GACZ,MAAM,SAAS,CAAC;AAEjB,aAAa;AACb,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAUhD,8CAA8C;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,38 @@
+import { type ReactNode } from "react";
+import type { BetterI18nProviderConfig } from "./types";
+export interface BetterI18nProviderProps extends BetterI18nProviderConfig {
+    children: ReactNode;
+}
+/**
+ * Provider component that combines Better i18n CDN with use-intl
+ *
+ * @example
+ * ```tsx
+ * // Basic usage (CSR - fetches messages on client)
+ * function App() {
+ *   return (
+ *     <BetterI18nProvider
+ *       project="acme/dashboard"
+ *       locale="en"
+ *     >
+ *       <MyComponent />
+ *     </BetterI18nProvider>
+ *   )
+ * }
+ *
+ * // SSR usage (pre-loaded messages)
+ * function App({ locale, messages }) {
+ *   return (
+ *     <BetterI18nProvider
+ *       project="acme/dashboard"
+ *       locale={locale}
+ *       messages={messages}
+ *     >
+ *       <MyComponent />
+ *     </BetterI18nProvider>
+ *   )
+ * }
+ * ```
+ */
+export declare function BetterI18nProvider({ children, project, locale: initialLocale, messages: initialMessages, timeZone, now, onLocaleChange, onError, cdnBaseUrl, debug, logLevel, fetch: customFetch, }: BetterI18nProviderProps): import("react/jsx-runtime").JSX.Element | null;
+//# 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":"AAIA,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAGf,OAAO,KAAK,EAAE,wBAAwB,EAAY,MAAM,SAAS,CAAC;AAElE,MAAM,WAAW,uBAAwB,SAAQ,wBAAwB;IACvE,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,OAAO,EACP,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,eAAe,EACzB,QAAQ,EACR,GAAG,EACH,cAAc,EACd,OAAO,EACP,UAAU,EACV,KAAK,EACL,QAAQ,EACR,KAAK,EAAE,WAAW,GACnB,EAAE,uBAAuB,kDA6HzB"}

package/dist/provider.js

@@ -0,0 +1,126 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createI18nCore } from "@better-i18n/i18n-core";
+import { useCallback, useEffect, useMemo, useState, } from "react";
+import { IntlProvider } from "use-intl";
+import { BetterI18nContext } from "./context";
+/**
+ * Provider component that combines Better i18n CDN with use-intl
+ *
+ * @example
+ * ```tsx
+ * // Basic usage (CSR - fetches messages on client)
+ * function App() {
+ *   return (
+ *     <BetterI18nProvider
+ *       project="acme/dashboard"
+ *       locale="en"
+ *     >
+ *       <MyComponent />
+ *     </BetterI18nProvider>
+ *   )
+ * }
+ *
+ * // SSR usage (pre-loaded messages)
+ * function App({ locale, messages }) {
+ *   return (
+ *     <BetterI18nProvider
+ *       project="acme/dashboard"
+ *       locale={locale}
+ *       messages={messages}
+ *     >
+ *       <MyComponent />
+ *     </BetterI18nProvider>
+ *   )
+ * }
+ * ```
+ */
+export function BetterI18nProvider({ children, project, locale: initialLocale, messages: initialMessages, timeZone, now, onLocaleChange, onError, cdnBaseUrl, debug, logLevel, fetch: customFetch, }) {
+    const [locale, setLocaleState] = useState(initialLocale);
+    const [messages, setMessages] = useState(initialMessages);
+    const [languages, setLanguages] = useState([]);
+    const [isLoadingMessages, setIsLoadingMessages] = useState(!initialMessages);
+    const [isLoadingLanguages, setIsLoadingLanguages] = useState(true);
+    // Create i18n core instance
+    const i18nCore = useMemo(() => createI18nCore({
+        project,
+        defaultLocale: initialLocale,
+        cdnBaseUrl,
+        debug,
+        logLevel,
+        fetch: customFetch,
+    }), [project, initialLocale, cdnBaseUrl, debug, logLevel, customFetch]);
+    // Load languages on mount
+    useEffect(() => {
+        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]);
+    // Load messages when locale changes (if not pre-loaded)
+    useEffect(() => {
+        // Skip if we have initial messages for the current locale
+        if (initialMessages && locale === initialLocale) {
+            return;
+        }
+        let cancelled = false;
+        const loadMessages = async () => {
+            setIsLoadingMessages(true);
+            try {
+                const msgs = await i18nCore.getMessages(locale);
+                if (!cancelled) {
+                    setMessages(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, initialMessages, initialLocale]);
+    // Locale change handler
+    const setLocale = useCallback((newLocale) => {
+        setLocaleState(newLocale);
+        onLocaleChange?.(newLocale);
+    }, [onLocaleChange]);
+    // Context value
+    const contextValue = useMemo(() => ({
+        locale,
+        setLocale,
+        languages,
+        isLoadingLanguages,
+        isLoadingMessages,
+        project,
+    }), [locale, setLocale, languages, isLoadingLanguages, isLoadingMessages, project]);
+    // Don't render until we have messages
+    if (!messages) {
+        return null;
+    }
+    return (_jsx(BetterI18nContext.Provider, { value: contextValue, children: _jsx(IntlProvider, { locale: locale, messages: messages, timeZone: timeZone, now: now, onError: onError, 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,107 @@
+import type { I18nCoreConfig, LanguageOption } from "@better-i18n/i18n-core";
+import type { Messages } from "./types";
+export interface GetMessagesConfig extends Omit<I18nCoreConfig, "defaultLocale"> {
+    /**
+     * Locale to fetch messages for
+     */
+    locale: string;
+}
+/**
+ * Fetch messages for a locale (server-side)
+ *
+ * Use this in your server loaders (TanStack Start, Remix, etc.)
+ *
+ * @example
+ * ```ts
+ * // TanStack Start loader
+ * export async function loader({ params }) {
+ *   const locale = params.locale || 'en'
+ *   const messages = await getMessages({
+ *     project: 'acme/dashboard',
+ *     locale,
+ *   })
+ *   return { locale, messages }
+ * }
+ * ```
+ */
+export declare function getMessages(config: GetMessagesConfig): Promise<Messages>;
+/**
+ * Fetch available locales (server-side)
+ *
+ * @example
+ * ```ts
+ * const locales = await getLocales({ project: 'acme/dashboard' })
+ * // ['en', 'tr', 'de', ...]
+ * ```
+ */
+export declare function getLocales(config: Omit<I18nCoreConfig, "defaultLocale"> & {
+    defaultLocale?: string;
+}): Promise<string[]>;
+/**
+ * Fetch available languages with metadata (server-side)
+ *
+ * @example
+ * ```ts
+ * const languages = await getLanguages({ project: 'acme/dashboard' })
+ * // [{ code: 'en', name: 'English', nativeName: 'English', flagUrl: '...' }, ...]
+ * ```
+ */
+export declare function getLanguages(config: Omit<I18nCoreConfig, "defaultLocale"> & {
+    defaultLocale?: string;
+}): Promise<LanguageOption[]>;
+/**
+ * Create a translator function for use outside React (server-side)
+ *
+ * @example
+ * ```ts
+ * const messages = await getMessages({ project: 'acme/dashboard', locale: 'en' })
+ * const t = createServerTranslator({ locale: 'en', messages })
+ *
+ * // Use in metadata, emails, etc.
+ * const title = t('page.title')
+ * ```
+ */
+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)
+ *
+ * @example
+ * ```ts
+ * const format = createServerFormatter({ locale: 'en' })
+ * const date = format.dateTime(new Date(), { dateStyle: 'full' })
+ * ```
+ */
+export declare function createServerFormatter(config: {
+    locale: string;
+    timeZone?: string;
+    now?: Date;
+}): {
+    dateTime: {
+        (value: Date | number, options?: import("use-intl").DateTimeFormatOptions): string;
+        (value: Date | number, format?: string, options?: import("use-intl").DateTimeFormatOptions): string;
+    };
+    number: {
+        (value: number | bigint, options?: import("use-intl").NumberFormatOptions): string;
+        (value: number | bigint, format?: string, options?: import("use-intl").NumberFormatOptions): string;
+    };
+    relativeTime: {
+        (date: number | Date, now?: import("use-intl").RelativeTimeFormatOptions["now"]): string;
+        (date: number | Date, options?: import("use-intl").RelativeTimeFormatOptions): string;
+    };
+    list: {
+        <Value extends string | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>>(value: Iterable<Value>, options?: Intl.ListFormatOptions): Value extends string ? string : Iterable<import("react").ReactElement>;
+        <Value extends string | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>>(value: Iterable<Value>, format?: string, options?: Intl.ListFormatOptions): Value extends string ? string : Iterable<import("react").ReactElement>;
+    };
+    dateTimeRange: {
+        (start: Date | number, end: Date | number, options?: import("use-intl").DateTimeFormatOptions): string;
+        (start: Date | number, end: Date | number, format?: string, options?: import("use-intl").DateTimeFormatOptions): string;
+    };
+};
+export { createTranslator, createFormatter } from "use-intl/core";
+//# 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,wBAAwB,CAAC;AAE7E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC;IAC9E;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAW9E;AAED;;;;;;;;GAQG;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,CAWnB;AAED;;;;;;;;GAQG;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,CAW3B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;;WAMA;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;;sCAlGiD,CAAC;qCAE3C,CAAC,iBACK,CAAC;;;wCAGC,CAAC;uCAIQ,CAAC,iBAAgC,CAAC;;;iCAQ1C,CAAC;qCAEf,CAAC;;;2JAMmB,CAAC;0JAYf,CAAC,iBAA8B,CAAC;;;0DAKiB,CAAC;yDAIxC,CAAC,iBAAkC,CAAC;;EAyDtD;AAGD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/server.js

@@ -0,0 +1,109 @@
+import { createI18nCore } from "@better-i18n/i18n-core";
+import { createFormatter, createTranslator } from "use-intl/core";
+/**
+ * Fetch messages for a locale (server-side)
+ *
+ * Use this in your server loaders (TanStack Start, Remix, etc.)
+ *
+ * @example
+ * ```ts
+ * // TanStack Start loader
+ * export async function loader({ params }) {
+ *   const locale = params.locale || 'en'
+ *   const messages = await getMessages({
+ *     project: 'acme/dashboard',
+ *     locale,
+ *   })
+ *   return { locale, messages }
+ * }
+ * ```
+ */
+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,
+    });
+    return (await i18n.getMessages(config.locale));
+}
+/**
+ * Fetch available locales (server-side)
+ *
+ * @example
+ * ```ts
+ * const locales = await getLocales({ project: 'acme/dashboard' })
+ * // ['en', 'tr', 'de', ...]
+ * ```
+ */
+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,
+    });
+    return i18n.getLocales();
+}
+/**
+ * Fetch available languages with metadata (server-side)
+ *
+ * @example
+ * ```ts
+ * const languages = await getLanguages({ project: 'acme/dashboard' })
+ * // [{ code: 'en', name: 'English', nativeName: 'English', flagUrl: '...' }, ...]
+ * ```
+ */
+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,
+    });
+    return i18n.getLanguages();
+}
+/**
+ * Create a translator function for use outside React (server-side)
+ *
+ * @example
+ * ```ts
+ * const messages = await getMessages({ project: 'acme/dashboard', locale: 'en' })
+ * const t = createServerTranslator({ locale: 'en', messages })
+ *
+ * // Use in metadata, emails, etc.
+ * const title = t('page.title')
+ * ```
+ */
+export function createServerTranslator(config) {
+    return createTranslator({
+        locale: config.locale,
+        messages: config.messages,
+        namespace: config.namespace,
+    });
+}
+/**
+ * Create a formatter for use outside React (server-side)
+ *
+ * @example
+ * ```ts
+ * const format = createServerFormatter({ locale: 'en' })
+ * const date = format.dateTime(new Date(), { dateStyle: 'full' })
+ * ```
+ */
+export function createServerFormatter(config) {
+    return createFormatter({
+        locale: config.locale,
+        timeZone: config.timeZone,
+        now: config.now,
+    });
+}
+// Re-export core functions from use-intl for advanced usage
+export { createTranslator, createFormatter } from "use-intl/core";
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAUlE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAyB;IACzD,MAAM,IAAI,GAAG,cAAc,CAAC;QAC1B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,aAAa,EAAE,MAAM,CAAC,MAAM;QAC5B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC,CAAC;IAEH,OAAO,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAa,CAAC;AAC7D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAA0E;IAE1E,MAAM,IAAI,GAAG,cAAc,CAAC;QAC1B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,IAAI;QAC3C,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAA0E;IAE1E,MAAM,IAAI,GAAG,cAAc,CAAC;QAC1B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,IAAI;QAC3C,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC;AAC7B,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAItC;IACC,OAAO,gBAAgB,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ,EAAE,MAAM,CAAC,QAA8D;QAC/E,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAIrC;IACC,OAAO,eAAe,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,GAAG,EAAE,MAAM,CAAC,GAAG;KAChB,CAAC,CAAC;AACL,CAAC;AAED,4DAA4D;AAC5D,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,76 @@
+import type { I18nCoreConfig, LanguageOption } from "@better-i18n/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;
+    /**
+     * Callback when locale changes
+     */
+    onLocaleChange?: (locale: string) => void;
+    /**
+     * Error handler for missing translations
+     */
+    onError?: ComponentProps<typeof IntlProvider>["onError"];
+}
+/**
+ * Better i18n context value
+ */
+export interface BetterI18nContextValue {
+    /**
+     * Current locale
+     */
+    locale: string;
+    /**
+     * Change the current locale
+     */
+    setLocale: (locale: string) => void;
+    /**
+     * Available languages with metadata
+     */
+    languages: LanguageOption[];
+    /**
+     * Whether languages are still loading
+     */
+    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,wBAAwB,CAAC;AAC7E,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,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAE1C;;OAEG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC,OAAO,YAAY,CAAC,CAAC,SAAS,CAAC,CAAC;CAC1D;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAEpC;;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

@@ -0,0 +1,66 @@
+{
+  "name": "@better-i18n/use-intl",
+  "version": "0.1.0",
+  "description": "Better i18n integration for use-intl (React, TanStack Start)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/better-i18n/better-i18n.git",
+    "directory": "packages/use-intl"
+  },
+  "bugs": {
+    "url": "https://github.com/better-i18n/better-i18n/issues"
+  },
+  "homepage": "https://github.com/better-i18n/better-i18n/tree/main/packages/use-intl",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "default": "./dist/server.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "package.json",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "i18n",
+    "localization",
+    "internationalization",
+    "react",
+    "tanstack",
+    "use-intl",
+    "next-intl"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "dependencies": {
+    "@better-i18n/i18n-core": "workspace:*"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "use-intl": ">=4.0.0"
+  },
+  "devDependencies": {
+    "@better-i18n/typescript-config": "workspace:*",
+    "@types/react": "^19.0.0",
+    "react": "^19.0.0",
+    "use-intl": "^4.7.0",
+    "typescript": "~5.9.2"
+  }
+}