@fluenti/next 0.4.0-rc.1 → 0.4.0-rc.3

package/dist/routing.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Shared routing configuration for middleware and navigation.
+ *
+ * Define once, use everywhere:
+ *
+ * @example
+ * ```ts
+ * // src/i18n/routing.ts
+ * import { defineRouting } from '@fluenti/next'
+ *
+ * export const routing = defineRouting({
+ *   locales: ['en', 'fr', 'ja'],
+ *   sourceLocale: 'en',
+ *   localePrefix: 'as-needed',
+ *   pathnames: {
+ *     '/about': { fr: '/a-propos' },
+ *     '/blog/[slug]': { fr: '/articles/[slug]' },
+ *   },
+ * })
+ * ```
+ *
+ * Then pass to both middleware and navigation:
+ * ```ts
+ * // middleware.ts
+ * export default createI18nMiddleware({ NextResponse, ...routing })
+ *
+ * // src/i18n/navigation.ts
+ * export const { Link, useRouter } = createNavigation(routing)
+ * ```
+ */
+export interface RoutingConfig<L extends string = string, P extends string = string> {
+    locales: readonly L[];
+    sourceLocale: L;
+    localePrefix?: 'always' | 'as-needed' | 'never';
+    pathnames?: Record<P, Partial<Record<L, string>>>;
+}
+/**
+ * Define a routing configuration for use with both `createI18nMiddleware` and `createNavigation`.
+ *
+ * This is a type-only helper — it returns the input unchanged but captures
+ * the literal types of locales and pathname keys for type-safe navigation.
+ */
+export declare function defineRouting<const L extends string, const P extends string>(config: RoutingConfig<L, P>): RoutingConfig<L, P>;
+/** Match a pathname against a pattern with [param] and [...slug] segments. */
+export declare function matchPattern(pattern: string, pathname: string): Record<string, string> | null;
+/** Substitute params into a pattern. */
+export declare function substituteParams(pattern: string, params: Record<string, string>): string;
+/** Reverse lookup: localized path → internal path. */
+export declare function resolveInternalPath(localizedPath: string, locale: string, pathnames: Record<string, Record<string, string>>): string | null;
+/** Forward lookup: internal path → localized path. */
+export declare function resolveLocalizedPath(internalPath: string, locale: string, pathnames: Record<string, Record<string, string>>): string | null;
+//# sourceMappingURL=routing.d.ts.map

package/dist/routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../src/routing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,MAAM,WAAW,aAAa,CAC5B,CAAC,SAAS,MAAM,GAAG,MAAM,EACzB,CAAC,SAAS,MAAM,GAAG,MAAM;IAEzB,OAAO,EAAE,SAAS,CAAC,EAAE,CAAA;IACrB,YAAY,EAAE,CAAC,CAAA;IACf,YAAY,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,OAAO,CAAA;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;CAClD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,KAAK,CAAC,CAAC,SAAS,MAAM,EACtB,KAAK,CAAC,CAAC,SAAS,MAAM,EACtB,MAAM,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAElD;AAID,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAuB7F;AAED,wCAAwC;AACxC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAKxF;AAED,sDAAsD;AACtD,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAChD,MAAM,GAAG,IAAI,CASf;AAED,sDAAsD;AACtD,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAChD,MAAM,GAAG,IAAI,CASf"}

package/dist/server.cjs

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});async function e(e,t,n){if(!n)throw Error(`[fluenti] withLocale requires a server module reference. Pass the generated server module as the third argument: withLocale("ja", fn, serverI18n)`);let r=(await n.getI18n()).locale;try{return n.setLocale(e),await n.getI18n(),await t()}finally{n.setLocale(r),await n.getI18n()}}exports.withLocale=e;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`./routing-Dy57-Uao.cjs`);let e=require(`react`);async function t(e,t,n){if(!n)throw Error(`[fluenti] withLocale requires a server module reference. Pass the generated server module as the third argument: withLocale("ja", fn, serverI18n)`);let r=(await n.getI18n()).locale;try{return n.setLocale(e),await n.getI18n(),await t()}finally{n.setLocale(r),await n.getI18n()}}var n=(0,e.cache)(()=>({locale:``}));function r(e){n().locale=e}async function i(){let e=n();if(e.locale)return e.locale;try{let{headers:e}=await import(`next/headers`),t=(await e()).get(`x-fluenti-locale`);if(t)return t}catch{}return`en`}function a(e){return e.map(e=>({locale:e}))}exports.generateLocaleParams=a,exports.getLocale=i,exports.setRequestLocale=r,exports.withLocale=t;
 //# sourceMappingURL=server.cjs.map

