@i18n-micro/utils 1.0.0 → 1.0.2

package/dist/build.cjs

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

package/dist/build.mjs

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

package/dist/merge-source.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("./deep-merge.cjs");function i(e,a,r){const n=new Set(a.map(o=>o.code)),l=a.find(o=>o.code===e);return[r,l?.fallbackLocale,e].filter(o=>!!o&&n.has(o)).filter((o,g,f)=>f.indexOf(o)===g)}function b(e,a,r){let n={};for(const l of e)n=c.deepMergeTranslations(n,a(r(l)));return n}async function t(e,a,r){let n={};for(const l of e){const o=await a(r(l));n=c.deepMergeTranslations(n,o)}return n}function s(e,a){return a?"index":e||"index"}function u(e){return`${e}.json`}function d(e,a){return`pages/${s(e)}/${a}.json`}function m(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),n=await t(r,e.readLocaleFile,u),l=await t(r,e.readLocaleFile,o=>d(a,o));return c.deepMergeTranslations(n,l)}function F(e){return(e??[]).map(a=>typeof a=="string"?{code:a}:{code:a.code,fallbackLocale:a.fallbackLocale})}exports.buildFallbackLocaleChain=i;exports.buildSourcePagePath=d;exports.buildSourceRootPath=u;exports.mergeSourceTranslations=S;exports.mergeTranslationsFromFallbackChain=b;exports.mergeTranslationsFromFallbackChainAsync=t;exports.normalizeConfiguredLocales=F;exports.resolveSourcePageName=s;exports.toSourceStorageKey=m;
+"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;

package/dist/merge-source.mjs

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

package/dist/normalize.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function n(r){return r?typeof r=="object"&&r!==null&&!Array.isArray(r)?r:{}:{}}function o(r){return n(r)}exports.toTranslationRecord=o;exports.toTranslations=n;

package/dist/normalize.d.cts

@@ -0,0 +1,9 @@
+import { Translations } from '@i18n-micro/types';
+/**
+ * Normalize unknown fetch/storage payloads into a plain translation object.
+ */
+export declare function toTranslations(data: unknown): Translations;
+/**
+ * Normalize unknown payloads into a mutable record (source loader).
+ */
+export declare function toTranslationRecord(data: unknown): Record<string, unknown>;

package/dist/normalize.d.ts

@@ -0,0 +1,9 @@
+import { Translations } from '@i18n-micro/types';
+/**
+ * Normalize unknown fetch/storage payloads into a plain translation object.
+ */
+export declare function toTranslations(data: unknown): Translations;
+/**
+ * Normalize unknown payloads into a mutable record (source loader).
+ */
+export declare function toTranslationRecord(data: unknown): Record<string, unknown>;

package/dist/normalize.mjs

@@ -0,0 +1,10 @@
+function n(r) {
+  return r ? typeof r == "object" && r !== null && !Array.isArray(r) ? r : {} : {};
+}
+function o(r) {
+  return n(r);
+}
+export {
+  o as toTranslationRecord,
+  n as toTranslations
+};

package/dist/payload-fetch.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("./payload-url.cjs");function l(e){return e?typeof e=="object"&&e!==null&&!Array.isArray(e)?e:{}:{}}async function n(e,a,t,s){if(!e.apiBaseServerHost)return{};const r=i.buildTranslationPayloadFetchRequest({apiBaseUrl:e.apiBaseUrl??"_locales",routeName:t,locale:a,isServer:!0,baseURL:e.apiBaseServerHost,apiBaseServerHost:e.apiBaseServerHost,dateBuild:e.dateBuild});try{const o=await s(r.path,{baseURL:r.baseURL,params:r.params});return l(o)}catch{return{}}}exports.fetchTranslationPayloadFromHost=n;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("./normalize.cjs"),i=require("./payload-url.cjs");async function n(a,r,t,s){if(!a.apiBaseServerHost)return{};const e=i.buildTranslationPayloadFetchRequest({apiBaseUrl:a.apiBaseUrl??"_locales",routeName:t,locale:r,isServer:!0,baseURL:a.apiBaseServerHost,apiBaseServerHost:a.apiBaseServerHost,dateBuild:a.dateBuild});try{const o=await s(e.path,{baseURL:e.baseURL,params:e.params});return l.toTranslations(o)}catch{return{}}}exports.fetchTranslationPayloadFromHost=n;

