@fluenti/react 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Fluenti Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,244 @@
+# @fluenti/react
+
+[![npm version](https://img.shields.io/npm/v/@fluenti/react?color=4f46e5&label=npm)](https://www.npmjs.com/package/@fluenti/react)
+[![bundle size](https://img.shields.io/bundlephobia/minzip/@fluenti/react?color=16a34a&label=size)](https://bundlephobia.com/package/@fluenti/react)
+[![license](https://img.shields.io/npm/l/@fluenti/react?color=64748b)](https://github.com/usefluenti/fluenti/blob/main/LICENSE)
+
+**Compile-time i18n for React.** Zero runtime parsing. RSC-ready. React 19 compatible.
+
+Fluenti compiles your translations at build time so your production bundle ships pre-resolved messages instead of an ICU parser. The result: smaller bundles, faster renders, and a DX that feels native to React.
+
+---
+
+## Features
+
+- **Zero runtime parsing** -- ICU MessageFormat compiled away at build time
+- **React Server Components** -- first-class RSC support via `@fluenti/react/server`
+- **Streaming SSR & Suspense** -- works with `React.Suspense` and streamed responses out of the box
+- **React 19 compatible** -- tested against React 19, works with 18+
+- **Tagged template literals** -- write `t`\`Hello, {name}!\`` directly in JSX
+- **Rich text components** -- `<Trans>`, `<Plural>`, `<Select>`, `<DateTime>`, `<NumberFormat>`
+- **Lazy loading** -- load locale catalogs on demand with dynamic imports
+- **Type-safe** -- full TypeScript support with strict types
+
+---
+
+## Quick Start
+
+### 1. Install
+
+```bash
+pnpm add @fluenti/core @fluenti/react
+pnpm add -D @fluenti/cli @fluenti/vite-plugin
+```
+
+### 2. Configure Vite
+
+```ts
+// vite.config.ts
+import react from '@vitejs/plugin-react'
+import fluenti from '@fluenti/vite-plugin'
+
+export default {
+  plugins: [
+    fluenti({ framework: 'react' }),
+    react(),
+  ],
+}
+```
+
+### 3. Wrap your app with `I18nProvider`
+
+```tsx
+import { I18nProvider } from '@fluenti/react'
+import en from './locales/compiled/en'
+
+function App() {
+  return (
+    <I18nProvider
+      locale="en"
+      fallbackLocale="en"
+      messages={{ en }}
+      loadMessages={(locale) => import(`./locales/compiled/${locale}.js`)}
+    >
+      <MyApp />
+    </I18nProvider>
+  )
+}
+```
+
+### 4. Translate
+
+```tsx
+import { t, useI18n, Trans, Plural, Select } from '@fluenti/react'
+
+function Dashboard() {
+  const { d, n, locale, setLocale } = useI18n()
+  const name = 'Alice'
+
+  return (
+    <div>
+      {/* Compile-time tagged template */}
+      <h1>{t`Welcome back, ${name}!`}</h1>
+
+      {/* Rich text with embedded components */}
+      <Trans>Read the <a href="/docs">documentation</a></Trans>
+
+      {/* Locale-aware pluralization */}
+      <Plural value={count} one="# item in cart" other="# items in cart" />
+
+      {/* Gender / categorical selection */}
+      <Select value={role} admin="Full access" editor="Edit access" other="Read only" />
+
+      {/* Date & number formatting */}
+      <p>{d(new Date(), 'long')}</p>
+      <p>{n(9999.99, 'currency')}</p>
+
+      {/* Switch locale at runtime */}
+      <button onClick={() => setLocale('ja')}>日本語</button>
+    </div>
+  )
+}
+```
+
+---
+
+## Compile-Time Transform
+
+Fluenti transforms your source code at build time. What you write:
+
+```tsx
+<Trans>Read the <a href="/docs">documentation</a></Trans>
+```
+
+What ships to production:
+
+```tsx
+// Pre-resolved message, no parser needed at runtime
+<>Read the <a href="/docs">ドキュメント</a></>
+```
+
+The ICU parser is a dev dependency only -- it never reaches your users.
+
+## Direct-Import `t`
+
+`import { t } from '@fluenti/react'` is Fluenti's primary compile-time API.
+
+It supports:
+
+- `` t`Hello ${name}` ``
+- `t({ message: 'Hello {name}', context: 'hero' }, { name })`
+
+It does not support ID lookup. For `t('message.id')`, locale switching, formatting helpers, or other imperative runtime APIs, use `useI18n()`.
+
+---
+
+## React Server Components (RSC)
+
+For Next.js App Router and other RSC-capable frameworks, use `@fluenti/react/server`:
+
+```ts
+// lib/i18n.server.ts
+import { createServerI18n } from '@fluenti/react/server'
+
+export const { setLocale, getI18n, Trans, Plural, DateTime, NumberFormat } =
+  createServerI18n({
+    loadMessages: (locale) => import(`../locales/compiled/${locale}.js`),
+    fallbackLocale: 'en',
+    resolveLocale: async () => {
+      const { cookies } = await import('next/headers')
+      return (await cookies()).get('locale')?.value ?? 'en'
+    },
+  })
+```
+
+```tsx
+// app/layout.tsx -- set locale once per request
+import { setLocale } from '@/lib/i18n.server'
+
+export default async function Layout({ params, children }) {
+  const { locale } = await params
+  setLocale(locale)
+  return <html lang={locale}><body>{children}</body></html>
+}
+```
+
+```tsx
+// app/page.tsx -- use components directly, no prop drilling
+import { Trans, Plural, DateTime, NumberFormat } from '@/lib/i18n.server'
+
+export default async function Page() {
+  return (
+    <div>
+      <Trans>Read the <a href="/docs">documentation</a>.</Trans>
+      <Plural value={5} one="# item" other="# items" />
+      <DateTime value={new Date()} style="long" />
+      <NumberFormat value={1234.56} />
+    </div>
+  )
+}
+```
+
+Server components are async and use `React.cache()` for request-scoped state -- no Context needed. The API mirrors client components exactly.
+
+---
+
+## API Reference
+
+### Components
+
+| Component | Description |
+|-----------|-------------|
+| `I18nProvider` | Provides i18n context to the component tree |
+| `Trans` | Rich text with embedded component interpolation |
+| `Plural` | Locale-aware pluralization via `Intl.PluralRules` |
+| `Select` | Categorical value selection (gender, role, status) |
+| `DateTime` | Date formatting via `Intl.DateTimeFormat` |
+| `NumberFormat` | Number formatting via `Intl.NumberFormat` |
+
+### Hooks
+
+| Hook | Returns |
+|------|---------|
+| `useI18n()` | `{ t, d, n, format, loadMessages, getLocales, i18n, locale, setLocale, ... }` |
+
+`useI18n().t` remains the full runtime API for ID lookup, descriptor lookup, and imperative usage. Convenience methods `d()`, `n()`, `format()`, `loadMessages()`, `getLocales()` are also available directly. The `i18n` object is retained as an escape hatch.
+
+### Server API (`@fluenti/react/server`)
+
+| Export | Description |
+|--------|-------------|
+| `createServerI18n(config)` | Create request-scoped i18n for RSC |
+| `setLocale(locale)` | Set locale for the current request |
+| `getI18n()` | Get the i18n instance (async) |
+| `Trans`, `Plural`, `DateTime`, `NumberFormat` | Async server components |
+
+### Utilities
+
+| Export | Entry point | Description |
+|--------|-------------|-------------|
+| `msg` | `@fluenti/react` | Tag for lazy message definitions outside the component tree |
+| `detectLocale(options)` | `@fluenti/react/server` | SSR locale detection (cookie, query, path, headers) |
+| `getSSRLocaleScript()` | `@fluenti/react/server` | Inline `<script>` for hydration without flash |
+| `isRTL(locale)` | `@fluenti/react/server` | Check if a locale is right-to-left |
+
+---
+
+## Framework Compatibility
+
+Works with any React-based framework:
+
+- **React SPA** (Vite)
+- **Next.js** (App Router + Pages Router)
+- **React Router** / Remix
+- **TanStack Start**
+
+---
+
+## Documentation
+
+Full docs, guides, and examples at [fluenti.dev](https://fluenti.dev).
+
+## License
+
+[MIT](https://github.com/usefluenti/fluenti/blob/main/LICENSE)

package/dist/__tests__/DateTime.test.d.ts

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

package/dist/__tests__/DateTime.test.d.ts.map

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

package/dist/__tests__/Number.test.d.ts

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

package/dist/__tests__/Number.test.d.ts.map

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

package/dist/__tests__/Plural.test.d.ts

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

package/dist/__tests__/Plural.test.d.ts.map

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

package/dist/__tests__/Select.test.d.ts

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

package/dist/__tests__/Select.test.d.ts.map

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

package/dist/__tests__/Trans.test.d.ts

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

package/dist/__tests__/Trans.test.d.ts.map

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

package/dist/__tests__/locale-switch.test.d.ts

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

package/dist/__tests__/locale-switch.test.d.ts.map

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

package/dist/__tests__/plural-core.test.d.ts

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

package/dist/__tests__/plural-core.test.d.ts.map

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

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

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

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

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

package/dist/__tests__/server.test.d.ts

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

package/dist/__tests__/server.test.d.ts.map

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

package/dist/__tests__/trans-core.test.d.ts

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

package/dist/__tests__/trans-core.test.d.ts.map

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

package/dist/compile-time-t.d.ts

@@ -0,0 +1,3 @@
+import { CompileTimeT } from '@fluenti/core';
+export declare const t: CompileTimeT;
+//# sourceMappingURL=compile-time-t.d.ts.map

package/dist/compile-time-t.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-time-t.d.ts","sourceRoot":"","sources":["../src/compile-time-t.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAEjD,eAAO,MAAM,CAAC,EAAE,YAME,CAAA"}

package/dist/components/DateTime.d.ts

@@ -0,0 +1,16 @@
+export interface DateTimeProps {
+    /** Date value to format */
+    value: Date | number;
+    /** Named format style */
+    style?: string;
+}
+/**
+ * `<DateTime>` — formatting component using Intl APIs.
+ *
+ * @example
+ * ```tsx
+ * <DateTime value={new Date()} style="long" />
+ * ```
+ */
+export declare function DateTime({ value, style }: DateTimeProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=DateTime.d.ts.map

package/dist/components/DateTime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DateTime.d.ts","sourceRoot":"","sources":["../../src/components/DateTime.tsx"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,2BAA2B;IAC3B,KAAK,EAAE,IAAI,GAAG,MAAM,CAAA;IACpB,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,aAAa,2CAMvD"}

package/dist/components/Number.d.ts

@@ -0,0 +1,16 @@
+export interface NumberProps {
+    /** Number value to format */
+    value: number;
+    /** Named format style */
+    style?: string;
+}
+/**
+ * `<Number>` — number formatting component using Intl APIs.
+ *
+ * @example
+ * ```tsx
+ * <Number value={1234.56} style="currency" />
+ * ```
+ */
+export declare function NumberFormat({ value, style }: NumberProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Number.d.ts.map

package/dist/components/Number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Number.d.ts","sourceRoot":"","sources":["../../src/components/Number.tsx"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,WAAW,2CAMzD"}

package/dist/components/Plural.d.ts

@@ -0,0 +1,35 @@
+import { ReactNode } from 'react';
+export interface PluralProps {
+    /** The count value */
+    value: number;
+    /** Override the auto-generated synthetic ICU message id */
+    id?: string;
+    /** Message context used for identity and translator disambiguation */
+    context?: string;
+    /** Translator-facing note preserved in extraction catalogs */
+    comment?: string;
+    /** Text for zero (if language supports) */
+    zero?: ReactNode;
+    /** Singular form. `#` replaced with value */
+    one?: ReactNode;
+    /** Dual form (Arabic, etc.) */
+    two?: ReactNode;
+    /** Few form (Slavic languages, etc.) */
+    few?: ReactNode;
+    /** Many form */
+    many?: ReactNode;
+    /** Default plural form */
+    other: ReactNode;
+    /** Offset from value before selecting form */
+    offset?: number;
+}
+/**
+ * `<Plural>` — ICU plural handling as a component.
+ *
+ * @example
+ * ```tsx
+ * <Plural value={count} zero="No messages" one="# message" other="# messages" />
+ * ```
+ */
+export declare const Plural: import('react').NamedExoticComponent<PluralProps>;
+//# sourceMappingURL=Plural.d.ts.map

package/dist/components/Plural.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plural.d.ts","sourceRoot":"","sources":["../../src/components/Plural.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAMxD,MAAM,WAAW,WAAW;IAC1B,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,2DAA2D;IAC3D,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,6CAA6C;IAC7C,GAAG,CAAC,EAAE,SAAS,CAAA;IACf,+BAA+B;IAC/B,GAAG,CAAC,EAAE,SAAS,CAAA;IACf,wCAAwC;IACxC,GAAG,CAAC,EAAE,SAAS,CAAA;IACf,gBAAgB;IAChB,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,0BAA0B;IAC1B,KAAK,EAAE,SAAS,CAAA;IAChB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,mDA+CjB,CAAA"}

package/dist/components/Select.d.ts

@@ -0,0 +1,32 @@
+import { ReactNode } from 'react';
+export interface SelectProps {
+    /** The selector value */
+    value: string;
+    /** Override the auto-generated synthetic ICU message id */
+    id?: string;
+    /** Message context used for identity and translator disambiguation */
+    context?: string;
+    /** Translator-facing note preserved in extraction catalogs */
+    comment?: string;
+    /** Default case */
+    other: ReactNode;
+    /** Type-safe named options. Takes precedence over direct case props. */
+    options?: Record<string, ReactNode>;
+    /** Named cases — any string key maps to a ReactNode */
+    [key: string]: ReactNode | Record<string, ReactNode> | undefined;
+}
+/**
+ * `<Select>` — ICU select for gender, role, or other categorical values.
+ *
+ * @example
+ * ```tsx
+ * <Select
+ *   value={gender}
+ *   male="He liked your post"
+ *   female="She liked your post"
+ *   other="They liked your post"
+ * />
+ * ```
+ */
+export declare function Select(props: SelectProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Select.d.ts.map

package/dist/components/Select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Select.d.ts","sourceRoot":"","sources":["../../src/components/Select.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAKlD,MAAM,WAAW,WAAW;IAC1B,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,2DAA2D;IAC3D,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mBAAmB;IACnB,KAAK,EAAE,SAAS,CAAA;IAChB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACnC,uDAAuD;IACvD,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,SAAS,CAAA;CACjE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,2CAyCxC"}

package/dist/components/Trans.d.ts

@@ -0,0 +1,29 @@
+import { ReactElement, ReactNode } from 'react';
+export interface TransProps {
+    /** Source text with embedded components */
+    children: ReactNode;
+    /** Override auto-generated hash ID */
+    id?: string;
+    /** Message context used for identity and translator disambiguation */
+    context?: string;
+    /** Context comment for translators */
+    comment?: string;
+    /** Custom render wrapper */
+    render?: (translation: ReactNode) => ReactNode;
+    /** @internal Pre-computed message ID from build plugin */
+    __id?: string;
+    /** @internal Pre-computed ICU message from build plugin */
+    __message?: string;
+    /** @internal Pre-computed component list from build plugin */
+    __components?: ReactElement[];
+}
+/**
+ * `<Trans>` component for rich-text translations containing nested React elements.
+ *
+ * @example
+ * ```tsx
+ * <Trans>Read the <a href="/docs">documentation</a> for more info.</Trans>
+ * ```
+ */
+export declare const Trans: import('react').NamedExoticComponent<TransProps>;
+//# sourceMappingURL=Trans.d.ts.map

package/dist/components/Trans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Trans.d.ts","sourceRoot":"","sources":["../../src/components/Trans.tsx"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,OAAO,CAAA;AAId,MAAM,WAAW,UAAU;IACzB,2CAA2C;IAC3C,QAAQ,EAAE,SAAS,CAAA;IACnB,sCAAsC;IACtC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,SAAS,KAAK,SAAS,CAAA;IAC9C,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,YAAY,EAAE,CAAA;CAC9B;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK,kDAwChB,CAAA"}

package/dist/components/icu-rich.d.ts

@@ -0,0 +1,22 @@
+import { MessageDescriptor } from '@fluenti/core';
+import { ReactElement, ReactNode } from 'react';
+import { PluralCategory } from './plural-core';
+export interface RichMessagePart {
+    message: string;
+    components: ReactElement[];
+}
+export declare function buildICUPluralMessage(forms: Partial<Record<PluralCategory, string>> & {
+    other: string;
+}, offset?: number): string;
+export declare function buildICUSelectMessage(forms: Record<string, string>): string;
+export declare function normalizeSelectForms(forms: Record<string, string>): {
+    forms: Record<string, string>;
+    valueMap: Record<string, string>;
+};
+export declare function serializeRichNode(node: ReactNode): RichMessagePart;
+export declare function serializeRichForms<T extends string>(keys: readonly T[], forms: Partial<Record<T, ReactNode>> & Record<string, ReactNode | undefined>): {
+    messages: Partial<Record<T, string>> & Record<string, string>;
+    components: ReactElement[];
+};
+export declare function renderRichTranslation(descriptor: MessageDescriptor, values: Record<string, unknown> | undefined, translate: (descriptor: MessageDescriptor, values?: Record<string, unknown>) => string, components: ReactElement[]): ReactNode;
+//# sourceMappingURL=icu-rich.d.ts.map

package/dist/components/icu-rich.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icu-rich.d.ts","sourceRoot":"","sources":["../../src/components/icu-rich.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEpD,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,eAAe,CAAA;AAEtE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,YAAY,EAAE,CAAA;CAC3B;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAClE,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CASR;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,MAAM,CAGR;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B;IACD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,CAqBA;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,eAAe,CAMlE;AAED,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,EACjD,IAAI,EAAE,SAAS,CAAC,EAAE,EAClB,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC,GAC3E;IACD,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7D,UAAU,EAAE,YAAY,EAAE,CAAA;CAC3B,CAoBA;AAED,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,iBAAiB,EAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC3C,SAAS,EAAE,CAAC,UAAU,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,EACtF,UAAU,EAAE,YAAY,EAAE,GACzB,SAAS,CAGX"}

package/dist/components/plural-core.d.ts

@@ -0,0 +1,15 @@
+import { ReactNode } from 'react';
+export declare const PLURAL_CATEGORIES: readonly ["zero", "one", "two", "few", "many", "other"];
+export type PluralCategory = (typeof PLURAL_CATEGORIES)[number];
+/**
+ * Resolve which plural category to use.
+ * Checks for exact =0 match first, then falls back to CLDR rules.
+ * @internal
+ */
+export declare function resolveCategory(value: number, locale: string, available: Record<string, boolean>): PluralCategory;
+/**
+ * Replace `#` with the formatted value in a ReactNode.
+ * @internal
+ */
+export declare function replaceHash(node: ReactNode, formatted: string): ReactNode;
+//# sourceMappingURL=plural-core.d.ts.map

package/dist/components/plural-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plural-core.d.ts","sourceRoot":"","sources":["../../src/components/plural-core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,eAAO,MAAM,iBAAiB,yDAA0D,CAAA;AACxF,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/D;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,cAAc,CAKhB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,CAKzE"}

package/dist/components/trans-core.d.ts

@@ -0,0 +1,28 @@
+import { ReactNode, ReactElement } from 'react';
+import { hashMessage } from '@fluenti/core';
+export { hashMessage };
+/**
+ * Extract a message string and component list from React children.
+ *
+ * Converts:
+ *   <Trans>Hello <b>{name}</b>, welcome!</Trans>
+ * Into:
+ *   message: "Hello <0>{name}</0>, welcome!"
+ *   components: [<b>{name}</b>]
+ *
+ * @internal
+ */
+export declare function extractMessage(children: ReactNode): {
+    message: string;
+    components: ReactElement[];
+};
+export declare function offsetIndices(message: string, offset: number): string;
+/**
+ * Reconstruct a translated message string back into React elements.
+ *
+ * Parses "<0>content</0>" tags and replaces them with cloned components.
+ *
+ * @internal
+ */
+export declare function reconstruct(translated: string, components: ReactElement[]): ReactNode;
+//# sourceMappingURL=trans-core.d.ts.map

package/dist/components/trans-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trans-core.d.ts","sourceRoot":"","sources":["../../src/components/trans-core.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,SAAS,EACd,KAAK,YAAY,EAClB,MAAM,OAAO,CAAA;AACd,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C,OAAO,EAAE,WAAW,EAAE,CAAA;AAEtB;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,GAAG;IACnD,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,YAAY,EAAE,CAAA;CAC3B,CAwBA;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKrE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,YAAY,EAAE,GACzB,SAAS,CAqCX"}

package/dist/context.d.ts

@@ -0,0 +1,3 @@
+import { I18nContextValue } from './types';
+export declare const I18nContext: import('react').Context<I18nContextValue | null>;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C,eAAO,MAAM,WAAW,kDAA+C,CAAA"}

package/dist/global-registry.d.ts

@@ -0,0 +1,18 @@
+import { FluentInstanceExtended } from '@fluenti/core';
+/**
+ * Global i18n instance registry.
+ *
+ * Used by `@fluenti/next` webpack loader and `@fluenti/vite-plugin` to access
+ * the i18n instance from module-level code via a Proxy. The instance is set by
+ * `<I18nProvider>` on mount.
+ */
+declare global {
+    var __fluenti_i18n: FluentInstanceExtended | undefined;
+}
+/** Get the global i18n instance (set by `<I18nProvider>`). */
+export declare function getGlobalI18n(): FluentInstanceExtended | undefined;
+/** Set the global i18n instance. Called by `<I18nProvider>` on mount. */
+export declare function setGlobalI18n(instance: FluentInstanceExtended): void;
+/** Clear the global i18n instance. Primarily for testing. */
+export declare function clearGlobalI18n(): void;
+//# sourceMappingURL=global-registry.d.ts.map

package/dist/global-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-registry.d.ts","sourceRoot":"","sources":["../src/global-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AAE3D;;;;;;GAMG;AAEH,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,cAAc,EAAE,sBAAsB,GAAG,SAAS,CAAA;CACvD;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,IAAI,sBAAsB,GAAG,SAAS,CAElE;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAEpE;AAED,6DAA6D;AAC7D,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}

package/dist/hooks/__useI18n.d.ts

@@ -0,0 +1,12 @@
+import { FluentInstanceExtended } from '../types';
+/**
+ * Internal hook used by the Vite plugin's compiled output.
+ * Returns the i18n instance for direct t() calls.
+ *
+ * **Not part of the public API.** Users never write this — the Vite plugin
+ * generates imports of this hook automatically.
+ *
+ * @internal
+ */
+export declare function __useI18n(): FluentInstanceExtended;
+//# sourceMappingURL=__useI18n.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"__useI18n.d.ts","sourceRoot":"","sources":["../../src/hooks/__useI18n.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AAEtD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,IAAI,sBAAsB,CASlD"}