@fluenti/nuxt 0.2.0 → 0.3.0

package/llms.txt

@@ -0,0 +1,103 @@
+# @fluenti/nuxt
+
+> Nuxt 3 module for Fluenti — locale-prefixed routing, locale detection, SEO head helpers, and NuxtLinkLocale component.
+
+@fluenti/nuxt integrates Fluenti i18n into Nuxt 3 with four routing strategies, an ordered locale detection chain, automatic vite-plugin registration, and SSR/SSG/SPA/ISR support.
+
+## Install
+
+```bash
+pnpm add @fluenti/nuxt @fluenti/core @fluenti/vue
+```
+
+## Quick Start
+
+```ts
+// nuxt.config.ts
+export default defineNuxtConfig({
+  modules: ['@fluenti/nuxt'],
+  fluenti: {
+    locales: ['en', 'ja', 'zh'],
+    defaultLocale: 'en',
+    strategy: 'prefix_except_default',
+  },
+})
+```
+
+## Module Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `locales` | `string[]` | — | Supported locale codes (required) |
+| `defaultLocale` | `string` | `'en'` | Default locale (required) |
+| `strategy` | `Strategy` | `'prefix_except_default'` | URL routing strategy |
+| `detectOrder` | `string[]` | `['path','cookie','header']` | Ordered locale detectors |
+| `detectBrowserLanguage` | `object` | — | Cookie and fallback settings |
+| `autoVitePlugin` | `boolean` | `true` | Auto-register vite-plugin |
+| `componentPrefix` | `string` | `''` | Prefix for i18n components |
+| `isr` | `{ enabled, ttl? }` | — | ISR route rules generation |
+| `compat` | `boolean` | `false` | vue-i18n bridge mode |
+
+## Routing Strategies
+
+| Strategy | Default locale | Other locales |
+|----------|---------------|---------------|
+| `prefix_except_default` | `/about` | `/ja/about` |
+| `prefix` | `/en/about` | `/ja/about` |
+| `prefix_and_default` | `/about` + `/en/about` | `/ja/about` |
+| `no_prefix` | `/about` | `/about` |
+
+## Locale Detection
+
+Detection chain runs in order: path -> cookie -> header -> fallback. First match wins. Custom detectors via `fluenti:detect-locale` hook.
+
+## Preferred Usage (compile-time first)
+
+1. `v-t` directive — `<p v-t>Hello {name}</p>` (Vue templates, zero runtime cost)
+2. t\`\` tagged template — t\`Hello {name}\` (primary compile-time API)
+3. `<Trans>` / `<Plural>` / `<Select>` — rich text with inline markup
+4. `msg` tagged template — outside components (route meta, stores)
+5. `useI18n().t()` — runtime fallback for dynamic keys only
+
+❌ AVOID: `t('some.key')` as the default — this is a legacy i18n pattern.
+
+## Auto-imported APIs
+
+| API | Source |
+|-----|--------|
+| `useI18n()` | `@fluenti/vue` |
+| `useLocalePath()` | `@fluenti/nuxt` |
+| `useSwitchLocalePath()` | `@fluenti/nuxt` |
+| `useLocaleHead()` | `@fluenti/nuxt` |
+| `<NuxtLinkLocale>` | `@fluenti/nuxt` |
+| `useLocaleRoute()` | `@fluenti/nuxt` |
+| `defineI18nRoute(config)` | `@fluenti/nuxt` |
+
+## Route Utilities
+
+- `localePath(path, locale, defaultLocale, strategy)` — Add locale prefix
+- `switchLocalePath(path, targetLocale, locales, defaultLocale, strategy)` — Switch locale in path
+- `extractLocaleFromPath(path, locales)` — Extract locale from path
+- `extendPages(pages, options)` — Extend Nuxt pages with locale variants
+
+## SEO & Sitemap
+
+- `buildLocaleHead(locale, path, config, options?)` — Generate locale-aware HTML head metadata (lang, dir, hreflang, og:locale, canonical)
+- `generateSitemapUrls(paths, locales, defaultLocale, strategy, baseUrl?)` — Generate multi-locale sitemap entries with hreflang alternatives
+- `createSitemapHook(locales, defaultLocale, strategy, baseUrl?)` — Hook handler for `@nuxtjs/sitemap`'s `sitemap:generate` hook
+
+## Key Types
+
+- `Strategy` — `'prefix' | 'prefix_except_default' | 'prefix_and_default' | 'no_prefix' | 'domains'`
+- `FluentNuxtRuntimeConfig` — Runtime config injected into Nuxt's public runtimeConfig
+- `DetectBrowserLanguageOptions` — Cookie and fallback settings for browser language detection
+- `ISROptions` — ISR route rules configuration (`enabled`, `ttl?`)
+- `DomainConfig` — Domain-to-locale mapping for the `'domains'` strategy
+- `I18nRouteConfig` — Per-page locale restriction (`{ locales: string[] } | false`)
+- `LocaleHeadMeta`, `LocaleHeadOptions` — Locale-aware HTML head metadata types
+
+## Documentation
+
+- Full docs: https://fluenti.dev
+- llms-full.txt: Detailed reference with examples and advanced configuration
+- Source: https://github.com/usefluenti/fluenti

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluenti/nuxt",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "description": "Nuxt module for Fluenti — locale-prefixed routes, SEO helpers, auto locale detection",
   "homepage": "https://fluenti.dev",
@@ -61,7 +61,8 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "llms*.txt"
   ],
   "peerDependencies": {
     "nuxt": "^3.0.0"
@@ -69,8 +70,8 @@
   "dependencies": {
     "@nuxt/kit": "^3.0.0",
     "@nuxt/schema": "^3.0.0",
-    "@fluenti/core": "0.2.0",
-    "@fluenti/vue": "0.2.0"
+    "@fluenti/core": "0.3.0",
+    "@fluenti/vue": "0.3.0"
   },
   "devDependencies": {
     "typescript": "^5.9",

package/dist/detectors-CFJvuwzi.cjs

@@ -1,2 +0,0 @@
-const e=require(`./path-utils-BQIsp_or.cjs`);let t=require(`#imports`);function n(t){if(t.strategy===`no_prefix`)return;let{locale:n}=e.t(t.path,t.locales);n&&t.setLocale(n)}function r(e){if(!e.detectBrowserLanguage?.useCookie)return;let n=e.detectBrowserLanguage.cookieKey??`fluenti_locale`;try{let r=(0,t.useCookie)(n);r.value&&e.locales.includes(r.value)&&e.setLocale(r.value)}catch{}}function i(e){if(e.isServer)try{let n=(0,t.useRequestHeaders)([`accept-language`])[`accept-language`];if(n){let t=a(n,e.locales);t&&e.setLocale(t)}}catch{}}function a(e,t){let n=e.split(`,`).map(e=>{let[t,n]=e.trim().split(`;q=`);return{lang:t.trim().toLowerCase(),q:n?parseFloat(n):1}}).sort((e,t)=>t.q-e.q);for(let{lang:e}of n){if(t.includes(e))return e;let n=e.split(`-`)[0];if(t.includes(n))return n}return null}function o(e){try{let n=(0,t.useRoute)().query.locale;n&&e.locales.includes(n)&&e.setLocale(n)}catch{}}var s={path:n,cookie:r,header:i,query:o};async function c(e,t,n,r){let i=null,a=!1,o={path:e,locales:t.locales,defaultLocale:t.defaultLocale,strategy:t.strategy,...t.detectBrowserLanguage?{detectBrowserLanguage:t.detectBrowserLanguage}:{},detectedLocale:null,setLocale(e){t.locales.includes(e)&&(i=e,o.detectedLocale=e,a=!0)},isServer:{}.server??!1};for(let e of t.detectOrder){if(a)break;let t=s[e]??n?.get(e);t&&await t(o)}return r&&!a&&await r(o),i??t.detectBrowserLanguage?.fallbackLocale??t.defaultLocale}Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return c}});
-//# sourceMappingURL=detectors-CFJvuwzi.cjs.map

