@i18n-micro/utils 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+ 
+ Copyright (c) 2016 
+ 
+ Permission is hereby granted, free of charge, to any person obtaining a copy
+ of this software and associated documentation files (the "Software"), to deal
+ in the Software without restriction, including without limitation the rights
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ copies of the Software, and to permit persons to whom the Software is
+ furnished to do so, subject to the following conditions:
+ 
+ The above copyright notice and this permission notice shall be included in all
+ copies or substantial portions of the Software.
+ 
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ SOFTWARE.

package/README.md

@@ -0,0 +1,14 @@
+# @i18n-micro/utils
+
+Framework-agnostic utilities for Nuxt I18n Micro. Import only what you need:
+
+```ts
+import { deepMergeTranslations } from '@i18n-micro/utils/deep-merge'
+import { mergeSourceTranslations } from '@i18n-micro/utils/merge-source'
+import { findAllowedLocalesForRoute } from '@i18n-micro/utils/route'
+import { extractBaseRoutePattern } from '@i18n-micro/utils/route-pattern'
+import { resolveI18nConfigWithRuntimeOverrides } from '@i18n-micro/utils/runtime-config'
+import { preMergeLocales } from '@i18n-micro/utils/build'
+```
+
+No Vue, Nuxt, or Nitro dependencies. `sideEffects: false` for tree-shaking friendly bundlers.

package/dist/accept-language.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function c(e){return e?e.split(",").map(t=>{const[n]=t.split(";");return(n??"").trim()}).filter(t=>t.length>0):[]}function g(e,t){const n=c(e);for(const r of n){const a=r.toLowerCase(),s=a.split("-")[0],o=t.find(u=>u.toLowerCase()===a||u.toLowerCase()===s);if(o)return o}return null}function i(e,t,n,r,a){return!n||t?e:g(r,a)??e}exports.applyAutoDetectLanguage=i;exports.detectLocaleFromAcceptLanguage=g;exports.parseAcceptLanguage=c;

package/dist/accept-language.d.cts

@@ -0,0 +1,3 @@
+export declare function parseAcceptLanguage(header: string | undefined): string[];
+export declare function detectLocaleFromAcceptLanguage(header: string | undefined, validLocales: string[]): string | null;
+export declare function applyAutoDetectLanguage(locale: string, hasExplicitPreference: boolean, autoDetectLanguage: boolean | undefined, acceptLanguageHeader: string | undefined, validLocales: string[]): string;

package/dist/accept-language.d.ts

@@ -0,0 +1,3 @@
+export declare function parseAcceptLanguage(header: string | undefined): string[];
+export declare function detectLocaleFromAcceptLanguage(header: string | undefined, validLocales: string[]): string | null;
+export declare function applyAutoDetectLanguage(locale: string, hasExplicitPreference: boolean, autoDetectLanguage: boolean | undefined, acceptLanguageHeader: string | undefined, validLocales: string[]): string;

package/dist/accept-language.mjs

@@ -0,0 +1,22 @@
+function s(t) {
+  return t ? t.split(",").map((n) => {
+    const [e] = n.split(";");
+    return (e ?? "").trim();
+  }).filter((n) => n.length > 0) : [];
+}
+function g(t, n) {
+  const e = s(t);
+  for (const o of e) {
+    const r = o.toLowerCase(), c = r.split("-")[0], a = n.find((u) => u.toLowerCase() === r || u.toLowerCase() === c);
+    if (a) return a;
+  }
+  return null;
+}
+function i(t, n, e, o, r) {
+  return !e || n ? t : g(o, r) ?? t;
+}
+export {
+  i as applyAutoDetectLanguage,
+  g as detectLocaleFromAcceptLanguage,
+  s as parseAcceptLanguage
+};

package/dist/active-locales.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function l(e){return(e??[]).filter(o=>!o.disabled)}function t(e){return l(e).map(o=>o.code)}function a(e,o){return l(e).some(n=>n.code===o)}exports.getEnabledLocaleCodes=t;exports.getEnabledLocales=l;exports.isEnabledLocale=a;

