@fluenti/react 0.2.1 → 0.3.1

package/llms-migration.txt

@@ -0,0 +1,272 @@
+# Migrating to @fluenti/react from react-i18next / react-intl
+
+> Step-by-step guide to migrate a React app from react-i18next or react-intl (FormatJS) to Fluenti.
+
+## Overview
+
+Fluenti is a **compile-time** i18n library — translations are compiled to optimized JS at build time. Unlike react-i18next and react-intl which parse messages at runtime, Fluenti produces zero-overhead string functions.
+
+Key differences:
+- No runtime message parser — messages become plain strings or template literal functions
+- ICU MessageFormat for all syntax (plurals, selects, numbers, dates)
+- PO or JSON catalog format, managed by CLI extraction and compilation
+- Vite plugin or Next.js plugin for build-time transforms
+
+---
+
+## Migrating from react-i18next
+
+### 1. Install Fluenti
+
+```bash
+pnpm add @fluenti/core @fluenti/react
+pnpm add -D @fluenti/cli
+```
+
+### 2. Replace provider setup
+
+Before (react-i18next):
+```tsx
+import i18n from 'i18next'
+import { initReactI18next, I18nextProvider } from 'react-i18next'
+
+i18n.use(initReactI18next).init({
+  resources: { en: { translation: messages } },
+  lng: 'en',
+})
+
+<I18nextProvider i18n={i18n}><App /></I18nextProvider>
+```
+
+After (Fluenti):
+```tsx
+import { I18nProvider } from '@fluenti/react'
+import en from './locales/compiled/en'
+
+<I18nProvider locale="en" fallbackLocale="en" messages={{ en }}>
+  <App />
+</I18nProvider>
+```
+
+### 3. Update hook usage
+
+Before (react-i18next):
+```tsx
+import { useTranslation } from 'react-i18next'
+const { t, i18n } = useTranslation()
+t('hello', { name: 'World' })
+i18n.changeLanguage('ja')
+```
+
+After (Fluenti):
+```tsx
+import { useI18n } from '@fluenti/react'
+const { i18n, setLocale } = useI18n()
+i18n.t('hello', { name: 'World' })
+setLocale('ja')
+```
+
+### 4. Replace components
+
+Before (react-i18next):
+```tsx
+import { Trans } from 'react-i18next'
+<Trans i18nKey="welcome">
+  Welcome to <strong>our app</strong>
+</Trans>
+```
+
+After (Fluenti):
+```tsx
+import { Trans } from '@fluenti/react'
+<Trans message="Welcome to {0}our app{1}">
+  {(text) => <strong>{text}</strong>}
+</Trans>
+```
+
+### 5. Convert message syntax
+
+react-i18next interpolation → ICU:
+```
+# react-i18next
+"hello": "Hello, {{name}}!"
+
+# Fluenti (ICU MessageFormat)
+"hello": "Hello, {name}!"
+```
+
+react-i18next plurals → ICU plural:
+```
+# react-i18next
+"items": "{{count}} item"
+"items_plural": "{{count}} items"
+
+# Fluenti (ICU)
+"items": "{count, plural, one {{count} item} other {{count} items}}"
+```
+
+### API Mapping: react-i18next → Fluenti
+
+| react-i18next | Fluenti |
+|---------------|---------|
+| `useTranslation()` | `useI18n()` |
+| `t(key, options)` | `i18n.t(key, values)` |
+| `i18n.changeLanguage(lng)` | `setLocale(locale)` |
+| `i18n.language` | `locale` |
+| `<Trans>` | `<Trans>` |
+| `<I18nextProvider>` | `<I18nProvider>` |
+| `{{var}}` interpolation | `{var}` interpolation |
+| `_plural` suffix | ICU `{n, plural, ...}` |
+| Namespaces | Not needed (use message IDs) |
+| Backend plugins | `loadMessages` prop on provider |
+
+---
+
+## Migrating from react-intl (FormatJS)
+
+### 1. Install Fluenti
+
+```bash
+pnpm add @fluenti/core @fluenti/react
+pnpm add -D @fluenti/cli
+```
+
+### 2. Replace provider
+
+Before (react-intl):
+```tsx
+import { IntlProvider } from 'react-intl'
+<IntlProvider locale="en" messages={messages}>
+  <App />
+</IntlProvider>
+```
+
+After (Fluenti):
+```tsx
+import { I18nProvider } from '@fluenti/react'
+import en from './locales/compiled/en'
+<I18nProvider locale="en" fallbackLocale="en" messages={{ en }}>
+  <App />
+</I18nProvider>
+```
+
+### 3. Update hook usage
+
+Before (react-intl):
+```tsx
+import { useIntl } from 'react-intl'
+const intl = useIntl()
+intl.formatMessage({ id: 'hello' }, { name: 'World' })
+intl.formatDate(date, { dateStyle: 'long' })
+intl.formatNumber(1234, { style: 'decimal' })
+```
+
+After (Fluenti):
+```tsx
+import { useI18n } from '@fluenti/react'
+const { i18n } = useI18n()
+i18n.t('hello', { name: 'World' })
+i18n.d(date, 'long')
+i18n.n(1234, 'decimal')
+```
+
+### 4. Replace components
+
+Before (react-intl):
+```tsx
+import { FormattedMessage, FormattedDate, FormattedNumber } from 'react-intl'
+<FormattedMessage id="hello" values={{ name: 'World' }} />
+<FormattedDate value={date} dateStyle="long" />
+<FormattedNumber value={1234} style="decimal" />
+```
+
+After (Fluenti):
+```tsx
+import { Trans, DateTime, NumberFormat } from '@fluenti/react'
+<Trans message="Hello, {name}!" values={{ name: 'World' }} />
+<DateTime value={date} style="long" />
+<NumberFormat value={1234} style="decimal" />
+```
+
+### 5. Message format
+
+react-intl already uses ICU MessageFormat, so most messages work as-is. Key differences:
+
+```
+# react-intl — uses defaultMessage
+defineMessage({ id: 'hello', defaultMessage: 'Hello, {name}!' })
+
+# Fluenti — messages live in catalog files, referenced by ID
+i18n.t('hello', { name: 'World' })
+```
+
+### API Mapping: react-intl → Fluenti
+
+| react-intl | Fluenti |
+|------------|---------|
+| `<IntlProvider>` | `<I18nProvider>` |
+| `useIntl()` | `useI18n()` |
+| `intl.formatMessage()` | `i18n.t()` |
+| `intl.formatDate()` | `i18n.d()` |
+| `intl.formatNumber()` | `i18n.n()` |
+| `<FormattedMessage>` | `<Trans>` |
+| `<FormattedDate>` | `<DateTime>` |
+| `<FormattedNumber>` | `<NumberFormat>` |
+| `<FormattedPlural>` | `<Plural>` |
+| `defineMessage()` | `msg()` |
+| ICU MessageFormat | ICU MessageFormat (compatible) |
+
+---
+
+## Common Steps for Both
+
+### Set up Fluenti CLI config
+
+```ts
+// fluenti.config.ts
+export default {
+  sourceLocale: 'en',
+  locales: ['en', 'ja', 'zh-CN'],
+  catalogDir: './locales',
+  format: 'po',
+  include: ['./src/**/*.{tsx,jsx,ts,js}'],
+  compileOutDir: './locales/compiled',
+}
+```
+
+### Extract and compile
+
+```bash
+npx fluenti extract    # Extract messages from source
+npx fluenti compile    # Compile to JS modules
+```
+
+### Vite plugin setup
+
+```ts
+// vite.config.ts
+import react from '@vitejs/plugin-react'
+import fluentiReact from '@fluenti/react/vite-plugin'
+
+export default {
+  plugins: [react(), fluentiReact()],
+}
+```
+
+### For Next.js projects
+
+Use @fluenti/next instead of the Vite plugin:
+
+```ts
+// next.config.ts
+import { withFluenti } from '@fluenti/next'
+export default withFluenti({})
+```
+
+## Key Behavioral Differences
+
+1. **Compile-time** — syntax errors caught at build time, not runtime
+2. **No runtime parser** — smaller bundle, faster rendering
+3. **PO file support** — compatible with Poedit, Crowdin, Weblate
+4. **CLI-managed catalogs** — extract → translate → compile workflow
+5. **AI translation** — `npx fluenti translate --provider claude` for automated translation