package/dist/detectors-CFJvuwzi.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"detectors-CFJvuwzi.cjs","names":[],"sources":["../src/runtime/detectors/path.ts","../src/runtime/detectors/cookie.ts","../src/runtime/detectors/header.ts","../src/runtime/detectors/query.ts","../src/runtime/detectors/index.ts"],"sourcesContent":["import type { LocaleDetectContext } from '../../types'\nimport { extractLocaleFromPath } from '../path-utils'\n\n/** Detect locale from URL path prefix (e.g. /ja/about → 'ja') */\nexport default function detectPath(ctx: LocaleDetectContext): void {\n  if (ctx.strategy === 'no_prefix') return\n  const { locale } = extractLocaleFromPath(ctx.path, ctx.locales)\n  if (locale) {\n    ctx.setLocale(locale)\n  }\n}\n","import { useCookie } from '#imports'\nimport type { LocaleDetectContext } from '../../types'\n\n/** Detect locale from cookie value */\nexport default function detectCookie(ctx: LocaleDetectContext): void {\n  if (!ctx.detectBrowserLanguage?.useCookie) return\n  const cookieKey = ctx.detectBrowserLanguage.cookieKey ?? 'fluenti_locale'\n  try {\n    const cookie = useCookie(cookieKey)\n    if (cookie.value && ctx.locales.includes(cookie.value)) {\n      ctx.setLocale(cookie.value)\n    }\n  } catch {\n    // useCookie may fail outside Nuxt context\n  }\n}\n","import { useRequestHeaders } from '#imports'\nimport type { LocaleDetectContext } from '../../types'\n\n/** Detect locale from Accept-Language header (SSR only) */\nexport default function detectHeader(ctx: LocaleDetectContext): void {\n  if (!ctx.isServer) return\n  try {\n    const headers = useRequestHeaders(['accept-language'])\n    const acceptLang = headers['accept-language']\n    if (acceptLang) {\n      const matched = negotiateLocale(acceptLang, ctx.locales)\n      if (matched) {\n        ctx.setLocale(matched)\n      }\n    }\n  } catch {\n    // May fail if not in a request context\n  }\n}\n\nfunction negotiateLocale(acceptLanguage: string, locales: string[]): string | null {\n  const preferred = acceptLanguage\n    .split(',')\n    .map((part) => {\n      const [lang, q] = part.trim().split(';q=')\n      return { lang: lang!.trim().toLowerCase(), q: q ? parseFloat(q) : 1 }\n    })\n    .sort((a, b) => b.q - a.q)\n\n  for (const { lang } of preferred) {\n    if (locales.includes(lang)) return lang\n    const prefix = lang.split('-')[0]!\n    if (locales.includes(prefix)) return prefix\n  }\n\n  return null\n}\n","import { useRoute } from '#imports'\nimport type { LocaleDetectContext } from '../../types'\n\n/** Detect locale from query parameter (e.g. ?locale=ja) */\nexport default function detectQuery(ctx: LocaleDetectContext): void {\n  try {\n    const route = useRoute()\n    const queryLocale = route.query['locale'] as string | undefined\n    if (queryLocale && ctx.locales.includes(queryLocale)) {\n      ctx.setLocale(queryLocale)\n    }\n  } catch {\n    // May fail outside Nuxt context\n  }\n}\n","import type { LocaleDetectContext, LocaleDetectorFn, FluentNuxtRuntimeConfig } from '../../types'\nimport detectPath from './path'\nimport detectCookie from './cookie'\nimport detectHeader from './header'\nimport detectQuery from './query'\n\n/** Map of built-in detector names to their implementations */\nconst builtinDetectors: Record<string, LocaleDetectorFn> = {\n  path: detectPath,\n  cookie: detectCookie,\n  header: detectHeader,\n  query: detectQuery,\n}\n\n/**\n * Run the detection chain: iterate through detectOrder, then fire the hook.\n *\n * Returns the detected locale or the defaultLocale as fallback.\n */\nexport async function runDetectors(\n  path: string,\n  config: FluentNuxtRuntimeConfig,\n  customDetectors?: Map<string, LocaleDetectorFn>,\n  hookFn?: (ctx: LocaleDetectContext) => void | Promise<void>,\n): Promise<string> {\n  let resolved: string | null = null\n  let stopped = false\n\n  const ctx: LocaleDetectContext = {\n    path,\n    locales: config.locales,\n    defaultLocale: config.defaultLocale,\n    strategy: config.strategy,\n    ...(config.detectBrowserLanguage ? { detectBrowserLanguage: config.detectBrowserLanguage } : {}),\n    detectedLocale: null,\n    setLocale(locale: string) {\n      if (config.locales.includes(locale)) {\n        resolved = locale\n        ctx.detectedLocale = locale\n        stopped = true\n      }\n    },\n    isServer: import.meta.server ?? false,\n  }\n\n  // 1. Run detectors in order\n  for (const name of config.detectOrder) {\n    if (stopped) break\n\n    const detector = builtinDetectors[name] ?? customDetectors?.get(name)\n    if (detector) {\n      await detector(ctx)\n    }\n  }\n\n  // 2. Fire the hook — allows overriding or supplementing the detection chain\n  if (hookFn && !stopped) {\n    await hookFn(ctx)\n  }\n\n  // 3. Fallback\n  return resolved ?? config.detectBrowserLanguage?.fallbackLocale ?? config.defaultLocale\n}\n\nexport { builtinDetectors }\nexport type { LocaleDetectContext, LocaleDetectorFn }\n"],"mappings":"uEAIA,SAAwB,EAAW,EAAgC,CACjE,GAAI,EAAI,WAAa,YAAa,OAClC,GAAM,CAAE,UAAW,EAAA,EAAsB,EAAI,KAAM,EAAI,QAAQ,CAC3D,GACF,EAAI,UAAU,EAAO,CCJzB,SAAwB,EAAa,EAAgC,CACnE,GAAI,CAAC,EAAI,uBAAuB,UAAW,OAC3C,IAAM,EAAY,EAAI,sBAAsB,WAAa,iBACzD,GAAI,CACF,IAAM,GAAA,EAAA,EAAA,WAAmB,EAAU,CAC/B,EAAO,OAAS,EAAI,QAAQ,SAAS,EAAO,MAAM,EACpD,EAAI,UAAU,EAAO,MAAM,MAEvB,GCRV,SAAwB,EAAa,EAAgC,CAC9D,KAAI,SACT,GAAI,CAEF,IAAM,GAAA,EAAA,EAAA,mBAD4B,CAAC,kBAAkB,CAAC,CAC3B,mBAC3B,GAAI,EAAY,CACd,IAAM,EAAU,EAAgB,EAAY,EAAI,QAAQ,CACpD,GACF,EAAI,UAAU,EAAQ,OAGpB,GAKV,SAAS,EAAgB,EAAwB,EAAkC,CACjF,IAAM,EAAY,EACf,MAAM,IAAI,CACV,IAAK,GAAS,CACb,GAAM,CAAC,EAAM,GAAK,EAAK,MAAM,CAAC,MAAM,MAAM,CAC1C,MAAO,CAAE,KAAM,EAAM,MAAM,CAAC,aAAa,CAAE,EAAG,EAAI,WAAW,EAAE,CAAG,EAAG,EACrE,CACD,MAAM,EAAG,IAAM,EAAE,EAAI,EAAE,EAAE,CAE5B,IAAK,GAAM,CAAE,UAAU,EAAW,CAChC,GAAI,EAAQ,SAAS,EAAK,CAAE,OAAO,EACnC,IAAM,EAAS,EAAK,MAAM,IAAI,CAAC,GAC/B,GAAI,EAAQ,SAAS,EAAO,CAAE,OAAO,EAGvC,OAAO,KC/BT,SAAwB,EAAY,EAAgC,CAClE,GAAI,CAEF,IAAM,GAAA,EAAA,EAAA,WADkB,CACE,MAAM,OAC5B,GAAe,EAAI,QAAQ,SAAS,EAAY,EAClD,EAAI,UAAU,EAAY,MAEtB,GCJV,IAAM,EAAqD,CACzD,KAAM,EACN,OAAQ,EACR,OAAQ,EACR,MAAO,EACR,CAOD,eAAsB,EACpB,EACA,EACA,EACA,EACiB,CACjB,IAAI,EAA0B,KAC1B,EAAU,GAER,EAA2B,CAC/B,OACA,QAAS,EAAO,QAChB,cAAe,EAAO,cACtB,SAAU,EAAO,SACjB,GAAI,EAAO,sBAAwB,CAAE,sBAAuB,EAAO,sBAAuB,CAAG,EAAE,CAC/F,eAAgB,KAChB,UAAU,EAAgB,CACpB,EAAO,QAAQ,SAAS,EAAO,GACjC,EAAW,EACX,EAAI,eAAiB,EACrB,EAAU,KAGd,SAAA,EAAA,CAAsB,QAAU,GACjC,CAGD,IAAK,IAAM,KAAQ,EAAO,YAAa,CACrC,GAAI,EAAS,MAEb,IAAM,EAAW,EAAiB,IAAS,GAAiB,IAAI,EAAK,CACjE,GACF,MAAM,EAAS,EAAI,CAUvB,OALI,GAAU,CAAC,GACb,MAAM,EAAO,EAAI,CAIZ,GAAY,EAAO,uBAAuB,gBAAkB,EAAO"}

