@i18n-micro/utils 1.0.8 → 1.0.13

package/dist/auto-detect-path.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function i(e,o={}){const t=o.autoDetectPath??"/",r=!e||e===""?"/":e;if(t==="*")return!0;if(t==="no_prefix")return!o.hasLocalePrefix;if(t==="/"||t==="")return r==="/";const c=t.startsWith("/")?t:`/${t}`;return r===c||r===`${c}/`}exports.shouldAttemptLocaleRedirect=i;

package/dist/auto-detect-path.d.cts

@@ -0,0 +1,16 @@
+/**
+ * Whether cookie / Accept-Language preference may steer locale redirects (#242).
+ *
+ * Modes (`ModuleOptions.autoDetectPath`):
+ * - `'/'` (default) — only `/`
+ * - `'no_prefix'` — any path without a locale prefix
+ * - `'*'` — every path (also enables aggressive prefixed-URL rewrites in the plugin)
+ * - any other string — exact path match
+ *
+ * Does not gate strategy / `localeRoutes` canonicalization: when preference is denied on an
+ * unprefixed path, the plugin still runs `getClientRedirect` with the default locale.
+ */
+export declare function shouldAttemptLocaleRedirect(path: string, options?: {
+    autoDetectPath?: string;
+    hasLocalePrefix?: boolean;
+}): boolean;