package/dist/server.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"server.cjs","names":[],"sources":["../src/with-locale.ts"],"sourcesContent":["/**\n * Per-component locale isolation for RSC.\n *\n * Temporarily switches the request-scoped locale, executes a function,\n * then restores the previous locale. This allows rendering a subtree in\n * a different locale without affecting the rest of the page.\n *\n * @param locale - The locale to switch to for the duration of `fn`.\n * @param fn - The function to execute with the switched locale.\n * @param serverModule - The generated server module reference (auto-injected\n *   by the webpack loader in production; only needed when calling manually).\n * @returns The return value of `fn`.\n *\n * @example Basic usage in a Server Component\n * ```tsx\n * // app/page.tsx (Server Component)\n * import { withLocale } from '@fluenti/next/server'\n *\n * export default async function Page() {\n *   return (\n *     <div>\n *       <h1>{t`Main content`}</h1>\n *       {await withLocale('ja', async () => (\n *         <JapaneseWidget />\n *       ))}\n *       <Footer />\n *     </div>\n *   )\n * }\n * ```\n *\n * @example Rendering a multilingual page section\n * ```tsx\n * import { withLocale } from '@fluenti/next/server'\n *\n * export default async function MultilingualPage() {\n *   const englishContent = await withLocale('en', async () => (\n *     <p>{t`Welcome`}</p>\n *   ))\n *   const japaneseContent = await withLocale('ja', async () => (\n *     <p>{t`Welcome`}</p>\n *   ))\n *   return (\n *     <div>\n *       {englishContent}\n *       {japaneseContent}\n *     </div>\n *   )\n * }\n * ```\n */\nexport async function withLocale<T>(\n  locale: string,\n  fn: () => T | Promise<T>,\n  serverModule?: { setLocale: (l: string) => void; getI18n: () => Promise<unknown> },\n): Promise<T> {\n  if (!serverModule) {\n    throw new Error(\n      '[fluenti] withLocale requires a server module reference. ' +\n        'Pass the generated server module as the third argument: ' +\n        'withLocale(\"ja\", fn, serverI18n)',\n    )\n  }\n\n  // Read current locale from the module's request store\n  // We need to save/restore state. Since we can't access the store directly,\n  // we use setLocale to switch and rely on the caller to restore.\n  const prevInstance = await serverModule.getI18n()\n  const prevLocale = (prevInstance as { locale: string }).locale\n\n  try {\n    serverModule.setLocale(locale)\n    // Force instance recreation by calling getI18n again\n    await serverModule.getI18n()\n    return await fn()\n  } finally {\n    serverModule.setLocale(prevLocale)\n    await serverModule.getI18n()\n  }\n}\n"],"mappings":"mEAmDA,eAAsB,EACpB,EACA,EACA,EACY,CACZ,GAAI,CAAC,EACH,MAAU,MACR,oJAGD,CAOH,IAAM,GADe,MAAM,EAAa,SAAS,EACO,OAExD,GAAI,CAIF,OAHA,EAAa,UAAU,EAAO,CAE9B,MAAM,EAAa,SAAS,CACrB,MAAM,GAAI,QACT,CACR,EAAa,UAAU,EAAW,CAClC,MAAM,EAAa,SAAS"}
+{"version":3,"file":"server.cjs","names":[],"sources":["../src/with-locale.ts","../src/server.ts"],"sourcesContent":["/**\n * Per-component locale isolation for RSC.\n *\n * Temporarily switches the request-scoped locale, executes a function,\n * then restores the previous locale. This allows rendering a subtree in\n * a different locale without affecting the rest of the page.\n *\n * @param locale - The locale to switch to for the duration of `fn`.\n * @param fn - The function to execute with the switched locale.\n * @param serverModule - The generated server module reference (auto-injected\n *   by the webpack loader in production; only needed when calling manually).\n * @returns The return value of `fn`.\n *\n * @example Basic usage in a Server Component\n * ```tsx\n * // app/page.tsx (Server Component)\n * import { withLocale } from '@fluenti/next/server'\n *\n * export default async function Page() {\n *   return (\n *     <div>\n *       <h1>{t`Main content`}</h1>\n *       {await withLocale('ja', async () => (\n *         <JapaneseWidget />\n *       ))}\n *       <Footer />\n *     </div>\n *   )\n * }\n * ```\n *\n * @example Rendering a multilingual page section\n * ```tsx\n * import { withLocale } from '@fluenti/next/server'\n *\n * export default async function MultilingualPage() {\n *   const englishContent = await withLocale('en', async () => (\n *     <p>{t`Welcome`}</p>\n *   ))\n *   const japaneseContent = await withLocale('ja', async () => (\n *     <p>{t`Welcome`}</p>\n *   ))\n *   return (\n *     <div>\n *       {englishContent}\n *       {japaneseContent}\n *     </div>\n *   )\n * }\n * ```\n */\nexport async function withLocale<T>(\n  locale: string,\n  fn: () => T | Promise<T>,\n  serverModule?: { setLocale: (l: string) => void; getI18n: () => Promise<unknown> },\n): Promise<T> {\n  if (!serverModule) {\n    throw new Error(\n      '[fluenti] withLocale requires a server module reference. ' +\n        'Pass the generated server module as the third argument: ' +\n        'withLocale(\"ja\", fn, serverI18n)',\n    )\n  }\n\n  // Read current locale from the module's request store\n  // We need to save/restore state. Since we can't access the store directly,\n  // we use setLocale to switch and rely on the caller to restore.\n  const prevInstance = await serverModule.getI18n()\n  const prevLocale = (prevInstance as { locale: string }).locale\n\n  try {\n    serverModule.setLocale(locale)\n    // Force instance recreation by calling getI18n again\n    await serverModule.getI18n()\n    return await fn()\n  } finally {\n    serverModule.setLocale(prevLocale)\n    await serverModule.getI18n()\n  }\n}\n","/**\n * @module @fluenti/next/server\n *\n * Server-side utilities for Next.js App Router.\n *\n * @example\n * ```tsx\n * import { getLocale, setRequestLocale } from '@fluenti/next/server'\n *\n * export default async function Page({ params }) {\n *   const { locale } = await params\n *   setRequestLocale(locale)\n *   const currentLocale = await getLocale()\n * }\n * ```\n */\n\nimport { cache } from 'react'\n\nexport { withLocale } from './with-locale'\n\n// ── Request-scoped locale store (React.cache) ─────────────────────────────\n\nconst getRequestStore = cache(() => ({ locale: '' }))\n\n/**\n * Set the locale for the current request scope.\n *\n * Call this at the top of page/layout components to enable static rendering.\n * Required for `generateStaticParams` pages where no middleware header is available.\n */\nexport function setRequestLocale(locale: string): void {\n  getRequestStore().locale = locale\n}\n\n/**\n * Get the current locale in a Server Component.\n *\n * Resolution: setRequestLocale() → x-fluenti-locale header → 'en'\n */\nexport async function getLocale(): Promise<string> {\n  const store = getRequestStore()\n  if (store.locale) return store.locale\n\n  try {\n    const { headers } = await import('next/headers')\n    const h = await (headers as () => Promise<{ get(name: string): string | null }>)()\n    const headerLocale = h.get('x-fluenti-locale')\n    if (headerLocale) return headerLocale\n  } catch {\n    // headers() not available during static generation\n  }\n\n  return 'en'\n}\n\n/**\n * Generate static params for all configured locales.\n *\n * @example\n * ```tsx\n * export function generateStaticParams() {\n *   return generateLocaleParams(['en', 'ja', 'zh-CN'])\n * }\n * ```\n */\nexport function generateLocaleParams(locales: string[]): Array<{ locale: string }> {\n  return locales.map(locale => ({ locale }))\n}\n"],"mappings":"4HAmDA,eAAsB,EACpB,EACA,EACA,EACY,CACZ,GAAI,CAAC,EACH,MAAU,MACR,oJAGD,CAOH,IAAM,GADe,MAAM,EAAa,SAAS,EACO,OAExD,GAAI,CAIF,OAHA,EAAa,UAAU,EAAO,CAE9B,MAAM,EAAa,SAAS,CACrB,MAAM,GAAI,QACT,CACR,EAAa,UAAU,EAAW,CAClC,MAAM,EAAa,SAAS,ECtDhC,IAAM,GAAA,EAAA,EAAA,YAA+B,CAAE,OAAQ,GAAI,EAAE,CAQrD,SAAgB,EAAiB,EAAsB,CACrD,GAAiB,CAAC,OAAS,EAQ7B,eAAsB,GAA6B,CACjD,IAAM,EAAQ,GAAiB,CAC/B,GAAI,EAAM,OAAQ,OAAO,EAAM,OAE/B,GAAI,CACF,GAAM,CAAE,WAAY,MAAM,OAAO,gBAE3B,GADI,MAAO,GAAiE,EAC3D,IAAI,mBAAmB,CAC9C,GAAI,EAAc,OAAO,OACnB,EAIR,MAAO,KAaT,SAAgB,EAAqB,EAA8C,CACjF,OAAO,EAAQ,IAAI,IAAW,CAAE,SAAQ,EAAE"}