package/dist/detectors-DhkfHBHr.js

@@ -1,84 +0,0 @@
-import { t as e } from "./path-utils-BcvXLCGi.js";
-import { useCookie as t, useRequestHeaders as n, useRoute as r } from "#imports";
-//#region src/runtime/detectors/path.ts
-function i(t) {
-	if (t.strategy === "no_prefix") return;
-	let { locale: n } = e(t.path, t.locales);
-	n && t.setLocale(n);
-}
-//#endregion
-//#region src/runtime/detectors/cookie.ts
-function a(e) {
-	if (!e.detectBrowserLanguage?.useCookie) return;
-	let n = e.detectBrowserLanguage.cookieKey ?? "fluenti_locale";
-	try {
-		let r = t(n);
-		r.value && e.locales.includes(r.value) && e.setLocale(r.value);
-	} catch {}
-}
-//#endregion
-//#region src/runtime/detectors/header.ts
-function o(e) {
-	if (e.isServer) try {
-		let t = n(["accept-language"])["accept-language"];
-		if (t) {
-			let n = s(t, e.locales);
-			n && e.setLocale(n);
-		}
-	} catch {}
-}
-function s(e, t) {
-	let n = e.split(",").map((e) => {
-		let [t, n] = e.trim().split(";q=");
-		return {
-			lang: t.trim().toLowerCase(),
-			q: n ? parseFloat(n) : 1
-		};
-	}).sort((e, t) => t.q - e.q);
-	for (let { lang: e } of n) {
-		if (t.includes(e)) return e;
-		let n = e.split("-")[0];
-		if (t.includes(n)) return n;
-	}
-	return null;
-}
-//#endregion
-//#region src/runtime/detectors/query.ts
-function c(e) {
-	try {
-		let t = r().query.locale;
-		t && e.locales.includes(t) && e.setLocale(t);
-	} catch {}
-}
-//#endregion
-//#region src/runtime/detectors/index.ts
-var l = {
-	path: i,
-	cookie: a,
-	header: o,
-	query: c
-};
-async function u(e, t, n, r) {
-	let i = null, a = !1, o = {
-		path: e,
-		locales: t.locales,
-		defaultLocale: t.defaultLocale,
-		strategy: t.strategy,
-		...t.detectBrowserLanguage ? { detectBrowserLanguage: t.detectBrowserLanguage } : {},
-		detectedLocale: null,
-		setLocale(e) {
-			t.locales.includes(e) && (i = e, o.detectedLocale = e, a = !0);
-		},
-		isServer: import.meta.server ?? !1
-	};
-	for (let e of t.detectOrder) {
-		if (a) break;
-		let t = l[e] ?? n?.get(e);
-		t && await t(o);
-	}
-	return r && !a && await r(o), i ?? t.detectBrowserLanguage?.fallbackLocale ?? t.defaultLocale;
-}
-//#endregion
-export { u as t };
-
-//# sourceMappingURL=detectors-DhkfHBHr.js.map