package/dist/active-locales.d.cts

@@ -0,0 +1,4 @@
+import { Locale } from '@i18n-micro/types';
+export declare function getEnabledLocales(locales?: Locale[] | null): Locale[];
+export declare function getEnabledLocaleCodes(locales?: Locale[] | null): string[];
+export declare function isEnabledLocale(locales: Locale[] | null | undefined, code: string): boolean;

package/dist/active-locales.d.ts

@@ -0,0 +1,4 @@
+import { Locale } from '@i18n-micro/types';
+export declare function getEnabledLocales(locales?: Locale[] | null): Locale[];
+export declare function getEnabledLocaleCodes(locales?: Locale[] | null): string[];
+export declare function isEnabledLocale(locales: Locale[] | null | undefined, code: string): boolean;

package/dist/active-locales.mjs

@@ -0,0 +1,14 @@
+function o(e) {
+  return (e ?? []).filter((n) => !n.disabled);
+}
+function a(e) {
+  return o(e).map((n) => n.code);
+}
+function c(e, n) {
+  return o(e).some((t) => t.code === n);
+}
+export {
+  a as getEnabledLocaleCodes,
+  o as getEnabledLocales,
+  c as isEnabledLocale
+};

package/dist/build.cjs

@@ -0,0 +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;

package/dist/build.d.cts

@@ -0,0 +1,14 @@
+export interface PreMergeLocaleInfo {
+    code: string;
+    fallbackLocale?: string;
+}
+/**
+ * Pre-merge all translation files at build time.
+ *
+ * Output: flat directory with structure pages/{routeName}/{locale}.json
+ */
+export declare function preMergeLocales(rootDirs: string[], translationDirName: string, outputDir: string, locales: PreMergeLocaleInfo[], globalFallbackLocale?: string, disablePageLocales?: boolean): Promise<void>;
+/**
+ * Merge translation layers at build time but keep the source directory shape.
+ */
+export declare function buildTranslationSourceLayers(rootDirs: string[], translationDirName: string, outputDir: string): Promise<void>;

package/dist/build.d.ts

@@ -0,0 +1,14 @@
+export interface PreMergeLocaleInfo {
+    code: string;
+    fallbackLocale?: string;
+}
+/**
+ * Pre-merge all translation files at build time.
+ *
+ * Output: flat directory with structure pages/{routeName}/{locale}.json
+ */
+export declare function preMergeLocales(rootDirs: string[], translationDirName: string, outputDir: string, locales: PreMergeLocaleInfo[], globalFallbackLocale?: string, disablePageLocales?: boolean): Promise<void>;
+/**
+ * Merge translation layers at build time but keep the source directory shape.
+ */
+export declare function buildTranslationSourceLayers(rootDirs: string[], translationDirName: string, outputDir: string): Promise<void>;

package/dist/build.mjs

@@ -0,0 +1,86 @@
+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) {
+    let o = {};
+    for (const t of f) {
+      const n = p(t, e);
+      if (d(n))
+        try {
+          o = v(o, JSON.parse(O(n, "utf-8")));
+        } catch {
+        }
+    }
+    h.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 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);
+      if (t.length <= 1) continue;
+      let n = {};
+      for (const a of t) {
+        const m = e.get(a);
+        m && (n = v(n, m));
+      }
+      e.set(o.code, n);
+    }
+  };
+  x(i);
+  for (const e of r.values())
+    x(e);
+  if (s || r.size === 0) {
+    const e = /* @__PURE__ */ new Map();
+    for (const [o, t] of i)
+      e.set(o, { ...t });
+    r.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, 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));
+    }
+}
+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))
+        try {
+          f = v(f, JSON.parse(O(i, "utf-8")));
+        } catch {
+        }
+    }
+    const l = p(c, s);
+    u(S(l), { recursive: !0 }), b(l, JSON.stringify(f));
+  }
+}
+export {
+  C as buildTranslationSourceLayers,
+  z as preMergeLocales
+};