package/llms.txt

@@ -0,0 +1,62 @@
+# @fluenti/react
+
+> React bindings for Fluenti — compile-time `t`, runtime-capable components, and client/server i18n helpers.
+
+@fluenti/react provides the React runtime for Fluenti. The recommended public path is:
+
+- compile-time authoring: `import { t } from '@fluenti/react'`
+- runtime / imperative access: `useI18n()`
+- server runtime access: `createServerI18n()` from `@fluenti/react/server`
+
+## Install
+
+```bash
+pnpm add @fluenti/core @fluenti/react
+pnpm add -D @fluenti/cli @fluenti/vite-plugin
+```
+
+## Main Exports
+
+Main entry (`@fluenti/react`):
+
+- `I18nProvider`
+- `useI18n()`
+- `t`
+- `Trans`, `Plural`, `Select`, `DateTime`, `NumberFormat`
+- `msg`
+- `I18nContext`
+
+Type re-exports from `@fluenti/react`:
+
+- `FluentiContext`, `I18nProviderProps`, `Messages`, `AllMessages`, `MessageDescriptor`, `CompileTimeMessageDescriptor`, `CompileTimeT`, `Locale`, `DateFormatOptions`, `NumberFormatOptions`
+- `FluentiTransProps`, `FluentiPluralProps`, `FluentiSelectProps`, `FluentiDateTimeProps`, `NumberFormatProps` — component prop types
+
+Server entry (`@fluenti/react/server`):
+
+- `createServerI18n()`
+- SSR helpers re-exported from `@fluenti/core`
+
+## Important Boundaries
+
+- imported `t` is compile-time only and requires the Fluenti plugin / loader
+- `useI18n().t()` is the full runtime API on the client
+- `createServerI18n()` is the full runtime API on the server
+- `Trans / Plural / Select / DateTime / NumberFormat` remain runtime-capable without the build plugin
+
+## Preferred Usage (compile-time first)
+
+1. t\`\` tagged template — t\`Hello {name}\` (primary compile-time API)
+2. `<Trans>` / `<Plural>` / `<Select>` — rich text with inline markup
+3. `msg` tagged template — outside components (route meta, stores)
+4. `useI18n().t()` / `createServerI18n().t()` — runtime fallback for dynamic keys only
+
+❌ AVOID: `t('some.key')` as the default — this is a legacy i18n pattern.
+
+## Lazy locale loading
+
+React uses `loadMessages(locale)` on `I18nProvider` for async locale chunks.
+
+## Docs
+
+- Full docs: https://fluenti.dev
+- Source: https://github.com/usefluenti/fluenti

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluenti/react",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "type": "module",
   "description": "React bindings for Fluenti — I18nProvider, useI18n, Trans/Plural/Select components",
   "homepage": "https://fluenti.dev",
@@ -62,7 +62,8 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "llms*.txt"
   ],
   "peerDependencies": {
     "react": ">=18.0.0",
@@ -74,8 +75,8 @@
     }
   },
   "dependencies": {
-    "@fluenti/core": "0.2.1",
-    "@fluenti/vite-plugin": "0.2.1"
+    "@fluenti/core": "0.3.1",
+    "@fluenti/vite-plugin": "0.3.1"
   },
   "devDependencies": {
     "typescript": "^5.9",
@@ -94,6 +95,7 @@
     "build": "vite build",
     "dev": "vite build --watch",
     "test": "vitest run",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "bench": "vitest bench"
   }
 }

package/dist/icu-rich-DBeWY1k6.js

@@ -1,108 +0,0 @@
-import { Children as e, Fragment as t, cloneElement as n, createElement as r, isValidElement as i } from "react";
-import { hashMessage as a } from "@fluenti/core";
-//#region src/components/trans-core.ts
-function o(n) {
-	let r = [], a = "";
-	return e.forEach(n, (e) => {
-		if (typeof e == "string" || typeof e == "number") a += String(e);
-		else if (i(e)) {
-			if (e.type === t) {
-				let t = o(e.props.children);
-				a += s(t.message, r.length), r.push(...t.components);
-				return;
-			}
-			let n = r.length, i = o(e.props.children);
-			r.push(e), r.push(...i.components), a += `<${n}>${s(i.message, n + 1)}</${n}>`;
-		}
-	}), {
-		message: a,
-		components: r
-	};
-}
-function s(e, t) {
-	return t === 0 ? e : e.replace(/<(\d+)(\/?>)/g, (e, n, r) => `<${Number(n) + t}${r}`).replace(/<\/(\d+)>/g, (e, n) => `</${Number(n) + t}>`);
-}
-function c(e, i) {
-	let a = /<(\d+)>([\s\S]*?)<\/\1>/g, o = [], s = 0, l;
-	for (a.lastIndex = 0, l = a.exec(e); l !== null;) {
-		l.index > s && o.push(e.slice(s, l.index));
-		let t = Number(l[1]), r = l[2], u = i[t];
-		if (u) {
-			let e = c(r, i);
-			o.push(n(u, { key: `trans-${t}` }, e));
-		} else o.push(r);
-		s = a.lastIndex, l = a.exec(e);
-	}
-	return s < e.length && o.push(e.slice(s)), o.length === 1 ? o[0] : r(t, null, ...o);
-}
-//#endregion
-//#region src/components/plural-core.ts
-var l = [
-	"zero",
-	"one",
-	"two",
-	"few",
-	"many",
-	"other"
-];
-//#endregion
-//#region src/components/icu-rich.tsx
-function u(e, t) {
-	let n = [];
-	for (let t of l) {
-		let r = e[t];
-		r !== void 0 && n.push(`${t === "zero" ? "=0" : t} {${r}}`);
-	}
-	return `{count, plural, ${t ? `offset:${t} ` : ""}${n.join(" ")}}`;
-}
-function d(e) {
-	return `{value, select, ${Object.entries(e).filter(([, e]) => e !== void 0).map(([e, t]) => `${e} {${t}}`).join(" ")}}`;
-}
-function f(e) {
-	let t = {}, n = {}, r = 0;
-	for (let [i, a] of Object.entries(e)) {
-		if (i === "other") {
-			t.other = a;
-			continue;
-		}
-		let e = /^[A-Za-z0-9_]+$/.test(i) ? i : `case_${r++}`;
-		t[e] = a, n[i] = e;
-	}
-	return t.other === void 0 && (t.other = ""), {
-		forms: t,
-		valueMap: n
-	};
-}
-function p(e) {
-	let t = o(e);
-	return {
-		message: t.message,
-		components: t.components
-	};
-}
-function m(e, t) {
-	let n = [], r = {};
-	for (let i of e) {
-		let e = t[i];
-		if (e === void 0) continue;
-		let a = p(e);
-		r[i] = s(a.message, n.length), n.push(...a.components);
-	}
-	for (let [i, a] of Object.entries(t)) {
-		if (e.includes(i) || a === void 0) continue;
-		let t = p(a);
-		r[i] = s(t.message, n.length), n.push(...t.components);
-	}
-	return {
-		messages: r,
-		components: n
-	};
-}
-function h(e, t, n, r) {
-	let i = n(e, t);
-	return r.length > 0 ? c(i, r) : i;
-}
-//#endregion
-export { m as a, a as c, h as i, c as l, d as n, l as o, f as r, o as s, u as t };
-
-//# sourceMappingURL=icu-rich-DBeWY1k6.js.map

package/dist/icu-rich-DBeWY1k6.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"icu-rich-DBeWY1k6.js","names":[],"sources":["../src/components/trans-core.ts","../src/components/plural-core.ts","../src/components/icu-rich.tsx"],"sourcesContent":["import {\n  Children,\n  isValidElement,\n  cloneElement,\n  createElement,\n  Fragment,\n  type ReactNode,\n  type ReactElement,\n} from 'react'\nimport { hashMessage } from '@fluenti/core'\n\nexport { hashMessage }\n\n/**\n * Extract a message string and component list from React children.\n *\n * Converts:\n *   <Trans>Hello <b>{name}</b>, welcome!</Trans>\n * Into:\n *   message: \"Hello <0>{name}</0>, welcome!\"\n *   components: [<b>{name}</b>]\n *\n * @internal\n */\nexport function extractMessage(children: ReactNode): {\n  message: string\n  components: ReactElement[]\n} {\n  const components: ReactElement[] = []\n  let message = ''\n\n  Children.forEach(children, (child) => {\n    if (typeof child === 'string' || typeof child === 'number') {\n      message += String(child)\n    } else if (isValidElement(child)) {\n      if (child.type === Fragment) {\n        const inner = extractMessage((child.props as { children?: ReactNode }).children)\n        message += offsetIndices(inner.message, components.length)\n        components.push(...inner.components)\n        return\n      }\n\n      const idx = components.length\n      const inner = extractMessage((child.props as { children?: ReactNode }).children)\n      components.push(child)\n      components.push(...inner.components)\n      message += `<${idx}>${offsetIndices(inner.message, idx + 1)}</${idx}>`\n    }\n  })\n\n  return { message, components }\n}\n\nexport function offsetIndices(message: string, offset: number): string {\n  if (offset === 0) return message\n  return message\n    .replace(/<(\\d+)(\\/?>)/g, (_match, index: string, suffix: string) => `<${Number(index) + offset}${suffix}`)\n    .replace(/<\\/(\\d+)>/g, (_match, index: string) => `</${Number(index) + offset}>`)\n}\n\n/**\n * Reconstruct a translated message string back into React elements.\n *\n * Parses \"<0>content</0>\" tags and replaces them with cloned components.\n *\n * @internal\n */\nexport function reconstruct(\n  translated: string,\n  components: ReactElement[],\n): ReactNode {\n  const TAG_RE = /<(\\d+)>([\\s\\S]*?)<\\/\\1>/g\n  const result: ReactNode[] = []\n  let lastIndex = 0\n  let match: RegExpExecArray | null\n\n  TAG_RE.lastIndex = 0\n  match = TAG_RE.exec(translated)\n\n  while (match !== null) {\n    if (match.index > lastIndex) {\n      result.push(translated.slice(lastIndex, match.index))\n    }\n\n    const idx = Number(match[1])\n    const innerText = match[2]!\n    const component = components[idx]\n\n    if (component) {\n      // Recursively reconstruct inner content\n      const innerContent = reconstruct(innerText, components)\n      result.push(\n        cloneElement(component, { key: `trans-${idx}` }, innerContent),\n      )\n    } else {\n      result.push(innerText)\n    }\n\n    lastIndex = TAG_RE.lastIndex\n    match = TAG_RE.exec(translated)\n  }\n\n  if (lastIndex < translated.length) {\n    result.push(translated.slice(lastIndex))\n  }\n\n  return result.length === 1 ? result[0]! : createElement(Fragment, null, ...result)\n}\n","import type { ReactNode } from 'react'\n\nexport const PLURAL_CATEGORIES = ['zero', 'one', 'two', 'few', 'many', 'other'] as const\nexport type PluralCategory = (typeof PLURAL_CATEGORIES)[number]\n\n/**\n * Resolve which plural category to use.\n * Checks for exact =0 match first, then falls back to CLDR rules.\n * @internal\n */\nexport function resolveCategory(\n  value: number,\n  locale: string,\n  available: Record<string, boolean>,\n): PluralCategory {\n  if (value === 0 && available['zero']) return 'zero'\n  const cldr = new Intl.PluralRules(locale).select(value) as PluralCategory\n  if (available[cldr]) return cldr\n  return 'other'\n}\n\n/**\n * Replace `#` with the formatted value in a ReactNode.\n * @internal\n */\nexport function replaceHash(node: ReactNode, formatted: string): ReactNode {\n  if (typeof node === 'string') {\n    return node.replace(/#/g, formatted)\n  }\n  return node\n}\n","import type { MessageDescriptor } from '@fluenti/core'\nimport type { ReactElement, ReactNode } from 'react'\nimport { extractMessage, offsetIndices, reconstruct } from './trans-core'\nimport { PLURAL_CATEGORIES, type PluralCategory } from './plural-core'\n\nexport interface RichMessagePart {\n  message: string\n  components: ReactElement[]\n}\n\nexport function buildICUPluralMessage(\n  forms: Partial<Record<PluralCategory, string>> & { other: string },\n  offset?: number,\n): string {\n  const parts: string[] = []\n  for (const cat of PLURAL_CATEGORIES) {\n    const text = forms[cat]\n    if (text === undefined) continue\n    parts.push(`${cat === 'zero' ? '=0' : cat} {${text}}`)\n  }\n  const offsetPrefix = offset ? `offset:${offset} ` : ''\n  return `{count, plural, ${offsetPrefix}${parts.join(' ')}}`\n}\n\nexport function buildICUSelectMessage(\n  forms: Record<string, string>,\n): string {\n  const entries = Object.entries(forms).filter(([, text]) => text !== undefined)\n  return `{value, select, ${entries.map(([key, text]) => `${key} {${text}}`).join(' ')}}`\n}\n\nexport function normalizeSelectForms(\n  forms: Record<string, string>,\n): {\n  forms: Record<string, string>\n  valueMap: Record<string, string>\n} {\n  const normalized: Record<string, string> = {}\n  const valueMap: Record<string, string> = {}\n  let index = 0\n\n  for (const [key, text] of Object.entries(forms)) {\n    if (key === 'other') {\n      normalized['other'] = text\n      continue\n    }\n\n    const safeKey = /^[A-Za-z0-9_]+$/.test(key) ? key : `case_${index++}`\n    normalized[safeKey] = text\n    valueMap[key] = safeKey\n  }\n\n  if (normalized['other'] === undefined) {\n    normalized['other'] = ''\n  }\n\n  return { forms: normalized, valueMap }\n}\n\nexport function serializeRichNode(node: ReactNode): RichMessagePart {\n  const extracted = extractMessage(node)\n  return {\n    message: extracted.message,\n    components: extracted.components,\n  }\n}\n\nexport function serializeRichForms<T extends string>(\n  keys: readonly T[],\n  forms: Partial<Record<T, ReactNode>> & Record<string, ReactNode | undefined>,\n): {\n  messages: Partial<Record<T, string>> & Record<string, string>\n  components: ReactElement[]\n} {\n  const components: ReactElement[] = []\n  const messages: Record<string, string> = {}\n\n  for (const key of keys) {\n    const value = forms[key]\n    if (value === undefined) continue\n    const extracted = serializeRichNode(value)\n    messages[key] = offsetIndices(extracted.message, components.length)\n    components.push(...extracted.components)\n  }\n\n  for (const [key, value] of Object.entries(forms)) {\n    if (keys.includes(key as T) || value === undefined) continue\n    const extracted = serializeRichNode(value)\n    messages[key] = offsetIndices(extracted.message, components.length)\n    components.push(...extracted.components)\n  }\n\n  return { messages: messages as Partial<Record<T, string>> & Record<string, string>, components }\n}\n\nexport function renderRichTranslation(\n  descriptor: MessageDescriptor,\n  values: Record<string, unknown> | undefined,\n  translate: (descriptor: MessageDescriptor, values?: Record<string, unknown>) => string,\n  components: ReactElement[],\n): ReactNode {\n  const translated = translate(descriptor, values)\n  return components.length > 0 ? reconstruct(translated, components) : translated\n}\n"],"mappings":"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"}