package/dist/detectors-DhkfHBHr.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"detectors-DhkfHBHr.js","names":[],"sources":["../src/runtime/detectors/path.ts","../src/runtime/detectors/cookie.ts","../src/runtime/detectors/header.ts","../src/runtime/detectors/query.ts","../src/runtime/detectors/index.ts"],"sourcesContent":["import type { LocaleDetectContext } from '../../types'\nimport { extractLocaleFromPath } from '../path-utils'\n\n/** Detect locale from URL path prefix (e.g. /ja/about → 'ja') */\nexport default function detectPath(ctx: LocaleDetectContext): void {\n  if (ctx.strategy === 'no_prefix') return\n  const { locale } = extractLocaleFromPath(ctx.path, ctx.locales)\n  if (locale) {\n    ctx.setLocale(locale)\n  }\n}\n","import { useCookie } from '#imports'\nimport type { LocaleDetectContext } from '../../types'\n\n/** Detect locale from cookie value */\nexport default function detectCookie(ctx: LocaleDetectContext): void {\n  if (!ctx.detectBrowserLanguage?.useCookie) return\n  const cookieKey = ctx.detectBrowserLanguage.cookieKey ?? 'fluenti_locale'\n  try {\n    const cookie = useCookie(cookieKey)\n    if (cookie.value && ctx.locales.includes(cookie.value)) {\n      ctx.setLocale(cookie.value)\n    }\n  } catch {\n    // useCookie may fail outside Nuxt context\n  }\n}\n","import { useRequestHeaders } from '#imports'\nimport type { LocaleDetectContext } from '../../types'\n\n/** Detect locale from Accept-Language header (SSR only) */\nexport default function detectHeader(ctx: LocaleDetectContext): void {\n  if (!ctx.isServer) return\n  try {\n    const headers = useRequestHeaders(['accept-language'])\n    const acceptLang = headers['accept-language']\n    if (acceptLang) {\n      const matched = negotiateLocale(acceptLang, ctx.locales)\n      if (matched) {\n        ctx.setLocale(matched)\n      }\n    }\n  } catch {\n    // May fail if not in a request context\n  }\n}\n\nfunction negotiateLocale(acceptLanguage: string, locales: string[]): string | null {\n  const preferred = acceptLanguage\n    .split(',')\n    .map((part) => {\n      const [lang, q] = part.trim().split(';q=')\n      return { lang: lang!.trim().toLowerCase(), q: q ? parseFloat(q) : 1 }\n    })\n    .sort((a, b) => b.q - a.q)\n\n  for (const { lang } of preferred) {\n    if (locales.includes(lang)) return lang\n    const prefix = lang.split('-')[0]!\n    if (locales.includes(prefix)) return prefix\n  }\n\n  return null\n}\n","import { useRoute } from '#imports'\nimport type { LocaleDetectContext } from '../../types'\n\n/** Detect locale from query parameter (e.g. ?locale=ja) */\nexport default function detectQuery(ctx: LocaleDetectContext): void {\n  try {\n    const route = useRoute()\n    const queryLocale = route.query['locale'] as string | undefined\n    if (queryLocale && ctx.locales.includes(queryLocale)) {\n      ctx.setLocale(queryLocale)\n    }\n  } catch {\n    // May fail outside Nuxt context\n  }\n}\n","import type { LocaleDetectContext, LocaleDetectorFn, FluentNuxtRuntimeConfig } from '../../types'\nimport detectPath from './path'\nimport detectCookie from './cookie'\nimport detectHeader from './header'\nimport detectQuery from './query'\n\n/** Map of built-in detector names to their implementations */\nconst builtinDetectors: Record<string, LocaleDetectorFn> = {\n  path: detectPath,\n  cookie: detectCookie,\n  header: detectHeader,\n  query: detectQuery,\n}\n\n/**\n * Run the detection chain: iterate through detectOrder, then fire the hook.\n *\n * Returns the detected locale or the defaultLocale as fallback.\n */\nexport async function runDetectors(\n  path: string,\n  config: FluentNuxtRuntimeConfig,\n  customDetectors?: Map<string, LocaleDetectorFn>,\n  hookFn?: (ctx: LocaleDetectContext) => void | Promise<void>,\n): Promise<string> {\n  let resolved: string | null = null\n  let stopped = false\n\n  const ctx: LocaleDetectContext = {\n    path,\n    locales: config.locales,\n    defaultLocale: config.defaultLocale,\n    strategy: config.strategy,\n    ...(config.detectBrowserLanguage ? { detectBrowserLanguage: config.detectBrowserLanguage } : {}),\n    detectedLocale: null,\n    setLocale(locale: string) {\n      if (config.locales.includes(locale)) {\n        resolved = locale\n        ctx.detectedLocale = locale\n        stopped = true\n      }\n    },\n    isServer: import.meta.server ?? false,\n  }\n\n  // 1. Run detectors in order\n  for (const name of config.detectOrder) {\n    if (stopped) break\n\n    const detector = builtinDetectors[name] ?? customDetectors?.get(name)\n    if (detector) {\n      await detector(ctx)\n    }\n  }\n\n  // 2. Fire the hook — allows overriding or supplementing the detection chain\n  if (hookFn && !stopped) {\n    await hookFn(ctx)\n  }\n\n  // 3. Fallback\n  return resolved ?? config.detectBrowserLanguage?.fallbackLocale ?? config.defaultLocale\n}\n\nexport { builtinDetectors }\nexport type { LocaleDetectContext, LocaleDetectorFn }\n"],"mappings":";;;AAIA,SAAwB,EAAW,GAAgC;AACjE,KAAI,EAAI,aAAa,YAAa;CAClC,IAAM,EAAE,cAAW,EAAsB,EAAI,MAAM,EAAI,QAAQ;AAC/D,CAAI,KACF,EAAI,UAAU,EAAO;;;;ACJzB,SAAwB,EAAa,GAAgC;AACnE,KAAI,CAAC,EAAI,uBAAuB,UAAW;CAC3C,IAAM,IAAY,EAAI,sBAAsB,aAAa;AACzD,KAAI;EACF,IAAM,IAAS,EAAU,EAAU;AACnC,EAAI,EAAO,SAAS,EAAI,QAAQ,SAAS,EAAO,MAAM,IACpD,EAAI,UAAU,EAAO,MAAM;SAEvB;;;;ACRV,SAAwB,EAAa,GAAgC;AAC9D,OAAI,SACT,KAAI;EAEF,IAAM,IADU,EAAkB,CAAC,kBAAkB,CAAC,CAC3B;AAC3B,MAAI,GAAY;GACd,IAAM,IAAU,EAAgB,GAAY,EAAI,QAAQ;AACxD,GAAI,KACF,EAAI,UAAU,EAAQ;;SAGpB;;AAKV,SAAS,EAAgB,GAAwB,GAAkC;CACjF,IAAM,IAAY,EACf,MAAM,IAAI,CACV,KAAK,MAAS;EACb,IAAM,CAAC,GAAM,KAAK,EAAK,MAAM,CAAC,MAAM,MAAM;AAC1C,SAAO;GAAE,MAAM,EAAM,MAAM,CAAC,aAAa;GAAE,GAAG,IAAI,WAAW,EAAE,GAAG;GAAG;GACrE,CACD,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,EAAE;AAE5B,MAAK,IAAM,EAAE,aAAU,GAAW;AAChC,MAAI,EAAQ,SAAS,EAAK,CAAE,QAAO;EACnC,IAAM,IAAS,EAAK,MAAM,IAAI,CAAC;AAC/B,MAAI,EAAQ,SAAS,EAAO,CAAE,QAAO;;AAGvC,QAAO;;;;AC/BT,SAAwB,EAAY,GAAgC;AAClE,KAAI;EAEF,IAAM,IADQ,GAAU,CACE,MAAM;AAChC,EAAI,KAAe,EAAI,QAAQ,SAAS,EAAY,IAClD,EAAI,UAAU,EAAY;SAEtB;;;;ACJV,IAAM,IAAqD;CACzD,MAAM;CACN,QAAQ;CACR,QAAQ;CACR,OAAO;CACR;AAOD,eAAsB,EACpB,GACA,GACA,GACA,GACiB;CACjB,IAAI,IAA0B,MAC1B,IAAU,IAER,IAA2B;EAC/B;EACA,SAAS,EAAO;EAChB,eAAe,EAAO;EACtB,UAAU,EAAO;EACjB,GAAI,EAAO,wBAAwB,EAAE,uBAAuB,EAAO,uBAAuB,GAAG,EAAE;EAC/F,gBAAgB;EAChB,UAAU,GAAgB;AACxB,GAAI,EAAO,QAAQ,SAAS,EAAO,KACjC,IAAW,GACX,EAAI,iBAAiB,GACrB,IAAU;;EAGd,UAAU,OAAO,KAAK,UAAU;EACjC;AAGD,MAAK,IAAM,KAAQ,EAAO,aAAa;AACrC,MAAI,EAAS;EAEb,IAAM,IAAW,EAAiB,MAAS,GAAiB,IAAI,EAAK;AACrE,EAAI,KACF,MAAM,EAAS,EAAI;;AAUvB,QALI,KAAU,CAAC,KACb,MAAM,EAAO,EAAI,EAIZ,KAAY,EAAO,uBAAuB,kBAAkB,EAAO"}