package/dist/payload-fetch.mjs

@@ -1,28 +1,26 @@
-import { buildTranslationPayloadFetchRequest as i } from "./payload-url.mjs";
-function n(r) {
-  return r ? typeof r == "object" && r !== null && !Array.isArray(r) ? r : {} : {};
-}
-async function l(r, a, t, s) {
-  if (!r.apiBaseServerHost) return {};
-  const e = i({
-    apiBaseUrl: r.apiBaseUrl ?? "_locales",
+import { toTranslations as i } from "./normalize.mjs";
+import { buildTranslationPayloadFetchRequest as l } from "./payload-url.mjs";
+async function n(a, r, t, s) {
+  if (!a.apiBaseServerHost) return {};
+  const e = l({
+    apiBaseUrl: a.apiBaseUrl ?? "_locales",
     routeName: t,
-    locale: a,
+    locale: r,
     isServer: !0,
-    baseURL: r.apiBaseServerHost,
-    apiBaseServerHost: r.apiBaseServerHost,
-    dateBuild: r.dateBuild
+    baseURL: a.apiBaseServerHost,
+    apiBaseServerHost: a.apiBaseServerHost,
+    dateBuild: a.dateBuild
   });
   try {
     const o = await s(e.path, {
       baseURL: e.baseURL,
       params: e.params
     });
-    return n(o);
+    return i(o);
   } catch {
     return {};
   }
 }
 export {
-  l as fetchTranslationPayloadFromHost
+  n as fetchTranslationPayloadFromHost
 };

package/dist/resolve-og-locale.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function c(n){const t=n.og?.trim();if(t)return t;const e=n.iso?.trim();if(!e)return null;const r=e.indexOf("_");if(r>0){const s=e.slice(0,r),o=e.slice(r+1);if(s.length>=2&&o.length===2)return`${s.toLowerCase()}_${o.toUpperCase()}`}const i=e.indexOf("-");if(i>0){const s=e.slice(0,i),o=e.slice(i+1);if(s.length>=2&&o.length===2&&/^[A-Za-z]{2}$/.test(o))return`${s.toLowerCase()}_${o.toUpperCase()}`}return null}function l(n,t={}){if(c(n)!==null||t.missingWarn===!1||process.env.NODE_ENV==="production")return;const e=t.tag??"og:locale",r=String(n.code??"unknown"),i=n.iso?`, iso: '${n.iso}'`:"";console.warn(`[i18n] Cannot derive ${e} for locale '${r}'${i}. Set locale.og (e.g. 'en_US') or use iso with a 2-letter region (e.g. 'en-US').`)}exports.resolveOgLocale=c;exports.warnUnresolvedOgLocale=l;

package/dist/resolve-og-locale.d.cts

@@ -0,0 +1,17 @@
+import { Locale } from '@i18n-micro/types';
+type OgLocaleInput = Pick<Locale, 'og' | 'iso' | 'code'>;
+export interface WarnUnresolvedOgLocaleOptions {
+    /** When false, suppresses the warning (same flag as missing translation keys). */
+    missingWarn?: boolean;
+    tag?: 'og:locale' | 'og:locale:alternate';
+}
+/**
+ * Resolve Open Graph locale (`language_TERRITORY`, underscore) for `og:locale` meta tags.
+ * Returns null when the value cannot be determined safely — no tag should be emitted.
+ */
+export declare function resolveOgLocale(locale: OgLocaleInput): string | null;
+/**
+ * Log a dev-only hint when `og:locale` / `og:locale:alternate` cannot be derived.
+ */
+export declare function warnUnresolvedOgLocale(locale: OgLocaleInput, options?: WarnUnresolvedOgLocaleOptions): void;
+export {};

package/dist/resolve-og-locale.d.ts

@@ -0,0 +1,17 @@
+import { Locale } from '@i18n-micro/types';
+type OgLocaleInput = Pick<Locale, 'og' | 'iso' | 'code'>;
+export interface WarnUnresolvedOgLocaleOptions {
+    /** When false, suppresses the warning (same flag as missing translation keys). */
+    missingWarn?: boolean;
+    tag?: 'og:locale' | 'og:locale:alternate';
+}
+/**
+ * Resolve Open Graph locale (`language_TERRITORY`, underscore) for `og:locale` meta tags.
+ * Returns null when the value cannot be determined safely — no tag should be emitted.
+ */
+export declare function resolveOgLocale(locale: OgLocaleInput): string | null;
+/**
+ * Log a dev-only hint when `og:locale` / `og:locale:alternate` cannot be derived.
+ */
+export declare function warnUnresolvedOgLocale(locale: OgLocaleInput, options?: WarnUnresolvedOgLocaleOptions): void;
+export {};

package/dist/resolve-og-locale.mjs

@@ -0,0 +1,30 @@
+function c(n) {
+  const t = n.og?.trim();
+  if (t) return t;
+  const e = n.iso?.trim();
+  if (!e) return null;
+  const r = e.indexOf("_");
+  if (r > 0) {
+    const s = e.slice(0, r), o = e.slice(r + 1);
+    if (s.length >= 2 && o.length === 2)
+      return `${s.toLowerCase()}_${o.toUpperCase()}`;
+  }
+  const i = e.indexOf("-");
+  if (i > 0) {
+    const s = e.slice(0, i), o = e.slice(i + 1);
+    if (s.length >= 2 && o.length === 2 && /^[A-Za-z]{2}$/.test(o))
+      return `${s.toLowerCase()}_${o.toUpperCase()}`;
+  }
+  return null;
+}
+function l(n, t = {}) {
+  if (c(n) !== null || t.missingWarn === !1 || process.env.NODE_ENV === "production") return;
+  const e = t.tag ?? "og:locale", r = String(n.code ?? "unknown"), i = n.iso ? `, iso: '${n.iso}'` : "";
+  console.warn(
+    `[i18n] Cannot derive ${e} for locale '${r}'${i}. Set locale.og (e.g. 'en_US') or use iso with a 2-letter region (e.g. 'en-US').`
+  );
+}
+export {
+  c as resolveOgLocale,
+  l as warnUnresolvedOgLocale
+};

package/dist/runtime-config.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function r(l){if(typeof l!="string")return;const t=l.trim();return t.length>0?t:void 0}function L(l){if(Array.isArray(l)){const t=l.map(e=>r(e)).filter(e=>!!e);return t.length>0?t:void 0}if(typeof l=="string"){const t=l.split(",").map(e=>e.trim()).filter(e=>e.length>0);return t.length>0?t:void 0}}function m(){return{defaultLocale:r(process.env.NUXT_I18N_DEFAULT_LOCALE)??r(process.env.NUXT_PUBLIC_I18N_RUNTIME_DEFAULT_LOCALE),fallbackLocale:r(process.env.NUXT_I18N_FALLBACK_LOCALE)??r(process.env.NUXT_PUBLIC_I18N_RUNTIME_FALLBACK_LOCALE),disabledLocales:L(process.env.NUXT_I18N_DISABLED_LOCALES)??L(process.env.NUXT_PUBLIC_I18N_RUNTIME_DISABLED_LOCALES),strategy:r(process.env.NUXT_I18N_STRATEGY)??r(process.env.NUXT_PUBLIC_I18N_RUNTIME_STRATEGY)}}function _(l){const t=l?.i18nRuntime;if(!t||typeof t!="object")return{};const e=t;return{defaultLocale:r(e.defaultLocale),fallbackLocale:r(e.fallbackLocale),disabledLocales:L(e.disabledLocales),strategy:r(e.strategy)}}function g(l){const t=m(),e=_(l);return{defaultLocale:e.defaultLocale??t.defaultLocale,fallbackLocale:e.fallbackLocale??t.fallbackLocale,disabledLocales:e.disabledLocales??t.disabledLocales,strategy:e.strategy??t.strategy}}function v(l,t,e=a=>console.warn(a)){const a=g(t),i=(l.locales??[]).map(o=>({...o}));if(a.strategy&&a.strategy!==l.strategy&&e(`[nuxt-i18n-micro] runtime i18n strategy override is ignored: "${a.strategy}" (build strategy: "${l.strategy}"). Build a separate artifact for each strategy.`),a.disabledLocales&&a.disabledLocales.length>0){const o=new Set(a.disabledLocales);for(const u of i)u.disabled=o.has(u.code)}const n=i.filter(o=>!o.disabled);if(n.length===0)return a.disabledLocales&&a.disabledLocales.length>0&&e("[nuxt-i18n-micro] runtime disabledLocales override would disable all locales; override ignored."),{...l,locales:(l.locales??[]).map(o=>({...o}))};const b=new Set(i.map(o=>o.code));let c=a.defaultLocale??l.defaultLocale,s=a.fallbackLocale??l.fallbackLocale;s&&!b.has(s)&&(e(`[nuxt-i18n-micro] runtime fallbackLocale "${s}" is not defined in locales; override ignored.`),s=l.fallbackLocale);const f=new Set(n.map(o=>o.code)),d=n[0]?.code??l.defaultLocale??"en";return(!c||!f.has(c))&&(a.defaultLocale?e(`[nuxt-i18n-micro] runtime defaultLocale "${a.defaultLocale}" is not enabled; falling back to "${d}".`):c&&!f.has(c)&&e(`[nuxt-i18n-micro] defaultLocale "${c}" is disabled by runtime overrides; falling back to "${d}".`),c=d),{...l,locales:i,defaultLocale:c,fallbackLocale:s}}exports.resolveI18nConfigWithRuntimeOverrides=v;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function o(e){if(typeof e!="string")return;const t=e.trim();return t.length>0?t:void 0}function L(e){if(Array.isArray(e)){const t=e.map(l=>o(l)).filter(l=>!!l);return t.length>0?t:void 0}if(typeof e=="string"){const t=e.split(",").map(l=>l.trim()).filter(l=>l.length>0);return t.length>0?t:void 0}}function m(){return{defaultLocale:o(process.env.NUXT_I18N_DEFAULT_LOCALE)??o(process.env.NUXT_PUBLIC_I18N_RUNTIME_DEFAULT_LOCALE),fallbackLocale:o(process.env.NUXT_I18N_FALLBACK_LOCALE)??o(process.env.NUXT_PUBLIC_I18N_RUNTIME_FALLBACK_LOCALE),disabledLocales:L(process.env.NUXT_I18N_DISABLED_LOCALES)??L(process.env.NUXT_PUBLIC_I18N_RUNTIME_DISABLED_LOCALES),strategy:o(process.env.NUXT_I18N_STRATEGY)??o(process.env.NUXT_PUBLIC_I18N_RUNTIME_STRATEGY)}}function g(e){const t=e?.i18nRuntime;if(!t||typeof t!="object")return{};const l=t;return{defaultLocale:o(l.defaultLocale),fallbackLocale:o(l.fallbackLocale),disabledLocales:L(l.disabledLocales),strategy:o(l.strategy)}}function v(e){return Object.assign({},e)}function b(e){return e.map(t=>v(t))}function y(e){const t=m(),l=g(e);return{defaultLocale:l.defaultLocale??t.defaultLocale,fallbackLocale:l.fallbackLocale??t.fallbackLocale,disabledLocales:l.disabledLocales??t.disabledLocales,strategy:l.strategy??t.strategy}}function p(e,t,l=a=>console.warn(a)){const a=y(t),n=b(e.locales??[]);if(a.strategy&&a.strategy!==e.strategy&&l(`[nuxt-i18n-micro] runtime i18n strategy override is ignored: "${a.strategy}" (build strategy: "${e.strategy}"). Build a separate artifact for each strategy.`),a.disabledLocales&&a.disabledLocales.length>0){const r=new Set(a.disabledLocales);for(const u of n)u.disabled=r.has(u.code)}const i=n.filter(r=>!r.disabled);if(i.length===0)return a.disabledLocales&&a.disabledLocales.length>0&&l("[nuxt-i18n-micro] runtime disabledLocales override would disable all locales; override ignored."),{...e,locales:b(e.locales??[])};const _=new Set(n.map(r=>r.code));let c=a.defaultLocale??e.defaultLocale,s=a.fallbackLocale??e.fallbackLocale;s&&!_.has(s)&&(l(`[nuxt-i18n-micro] runtime fallbackLocale "${s}" is not defined in locales; override ignored.`),s=e.fallbackLocale);const f=new Set(i.map(r=>r.code)),d=i[0]?.code??e.defaultLocale??"en";return(!c||!f.has(c))&&(a.defaultLocale?l(`[nuxt-i18n-micro] runtime defaultLocale "${a.defaultLocale}" is not enabled; falling back to "${d}".`):c&&!f.has(c)&&l(`[nuxt-i18n-micro] defaultLocale "${c}" is disabled by runtime overrides; falling back to "${d}".`),c=d),{...e,locales:n,defaultLocale:c,fallbackLocale:s}}exports.resolveI18nConfigWithRuntimeOverrides=p;

package/dist/runtime-config.mjs

@@ -1,69 +1,75 @@
-function c(l) {
-  if (typeof l != "string") return;
-  const a = l.trim();
+function o(e) {
+  if (typeof e != "string") return;
+  const a = e.trim();
   return a.length > 0 ? a : void 0;
 }
-function L(l) {
-  if (Array.isArray(l)) {
-    const a = l.map((e) => c(e)).filter((e) => !!e);
+function L(e) {
+  if (Array.isArray(e)) {
+    const a = e.map((l) => o(l)).filter((l) => !!l);
     return a.length > 0 ? a : void 0;
   }
-  if (typeof l == "string") {
-    const a = l.split(",").map((e) => e.trim()).filter((e) => e.length > 0);
+  if (typeof e == "string") {
+    const a = e.split(",").map((l) => l.trim()).filter((l) => l.length > 0);
     return a.length > 0 ? a : void 0;
   }
 }
-function b() {
+function m() {
   return {
-    defaultLocale: c(process.env.NUXT_I18N_DEFAULT_LOCALE) ?? c(process.env.NUXT_PUBLIC_I18N_RUNTIME_DEFAULT_LOCALE),
-    fallbackLocale: c(process.env.NUXT_I18N_FALLBACK_LOCALE) ?? c(process.env.NUXT_PUBLIC_I18N_RUNTIME_FALLBACK_LOCALE),
+    defaultLocale: o(process.env.NUXT_I18N_DEFAULT_LOCALE) ?? o(process.env.NUXT_PUBLIC_I18N_RUNTIME_DEFAULT_LOCALE),
+    fallbackLocale: o(process.env.NUXT_I18N_FALLBACK_LOCALE) ?? o(process.env.NUXT_PUBLIC_I18N_RUNTIME_FALLBACK_LOCALE),
     disabledLocales: L(process.env.NUXT_I18N_DISABLED_LOCALES) ?? L(process.env.NUXT_PUBLIC_I18N_RUNTIME_DISABLED_LOCALES),
-    strategy: c(process.env.NUXT_I18N_STRATEGY) ?? c(process.env.NUXT_PUBLIC_I18N_RUNTIME_STRATEGY)
+    strategy: o(process.env.NUXT_I18N_STRATEGY) ?? o(process.env.NUXT_PUBLIC_I18N_RUNTIME_STRATEGY)
   };
 }
-function m(l) {
-  const a = l?.i18nRuntime;
+function g(e) {
+  const a = e?.i18nRuntime;
   if (!a || typeof a != "object") return {};
-  const e = a;
+  const l = a;
   return {
-    defaultLocale: c(e.defaultLocale),
-    fallbackLocale: c(e.fallbackLocale),
-    disabledLocales: L(e.disabledLocales),
-    strategy: c(e.strategy)
+    defaultLocale: o(l.defaultLocale),
+    fallbackLocale: o(l.fallbackLocale),
+    disabledLocales: L(l.disabledLocales),
+    strategy: o(l.strategy)
   };
 }
-function g(l) {
-  const a = b(), e = m(l);
+function v(e) {
+  return Object.assign({}, e);
+}
+function _(e) {
+  return e.map((a) => v(a));
+}
+function p(e) {
+  const a = m(), l = g(e);
   return {
-    defaultLocale: e.defaultLocale ?? a.defaultLocale,
-    fallbackLocale: e.fallbackLocale ?? a.fallbackLocale,
-    disabledLocales: e.disabledLocales ?? a.disabledLocales,
-    strategy: e.strategy ?? a.strategy
+    defaultLocale: l.defaultLocale ?? a.defaultLocale,
+    fallbackLocale: l.fallbackLocale ?? a.fallbackLocale,
+    disabledLocales: l.disabledLocales ?? a.disabledLocales,
+    strategy: l.strategy ?? a.strategy
   };
 }
-function p(l, a, e = (t) => console.warn(t)) {
-  const t = g(a), i = (l.locales ?? []).map((o) => ({ ...o }));
-  if (t.strategy && t.strategy !== l.strategy && e(
-    `[nuxt-i18n-micro] runtime i18n strategy override is ignored: "${t.strategy}" (build strategy: "${l.strategy}"). Build a separate artifact for each strategy.`
+function y(e, a, l = (t) => console.warn(t)) {
+  const t = p(a), n = _(e.locales ?? []);
+  if (t.strategy && t.strategy !== e.strategy && l(
+    `[nuxt-i18n-micro] runtime i18n strategy override is ignored: "${t.strategy}" (build strategy: "${e.strategy}"). Build a separate artifact for each strategy.`
   ), t.disabledLocales && t.disabledLocales.length > 0) {
-    const o = new Set(t.disabledLocales);
-    for (const u of i)
-      u.disabled = o.has(u.code);
+    const r = new Set(t.disabledLocales);
+    for (const u of n)
+      u.disabled = r.has(u.code);
   }
-  const n = i.filter((o) => !o.disabled);
-  if (n.length === 0)
-    return t.disabledLocales && t.disabledLocales.length > 0 && e("[nuxt-i18n-micro] runtime disabledLocales override would disable all locales; override ignored."), { ...l, locales: (l.locales ?? []).map((o) => ({ ...o })) };
-  const _ = new Set(i.map((o) => o.code));
-  let s = t.defaultLocale ?? l.defaultLocale, r = t.fallbackLocale ?? l.fallbackLocale;
-  r && !_.has(r) && (e(`[nuxt-i18n-micro] runtime fallbackLocale "${r}" is not defined in locales; override ignored.`), r = l.fallbackLocale);
-  const f = new Set(n.map((o) => o.code)), d = n[0]?.code ?? l.defaultLocale ?? "en";
-  return (!s || !f.has(s)) && (t.defaultLocale ? e(`[nuxt-i18n-micro] runtime defaultLocale "${t.defaultLocale}" is not enabled; falling back to "${d}".`) : s && !f.has(s) && e(`[nuxt-i18n-micro] defaultLocale "${s}" is disabled by runtime overrides; falling back to "${d}".`), s = d), {
-    ...l,
-    locales: i,
-    defaultLocale: s,
-    fallbackLocale: r
+  const i = n.filter((r) => !r.disabled);
+  if (i.length === 0)
+    return t.disabledLocales && t.disabledLocales.length > 0 && l("[nuxt-i18n-micro] runtime disabledLocales override would disable all locales; override ignored."), { ...e, locales: _(e.locales ?? []) };
+  const b = new Set(n.map((r) => r.code));
+  let c = t.defaultLocale ?? e.defaultLocale, s = t.fallbackLocale ?? e.fallbackLocale;
+  s && !b.has(s) && (l(`[nuxt-i18n-micro] runtime fallbackLocale "${s}" is not defined in locales; override ignored.`), s = e.fallbackLocale);
+  const f = new Set(i.map((r) => r.code)), d = i[0]?.code ?? e.defaultLocale ?? "en";
+  return (!c || !f.has(c)) && (t.defaultLocale ? l(`[nuxt-i18n-micro] runtime defaultLocale "${t.defaultLocale}" is not enabled; falling back to "${d}".`) : c && !f.has(c) && l(`[nuxt-i18n-micro] defaultLocale "${c}" is disabled by runtime overrides; falling back to "${d}".`), c = d), {
+    ...e,
+    locales: n,
+    defaultLocale: c,
+    fallbackLocale: s
   };
 }
 export {
-  p as resolveI18nConfigWithRuntimeOverrides
+  y as resolveI18nConfigWithRuntimeOverrides
 };

package/dist/source-loader.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./merge-source.cjs");function u(r){return r?typeof r=="object"&&r!==null&&!Array.isArray(r)?r:{}:{}}async function a(r,o){return e.mergeSourceTranslations({...o,readLocaleFile:async t=>{const n=await r.getItem(e.toSourceStorageKey(t));return u(n)}})}exports.loadSourceTranslationsFromStorage=a;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./merge-source.cjs"),n=require("./normalize.cjs");async function c(r,o){return e.mergeSourceTranslations({...o,readLocaleFile:async t=>{const a=await r.getItem(e.toSourceStorageKey(t));return n.toTranslationRecord(a)}})}exports.loadSourceTranslationsFromStorage=c;

package/dist/source-loader.mjs

@@ -1,16 +1,14 @@
-import { mergeSourceTranslations as t, toSourceStorageKey as i } from "./merge-source.mjs";
-function u(r) {
-  return r ? typeof r == "object" && r !== null && !Array.isArray(r) ? r : {} : {};
-}
-async function c(r, e) {
-  return t({
-    ...e,
-    readLocaleFile: async (o) => {
-      const n = await r.getItem(i(o));
-      return u(n);
+import { mergeSourceTranslations as a, toSourceStorageKey as n } from "./merge-source.mjs";
+import { toTranslationRecord as c } from "./normalize.mjs";
+async function l(o, r) {
+  return a({
+    ...r,
+    readLocaleFile: async (e) => {
+      const t = await o.getItem(n(e));
+      return c(t);
     }
   });
 }
 export {
-  c as loadSourceTranslationsFromStorage
+  l as loadSourceTranslationsFromStorage
 };

package/package.json

@@ -1,27 +1,34 @@
 {
   "name": "@i18n-micro/utils",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Framework-agnostic utilities for Nuxt I18n Micro (granular subpath imports).",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/s00d/nuxt-i18n-micro.git",
-    "directory": "packages/utils"
+  "keywords": [
+    "i18n",
+    "locale",
+    "translations",
+    "utils"
+  ],
+  "homepage": "https://github.com/s00d/nuxt-i18n-micro/tree/main/packages/utils#readme",
+  "bugs": {
+    "url": "https://github.com/s00d/nuxt-i18n-micro/issues"
   },
   "license": "MIT",
-  "type": "module",
-  "sideEffects": false,
   "author": {
     "name": "s00d",
     "email": "Virus191288@gmail.com",
     "url": "https://s00d.github.io/"
   },
-  "homepage": "https://github.com/s00d/nuxt-i18n-micro/tree/main/packages/utils#readme",
-  "bugs": {
-    "url": "https://github.com/s00d/nuxt-i18n-micro/issues"
-  },
-  "engines": {
-    "node": ">=18"
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/s00d/nuxt-i18n-micro.git",
+    "directory": "packages/utils"
   },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
+  "sideEffects": false,
   "exports": {
     "./deep-merge": {
       "import": {
@@ -122,6 +129,17 @@
       },
       "default": "./dist/resolve-locale.mjs"
     },
+    "./resolve-og-locale": {
+      "import": {
+        "types": "./dist/resolve-og-locale.d.ts",
+        "default": "./dist/resolve-og-locale.mjs"
+      },
+      "require": {
+        "types": "./dist/resolve-og-locale.d.cts",
+        "default": "./dist/resolve-og-locale.cjs"
+      },
+      "default": "./dist/resolve-og-locale.mjs"
+    },
     "./active-locales": {
       "import": {
         "types": "./dist/active-locales.d.ts",
@@ -199,6 +217,17 @@
       },
       "default": "./dist/runtime-config.mjs"
     },
+    "./normalize": {
+      "import": {
+        "types": "./dist/normalize.d.ts",
+        "default": "./dist/normalize.mjs"
+      },
+      "require": {
+        "types": "./dist/normalize.d.cts",
+        "default": "./dist/normalize.cjs"
+      },
+      "default": "./dist/normalize.mjs"
+    },
     "./build": {
       "import": {
         "types": "./dist/build.d.ts",
@@ -216,26 +245,19 @@
   "publishConfig": {
     "access": "public"
   },
-  "keywords": [
-    "i18n",
-    "translations",
-    "utils",
-    "locale"
-  ],
-  "files": [
-    "dist",
-    "README.md"
-  ],
   "dependencies": {
     "globby": "^14.1.0",
-    "@i18n-micro/types": "1.2.3"
+    "@i18n-micro/types": "1.2.5"
   },
   "devDependencies": {
     "publint": "^0.3.17",
     "vite": "^7.3.1",
     "vite-plugin-dts": "^4.5.4",
     "vitest": "^3.2.4",
-    "@i18n-micro/test-utils": "1.2.1"
+    "@i18n-micro/test-utils": "1.2.2"
+  },
+  "engines": {
+    "node": ">=18"
   },
   "scripts": {
     "build": "vite build",