@fluenti/next 0.2.1 → 0.3.1

package/dist/loader.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"loader.cjs","names":[],"sources":["../src/loader.ts"],"sourcesContent":["/**\n * Webpack loader for t`` and t() transforms in Next.js.\n *\n * Runs as enforce: 'pre' to transform source before other loaders.\n * Only statically provable `t` bindings are optimized; runtime `t()` calls\n * continue to work without injected proxy globals.\n */\nimport { scopeTransform } from './scope-transform'\nimport { transformTransComponents } from './trans-transform'\n\n/**\n * Webpack loader function.\n * `this` is the webpack LoaderContext.\n */\nexport default function fluentLoader(this: LoaderContext, source: string): string {\n  // Only process .tsx, .ts, .jsx, .js files\n  if (!/\\.[jt]sx?$/.test(this.resourcePath)) {\n    return source\n  }\n\n  // Skip node_modules and .next directory\n  if (/node_modules|\\.next/.test(this.resourcePath)) {\n    return source\n  }\n\n  let result = source\n  const isClientModule = /^\\s*['\"]use client['\"]/.test(result)\n\n  // ── <Trans> compile-time optimization (JSX/TSX only) ──────────────\n  if (/\\.[jt]sx$/.test(this.resourcePath) && /<Trans[\\s>]/.test(result)) {\n    const transResult = transformTransComponents(result)\n    if (transResult.transformed) {\n      result = transResult.code\n    }\n  }\n\n  // Quick check: does this file contain any Fluenti authoring/runtime surface?\n  if (!isServerFluentiFile(result, isClientModule) && !hasFluentPatterns(result)) {\n    return result\n  }\n\n  // Try scope-aware transform first (AST-based, zero false positives)\n  try {\n    const scoped = scopeTransform(result, {\n      framework: 'react',\n      serverModuleImport: '@fluenti/next',\n      treatFrameworkDirectImportsAsServer: !isClientModule,\n      rerouteServerAuthoringImports: !isClientModule,\n      errorOnServerUseI18n: !isClientModule,\n    })\n    if (scoped.transformed) {\n      return scoped.code\n    }\n  } catch (error: unknown) {\n    const msg = error instanceof Error ? error.message : String(error)\n    throw new Error(`[fluenti] Transform failed in ${this.resourcePath}: ${msg}`)\n  }\n\n  return result\n}\n\n/**\n * Quick regex check to avoid full parsing on files without t`` or t().\n */\nfunction hasFluentPatterns(code: string): boolean {\n  if (/(?<![.\\w$])t\\(\\s*['\"]/.test(code) || /[A-Za-z_$][\\w$]*\\(\\s*\\{/.test(code)) {\n    return true\n  }\n\n  if (/[A-Za-z_$][\\w$]*`/.test(code) && (code.includes('useI18n') || code.includes('getI18n'))) {\n    return true\n  }\n\n  return /import\\s*\\{\\s*t(?:\\s+as\\s+[A-Za-z_$][\\w$]*)?[\\s,}]/.test(code)\n    && (code.includes('@fluenti/react') || code.includes('@fluenti/next'))\n}\n\nfunction isServerFluentiFile(code: string, isClientModule: boolean): boolean {\n  if (isClientModule) return false\n  if (!code.includes('@fluenti/react') && !code.includes('@fluenti/next')) {\n    return false\n  }\n\n  return /\\b(useI18n|Trans|Plural|Select|DateTime|NumberFormat|t)\\b/.test(code)\n}\n\ninterface LoaderContext {\n  resourcePath: string\n  getOptions(): Record<string, unknown>\n}\n"],"mappings":"wCAcA,SAAwB,EAAkC,EAAwB,CAOhF,GALI,CAAC,aAAa,KAAK,KAAK,aAAa,EAKrC,sBAAsB,KAAK,KAAK,aAAa,CAC/C,OAAO,EAGT,IAAI,EAAS,EACP,EAAiB,yBAAyB,KAAK,EAAO,CAG5D,GAAI,YAAY,KAAK,KAAK,aAAa,EAAI,cAAc,KAAK,EAAO,CAAE,CACrE,IAAM,GAAA,EAAA,EAAA,0BAAuC,EAAO,CAChD,EAAY,cACd,EAAS,EAAY,MAKzB,GAAI,CAAC,EAAoB,EAAQ,EAAe,EAAI,CAAC,EAAkB,EAAO,CAC5E,OAAO,EAIT,GAAI,CACF,IAAM,GAAA,EAAA,EAAA,gBAAwB,EAAQ,CACpC,UAAW,QACX,mBAAoB,gBACpB,oCAAqC,CAAC,EACtC,8BAA+B,CAAC,EAChC,qBAAsB,CAAC,EACxB,CAAC,CACF,GAAI,EAAO,YACT,OAAO,EAAO,WAET,EAAgB,CACvB,IAAM,EAAM,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,CAClE,MAAU,MAAM,iCAAiC,KAAK,aAAa,IAAI,IAAM,CAG/E,OAAO,EAMT,SAAS,EAAkB,EAAuB,CAShD,MARI,wBAAwB,KAAK,EAAK,EAAI,0BAA0B,KAAK,EAAK,EAI1E,oBAAoB,KAAK,EAAK,GAAK,EAAK,SAAS,UAAU,EAAI,EAAK,SAAS,UAAU,EAClF,GAGF,qDAAqD,KAAK,EAAK,GAChE,EAAK,SAAS,iBAAiB,EAAI,EAAK,SAAS,gBAAgB,EAGzE,SAAS,EAAoB,EAAc,EAAkC,CAM3E,OALI,GACA,CAAC,EAAK,SAAS,iBAAiB,EAAI,CAAC,EAAK,SAAS,gBAAgB,CAC9D,GAGF,4DAA4D,KAAK,EAAK"}
+{"version":3,"file":"loader.cjs","names":[],"sources":["../src/loader.ts"],"sourcesContent":["/**\n * Webpack loader for t`` and t() transforms in Next.js.\n *\n * Runs as enforce: 'pre' to transform source before other loaders.\n * Only statically provable `t` bindings are optimized; runtime `t()` calls\n * continue to work without injected proxy globals.\n */\nimport { createTransformPipeline, hasScopeTransformCandidate } from '@fluenti/core/transform'\n\nconst pipeline = createTransformPipeline({ framework: 'react' })\n\n/**\n * Webpack loader function.\n * `this` is the webpack LoaderContext.\n */\nexport default function fluentLoader(this: LoaderContext, source: string): string {\n  // Only process .tsx, .ts, .jsx, .js files\n  if (!/\\.[jt]sx?$/.test(this.resourcePath)) {\n    return source\n  }\n\n  // Skip node_modules and .next directory\n  if (/node_modules|\\.next/.test(this.resourcePath)) {\n    return source\n  }\n\n  let result = source\n  const isClientModule = /^\\s*['\"]use client['\"]/.test(result)\n\n  // ── <Trans> compile-time optimization (JSX/TSX only) ──────────────\n  if (/\\.[jt]sx$/.test(this.resourcePath) && /<Trans[\\s>]/.test(result)) {\n    const transResult = pipeline.transformTrans(result)\n    if (transResult.transformed) {\n      result = transResult.code\n    }\n  }\n\n  // Quick check: does this file contain any Fluenti patterns?\n  if (!hasScopeTransformCandidate(result)) {\n    return result\n  }\n\n  // Try scope-aware transform (AST-based, zero false positives)\n  try {\n    const scoped = pipeline.transformScope(result, {\n      serverModuleImport: '@fluenti/next',\n      treatFrameworkDirectImportsAsServer: !isClientModule,\n      rerouteServerAuthoringImports: !isClientModule,\n      errorOnServerUseI18n: !isClientModule,\n    })\n    if (scoped.transformed) {\n      return scoped.code\n    }\n  } catch (error: unknown) {\n    const msg = error instanceof Error ? error.message : String(error)\n    throw new Error(`[fluenti] Transform failed in ${this.resourcePath}: ${msg}`)\n  }\n\n  return result\n}\n\ninterface LoaderContext {\n  resourcePath: string\n  getOptions(): Record<string, unknown>\n}\n"],"mappings":"yCASA,IAAM,GAAA,EAAA,EAAA,yBAAmC,CAAE,UAAW,QAAS,CAAC,CAMhE,SAAwB,EAAkC,EAAwB,CAOhF,GALI,CAAC,aAAa,KAAK,KAAK,aAAa,EAKrC,sBAAsB,KAAK,KAAK,aAAa,CAC/C,OAAO,EAGT,IAAI,EAAS,EACP,EAAiB,yBAAyB,KAAK,EAAO,CAG5D,GAAI,YAAY,KAAK,KAAK,aAAa,EAAI,cAAc,KAAK,EAAO,CAAE,CACrE,IAAM,EAAc,EAAS,eAAe,EAAO,CAC/C,EAAY,cACd,EAAS,EAAY,MAKzB,GAAI,EAAA,EAAA,EAAA,4BAA4B,EAAO,CACrC,OAAO,EAIT,GAAI,CACF,IAAM,EAAS,EAAS,eAAe,EAAQ,CAC7C,mBAAoB,gBACpB,oCAAqC,CAAC,EACtC,8BAA+B,CAAC,EAChC,qBAAsB,CAAC,EACxB,CAAC,CACF,GAAI,EAAO,YACT,OAAO,EAAO,WAET,EAAgB,CACvB,IAAM,EAAM,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,CAClE,MAAU,MAAM,iCAAiC,KAAK,aAAa,IAAI,IAAM,CAG/E,OAAO"}

