@fluenti/next 0.3.3 → 0.4.0-rc.0

package/dist/with-locale.d.ts

@@ -2,10 +2,18 @@
  * Per-component locale isolation for RSC.
  *
  * Temporarily switches the request-scoped locale, executes a function,
- * then restores the previous locale.
+ * then restores the previous locale. This allows rendering a subtree in
+ * a different locale without affecting the rest of the page.
  *
- * @example
+ * @param locale - The locale to switch to for the duration of `fn`.
+ * @param fn - The function to execute with the switched locale.
+ * @param serverModule - The generated server module reference (auto-injected
+ *   by the webpack loader in production; only needed when calling manually).
+ * @returns The return value of `fn`.
+ *
+ * @example Basic usage in a Server Component
  * ```tsx
+ * // app/page.tsx (Server Component)
  * import { withLocale } from '@fluenti/next/server'
  *
  * export default async function Page() {
@@ -20,6 +28,26 @@
  *   )
  * }
  * ```
+ *
+ * @example Rendering a multilingual page section
+ * ```tsx
+ * import { withLocale } from '@fluenti/next/server'
+ *
+ * export default async function MultilingualPage() {
+ *   const englishContent = await withLocale('en', async () => (
+ *     <p>{t`Welcome`}</p>
+ *   ))
+ *   const japaneseContent = await withLocale('ja', async () => (
+ *     <p>{t`Welcome`}</p>
+ *   ))
+ *   return (
+ *     <div>
+ *       {englishContent}
+ *       {japaneseContent}
+ *     </div>
+ *   )
+ * }
+ * ```
  */
 export declare function withLocale<T>(locale: string, fn: () => T | Promise<T>, serverModule?: {
     setLocale: (l: string) => void;

package/dist/with-locale.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"with-locale.d.ts","sourceRoot":"","sources":["../src/with-locale.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACxB,YAAY,CAAC,EAAE;IAAE,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,GACjF,OAAO,CAAC,CAAC,CAAC,CAwBZ"}
+{"version":3,"file":"with-locale.d.ts","sourceRoot":"","sources":["../src/with-locale.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACxB,YAAY,CAAC,EAAE;IAAE,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,GACjF,OAAO,CAAC,CAAC,CAAC,CAwBZ"}

package/llms-full.txt

@@ -50,7 +50,8 @@ In a `withFluenti()` project, the recommended authoring surface is:
 
 ```tsx
 // ✅ Preferred: compile-time authoring surface
-import { t, Trans, Plural, Select, DateTime, NumberFormat } from '@fluenti/react'
+import { t } from '@fluenti/react'
+import { Trans, Plural, Select, DateTime, NumberFormat } from '@fluenti/react/components'
 ```
 
 This applies to both client and server authoring.

package/llms.txt

@@ -4,7 +4,7 @@
 
 `@fluenti/next` wires Fluenti into Next.js. In a `withFluenti()` project, the recommended authoring path is:
 
-- client and server authoring: `import { t, Trans, Plural, Select, DateTime, NumberFormat } from '@fluenti/react'`
+- client and server authoring: `import { t } from '@fluenti/react'` + `import { Trans, Plural, Select, DateTime, NumberFormat } from '@fluenti/react/components'`
 - Next runtime/integration: `I18nProvider`, `getI18n()`, and `setLocale()` from `@fluenti/next`
 
 ## Install
@@ -49,6 +49,43 @@ Provider entry (`@fluenti/next/provider`):
 
 ❌ AVOID: `t('some.key')` as the default — this is a legacy i18n pattern.
 
+## Code Examples — Next.js
+
+### Client Components
+
+```tsx
+'use client'
+import { useI18n } from '@fluenti/react'
+
+export function Header() {
+  const { t } = useI18n()
+  return <h1>{t\`Welcome to our app\`}</h1>
+}
+```
+
+### Server Components (RSC)
+
+```tsx
+import { getI18n } from '@fluenti/next/server'
+
+export default async function Page() {
+  const { t } = await getI18n()
+  return <h1>{t\`Welcome to our app\`}</h1>
+}
+```
+
+### What NOT to write
+
+❌ Do not use manual key strings:
+```tsx
+// WRONG
+const { t } = useI18n()
+return <h1>{t('welcome_key')}</h1>
+
+// CORRECT
+return <h1>{t\`Welcome to our app\`}</h1>
+```
+
 ## Docs
 
 - Full docs: https://fluenti.dev

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluenti/next",
-  "version": "0.3.3",
+  "version": "0.4.0-rc.0",
   "type": "module",
   "description": "Next.js plugin for Fluenti — withFluenti, I18nProvider, t`` transforms for App Router and Pages Router",
   "homepage": "https://fluenti.dev",
@@ -80,6 +80,20 @@
         "types": "./dist/navigation.d.ts",
         "default": "./dist/navigation.cjs"
       }
+    },
+    "./loader": {
+      "import": "./dist/loader.js",
+      "require": "./dist/loader.cjs"
+    },
+    "./i18n-config": {
+      "import": {
+        "types": "./dist/i18n-config.d.ts",
+        "default": "./dist/i18n-config.js"
+      },
+      "require": {
+        "types": "./dist/i18n-config.d.ts",
+        "default": "./dist/i18n-config.cjs"
+      }
     }
   },
   "files": [
@@ -93,15 +107,15 @@
   "dependencies": {
     "jiti": "^2",
     "picomatch": "^4",
-    "@fluenti/core": "0.3.3",
-    "@fluenti/react": "0.3.3"
+    "@fluenti/core": "0.4.0-rc.0",
+    "@fluenti/react": "0.4.0-rc.0"
   },
   "devDependencies": {
     "@types/node": "^25",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "@vitest/coverage-v8": "^4",
-    "next": "^15",
+    "next": "^16",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "typescript": "^5.9",