package/dist/cache-control.cjs

@@ -0,0 +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;

package/dist/cache-control.d.cts

@@ -0,0 +1,33 @@
+/**
+ * CacheControl — O(1) LRU cache with optional sliding TTL.
+ *
+ * Map is created internally — no external references, no desync risk.
+ *
+ * Performance:
+ *   get  — O(1) (lazy TTL check + LRU reorder via Map delete/set)
+ *   set  — O(1) (LRU eviction via Map.keys().next())
+ *   has  — O(1) (lazy TTL eviction)
+ *
+ * Eviction: LRU (Least Recently Used) based on native Map insertion order.
+ */
+export interface CacheControlOptions {
+    maxSize?: number;
+    /** TTL in seconds (0 = no expiration) */
+    ttl?: number;
+}
+export declare class CacheControl<T> {
+    private readonly cache;
+    private readonly expiry;
+    private maxSize;
+    private ttlMs;
+    constructor(options?: CacheControlOptions);
+    /** Update limits at runtime. Last call wins. */
+    configure(options: CacheControlOptions): void;
+    get(key: string): T | undefined;
+    has(key: string): boolean;
+    set(key: string, value: T): void;
+    delete(key: string): boolean;
+    clear(): void;
+    keys(): IterableIterator<string>;
+    get size(): number;
+}

package/dist/cache-control.d.ts

@@ -0,0 +1,33 @@
+/**
+ * CacheControl — O(1) LRU cache with optional sliding TTL.
+ *
+ * Map is created internally — no external references, no desync risk.
+ *
+ * Performance:
+ *   get  — O(1) (lazy TTL check + LRU reorder via Map delete/set)
+ *   set  — O(1) (LRU eviction via Map.keys().next())
+ *   has  — O(1) (lazy TTL eviction)
+ *
+ * Eviction: LRU (Least Recently Used) based on native Map insertion order.
+ */
+export interface CacheControlOptions {
+    maxSize?: number;
+    /** TTL in seconds (0 = no expiration) */
+    ttl?: number;
+}
+export declare class CacheControl<T> {
+    private readonly cache;
+    private readonly expiry;
+    private maxSize;
+    private ttlMs;
+    constructor(options?: CacheControlOptions);
+    /** Update limits at runtime. Last call wins. */
+    configure(options: CacheControlOptions): void;
+    get(key: string): T | undefined;
+    has(key: string): boolean;
+    set(key: string, value: T): void;
+    delete(key: string): boolean;
+    clear(): void;
+    keys(): IterableIterator<string>;
+    get size(): number;
+}

package/dist/cache-control.mjs

@@ -0,0 +1,56 @@
+class h {
+  constructor(t) {
+    this.cache = /* @__PURE__ */ new Map(), this.expiry = /* @__PURE__ */ new Map(), this.maxSize = 0, this.ttlMs = 0, t && this.configure(t);
+  }
+  /** Update limits at runtime. Last call wins. */
+  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;
+  }
+}
+export {
+  h as CacheControl
+};

package/dist/cookie.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t="user-locale",a="hash-locale",o=3600*24*365;function l(e){return e.localeCookie===null?null:e.localeCookie||t}function n(e){return e.hashMode?a:null}function i(){const e=new Date;return e.setTime(e.getTime()+o*1e3),{expires:e,maxAge:o,path:"/",watch:!0,sameSite:"lax"}}exports.DEFAULT_COOKIE_MAX_AGE=o;exports.DEFAULT_COOKIE_NAME=t;exports.DEFAULT_HASH_COOKIE_NAME=a;exports.getHashCookieName=n;exports.getLocaleCookieName=l;exports.getLocaleCookieOptions=i;

package/dist/cookie.d.cts