package/dist/locale-head-BfsESdd7.cjs

@@ -1,2 +0,0 @@
-const e=require(`./path-utils-BQIsp_or.cjs`);function t(t,n,r,i){let a={htmlAttrs:{lang:t},link:[],meta:[]};if(i?.addSeoAttributes){let o=i.baseUrl??``;for(let t of r.locales){let i=e.r(n,t,r.locales,r.defaultLocale,r.strategy);a.link.push({rel:`alternate`,hreflang:t,href:`${o}${i}`})}let s=e.r(n,r.defaultLocale,r.locales,r.defaultLocale,r.strategy);a.link.push({rel:`alternate`,hreflang:`x-default`,href:`${o}${s}`}),a.meta.push({property:`og:locale`,content:t});for(let e of r.locales)e!==t&&a.meta.push({property:`og:locale:alternate`,content:e})}return a}Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return t}});
-//# sourceMappingURL=locale-head-BfsESdd7.cjs.map

package/dist/locale-head-BfsESdd7.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"locale-head-BfsESdd7.cjs","names":[],"sources":["../src/runtime/locale-head.ts"],"sourcesContent":["import { switchLocalePath } from './path-utils'\nimport type { FluentNuxtRuntimeConfig } from '../types'\n\n/** Head metadata for locale SEO */\nexport interface LocaleHeadMeta {\n  htmlAttrs: { lang: string }\n  link: Array<{ rel: string; hreflang: string; href: string }>\n  meta: Array<{ property: string; content: string }>\n}\n\nexport interface LocaleHeadOptions {\n  /** Add hreflang and og:locale SEO attributes */\n  addSeoAttributes?: boolean\n  /** Base URL for absolute hreflang links (e.g. 'https://example.com') */\n  baseUrl?: string\n}\n\n/**\n * Pure function that builds locale-aware HTML head metadata.\n *\n * This is the framework-agnostic core logic. For the Nuxt composable,\n * use `useLocaleHead()` from `composables.ts` instead.\n */\nexport function buildLocaleHead(\n  locale: string,\n  currentPath: string,\n  config: FluentNuxtRuntimeConfig,\n  options?: LocaleHeadOptions,\n): LocaleHeadMeta {\n  const head: LocaleHeadMeta = {\n    htmlAttrs: { lang: locale },\n    link: [],\n    meta: [],\n  }\n\n  if (options?.addSeoAttributes) {\n    const baseUrl = options.baseUrl ?? ''\n\n    // hreflang alternate links for each locale\n    for (const loc of config.locales) {\n      const path = switchLocalePath(\n        currentPath,\n        loc,\n        config.locales,\n        config.defaultLocale,\n        config.strategy,\n      )\n      head.link.push({\n        rel: 'alternate',\n        hreflang: loc,\n        href: `${baseUrl}${path}`,\n      })\n    }\n\n    // x-default hreflang\n    const defaultPath = switchLocalePath(\n      currentPath,\n      config.defaultLocale,\n      config.locales,\n      config.defaultLocale,\n      config.strategy,\n    )\n    head.link.push({\n      rel: 'alternate',\n      hreflang: 'x-default',\n      href: `${baseUrl}${defaultPath}`,\n    })\n\n    // og:locale\n    head.meta.push({ property: 'og:locale', content: locale })\n\n    // og:locale:alternate for other locales\n    for (const loc of config.locales) {\n      if (loc !== locale) {\n        head.meta.push({ property: 'og:locale:alternate', content: loc })\n      }\n    }\n  }\n\n  return head\n}\n"],"mappings":"6CAuBA,SAAgB,EACd,EACA,EACA,EACA,EACgB,CAChB,IAAM,EAAuB,CAC3B,UAAW,CAAE,KAAM,EAAQ,CAC3B,KAAM,EAAE,CACR,KAAM,EAAE,CACT,CAED,GAAI,GAAS,iBAAkB,CAC7B,IAAM,EAAU,EAAQ,SAAW,GAGnC,IAAK,IAAM,KAAO,EAAO,QAAS,CAChC,IAAM,EAAO,EAAA,EACX,EACA,EACA,EAAO,QACP,EAAO,cACP,EAAO,SACR,CACD,EAAK,KAAK,KAAK,CACb,IAAK,YACL,SAAU,EACV,KAAM,GAAG,IAAU,IACpB,CAAC,CAIJ,IAAM,EAAc,EAAA,EAClB,EACA,EAAO,cACP,EAAO,QACP,EAAO,cACP,EAAO,SACR,CACD,EAAK,KAAK,KAAK,CACb,IAAK,YACL,SAAU,YACV,KAAM,GAAG,IAAU,IACpB,CAAC,CAGF,EAAK,KAAK,KAAK,CAAE,SAAU,YAAa,QAAS,EAAQ,CAAC,CAG1D,IAAK,IAAM,KAAO,EAAO,QACnB,IAAQ,GACV,EAAK,KAAK,KAAK,CAAE,SAAU,sBAAuB,QAAS,EAAK,CAAC,CAKvE,OAAO"}

