@fluenti/react 0.1.0

package/dist/server.d.ts

@@ -0,0 +1,240 @@
+import { FluentInstanceExtended, Locale, Messages, DateFormatOptions, NumberFormatOptions } from '@fluenti/core';
+import { ReactNode, ReactElement } from 'react';
+export { detectLocale, getSSRLocaleScript, getHydratedLocale, isRTL, getDirection } from '@fluenti/core';
+export type { DetectLocaleOptions } from '@fluenti/core';
+/**
+ * Configuration for `createServerI18n`.
+ */
+export interface ServerI18nConfig {
+    /** Load messages for a given locale. Called once per locale per request. */
+    loadMessages: (locale: string) => Promise<Messages | {
+        default: Messages;
+    }>;
+    /** Fallback locale when a translation is missing */
+    fallbackLocale?: string;
+    /**
+     * Auto-resolve locale when `setLocale()` was not called.
+     *
+     * This is the fallback for contexts where the layout doesn't run — most
+     * notably **Server Actions** (`'use server'`), which are independent
+     * requests that skip the layout tree entirely.
+     *
+     * Common patterns:
+     * - Read from a cookie (Next.js: `cookies().get('locale')`)
+     * - Read from a request header set by middleware
+     * - Query the database for the authenticated user's preference
+     *
+     * If omitted and `setLocale()` was not called, `getI18n()` will throw.
+     *
+     * @example
+     * ```ts
+     * resolveLocale: async () => {
+     *   const { cookies } = await import('next/headers')
+     *   return (await cookies()).get('locale')?.value ?? 'en'
+     * }
+     * ```
+     */
+    resolveLocale?: () => string | Promise<string>;
+    /** Custom fallback chains per locale */
+    fallbackChain?: Record<string, Locale[]>;
+    /** Custom date format styles */
+    dateFormats?: DateFormatOptions;
+    /** Custom number format styles */
+    numberFormats?: NumberFormatOptions;
+    /** Handler for missing translation keys */
+    missing?: (locale: Locale, id: string) => string | undefined;
+}
+export interface ServerTransProps {
+    /** 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;
+}
+export interface ServerPluralProps {
+    /** 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;
+}
+export interface ServerSelectProps {
+    /** 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> | string | undefined;
+}
+export interface ServerDateTimeProps {
+    /** Date value to format */
+    value: Date | number;
+    /** Named format style */
+    style?: string;
+}
+export interface ServerNumberProps {
+    /** Number value to format */
+    value: number;
+    /** Named format style */
+    style?: string;
+}
+type ServerTransComponent = (props: ServerTransProps) => Promise<ReactElement>;
+type ServerPluralComponent = (props: ServerPluralProps) => Promise<ReactElement>;
+type ServerSelectComponent = (props: ServerSelectProps) => Promise<ReactElement>;
+type ServerDateTimeComponent = (props: ServerDateTimeProps) => Promise<ReactElement>;
+type ServerNumberComponent = (props: ServerNumberProps) => Promise<ReactElement>;
+/**
+ * The object returned by `createServerI18n`.
+ */
+export interface ServerI18n {
+    /**
+     * Set the locale for the current server request.
+     * Call this once in your root layout or page before any `getI18n()` calls.
+     *
+     * Uses `React.cache()` — scoped to the current request automatically.
+     */
+    setLocale: (locale: string) => void;
+    /**
+     * Get a fully configured i18n instance for the current request.
+     * Messages are loaded lazily and cached per-request.
+     *
+     * @example
+     * ```tsx
+     * // In any Server Component
+     * const { t, d, n, locale } = await getI18n()
+     * return <h1>{t('welcome')}</h1>
+     * ```
+     */
+    getI18n: () => Promise<FluentInstanceExtended & {
+        locale: string;
+    }>;
+    /**
+     * `<Trans>` for React Server Components.
+     * Async component — automatically resolves the i18n instance.
+     *
+     * @example
+     * ```tsx
+     * <Trans>Read the <a href="/docs">documentation</a>.</Trans>
+     * ```
+     */
+    Trans: ServerTransComponent;
+    /**
+     * `<Plural>` for React Server Components.
+     *
+     * @example
+     * ```tsx
+     * <Plural value={count} one="# item" other="# items" />
+     * ```
+     */
+    Plural: ServerPluralComponent;
+    /**
+     * `<Select>` for React Server Components.
+     *
+     * @example
+     * ```tsx
+     * <Select value={gender} male="He liked this" other="They liked this" />
+     * ```
+     */
+    Select: ServerSelectComponent;
+    /**
+     * `<DateTime>` for React Server Components.
+     *
+     * @example
+     * ```tsx
+     * <DateTime value={new Date()} style="long" />
+     * ```
+     */
+    DateTime: ServerDateTimeComponent;
+    /**
+     * `<NumberFormat>` for React Server Components.
+     *
+     * @example
+     * ```tsx
+     * <NumberFormat value={1234.56} style="currency" />
+     * ```
+     */
+    NumberFormat: ServerNumberComponent;
+    /**
+     * Synchronous accessor for the cached i18n instance.
+     * Used internally by @fluenti/next webpack loader.
+     * @internal
+     */
+    __getSyncInstance: () => FluentInstanceExtended & {
+        locale: string;
+    };
+}
+/**
+ * Create server-side i18n utilities for React Server Components.
+ *
+ * Uses `React.cache()` to share state within a single server request
+ * without React Context (which is unavailable in Server Components).
+ *
+ * @example
+ * ```ts
+ * // lib/i18n.server.ts — define once
+ * import { createServerI18n } from '@fluenti/react/server'
+ *
+ * export const { setLocale, getI18n, Trans, Plural, Select, DateTime, NumberFormat } = createServerI18n({
+ *   loadMessages: (locale) => import(`../messages/${locale}.json`),
+ *   fallbackLocale: 'en',
+ * })
+ * ```
+ *
+ * ```tsx
+ * // app/[locale]/layout.tsx — set locale once
+ * 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/[locale]/page.tsx — use Trans, Plural, etc. directly
+ * import { Trans, Plural, Select } 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" />
+ *       <Select value="male" male="He liked this" other="They liked this" />
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+export declare function createServerI18n(config: ServerI18nConfig): ServerI18n;
+//# 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":"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"}

package/dist/server.js

@@ -0,0 +1,122 @@
+import { a as e, c as t, i as n, l as r, n as i, o as a, r as o, s, t as c } from "./icu-rich-DBeWY1k6.js";
+import { Fragment as l, cache as u, createElement as d } from "react";
+import { createFluent as f, detectLocale as p, getDirection as m, getHydratedLocale as h, getSSRLocaleScript as g, hashMessage as _, isRTL as v } from "@fluenti/core";
+//#region src/server.ts
+function y(p) {
+	let m = u(() => ({
+		locale: null,
+		instance: null
+	})), h = u(() => /* @__PURE__ */ new Map()), g = null, v = 0, y = 0;
+	function b(e) {
+		m().locale = e, v++, g = null;
+	}
+	async function x(e) {
+		let t = h(), n = t.get(e);
+		if (n) return n;
+		let r = await p.loadMessages(e), i = typeof r == "object" && r && "default" in r ? r.default : r;
+		return t.set(e, i), i;
+	}
+	async function S() {
+		let e = m();
+		!e.locale && p.resolveLocale && (e.locale = await p.resolveLocale());
+		let t = e.locale;
+		if (!t) throw Error("[fluenti] No locale set. Call setLocale(locale) in your layout before using getI18n(), or provide a resolveLocale function in createServerI18n config to auto-detect locale in Server Actions and other contexts where the layout does not run.");
+		if (e.instance && e.instance.locale === t) return e.instance;
+		let n = {};
+		n[t] = await x(t), p.fallbackLocale && p.fallbackLocale !== t && (n[p.fallbackLocale] = await x(p.fallbackLocale));
+		let r = {
+			locale: t,
+			messages: n
+		};
+		return p.fallbackLocale !== void 0 && (r.fallbackLocale = p.fallbackLocale), p.fallbackChain !== void 0 && (r.fallbackChain = p.fallbackChain), p.dateFormats !== void 0 && (r.dateFormats = p.dateFormats), p.numberFormats !== void 0 && (r.numberFormats = p.numberFormats), p.missing !== void 0 && (r.missing = p.missing), e.instance = f(r), g = e.instance, y = v, e.instance;
+	}
+	async function C({ children: e, id: n, context: i, comment: a, render: o }) {
+		let c = await S(), { message: u, components: f } = s(e), p = n ?? t(u, i), m = r(c.t({
+			id: p,
+			message: u,
+			...i === void 0 ? {} : { context: i },
+			...a === void 0 ? {} : { comment: a }
+		}), f);
+		return d(l, null, o ? o(m) : m);
+	}
+	async function w({ value: t, id: r, context: i, comment: o, zero: s, one: u, two: f, few: p, many: m, other: h, offset: g }) {
+		let v = await S(), { messages: y, components: b } = e(a, {
+			zero: s,
+			one: u,
+			two: f,
+			few: p,
+			many: m,
+			other: h
+		}), x = c({
+			...y.zero !== void 0 && { zero: y.zero },
+			...y.one !== void 0 && { one: y.one },
+			...y.two !== void 0 && { two: y.two },
+			...y.few !== void 0 && { few: y.few },
+			...y.many !== void 0 && { many: y.many },
+			other: y.other ?? ""
+		}, g);
+		return d(l, null, n({
+			id: r ?? (i === void 0 ? x : _(x, i)),
+			message: x,
+			...i === void 0 ? {} : { context: i },
+			...o === void 0 ? {} : { comment: o }
+		}, { count: t }, (e, t) => v.t(e, t), b));
+	}
+	async function T({ value: t, id: r, context: a, comment: s, other: c, options: u, ...f }) {
+		let p = await S(), m = u === void 0 ? {
+			...Object.fromEntries(Object.entries(f).filter(([e]) => ![
+				"value",
+				"id",
+				"context",
+				"comment",
+				"options",
+				"other"
+			].includes(e))),
+			other: c
+		} : {
+			...u,
+			other: c
+		}, h = [...Object.keys(m).filter((e) => e !== "other"), "other"], { messages: g, components: v } = e(h, m), y = o(Object.fromEntries([...h].map((e) => [e, g[e] ?? ""]))), b = i(y.forms);
+		return d(l, null, n({
+			id: r ?? (a === void 0 ? b : _(b, a)),
+			message: b,
+			...a === void 0 ? {} : { context: a },
+			...s === void 0 ? {} : { comment: s }
+		}, { value: y.valueMap[t] ?? "other" }, (e, t) => p.t(e, t), v));
+	}
+	async function E({ value: e, style: t }) {
+		return d(l, null, (await S()).d(e, t));
+	}
+	async function D({ value: e, style: t }) {
+		return d(l, null, (await S()).n(e, t));
+	}
+	function O() {
+		let e = m();
+		if (e.instance) return e.instance;
+		if (g && y === v) return g;
+		let t = e.locale ?? p.fallbackLocale ?? "en", n = h(), r = {}, i = n.get(t);
+		if (i && (r[t] = i), p.fallbackLocale && p.fallbackLocale !== t) {
+			let e = n.get(p.fallbackLocale);
+			e && (r[p.fallbackLocale] = e);
+		}
+		let a = {
+			locale: t,
+			messages: r
+		};
+		return p.fallbackLocale !== void 0 && (a.fallbackLocale = p.fallbackLocale), p.fallbackChain !== void 0 && (a.fallbackChain = p.fallbackChain), p.dateFormats !== void 0 && (a.dateFormats = p.dateFormats), p.numberFormats !== void 0 && (a.numberFormats = p.numberFormats), p.missing !== void 0 && (a.missing = p.missing), e.instance = f(a), e.instance;
+	}
+	return {
+		setLocale: b,
+		getI18n: S,
+		__getSyncInstance: O,
+		Trans: C,
+		Plural: w,
+		Select: T,
+		DateTime: E,
+		NumberFormat: D
+	};
+}
+//#endregion
+export { y as createServerI18n, p as detectLocale, m as getDirection, h as getHydratedLocale, g as getSSRLocaleScript, v as isRTL };
+
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","names":[],"sources":["../src/server.ts"],"sourcesContent":["import { cache } from 'react'\nimport { createFluent, hashMessage as hashSyntheticMessage } from '@fluenti/core'\nimport type {\n  FluentInstanceExtended,\n  FluentConfigExtended,\n  Locale,\n  Messages,\n  DateFormatOptions,\n  NumberFormatOptions,\n} from '@fluenti/core'\nimport { createElement, Fragment, type ReactNode, type ReactElement } from 'react'\nimport { hashMessage, extractMessage, reconstruct } from './components/trans-core'\nimport { PLURAL_CATEGORIES, type PluralCategory } from './components/plural-core'\nimport { buildICUPluralMessage, buildICUSelectMessage, normalizeSelectForms, renderRichTranslation, serializeRichForms } from './components/icu-rich'\n\n// Re-export SSR utilities from core for convenience\nexport { detectLocale, getSSRLocaleScript, getHydratedLocale, isRTL, getDirection } from '@fluenti/core'\nexport type { DetectLocaleOptions } from '@fluenti/core'\n\n/**\n * Configuration for `createServerI18n`.\n */\nexport interface ServerI18nConfig {\n  /** Load messages for a given locale. Called once per locale per request. */\n  loadMessages: (locale: string) => Promise<Messages | { default: Messages }>\n  /** Fallback locale when a translation is missing */\n  fallbackLocale?: string\n  /**\n   * Auto-resolve locale when `setLocale()` was not called.\n   *\n   * This is the fallback for contexts where the layout doesn't run — most\n   * notably **Server Actions** (`'use server'`), which are independent\n   * requests that skip the layout tree entirely.\n   *\n   * Common patterns:\n   * - Read from a cookie (Next.js: `cookies().get('locale')`)\n   * - Read from a request header set by middleware\n   * - Query the database for the authenticated user's preference\n   *\n   * If omitted and `setLocale()` was not called, `getI18n()` will throw.\n   *\n   * @example\n   * ```ts\n   * resolveLocale: async () => {\n   *   const { cookies } = await import('next/headers')\n   *   return (await cookies()).get('locale')?.value ?? 'en'\n   * }\n   * ```\n   */\n  resolveLocale?: () => string | Promise<string>\n  /** Custom fallback chains per locale */\n  fallbackChain?: Record<string, Locale[]>\n  /** Custom date format styles */\n  dateFormats?: DateFormatOptions\n  /** Custom number format styles */\n  numberFormats?: NumberFormatOptions\n  /** Handler for missing translation keys */\n  missing?: (locale: Locale, id: string) => string | undefined\n}\n\n// ─── Server Component Props ──────────────────────────────────────────────────\n\nexport interface ServerTransProps {\n  /** Source text with embedded components */\n  children: ReactNode\n  /** Override auto-generated hash ID */\n  id?: string\n  /** Message context used for identity and translator disambiguation */\n  context?: string\n  /** Context comment for translators */\n  comment?: string\n  /** Custom render wrapper */\n  render?: (translation: ReactNode) => ReactNode\n}\n\nexport interface ServerPluralProps {\n  /** The count value */\n  value: number\n  /** Override the auto-generated synthetic ICU message id */\n  id?: string\n  /** Message context used for identity and translator disambiguation */\n  context?: string\n  /** Translator-facing note preserved in extraction catalogs */\n  comment?: string\n  /** Text for zero (if language supports) */\n  zero?: ReactNode\n  /** Singular form. `#` replaced with value */\n  one?: ReactNode\n  /** Dual form (Arabic, etc.) */\n  two?: ReactNode\n  /** Few form (Slavic languages, etc.) */\n  few?: ReactNode\n  /** Many form */\n  many?: ReactNode\n  /** Default plural form */\n  other: ReactNode\n  /** Offset from value before selecting form */\n  offset?: number\n}\n\nexport interface ServerSelectProps {\n  /** The selector value */\n  value: string\n  /** Override the auto-generated synthetic ICU message id */\n  id?: string\n  /** Message context used for identity and translator disambiguation */\n  context?: string\n  /** Translator-facing note preserved in extraction catalogs */\n  comment?: string\n  /** Default case */\n  other: ReactNode\n  /** Type-safe named options. Takes precedence over direct case props. */\n  options?: Record<string, ReactNode>\n  /** Named cases — any string key maps to a ReactNode */\n  [key: string]: ReactNode | Record<string, ReactNode> | string | undefined\n}\n\nexport interface ServerDateTimeProps {\n  /** Date value to format */\n  value: Date | number\n  /** Named format style */\n  style?: string\n}\n\nexport interface ServerNumberProps {\n  /** Number value to format */\n  value: number\n  /** Named format style */\n  style?: string\n}\n\n// ─── Server Component Types ──────────────────────────────────────────────────\n\ntype ServerTransComponent = (props: ServerTransProps) => Promise<ReactElement>\ntype ServerPluralComponent = (props: ServerPluralProps) => Promise<ReactElement>\ntype ServerSelectComponent = (props: ServerSelectProps) => Promise<ReactElement>\ntype ServerDateTimeComponent = (props: ServerDateTimeProps) => Promise<ReactElement>\ntype ServerNumberComponent = (props: ServerNumberProps) => Promise<ReactElement>\n\n/**\n * The object returned by `createServerI18n`.\n */\nexport interface ServerI18n {\n  /**\n   * Set the locale for the current server request.\n   * Call this once in your root layout or page before any `getI18n()` calls.\n   *\n   * Uses `React.cache()` — scoped to the current request automatically.\n   */\n  setLocale: (locale: string) => void\n\n  /**\n   * Get a fully configured i18n instance for the current request.\n   * Messages are loaded lazily and cached per-request.\n   *\n   * @example\n   * ```tsx\n   * // In any Server Component\n   * const { t, d, n, locale } = await getI18n()\n   * return <h1>{t('welcome')}</h1>\n   * ```\n   */\n  getI18n: () => Promise<FluentInstanceExtended & { locale: string }>\n\n  /**\n   * `<Trans>` for React Server Components.\n   * Async component — automatically resolves the i18n instance.\n   *\n   * @example\n   * ```tsx\n   * <Trans>Read the <a href=\"/docs\">documentation</a>.</Trans>\n   * ```\n   */\n  Trans: ServerTransComponent\n\n  /**\n   * `<Plural>` for React Server Components.\n   *\n   * @example\n   * ```tsx\n   * <Plural value={count} one=\"# item\" other=\"# items\" />\n   * ```\n   */\n  Plural: ServerPluralComponent\n\n  /**\n   * `<Select>` for React Server Components.\n   *\n   * @example\n   * ```tsx\n   * <Select value={gender} male=\"He liked this\" other=\"They liked this\" />\n   * ```\n   */\n  Select: ServerSelectComponent\n\n  /**\n   * `<DateTime>` for React Server Components.\n   *\n   * @example\n   * ```tsx\n   * <DateTime value={new Date()} style=\"long\" />\n   * ```\n   */\n  DateTime: ServerDateTimeComponent\n\n  /**\n   * `<NumberFormat>` for React Server Components.\n   *\n   * @example\n   * ```tsx\n   * <NumberFormat value={1234.56} style=\"currency\" />\n   * ```\n   */\n  NumberFormat: ServerNumberComponent\n\n  /**\n   * Synchronous accessor for the cached i18n instance.\n   * Used internally by @fluenti/next webpack loader.\n   * @internal\n   */\n  __getSyncInstance: () => FluentInstanceExtended & { locale: string }\n}\n\n/**\n * Create server-side i18n utilities for React Server Components.\n *\n * Uses `React.cache()` to share state within a single server request\n * without React Context (which is unavailable in Server Components).\n *\n * @example\n * ```ts\n * // lib/i18n.server.ts — define once\n * import { createServerI18n } from '@fluenti/react/server'\n *\n * export const { setLocale, getI18n, Trans, Plural, Select, DateTime, NumberFormat } = createServerI18n({\n *   loadMessages: (locale) => import(`../messages/${locale}.json`),\n *   fallbackLocale: 'en',\n * })\n * ```\n *\n * ```tsx\n * // app/[locale]/layout.tsx — set locale once\n * import { setLocale } from '@/lib/i18n.server'\n *\n * export default async function Layout({ params, children }) {\n *   const { locale } = await params\n *   setLocale(locale)\n *   return <html lang={locale}><body>{children}</body></html>\n * }\n * ```\n *\n * ```tsx\n * // app/[locale]/page.tsx — use Trans, Plural, etc. directly\n * import { Trans, Plural, Select } from '@/lib/i18n.server'\n *\n * export default async function Page() {\n *   return (\n *     <div>\n *       <Trans>Read the <a href=\"/docs\">documentation</a>.</Trans>\n *       <Plural value={5} one=\"# item\" other=\"# items\" />\n *       <Select value=\"male\" male=\"He liked this\" other=\"They liked this\" />\n *     </div>\n *   )\n * }\n * ```\n */\nexport function createServerI18n(config: ServerI18nConfig): ServerI18n {\n  // Request-scoped store using React.cache()\n  // Each server request gets its own isolated state\n  const getRequestStore = cache((): {\n    locale: string | null\n    instance: (FluentInstanceExtended & { locale: string }) | null\n  } => ({\n    locale: null,\n    instance: null,\n  }))\n\n  // Cache loaded messages per-request to avoid redundant imports\n  const getMessageCache = cache((): Map<string, Messages> => new Map())\n\n  // Module-level fallback for server actions where React.cache()\n  // may not share state with the page render.\n  let _lastInstance: (FluentInstanceExtended & { locale: string }) | null = null\n  let _requestId = 0\n  let _lastRequestId = 0\n\n  function setLocale(locale: string): void {\n    getRequestStore().locale = locale\n    _requestId++\n    _lastInstance = null\n  }\n\n  async function loadLocaleMessages(locale: string): Promise<Messages> {\n    const messageCache = getMessageCache()\n    const cached = messageCache.get(locale)\n    if (cached) return cached\n\n    const raw = await config.loadMessages(locale)\n    const messages: Messages =\n      typeof raw === 'object' && raw !== null && 'default' in raw\n        ? (raw as { default: Messages }).default\n        : (raw as Messages)\n\n    messageCache.set(locale, messages)\n    return messages\n  }\n\n  async function getI18n(): Promise<FluentInstanceExtended & { locale: string }> {\n    const store = getRequestStore()\n\n    // If setLocale() was never called (e.g. Server Action — independent request\n    // that skips the layout), try the resolveLocale fallback.\n    if (!store.locale && config.resolveLocale) {\n      store.locale = await config.resolveLocale()\n    }\n\n    const locale = store.locale\n\n    if (!locale) {\n      throw new Error(\n        '[fluenti] No locale set. Call setLocale(locale) in your layout before using getI18n(), ' +\n          'or provide a resolveLocale function in createServerI18n config to auto-detect locale ' +\n          'in Server Actions and other contexts where the layout does not run.',\n      )\n    }\n\n    // Return cached instance if locale hasn't changed\n    if (store.instance && store.instance.locale === locale) {\n      return store.instance\n    }\n\n    // Load messages for current locale (and fallback if configured)\n    const allMessages: Record<string, Messages> = {}\n    allMessages[locale] = await loadLocaleMessages(locale)\n\n    if (config.fallbackLocale && config.fallbackLocale !== locale) {\n      allMessages[config.fallbackLocale] = await loadLocaleMessages(config.fallbackLocale)\n    }\n\n    const fluentConfig: FluentConfigExtended = {\n      locale,\n      messages: allMessages,\n    }\n    if (config.fallbackLocale !== undefined) fluentConfig.fallbackLocale = config.fallbackLocale\n    if (config.fallbackChain !== undefined) fluentConfig.fallbackChain = config.fallbackChain\n    if (config.dateFormats !== undefined) fluentConfig.dateFormats = config.dateFormats\n    if (config.numberFormats !== undefined) fluentConfig.numberFormats = config.numberFormats\n    if (config.missing !== undefined) fluentConfig.missing = config.missing\n\n    store.instance = createFluent(fluentConfig)\n    _lastInstance = store.instance\n    _lastRequestId = _requestId\n    return store.instance\n  }\n\n  // ─── Async Server Components ─────────────────────────────────────────────\n\n  async function Trans({ children, id, context, comment, render }: ServerTransProps): Promise<ReactElement> {\n    const i18n = await getI18n()\n    const { message, components } = extractMessage(children)\n    const messageId = id ?? hashMessage(message, context)\n    const translated = i18n.t({\n      id: messageId,\n      message,\n      ...(context !== undefined ? { context } : {}),\n      ...(comment !== undefined ? { comment } : {}),\n    })\n    const result = reconstruct(translated, components)\n    return createElement(Fragment, null, render ? render(result) : result)\n  }\n\n  async function Plural({\n    value,\n    id,\n    context,\n    comment,\n    zero,\n    one,\n    two,\n    few,\n    many,\n    other,\n    offset,\n  }: ServerPluralProps): Promise<ReactElement> {\n    const i18n = await getI18n()\n    const forms: Record<PluralCategory, ReactNode | undefined> = {\n      zero,\n      one,\n      two,\n      few,\n      many,\n      other,\n    }\n    const { messages, components } = serializeRichForms(PLURAL_CATEGORIES, forms)\n    const icuMessage = buildICUPluralMessage(\n      {\n        ...(messages.zero !== undefined && { zero: messages.zero }),\n        ...(messages.one !== undefined && { one: messages.one }),\n        ...(messages.two !== undefined && { two: messages.two }),\n        ...(messages.few !== undefined && { few: messages.few }),\n        ...(messages.many !== undefined && { many: messages.many }),\n        other: messages.other ?? '',\n      },\n      offset,\n    )\n\n    const result = renderRichTranslation(\n      {\n        id: id ?? (context === undefined ? icuMessage : hashSyntheticMessage(icuMessage, context)),\n        message: icuMessage,\n        ...(context !== undefined ? { context } : {}),\n        ...(comment !== undefined ? { comment } : {}),\n      },\n      { count: value },\n      (descriptor, values) => i18n.t(descriptor, values),\n      components,\n    )\n\n    return createElement(Fragment, null, result)\n  }\n\n  async function Select({\n    value,\n    id,\n    context,\n    comment,\n    other,\n    options,\n    ...cases\n  }: ServerSelectProps): Promise<ReactElement> {\n    const i18n = await getI18n()\n    const forms: Record<string, ReactNode | undefined> = options === undefined\n      ? {\n        ...Object.fromEntries(\n          Object.entries(cases).filter(([key]) => !['value', 'id', 'context', 'comment', 'options', 'other'].includes(key)),\n        ),\n        other,\n      }\n      : {\n        ...options,\n        other,\n      }\n\n    const orderedKeys = [...Object.keys(forms).filter(key => key !== 'other'), 'other'] as const\n    const { messages, components } = serializeRichForms(orderedKeys, forms)\n    const normalized = normalizeSelectForms(\n      Object.fromEntries(\n        [...orderedKeys].map((key) => [key, messages[key] ?? '']),\n      ),\n    )\n    const icuMessage = buildICUSelectMessage(normalized.forms)\n\n    const result = renderRichTranslation(\n      {\n        id: id ?? (context === undefined ? icuMessage : hashSyntheticMessage(icuMessage, context)),\n        message: icuMessage,\n        ...(context !== undefined ? { context } : {}),\n        ...(comment !== undefined ? { comment } : {}),\n      },\n      { value: normalized.valueMap[value] ?? 'other' },\n      (descriptor, values) => i18n.t(descriptor, values),\n      components,\n    )\n\n    return createElement(Fragment, null, result)\n  }\n\n  async function DateTime({ value, style }: ServerDateTimeProps): Promise<ReactElement> {\n    const i18n = await getI18n()\n    return createElement(Fragment, null, i18n.d(value, style))\n  }\n\n  async function NumberFormat({ value, style }: ServerNumberProps): Promise<ReactElement> {\n    const i18n = await getI18n()\n    return createElement(Fragment, null, i18n.n(value, style))\n  }\n\n  /**\n   * Synchronous accessor for the cached i18n instance.\n   * Used by @fluenti/next webpack loader for t`` in RSC.\n   * Throws if getI18n() hasn't been called yet in this request.\n   * @internal\n   */\n  function __getSyncInstance(): FluentInstanceExtended & { locale: string } {\n    const store = getRequestStore()\n    if (store.instance) {\n      return store.instance\n    }\n\n    // Module-level fallback for server actions where React.cache()\n    // may not share state across different call contexts.\n    // Only use within the same request (tracked by _requestId).\n    if (_lastInstance && _lastRequestId === _requestId) {\n      return _lastInstance\n    }\n\n    // Final fallback: create instance synchronously with the default locale.\n    // This handles Suspense boundaries and streamed components where\n    // the React.cache store may not have been populated yet.\n    const locale = store.locale ?? config.fallbackLocale ?? 'en'\n    const messageCache = getMessageCache()\n    const messages: Record<string, Messages> = {}\n    const cached = messageCache.get(locale)\n    if (cached) messages[locale] = cached\n    if (config.fallbackLocale && config.fallbackLocale !== locale) {\n      const fallback = messageCache.get(config.fallbackLocale)\n      if (fallback) messages[config.fallbackLocale] = fallback\n    }\n\n    const fluentConfig: FluentConfigExtended = { locale, messages }\n    if (config.fallbackLocale !== undefined) fluentConfig.fallbackLocale = config.fallbackLocale\n    if (config.fallbackChain !== undefined) fluentConfig.fallbackChain = config.fallbackChain\n    if (config.dateFormats !== undefined) fluentConfig.dateFormats = config.dateFormats\n    if (config.numberFormats !== undefined) fluentConfig.numberFormats = config.numberFormats\n    if (config.missing !== undefined) fluentConfig.missing = config.missing\n\n    store.instance = createFluent(fluentConfig)\n    return store.instance\n  }\n\n  return { setLocale, getI18n, __getSyncInstance, Trans, Plural, Select, DateTime, NumberFormat }\n}\n"],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,55 @@
+import { ReactNode } from 'react';
+import { Locale, Messages, AllMessages, MessageDescriptor, CompileTimeMessageDescriptor, CompileTimeT, DateFormatOptions, NumberFormatOptions, FluentInstanceExtended } from '@fluenti/core';
+export interface I18nContextValue {
+    /** The underlying Fluent instance (escape hatch for advanced use) */
+    i18n: FluentInstanceExtended;
+    /** Translate a message by id with optional interpolation values */
+    t: {
+        (id: string | MessageDescriptor, values?: Record<string, unknown>): string;
+        (strings: TemplateStringsArray, ...exprs: unknown[]): string;
+    };
+    /** Format a date value for the current locale */
+    d: (value: Date | number, style?: string) => string;
+    /** Format a number value for the current locale */
+    n: (value: number, style?: string) => string;
+    /** Format an ICU message string directly (no catalog lookup) */
+    format: (message: string, values?: Record<string, unknown>) => string;
+    /** Merge additional messages into a locale catalog at runtime */
+    loadMessages: (locale: string, messages: Messages) => void;
+    /** Return all locale codes that have loaded messages */
+    getLocales: () => string[];
+    /** Current locale */
+    locale: string;
+    /** Change the active locale (async when lazy loading) */
+    setLocale: (locale: string) => Promise<void>;
+    /** Whether a locale is currently being loaded */
+    isLoading: boolean;
+    /** Set of locales whose messages have been loaded */
+    loadedLocales: string[];
+    /** Preload a locale in the background without switching to it */
+    preloadLocale: (locale: string) => Promise<void>;
+}
+export interface I18nProviderProps {
+    /** Active locale code */
+    locale: string;
+    /** Fallback locale when translation is missing */
+    fallbackLocale?: string;
+    /** Static message catalogs */
+    messages?: AllMessages;
+    /** Async loader for lazy loading */
+    loadMessages?: (locale: string) => Promise<Messages | {
+        default: Messages;
+    }>;
+    /** Custom fallback chains per locale */
+    fallbackChain?: Record<string, string[]>;
+    /** Date format styles */
+    dateFormats?: DateFormatOptions;
+    /** Number format styles */
+    numberFormats?: NumberFormatOptions;
+    /** Missing message handler */
+    missing?: (locale: Locale, id: string) => string | undefined;
+    /** App content */
+    children: ReactNode;
+}
+export type { Locale, Messages, AllMessages, MessageDescriptor, CompileTimeMessageDescriptor, CompileTimeT, DateFormatOptions, NumberFormatOptions, FluentInstanceExtended, };
+//# 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,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EACV,MAAM,EACN,QAAQ,EACR,WAAW,EACX,iBAAiB,EACjB,4BAA4B,EAC5B,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,eAAe,CAAA;AAEtB,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,IAAI,EAAE,sBAAsB,CAAA;IAC5B,mEAAmE;IACnE,CAAC,EAAE;QACD,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAA;QAC1E,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAAA;KAC7D,CAAA;IACD,iDAAiD;IACjD,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;IACnD,mDAAmD;IACnD,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;IAC5C,gEAAgE;IAChE,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAA;IACrE,iEAAiE;IACjE,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAA;IAC1D,wDAAwD;IACxD,UAAU,EAAE,MAAM,MAAM,EAAE,CAAA;IAC1B,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,yDAAyD;IACzD,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5C,iDAAiD;IACjD,SAAS,EAAE,OAAO,CAAA;IAClB,qDAAqD;IACrD,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,iEAAiE;IACjE,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACjD;AAED,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,kDAAkD;IAClD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,oCAAoC;IACpC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,GAAG;QAAE,OAAO,EAAE,QAAQ,CAAA;KAAE,CAAC,CAAA;IAC5E,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IACxC,yBAAyB;IACzB,WAAW,CAAC,EAAE,iBAAiB,CAAA;IAC/B,2BAA2B;IAC3B,aAAa,CAAC,EAAE,mBAAmB,CAAA;IACnC,8BAA8B;IAC9B,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;IAC5D,kBAAkB;IAClB,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED,YAAY,EACV,MAAM,EACN,QAAQ,EACR,WAAW,EACX,iBAAiB,EACjB,4BAA4B,EAC5B,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,GACvB,CAAA"}

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@fluenti/react",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "React bindings for Fluenti — I18nProvider, useI18n, Trans/Plural/Select components",
+  "homepage": "https://fluenti.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/usefluenti/fluenti.git",
+    "directory": "packages/react"
+  },
+  "bugs": {
+    "url": "https://github.com/usefluenti/fluenti/issues"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "i18n",
+    "internationalization",
+    "compile-time",
+    "icu",
+    "messageformat",
+    "react",
+    "hooks",
+    "provider"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./server": {
+      "import": {
+        "types": "./dist/server.d.ts",
+        "default": "./dist/server.js"
+      },
+      "require": {
+        "types": "./dist/server.d.ts",
+        "default": "./dist/server.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "dependencies": {
+    "@fluenti/core": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.9",
+    "vite": "^8",
+    "vite-plugin-dts": "^4",
+    "vitest": "^4",
+    "@vitest/coverage-v8": "^4",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "@testing-library/react": "^16.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "happy-dom": "^20"
+  },
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite build --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}