@fluenti/react 0.2.0 → 0.3.0

package/dist/types.d.ts

@@ -1,19 +1,17 @@
 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;
+import { Locale, LocalizedString, Messages, AllMessages, CompiledMessage, MessageDescriptor, CompileTimeMessageDescriptor, CompileTimeT, DateFormatOptions, NumberFormatOptions, DiagnosticsConfig } from '@fluenti/core';
+export interface FluentiContext {
     /** Translate a message by id with optional interpolation values */
     t: {
-        (id: string | MessageDescriptor, values?: Record<string, unknown>): string;
-        (strings: TemplateStringsArray, ...exprs: unknown[]): string;
+        (id: string | MessageDescriptor, values?: Record<string, unknown>): LocalizedString;
+        (strings: TemplateStringsArray, ...exprs: unknown[]): LocalizedString;
     };
     /** Format a date value for the current locale */
-    d: (value: Date | number, style?: string) => string;
+    d: (value: Date | number, style?: string) => LocalizedString;
     /** Format a number value for the current locale */
-    n: (value: number, style?: string) => string;
+    n: (value: number, style?: string) => LocalizedString;
     /** Format an ICU message string directly (no catalog lookup) */
-    format: (message: string, values?: Record<string, unknown>) => string;
+    format: (message: string, values?: Record<string, unknown>) => LocalizedString;
     /** Merge additional messages into a locale catalog at runtime */
     loadMessages: (locale: string, messages: Messages) => void;
     /** Return all locale codes that have loaded messages */
@@ -28,6 +26,10 @@ export interface I18nContextValue {
     loadedLocales: string[];
     /** Preload a locale in the background without switching to it */
     preloadLocale: (locale: string) => Promise<void>;
+    /** Check if a translation key exists for the given or current locale */
+    te: (key: string, locale?: string) => boolean;
+    /** Get the raw compiled message for a key without interpolation */
+    tm: (key: string, locale?: string) => CompiledMessage | undefined;
 }
 export interface I18nProviderProps {
     /** Active locale code */
@@ -48,8 +50,13 @@ export interface I18nProviderProps {
     numberFormats?: NumberFormatOptions;
     /** Missing message handler */
     missing?: (locale: Locale, id: string) => string | undefined;
+    /** Runtime diagnostics configuration */
+    diagnostics?: DiagnosticsConfig;
     /** App content */
     children: ReactNode;
+    /** Pre-created FluentiInstance (alternative to inline config) */
+    instance?: import('./create-fluenti').FluentiInstance;
 }
-export type { Locale, Messages, AllMessages, MessageDescriptor, CompileTimeMessageDescriptor, CompileTimeT, DateFormatOptions, NumberFormatOptions, FluentInstanceExtended, };
+export type FluentiProviderProps = I18nProviderProps;
+export type { Locale, LocalizedString, Messages, AllMessages, MessageDescriptor, CompileTimeMessageDescriptor, CompileTimeT, DateFormatOptions, NumberFormatOptions, };
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/vite-plugin.cjs

@@ -1,110 +1,2 @@
-let e=require(`@fluenti/vite-plugin`),t=require(`node:path`);var n={generateRuntime(e){let{catalogDir:n,locales:r,sourceLocale:i,defaultBuildLocale:a}=e,o=a||i,s=(0,t.resolve)(process.cwd(),n);return`
-import __defaultMsgs from '${s}/${o}.js'
-
-const __catalog = { ...__defaultMsgs }
-let __currentLocale = '${o}'
-const __loadedLocales = new Set(['${o}'])
-let __loading = false
-const __cache = new Map()
-const __normalizeMessages = (mod) => mod.default ?? mod
-
-const __loaders = {
-${r.filter(e=>e!==o).map(e=>`  '${e}': () => import('${s}/${e}.js'),`).join(`
-`)}
-}
-
-async function __switchLocale(locale) {
-  if (__loadedLocales.has(locale)) {
-    Object.assign(__catalog, __cache.get(locale) || __defaultMsgs)
-    __currentLocale = locale
-    return
-  }
-  __loading = true
-  try {
-    const mod = __normalizeMessages(await __loaders[locale]())
-    __cache.set(locale, mod)
-    __loadedLocales.add(locale)
-    Object.assign(__catalog, mod)
-    __currentLocale = locale
-  } finally {
-    __loading = false
-  }
-}
-
-async function __preloadLocale(locale) {
-  if (__loadedLocales.has(locale) || !__loaders[locale]) return
-  try {
-    const mod = __normalizeMessages(await __loaders[locale]())
-    __cache.set(locale, mod)
-    __loadedLocales.add(locale)
-  } catch (e) { console.warn('[fluenti] preload failed:', locale, e) }
-}
-
-globalThis[Symbol.for('fluenti.runtime.react')] = { __switchLocale, __preloadLocale }
-
-export { __catalog, __switchLocale, __preloadLocale, __currentLocale, __loading, __loadedLocales }
-`},generateRouteRuntime(e){let{catalogDir:n,locales:r,sourceLocale:i,defaultBuildLocale:a}=e,o=a||i,s=(0,t.resolve)(process.cwd(),n);return`
-import __defaultMsgs from '${s}/${o}.js'
-
-const __catalog = { ...__defaultMsgs }
-let __currentLocale = '${o}'
-const __loadedLocales = new Set(['${o}'])
-let __loading = false
-const __cache = new Map()
-const __loadedRoutes = new Set()
-const __normalizeMessages = (mod) => mod.default ?? mod
-
-const __loaders = {
-${r.filter(e=>e!==o).map(e=>`  '${e}': () => import('${s}/${e}.js'),`).join(`
-`)}
-}
-
-const __routeLoaders = {}
-
-function __registerRouteLoader(routeId, locale, loader) {
-  const key = routeId + ':' + locale
-  __routeLoaders[key] = loader
-}
-
-async function __loadRoute(routeId, locale) {
-  const key = routeId + ':' + (locale || __currentLocale)
-  if (__loadedRoutes.has(key)) return
-  const loader = __routeLoaders[key]
-  if (!loader) return
-  const mod = __normalizeMessages(await loader())
-  Object.assign(__catalog, mod)
-  __loadedRoutes.add(key)
-}
-
-async function __switchLocale(locale) {
-  if (locale === __currentLocale) return
-  __loading = true
-  try {
-    if (__cache.has(locale)) {
-      Object.assign(__catalog, __cache.get(locale))
-    } else {
-      const mod = __normalizeMessages(await __loaders[locale]())
-      __cache.set(locale, mod)
-      Object.assign(__catalog, mod)
-    }
-    __loadedLocales.add(locale)
-    __currentLocale = locale
-  } finally {
-    __loading = false
-  }
-}
-
-async function __preloadLocale(locale) {
-  if (__cache.has(locale) || !__loaders[locale]) return
-  try {
-    const mod = __normalizeMessages(await __loaders[locale]())
-    __cache.set(locale, mod)
-    __loadedLocales.add(locale)
-  } catch (e) { console.warn('[fluenti] preload failed:', locale, e) }
-}
-
-globalThis[Symbol.for('fluenti.runtime.react')] = { __switchLocale, __preloadLocale }
-
-export { __catalog, __switchLocale, __preloadLocale, __loadRoute, __registerRouteLoader, __currentLocale, __loading, __loadedLocales }
-`}};function r(t){return(0,e.createFluentiPlugins)({...t,framework:`react`},[],n)}module.exports=r;
+let e=require(`@fluenti/vite-plugin`);var t=(0,e.createRuntimeGenerator)({imports:``,catalogInit:`const __catalog = { ...__defaultMsgs }`,localeInit:e=>`let __currentLocale = '${e}'`,loadingInit:`let __loading = false`,catalogUpdate:e=>`Object.assign(__catalog, ${e})`,localeUpdate:e=>`__currentLocale = ${e}`,loadingUpdate:e=>`__loading = ${e}`,localeRead:`__currentLocale`,runtimeKey:`fluenti.runtime.react.v1`});function n(n){return(0,e.createFluentiPlugins)({...n?.config===void 0?{}:{config:n.config},framework:`react`},[],t)}module.exports=n;
 //# sourceMappingURL=vite-plugin.cjs.map

package/dist/vite-plugin.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"vite-plugin.cjs","names":[],"sources":["../src/react-runtime.ts","../src/vite-plugin.ts"],"sourcesContent":["import { resolve } from 'node:path'\nimport type { RuntimeGenerator, RuntimeGeneratorOptions } from '@fluenti/vite-plugin'\n\nexport const reactRuntimeGenerator: RuntimeGenerator = {\n  generateRuntime(options: RuntimeGeneratorOptions): string {\n    const { catalogDir, locales, sourceLocale, defaultBuildLocale } = options\n    const defaultLocale = defaultBuildLocale || sourceLocale\n    const absoluteCatalogDir = resolve(process.cwd(), catalogDir)\n    const runtimeKey = 'fluenti.runtime.react'\n    const lazyLocales = locales.filter((locale) => locale !== defaultLocale)\n\n    return `\nimport __defaultMsgs from '${absoluteCatalogDir}/${defaultLocale}.js'\n\nconst __catalog = { ...__defaultMsgs }\nlet __currentLocale = '${defaultLocale}'\nconst __loadedLocales = new Set(['${defaultLocale}'])\nlet __loading = false\nconst __cache = new Map()\nconst __normalizeMessages = (mod) => mod.default ?? mod\n\nconst __loaders = {\n${lazyLocales.map((l) => `  '${l}': () => import('${absoluteCatalogDir}/${l}.js'),`).join('\\n')}\n}\n\nasync function __switchLocale(locale) {\n  if (__loadedLocales.has(locale)) {\n    Object.assign(__catalog, __cache.get(locale) || __defaultMsgs)\n    __currentLocale = locale\n    return\n  }\n  __loading = true\n  try {\n    const mod = __normalizeMessages(await __loaders[locale]())\n    __cache.set(locale, mod)\n    __loadedLocales.add(locale)\n    Object.assign(__catalog, mod)\n    __currentLocale = locale\n  } finally {\n    __loading = false\n  }\n}\n\nasync function __preloadLocale(locale) {\n  if (__loadedLocales.has(locale) || !__loaders[locale]) return\n  try {\n    const mod = __normalizeMessages(await __loaders[locale]())\n    __cache.set(locale, mod)\n    __loadedLocales.add(locale)\n  } catch (e) { console.warn('[fluenti] preload failed:', locale, e) }\n}\n\nglobalThis[Symbol.for('${runtimeKey}')] = { __switchLocale, __preloadLocale }\n\nexport { __catalog, __switchLocale, __preloadLocale, __currentLocale, __loading, __loadedLocales }\n`\n  },\n\n  generateRouteRuntime(options: RuntimeGeneratorOptions): string {\n    const { catalogDir, locales, sourceLocale, defaultBuildLocale } = options\n    const defaultLocale = defaultBuildLocale || sourceLocale\n    const absoluteCatalogDir = resolve(process.cwd(), catalogDir)\n    const runtimeKey = 'fluenti.runtime.react'\n    const lazyLocales = locales.filter((locale) => locale !== defaultLocale)\n\n    return `\nimport __defaultMsgs from '${absoluteCatalogDir}/${defaultLocale}.js'\n\nconst __catalog = { ...__defaultMsgs }\nlet __currentLocale = '${defaultLocale}'\nconst __loadedLocales = new Set(['${defaultLocale}'])\nlet __loading = false\nconst __cache = new Map()\nconst __loadedRoutes = new Set()\nconst __normalizeMessages = (mod) => mod.default ?? mod\n\nconst __loaders = {\n${lazyLocales.map((l) => `  '${l}': () => import('${absoluteCatalogDir}/${l}.js'),`).join('\\n')}\n}\n\nconst __routeLoaders = {}\n\nfunction __registerRouteLoader(routeId, locale, loader) {\n  const key = routeId + ':' + locale\n  __routeLoaders[key] = loader\n}\n\nasync function __loadRoute(routeId, locale) {\n  const key = routeId + ':' + (locale || __currentLocale)\n  if (__loadedRoutes.has(key)) return\n  const loader = __routeLoaders[key]\n  if (!loader) return\n  const mod = __normalizeMessages(await loader())\n  Object.assign(__catalog, mod)\n  __loadedRoutes.add(key)\n}\n\nasync function __switchLocale(locale) {\n  if (locale === __currentLocale) return\n  __loading = true\n  try {\n    if (__cache.has(locale)) {\n      Object.assign(__catalog, __cache.get(locale))\n    } else {\n      const mod = __normalizeMessages(await __loaders[locale]())\n      __cache.set(locale, mod)\n      Object.assign(__catalog, mod)\n    }\n    __loadedLocales.add(locale)\n    __currentLocale = locale\n  } finally {\n    __loading = false\n  }\n}\n\nasync function __preloadLocale(locale) {\n  if (__cache.has(locale) || !__loaders[locale]) return\n  try {\n    const mod = __normalizeMessages(await __loaders[locale]())\n    __cache.set(locale, mod)\n    __loadedLocales.add(locale)\n  } catch (e) { console.warn('[fluenti] preload failed:', locale, e) }\n}\n\nglobalThis[Symbol.for('${runtimeKey}')] = { __switchLocale, __preloadLocale }\n\nexport { __catalog, __switchLocale, __preloadLocale, __loadRoute, __registerRouteLoader, __currentLocale, __loading, __loadedLocales }\n`\n  },\n}\n","import type { Plugin } from 'vite'\nimport type { FluentiPluginOptions } from '@fluenti/vite-plugin'\nimport { createFluentiPlugins } from '@fluenti/vite-plugin'\nimport { reactRuntimeGenerator } from './react-runtime'\n\nexport type { FluentiPluginOptions as FluentiReactOptions } from '@fluenti/vite-plugin'\n\nexport default function fluentiReact(options?: FluentiPluginOptions): Plugin[] {\n  return createFluentiPlugins(\n    { ...options, framework: 'react' },\n    [],\n    reactRuntimeGenerator,\n  )\n}\n"],"mappings":"6DAGA,IAAa,EAA0C,CACrD,gBAAgB,EAA0C,CACxD,GAAM,CAAE,aAAY,UAAS,eAAc,sBAAuB,EAC5D,EAAgB,GAAsB,EACtC,GAAA,EAAA,EAAA,SAA6B,QAAQ,KAAK,CAAE,EAAW,CAI7D,MAAO;6BACkB,EAAmB,GAAG,EAAc;;;yBAGxC,EAAc;oCACH,EAAc;;;;;;EAP1B,EAAQ,OAAQ,GAAW,IAAW,EAAc,CAa9D,IAAK,GAAM,MAAM,EAAE,mBAAmB,EAAmB,GAAG,EAAE,QAAQ,CAAC,KAAK;EAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoC9F,qBAAqB,EAA0C,CAC7D,GAAM,CAAE,aAAY,UAAS,eAAc,sBAAuB,EAC5D,EAAgB,GAAsB,EACtC,GAAA,EAAA,EAAA,SAA6B,QAAQ,KAAK,CAAE,EAAW,CAI7D,MAAO;6BACkB,EAAmB,GAAG,EAAc;;;yBAGxC,EAAc;oCACH,EAAc;;;;;;;EAP1B,EAAQ,OAAQ,GAAW,IAAW,EAAc,CAc9D,IAAK,GAAM,MAAM,EAAE,mBAAmB,EAAmB,GAAG,EAAE,QAAQ,CAAC,KAAK;EAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoD/F,CC1HD,SAAwB,EAAa,EAA0C,CAC7E,OAAA,EAAA,EAAA,sBACE,CAAE,GAAG,EAAS,UAAW,QAAS,CAClC,EAAE,CACF,EACD"}
+{"version":3,"file":"vite-plugin.cjs","names":[],"sources":["../src/react-runtime.ts","../src/vite-plugin.ts"],"sourcesContent":["import { createRuntimeGenerator } from '@fluenti/vite-plugin'\nimport type { RuntimeGenerator } from '@fluenti/vite-plugin'\n\nexport const reactRuntimeGenerator: RuntimeGenerator = createRuntimeGenerator({\n  imports: '',\n  catalogInit: 'const __catalog = { ...__defaultMsgs }',\n  localeInit: (defaultLocale) => `let __currentLocale = '${defaultLocale}'`,\n  loadingInit: 'let __loading = false',\n  catalogUpdate: (msgs) => `Object.assign(__catalog, ${msgs})`,\n  localeUpdate: (locale) => `__currentLocale = ${locale}`,\n  loadingUpdate: (value) => `__loading = ${value}`,\n  localeRead: '__currentLocale',\n  runtimeKey: 'fluenti.runtime.react.v1',\n})\n","import type { Plugin } from 'vite'\nimport type { FluentiPluginOptions } from '@fluenti/vite-plugin'\nimport { createFluentiPlugins } from '@fluenti/vite-plugin'\nimport { reactRuntimeGenerator } from './react-runtime'\n\nexport type { FluentiPluginOptions as FluentiReactOptions } from '@fluenti/vite-plugin'\n\nexport default function fluentiReact(options?: FluentiPluginOptions): Plugin[] {\n  return createFluentiPlugins(\n    { ...(options?.config !== undefined ? { config: options.config } : {}), framework: 'react' },\n    [],\n    reactRuntimeGenerator,\n  )\n}\n"],"mappings":"sCAGA,IAAa,GAAA,EAAA,EAAA,wBAAiE,CAC5E,QAAS,GACT,YAAa,yCACb,WAAa,GAAkB,0BAA0B,EAAc,GACvE,YAAa,wBACb,cAAgB,GAAS,4BAA4B,EAAK,GAC1D,aAAe,GAAW,qBAAqB,IAC/C,cAAgB,GAAU,eAAe,IACzC,WAAY,kBACZ,WAAY,2BACb,CAAC,CCNF,SAAwB,EAAa,EAA0C,CAC7E,OAAA,EAAA,EAAA,sBACE,CAAE,GAAI,GAAS,SAAW,IAAA,GAAyC,EAAE,CAA/B,CAAE,OAAQ,EAAQ,OAAQ,CAAQ,UAAW,QAAS,CAC5F,EAAE,CACF,EACD"}

package/dist/vite-plugin.js

@@ -1,127 +1,21 @@
-import { createFluentiPlugins as e } from "@fluenti/vite-plugin";
-import { resolve as t } from "node:path";
+import { createFluentiPlugins as e, createRuntimeGenerator as t } from "@fluenti/vite-plugin";
 //#region src/react-runtime.ts
-var n = {
-	generateRuntime(e) {
-		let { catalogDir: n, locales: r, sourceLocale: i, defaultBuildLocale: a } = e, o = a || i, s = t(process.cwd(), n);
-		return `
-import __defaultMsgs from '${s}/${o}.js'
-
-const __catalog = { ...__defaultMsgs }
-let __currentLocale = '${o}'
-const __loadedLocales = new Set(['${o}'])
-let __loading = false
-const __cache = new Map()
-const __normalizeMessages = (mod) => mod.default ?? mod
-
-const __loaders = {
-${r.filter((e) => e !== o).map((e) => `  '${e}': () => import('${s}/${e}.js'),`).join("\n")}
-}
-
-async function __switchLocale(locale) {
-  if (__loadedLocales.has(locale)) {
-    Object.assign(__catalog, __cache.get(locale) || __defaultMsgs)
-    __currentLocale = locale
-    return
-  }
-  __loading = true
-  try {
-    const mod = __normalizeMessages(await __loaders[locale]())
-    __cache.set(locale, mod)
-    __loadedLocales.add(locale)
-    Object.assign(__catalog, mod)
-    __currentLocale = locale
-  } finally {
-    __loading = false
-  }
-}
-
-async function __preloadLocale(locale) {
-  if (__loadedLocales.has(locale) || !__loaders[locale]) return
-  try {
-    const mod = __normalizeMessages(await __loaders[locale]())
-    __cache.set(locale, mod)
-    __loadedLocales.add(locale)
-  } catch (e) { console.warn('[fluenti] preload failed:', locale, e) }
-}
-
-globalThis[Symbol.for('fluenti.runtime.react')] = { __switchLocale, __preloadLocale }
-
-export { __catalog, __switchLocale, __preloadLocale, __currentLocale, __loading, __loadedLocales }
-`;
-	},
-	generateRouteRuntime(e) {
-		let { catalogDir: n, locales: r, sourceLocale: i, defaultBuildLocale: a } = e, o = a || i, s = t(process.cwd(), n);
-		return `
-import __defaultMsgs from '${s}/${o}.js'
-
-const __catalog = { ...__defaultMsgs }
-let __currentLocale = '${o}'
-const __loadedLocales = new Set(['${o}'])
-let __loading = false
-const __cache = new Map()
-const __loadedRoutes = new Set()
-const __normalizeMessages = (mod) => mod.default ?? mod
-
-const __loaders = {
-${r.filter((e) => e !== o).map((e) => `  '${e}': () => import('${s}/${e}.js'),`).join("\n")}
-}
-
-const __routeLoaders = {}
-
-function __registerRouteLoader(routeId, locale, loader) {
-  const key = routeId + ':' + locale
-  __routeLoaders[key] = loader
-}
-
-async function __loadRoute(routeId, locale) {
-  const key = routeId + ':' + (locale || __currentLocale)
-  if (__loadedRoutes.has(key)) return
-  const loader = __routeLoaders[key]
-  if (!loader) return
-  const mod = __normalizeMessages(await loader())
-  Object.assign(__catalog, mod)
-  __loadedRoutes.add(key)
-}
-
-async function __switchLocale(locale) {
-  if (locale === __currentLocale) return
-  __loading = true
-  try {
-    if (__cache.has(locale)) {
-      Object.assign(__catalog, __cache.get(locale))
-    } else {
-      const mod = __normalizeMessages(await __loaders[locale]())
-      __cache.set(locale, mod)
-      Object.assign(__catalog, mod)
-    }
-    __loadedLocales.add(locale)
-    __currentLocale = locale
-  } finally {
-    __loading = false
-  }
-}
-
-async function __preloadLocale(locale) {
-  if (__cache.has(locale) || !__loaders[locale]) return
-  try {
-    const mod = __normalizeMessages(await __loaders[locale]())
-    __cache.set(locale, mod)
-    __loadedLocales.add(locale)
-  } catch (e) { console.warn('[fluenti] preload failed:', locale, e) }
-}
-
-globalThis[Symbol.for('fluenti.runtime.react')] = { __switchLocale, __preloadLocale }
-
-export { __catalog, __switchLocale, __preloadLocale, __loadRoute, __registerRouteLoader, __currentLocale, __loading, __loadedLocales }
-`;
-	}
-};
+var n = t({
+	imports: "",
+	catalogInit: "const __catalog = { ...__defaultMsgs }",
+	localeInit: (e) => `let __currentLocale = '${e}'`,
+	loadingInit: "let __loading = false",
+	catalogUpdate: (e) => `Object.assign(__catalog, ${e})`,
+	localeUpdate: (e) => `__currentLocale = ${e}`,
+	loadingUpdate: (e) => `__loading = ${e}`,
+	localeRead: "__currentLocale",
+	runtimeKey: "fluenti.runtime.react.v1"
+});
 //#endregion
 //#region src/vite-plugin.ts
 function r(t) {
 	return e({
-		...t,
+		...t?.config === void 0 ? {} : { config: t.config },
 		framework: "react"
 	}, [], n);
 }

package/dist/vite-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"vite-plugin.js","names":[],"sources":["../src/react-runtime.ts","../src/vite-plugin.ts"],"sourcesContent":["import { resolve } from 'node:path'\nimport type { RuntimeGenerator, RuntimeGeneratorOptions } from '@fluenti/vite-plugin'\n\nexport const reactRuntimeGenerator: RuntimeGenerator = {\n  generateRuntime(options: RuntimeGeneratorOptions): string {\n    const { catalogDir, locales, sourceLocale, defaultBuildLocale } = options\n    const defaultLocale = defaultBuildLocale || sourceLocale\n    const absoluteCatalogDir = resolve(process.cwd(), catalogDir)\n    const runtimeKey = 'fluenti.runtime.react'\n    const lazyLocales = locales.filter((locale) => locale !== defaultLocale)\n\n    return `\nimport __defaultMsgs from '${absoluteCatalogDir}/${defaultLocale}.js'\n\nconst __catalog = { ...__defaultMsgs }\nlet __currentLocale = '${defaultLocale}'\nconst __loadedLocales = new Set(['${defaultLocale}'])\nlet __loading = false\nconst __cache = new Map()\nconst __normalizeMessages = (mod) => mod.default ?? mod\n\nconst __loaders = {\n${lazyLocales.map((l) => `  '${l}': () => import('${absoluteCatalogDir}/${l}.js'),`).join('\\n')}\n}\n\nasync function __switchLocale(locale) {\n  if (__loadedLocales.has(locale)) {\n    Object.assign(__catalog, __cache.get(locale) || __defaultMsgs)\n    __currentLocale = locale\n    return\n  }\n  __loading = true\n  try {\n    const mod = __normalizeMessages(await __loaders[locale]())\n    __cache.set(locale, mod)\n    __loadedLocales.add(locale)\n    Object.assign(__catalog, mod)\n    __currentLocale = locale\n  } finally {\n    __loading = false\n  }\n}\n\nasync function __preloadLocale(locale) {\n  if (__loadedLocales.has(locale) || !__loaders[locale]) return\n  try {\n    const mod = __normalizeMessages(await __loaders[locale]())\n    __cache.set(locale, mod)\n    __loadedLocales.add(locale)\n  } catch (e) { console.warn('[fluenti] preload failed:', locale, e) }\n}\n\nglobalThis[Symbol.for('${runtimeKey}')] = { __switchLocale, __preloadLocale }\n\nexport { __catalog, __switchLocale, __preloadLocale, __currentLocale, __loading, __loadedLocales }\n`\n  },\n\n  generateRouteRuntime(options: RuntimeGeneratorOptions): string {\n    const { catalogDir, locales, sourceLocale, defaultBuildLocale } = options\n    const defaultLocale = defaultBuildLocale || sourceLocale\n    const absoluteCatalogDir = resolve(process.cwd(), catalogDir)\n    const runtimeKey = 'fluenti.runtime.react'\n    const lazyLocales = locales.filter((locale) => locale !== defaultLocale)\n\n    return `\nimport __defaultMsgs from '${absoluteCatalogDir}/${defaultLocale}.js'\n\nconst __catalog = { ...__defaultMsgs }\nlet __currentLocale = '${defaultLocale}'\nconst __loadedLocales = new Set(['${defaultLocale}'])\nlet __loading = false\nconst __cache = new Map()\nconst __loadedRoutes = new Set()\nconst __normalizeMessages = (mod) => mod.default ?? mod\n\nconst __loaders = {\n${lazyLocales.map((l) => `  '${l}': () => import('${absoluteCatalogDir}/${l}.js'),`).join('\\n')}\n}\n\nconst __routeLoaders = {}\n\nfunction __registerRouteLoader(routeId, locale, loader) {\n  const key = routeId + ':' + locale\n  __routeLoaders[key] = loader\n}\n\nasync function __loadRoute(routeId, locale) {\n  const key = routeId + ':' + (locale || __currentLocale)\n  if (__loadedRoutes.has(key)) return\n  const loader = __routeLoaders[key]\n  if (!loader) return\n  const mod = __normalizeMessages(await loader())\n  Object.assign(__catalog, mod)\n  __loadedRoutes.add(key)\n}\n\nasync function __switchLocale(locale) {\n  if (locale === __currentLocale) return\n  __loading = true\n  try {\n    if (__cache.has(locale)) {\n      Object.assign(__catalog, __cache.get(locale))\n    } else {\n      const mod = __normalizeMessages(await __loaders[locale]())\n      __cache.set(locale, mod)\n      Object.assign(__catalog, mod)\n    }\n    __loadedLocales.add(locale)\n    __currentLocale = locale\n  } finally {\n    __loading = false\n  }\n}\n\nasync function __preloadLocale(locale) {\n  if (__cache.has(locale) || !__loaders[locale]) return\n  try {\n    const mod = __normalizeMessages(await __loaders[locale]())\n    __cache.set(locale, mod)\n    __loadedLocales.add(locale)\n  } catch (e) { console.warn('[fluenti] preload failed:', locale, e) }\n}\n\nglobalThis[Symbol.for('${runtimeKey}')] = { __switchLocale, __preloadLocale }\n\nexport { __catalog, __switchLocale, __preloadLocale, __loadRoute, __registerRouteLoader, __currentLocale, __loading, __loadedLocales }\n`\n  },\n}\n","import type { Plugin } from 'vite'\nimport type { FluentiPluginOptions } from '@fluenti/vite-plugin'\nimport { createFluentiPlugins } from '@fluenti/vite-plugin'\nimport { reactRuntimeGenerator } from './react-runtime'\n\nexport type { FluentiPluginOptions as FluentiReactOptions } from '@fluenti/vite-plugin'\n\nexport default function fluentiReact(options?: FluentiPluginOptions): Plugin[] {\n  return createFluentiPlugins(\n    { ...options, framework: 'react' },\n    [],\n    reactRuntimeGenerator,\n  )\n}\n"],"mappings":";;;AAGA,IAAa,IAA0C;CACrD,gBAAgB,GAA0C;EACxD,IAAM,EAAE,eAAY,YAAS,iBAAc,0BAAuB,GAC5D,IAAgB,KAAsB,GACtC,IAAqB,EAAQ,QAAQ,KAAK,EAAE,EAAW;AAI7D,SAAO;6BACkB,EAAmB,GAAG,EAAc;;;yBAGxC,EAAc;oCACH,EAAc;;;;;;EAP1B,EAAQ,QAAQ,MAAW,MAAW,EAAc,CAa9D,KAAK,MAAM,MAAM,EAAE,mBAAmB,EAAmB,GAAG,EAAE,QAAQ,CAAC,KAAK,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoC9F,qBAAqB,GAA0C;EAC7D,IAAM,EAAE,eAAY,YAAS,iBAAc,0BAAuB,GAC5D,IAAgB,KAAsB,GACtC,IAAqB,EAAQ,QAAQ,KAAK,EAAE,EAAW;AAI7D,SAAO;6BACkB,EAAmB,GAAG,EAAc;;;yBAGxC,EAAc;oCACH,EAAc;;;;;;;EAP1B,EAAQ,QAAQ,MAAW,MAAW,EAAc,CAc9D,KAAK,MAAM,MAAM,EAAE,mBAAmB,EAAmB,GAAG,EAAE,QAAQ,CAAC,KAAK,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoD/F;;;AC1HD,SAAwB,EAAa,GAA0C;AAC7E,QAAO,EACL;EAAE,GAAG;EAAS,WAAW;EAAS,EAClC,EAAE,EACF,EACD"}
+{"version":3,"file":"vite-plugin.js","names":[],"sources":["../src/react-runtime.ts","../src/vite-plugin.ts"],"sourcesContent":["import { createRuntimeGenerator } from '@fluenti/vite-plugin'\nimport type { RuntimeGenerator } from '@fluenti/vite-plugin'\n\nexport const reactRuntimeGenerator: RuntimeGenerator = createRuntimeGenerator({\n  imports: '',\n  catalogInit: 'const __catalog = { ...__defaultMsgs }',\n  localeInit: (defaultLocale) => `let __currentLocale = '${defaultLocale}'`,\n  loadingInit: 'let __loading = false',\n  catalogUpdate: (msgs) => `Object.assign(__catalog, ${msgs})`,\n  localeUpdate: (locale) => `__currentLocale = ${locale}`,\n  loadingUpdate: (value) => `__loading = ${value}`,\n  localeRead: '__currentLocale',\n  runtimeKey: 'fluenti.runtime.react.v1',\n})\n","import type { Plugin } from 'vite'\nimport type { FluentiPluginOptions } from '@fluenti/vite-plugin'\nimport { createFluentiPlugins } from '@fluenti/vite-plugin'\nimport { reactRuntimeGenerator } from './react-runtime'\n\nexport type { FluentiPluginOptions as FluentiReactOptions } from '@fluenti/vite-plugin'\n\nexport default function fluentiReact(options?: FluentiPluginOptions): Plugin[] {\n  return createFluentiPlugins(\n    { ...(options?.config !== undefined ? { config: options.config } : {}), framework: 'react' },\n    [],\n    reactRuntimeGenerator,\n  )\n}\n"],"mappings":";;AAGA,IAAa,IAA0C,EAAuB;CAC5E,SAAS;CACT,aAAa;CACb,aAAa,MAAkB,0BAA0B,EAAc;CACvE,aAAa;CACb,gBAAgB,MAAS,4BAA4B,EAAK;CAC1D,eAAe,MAAW,qBAAqB;CAC/C,gBAAgB,MAAU,eAAe;CACzC,YAAY;CACZ,YAAY;CACb,CAAC;;;ACNF,SAAwB,EAAa,GAA0C;AAC7E,QAAO,EACL;EAAE,GAAI,GAAS,WAAW,KAAA,IAAyC,EAAE,GAA/B,EAAE,QAAQ,EAAQ,QAAQ;EAAQ,WAAW;EAAS,EAC5F,EAAE,EACF,EACD"}

