@i18n-micro/utils 1.0.7 → 1.0.11

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/cache-control.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class s{constructor(t){this.cache=new Map,this.expiry=new Map,this.maxSize=0,this.ttlMs=0,t&&this.configure(t)}configure(t){this.maxSize=t.maxSize??0,this.ttlMs=(t.ttl??0)*1e3,this.ttlMs===0&&this.expiry.clear()}get(t){const e=this.cache.get(t);if(e!==void 0){if(this.ttlMs>0){const i=this.expiry.get(t);if(i&&Date.now()>i){this.delete(t);return}this.expiry.set(t,Date.now()+this.ttlMs)}return this.cache.delete(t),this.cache.set(t,e),e}}has(t){if(!this.cache.has(t))return!1;if(this.ttlMs>0){const e=this.expiry.get(t);if(e&&Date.now()>e)return this.delete(t),!1}return!0}set(t,e){if(this.cache.has(t))this.cache.delete(t);else if(this.maxSize>0&&this.cache.size>=this.maxSize){const i=this.cache.keys().next().value;i!==void 0&&this.delete(i)}this.cache.set(t,e),this.ttlMs>0&&this.expiry.set(t,Date.now()+this.ttlMs)}delete(t){return this.expiry.delete(t),this.cache.delete(t)}clear(){this.cache.clear(),this.expiry.clear()}keys(){return this.cache.keys()}get size(){return this.cache.size}}exports.CacheControl=s;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class s{constructor(t){this.cache=new Map,this.expiry=new Map,this.maxSize=0,this.ttlMs=0,t&&this.configure(t)}configure(t){this.maxSize=t.maxSize??0,this.ttlMs=(t.ttl??0)*1e3,this.ttlMs===0&&this.expiry.clear()}get(t){const e=this.cache.get(t);if(e!==void 0){if(this.ttlMs>0){const i=this.expiry.get(t);if(i&&Date.now()>i){this.delete(t);return}this.expiry.set(t,Date.now()+this.ttlMs)}return this.maxSize>0&&(this.cache.delete(t),this.cache.set(t,e)),e}}has(t){if(!this.cache.has(t))return!1;if(this.ttlMs>0){const e=this.expiry.get(t);if(e&&Date.now()>e)return this.delete(t),!1}return!0}set(t,e){if(this.cache.has(t))this.cache.delete(t);else if(this.maxSize>0&&this.cache.size>=this.maxSize){const i=this.cache.keys().next().value;i!==void 0&&this.delete(i)}this.cache.set(t,e),this.ttlMs>0&&this.expiry.set(t,Date.now()+this.ttlMs)}delete(t){return this.expiry.delete(t),this.cache.delete(t)}clear(){this.cache.clear(),this.expiry.clear()}keys(){return this.cache.keys()}get size(){return this.cache.size}}exports.CacheControl=s;

package/dist/cache-control.mjs

@@ -17,7 +17,7 @@ class h {
         }
         this.expiry.set(t, Date.now() + this.ttlMs);
       }