package/dist/locale-head-CqUlvy3O.js

@@ -1,38 +0,0 @@
-import { r as e } from "./path-utils-BcvXLCGi.js";
-//#region src/runtime/locale-head.ts
-function t(t, n, r, i) {
-	let a = {
-		htmlAttrs: { lang: t },
-		link: [],
-		meta: []
-	};
-	if (i?.addSeoAttributes) {
-		let o = i.baseUrl ?? "";
-		for (let t of r.locales) {
-			let i = e(n, t, r.locales, r.defaultLocale, r.strategy);
-			a.link.push({
-				rel: "alternate",
-				hreflang: t,
-				href: `${o}${i}`
-			});
-		}
-		let s = e(n, r.defaultLocale, r.locales, r.defaultLocale, r.strategy);
-		a.link.push({
-			rel: "alternate",
-			hreflang: "x-default",
-			href: `${o}${s}`
-		}), a.meta.push({
-			property: "og:locale",
-			content: t
-		});
-		for (let e of r.locales) e !== t && a.meta.push({
-			property: "og:locale:alternate",
-			content: e
-		});
-	}
-	return a;
-}
-//#endregion
-export { t };
-
-//# sourceMappingURL=locale-head-CqUlvy3O.js.map

package/dist/locale-head-CqUlvy3O.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"locale-head-CqUlvy3O.js","names":[],"sources":["../src/runtime/locale-head.ts"],"sourcesContent":["import { switchLocalePath } from './path-utils'\nimport type { FluentNuxtRuntimeConfig } from '../types'\n\n/** Head metadata for locale SEO */\nexport interface LocaleHeadMeta {\n  htmlAttrs: { lang: string }\n  link: Array<{ rel: string; hreflang: string; href: string }>\n  meta: Array<{ property: string; content: string }>\n}\n\nexport interface LocaleHeadOptions {\n  /** Add hreflang and og:locale SEO attributes */\n  addSeoAttributes?: boolean\n  /** Base URL for absolute hreflang links (e.g. 'https://example.com') */\n  baseUrl?: string\n}\n\n/**\n * Pure function that builds locale-aware HTML head metadata.\n *\n * This is the framework-agnostic core logic. For the Nuxt composable,\n * use `useLocaleHead()` from `composables.ts` instead.\n */\nexport function buildLocaleHead(\n  locale: string,\n  currentPath: string,\n  config: FluentNuxtRuntimeConfig,\n  options?: LocaleHeadOptions,\n): LocaleHeadMeta {\n  const head: LocaleHeadMeta = {\n    htmlAttrs: { lang: locale },\n    link: [],\n    meta: [],\n  }\n\n  if (options?.addSeoAttributes) {\n    const baseUrl = options.baseUrl ?? ''\n\n    // hreflang alternate links for each locale\n    for (const loc of config.locales) {\n      const path = switchLocalePath(\n        currentPath,\n        loc,\n        config.locales,\n        config.defaultLocale,\n        config.strategy,\n      )\n      head.link.push({\n        rel: 'alternate',\n        hreflang: loc,\n        href: `${baseUrl}${path}`,\n      })\n    }\n\n    // x-default hreflang\n    const defaultPath = switchLocalePath(\n      currentPath,\n      config.defaultLocale,\n      config.locales,\n      config.defaultLocale,\n      config.strategy,\n    )\n    head.link.push({\n      rel: 'alternate',\n      hreflang: 'x-default',\n      href: `${baseUrl}${defaultPath}`,\n    })\n\n    // og:locale\n    head.meta.push({ property: 'og:locale', content: locale })\n\n    // og:locale:alternate for other locales\n    for (const loc of config.locales) {\n      if (loc !== locale) {\n        head.meta.push({ property: 'og:locale:alternate', content: loc })\n      }\n    }\n  }\n\n  return head\n}\n"],"mappings":";;AAuBA,SAAgB,EACd,GACA,GACA,GACA,GACgB;CAChB,IAAM,IAAuB;EAC3B,WAAW,EAAE,MAAM,GAAQ;EAC3B,MAAM,EAAE;EACR,MAAM,EAAE;EACT;AAED,KAAI,GAAS,kBAAkB;EAC7B,IAAM,IAAU,EAAQ,WAAW;AAGnC,OAAK,IAAM,KAAO,EAAO,SAAS;GAChC,IAAM,IAAO,EACX,GACA,GACA,EAAO,SACP,EAAO,eACP,EAAO,SACR;AACD,KAAK,KAAK,KAAK;IACb,KAAK;IACL,UAAU;IACV,MAAM,GAAG,IAAU;IACpB,CAAC;;EAIJ,IAAM,IAAc,EAClB,GACA,EAAO,eACP,EAAO,SACP,EAAO,eACP,EAAO,SACR;AAQD,EAPA,EAAK,KAAK,KAAK;GACb,KAAK;GACL,UAAU;GACV,MAAM,GAAG,IAAU;GACpB,CAAC,EAGF,EAAK,KAAK,KAAK;GAAE,UAAU;GAAa,SAAS;GAAQ,CAAC;AAG1D,OAAK,IAAM,KAAO,EAAO,QACvB,CAAI,MAAQ,KACV,EAAK,KAAK,KAAK;GAAE,UAAU;GAAuB,SAAS;GAAK,CAAC;;AAKvE,QAAO"}