package/dist/icu-rich-XY1SdM5K.cjs

@@ -1,2 +0,0 @@
-let e=require(`react`);require(`@fluenti/core`);function t(r){let i=[],a=``;return e.Children.forEach(r,r=>{if(typeof r==`string`||typeof r==`number`)a+=String(r);else if((0,e.isValidElement)(r)){if(r.type===e.Fragment){let e=t(r.props.children);a+=n(e.message,i.length),i.push(...e.components);return}let o=i.length,s=t(r.props.children);i.push(r),i.push(...s.components),a+=`<${o}>${n(s.message,o+1)}</${o}>`}}),{message:a,components:i}}function n(e,t){return t===0?e:e.replace(/<(\d+)(\/?>)/g,(e,n,r)=>`<${Number(n)+t}${r}`).replace(/<\/(\d+)>/g,(e,n)=>`</${Number(n)+t}>`)}function r(t,n){let i=/<(\d+)>([\s\S]*?)<\/\1>/g,a=[],o=0,s;for(i.lastIndex=0,s=i.exec(t);s!==null;){s.index>o&&a.push(t.slice(o,s.index));let c=Number(s[1]),l=s[2],u=n[c];if(u){let t=r(l,n);a.push((0,e.cloneElement)(u,{key:`trans-${c}`},t))}else a.push(l);o=i.lastIndex,s=i.exec(t)}return o<t.length&&a.push(t.slice(o)),a.length===1?a[0]:(0,e.createElement)(e.Fragment,null,...a)}var i=[`zero`,`one`,`two`,`few`,`many`,`other`];function a(e,t){let n=[];for(let t of i){let r=e[t];r!==void 0&&n.push(`${t===`zero`?`=0`:t} {${r}}`)}return`{count, plural, ${t?`offset:${t} `:``}${n.join(` `)}}`}function o(e){return`{value, select, ${Object.entries(e).filter(([,e])=>e!==void 0).map(([e,t])=>`${e} {${t}}`).join(` `)}}`}function s(e){let t={},n={},r=0;for(let[i,a]of Object.entries(e)){if(i===`other`){t.other=a;continue}let e=/^[A-Za-z0-9_]+$/.test(i)?i:`case_${r++}`;t[e]=a,n[i]=e}return t.other===void 0&&(t.other=``),{forms:t,valueMap:n}}function c(e){let n=t(e);return{message:n.message,components:n.components}}function l(e,t){let r=[],i={};for(let a of e){let e=t[a];if(e===void 0)continue;let o=c(e);i[a]=n(o.message,r.length),r.push(...o.components)}for(let[a,o]of Object.entries(t)){if(e.includes(a)||o===void 0)continue;let t=c(o);i[a]=n(t.message,r.length),r.push(...t.components)}return{messages:i,components:r}}function u(e,t,n,i){let a=n(e,t);return i.length>0?r(a,i):a}Object.defineProperty(exports,`a`,{enumerable:!0,get:function(){return l}}),Object.defineProperty(exports,`c`,{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return u}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,`o`,{enumerable:!0,get:function(){return i}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,`s`,{enumerable:!0,get:function(){return t}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return a}});
-//# sourceMappingURL=icu-rich-XY1SdM5K.cjs.map