package/dist/loader.js

@@ -1,35 +1,29 @@
-import { scopeTransform as e, transformTransComponents as t } from "@fluenti/core/internal";
+import { createTransformPipeline as e, hasScopeTransformCandidate as t } from "@fluenti/core/transform";
 //#region src/loader.ts
-function n(n) {
-	if (!/\.[jt]sx?$/.test(this.resourcePath) || /node_modules|\.next/.test(this.resourcePath)) return n;
-	let a = n, o = /^\s*['"]use client['"]/.test(a);
-	if (/\.[jt]sx$/.test(this.resourcePath) && /<Trans[\s>]/.test(a)) {
-		let e = t(a);
-		e.transformed && (a = e.code);
+var n = e({ framework: "react" });
+function r(e) {
+	if (!/\.[jt]sx?$/.test(this.resourcePath) || /node_modules|\.next/.test(this.resourcePath)) return e;
+	let r = e, i = /^\s*['"]use client['"]/.test(r);
+	if (/\.[jt]sx$/.test(this.resourcePath) && /<Trans[\s>]/.test(r)) {
+		let e = n.transformTrans(r);
+		e.transformed && (r = e.code);
 	}
-	if (!i(a, o) && !r(a)) return a;
+	if (!t(r)) return r;
 	try {
-		let t = e(a, {
-			framework: "react",
+		let e = n.transformScope(r, {
 			serverModuleImport: "@fluenti/next",
-			treatFrameworkDirectImportsAsServer: !o,
-			rerouteServerAuthoringImports: !o,
-			errorOnServerUseI18n: !o
+			treatFrameworkDirectImportsAsServer: !i,
+			rerouteServerAuthoringImports: !i,
+			errorOnServerUseI18n: !i
 		});
-		if (t.transformed) return t.code;
+		if (e.transformed) return e.code;
 	} catch (e) {
 		let t = e instanceof Error ? e.message : String(e);
 		throw Error(`[fluenti] Transform failed in ${this.resourcePath}: ${t}`);
 	}
-	return a;
-}
-function r(e) {
-	return /(?<![.\w$])t\(\s*['"]/.test(e) || /[A-Za-z_$][\w$]*\(\s*\{/.test(e) || /[A-Za-z_$][\w$]*`/.test(e) && (e.includes("useI18n") || e.includes("getI18n")) ? !0 : /import\s*\{\s*t(?:\s+as\s+[A-Za-z_$][\w$]*)?[\s,}]/.test(e) && (e.includes("@fluenti/react") || e.includes("@fluenti/next"));
-}
-function i(e, t) {
-	return t || !e.includes("@fluenti/react") && !e.includes("@fluenti/next") ? !1 : /\b(useI18n|Trans|Plural|Select|DateTime|NumberFormat|t)\b/.test(e);
+	return r;
 }
 //#endregion
-export { n as default };
+export { r as default };
 
 //# sourceMappingURL=loader.js.map

package/dist/loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"loader.js","names":[],"sources":["../src/loader.ts"],"sourcesContent":["/**\n * Webpack loader for t`` and t() transforms in Next.js.\n *\n * Runs as enforce: 'pre' to transform source before other loaders.\n * Only statically provable `t` bindings are optimized; runtime `t()` calls\n * continue to work without injected proxy globals.\n */\nimport { scopeTransform } from './scope-transform'\nimport { transformTransComponents } from './trans-transform'\n\n/**\n * Webpack loader function.\n * `this` is the webpack LoaderContext.\n */\nexport default function fluentLoader(this: LoaderContext, source: string): string {\n  // Only process .tsx, .ts, .jsx, .js files\n  if (!/\\.[jt]sx?$/.test(this.resourcePath)) {\n    return source\n  }\n\n  // Skip node_modules and .next directory\n  if (/node_modules|\\.next/.test(this.resourcePath)) {\n    return source\n  }\n\n  let result = source\n  const isClientModule = /^\\s*['\"]use client['\"]/.test(result)\n\n  // ── <Trans> compile-time optimization (JSX/TSX only) ──────────────\n  if (/\\.[jt]sx$/.test(this.resourcePath) && /<Trans[\\s>]/.test(result)) {\n    const transResult = transformTransComponents(result)\n    if (transResult.transformed) {\n      result = transResult.code\n    }\n  }\n\n  // Quick check: does this file contain any Fluenti authoring/runtime surface?\n  if (!isServerFluentiFile(result, isClientModule) && !hasFluentPatterns(result)) {\n    return result\n  }\n\n  // Try scope-aware transform first (AST-based, zero false positives)\n  try {\n    const scoped = scopeTransform(result, {\n      framework: 'react',\n      serverModuleImport: '@fluenti/next',\n      treatFrameworkDirectImportsAsServer: !isClientModule,\n      rerouteServerAuthoringImports: !isClientModule,\n      errorOnServerUseI18n: !isClientModule,\n    })\n    if (scoped.transformed) {\n      return scoped.code\n    }\n  } catch (error: unknown) {\n    const msg = error instanceof Error ? error.message : String(error)\n    throw new Error(`[fluenti] Transform failed in ${this.resourcePath}: ${msg}`)\n  }\n\n  return result\n}\n\n/**\n * Quick regex check to avoid full parsing on files without t`` or t().\n */\nfunction hasFluentPatterns(code: string): boolean {\n  if (/(?<![.\\w$])t\\(\\s*['\"]/.test(code) || /[A-Za-z_$][\\w$]*\\(\\s*\\{/.test(code)) {\n    return true\n  }\n\n  if (/[A-Za-z_$][\\w$]*`/.test(code) && (code.includes('useI18n') || code.includes('getI18n'))) {\n    return true\n  }\n\n  return /import\\s*\\{\\s*t(?:\\s+as\\s+[A-Za-z_$][\\w$]*)?[\\s,}]/.test(code)\n    && (code.includes('@fluenti/react') || code.includes('@fluenti/next'))\n}\n\nfunction isServerFluentiFile(code: string, isClientModule: boolean): boolean {\n  if (isClientModule) return false\n  if (!code.includes('@fluenti/react') && !code.includes('@fluenti/next')) {\n    return false\n  }\n\n  return /\\b(useI18n|Trans|Plural|Select|DateTime|NumberFormat|t)\\b/.test(code)\n}\n\ninterface LoaderContext {\n  resourcePath: string\n  getOptions(): Record<string, unknown>\n}\n"],"mappings":";;AAcA,SAAwB,EAAkC,GAAwB;AAOhF,KALI,CAAC,aAAa,KAAK,KAAK,aAAa,IAKrC,sBAAsB,KAAK,KAAK,aAAa,CAC/C,QAAO;CAGT,IAAI,IAAS,GACP,IAAiB,yBAAyB,KAAK,EAAO;AAG5D,KAAI,YAAY,KAAK,KAAK,aAAa,IAAI,cAAc,KAAK,EAAO,EAAE;EACrE,IAAM,IAAc,EAAyB,EAAO;AACpD,EAAI,EAAY,gBACd,IAAS,EAAY;;AAKzB,KAAI,CAAC,EAAoB,GAAQ,EAAe,IAAI,CAAC,EAAkB,EAAO,CAC5E,QAAO;AAIT,KAAI;EACF,IAAM,IAAS,EAAe,GAAQ;GACpC,WAAW;GACX,oBAAoB;GACpB,qCAAqC,CAAC;GACtC,+BAA+B,CAAC;GAChC,sBAAsB,CAAC;GACxB,CAAC;AACF,MAAI,EAAO,YACT,QAAO,EAAO;UAET,GAAgB;EACvB,IAAM,IAAM,aAAiB,QAAQ,EAAM,UAAU,OAAO,EAAM;AAClE,QAAU,MAAM,iCAAiC,KAAK,aAAa,IAAI,IAAM;;AAG/E,QAAO;;AAMT,SAAS,EAAkB,GAAuB;AAShD,QARI,wBAAwB,KAAK,EAAK,IAAI,0BAA0B,KAAK,EAAK,IAI1E,oBAAoB,KAAK,EAAK,KAAK,EAAK,SAAS,UAAU,IAAI,EAAK,SAAS,UAAU,IAClF,KAGF,qDAAqD,KAAK,EAAK,KAChE,EAAK,SAAS,iBAAiB,IAAI,EAAK,SAAS,gBAAgB;;AAGzE,SAAS,EAAoB,GAAc,GAAkC;AAM3E,QALI,KACA,CAAC,EAAK,SAAS,iBAAiB,IAAI,CAAC,EAAK,SAAS,gBAAgB,GAC9D,KAGF,4DAA4D,KAAK,EAAK"}
+{"version":3,"file":"loader.js","names":[],"sources":["../src/loader.ts"],"sourcesContent":["/**\n * Webpack loader for t`` and t() transforms in Next.js.\n *\n * Runs as enforce: 'pre' to transform source before other loaders.\n * Only statically provable `t` bindings are optimized; runtime `t()` calls\n * continue to work without injected proxy globals.\n */\nimport { createTransformPipeline, hasScopeTransformCandidate } from '@fluenti/core/transform'\n\nconst pipeline = createTransformPipeline({ framework: 'react' })\n\n/**\n * Webpack loader function.\n * `this` is the webpack LoaderContext.\n */\nexport default function fluentLoader(this: LoaderContext, source: string): string {\n  // Only process .tsx, .ts, .jsx, .js files\n  if (!/\\.[jt]sx?$/.test(this.resourcePath)) {\n    return source\n  }\n\n  // Skip node_modules and .next directory\n  if (/node_modules|\\.next/.test(this.resourcePath)) {\n    return source\n  }\n\n  let result = source\n  const isClientModule = /^\\s*['\"]use client['\"]/.test(result)\n\n  // ── <Trans> compile-time optimization (JSX/TSX only) ──────────────\n  if (/\\.[jt]sx$/.test(this.resourcePath) && /<Trans[\\s>]/.test(result)) {\n    const transResult = pipeline.transformTrans(result)\n    if (transResult.transformed) {\n      result = transResult.code\n    }\n  }\n\n  // Quick check: does this file contain any Fluenti patterns?\n  if (!hasScopeTransformCandidate(result)) {\n    return result\n  }\n\n  // Try scope-aware transform (AST-based, zero false positives)\n  try {\n    const scoped = pipeline.transformScope(result, {\n      serverModuleImport: '@fluenti/next',\n      treatFrameworkDirectImportsAsServer: !isClientModule,\n      rerouteServerAuthoringImports: !isClientModule,\n      errorOnServerUseI18n: !isClientModule,\n    })\n    if (scoped.transformed) {\n      return scoped.code\n    }\n  } catch (error: unknown) {\n    const msg = error instanceof Error ? error.message : String(error)\n    throw new Error(`[fluenti] Transform failed in ${this.resourcePath}: ${msg}`)\n  }\n\n  return result\n}\n\ninterface LoaderContext {\n  resourcePath: string\n  getOptions(): Record<string, unknown>\n}\n"],"mappings":";;AASA,IAAM,IAAW,EAAwB,EAAE,WAAW,SAAS,CAAC;AAMhE,SAAwB,EAAkC,GAAwB;AAOhF,KALI,CAAC,aAAa,KAAK,KAAK,aAAa,IAKrC,sBAAsB,KAAK,KAAK,aAAa,CAC/C,QAAO;CAGT,IAAI,IAAS,GACP,IAAiB,yBAAyB,KAAK,EAAO;AAG5D,KAAI,YAAY,KAAK,KAAK,aAAa,IAAI,cAAc,KAAK,EAAO,EAAE;EACrE,IAAM,IAAc,EAAS,eAAe,EAAO;AACnD,EAAI,EAAY,gBACd,IAAS,EAAY;;AAKzB,KAAI,CAAC,EAA2B,EAAO,CACrC,QAAO;AAIT,KAAI;EACF,IAAM,IAAS,EAAS,eAAe,GAAQ;GAC7C,oBAAoB;GACpB,qCAAqC,CAAC;GACtC,+BAA+B,CAAC;GAChC,sBAAsB,CAAC;GACxB,CAAC;AACF,MAAI,EAAO,YACT,QAAO,EAAO;UAET,GAAgB;EACvB,IAAM,IAAM,aAAiB,QAAQ,EAAM,UAAU,OAAO,EAAM;AAClE,QAAU,MAAM,iCAAiC,KAAK,aAAa,IAAI,IAAM;;AAG/E,QAAO"}

package/dist/middleware.d.ts

@@ -0,0 +1,109 @@
+/**
+ * @module @fluenti/next/middleware
+ *
+ * Built-in i18n middleware for Next.js App Router.
+ *
+ * Uses `x-fluenti-locale` request header to pass locale from middleware to
+ * server components — avoids `Set-Cookie` on every request (CDN-friendly).
+ *
+ * Cookie is only used to remember user preference (set by LocaleSwitcher).
+ *
+ * @example
+ * ```ts
+ * // src/middleware.ts
+ * import { NextResponse } from 'next/server'
+ * import { createI18nMiddleware } from '@fluenti/next/middleware'
+ *
+ * export default createI18nMiddleware({ NextResponse })
+ *
+ * export const config = {
+ *   matcher: ['/((?!_next|api|favicon).*)'],
+ * }
+ * ```
+ *
+ * @example Composing with Clerk
+ * ```ts
+ * import { NextResponse } from 'next/server'
+ * import { clerkMiddleware } from '@clerk/nextjs/server'
+ * import { createI18nMiddleware } from '@fluenti/next/middleware'
+ *
+ * const i18nMiddleware = createI18nMiddleware({ NextResponse })
+ *
+ * export default clerkMiddleware(async (auth, req) => {
+ *   await auth.protect()
+ *   return i18nMiddleware(req)
+ * })
+ * ```
+ */
+/** Header name used to pass resolved locale from middleware to RSC */
+export declare const LOCALE_HEADER = "x-fluenti-locale";
+export interface I18nMiddlewareConfig {
+    /** Available locales. If omitted, reads from `fluenti.config.ts`. */
+    locales?: string[];
+    /** Source/default locale. If omitted, reads from `fluenti.config.ts`. */
+    sourceLocale?: string;
+    /** Cookie name for reading user preference (default: 'locale') */
+    cookieName?: string;
+    /**
+     * Locale prefix strategy:
+     * - `'always'`: all locales get a URL prefix (e.g. `/en/about`, `/fr/about`)
+     * - `'as-needed'`: source locale has no prefix, others do (e.g. `/about`, `/fr/about`)
+     *
+     * Default: `'as-needed'`
+     */
+    localePrefix?: 'always' | 'as-needed';
+}
+type NextRequest = {
+    nextUrl: {
+        pathname: string;
+        search: string;
+    };
+    url: string;
+    cookies: {
+        get(name: string): {
+            value: string;
+        } | undefined;
+    };
+    headers: Headers;
+};
+type NextResponseStatic = {
+    redirect(url: URL): NextResponseInstance;
+    rewrite(url: URL, init?: Record<string, unknown>): NextResponseInstance;
+    next(init?: Record<string, unknown>): NextResponseInstance;
+};
+type NextResponseInstance = {
+    headers: {
+        set(name: string, value: string): void;
+    };
+};
+/**
+ * Create an i18n middleware function for Next.js.
+ *
+ * Requires `NextResponse` to be passed in because the middleware module runs
+ * in Next.js Edge Runtime where `require('next/server')` is not available.
+ *
+ * @example
+ * ```ts
+ * import { NextResponse } from 'next/server'
+ * import { createI18nMiddleware } from '@fluenti/next/middleware'
+ *
+ * export default createI18nMiddleware({ NextResponse })
+ * ```
+ *
+ * @example With explicit locales
+ * ```ts
+ * import { NextResponse } from 'next/server'
+ * import { createI18nMiddleware } from '@fluenti/next/middleware'
+ *
+ * export default createI18nMiddleware({
+ *   NextResponse,
+ *   locales: ['en', 'ja', 'zh-CN'],
+ *   sourceLocale: 'en',
+ * })
+ * ```
+ */
+export declare function createI18nMiddleware(config: I18nMiddlewareConfig & {
+    NextResponse: NextResponseStatic;
+}): (request: NextRequest) => NextResponseInstance;
+export {};
+//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,sEAAsE;AACtE,eAAO,MAAM,aAAa,qBAAqB,CAAA;AAE/C,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAA;CACtC;AAED,KAAK,WAAW,GAAG;IACjB,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7C,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE;QAAE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,GAAG,SAAS,CAAA;KAAE,CAAA;IAC7D,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,KAAK,kBAAkB,GAAG;IACxB,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,oBAAoB,CAAA;IACxC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,oBAAoB,CAAA;IACvE,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,oBAAoB,CAAA;CAC3D,CAAA;AAED,KAAK,oBAAoB,GAAG;IAC1B,OAAO,EAAE;QAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAA;CACpD,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG;IAAE,YAAY,EAAE,kBAAkB,CAAA;CAAE,IAOvE,SAAS,WAAW,0BA6DpD"}

package/dist/navigation.d.ts

@@ -0,0 +1,40 @@
+export interface GetLocalePathOptions {
+    /** Source/default locale (no prefix in as-needed mode) */
+    sourceLocale?: string;
+    /**
+     * Known locale codes (e.g. ['en', 'fr', 'ja']).
+     * When provided, the existing prefix is only stripped when it's an actual locale —
+     * preventing false matches on generic 2-letter path segments like /my or /us.
+     */
+    locales?: string[];
+}
+/**
+ * Get the locale-prefixed path for a given pathname and locale.
+ *
+ * Pure function — works on both server and client.
+ *
+ * @example
+ * ```ts
+ * getLocalePath('/about', 'fr')       // → '/fr/about'
+ * getLocalePath('/about', 'en')       // → '/about' (source locale, no prefix)
+ * getLocalePath('/fr/about', 'en')    // → '/about'
+ * getLocalePath('/fr/about', 'ja')    // → '/ja/about'
+ * ```
+ */
+export declare function getLocalePath(pathname: string, locale: string, options?: GetLocalePathOptions): string;
+/**
+ * Hook for switching locales in Next.js App Router.
+ *
+ * Sets a cookie to remember user preference, navigates to the new locale path,
+ * and triggers a server component refresh.
+ */
+export declare function useLocaleSwitcher(options?: {
+    /** Override the source/default locale instead of inferring from locales[0]. */
+    sourceLocale?: string;
+}): {
+    switchLocale: (newLocale: string) => void;
+    currentLocale: string;
+    locales: string[];
+    sourceLocale: string;
+};
+//# sourceMappingURL=navigation.d.ts.map

package/dist/navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../src/navigation.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,oBAAoB;IACnC,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,oBAAoB,GAC7B,MAAM,CAwBR;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE;IAC1C,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;8BASkC,MAAM;;;;EAkBxC"}

package/dist/read-config.d.ts

@@ -1,6 +1,8 @@
 import { WithFluentConfig, ResolvedFluentConfig } from './types';
 /**
  * Read fluenti.config.ts and merge with withFluenti() overrides.
+ *
+ * Delegates config file loading to `@fluenti/core`'s shared `loadConfigSync()`.
  */
 export declare function resolveConfig(projectRoot: string, overrides?: WithFluentConfig): ResolvedFluentConfig;
 //# sourceMappingURL=read-config.d.ts.map

package/dist/read-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read-config.d.ts","sourceRoot":"","sources":["../src/read-config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAarE;;GAEG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,gBAAgB,GAC3B,oBAAoB,CAiCtB"}
+{"version":3,"file":"read-config.d.ts","sourceRoot":"","sources":["../src/read-config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAErE;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,gBAAgB,GAC3B,oBAAoB,CAyBtB"}

package/dist/types.d.ts

@@ -1,17 +1,13 @@
-import { DateFormatOptions, NumberFormatOptions, Locale } from '@fluenti/core';
+import { FluentiBuildConfig } from '@fluenti/core/internal';
 /**
  * Configuration for `withFluenti()`.
  *
- * Reads defaults from `fluenti.config.ts` in the project root.
- * All options here override the config file values.
+ * All i18n config (locales, sourceLocale, splitting, etc.) lives in `fluenti.config.ts`.
+ * Only Next.js-specific options are set here.
  */
 export interface WithFluentConfig {
-    /** Override `fluenti.config.ts` locales */
-    locales?: string[];
-    /** Override `fluenti.config.ts` sourceLocale (used as defaultLocale) */
-    defaultLocale?: string;
-    /** Override `fluenti.config.ts` compileOutDir */
-    compiledDir?: string;
+    /** fluenti.config.ts path or inline config */
+    config?: string | FluentiBuildConfig;
     /** Custom serverModule path (skip auto-generation) */
     serverModule?: string;
     /** Where to generate the serverModule (default: node_modules/.fluenti) */
@@ -29,33 +25,24 @@ export interface WithFluentConfig {
     resolveLocale?: string;
     /** Cookie name used for locale detection (default: 'locale') */
     cookieName?: string;
-    /** Custom date format styles */
-    dateFormats?: DateFormatOptions;
-    /** Custom number format styles */
-    numberFormats?: NumberFormatOptions;
-    /** Fallback chain per locale */
-    fallbackChain?: Record<string, Locale[]>;
-    /** Auto extract+compile in dev mode (default: true) */
-    devAutoCompile?: boolean;
-    /** Debounce delay in ms for dev auto-compile (default: 1000). Increase if you see excessive recompilation. */
-    devAutoCompileDelay?: number;
-    /** Auto extract+compile before production build (default: true) */
-    buildAutoCompile?: boolean;
+    /**
+     * Webpack loader enforce mode (default: 'pre').
+     *
+     * Set to `undefined` to let webpack determine ordering, or `'post'` to run after other loaders.
+     * This can be useful when other loaders need to process files before Fluenti's transform.
+     */
+    loaderEnforce?: 'pre' | 'post' | undefined;
 }
 /**
  * Resolved config after merging fluenti.config.ts + withFluenti() overrides.
  */
 export interface ResolvedFluentConfig {
-    locales: string[];
-    defaultLocale: string;
-    compiledDir: string;
+    /** The fully resolved FluentiBuildConfig */
+    fluentiConfig: FluentiBuildConfig;
     serverModule: string | null;
     serverModuleOutDir: string;
     resolveLocale?: string;
     cookieName: string;
-    dateFormats?: DateFormatOptions;
-    numberFormats?: NumberFormatOptions;
-    fallbackChain?: Record<string, Locale[]>;
 }
 /**
  * Props for the I18nProvider server component.

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,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAEnF;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,0EAA0E;IAC1E,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAE3B;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB,gCAAgC;IAChC,WAAW,CAAC,EAAE,iBAAiB,CAAA;IAC/B,kCAAkC;IAClC,aAAa,CAAC,EAAE,mBAAmB,CAAA;IACnC,gCAAgC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IACxC,uDAAuD;IACvD,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,8GAA8G;IAC9G,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,kBAAkB,EAAE,MAAM,CAAA;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,iBAAiB,CAAA;IAC/B,aAAa,CAAC,EAAE,mBAAmB,CAAA;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CACzC;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;IAIpC,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,0EAA0E;IAC1E,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/llms-full.txt

@@ -0,0 +1,122 @@
+# @fluenti/next
+
+> Next.js integration for Fluenti — `withFluenti()`, strict compile-time transforms, and generated server runtime helpers.
+
+@fluenti/next integrates Fluenti into Next.js projects. Its job is to:
+
+- wrap `next.config` with `withFluenti()`
+- install the Fluenti loader
+- generate the internal server runtime module consumed as `@fluenti/next`
+- keep Next authoring aligned with the main React authoring surface
+
+## Install
+
+```bash
+pnpm add @fluenti/core @fluenti/react @fluenti/next
+```
+
+## Main public entry
+
+```ts
+import { withFluenti } from '@fluenti/next'
+
+export default withFluenti()({
+  reactStrictMode: true,
+})
+```
+
+### `withFluenti(config?)`
+
+Supports:
+
+- `withFluenti(fluentiConfig?)(nextConfig)`
+- `withFluenti(nextConfig)`
+
+Public config fields:
+
+- `locales`
+- `defaultLocale`
+- `compiledDir`
+- `serverModule`
+- `serverModuleOutDir`
+- `resolveLocale`
+- `dateFormats`
+- `numberFormats`
+- `fallbackChain`
+
+## Authoring model in Next
+
+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'
+```
+
+This applies to both client and server authoring.
+
+For runtime and integration concerns, use the generated module:
+
+```ts
+import { I18nProvider, getI18n, setLocale } from '@fluenti/next'
+```
+
+### Important boundaries
+
+- imported `t` is compile-time only — ✅ this is the preferred API
+- client and server authoring should stay on `@fluenti/react`
+- server runtime access should use `await getI18n()` — ⚠️ runtime fallback for dynamic keys
+- direct-import server `t` requires an async server scope
+
+## What `withFluenti()` does
+
+1. resolves Fluenti config from `fluenti.config.ts` and explicit overrides
+2. generates a server module under the configured output directory
+3. aliases that generated module as `@fluenti/next`
+4. runs the loader on app code so official authoring APIs are transformed correctly
+
+## Generated runtime module
+
+`@fluenti/next` is not a hand-authored package entry. It is a generated module created by `withFluenti()`.
+
+It provides:
+
+- `I18nProvider`
+- `setLocale`
+- `getI18n`
+- compile-time `t` stub
+- server-side `Trans`
+- server-side `Plural`
+- server-side `Select`
+- server-side `DateTime`
+- server-side `NumberFormat`
+
+### `I18nProvider`
+
+Use in root layouts to initialize server and client runtime state.
+
+### `getI18n()`
+
+Use in server components, route handlers, metadata functions, and server actions when you need the full runtime API.
+
+### `setLocale()`
+
+Sets the request locale for the generated server runtime.
+
+## Public package subpaths
+
+- `@fluenti/next` — config wrapper and types
+- `@fluenti/next/server` — server-side helpers exported by the package itself
+- `@fluenti/next/provider` — provider-related types/helpers
+- `@fluenti/next/client` — client-side type declarations
+
+`@fluenti/next` is created per project by `withFluenti()`.
+
+## Relationship to `@fluenti/react`
+
+`@fluenti/next` builds on `@fluenti/react`.
+
+- authoring surface: `@fluenti/react`
+- Next-specific runtime integration: `@fluenti/next` + generated module
+
+This keeps the main mental model aligned across React SPA, Vite, and Next.