package/dist/auto-detect-path.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Whether cookie / Accept-Language preference may steer locale redirects (#242).
+ *
+ * Modes (`ModuleOptions.autoDetectPath`):
+ * - `'/'` (default) — only `/`
+ * - `'no_prefix'` — any path without a locale prefix
+ * - `'*'` — every path (also enables aggressive prefixed-URL rewrites in the plugin)
+ * - any other string — exact path match
+ *
+ * Does not gate strategy / `localeRoutes` canonicalization: when preference is denied on an
+ * unprefixed path, the plugin still runs `getClientRedirect` with the default locale.
+ */
+export declare function shouldAttemptLocaleRedirect(path: string, options?: {
+    autoDetectPath?: string;
+    hasLocalePrefix?: boolean;
+}): boolean;

package/dist/auto-detect-path.mjs

@@ -0,0 +1,13 @@
+function c(e, n = {}) {
+  const t = n.autoDetectPath ?? "/", r = !e || e === "" ? "/" : e;
+  if (t === "*") return !0;
+  if (t === "no_prefix")
+    return !n.hasLocalePrefix;
+  if (t === "/" || t === "")
+    return r === "/";
+  const o = t.startsWith("/") ? t : `/${t}`;
+  return r === o || r === `${o}/`;
+}
+export {
+  c as shouldAttemptLocaleRedirect
+};

package/dist/build.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("node:fs"),i=require("node:path"),j=require("globby"),M=require("./deep-merge.cjs");async function P(m,h,r,y,p,w){n.existsSync(r)&&n.rmSync(r,{recursive:!0,force:!0}),n.mkdirSync(r,{recursive:!0});const c=m.map(e=>i.join(e,h)),l=new Set,S=await Promise.all(c.filter(e=>n.existsSync(e)).map(e=>j.globby("**/*.json",{cwd:e})));for(const e of S)e.forEach(o=>l.add(o));const g=new Map;for(const e of l){let o={};for(const t of c){const s=i.join(t,e);if(n.existsSync(s))try{o=M.deepMergeTranslationsRecursive(o,JSON.parse(n.readFileSync(s,"utf-8")))}catch{}}g.set(e,o)}const d=new Map,f=new Map;for(const[e,o]of g){const t=i.dirname(e),s=e.slice(e.lastIndexOf("/")+1).replace(".json","");t==="."?d.set(s,o):(f.has(t)||f.set(t,new Map),f.get(t).set(s,o))}const v=new Set(y.map(e=>e.code)),b=e=>{for(const o of y){const t=[p,o.fallbackLocale,o.code].filter(a=>!!a&&v.has(a)).filter((a,u,x)=>x.indexOf(a)===u);if(t.length<=1)continue;let s={};for(const a of t){const u=e.get(a);u&&(s=M.deepMergeTranslationsRecursive(s,u))}e.set(o.code,s)}};b(d);for(const e of f.values())b(e);if(w||f.size===0){const e=new Map;for(const[o,t]of d)e.set(o,{...t});f.set("pages/index",e)}else for(const[,e]of f)for(const[o,t]of d){const s=e.get(o);e.set(o,s?M.deepMergeTranslations(t,s):{...t})}for(const[e,o]of f)for(const[t,s]of o){const a=i.join(r,e,`${t}.json`);n.mkdirSync(i.dirname(a),{recursive:!0}),n.writeFileSync(a,JSON.stringify(s))}}async function k(m,h,r){n.existsSync(r)&&n.rmSync(r,{recursive:!0,force:!0}),n.mkdirSync(r,{recursive:!0});const y=m.map(c=>i.join(c,h)),p=new Set,w=await Promise.all(y.filter(c=>n.existsSync(c)).map(c=>j.globby("**/*.json",{cwd:c})));for(const c of w)c.forEach(l=>p.add(l));for(const c of p){let l={};for(const g of y){const d=i.join(g,c);if(n.existsSync(d))try{l=M.deepMergeTranslationsRecursive(l,JSON.parse(n.readFileSync(d,"utf-8")))}catch{}}const S=i.join(r,c);n.mkdirSync(i.dirname(S),{recursive:!0}),n.writeFileSync(S,JSON.stringify(l))}}exports.buildTranslationSourceLayers=k;exports.preMergeLocales=P;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("node:fs"),r=require("node:path"),j=require("globby"),M=require("./deep-merge.cjs");async function P(m,h,a,p,S,w){n.existsSync(a)&&n.rmSync(a,{recursive:!0,force:!0}),n.mkdirSync(a,{recursive:!0});const c=m.map(e=>r.join(e,h)),i=new Set,g=await Promise.all(c.filter(e=>n.existsSync(e)).map(e=>j.globby("**/*.json",{cwd:e})));for(const e of g)e.forEach(o=>i.add(o));const u=new Map;for(const e of i){let o={};for(const t of c){const s=r.join(t,e);if(n.existsSync(s))try{o=M.deepMergeTranslationsRecursive(o,JSON.parse(n.readFileSync(s,"utf-8")))}catch{}}u.set(e,o)}const d=new Map,l=new Map;for(const[e,o]of u){const t=r.dirname(e),s=e.slice(e.lastIndexOf("/")+1).replace(".json","");t==="."?d.set(s,o):(l.has(t)||l.set(t,new Map),l.get(t).set(s,o))}const b=new Set(p.map(e=>e.code)),x=e=>{for(const o of p){const t=[S,o.fallbackLocale,o.code].filter(f=>!!f&&b.has(f)).filter((f,y,v)=>v.indexOf(f)===y);if(t.length<=1)continue;let s={};for(const f of t){const y=e.get(f);y&&(s=M.deepMergeTranslationsRecursive(s,y))}e.set(o.code,s)}};x(d);for(const e of l.values())x(e);if(w||l.size===0){const e=new Map;for(const[o,t]of d)e.set(o,{...t});l.set("pages/index",e)}else for(const[,e]of l)for(const[o,t]of d){const s=e.get(o);e.set(o,s?M.deepMergeTranslations(t,s):{...t})}for(const[e,o]of l){const t=e.replace(/^pages\/?/,"")||"index";for(const[s,f]of o){if(!b.has(s))continue;const y=r.join(a,t,s,"data.json");n.mkdirSync(r.dirname(y),{recursive:!0}),n.writeFileSync(y,JSON.stringify(f))}}}async function k(m,h,a){n.existsSync(a)&&n.rmSync(a,{recursive:!0,force:!0}),n.mkdirSync(a,{recursive:!0});const p=m.map(c=>r.join(c,h)),S=new Set,w=await Promise.all(p.filter(c=>n.existsSync(c)).map(c=>j.globby("**/*.json",{cwd:c})));for(const c of w)c.forEach(i=>S.add(i));for(const c of S){let i={};for(const u of p){const d=r.join(u,c);if(n.existsSync(d))try{i=M.deepMergeTranslationsRecursive(i,JSON.parse(n.readFileSync(d,"utf-8")))}catch{}}const g=r.join(a,c);n.mkdirSync(r.dirname(g),{recursive:!0}),n.writeFileSync(g,JSON.stringify(i))}}exports.buildTranslationSourceLayers=k;exports.preMergeLocales=P;

package/dist/build.d.cts

@@ -5,7 +5,7 @@ export interface PreMergeLocaleInfo {
 /**
  * Pre-merge all translation files at build time.
  *
- * Output: flat directory with structure pages/{routeName}/{locale}.json
+ * Output: `{page}/{locale}/data.json` (same relative path the client fetches under `apiBaseUrl`).
  */
 export declare function preMergeLocales(rootDirs: string[], translationDirName: string, outputDir: string, locales: PreMergeLocaleInfo[], globalFallbackLocale?: string, disablePageLocales?: boolean): Promise<void>;
 /**

package/dist/build.d.ts

@@ -5,7 +5,7 @@ export interface PreMergeLocaleInfo {
 /**
  * Pre-merge all translation files at build time.
  *
- * Output: flat directory with structure pages/{routeName}/{locale}.json
+ * Output: `{page}/{locale}/data.json` (same relative path the client fetches under `apiBaseUrl`).
  */
 export declare function preMergeLocales(rootDirs: string[], translationDirName: string, outputDir: string, locales: PreMergeLocaleInfo[], globalFallbackLocale?: string, disablePageLocales?: boolean): Promise<void>;
 /**

package/dist/build.mjs

@@ -1,81 +1,84 @@
-import O, { existsSync as i, mkdirSync as w, readFileSync as b, writeFileSync as j } from "node:fs";
-import { join as p, dirname as v } from "node:path";
-import { globby as F } from "globby";
-import { deepMergeTranslationsRecursive as P, deepMergeTranslations as J } from "./deep-merge.mjs";
-async function z(M, S, c, d, y, u) {
-  i(c) && O.rmSync(c, { recursive: !0, force: !0 }), w(c, { recursive: !0 });
-  const a = M.map((e) => p(e, S)), r = /* @__PURE__ */ new Set(), m = await Promise.all(a.filter((e) => i(e)).map((e) => F("**/*.json", { cwd: e })));
-  for (const e of m)
-    e.forEach((o) => r.add(o));
-  const g = /* @__PURE__ */ new Map();
-  for (const e of r) {
+import b, { existsSync as p, mkdirSync as w, readFileSync as j, writeFileSync as F } from "node:fs";
+import { join as d, dirname as v } from "node:path";
+import { globby as L } from "globby";
+import { deepMergeTranslationsRecursive as x, deepMergeTranslations as J } from "./deep-merge.mjs";
+async function z(M, S, n, y, m, u) {
+  p(n) && b.rmSync(n, { recursive: !0, force: !0 }), w(n, { recursive: !0 });
+  const s = M.map((e) => d(e, S)), c = /* @__PURE__ */ new Set(), g = await Promise.all(s.filter((e) => p(e)).map((e) => L("**/*.json", { cwd: e })));
+  for (const e of g)
+    e.forEach((o) => c.add(o));
+  const h = /* @__PURE__ */ new Map();
+  for (const e of c) {
     let o = {};
-    for (const t of a) {
-      const s = p(t, e);
-      if (i(s))
+    for (const t of s) {
+      const a = d(t, e);
+      if (p(a))
         try {
-          o = P(o, JSON.parse(b(s, "utf-8")));
+          o = x(o, JSON.parse(j(a, "utf-8")));
         } catch {
         }
     }
-    g.set(e, o);
+    h.set(e, o);
   }
-  const l = /* @__PURE__ */ new Map(), f = /* @__PURE__ */ new Map();
-  for (const [e, o] of g) {
-    const t = v(e), s = e.slice(e.lastIndexOf("/") + 1).replace(".json", "");
-    t === "." ? l.set(s, o) : (f.has(t) || f.set(t, /* @__PURE__ */ new Map()), f.get(t).set(s, o));
+  const l = /* @__PURE__ */ new Map(), r = /* @__PURE__ */ new Map();
+  for (const [e, o] of h) {
+    const t = v(e), a = e.slice(e.lastIndexOf("/") + 1).replace(".json", "");
+    t === "." ? l.set(a, o) : (r.has(t) || r.set(t, /* @__PURE__ */ new Map()), r.get(t).set(a, o));
   }
-  const L = new Set(d.map((e) => e.code)), x = (e) => {
-    for (const o of d) {
-      const t = [y, o.fallbackLocale, o.code].filter((n) => !!n && L.has(n)).filter((n, h, k) => k.indexOf(n) === h);
+  const P = new Set(y.map((e) => e.code)), O = (e) => {
+    for (const o of y) {
+      const t = [m, o.fallbackLocale, o.code].filter((f) => !!f && P.has(f)).filter((f, i, k) => k.indexOf(f) === i);
       if (t.length <= 1) continue;
-      let s = {};
-      for (const n of t) {
-        const h = e.get(n);
-        h && (s = P(s, h));
+      let a = {};
+      for (const f of t) {
+        const i = e.get(f);
+        i && (a = x(a, i));
       }
-      e.set(o.code, s);
+      e.set(o.code, a);
     }
   };
-  x(l);
-  for (const e of f.values())
-    x(e);
-  if (u || f.size === 0) {
+  O(l);
+  for (const e of r.values())
+    O(e);
+  if (u || r.size === 0) {
     const e = /* @__PURE__ */ new Map();
     for (const [o, t] of l)
       e.set(o, { ...t });
-    f.set("pages/index", e);
+    r.set("pages/index", e);
   } else
-    for (const [, e] of f)
+    for (const [, e] of r)
       for (const [o, t] of l) {
-        const s = e.get(o);
-        e.set(o, s ? J(t, s) : { ...t });
+        const a = e.get(o);
+        e.set(o, a ? J(t, a) : { ...t });
       }
-  for (const [e, o] of f)
-    for (const [t, s] of o) {
-      const n = p(c, e, `${t}.json`);
-      w(v(n), { recursive: !0 }), j(n, JSON.stringify(s));
+  for (const [e, o] of r) {
+    const t = e.replace(/^pages\/?/, "") || "index";
+    for (const [a, f] of o) {
+      if (!P.has(a)) continue;
+      const i = d(n, t, a, "data.json");
+      w(v(i), { recursive: !0 }), F(i, JSON.stringify(f));
     }
+  }
 }
-async function C(M, S, c) {
-  i(c) && O.rmSync(c, { recursive: !0, force: !0 }), w(c, { recursive: !0 });
-  const d = M.map((a) => p(a, S)), y = /* @__PURE__ */ new Set(), u = await Promise.all(
-    d.filter((a) => i(a)).map((a) => F("**/*.json", { cwd: a }))
+async function C(M, S, n) {
+  p(n) && b.rmSync(n, { recursive: !0, force: !0 }), w(n, { recursive: !0 });
+  const y = M.map((s) => d(s, S)), m = /* @__PURE__ */ new Set(), u = await Promise.all(
+    y.filter((s) => p(s)).map((s) => L("**/*.json", { cwd: s }))
   );
-  for (const a of u)
-    a.forEach((r) => y.add(r));
-  for (const a of y) {
-    let r = {};
-    for (const g of d) {
-      const l = p(g, a);
-      if (i(l))
+  for (const s of u)
+    s.forEach((c) => m.add(c));
+  for (const s of m) {
+    let c = {};
+    for (const h of y) {
+      const l = d(h, s);
+      if (p(l))
         try {
-          r = P(r, JSON.parse(b(l, "utf-8")));
+          c = x(c, JSON.parse(j(l, "utf-8")));
         } catch {
         }
     }
-    const m = p(c, a);
-    w(v(m), { recursive: !0 }), j(m, JSON.stringify(r));
+    const g = d(n, s);
+    w(v(g), { recursive: !0 }), F(g, JSON.stringify(c));
   }
 }
 export {

package/dist/merge-source.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("./deep-merge.cjs");function i(e,a,r){const c=new Set(a.map(o=>o.code)),n=a.find(o=>o.code===e);return[r,n?.fallbackLocale,e].filter(o=>!!o&&c.has(o)).filter((o,d,f)=>f.indexOf(o)===d)}function m(e,a,r){let c={};for(const n of e)c=t.deepMergeTranslations(c,a(r(n)));return c}async function l(e,a,r){return(await Promise.all(e.map(n=>a(r(n))))).reduce((n,o)=>t.deepMergeTranslations(n,o),{})}function s(e,a){return a?"index":e||"index"}function u(e){return`${e}.json`}function g(e,a){return`pages/${s(e)}/${a}.json`}function b(e){return`assets:i18n:${e.replace(/\//g,":")}`}async function S(e){const a=s(e.pageName,e.disablePageLocales),r=i(e.locale,e.locales,e.globalFallbackLocale),c=await l(r,e.readLocaleFile,u),n=await l(r,e.readLocaleFile,o=>g(a,o));return t.deepMergeTranslations(c,n)}function h(e){return(e??[]).map(a=>typeof a=="string"?{code:a}:{code:a.code,fallbackLocale:a.fallbackLocale})}exports.buildFallbackLocaleChain=i;exports.buildSourcePagePath=g;exports.buildSourceRootPath=u;exports.mergeSourceTranslations=S;exports.mergeTranslationsFromFallbackChain=m;exports.mergeTranslationsFromFallbackChainAsync=l;exports.normalizeConfiguredLocales=h;exports.resolveSourcePageName=s;exports.toSourceStorageKey=b;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("./deep-merge.cjs");function s(e,a,r){const c=new Set(a.map(o=>o.code)),n=a.find(o=>o.code===e);return[r,n?.fallbackLocale,e].filter(o=>!!o&&c.has(o)).filter((o,f,m)=>m.indexOf(o)===f)}function b(e,a,r){let c={};for(const n of e)c=l.deepMergeTranslations(c,a(r(n)));return c}async function t(e,a,r){return(await Promise.all(e.map(n=>a(r(n))))).reduce((n,o)=>l.deepMergeTranslations(n,o),{})}function i(e,a){return a?"index":e||"index"}function u(e){return`${e}.json`}function g(e,a){return`pages/${i(e)}/${a}.json`}function d(e){return e.replace(/^\/+/,"").replace(/\\/g,"/")}function S(e,a){const r=e.replace(/^\/+|\/+$/g,"")||"index";return d(`${r}/${a}/data.json`)}async function h(e){const a=i(e.pageName,e.disablePageLocales),r=s(e.locale,e.locales,e.globalFallbackLocale),c=await t(r,e.readLocaleFile,u),n=await t(r,e.readLocaleFile,o=>g(a,o));return l.deepMergeTranslations(c,n)}function k(e){return(e??[]).map(a=>typeof a=="string"?{code:a}:{code:a.code,fallbackLocale:a.fallbackLocale})}exports.buildFallbackLocaleChain=s;exports.buildSourcePagePath=g;exports.buildSourceRootPath=u;exports.mergeSourceTranslations=h;exports.mergeTranslationsFromFallbackChain=b;exports.mergeTranslationsFromFallbackChainAsync=t;exports.normalizeConfiguredLocales=k;exports.resolveSourcePageName=i;exports.toPremergedStorageKey=S;exports.toSourceStorageKey=d;

package/dist/merge-source.d.cts

@@ -17,6 +17,14 @@ export declare function mergeTranslationsFromFallbackChainAsync(chain: string[],
 export declare function resolveSourcePageName(pageName: string, disablePageLocales?: boolean): string;
 export declare function buildSourceRootPath(localeCode: string): string;
 export declare function buildSourcePagePath(pageName: string, localeCode: string): string;
+/**
+ * Storage key relative to the Nitro unstorage mount (fs-friendly `/` paths).
+ */
 export declare function toSourceStorageKey(relativePath: string): string;
+/**
+ * Premerged page/locale payload key — matches the client URL path under `apiBaseUrl`
+ * (`{page}/{locale}/data.json`, e.g. `index/en/data.json` → `/_locales/index/en/data.json`).
+ */
+export declare function toPremergedStorageKey(pageName: string, locale: string): string;
 export declare function mergeSourceTranslations(input: MergeSourceTranslationsInput): Promise<Record<string, unknown>>;
 export declare function normalizeConfiguredLocales(locales: Array<string | Locale> | undefined): SourceLocaleInfo[];

package/dist/merge-source.d.ts

@@ -17,6 +17,14 @@ export declare function mergeTranslationsFromFallbackChainAsync(chain: string[],
 export declare function resolveSourcePageName(pageName: string, disablePageLocales?: boolean): string;
 export declare function buildSourceRootPath(localeCode: string): string;
 export declare function buildSourcePagePath(pageName: string, localeCode: string): string;
+/**
+ * Storage key relative to the Nitro unstorage mount (fs-friendly `/` paths).
+ */
 export declare function toSourceStorageKey(relativePath: string): string;
+/**
+ * Premerged page/locale payload key — matches the client URL path under `apiBaseUrl`
+ * (`{page}/{locale}/data.json`, e.g. `index/en/data.json` → `/_locales/index/en/data.json`).
+ */
+export declare function toPremergedStorageKey(pageName: string, locale: string): string;
 export declare function mergeSourceTranslations(input: MergeSourceTranslationsInput): Promise<Record<string, unknown>>;
 export declare function normalizeConfiguredLocales(locales: Array<string | Locale> | undefined): SourceLocaleInfo[];

package/dist/merge-source.mjs

@@ -1,32 +1,36 @@
 import { deepMergeTranslations as t } from "./deep-merge.mjs";
-function f(e, a, r) {
-  const c = new Set(a.map((o) => o.code)), n = a.find((o) => o.code === e);
-  return [r, n?.fallbackLocale, e].filter((o) => !!o && c.has(o)).filter((o, i, u) => u.indexOf(o) === i);
+function f(e, a, n) {
+  const c = new Set(a.map((o) => o.code)), r = a.find((o) => o.code === e);
+  return [n, r?.fallbackLocale, e].filter((o) => !!o && c.has(o)).filter((o, s, u) => u.indexOf(o) === s);
 }
-function b(e, a, r) {
+function k(e, a, n) {
   let c = {};
-  for (const n of e)
-    c = t(c, a(r(n)));
+  for (const r of e)
+    c = t(c, a(n(r)));
   return c;
 }
-async function l(e, a, r) {
-  return (await Promise.all(e.map((n) => a(r(n))))).reduce((n, o) => t(n, o), {});
+async function l(e, a, n) {
+  return (await Promise.all(e.map((r) => a(n(r))))).reduce((r, o) => t(r, o), {});
 }
-function s(e, a) {
+function i(e, a) {
   return a ? "index" : e || "index";
 }
 function d(e) {
   return `${e}.json`;
 }
 function g(e, a) {
-  return `pages/${s(e)}/${a}.json`;
+  return `pages/${i(e)}/${a}.json`;
 }
-function k(e) {
-  return `assets:i18n:${e.replace(/\//g, ":")}`;
+function m(e) {
+  return e.replace(/^\/+/, "").replace(/\\/g, "/");
 }
-async function h(e) {
-  const a = s(e.pageName, e.disablePageLocales), r = f(e.locale, e.locales, e.globalFallbackLocale), c = await l(r, e.readLocaleFile, d), n = await l(r, e.readLocaleFile, (o) => g(a, o));
-  return t(c, n);
+function h(e, a) {
+  const n = e.replace(/^\/+|\/+$/g, "") || "index";
+  return m(`${n}/${a}/data.json`);
+}
+async function p(e) {
+  const a = i(e.pageName, e.disablePageLocales), n = f(e.locale, e.locales, e.globalFallbackLocale), c = await l(n, e.readLocaleFile, d), r = await l(n, e.readLocaleFile, (o) => g(a, o));
+  return t(c, r);
 }
 function L(e) {
   return (e ?? []).map(
@@ -37,10 +41,11 @@ export {
   f as buildFallbackLocaleChain,
   g as buildSourcePagePath,
   d as buildSourceRootPath,
-  h as mergeSourceTranslations,
-  b as mergeTranslationsFromFallbackChain,
+  p as mergeSourceTranslations,
+  k as mergeTranslationsFromFallbackChain,
   l as mergeTranslationsFromFallbackChainAsync,
   L as normalizeConfiguredLocales,
-  s as resolveSourcePageName,
-  k as toSourceStorageKey
+  i as resolveSourcePageName,
+  h as toPremergedStorageKey,
+  m as toSourceStorageKey
 };

package/dist/normalize.d.cts

@@ -1,6 +1,7 @@
 import { Translations } from '@i18n-micro/types';
 /**
  * Normalize unknown fetch/storage payloads into a plain translation object.
+ * Unstorage already runs `destr` on JSON files — strings are not expected here.
  */
 export declare function toTranslations(data: unknown): Translations;
 /**

package/dist/normalize.d.ts

@@ -1,6 +1,7 @@
 import { Translations } from '@i18n-micro/types';
 /**
  * Normalize unknown fetch/storage payloads into a plain translation object.
+ * Unstorage already runs `destr` on JSON files — strings are not expected here.
  */
 export declare function toTranslations(data: unknown): Translations;
 /**

package/dist/payload-config.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d=require("node:path"),r=500,t=10*1024*1024;function s(a){return a.translationPayloads?.mode==="source"?"source":"premerged"}function o(a){const e=s(a),n=e==="source";return{mode:e,serverAssets:a.translationPayloads?.serverAssets!==!1,serverHandler:a.translationPayloads?.serverHandler!==!1,publicAssets:n?a.translationPayloads?.publicAssets===!0:a.translationPayloads?.publicAssets!==!1,prerenderRoutes:n?a.translationPayloads?.prerenderRoutes===!0:a.translationPayloads?.prerenderRoutes!==!1,publicDir:a.translationPayloads?.publicDir,warnFileCount:a.translationPayloads?.warnFileCount,warnSizeBytes:a.translationPayloads?.warnSizeBytes}}function y(a,e){const n=o(e);return d.join(a??"./dist",n.publicDir??e.translationDir??"locales")}function c(a){return{warnFileCount:a?.warnFileCount??r,warnSizeBytes:a?.warnSizeBytes??t}}function l(a){return a.serverAssets||a.serverHandler||a.publicAssets||a.prerenderRoutes}function P(a){if(l(a.translationPayloads))return[];const e=[];return a.apiBaseServerHost||e.push("[nuxt-i18n-micro] translationPayloads disabled all local outputs but apiBaseServerHost is not set. SSR will load empty translations unless you provide an external server payload host."),a.apiBaseClientHost||e.push("[nuxt-i18n-micro] translationPayloads disabled all local outputs but apiBaseClientHost is not set. Client-side navigation may load empty translations unless you provide an external client payload host."),e}function i(a){return a>=1024*1024?`${(a/(1024*1024)).toFixed(1)} MB`:a>=1024?`${(a/1024).toFixed(1)} KB`:`${a} B`}function T(a,e){const n=e?.warnFileCount??r,u=e?.warnSizeBytes??t;return a.fileCount<n&&a.totalBytes<u?null:`[nuxt-i18n-micro] Generated translation payloads are large (${a.fileCount} files, ${i(a.totalBytes)}). Consider translationPayloads.mode: 'source' for serverless deployments, disabling unused outputs, or hosting payloads externally.`}exports.DEFAULT_TRANSLATION_PAYLOAD_WARN_FILE_COUNT=r;exports.DEFAULT_TRANSLATION_PAYLOAD_WARN_SIZE_BYTES=t;exports.formatBytes=i;exports.getTranslationPayloadMisconfigurationWarnings=P;exports.getTranslationPayloadSizeWarning=T;exports.hasLocalTranslationPayloadOutput=l;exports.resolveTranslationPayloadMode=s;exports.resolveTranslationPayloadOptions=o;exports.resolveTranslationPayloadPublicDir=y;exports.resolveTranslationPayloadWarningThresholds=c;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d=require("node:path"),s=500,n=10*1024*1024;function l(e){return e.translationPayloads?.mode==="source"?"source":"premerged"}function c(e){const a=l(e),r=a==="source";return{mode:a,serverAssets:e.translationPayloads?.serverAssets!==!1,serverHandler:e.translationPayloads?.serverHandler!==!1,publicAssets:r?e.translationPayloads?.publicAssets===!0:e.translationPayloads?.publicAssets!==!1,prerenderRoutes:e.translationPayloads?.prerenderRoutes===!0,publicDir:e.translationPayloads?.publicDir,warnFileCount:e.translationPayloads?.warnFileCount,warnSizeBytes:e.translationPayloads?.warnSizeBytes}}function o(e,a){const r=e.translationPayloads?.publicDir;return r!=null&&String(r).length>0?String(r).replace(/^\/+|\/+$/g,"").replace(/\/{2,}/g,"/")||"_locales":(a??e.apiBaseUrl??"_locales").replace(/^\/+|\/+$/g,"").replace(/\/{2,}/g,"/")||"_locales"}function y(e,a,r){return d.join(e??"./dist",o(a,r))}function P(e,a){return e.publicAssets?!0:a&&e.serverAssets}function p(e,a){return!a&&e.serverAssets}function A(e){return{warnFileCount:e?.warnFileCount??s,warnSizeBytes:e?.warnSizeBytes??n}}function i(e){return e.serverAssets||e.serverHandler||e.publicAssets||e.prerenderRoutes}function T(e){const a=[];return!e.translationPayloads.serverAssets&&!e.translationPayloads.publicAssets&&!e.apiBaseServerHost&&a.push("[nuxt-i18n-micro] translationPayloads.serverAssets and publicAssets are false and apiBaseServerHost is not set. SSR will load empty translations unless you provide an external server payload host."),i(e.translationPayloads)||(e.apiBaseServerHost||a.push("[nuxt-i18n-micro] translationPayloads disabled all local outputs but apiBaseServerHost is not set. SSR will load empty translations unless you provide an external server payload host."),e.apiBaseClientHost||a.push("[nuxt-i18n-micro] translationPayloads disabled all local outputs but apiBaseClientHost is not set. Client-side navigation may load empty translations unless you provide an external client payload host.")),a}function u(e){return e>=1024*1024?`${(e/(1024*1024)).toFixed(1)} MB`:e>=1024?`${(e/1024).toFixed(1)} KB`:`${e} B`}function v(e,a){const r=a?.warnFileCount??s,t=a?.warnSizeBytes??n;return e.fileCount<r&&e.totalBytes<t?null:`[nuxt-i18n-micro] Generated translation payloads are large (${e.fileCount} files, ${u(e.totalBytes)}). Consider translationPayloads.mode: 'source' for public output, hosting payloads externally, or disabling unused public/prerender outputs.`}exports.DEFAULT_TRANSLATION_PAYLOAD_WARN_FILE_COUNT=s;exports.DEFAULT_TRANSLATION_PAYLOAD_WARN_SIZE_BYTES=n;exports.formatBytes=u;exports.getTranslationPayloadMisconfigurationWarnings=T;exports.getTranslationPayloadSizeWarning=v;exports.hasLocalTranslationPayloadOutput=i;exports.resolveTranslationPayloadMode=l;exports.resolveTranslationPayloadOptions=c;exports.resolveTranslationPayloadPublicDir=y;exports.resolveTranslationPayloadPublicRel=o;exports.resolveTranslationPayloadWarningThresholds=A;exports.shouldCopyTranslationPayloadsToPublic=P;exports.shouldRegisterNitroServerAssets=p;

package/dist/payload-config.d.cts

@@ -27,7 +27,21 @@ export declare const DEFAULT_TRANSLATION_PAYLOAD_WARN_FILE_COUNT = 500;
 export declare const DEFAULT_TRANSLATION_PAYLOAD_WARN_SIZE_BYTES: number;
 export declare function resolveTranslationPayloadMode(options: ModuleOptions): TranslationPayloadMode;
 export declare function resolveTranslationPayloadOptions(options: ModuleOptions): ResolvedTranslationPayloadOptions;
-export declare function resolveTranslationPayloadPublicDir(outputPublicDir: string | undefined, options: ModuleOptions): string;
+/**
+ * Public payload directory relative to Nitro's public root.
+ * Defaults to `apiBaseUrl` (`_locales`) so static files match client fetch URLs.
+ */
+export declare function resolveTranslationPayloadPublicRel(options: ModuleOptions, apiBaseUrl?: string): string;
+export declare function resolveTranslationPayloadPublicDir(outputPublicDir: string | undefined, options: ModuleOptions, apiBaseUrl?: string): string;
+/**
+ * Whether production builds should copy the payload tree into Nitro public output.
+ * - `publicAssets: true` always copies (CDN / static clients).
+ * - On Node, `serverAssets: true` also forces a copy — SSR reads `public/` via fs (no Rollup `raw:`).
+ * - On Edge, `serverAssets` means Nitro `serverAssets` embed only — do not force a public tree.
+ */
+export declare function shouldCopyTranslationPayloadsToPublic(translationPayloads: ResolvedTranslationPayloadOptions, isNode: boolean): boolean;
+/** Edge-only: register Nitro `serverAssets` (`assets:i18n`) when local SSR payloads are enabled. */
+export declare function shouldRegisterNitroServerAssets(translationPayloads: ResolvedTranslationPayloadOptions, isNode: boolean): boolean;
 export declare function resolveTranslationPayloadWarningThresholds(options?: TranslationPayloadOptions): Required<TranslationPayloadSizeThresholds>;
 export declare function hasLocalTranslationPayloadOutput(translationPayloads: ResolvedTranslationPayloadOptions): boolean;
 export declare function getTranslationPayloadMisconfigurationWarnings(input: TranslationPayloadMisconfigurationInput): string[];

package/dist/payload-config.d.ts

@@ -27,7 +27,21 @@ export declare const DEFAULT_TRANSLATION_PAYLOAD_WARN_FILE_COUNT = 500;
 export declare const DEFAULT_TRANSLATION_PAYLOAD_WARN_SIZE_BYTES: number;
 export declare function resolveTranslationPayloadMode(options: ModuleOptions): TranslationPayloadMode;
 export declare function resolveTranslationPayloadOptions(options: ModuleOptions): ResolvedTranslationPayloadOptions;
-export declare function resolveTranslationPayloadPublicDir(outputPublicDir: string | undefined, options: ModuleOptions): string;
+/**
+ * Public payload directory relative to Nitro's public root.
+ * Defaults to `apiBaseUrl` (`_locales`) so static files match client fetch URLs.
+ */
+export declare function resolveTranslationPayloadPublicRel(options: ModuleOptions, apiBaseUrl?: string): string;
+export declare function resolveTranslationPayloadPublicDir(outputPublicDir: string | undefined, options: ModuleOptions, apiBaseUrl?: string): string;
+/**
+ * Whether production builds should copy the payload tree into Nitro public output.
+ * - `publicAssets: true` always copies (CDN / static clients).
+ * - On Node, `serverAssets: true` also forces a copy — SSR reads `public/` via fs (no Rollup `raw:`).
+ * - On Edge, `serverAssets` means Nitro `serverAssets` embed only — do not force a public tree.
+ */
+export declare function shouldCopyTranslationPayloadsToPublic(translationPayloads: ResolvedTranslationPayloadOptions, isNode: boolean): boolean;
+/** Edge-only: register Nitro `serverAssets` (`assets:i18n`) when local SSR payloads are enabled. */
+export declare function shouldRegisterNitroServerAssets(translationPayloads: ResolvedTranslationPayloadOptions, isNode: boolean): boolean;
 export declare function resolveTranslationPayloadWarningThresholds(options?: TranslationPayloadOptions): Required<TranslationPayloadSizeThresholds>;
 export declare function hasLocalTranslationPayloadOutput(translationPayloads: ResolvedTranslationPayloadOptions): boolean;
 export declare function getTranslationPayloadMisconfigurationWarnings(input: TranslationPayloadMisconfigurationInput): string[];

package/dist/payload-config.mjs

@@ -1,59 +1,74 @@
 import { join as l } from "node:path";
-const r = 500, t = 10 * 1024 * 1024;
-function o(a) {
-  return a.translationPayloads?.mode === "source" ? "source" : "premerged";
+const n = 500, t = 10 * 1024 * 1024;
+function o(e) {
+  return e.translationPayloads?.mode === "source" ? "source" : "premerged";
 }
-function i(a) {
-  const e = o(a), n = e === "source";
+function y(e) {
+  const a = o(e), r = a === "source";
   return {
-    mode: e,
-    serverAssets: a.translationPayloads?.serverAssets !== !1,
-    serverHandler: a.translationPayloads?.serverHandler !== !1,
-    publicAssets: n ? a.translationPayloads?.publicAssets === !0 : a.translationPayloads?.publicAssets !== !1,
-    prerenderRoutes: n ? a.translationPayloads?.prerenderRoutes === !0 : a.translationPayloads?.prerenderRoutes !== !1,
-    publicDir: a.translationPayloads?.publicDir,
-    warnFileCount: a.translationPayloads?.warnFileCount,
-    warnSizeBytes: a.translationPayloads?.warnSizeBytes
+    mode: a,
+    serverAssets: e.translationPayloads?.serverAssets !== !1,
+    serverHandler: e.translationPayloads?.serverHandler !== !1,
+    publicAssets: r ? e.translationPayloads?.publicAssets === !0 : e.translationPayloads?.publicAssets !== !1,
+    // Off by default: prerendering `/_locales` without a live handler writes empty public stubs.
+    // Opt in when you need static `/{apiBaseUrl}/.../data.json` and payloads are already available.
+    prerenderRoutes: e.translationPayloads?.prerenderRoutes === !0,
+    publicDir: e.translationPayloads?.publicDir,
+    warnFileCount: e.translationPayloads?.warnFileCount,
+    warnSizeBytes: e.translationPayloads?.warnSizeBytes
   };
 }
-function y(a, e) {
-  const n = i(e);
-  return l(a ?? "./dist", n.publicDir ?? e.translationDir ?? "locales");
+function i(e, a) {
+  const r = e.translationPayloads?.publicDir;
+  return r != null && String(r).length > 0 ? String(r).replace(/^\/+|\/+$/g, "").replace(/\/{2,}/g, "/") || "_locales" : (a ?? e.apiBaseUrl ?? "_locales").replace(/^\/+|\/+$/g, "").replace(/\/{2,}/g, "/") || "_locales";
 }
-function f(a) {
+function p(e, a, r) {
+  return l(e ?? "./dist", i(a, r));
+}
+function f(e, a) {
+  return e.publicAssets ? !0 : a && e.serverAssets;
+}
+function v(e, a) {
+  return !a && e.serverAssets;
+}
+function A(e) {
   return {
-    warnFileCount: a?.warnFileCount ?? r,
-    warnSizeBytes: a?.warnSizeBytes ?? t
+    warnFileCount: e?.warnFileCount ?? n,
+    warnSizeBytes: e?.warnSizeBytes ?? t
   };
 }
-function u(a) {
-  return a.serverAssets || a.serverHandler || a.publicAssets || a.prerenderRoutes;
+function u(e) {
+  return e.serverAssets || e.serverHandler || e.publicAssets || e.prerenderRoutes;
 }
-function P(a) {
-  if (u(a.translationPayloads)) return [];
-  const e = [];
-  return a.apiBaseServerHost || e.push(
+function P(e) {
+  const a = [];
+  return !e.translationPayloads.serverAssets && !e.translationPayloads.publicAssets && !e.apiBaseServerHost && a.push(
+    "[nuxt-i18n-micro] translationPayloads.serverAssets and publicAssets are false and apiBaseServerHost is not set. SSR will load empty translations unless you provide an external server payload host."
+  ), u(e.translationPayloads) || (e.apiBaseServerHost || a.push(
     "[nuxt-i18n-micro] translationPayloads disabled all local outputs but apiBaseServerHost is not set. SSR will load empty translations unless you provide an external server payload host."
-  ), a.apiBaseClientHost || e.push(
+  ), e.apiBaseClientHost || a.push(
     "[nuxt-i18n-micro] translationPayloads disabled all local outputs but apiBaseClientHost is not set. Client-side navigation may load empty translations unless you provide an external client payload host."
-  ), e;
+  )), a;
 }
-function d(a) {
-  return a >= 1024 * 1024 ? `${(a / (1024 * 1024)).toFixed(1)} MB` : a >= 1024 ? `${(a / 1024).toFixed(1)} KB` : `${a} B`;
+function d(e) {
+  return e >= 1024 * 1024 ? `${(e / (1024 * 1024)).toFixed(1)} MB` : e >= 1024 ? `${(e / 1024).toFixed(1)} KB` : `${e} B`;
 }
-function p(a, e) {
-  const n = e?.warnFileCount ?? r, s = e?.warnSizeBytes ?? t;
-  return a.fileCount < n && a.totalBytes < s ? null : `[nuxt-i18n-micro] Generated translation payloads are large (${a.fileCount} files, ${d(a.totalBytes)}). Consider translationPayloads.mode: 'source' for serverless deployments, disabling unused outputs, or hosting payloads externally.`;
+function S(e, a) {
+  const r = a?.warnFileCount ?? n, s = a?.warnSizeBytes ?? t;
+  return e.fileCount < r && e.totalBytes < s ? null : `[nuxt-i18n-micro] Generated translation payloads are large (${e.fileCount} files, ${d(e.totalBytes)}). Consider translationPayloads.mode: 'source' for public output, hosting payloads externally, or disabling unused public/prerender outputs.`;
 }
 export {
-  r as DEFAULT_TRANSLATION_PAYLOAD_WARN_FILE_COUNT,
+  n as DEFAULT_TRANSLATION_PAYLOAD_WARN_FILE_COUNT,
   t as DEFAULT_TRANSLATION_PAYLOAD_WARN_SIZE_BYTES,
   d as formatBytes,
   P as getTranslationPayloadMisconfigurationWarnings,
-  p as getTranslationPayloadSizeWarning,
+  S as getTranslationPayloadSizeWarning,
   u as hasLocalTranslationPayloadOutput,
   o as resolveTranslationPayloadMode,
-  i as resolveTranslationPayloadOptions,
-  y as resolveTranslationPayloadPublicDir,
-  f as resolveTranslationPayloadWarningThresholds
+  y as resolveTranslationPayloadOptions,
+  p as resolveTranslationPayloadPublicDir,
+  i as resolveTranslationPayloadPublicRel,
+  A as resolveTranslationPayloadWarningThresholds,
+  f as shouldCopyTranslationPayloadsToPublic,
+  v as shouldRegisterNitroServerAssets
 };

package/dist/resolve-hreflang.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function l(e){return e.iso?.trim()||String(e.code)}function u(e){const r=e.match(/^([A-Za-z]{2,3})(?:[-_](.+))?$/);return r?{language:r[1],region:r[2]}:{language:e}}function d(e,r={}){const{hreflangBaseLanguage:f=!1}=r;if(!f)return e.map(t=>{const o=String(t.code);return{hreflang:l(t),localeCode:o}});const s=new Map;for(const t of e){const o=String(t.code),a=l(t),{language:n,region:i}=u(a);n&&i&&!s.has(n)&&s.set(n,o),s.set(a,o)}const g=new Set,c=[];for(const t of e){const o=String(t.code),a=l(t),{language:n,region:i}=u(a);n&&i&&s.get(n)===o&&!g.has(n)&&(g.add(n),c.push({hreflang:n,localeCode:o})),g.has(a)||(g.add(a),c.push({hreflang:a,localeCode:o}))}return c}exports.resolveHreflangAlternates=d;

package/dist/resolve-hreflang.d.cts

@@ -0,0 +1,22 @@
+import { Locale } from '@i18n-micro/types';
+export type HreflangLocaleInput = Pick<Locale, 'code' | 'iso'>;
+export interface ResolveHreflangAlternatesOptions {
+    /**
+     * Also emit a bare-language `hreflang` derived from `iso` (e.g. `es-ES` → `es`),
+     * claimed by the first regional locale in the list for that language.
+     * Never derived from routing `code`.
+     * @default false
+     */
+    hreflangBaseLanguage?: boolean;
+}
+export interface HreflangAlternate {
+    /** Value for the `hreflang` attribute (BCP-47 / `iso || code`). */
+    hreflang: string;
+    /** Locale `code` whose localized URL should back this tag. */
+    localeCode: string;
+}
+/**
+ * Resolve `hreflang` values for SEO alternate links.
+ * Uses `iso || code` — never emits routing `code` when `iso` is set (#243).
+ */
+export declare function resolveHreflangAlternates(locales: HreflangLocaleInput[], options?: ResolveHreflangAlternatesOptions): HreflangAlternate[];

package/dist/resolve-hreflang.d.ts

@@ -0,0 +1,22 @@
+import { Locale } from '@i18n-micro/types';
+export type HreflangLocaleInput = Pick<Locale, 'code' | 'iso'>;
+export interface ResolveHreflangAlternatesOptions {
+    /**
+     * Also emit a bare-language `hreflang` derived from `iso` (e.g. `es-ES` → `es`),
+     * claimed by the first regional locale in the list for that language.
+     * Never derived from routing `code`.
+     * @default false
+     */
+    hreflangBaseLanguage?: boolean;
+}
+export interface HreflangAlternate {
+    /** Value for the `hreflang` attribute (BCP-47 / `iso || code`). */
+    hreflang: string;
+    /** Locale `code` whose localized URL should back this tag. */
+    localeCode: string;
+}
+/**
+ * Resolve `hreflang` values for SEO alternate links.
+ * Uses `iso || code` — never emits routing `code` when `iso` is set (#243).
+ */
+export declare function resolveHreflangAlternates(locales: HreflangLocaleInput[], options?: ResolveHreflangAlternatesOptions): HreflangAlternate[];

package/dist/resolve-hreflang.mjs

@@ -0,0 +1,29 @@
+function u(n) {
+  return n.iso?.trim() || String(n.code);
+}
+function f(n) {
+  const r = n.match(/^([A-Za-z]{2,3})(?:[-_](.+))?$/);
+  return r ? { language: r[1], region: r[2] } : { language: n };
+}
+function d(n, r = {}) {
+  const { hreflangBaseLanguage: l = !1 } = r;
+  if (!l)
+    return n.map((o) => {
+      const t = String(o.code);
+      return { hreflang: u(o), localeCode: t };
+    });
+  const g = /* @__PURE__ */ new Map();
+  for (const o of n) {
+    const t = String(o.code), a = u(o), { language: e, region: i } = f(a);
+    e && i && !g.has(e) && g.set(e, t), g.set(a, t);
+  }
+  const s = /* @__PURE__ */ new Set(), c = [];
+  for (const o of n) {
+    const t = String(o.code), a = u(o), { language: e, region: i } = f(a);
+    e && i && g.get(e) === t && !s.has(e) && (s.add(e), c.push({ hreflang: e, localeCode: t })), s.has(a) || (s.add(a), c.push({ hreflang: a, localeCode: t }));
+  }
+  return c;
+}
+export {
+  d as resolveHreflangAlternates
+};

package/dist/split-locale-routes.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function a(s){const o=[],n={},r=new Set;for(const t of s){const e=t.name?.trim();if(!e)throw new Error("[splitLocaleRoutes] each entry needs a non-empty `name`");if(!t.path)throw new Error(`[splitLocaleRoutes] entry "${e}" needs a \`path\``);if(!t.file)throw new Error(`[splitLocaleRoutes] entry "${e}" needs a \`file\``);if(r.has(e))throw new Error(`[splitLocaleRoutes] duplicate route name "${e}"`);r.add(e),o.push({name:e,path:t.path,file:t.file}),t.paths!==void 0&&(n[e]=t.paths)}return{pages:o,globalLocaleRoutes:n}}exports.splitLocaleRoutes=a;

package/dist/split-locale-routes.d.cts

@@ -0,0 +1,36 @@
+import { GlobalLocaleRoutes, LocaleCode } from '@i18n-micro/types';
+/**
+ * One programmatic route entry for {@link splitLocaleRoutes} (#244).
+ * Prefer route `name` as the `globalLocaleRoutes` key so shared wrapper SFCs do not collapse.
+ */
+export interface SplitLocaleRouteEntry {
+    /** Route name — also the key in `globalLocaleRoutes`. */
+    name: string;
+    /** Default (unlocalized) path pushed into `pages:extend`. */
+    path: string;
+    /** Page component / wrapper SFC (Nuxt `file`). */
+    file: string;
+    /**
+     * Custom per-locale paths, or `false` to disable localization for this route.
+     * Omitted → route is still pushed to `pages`, but no `globalLocaleRoutes` entry.
+     */
+    paths?: Record<LocaleCode, string> | false;
+}
+export interface SplitLocaleRoutePage {
+    name: string;
+    path: string;
+    file: string;
+}
+export interface SplitLocaleRoutesResult {
+    /** Pass into `pages:extend`: `pages.push(...pages)`. */
+    pages: SplitLocaleRoutePage[];
+    /** Merge into `i18n.globalLocaleRoutes` (keyed by route name). */
+    globalLocaleRoutes: NonNullable<GlobalLocaleRoutes>;
+}
+/**
+ * Split one programmatic route registry into Nuxt pages + `globalLocaleRoutes` (#244).
+ *
+ * Keeps both halves in sync and keys locale paths by route **name** (not file path),
+ * so N routes sharing one wrapper SFC do not overwrite each other.
+ */
+export declare function splitLocaleRoutes(entries: readonly SplitLocaleRouteEntry[]): SplitLocaleRoutesResult;

package/dist/split-locale-routes.d.ts

@@ -0,0 +1,36 @@
+import { GlobalLocaleRoutes, LocaleCode } from '@i18n-micro/types';
+/**
+ * One programmatic route entry for {@link splitLocaleRoutes} (#244).
+ * Prefer route `name` as the `globalLocaleRoutes` key so shared wrapper SFCs do not collapse.
+ */
+export interface SplitLocaleRouteEntry {
+    /** Route name — also the key in `globalLocaleRoutes`. */
+    name: string;
+    /** Default (unlocalized) path pushed into `pages:extend`. */
+    path: string;
+    /** Page component / wrapper SFC (Nuxt `file`). */
+    file: string;
+    /**
+     * Custom per-locale paths, or `false` to disable localization for this route.
+     * Omitted → route is still pushed to `pages`, but no `globalLocaleRoutes` entry.
+     */
+    paths?: Record<LocaleCode, string> | false;
+}
+export interface SplitLocaleRoutePage {
+    name: string;
+    path: string;
+    file: string;
+}
+export interface SplitLocaleRoutesResult {
+    /** Pass into `pages:extend`: `pages.push(...pages)`. */
+    pages: SplitLocaleRoutePage[];
+    /** Merge into `i18n.globalLocaleRoutes` (keyed by route name). */
+    globalLocaleRoutes: NonNullable<GlobalLocaleRoutes>;
+}
+/**
+ * Split one programmatic route registry into Nuxt pages + `globalLocaleRoutes` (#244).
+ *
+ * Keeps both halves in sync and keys locale paths by route **name** (not file path),
+ * so N routes sharing one wrapper SFC do not overwrite each other.
+ */
+export declare function splitLocaleRoutes(entries: readonly SplitLocaleRouteEntry[]): SplitLocaleRoutesResult;

package/dist/split-locale-routes.mjs

@@ -0,0 +1,19 @@
+function s(a) {
+  const o = [], n = {}, r = /* @__PURE__ */ new Set();
+  for (const t of a) {
+    const e = t.name?.trim();
+    if (!e)
+      throw new Error("[splitLocaleRoutes] each entry needs a non-empty `name`");
+    if (!t.path)
+      throw new Error(`[splitLocaleRoutes] entry "${e}" needs a \`path\``);
+    if (!t.file)
+      throw new Error(`[splitLocaleRoutes] entry "${e}" needs a \`file\``);
+    if (r.has(e))
+      throw new Error(`[splitLocaleRoutes] duplicate route name "${e}"`);
+    r.add(e), o.push({ name: e, path: t.path, file: t.file }), t.paths !== void 0 && (n[e] = t.paths);
+  }
+  return { pages: o, globalLocaleRoutes: n };
+}
+export {
+  s as splitLocaleRoutes
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@i18n-micro/utils",
-  "version": "1.0.8",
+  "version": "1.0.13",
   "description": "Framework-agnostic utilities for Nuxt I18n Micro (granular subpath imports).",
   "keywords": [
     "i18n",
@@ -165,6 +165,36 @@
       },
       "default": "./dist/resolve-locale.mjs"
     },
+    "./auto-detect-path": {
+      "production": {
+        "types": "./dist/auto-detect-path.d.ts",
+        "default": "./dist/auto-detect-path.mjs"
+      },
+      "import": {
+        "types": "./dist/auto-detect-path.d.ts",
+        "default": "./dist/auto-detect-path.mjs"
+      },
+      "require": {
+        "types": "./dist/auto-detect-path.d.cts",
+        "default": "./dist/auto-detect-path.cjs"
+      },
+      "default": "./dist/auto-detect-path.mjs"
+    },
+    "./split-locale-routes": {
+      "production": {
+        "types": "./dist/split-locale-routes.d.ts",
+        "default": "./dist/split-locale-routes.mjs"
+      },
+      "import": {
+        "types": "./dist/split-locale-routes.d.ts",
+        "default": "./dist/split-locale-routes.mjs"
+      },
+      "require": {
+        "types": "./dist/split-locale-routes.d.cts",
+        "default": "./dist/split-locale-routes.cjs"
+      },
+      "default": "./dist/split-locale-routes.mjs"
+    },
     "./resolve-og-locale": {
       "production": {
         "types": "./dist/resolve-og-locale.d.ts",
@@ -180,6 +210,21 @@
       },
       "default": "./dist/resolve-og-locale.mjs"
     },
+    "./resolve-hreflang": {
+      "production": {
+        "types": "./dist/resolve-hreflang.d.ts",
+        "default": "./dist/resolve-hreflang.mjs"
+      },
+      "import": {
+        "types": "./dist/resolve-hreflang.d.ts",
+        "default": "./dist/resolve-hreflang.mjs"
+      },
+      "require": {
+        "types": "./dist/resolve-hreflang.d.cts",
+        "default": "./dist/resolve-hreflang.cjs"
+      },
+      "default": "./dist/resolve-hreflang.mjs"
+    },
     "./merge-i18n-head": {
       "production": {
         "types": "./dist/merge-i18n-head.d.ts",
@@ -353,14 +398,14 @@
   },
   "dependencies": {
     "globby": "^14.1.0",
-    "@i18n-micro/types": "1.2.7"
+    "@i18n-micro/types": "^1.2.10"
   },
   "devDependencies": {
     "publint": "^0.3.17",
     "vite": "^7.3.6",
     "vite-plugin-dts": "^4.5.4",
     "vitest": "^4.1.10",
-    "@i18n-micro/test-utils": "1.2.6"
+    "@i18n-micro/test-utils": "^1.2.8"
   },
   "engines": {
     "node": ">=18"