package/llms-full.txt

@@ -0,0 +1,185 @@
+# @fluenti/react
+
+> React bindings for Fluenti — compile-time `t`, runtime-capable components, and client/server i18n helpers.
+
+@fluenti/react is the React runtime layer for Fluenti. It supports:
+
+- compile-time authoring with `import { t } from '@fluenti/react'`
+- runtime lookup and imperative access with `useI18n()`
+- async locale loading through `I18nProvider`
+- request-scoped server helpers through `@fluenti/react/server`
+
+## Install
+
+```bash
+pnpm add @fluenti/core @fluenti/react
+pnpm add -D @fluenti/cli @fluenti/vite-plugin
+```
+
+## Main entry: `@fluenti/react`
+
+### Public exports
+
+- `I18nProvider`
+- `useI18n`
+- `t`
+- `Trans`
+- `Plural`
+- `Select`
+- `DateTime`
+- `NumberFormat`
+- `msg`
+- `I18nContext`
+
+Types:
+
+- `FluentiContext`
+- `I18nProviderProps`
+- `FluentiTransProps`
+- `FluentiPluralProps`
+- `FluentiSelectProps`
+- `FluentiDateTimeProps`
+- `NumberFormatProps`
+- `CompileTimeT`
+
+### `I18nProvider`
+
+Wraps a client React subtree with one Fluenti runtime instance.
+
+Important props:
+
+- `locale`
+- `messages`
+- `fallbackLocale`
+- `fallbackChain`
+- `loadMessages`
+- `dateFormats`
+- `numberFormats`
+- `missing`
+
+`loadMessages(locale)` is the public lazy-loading hook for async locale chunks.
+
+### `useI18n()`
+
+Returns the full client runtime API:
+
+- `t(idOrDescriptor, values?)`
+- tagged-template `t\`\``
+- `d(value, style?)`
+- `n(value, style?)`
+- `format(message, values?)`
+- `loadMessages(locale, messages)`
+- `getLocales()`
+- `locale`
+- `setLocale(locale)`
+- `isLoading`
+- `loadedLocales`
+- `preloadLocale(locale)`
+- `te(id)` — check if a translation key exists
+- `tm(id)` — get the raw compiled message without interpolation
+
+## Compile-time `t`
+
+Imported `t` is compile-time only:
+
+```tsx
+import { t } from '@fluenti/react'
+
+const headline = t`Hello ${name}`                               // ✅ Preferred
+const label = t({ message: 'Hello {name}', context: 'home.hero' }, { name }) // ✅ Preferred
+```
+
+Use `useI18n().t()` for runtime ID lookup or other imperative code:
+
+```tsx
+const { t } = useI18n()
+return <p>{t('dashboard.greeting')}</p>  // ⚠️ Runtime fallback — use only for dynamic keys
+```
+
+If imported `t` runs at runtime without the build plugin, it throws a clear error.
+
+## Runtime-capable components
+
+These continue to work without the build plugin:
+
+- `Trans`
+- `Plural`
+- `Select`
+- `DateTime`
+- `NumberFormat`
+
+Cross-framework contract highlights:
+
+- `Plural` supports `id`, `context`, `comment`, and `offset`
+- `zero` maps to exact `=0`
+- `#` uses the adjusted count
+- `Select` supports `options`, which take precedence over direct case props
+
+## Example
+
+```tsx
+import { I18nProvider, t, useI18n, Trans, Plural, Select } from '@fluenti/react'
+
+function Home() {
+  const name = 'Fluenti'
+  const headline = t`Hello ${name}`
+  const { setLocale, preloadLocale } = useI18n()
+
+  return (
+    <>
+      <h1>{headline}</h1>
+      <Trans>Read the <a href="/docs">documentation</a></Trans>
+      <Plural value={3} one="# item" other="# items" />
+      <Select value="admin" admin="Administrator" other="User" />
+      <button onMouseEnter={() => void preloadLocale('ja')} onClick={() => void setLocale('ja')}>
+        日本語
+      </button>
+    </>
+  )
+}
+
+export default function App() {
+  return (
+    <I18nProvider
+      locale="en"
+      fallbackLocale="en"
+      messages={{ en }}
+      loadMessages={(locale) => import(`./locales/compiled/${locale}.js`)}
+    >
+      <Home />
+    </I18nProvider>
+  )
+}
+```
+
+## Server entry: `@fluenti/react/server`
+
+### `createServerI18n(config)`
+
+Creates request-scoped runtime helpers for server rendering.
+
+Config:
+
+- `loadMessages(locale)`
+- `fallbackLocale`
+- `resolveLocale`
+- `fallbackChain`
+- `dateFormats`
+- `numberFormats`
+- `missing`
+
+Returns:
+
+- `setLocale(locale)`
+- `getI18n()`
+- `Trans`
+- `Plural`
+- `Select`
+- `DateTime`
+- `NumberFormat`
+
+Use this for server-side runtime access. It is distinct from imported compile-time `t`.
+
+## Build plugin relationship
+
+`@fluenti/react` is the runtime layer. `@fluenti/vite-plugin` and `@fluenti/next` provide compile-time transforms for imported `t` and component optimizations.