@@ -0,0 +1,24 @@
+import { ModuleOptionsExtend } from '@i18n-micro/types';
+export declare const DEFAULT_COOKIE_NAME = "user-locale";
+export declare const DEFAULT_HASH_COOKIE_NAME = "hash-locale";
+export declare const DEFAULT_COOKIE_MAX_AGE: number;
+/**
+ * Returns cookie name from config.
+ * If localeCookie === null, returns null (cookies disabled).
+ */
+export declare function getLocaleCookieName(config: ModuleOptionsExtend): string | null;
+/**
+ * Returns hash cookie name when hashMode is enabled.
+ * Returns null when hashMode is false.
+ */
+export declare function getHashCookieName(config: ModuleOptionsExtend): string | null;
+/**
+ * Returns standard options for locale/hash cookies.
+ */
+export declare function getLocaleCookieOptions(): {
+    expires: Date;
+    maxAge: number;
+    path: string;
+    watch: boolean;
+    sameSite: "lax";
+};

package/dist/cookie.d.ts

@@ -0,0 +1,24 @@
+import { ModuleOptionsExtend } from '@i18n-micro/types';
+export declare const DEFAULT_COOKIE_NAME = "user-locale";
+export declare const DEFAULT_HASH_COOKIE_NAME = "hash-locale";
+export declare const DEFAULT_COOKIE_MAX_AGE: number;
+/**
+ * Returns cookie name from config.
+ * If localeCookie === null, returns null (cookies disabled).
+ */
+export declare function getLocaleCookieName(config: ModuleOptionsExtend): string | null;
+/**
+ * Returns hash cookie name when hashMode is enabled.
+ * Returns null when hashMode is false.
+ */
+export declare function getHashCookieName(config: ModuleOptionsExtend): string | null;
+/**
+ * Returns standard options for locale/hash cookies.
+ */
+export declare function getLocaleCookieOptions(): {
+    expires: Date;
+    maxAge: number;
+    path: string;
+    watch: boolean;
+    sameSite: "lax";
+};

package/dist/cookie.mjs

@@ -0,0 +1,25 @@
+const o = "user-locale", t = "hash-locale", n = 31536e3;
+function a(e) {
+  return e.localeCookie === null ? null : e.localeCookie || o;
+}
+function l(e) {
+  return e.hashMode ? t : null;
+}
+function A() {
+  const e = /* @__PURE__ */ new Date();
+  return e.setTime(e.getTime() + 31536e3 * 1e3), {
+    expires: e,
+    maxAge: 31536e3,
+    path: "/",
+    watch: !0,
+    sameSite: "lax"
+  };
+}
+export {
+  n as DEFAULT_COOKIE_MAX_AGE,
+  o as DEFAULT_COOKIE_NAME,
+  t as DEFAULT_HASH_COOKIE_NAME,
+  l as getHashCookieName,
+  a as getLocaleCookieName,
+  A as getLocaleCookieOptions
+};

package/dist/deep-merge.cjs

@@ -0,0 +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;

package/dist/deep-merge.d.cts

@@ -0,0 +1,17 @@
+/**
+ * Optimized deep merge for translation objects (2-level depth).
+ *
+ * Regular shallow spread `{ ...old, ...new }` overwrites nested objects entirely:
+ *   { common: { fromA: "A" } } + { common: { fromB: "B" } } => { common: { fromB: "B" } }
+ *
+ * This function preserves sibling keys inside nested objects:
+ *   { common: { fromA: "A" } } + { common: { fromB: "B" } } => { common: { fromA: "A", fromB: "B" } }
+ *
+ * Performance: only iterates top-level keys of `source`; inner merge is a single spread.
+ *
+ * Limitation: only merges 2 levels deep. At level 3+, source overwrites target.
+ * For 99% of i18n files (Section → Key → Value), this is sufficient.
+ */
+export declare function deepMergeTranslations(target: Record<string, unknown>, source: Record<string, unknown>): Record<string, unknown>;
+/** Recursive deep merge for build-time layer merging. */
+export declare function deepMergeTranslationsRecursive(target: Record<string, unknown>, source: Record<string, unknown>): Record<string, unknown>;