package/dist/icu-rich-XY1SdM5K.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"icu-rich-XY1SdM5K.cjs","names":[],"sources":["../src/components/trans-core.ts","../src/components/plural-core.ts","../src/components/icu-rich.tsx"],"sourcesContent":["import {\n  Children,\n  isValidElement,\n  cloneElement,\n  createElement,\n  Fragment,\n  type ReactNode,\n  type ReactElement,\n} from 'react'\nimport { hashMessage } from '@fluenti/core'\n\nexport { hashMessage }\n\n/**\n * Extract a message string and component list from React children.\n *\n * Converts:\n *   <Trans>Hello <b>{name}</b>, welcome!</Trans>\n * Into:\n *   message: \"Hello <0>{name}</0>, welcome!\"\n *   components: [<b>{name}</b>]\n *\n * @internal\n */\nexport function extractMessage(children: ReactNode): {\n  message: string\n  components: ReactElement[]\n} {\n  const components: ReactElement[] = []\n  let message = ''\n\n  Children.forEach(children, (child) => {\n    if (typeof child === 'string' || typeof child === 'number') {\n      message += String(child)\n    } else if (isValidElement(child)) {\n      if (child.type === Fragment) {\n        const inner = extractMessage((child.props as { children?: ReactNode }).children)\n        message += offsetIndices(inner.message, components.length)\n        components.push(...inner.components)\n        return\n      }\n\n      const idx = components.length\n      const inner = extractMessage((child.props as { children?: ReactNode }).children)\n      components.push(child)\n      components.push(...inner.components)\n      message += `<${idx}>${offsetIndices(inner.message, idx + 1)}</${idx}>`\n    }\n  })\n\n  return { message, components }\n}\n\nexport function offsetIndices(message: string, offset: number): string {\n  if (offset === 0) return message\n  return message\n    .replace(/<(\\d+)(\\/?>)/g, (_match, index: string, suffix: string) => `<${Number(index) + offset}${suffix}`)\n    .replace(/<\\/(\\d+)>/g, (_match, index: string) => `</${Number(index) + offset}>`)\n}\n\n/**\n * Reconstruct a translated message string back into React elements.\n *\n * Parses \"<0>content</0>\" tags and replaces them with cloned components.\n *\n * @internal\n */\nexport function reconstruct(\n  translated: string,\n  components: ReactElement[],\n): ReactNode {\n  const TAG_RE = /<(\\d+)>([\\s\\S]*?)<\\/\\1>/g\n  const result: ReactNode[] = []\n  let lastIndex = 0\n  let match: RegExpExecArray | null\n\n  TAG_RE.lastIndex = 0\n  match = TAG_RE.exec(translated)\n\n  while (match !== null) {\n    if (match.index > lastIndex) {\n      result.push(translated.slice(lastIndex, match.index))\n    }\n\n    const idx = Number(match[1])\n    const innerText = match[2]!\n    const component = components[idx]\n\n    if (component) {\n      // Recursively reconstruct inner content\n      const innerContent = reconstruct(innerText, components)\n      result.push(\n        cloneElement(component, { key: `trans-${idx}` }, innerContent),\n      )\n    } else {\n      result.push(innerText)\n    }\n\n    lastIndex = TAG_RE.lastIndex\n    match = TAG_RE.exec(translated)\n  }\n\n  if (lastIndex < translated.length) {\n    result.push(translated.slice(lastIndex))\n  }\n\n  return result.length === 1 ? result[0]! : createElement(Fragment, null, ...result)\n}\n","import type { ReactNode } from 'react'\n\nexport const PLURAL_CATEGORIES = ['zero', 'one', 'two', 'few', 'many', 'other'] as const\nexport type PluralCategory = (typeof PLURAL_CATEGORIES)[number]\n\n/**\n * Resolve which plural category to use.\n * Checks for exact =0 match first, then falls back to CLDR rules.\n * @internal\n */\nexport function resolveCategory(\n  value: number,\n  locale: string,\n  available: Record<string, boolean>,\n): PluralCategory {\n  if (value === 0 && available['zero']) return 'zero'\n  const cldr = new Intl.PluralRules(locale).select(value) as PluralCategory\n  if (available[cldr]) return cldr\n  return 'other'\n}\n\n/**\n * Replace `#` with the formatted value in a ReactNode.\n * @internal\n */\nexport function replaceHash(node: ReactNode, formatted: string): ReactNode {\n  if (typeof node === 'string') {\n    return node.replace(/#/g, formatted)\n  }\n  return node\n}\n","import type { MessageDescriptor } from '@fluenti/core'\nimport type { ReactElement, ReactNode } from 'react'\nimport { extractMessage, offsetIndices, reconstruct } from './trans-core'\nimport { PLURAL_CATEGORIES, type PluralCategory } from './plural-core'\n\nexport interface RichMessagePart {\n  message: string\n  components: ReactElement[]\n}\n\nexport function buildICUPluralMessage(\n  forms: Partial<Record<PluralCategory, string>> & { other: string },\n  offset?: number,\n): string {\n  const parts: string[] = []\n  for (const cat of PLURAL_CATEGORIES) {\n    const text = forms[cat]\n    if (text === undefined) continue\n    parts.push(`${cat === 'zero' ? '=0' : cat} {${text}}`)\n  }\n  const offsetPrefix = offset ? `offset:${offset} ` : ''\n  return `{count, plural, ${offsetPrefix}${parts.join(' ')}}`\n}\n\nexport function buildICUSelectMessage(\n  forms: Record<string, string>,\n): string {\n  const entries = Object.entries(forms).filter(([, text]) => text !== undefined)\n  return `{value, select, ${entries.map(([key, text]) => `${key} {${text}}`).join(' ')}}`\n}\n\nexport function normalizeSelectForms(\n  forms: Record<string, string>,\n): {\n  forms: Record<string, string>\n  valueMap: Record<string, string>\n} {\n  const normalized: Record<string, string> = {}\n  const valueMap: Record<string, string> = {}\n  let index = 0\n\n  for (const [key, text] of Object.entries(forms)) {\n    if (key === 'other') {\n      normalized['other'] = text\n      continue\n    }\n\n    const safeKey = /^[A-Za-z0-9_]+$/.test(key) ? key : `case_${index++}`\n    normalized[safeKey] = text\n    valueMap[key] = safeKey\n  }\n\n  if (normalized['other'] === undefined) {\n    normalized['other'] = ''\n  }\n\n  return { forms: normalized, valueMap }\n}\n\nexport function serializeRichNode(node: ReactNode): RichMessagePart {\n  const extracted = extractMessage(node)\n  return {\n    message: extracted.message,\n    components: extracted.components,\n  }\n}\n\nexport function serializeRichForms<T extends string>(\n  keys: readonly T[],\n  forms: Partial<Record<T, ReactNode>> & Record<string, ReactNode | undefined>,\n): {\n  messages: Partial<Record<T, string>> & Record<string, string>\n  components: ReactElement[]\n} {\n  const components: ReactElement[] = []\n  const messages: Record<string, string> = {}\n\n  for (const key of keys) {\n    const value = forms[key]\n    if (value === undefined) continue\n    const extracted = serializeRichNode(value)\n    messages[key] = offsetIndices(extracted.message, components.length)\n    components.push(...extracted.components)\n  }\n\n  for (const [key, value] of Object.entries(forms)) {\n    if (keys.includes(key as T) || value === undefined) continue\n    const extracted = serializeRichNode(value)\n    messages[key] = offsetIndices(extracted.message, components.length)\n    components.push(...extracted.components)\n  }\n\n  return { messages: messages as Partial<Record<T, string>> & Record<string, string>, components }\n}\n\nexport function renderRichTranslation(\n  descriptor: MessageDescriptor,\n  values: Record<string, unknown> | undefined,\n  translate: (descriptor: MessageDescriptor, values?: Record<string, unknown>) => string,\n  components: ReactElement[],\n): ReactNode {\n  const translated = translate(descriptor, values)\n  return components.length > 0 ? reconstruct(translated, components) : translated\n}\n"],"mappings":"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"}