package/dist/server.d.ts

@@ -1,7 +1,44 @@
 /**
- * Server-side utilities for @fluenti/next.
+ * @module @fluenti/next/server
  *
- * Provides `withLocale()` for per-component locale isolation in RSC.
+ * Server-side utilities for Next.js App Router.
+ *
+ * @example
+ * ```tsx
+ * import { getLocale, setRequestLocale } from '@fluenti/next/server'
+ *
+ * export default async function Page({ params }) {
+ *   const { locale } = await params
+ *   setRequestLocale(locale)
+ *   const currentLocale = await getLocale()
+ * }
+ * ```
  */
 export { withLocale } from './with-locale';
+/**
+ * Set the locale for the current request scope.
+ *
+ * Call this at the top of page/layout components to enable static rendering.
+ * Required for `generateStaticParams` pages where no middleware header is available.
+ */
+export declare function setRequestLocale(locale: string): void;
+/**
+ * Get the current locale in a Server Component.
+ *
+ * Resolution: setRequestLocale() → x-fluenti-locale header → 'en'
+ */
+export declare function getLocale(): Promise<string>;
+/**
+ * Generate static params for all configured locales.
+ *
+ * @example
+ * ```tsx
+ * export function generateStaticParams() {
+ *   return generateLocaleParams(['en', 'ja', 'zh-CN'])
+ * }
+ * ```
+ */
+export declare function generateLocaleParams(locales: string[]): Array<{
+    locale: string;
+}>;
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAM1C;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAErD;AAED;;;;GAIG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAcjD;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAEjF"}