package/dist/deep-merge.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Optimized deep merge for translation objects (2-level depth).
+ *
+ * Regular shallow spread `{ ...old, ...new }` overwrites nested objects entirely:
+ *   { common: { fromA: "A" } } + { common: { fromB: "B" } } => { common: { fromB: "B" } }
+ *
+ * This function preserves sibling keys inside nested objects:
+ *   { common: { fromA: "A" } } + { common: { fromB: "B" } } => { common: { fromA: "A", fromB: "B" } }
+ *
+ * Performance: only iterates top-level keys of `source`; inner merge is a single spread.
+ *
+ * Limitation: only merges 2 levels deep. At level 3+, source overwrites target.
+ * For 99% of i18n files (Section → Key → Value), this is sufficient.
+ */
+export declare function deepMergeTranslations(target: Record<string, unknown>, source: Record<string, unknown>): Record<string, unknown>;
+/** Recursive deep merge for build-time layer merging. */
+export declare function deepMergeTranslationsRecursive(target: Record<string, unknown>, source: Record<string, unknown>): Record<string, unknown>;

package/dist/deep-merge.mjs

@@ -0,0 +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;
+  }
+  return o;
+}
+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;
+  }
+  return o;
+}
+export {
+  i as deepMergeTranslations,
+  c as deepMergeTranslationsRecursive
+};

package/dist/merge-source.cjs

@@ -0,0 +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;

package/dist/merge-source.d.cts

@@ -0,0 +1,22 @@
+import { Locale } from '@i18n-micro/types';
+export interface SourceLocaleInfo {
+    code: string;
+    fallbackLocale?: string;
+}
+export interface MergeSourceTranslationsInput {
+    locale: string;
+    pageName: string;
+    locales: SourceLocaleInfo[];
+    globalFallbackLocale?: string;
+    disablePageLocales?: boolean;
+    readLocaleFile: (relativePath: string) => Record<string, unknown> | Promise<Record<string, unknown>>;
+}
+export declare function buildFallbackLocaleChain(locale: string, locales: SourceLocaleInfo[], globalFallbackLocale?: string): string[];
+export declare function mergeTranslationsFromFallbackChain(chain: string[], readLocaleFile: (relativePath: string) => Record<string, unknown>, relativePathForLocale: (localeCode: string) => string): Record<string, unknown>;
+export declare function mergeTranslationsFromFallbackChainAsync(chain: string[], readLocaleFile: (relativePath: string) => Record<string, unknown> | Promise<Record<string, unknown>>, relativePathForLocale: (localeCode: string) => string): Promise<Record<string, unknown>>;
+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;
+export declare function toSourceStorageKey(relativePath: 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

@@ -0,0 +1,22 @@
+import { Locale } from '@i18n-micro/types';
+export interface SourceLocaleInfo {
+    code: string;
+    fallbackLocale?: string;
+}
+export interface MergeSourceTranslationsInput {
+    locale: string;
+    pageName: string;
+    locales: SourceLocaleInfo[];
+    globalFallbackLocale?: string;
+    disablePageLocales?: boolean;
+    readLocaleFile: (relativePath: string) => Record<string, unknown> | Promise<Record<string, unknown>>;
+}
+export declare function buildFallbackLocaleChain(locale: string, locales: SourceLocaleInfo[], globalFallbackLocale?: string): string[];
+export declare function mergeTranslationsFromFallbackChain(chain: string[], readLocaleFile: (relativePath: string) => Record<string, unknown>, relativePathForLocale: (localeCode: string) => string): Record<string, unknown>;
+export declare function mergeTranslationsFromFallbackChainAsync(chain: string[], readLocaleFile: (relativePath: string) => Record<string, unknown> | Promise<Record<string, unknown>>, relativePathForLocale: (localeCode: string) => string): Promise<Record<string, unknown>>;
+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;
+export declare function toSourceStorageKey(relativePath: 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

@@ -0,0 +1,51 @@
+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 b(e, a, r) {
+  let n = {};
+  for (const c of e)
+    n = t(n, a(r(c)));
+  return n;
+}
+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;
+}
+function s(e, a) {
+  return a ? "index" : e || "index";
+}
+function d(e) {
+  return `${e}.json`;
+}
+function g(e, a) {
+  return `pages/${s(e)}/${a}.json`;
+}
+function L(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);
+}
+function C(e) {
+  return (e ?? []).map(
+    (a) => typeof a == "string" ? { code: a } : { code: a.code, fallbackLocale: a.fallbackLocale }
+  );
+}
+export {
+  u as buildFallbackLocaleChain,
+  g as buildSourcePagePath,
+  d as buildSourceRootPath,
+  k as mergeSourceTranslations,
+  b as mergeTranslationsFromFallbackChain,
+  l as mergeTranslationsFromFallbackChainAsync,
+  C as normalizeConfiguredLocales,
+  s as resolveSourcePageName,
+  L as toSourceStorageKey
+};