package/dist/page-extend-DJ7wpuVj.js

@@ -1,25 +0,0 @@
-//#region src/runtime/page-extend.ts
-function e(e, n) {
-	let { locales: r, defaultLocale: i, strategy: a } = n;
-	if (a === "no_prefix") return;
-	let o = [...e];
-	for (let n of r) if (!(a === "prefix_except_default" && n === i)) for (let r of o) {
-		let i = t(r, n);
-		e.push(i);
-	}
-	a === "prefix" && e.splice(0, o.length);
-}
-function t(e, t) {
-	let n = {
-		...e,
-		path: `/${t}${e.path === "/" ? "" : e.path}`
-	};
-	return e.name && (n.name = `${e.name}___${t}`), e.children && (n.children = e.children.map((e) => {
-		let n = { ...e };
-		return e.name && (n.name = `${e.name}___${t}`), n;
-	})), n;
-}
-//#endregion
-export { e as t };
-
-//# sourceMappingURL=page-extend-DJ7wpuVj.js.map

package/dist/page-extend-DJ7wpuVj.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"page-extend-DJ7wpuVj.js","names":[],"sources":["../src/runtime/page-extend.ts"],"sourcesContent":["import type { Strategy } from '../types'\n\n/** Page route definition used for route extension */\nexport interface PageRoute {\n  path: string\n  name?: string\n  children?: PageRoute[]\n}\n\n/**\n * Extend page routes with locale-prefixed variants.\n * Mutates the pages array in place (Nuxt convention).\n *\n * This is a build-time utility used in the module's `pages:extend` hook.\n */\nexport function extendPages(\n  pages: PageRoute[],\n  options: { locales: string[]; defaultLocale: string; strategy: Strategy },\n): void {\n  const { locales, defaultLocale, strategy } = options\n  if (strategy === 'no_prefix') return\n\n  const originalPages = [...pages]\n\n  for (const locale of locales) {\n    // For prefix_except_default, skip creating prefixed routes for the default locale\n    if (strategy === 'prefix_except_default' && locale === defaultLocale) continue\n\n    for (const page of originalPages) {\n      const prefixedPage = prefixPage(page, locale)\n      pages.push(prefixedPage)\n    }\n  }\n\n  // For prefix strategy, remove the original unprefixed routes\n  // (every locale including default must have a prefix)\n  if (strategy === 'prefix') {\n    // Remove all original pages (they'll only exist as prefixed versions)\n    pages.splice(0, originalPages.length)\n  }\n}\n\nfunction prefixPage(page: PageRoute, locale: string): PageRoute {\n  const prefixed: PageRoute = {\n    ...page,\n    path: `/${locale}${page.path === '/' ? '' : page.path}`,\n  }\n  if (page.name) {\n    prefixed.name = `${page.name}___${locale}`\n  }\n\n  if (page.children) {\n    prefixed.children = page.children.map((child) => {\n      const prefixedChild: PageRoute = { ...child }\n      if (child.name) {\n        prefixedChild.name = `${child.name}___${locale}`\n      }\n      return prefixedChild\n    })\n  }\n\n  return prefixed\n}\n"],"mappings":";AAeA,SAAgB,EACd,GACA,GACM;CACN,IAAM,EAAE,YAAS,kBAAe,gBAAa;AAC7C,KAAI,MAAa,YAAa;CAE9B,IAAM,IAAgB,CAAC,GAAG,EAAM;AAEhC,MAAK,IAAM,KAAU,EAEf,aAAa,2BAA2B,MAAW,GAEvD,MAAK,IAAM,KAAQ,GAAe;EAChC,IAAM,IAAe,EAAW,GAAM,EAAO;AAC7C,IAAM,KAAK,EAAa;;AAM5B,CAAI,MAAa,YAEf,EAAM,OAAO,GAAG,EAAc,OAAO;;AAIzC,SAAS,EAAW,GAAiB,GAA2B;CAC9D,IAAM,IAAsB;EAC1B,GAAG;EACH,MAAM,IAAI,IAAS,EAAK,SAAS,MAAM,KAAK,EAAK;EAClD;AAeD,QAdI,EAAK,SACP,EAAS,OAAO,GAAG,EAAK,KAAK,KAAK,MAGhC,EAAK,aACP,EAAS,WAAW,EAAK,SAAS,KAAK,MAAU;EAC/C,IAAM,IAA2B,EAAE,GAAG,GAAO;AAI7C,SAHI,EAAM,SACR,EAAc,OAAO,GAAG,EAAM,KAAK,KAAK,MAEnC;GACP,GAGG"}