package/dist/server.js

@@ -1,5 +1,6 @@
+import { cache as e } from "react";
 //#region src/with-locale.ts
-async function e(e, t, n) {
+async function t(e, t, n) {
 	if (!n) throw Error("[fluenti] withLocale requires a server module reference. Pass the generated server module as the third argument: withLocale(\"ja\", fn, serverI18n)");
 	let r = (await n.getI18n()).locale;
 	try {
@@ -9,6 +10,24 @@ async function e(e, t, n) {
 	}
 }
 //#endregion
-export { e as withLocale };
+//#region src/server.ts
+var n = e(() => ({ locale: "" }));
+function r(e) {
+	n().locale = e;
+}
+async function i() {
+	let e = n();
+	if (e.locale) return e.locale;
+	try {
+		let { headers: e } = await import("next/headers"), t = (await e()).get("x-fluenti-locale");
+		if (t) return t;
+	} catch {}
+	return "en";
+}
+function a(e) {
+	return e.map((e) => ({ locale: e }));
+}
+//#endregion
+export { a as generateLocaleParams, i as getLocale, r as setRequestLocale, t as withLocale };
 
 //# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","names":[],"sources":["../src/with-locale.ts"],"sourcesContent":["/**\n * Per-component locale isolation for RSC.\n *\n * Temporarily switches the request-scoped locale, executes a function,\n * then restores the previous locale. This allows rendering a subtree in\n * a different locale without affecting the rest of the page.\n *\n * @param locale - The locale to switch to for the duration of `fn`.\n * @param fn - The function to execute with the switched locale.\n * @param serverModule - The generated server module reference (auto-injected\n *   by the webpack loader in production; only needed when calling manually).\n * @returns The return value of `fn`.\n *\n * @example Basic usage in a Server Component\n * ```tsx\n * // app/page.tsx (Server Component)\n * import { withLocale } from '@fluenti/next/server'\n *\n * export default async function Page() {\n *   return (\n *     <div>\n *       <h1>{t`Main content`}</h1>\n *       {await withLocale('ja', async () => (\n *         <JapaneseWidget />\n *       ))}\n *       <Footer />\n *     </div>\n *   )\n * }\n * ```\n *\n * @example Rendering a multilingual page section\n * ```tsx\n * import { withLocale } from '@fluenti/next/server'\n *\n * export default async function MultilingualPage() {\n *   const englishContent = await withLocale('en', async () => (\n *     <p>{t`Welcome`}</p>\n *   ))\n *   const japaneseContent = await withLocale('ja', async () => (\n *     <p>{t`Welcome`}</p>\n *   ))\n *   return (\n *     <div>\n *       {englishContent}\n *       {japaneseContent}\n *     </div>\n *   )\n * }\n * ```\n */\nexport async function withLocale<T>(\n  locale: string,\n  fn: () => T | Promise<T>,\n  serverModule?: { setLocale: (l: string) => void; getI18n: () => Promise<unknown> },\n): Promise<T> {\n  if (!serverModule) {\n    throw new Error(\n      '[fluenti] withLocale requires a server module reference. ' +\n        'Pass the generated server module as the third argument: ' +\n        'withLocale(\"ja\", fn, serverI18n)',\n    )\n  }\n\n  // Read current locale from the module's request store\n  // We need to save/restore state. Since we can't access the store directly,\n  // we use setLocale to switch and rely on the caller to restore.\n  const prevInstance = await serverModule.getI18n()\n  const prevLocale = (prevInstance as { locale: string }).locale\n\n  try {\n    serverModule.setLocale(locale)\n    // Force instance recreation by calling getI18n again\n    await serverModule.getI18n()\n    return await fn()\n  } finally {\n    serverModule.setLocale(prevLocale)\n    await serverModule.getI18n()\n  }\n}\n"],"mappings":";AAmDA,eAAsB,EACpB,GACA,GACA,GACY;AACZ,KAAI,CAAC,EACH,OAAU,MACR,sJAGD;CAOH,IAAM,KADe,MAAM,EAAa,SAAS,EACO;AAExD,KAAI;AAIF,SAHA,EAAa,UAAU,EAAO,EAE9B,MAAM,EAAa,SAAS,EACrB,MAAM,GAAI;WACT;AAER,EADA,EAAa,UAAU,EAAW,EAClC,MAAM,EAAa,SAAS"}
+{"version":3,"file":"server.js","names":[],"sources":["../src/with-locale.ts","../src/server.ts"],"sourcesContent":["/**\n * Per-component locale isolation for RSC.\n *\n * Temporarily switches the request-scoped locale, executes a function,\n * then restores the previous locale. This allows rendering a subtree in\n * a different locale without affecting the rest of the page.\n *\n * @param locale - The locale to switch to for the duration of `fn`.\n * @param fn - The function to execute with the switched locale.\n * @param serverModule - The generated server module reference (auto-injected\n *   by the webpack loader in production; only needed when calling manually).\n * @returns The return value of `fn`.\n *\n * @example Basic usage in a Server Component\n * ```tsx\n * // app/page.tsx (Server Component)\n * import { withLocale } from '@fluenti/next/server'\n *\n * export default async function Page() {\n *   return (\n *     <div>\n *       <h1>{t`Main content`}</h1>\n *       {await withLocale('ja', async () => (\n *         <JapaneseWidget />\n *       ))}\n *       <Footer />\n *     </div>\n *   )\n * }\n * ```\n *\n * @example Rendering a multilingual page section\n * ```tsx\n * import { withLocale } from '@fluenti/next/server'\n *\n * export default async function MultilingualPage() {\n *   const englishContent = await withLocale('en', async () => (\n *     <p>{t`Welcome`}</p>\n *   ))\n *   const japaneseContent = await withLocale('ja', async () => (\n *     <p>{t`Welcome`}</p>\n *   ))\n *   return (\n *     <div>\n *       {englishContent}\n *       {japaneseContent}\n *     </div>\n *   )\n * }\n * ```\n */\nexport async function withLocale<T>(\n  locale: string,\n  fn: () => T | Promise<T>,\n  serverModule?: { setLocale: (l: string) => void; getI18n: () => Promise<unknown> },\n): Promise<T> {\n  if (!serverModule) {\n    throw new Error(\n      '[fluenti] withLocale requires a server module reference. ' +\n        'Pass the generated server module as the third argument: ' +\n        'withLocale(\"ja\", fn, serverI18n)',\n    )\n  }\n\n  // Read current locale from the module's request store\n  // We need to save/restore state. Since we can't access the store directly,\n  // we use setLocale to switch and rely on the caller to restore.\n  const prevInstance = await serverModule.getI18n()\n  const prevLocale = (prevInstance as { locale: string }).locale\n\n  try {\n    serverModule.setLocale(locale)\n    // Force instance recreation by calling getI18n again\n    await serverModule.getI18n()\n    return await fn()\n  } finally {\n    serverModule.setLocale(prevLocale)\n    await serverModule.getI18n()\n  }\n}\n","/**\n * @module @fluenti/next/server\n *\n * Server-side utilities for Next.js App Router.\n *\n * @example\n * ```tsx\n * import { getLocale, setRequestLocale } from '@fluenti/next/server'\n *\n * export default async function Page({ params }) {\n *   const { locale } = await params\n *   setRequestLocale(locale)\n *   const currentLocale = await getLocale()\n * }\n * ```\n */\n\nimport { cache } from 'react'\n\nexport { withLocale } from './with-locale'\n\n// ── Request-scoped locale store (React.cache) ─────────────────────────────\n\nconst getRequestStore = cache(() => ({ locale: '' }))\n\n/**\n * Set the locale for the current request scope.\n *\n * Call this at the top of page/layout components to enable static rendering.\n * Required for `generateStaticParams` pages where no middleware header is available.\n */\nexport function setRequestLocale(locale: string): void {\n  getRequestStore().locale = locale\n}\n\n/**\n * Get the current locale in a Server Component.\n *\n * Resolution: setRequestLocale() → x-fluenti-locale header → 'en'\n */\nexport async function getLocale(): Promise<string> {\n  const store = getRequestStore()\n  if (store.locale) return store.locale\n\n  try {\n    const { headers } = await import('next/headers')\n    const h = await (headers as () => Promise<{ get(name: string): string | null }>)()\n    const headerLocale = h.get('x-fluenti-locale')\n    if (headerLocale) return headerLocale\n  } catch {\n    // headers() not available during static generation\n  }\n\n  return 'en'\n}\n\n/**\n * Generate static params for all configured locales.\n *\n * @example\n * ```tsx\n * export function generateStaticParams() {\n *   return generateLocaleParams(['en', 'ja', 'zh-CN'])\n * }\n * ```\n */\nexport function generateLocaleParams(locales: string[]): Array<{ locale: string }> {\n  return locales.map(locale => ({ locale }))\n}\n"],"mappings":";;AAmDA,eAAsB,EACpB,GACA,GACA,GACY;AACZ,KAAI,CAAC,EACH,OAAU,MACR,sJAGD;CAOH,IAAM,KADe,MAAM,EAAa,SAAS,EACO;AAExD,KAAI;AAIF,SAHA,EAAa,UAAU,EAAO,EAE9B,MAAM,EAAa,SAAS,EACrB,MAAM,GAAI;WACT;AAER,EADA,EAAa,UAAU,EAAW,EAClC,MAAM,EAAa,SAAS;;;;;ACtDhC,IAAM,IAAkB,SAAa,EAAE,QAAQ,IAAI,EAAE;AAQrD,SAAgB,EAAiB,GAAsB;AACrD,IAAiB,CAAC,SAAS;;AAQ7B,eAAsB,IAA6B;CACjD,IAAM,IAAQ,GAAiB;AAC/B,KAAI,EAAM,OAAQ,QAAO,EAAM;AAE/B,KAAI;EACF,IAAM,EAAE,eAAY,MAAM,OAAO,iBAE3B,KADI,MAAO,GAAiE,EAC3D,IAAI,mBAAmB;AAC9C,MAAI,EAAc,QAAO;SACnB;AAIR,QAAO;;AAaT,SAAgB,EAAqB,GAA8C;AACjF,QAAO,EAAQ,KAAI,OAAW,EAAE,WAAQ,EAAE"}

package/dist/types.d.ts

@@ -8,6 +8,16 @@ import { FluentiBuildConfig } from '@fluenti/core/internal';
 export interface WithFluentConfig {
     /** fluenti.config.ts path or inline config */
     config?: string | FluentiBuildConfig;
+    /**
+     * Shorthand for `config: { locales }`. Specify target locales without a separate config file.
+     * Ignored if `config` is also provided.
+     *
+     * @example
+     * ```ts
+     * export default withFluenti({ locales: ['en', 'ja', 'zh-CN'] })({ reactStrictMode: true })
+     * ```
+     */
+    locales?: string[];
     /** Custom serverModule path (skip auto-generation) */
     serverModule?: string;
     /** Where to generate the serverModule (default: .fluenti) */

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,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAEhE;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAAA;IAIpC,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,6DAA6D;IAC7D,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAE3B;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAAA;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,4CAA4C;IAC5C,aAAa,EAAE,kBAAkB,CAAA;IACjC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,kBAAkB,EAAE,MAAM,CAAA;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAEhE;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAAA;IACpC;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAIlB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,6DAA6D;IAC7D,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAE3B;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAAA;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,4CAA4C;IAC5C,aAAa,EAAE,kBAAkB,CAAA;IACjC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,kBAAkB,EAAE,MAAM,CAAA;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B"}

package/dist/with-fluenti.d.ts

@@ -6,18 +6,16 @@ type NextConfig = Record<string, any>;
  * Adds a webpack loader that transforms `t\`\`` and `t()` calls,
  * and generates a server module for RSC i18n.
  *
- * @example
+ * @example Minimal — no fluenti.config.ts needed
  * ```ts
- * // next.config.ts — function style (recommended)
  * import { withFluenti } from '@fluenti/next'
- * export default withFluenti()({ reactStrictMode: true })
+ * export default withFluenti({ locales: ['en', 'ja'] })({ reactStrictMode: true })
  * ```
  *
- * @example
+ * @example With fluenti.config.ts (advanced)
  * ```ts
- * // next.config.ts — direct style
  * import { withFluenti } from '@fluenti/next'
- * export default withFluenti({ reactStrictMode: true })
+ * export default withFluenti()({ reactStrictMode: true })
  * ```
  */
 export declare function withFluenti(fluentConfig?: WithFluentConfig): (nextConfig?: NextConfig) => NextConfig;

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

@@ -1 +1 @@
-{"version":3,"file":"with-fluenti.d.ts","sourceRoot":"","sources":["../src/with-fluenti.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAQ/C,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AAErC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CAAC,YAAY,CAAC,EAAE,gBAAgB,GAAG,CAAC,UAAU,CAAC,EAAE,UAAU,KAAK,UAAU,CAAA;AACrG,wBAAgB,WAAW,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAAA"}
+{"version":3,"file":"with-fluenti.d.ts","sourceRoot":"","sources":["../src/with-fluenti.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAQ/C,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AAErC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,YAAY,CAAC,EAAE,gBAAgB,GAAG,CAAC,UAAU,CAAC,EAAE,UAAU,KAAK,UAAU,CAAA;AACrG,wBAAgB,WAAW,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluenti/next",
-  "version": "0.4.0-rc.1",
+  "version": "0.4.0-rc.3",
   "type": "module",
   "description": "Next.js plugin for Fluenti — withFluenti, I18nProvider, t`` transforms for App Router and Pages Router",
   "homepage": "https://fluenti.dev",
@@ -107,8 +107,8 @@
   "dependencies": {
     "jiti": "^2",
     "picomatch": "^4",
-    "@fluenti/core": "0.4.0-rc.1",
-    "@fluenti/react": "0.4.0-rc.1"
+    "@fluenti/core": "0.4.0-rc.3",
+    "@fluenti/react": "0.4.0-rc.3"
   },
   "devDependencies": {
     "@types/node": "^25",