package/dist/parse-path.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("./deep-merge.cjs");function n(e){const t=e.replace(/\\/g,"/");if(!t.endsWith(".json"))return{type:"ignore"};if(t.startsWith("pages/")){const r=t.match(/^pages\/(.+)\/([^/]+)\.json$/);if(!r?.[1]||!r[2])return{type:"ignore"};const o=s(r[1].split("/"));return o?{type:"page",pageName:o,locale:r[2]}:{type:"ignore"}}const a=t.match(/^([^/]+)\.json$/);return a?.[1]?{type:"root",locale:a[1]}:{type:"ignore"}}function i(e,t=!1){const a=n(e);return t&&a.type==="page"?{type:"root",locale:a.locale}:a}function s(e){return e.length===0?null:e.join("-")}function u(e,t,a,r=!1){const o=i(t,r);if(o.type==="page"){const l=e.routes[o.pageName]??(e.routes[o.pageName]={});l[o.locale]=a;return}o.type==="root"&&(e.root[o.locale]=a)}function c(e,t){return p.deepMergeTranslations(e??{},t)}exports.classifyTranslationRelativePath=i;exports.mergeRouteTranslationsWithRoot=c;exports.pagePathSegmentsToRouteName=s;exports.parseTranslationRelativePath=n;exports.storeLoadedTranslationFile=u;

package/dist/parse-path.d.cts

@@ -0,0 +1,35 @@
+export type ParsedTranslationRelativePath = {
+    type: 'page';
+    pageName: string;
+    locale: string;
+} | {
+    type: 'root';
+    locale: string;
+} | {
+    type: 'ignore';
+};
+export interface TranslationFileBuckets<T = Record<string, unknown>> {
+    root: Record<string, T>;
+    routes: Record<string, Record<string, T>>;
+}
+/**
+ * Parse a translation file path relative to the locales root.
+ * Examples: `en.json`, `pages/about/en.json`, `pages/user/profile/en.json`
+ */
+export declare function parseTranslationRelativePath(relativePath: string): ParsedTranslationRelativePath;
+/**
+ * Classify a translation path, optionally treating page files as root-level translations.
+ */
+export declare function classifyTranslationRelativePath(relativePath: string, disablePageLocales?: boolean): ParsedTranslationRelativePath;
+/**
+ * Convert nested page path segments to a route name (e.g. `user/profile` → `user-profile`).
+ */
+export declare function pagePathSegmentsToRouteName(segments: string[]): string | null;
+/**
+ * Store a loaded translation file in root or route buckets based on its relative path.
+ */
+export declare function storeLoadedTranslationFile<T extends Record<string, unknown>>(buckets: TranslationFileBuckets<T>, relativePath: string, translations: T, disablePageLocales?: boolean): void;
+/**
+ * Merge route-specific translations on top of root translations.
+ */
+export declare function mergeRouteTranslationsWithRoot<T extends Record<string, unknown>>(rootTranslations: T | undefined, routeTranslations: T): T;