package/dist/page-extend-OvV-ZhFB.cjs

@@ -1,2 +0,0 @@
-function e(e,n){let{locales:r,defaultLocale:i,strategy:a}=n;if(a===`no_prefix`)return;let o=[...e];for(let n of r)if(!(a===`prefix_except_default`&&n===i))for(let r of o){let i=t(r,n);e.push(i)}a===`prefix`&&e.splice(0,o.length)}function t(e,t){let n={...e,path:`/${t}${e.path===`/`?``:e.path}`};return e.name&&(n.name=`${e.name}___${t}`),e.children&&(n.children=e.children.map(e=>{let n={...e};return e.name&&(n.name=`${e.name}___${t}`),n})),n}Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return e}});
-//# sourceMappingURL=page-extend-OvV-ZhFB.cjs.map

package/dist/page-extend-OvV-ZhFB.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"page-extend-OvV-ZhFB.cjs","names":[],"sources":["../src/runtime/page-extend.ts"],"sourcesContent":["import type { Strategy } from '../types'\n\n/** Page route definition used for route extension */\nexport interface PageRoute {\n  path: string\n  name?: string\n  children?: PageRoute[]\n}\n\n/**\n * Extend page routes with locale-prefixed variants.\n * Mutates the pages array in place (Nuxt convention).\n *\n * This is a build-time utility used in the module's `pages:extend` hook.\n */\nexport function extendPages(\n  pages: PageRoute[],\n  options: { locales: string[]; defaultLocale: string; strategy: Strategy },\n): void {\n  const { locales, defaultLocale, strategy } = options\n  if (strategy === 'no_prefix') return\n\n  const originalPages = [...pages]\n\n  for (const locale of locales) {\n    // For prefix_except_default, skip creating prefixed routes for the default locale\n    if (strategy === 'prefix_except_default' && locale === defaultLocale) continue\n\n    for (const page of originalPages) {\n      const prefixedPage = prefixPage(page, locale)\n      pages.push(prefixedPage)\n    }\n  }\n\n  // For prefix strategy, remove the original unprefixed routes\n  // (every locale including default must have a prefix)\n  if (strategy === 'prefix') {\n    // Remove all original pages (they'll only exist as prefixed versions)\n    pages.splice(0, originalPages.length)\n  }\n}\n\nfunction prefixPage(page: PageRoute, locale: string): PageRoute {\n  const prefixed: PageRoute = {\n    ...page,\n    path: `/${locale}${page.path === '/' ? '' : page.path}`,\n  }\n  if (page.name) {\n    prefixed.name = `${page.name}___${locale}`\n  }\n\n  if (page.children) {\n    prefixed.children = page.children.map((child) => {\n      const prefixedChild: PageRoute = { ...child }\n      if (child.name) {\n        prefixedChild.name = `${child.name}___${locale}`\n      }\n      return prefixedChild\n    })\n  }\n\n  return prefixed\n}\n"],"mappings":"AAeA,SAAgB,EACd,EACA,EACM,CACN,GAAM,CAAE,UAAS,gBAAe,YAAa,EAC7C,GAAI,IAAa,YAAa,OAE9B,IAAM,EAAgB,CAAC,GAAG,EAAM,CAEhC,IAAK,IAAM,KAAU,EAEf,SAAa,yBAA2B,IAAW,GAEvD,IAAK,IAAM,KAAQ,EAAe,CAChC,IAAM,EAAe,EAAW,EAAM,EAAO,CAC7C,EAAM,KAAK,EAAa,CAMxB,IAAa,UAEf,EAAM,OAAO,EAAG,EAAc,OAAO,CAIzC,SAAS,EAAW,EAAiB,EAA2B,CAC9D,IAAM,EAAsB,CAC1B,GAAG,EACH,KAAM,IAAI,IAAS,EAAK,OAAS,IAAM,GAAK,EAAK,OAClD,CAeD,OAdI,EAAK,OACP,EAAS,KAAO,GAAG,EAAK,KAAK,KAAK,KAGhC,EAAK,WACP,EAAS,SAAW,EAAK,SAAS,IAAK,GAAU,CAC/C,IAAM,EAA2B,CAAE,GAAG,EAAO,CAI7C,OAHI,EAAM,OACR,EAAc,KAAO,GAAG,EAAM,KAAK,KAAK,KAEnC,GACP,EAGG"}