-      return this.cache.delete(t), this.cache.set(t, e), e;
+      return this.maxSize > 0 && (this.cache.delete(t), this.cache.set(t, e)), e;
     }
   }
   has(t) {

package/dist/deep-merge.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function i(s,o){const t={...s};for(const e in o){if(e==="__proto__"||e==="constructor")continue;const r=o[e],n=t[e];r!==null&&typeof r=="object"&&!Array.isArray(r)&&n!==null&&typeof n=="object"&&!Array.isArray(n)?t[e]={...n,...r}:t[e]=r}return t}function c(s,o){if(!s||Object.keys(s).length===0)return{...o};const t={...s};for(const e in o){if(e==="__proto__"||e==="constructor")continue;const r=o[e],n=t[e];r&&typeof r=="object"&&!Array.isArray(r)&&n&&typeof n=="object"&&!Array.isArray(n)?t[e]=c(n,r):t[e]=r}return t}exports.deepMergeTranslations=i;exports.deepMergeTranslationsRecursive=c;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function i(s,n){const r={...s};for(const e of Object.keys(n)){if(e==="__proto__")continue;const t=n[e],o=r[e];t!==null&&typeof t=="object"&&!Array.isArray(t)&&o!==null&&typeof o=="object"&&!Array.isArray(o)?r[e]={...o,...t}:r[e]=t}return r}function c(s,n){if(!s||Object.keys(s).length===0)return{...n};const r={...s};for(const e of Object.keys(n)){if(e==="__proto__")continue;const t=n[e],o=r[e];t&&typeof t=="object"&&!Array.isArray(t)&&o&&typeof o=="object"&&!Array.isArray(o)?r[e]=c(o,t):r[e]=t}return r}exports.deepMergeTranslations=i;exports.deepMergeTranslationsRecursive=c;

package/dist/deep-merge.mjs

@@ -1,23 +1,23 @@
-function i(s, e) {
-  const o = { ...s };
-  for (const t in e) {
-    if (t === "__proto__" || t === "constructor") continue;
-    const r = e[t], n = o[t];
-    r !== null && typeof r == "object" && !Array.isArray(r) && n !== null && typeof n == "object" && !Array.isArray(n) ? o[t] = { ...n, ...r } : o[t] = r;
+function y(s, n) {
+  const r = { ...s };
+  for (const e of Object.keys(n)) {
+    if (e === "__proto__") continue;
+    const t = n[e], o = r[e];
+    t !== null && typeof t == "object" && !Array.isArray(t) && o !== null && typeof o == "object" && !Array.isArray(o) ? r[e] = { ...o, ...t } : r[e] = t;
   }
-  return o;
+  return r;
 }
-function c(s, e) {
-  if (!s || Object.keys(s).length === 0) return { ...e };
-  const o = { ...s };
-  for (const t in e) {
-    if (t === "__proto__" || t === "constructor") continue;
-    const r = e[t], n = o[t];
-    r && typeof r == "object" && !Array.isArray(r) && n && typeof n == "object" && !Array.isArray(n) ? o[t] = c(n, r) : o[t] = r;
+function c(s, n) {
+  if (!s || Object.keys(s).length === 0) return { ...n };
+  const r = { ...s };
+  for (const e of Object.keys(n)) {
+    if (e === "__proto__") continue;
+    const t = n[e], o = r[e];
+    t && typeof t == "object" && !Array.isArray(t) && o && typeof o == "object" && !Array.isArray(o) ? r[e] = c(o, t) : r[e] = t;
   }
-  return o;
+  return r;
 }
 export {
-  i as deepMergeTranslations,
+  y as deepMergeTranslations,
   c as deepMergeTranslationsRecursive
 };

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/payload-stats.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("node:fs"),s=require("node:path");function r(n,t){for(const e of o.readdirSync(n,{withFileTypes:!0})){const i=s.join(n,e.name);if(e.isDirectory()){r(i,t);continue}e.name.endsWith(".json")&&(t.fileCount+=1,t.totalBytes+=o.statSync(i).size)}}function a(n){const t={fileCount:0,totalBytes:0};return o.existsSync(n)&&r(n,t),t}exports.scanTranslationPayloadDirectory=a;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const y=require("node:crypto"),o=require("node:fs"),l=require("node:zlib"),u=require("node:path");function f(n,t){for(const e of o.readdirSync(n,{withFileTypes:!0})){const s=u.join(n,e.name);e.isDirectory()?f(s,t):e.name.endsWith(".json")&&t.push(s)}}function S(n){const t={fileCount:0,totalBytes:0};if(!o.existsSync(n))return t;const e=[];f(n,e);for(const s of e)t.fileCount+=1,t.totalBytes+=o.statSync(s).size;return t}function d(n,t){const e=y.createHash("sha256");let s=0;for(const c of n){const a=u.join(c,t);if(!o.existsSync(a))continue;const r=[];f(a,r),r.sort();for(const i of r)e.update(u.relative(a,i)),e.update("\0"),e.update(o.readFileSync(i)),s+=1}return s>0?e.digest("hex").slice(0,16):null}const h=1024;function T(n,t){if(!t||!o.existsSync(n))return 0;const e=t===!0||t.gzip!==!1,s=t===!0||t.brotli!==!1;if(!e&&!s)return 0;const c=[];f(n,c);let a=0;for(const r of c){const i=o.readFileSync(r);i.length<h||(e&&o.writeFileSync(`${r}.gz`,l.gzipSync(i,{level:9})),s&&o.writeFileSync(`${r}.br`,l.brotliCompressSync(i,{params:{[l.constants.BROTLI_PARAM_QUALITY]:11,[l.constants.BROTLI_PARAM_SIZE_HINT]:i.length}})),a+=1)}return a}exports.compressTranslationPayloads=T;exports.hashTranslationSources=d;exports.scanTranslationPayloadDirectory=S;

package/dist/payload-stats.d.cts

@@ -1,2 +1,32 @@
 import { TranslationPayloadStats } from './payload-config';
 export declare function scanTranslationPayloadDirectory(dir: string): TranslationPayloadStats;
+/**
+ * Fingerprint of the translation sources, used to cache-bust `_locales` requests.
+ *
+ * The alternative — a build timestamp — changes on every deploy, so browsers and CDNs
+ * throw away a dictionary that may not have changed at all. Hashing the sources means
+ * the URL only moves when the translations actually move.
+ *
+ * Layer order matters (later layers override earlier ones), so paths are hashed in the
+ * order given and relative to their own root: an identical tree checked out elsewhere
+ * must produce the same value.
+ *
+ * Returns `null` when there is nothing to hash, leaving the caller to fall back.
+ */
+export declare function hashTranslationSources(rootDirs: string[], translationDirName: string): string | null;
+/** Nitro's `compressPublicAssets`: `true` means both encodings, an object selects them. */
+export type PublicAssetCompression = boolean | {
+    gzip?: boolean;
+    brotli?: boolean;
+} | undefined;
+/**
+ * Gzip/brotli the translation payloads copied into the public directory.
+ *
+ * Nitro compresses public assets before the `nitro:build:public-assets` hook where the
+ * payloads are copied, so `compressPublicAssets` never reaches them — a static host
+ * would serve the single largest part of the output uncompressed. This applies the
+ * user's setting to those files; it does not turn compression on by itself.
+ *
+ * Returns the number of files actually compressed.
+ */
+export declare function compressTranslationPayloads(dir: string, compression: PublicAssetCompression): number;

package/dist/payload-stats.d.ts

@@ -1,2 +1,32 @@
 import { TranslationPayloadStats } from './payload-config';
 export declare function scanTranslationPayloadDirectory(dir: string): TranslationPayloadStats;
+/**
+ * Fingerprint of the translation sources, used to cache-bust `_locales` requests.
+ *
+ * The alternative — a build timestamp — changes on every deploy, so browsers and CDNs
+ * throw away a dictionary that may not have changed at all. Hashing the sources means
+ * the URL only moves when the translations actually move.
+ *
+ * Layer order matters (later layers override earlier ones), so paths are hashed in the
+ * order given and relative to their own root: an identical tree checked out elsewhere
+ * must produce the same value.
+ *
+ * Returns `null` when there is nothing to hash, leaving the caller to fall back.
+ */
+export declare function hashTranslationSources(rootDirs: string[], translationDirName: string): string | null;
+/** Nitro's `compressPublicAssets`: `true` means both encodings, an object selects them. */
+export type PublicAssetCompression = boolean | {
+    gzip?: boolean;
+    brotli?: boolean;
+} | undefined;
+/**
+ * Gzip/brotli the translation payloads copied into the public directory.
+ *
+ * Nitro compresses public assets before the `nitro:build:public-assets` hook where the
+ * payloads are copied, so `compressPublicAssets` never reaches them — a static host
+ * would serve the single largest part of the output uncompressed. This applies the
+ * user's setting to those files; it does not turn compression on by itself.
+ *
+ * Returns the number of files actually compressed.
+ */
+export declare function compressTranslationPayloads(dir: string, compression: PublicAssetCompression): number;

package/dist/payload-stats.mjs

@@ -1,19 +1,54 @@
-import { existsSync as r, readdirSync as s, statSync as c } from "node:fs";
-import { join as a } from "node:path";
-function i(n, t) {
-  for (const o of s(n, { withFileTypes: !0 })) {
-    const e = a(n, o.name);
-    if (o.isDirectory()) {
-      i(e, t);
-      continue;
-    }
-    o.name.endsWith(".json") && (t.fileCount += 1, t.totalBytes += c(e).size);
+import { createHash as p } from "node:crypto";
+import { existsSync as c, readFileSync as y, writeFileSync as a, statSync as S, readdirSync as m } from "node:fs";
+import { gzipSync as T, brotliCompressSync as d, constants as u } from "node:zlib";
+import { join as h, relative as _ } from "node:path";
+function f(n, t) {
+  for (const e of m(n, { withFileTypes: !0 })) {
+    const o = h(n, e.name);
+    e.isDirectory() ? f(o, t) : e.name.endsWith(".json") && t.push(o);
   }
 }
-function u(n) {
+function A(n) {
   const t = { fileCount: 0, totalBytes: 0 };
-  return r(n) && i(n, t), t;
+  if (!c(n)) return t;
+  const e = [];
+  f(n, e);
+  for (const o of e)
+    t.fileCount += 1, t.totalBytes += S(o).size;
+  return t;
+}
+function B(n, t) {
+  const e = p("sha256");
+  let o = 0;
+  for (const l of n) {
+    const i = h(l, t);
+    if (!c(i)) continue;
+    const s = [];
+    f(i, s), s.sort();
+    for (const r of s)
+      e.update(_(i, r)), e.update("\0"), e.update(y(r)), o += 1;
+  }
+  return o > 0 ? e.digest("hex").slice(0, 16) : null;
+}
+const g = 1024;
+function b(n, t) {
+  if (!t || !c(n)) return 0;
+  const e = t === !0 || t.gzip !== !1, o = t === !0 || t.brotli !== !1;
+  if (!e && !o) return 0;
+  const l = [];
+  f(n, l);
+  let i = 0;
+  for (const s of l) {
+    const r = y(s);
+    r.length < g || (e && a(`${s}.gz`, T(r, { level: 9 })), o && a(
+      `${s}.br`,
+      d(r, { params: { [u.BROTLI_PARAM_QUALITY]: 11, [u.BROTLI_PARAM_SIZE_HINT]: r.length } })
+    ), i += 1);
+  }
+  return i;
 }
 export {
-  u as scanTranslationPayloadDirectory
+  b as compressTranslationPayloads,
+  B as hashTranslationSources,
+  A as scanTranslationPayloadDirectory
 };

package/dist/payload-url.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function r(a,e){const l=a||"index";return e?.[l]??l}function o(a,e,l){return`/${a.replace(/^\/+|\/+$/g,"")}/${e}/${l}/data.json`.replace(/\/{2,}/g,"/")}function n(a){return(a.isServer?a.apiBaseServerHost:a.apiBaseClientHost)??a.baseURL}function t(a){const e=r(a.routeName,a.routesLocaleLinks);return{path:o(a.apiBaseUrl,e,a.locale),baseURL:n(a),params:a.dateBuild?{v:a.dateBuild}:void 0}}exports.buildTranslationPayloadFetchRequest=t;exports.buildTranslationPayloadPath=o;exports.resolveTranslationPayloadBaseURL=n;exports.resolveTranslationPayloadPage=r;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function r(a,e){const l=a||"index";return e?.[l]??l}function t(a,e,l){return`/${a.replace(/^\/+|\/+$/g,"")}/${e}/${l}/data.json`.replace(/\/{2,}/g,"/")}function n(a){return(a.isServer?a.apiBaseServerHost:a.apiBaseClientHost)??a.baseURL}function o(a){const e=r(a.routeName,a.routesLocaleLinks);return{path:t(a.apiBaseUrl,e,a.locale),baseURL:n(a),params:a.dateBuild?{v:a.dateBuild}:void 0}}function s(a,e=!0){const l=Math.floor(a??0);return!Number.isSafeInteger(l)||l<=0?null:e?`public, max-age=${l}, immutable`:"public, max-age=0, must-revalidate"}exports.buildTranslationPayloadCacheControl=s;exports.buildTranslationPayloadFetchRequest=o;exports.buildTranslationPayloadPath=t;exports.resolveTranslationPayloadBaseURL=n;exports.resolveTranslationPayloadPage=r;

package/dist/payload-url.d.cts

@@ -22,3 +22,15 @@ export declare function buildTranslationPayloadFetchRequest(input: TranslationPa
     baseURL: string;
     params?: Record<string, string | number>;
 };
+/**
+ * Builds `Cache-Control` for `/{apiBaseUrl}/:page/:locale/data.json`.
+ *
+ * `immutable` is only emitted when a cache-buster is active (`hasCacheBuster`),
+ * i.e. requests carry `?v=<dateBuild>`. Without a cache-buster (`dateBuild` set
+ * to `0`/`''`) the URL is stable across deploys, so we intentionally avoid
+ * long-lived caching by returning a conservative `max-age=0` policy.
+ *
+ * Returns `null` when caching should be skipped — non-positive or non-finite
+ * `duration` (guards `NaN`/`Infinity` from producing a malformed header).
+ */
+export declare function buildTranslationPayloadCacheControl(durationSeconds: number | undefined, hasCacheBuster?: boolean): string | null;

package/dist/payload-url.d.ts

@@ -22,3 +22,15 @@ export declare function buildTranslationPayloadFetchRequest(input: TranslationPa
     baseURL: string;
     params?: Record<string, string | number>;
 };
+/**
+ * Builds `Cache-Control` for `/{apiBaseUrl}/:page/:locale/data.json`.
+ *
+ * `immutable` is only emitted when a cache-buster is active (`hasCacheBuster`),
+ * i.e. requests carry `?v=<dateBuild>`. Without a cache-buster (`dateBuild` set
+ * to `0`/`''`) the URL is stable across deploys, so we intentionally avoid
+ * long-lived caching by returning a conservative `max-age=0` policy.
+ *
+ * Returns `null` when caching should be skipped — non-positive or non-finite
+ * `duration` (guards `NaN`/`Infinity` from producing a malformed header).
+ */
+export declare function buildTranslationPayloadCacheControl(durationSeconds: number | undefined, hasCacheBuster?: boolean): string | null;

package/dist/payload-url.mjs

@@ -5,20 +5,25 @@ function l(a, e) {
 function n(a, e, r) {
   return `/${a.replace(/^\/+|\/+$/g, "")}/${e}/${r}/data.json`.replace(/\/{2,}/g, "/");
 }
-function o(a) {
+function t(a) {
   return (a.isServer ? a.apiBaseServerHost : a.apiBaseClientHost) ?? a.baseURL;
 }
-function t(a) {
+function s(a) {
   const e = l(a.routeName, a.routesLocaleLinks);
   return {
     path: n(a.apiBaseUrl, e, a.locale),
-    baseURL: o(a),
+    baseURL: t(a),
     params: a.dateBuild ? { v: a.dateBuild } : void 0
   };
 }
+function i(a, e = !0) {
+  const r = Math.floor(a ?? 0);
+  return !Number.isSafeInteger(r) || r <= 0 ? null : e ? `public, max-age=${r}, immutable` : "public, max-age=0, must-revalidate";
+}
 export {
-  t as buildTranslationPayloadFetchRequest,
+  i as buildTranslationPayloadCacheControl,
+  s as buildTranslationPayloadFetchRequest,
   n as buildTranslationPayloadPath,
-  o as resolveTranslationPayloadBaseURL,
+  t as resolveTranslationPayloadBaseURL,
   l as resolveTranslationPayloadPage
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@i18n-micro/utils",
-  "version": "1.0.7",
+  "version": "1.0.11",
   "description": "Framework-agnostic utilities for Nuxt I18n Micro (granular subpath imports).",
   "keywords": [
     "i18n",
@@ -353,14 +353,14 @@
   },
   "dependencies": {
     "globby": "^14.1.0",
-    "@i18n-micro/types": "1.2.6"
+    "@i18n-micro/types": "1.2.8"
   },
   "devDependencies": {
     "publint": "^0.3.17",
-    "vite": "^7.3.1",
+    "vite": "^7.3.6",
     "vite-plugin-dts": "^4.5.4",
-    "vitest": "^3.2.4",
-    "@i18n-micro/test-utils": "1.2.2"
+    "vitest": "^4.1.10",
+    "@i18n-micro/test-utils": "1.2.6"
   },
   "engines": {
     "node": ">=18"
@@ -368,7 +368,7 @@
   "scripts": {
     "build": "vite build",
     "check:package": "publint",
-    "test": "jest",
+    "test": "vitest run",
     "test:dist": "vitest run --config vitest.dist.config.ts"
   }
 }