nuxt-i18n-micro 3.18.2 → 3.19.0

package/dist/runtime/server/plugins/watcher.dev.js

@@ -1,11 +1,12 @@
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import path from "node:path";
+import { SERVER_CC_KEY, STORAGE_CC_KEY } from "@i18n-micro/hmr/cache-keys";
+import { handleTranslationWatchChange, parseTranslationWatchRelativePath } from "@i18n-micro/hmr/watcher";
+import { CacheControl } from "@i18n-micro/utils/cache-control";
 import { watch } from "chokidar";
 import { defineNitroPlugin } from "nitropack/runtime";
 import { getI18nPrivateConfig } from "#i18n-internal/config";
-import { CacheControl } from "../../utils/cache-control.js";
-const SERVER_CC_KEY = Symbol.for("__NUXT_I18N_SERVER_CACHE_CC__");
-const STORAGE_CC_KEY = Symbol.for("__NUXT_I18N_STORAGE_CC__");
+import { getI18nConfig } from "#i18n-internal/strategy";
 function getCacheByKey(key) {
   const g = globalThis;
   const cc = g[key];
@@ -39,24 +40,6 @@ function readJsonSafe(filePath) {
   }
   return {};
 }
-function deepMerge(target, source) {
-  const result = { ...target };
-  for (const key in source) {
-    if (key === "__proto__" || key === "constructor") continue;
-    const src = source[key];
-    const dst = result[key];
-    if (src !== null && typeof src === "object" && !Array.isArray(src) && dst !== null && typeof dst === "object" && !Array.isArray(dst)) {
-      result[key] = { ...dst, ...src };
-    } else {
-      result[key] = src;
-    }
-  }
-  return result;
-}
-function buildCacheEntry(data) {
-  const json = JSON.stringify(data).replace(/</g, "\\u003c");
-  return { data, json };
-}
 let watcherInstance = null;
 export default defineNitroPlugin((nitroApp) => {
   if (watcherInstance) {
@@ -75,56 +58,43 @@ export default defineNitroPlugin((nitroApp) => {
   const routesLocaleLinks = i18nConfig.routesLocaleLinks || {};
   const translationsRoot = path.resolve(i18nConfig.rootDir, i18nConfig.translationDir);
   log(`Watching for translation changes in: ${translationsRoot}`);
-  function mergeAndSet(serverCache, locale, pageName) {
-    const rootData = readJsonSafe(path.join(translationsRoot, `${locale}.json`));
-    const pageData = readJsonSafe(path.join(translationsRoot, "pages", pageName, `${locale}.json`));
-    const merged = deepMerge(rootData, pageData);
-    const cacheKey = `${locale}:${pageName}`;
-    serverCache.set(cacheKey, buildCacheEntry(merged));
-    const storageCache = getStorageCache();
-    if (storageCache) {
-      storageCache.delete(cacheKey);
-    }
-    log(`Re-merged and cached '${cacheKey}'`);
-    const aliases = Object.keys(routesLocaleLinks).filter((alias) => routesLocaleLinks[alias] === pageName);
-    for (const alias of aliases) {
-      const aliasKey = `${locale}:${alias}`;
-      serverCache.set(aliasKey, buildCacheEntry(merged));
-      if (storageCache) {
-        storageCache.delete(aliasKey);
-      }
-      log(`Re-merged and cached alias '${aliasKey}'`);
-    }
-  }
   const invalidateAndRefresh = async (filePath, event) => {
-    if (!filePath.endsWith(".json")) return;
     const relativePath = path.relative(translationsRoot, filePath).replace(/\\/g, "/");
-    const isPageTranslation = relativePath.startsWith("pages/");
-    const serverCache = getOrCreateServerCache();
+    const runtimeConfig = getI18nConfig();
     try {
-      if (isPageTranslation) {
-        const match = relativePath.match(/^pages\/(.+)\/([^/]+)\.json$/);
-        if (!match || !match[1] || !match[2]) return;
-        const pageName = match[1];
-        const locale = match[2];
-        mergeAndSet(serverCache, locale, pageName);
-      } else {
-        const match = relativePath.match(/^([^/]+)\.json$/);
-        if (!match || !match[1]) return;
-        const locale = match[1];
-        if (!configuredLocales.has(locale)) {
-          warn(`Detected ${event} for '${relativePath}', but locale '${locale}' is not in i18n.locales. Update config and restart dev server.`);
-          return;
-        }
-        const pagesDir = path.join(translationsRoot, "pages");
-        if (existsSync(pagesDir)) {
-          const pageDirs = readdirSync(pagesDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name);
-          for (const pageName of pageDirs) {
-            mergeAndSet(serverCache, locale, pageName);
+      const result = await handleTranslationWatchChange({
+        relativePath,
+        configuredLocales,
+        listPageNames: () => {
+          const pagesDir = path.join(translationsRoot, "pages");
+          if (!existsSync(pagesDir)) {
+            return [];
           }
+          return readdirSync(pagesDir, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name);
+        },
+        serverCache: getOrCreateServerCache(),
+        storageCache: getStorageCache(),
+        routesLocaleLinks,
+        mergeInput: {
+          translationPayloadMode: runtimeConfig.translationPayloadMode,
+          locales: runtimeConfig.locales,
+          fallbackLocale: runtimeConfig.fallbackLocale,
+          disablePageLocales: runtimeConfig.disablePageLocales,
+          readLocaleFile: (relativeFilePath) => readJsonSafe(path.join(translationsRoot, relativeFilePath))
+        }
+      });
+      if (result === "root") {
+        const parsed = parseTranslationWatchRelativePath(relativePath);
+        if (parsed.type === "root") {
+          log(`Re-merged ALL pages for locale '${parsed.locale}'`);
+        }
+      } else if (result === "page") {
+        log(`Re-merged page cache for '${relativePath}'`);
+      } else if (result === "ignored") {
+        const parsed = parseTranslationWatchRelativePath(relativePath);
+        if (parsed.type === "root" && !configuredLocales.has(parsed.locale)) {
+          warn(`Detected ${event} for '${relativePath}', but locale '${parsed.locale}' is not in i18n.locales. Update config and restart dev server.`);
         }
-        mergeAndSet(serverCache, locale, "index");
-        log(`Re-merged ALL pages for locale '${locale}'`);
       }
     } catch (e) {
       warn("Failed to refresh server cache for", filePath, e);

package/dist/runtime/server/routes/i18n.js

@@ -1,8 +1,8 @@
+import { isEnabledLocale } from "@i18n-micro/utils/active-locales";
+import { resolveI18nConfigWithRuntimeOverrides } from "@i18n-micro/utils/runtime-config";
 import { createError, defineEventHandler, getRouterParam, send, setResponseHeader } from "h3";
 import { getI18nConfig } from "#i18n-internal/strategy";
 import { useRuntimeConfig } from "#imports";
-import { isEnabledLocale } from "../../utils/active-locales.js";
-import { resolveI18nConfigWithRuntimeOverrides } from "../../utils/runtime-i18n-config.js";
 import { loadTranslationsFromServer } from "../utils/server-loader.js";
 export default defineEventHandler(async (event) => {
   const page = getRouterParam(event, "page");

package/dist/runtime/server/utils/locale-detector.js

@@ -1,3 +1,4 @@
+import { detectLocaleFromAcceptLanguage } from "@i18n-micro/utils/accept-language";
 import { getCookie, getQuery, getRequestURL } from "h3";
 export const detectCurrentLocale = (event, config, defaultLocale) => {
   const { fallbackLocale, defaultLocale: configDefaultLocale, locales } = config;
@@ -20,5 +21,14 @@ export const detectCurrentLocale = (event, config, defaultLocale) => {
       }
     }
   }
-  return (getCookie(event, "user-locale") || event.headers.get("accept-language")?.split(",")[0] || fallbackLocale || defaultLocale || configDefaultLocale || "en").toString();
+  const cookieLocale = getCookie(event, "user-locale");
+  if (cookieLocale) {
+    return cookieLocale.toString();
+  }
+  const localeCodes = locales?.map((locale) => locale.code) ?? [];
+  const detectedFromHeader = detectLocaleFromAcceptLanguage(event.headers.get("accept-language") ?? void 0, localeCodes);
+  if (detectedFromHeader) {
+    return detectedFromHeader;
+  }
+  return (fallbackLocale || defaultLocale || configDefaultLocale || "en").toString();
 };

package/dist/runtime/server/utils/locale-server-middleware.js

@@ -1,7 +1,7 @@
+import { getEnabledLocaleCodes, getEnabledLocales } from "@i18n-micro/utils/active-locales";
+import { resolveI18nConfigWithRuntimeOverrides } from "@i18n-micro/utils/runtime-config";
 import { getI18nConfig } from "#i18n-internal/strategy";
 import { useRuntimeConfig } from "#imports";
-import { getEnabledLocaleCodes, getEnabledLocales } from "../../utils/active-locales.js";
-import { resolveI18nConfigWithRuntimeOverrides } from "../../utils/runtime-i18n-config.js";
 import { detectCurrentLocale } from "./locale-detector.js";
 export const useLocaleServerMiddleware = (event, defaultLocale, currentLocale) => {
   const {

package/dist/runtime/server/utils/server-loader.d.ts

@@ -1,12 +1,12 @@
 /**
  * Server-side translation loader.
- * All merging (layers, fallback locales, global + page) is done at build time.
- * This loader simply reads a single pre-built file from Nitro storage and returns it.
+ * In `premerged` mode, layers/fallback/root+page are merged at build time and this loader
+ * reads a single Nitro asset. In `source` mode, compact source files are merged at runtime.
  */
 import type { Translations } from '@i18n-micro/types';
 /**
  * Load translations for a given locale and page.
- * Returns a single pre-built file (global + page + fallback already baked in at build time).
+ * Returns merged translations and a pre-serialized JSON string for the API route.
  */
 export declare function loadTranslationsFromServer(locale: string, routeName: string): Promise<{
     data: Translations;

package/dist/runtime/server/utils/server-loader.js

@@ -1,16 +1,20 @@
+import { SERVER_CC_KEY } from "@i18n-micro/hmr/cache-keys";
+import { isEnabledLocale } from "@i18n-micro/utils/active-locales";
+import { CacheControl } from "@i18n-micro/utils/cache-control";
+import { normalizeConfiguredLocales } from "@i18n-micro/utils/merge-source";
+import { fetchTranslationPayloadFromHost } from "@i18n-micro/utils/payload-fetch";
+import { resolveTranslationPayloadPage } from "@i18n-micro/utils/payload-url";
+import { resolveI18nConfigWithRuntimeOverrides } from "@i18n-micro/utils/runtime-config";
+import { loadSourceTranslationsFromStorage } from "@i18n-micro/utils/source-loader";
 import { useStorage } from "nitropack/runtime";
 import { getI18nConfig } from "#i18n-internal/strategy";
-import { isEnabledLocale } from "../../utils/active-locales.js";
-import { CacheControl } from "../../utils/cache-control.js";
-import { resolveI18nConfigWithRuntimeOverrides } from "../../utils/runtime-i18n-config.js";
-const CC_KEY = Symbol.for("__NUXT_I18N_SERVER_CACHE_CC__");
 function getServerCacheControl() {
   const g = globalThis;
-  if (!g[CC_KEY]) {
+  if (!g[SERVER_CC_KEY]) {
     const cfg = resolveI18nConfigWithRuntimeOverrides(getI18nConfig());
-    g[CC_KEY] = new CacheControl({ maxSize: cfg.cacheMaxSize ?? 0, ttl: cfg.cacheTtl ?? 0 });
+    g[SERVER_CC_KEY] = new CacheControl({ maxSize: cfg.cacheMaxSize ?? 0, ttl: cfg.cacheTtl ?? 0 });
   }
-  return g[CC_KEY];
+  return g[SERVER_CC_KEY];
 }
 const ASSETS_PREFIX = "assets:i18n";
 function toTranslations(data) {
@@ -35,8 +39,28 @@ export async function loadTranslationsFromServer(locale, routeName) {
   }
   const storage = useStorage();
   const routesLocaleLinks = config.routesLocaleLinks || {};
-  const resolvedPage = routesLocaleLinks[routeName] || routeName;
+  const resolvedPage = resolveTranslationPayloadPage(routeName, routesLocaleLinks);
   const normalizedPage = resolvedPage.replace(/\//g, ":");
+  if (config.apiBaseServerHost) {
+    const data2 = await fetchTranslationPayloadFromHost(config, locale, resolvedPage, $fetch);
+    const json2 = JSON.stringify(data2).replace(/</g, "\\u003c");
+    const entry2 = { data: data2, json: json2 };
+    cc.set(cacheKey, entry2);
+    return entry2;
+  }
+  if (config.translationPayloadMode === "source") {
+    const data2 = await loadSourceTranslationsFromStorage(storage, {
+      locale,
+      pageName: resolvedPage,
+      locales: normalizeConfiguredLocales(config.locales),
+      globalFallbackLocale: config.fallbackLocale,
+      disablePageLocales: config.disablePageLocales
+    });
+    const json2 = JSON.stringify(data2).replace(/</g, "\\u003c");
+    const entry2 = { data: data2, json: json2 };
+    cc.set(cacheKey, entry2);
+    return entry2;
+  }
   const key = `${ASSETS_PREFIX}:pages:${normalizedPage}:${locale}.json`;
   const loaded = await storage.getItem(key);
   const data = toTranslations(loaded);

package/dist/runtime/server/utils/translation-server-middleware.js

@@ -1,8 +1,8 @@
 import { interpolate } from "@i18n-micro/core";
+import { getEnabledLocales } from "@i18n-micro/utils/active-locales";
+import { resolveI18nConfigWithRuntimeOverrides } from "@i18n-micro/utils/runtime-config";
 import { getI18nConfig } from "#i18n-internal/strategy";
 import { useRuntimeConfig } from "#imports";
-import { getEnabledLocales } from "../../utils/active-locales.js";
-import { resolveI18nConfigWithRuntimeOverrides } from "../../utils/runtime-i18n-config.js";
 import { detectCurrentLocale } from "./locale-detector.js";
 import { loadTranslationsFromServer } from "./server-loader.js";
 const I18N_CONTEXT_KEY = "__i18n_translations__";

package/dist/runtime/utils/storage.d.ts

@@ -1,9 +1,4 @@
-/**
- * Translation Storage
- * Unified translation storage for client and server.
- * Cache control (TTL, maxSize) delegated to CacheControl.
- */
-import { type CacheControlOptions } from './cache-control.js';
+import { type CacheControlOptions } from '@i18n-micro/utils/cache-control';
 declare global {
     interface Window {
         __I18N__?: Record<string, unknown>;
@@ -12,7 +7,10 @@ declare global {
 export interface LoadOptions {
     apiBaseUrl: string;
     baseURL: string;
+    apiBaseClientHost?: string;
+    apiBaseServerHost?: string;
     dateBuild?: string | number;
+    routesLocaleLinks?: Record<string, string>;
 }
 export interface LoadResult {
     data: Record<string, unknown>;

package/dist/runtime/utils/storage.js

@@ -1,11 +1,12 @@
-import { CacheControl } from "./cache-control.js";
-const CC_KEY = Symbol.for("__NUXT_I18N_STORAGE_CC__");
+import { STORAGE_CC_KEY } from "@i18n-micro/hmr/cache-keys";
+import { CacheControl } from "@i18n-micro/utils/cache-control";
+import { buildTranslationPayloadFetchRequest } from "@i18n-micro/utils/payload-url";
 function getStorageCacheControl() {
   const g = globalThis;
-  if (!g[CC_KEY]) {
-    g[CC_KEY] = new CacheControl();
+  if (!g[STORAGE_CC_KEY]) {
+    g[STORAGE_CC_KEY] = new CacheControl();
   }
-  return g[CC_KEY];
+  return g[STORAGE_CC_KEY];
 }
 class TranslationStorage {
   cc;
@@ -28,12 +29,20 @@ class TranslationStorage {
   // FETCH LOADER
   // ==========================================================================
   async fetchTranslations(locale, routeName, options) {
-    const { apiBaseUrl, baseURL, dateBuild } = options;
-    const page = routeName || "index";
-    const path = `/${apiBaseUrl}/${page}/${locale}/data.json`;
-    return await $fetch(path.replace(/\/{2,}/g, "/"), {
-      baseURL,
-      params: dateBuild ? { v: dateBuild } : void 0
+    const request = buildTranslationPayloadFetchRequest({
+      apiBaseUrl: options.apiBaseUrl,
+      routeName,
+      locale,
+      isServer: import.meta.server,
+      baseURL: options.baseURL,
+      apiBaseClientHost: options.apiBaseClientHost,
+      apiBaseServerHost: options.apiBaseServerHost,
+      dateBuild: options.dateBuild,
+      routesLocaleLinks: options.routesLocaleLinks
+    });
+    return await $fetch(request.path, {
+      baseURL: request.baseURL,
+      params: request.params
     });
   }
   // ==========================================================================

package/dist/types.d.mts

@@ -8,6 +8,8 @@ export { type Getter, type GlobalLocaleRoutes, type Locale, type LocaleCode, typ
 
 export { type PluginsInjections } from '../dist/runtime/plugins/01.plugin.js'
 
+export { type TranslationPayloadMode, type resolveTranslationPayloadMode, type resolveTranslationPayloadOptions, type resolveTranslationPayloadPublicDir } from '@i18n-micro/utils/payload-config'
+
 export { default } from './module.mjs'
 
 export { type ModuleHooks } from './module.mjs'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nuxt-i18n-micro",
-  "version": "3.18.2",
+  "version": "3.19.0",
   "description": "Nuxt I18n Micro is a lightweight, high-performance internationalization module for Nuxt, designed to handle multi-language support with minimal overhead, fast build times, and efficient runtime performance.",
   "repository": "s00d/nuxt-i18n-micro",
   "license": "MIT",
@@ -75,10 +75,12 @@
     "globby": "^14.1.0",
     "ufo": "^1.5.4",
     "@i18n-micro/core": "1.3.1",
+    "@i18n-micro/path-strategy": "1.3.2",
+    "@i18n-micro/hmr": "1.0.0",
     "@i18n-micro/route-strategy": "1.1.7",
-    "@i18n-micro/test-utils": "1.2.1",
-    "@i18n-micro/types": "1.2.2",
-    "@i18n-micro/path-strategy": "1.3.2"
+    "@i18n-micro/types": "1.2.3",
+    "@i18n-micro/utils": "1.0.0",
+    "@i18n-micro/test-utils": "1.2.1"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.3.14",
@@ -122,9 +124,10 @@
     "dev:generate": "nuxi generate playground",
     "release": "pnpm run release:check && pnpm run release:patch",
     "release:check": "pnpm run format && pnpm run lint && pnpm run typecheck && pnpm run test:types && pnpm run test && pnpm run test:vitest && pnpm run test:workspaces",
-    "release:patch": "pnpm run prepack && node scripts/run-changelogen-release.mjs patch && pnpm publish -r && git push --follow-tags",
-    "release:minor": "pnpm run prepack && node scripts/run-changelogen-release.mjs minor && pnpm publish -r && git push --follow-tags",
-    "release:major": "pnpm run prepack && node scripts/run-changelogen-release.mjs major && pnpm publish -r && git push --follow-tags",
+    "release:auth": "node scripts/ensure-npm-auth.mjs",
+    "release:patch": "pnpm run release:auth && pnpm run prepack && node scripts/run-changelogen-release.mjs patch && pnpm publish -r && git push --follow-tags",
+    "release:minor": "pnpm run release:auth && pnpm run prepack && node scripts/run-changelogen-release.mjs minor && pnpm publish -r && git push --follow-tags",
+    "release:major": "pnpm run release:auth && pnpm run prepack && node scripts/run-changelogen-release.mjs major && pnpm publish -r && git push --follow-tags",
     "lint": "biome check .",
     "lint:fix": "biome check --write .",
     "format": "biome format --write .",
@@ -144,7 +147,7 @@
     "verify:packages": "node scripts/verify-packages.mjs",
     "verify:packages:publint": "node scripts/verify-packages.mjs --publint",
     "compare:published": "node scripts/compare-published-dist.mjs",
-    "test:dist:packages": "pnpm --filter \"@i18n-micro/core\" --filter \"@i18n-micro/vue\" --filter \"@i18n-micro/path-strategy\" --filter \"@i18n-micro/route-strategy\" --filter \"@i18n-micro/devtools-ui\" --filter \"@i18n-micro/astro\" run test:dist",
+    "test:dist:packages": "pnpm --filter \"@i18n-micro/core\" --filter \"@i18n-micro/utils\" --filter \"@i18n-micro/hmr\" --filter \"@i18n-micro/vue\" --filter \"@i18n-micro/path-strategy\" --filter \"@i18n-micro/route-strategy\" --filter \"@i18n-micro/devtools-ui\" --filter \"@i18n-micro/astro\" run test:dist",
     "typecheck": "tsc --noEmit",
     "typecheck:nuxt": "nuxt typecheck --no-emit",
     "docs:dev": "vitepress dev docs",

package/dist/client/_nuxt/builds/meta/a653a17d-86f7-440a-a09c-9871b01bc761.json

@@ -1 +0,0 @@
-{"id":"a653a17d-86f7-440a-a09c-9871b01bc761","timestamp":1779781934227,"matcher":{"static":{},"wildcard":{},"dynamic":{}},"prerendered":[]}

package/dist/runtime/utils/active-locales.d.ts

@@ -1,4 +0,0 @@
-import type { 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/runtime/utils/active-locales.js

@@ -1,9 +0,0 @@
-export function getEnabledLocales(locales) {
-  return (locales ?? []).filter((locale) => !locale.disabled);
-}
-export function getEnabledLocaleCodes(locales) {
-  return getEnabledLocales(locales).map((locale) => locale.code);
-}
-export function isEnabledLocale(locales, code) {
-  return getEnabledLocales(locales).some((locale) => locale.code === code);
-}

package/dist/runtime/utils/cache-control.d.ts

@@ -1,50 +0,0 @@
-/**
- * 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 entry. Returns undefined if missing or expired.
-     * Refreshes TTL on hit (sliding expiration).
-     * Promotes key to most-recently-used position.
-     */
-    get(key: string): T | undefined;
-    /**
-     * Check existence. Lazily evicts expired entries (side-effect by design).
-     */
-    has(key: string): boolean;
-    /**
-     * Store entry with O(1) LRU eviction.
-     * Existing key — refreshes LRU position.
-     * New key at capacity — evicts least-recently-used (first Map key).
-     */
-    set(key: string, value: T): void;
-    /** Delete entry and its expiry metadata. */
-    delete(key: string): boolean;
-    /** Clear all entries and metadata. */
-    clear(): void;
-    /** Iterate over all cache keys. */
-    keys(): IterableIterator<string>;
-    /** Current number of entries. */
-    get size(): number;
-}

package/dist/runtime/utils/cache-control.js

@@ -1,88 +0,0 @@
-export class CacheControl {
-  cache = /* @__PURE__ */ new Map();
-  expiry = /* @__PURE__ */ new Map();
-  maxSize = 0;
-  ttlMs = 0;
-  constructor(options) {
-    if (options) this.configure(options);
-  }
-  /** Update limits at runtime. Last call wins. */
-  configure(options) {
-    this.maxSize = options.maxSize ?? 0;
-    this.ttlMs = (options.ttl ?? 0) * 1e3;
-    if (this.ttlMs === 0) {
-      this.expiry.clear();
-    }
-  }
-  /**
-   * Get entry. Returns undefined if missing or expired.
-   * Refreshes TTL on hit (sliding expiration).
-   * Promotes key to most-recently-used position.
-   */
-  get(key) {
-    const entry = this.cache.get(key);
-    if (entry === void 0) return void 0;
-    if (this.ttlMs > 0) {
-      const exp = this.expiry.get(key);
-      if (exp && Date.now() > exp) {
-        this.delete(key);
-        return void 0;
-      }
-      this.expiry.set(key, Date.now() + this.ttlMs);
-    }
-    this.cache.delete(key);
-    this.cache.set(key, entry);
-    return entry;
-  }
-  /**
-   * Check existence. Lazily evicts expired entries (side-effect by design).
-   */
-  has(key) {
-    if (!this.cache.has(key)) return false;
-    if (this.ttlMs > 0) {
-      const exp = this.expiry.get(key);
-      if (exp && Date.now() > exp) {
-        this.delete(key);
-        return false;
-      }
-    }
-    return true;
-  }
-  /**
-   * Store entry with O(1) LRU eviction.
-   * Existing key — refreshes LRU position.
-   * New key at capacity — evicts least-recently-used (first Map key).
-   */
-  set(key, value) {
-    if (this.cache.has(key)) {
-      this.cache.delete(key);
-    } else if (this.maxSize > 0 && this.cache.size >= this.maxSize) {
-      const oldestKey = this.cache.keys().next().value;
-      if (oldestKey !== void 0) {
-        this.delete(oldestKey);
-      }
-    }
-    this.cache.set(key, value);
-    if (this.ttlMs > 0) {
-      this.expiry.set(key, Date.now() + this.ttlMs);
-    }
-  }
-  /** Delete entry and its expiry metadata. */
-  delete(key) {
-    this.expiry.delete(key);
-    return this.cache.delete(key);
-  }
-  /** Clear all entries and metadata. */
-  clear() {
-    this.cache.clear();
-    this.expiry.clear();
-  }
-  /** Iterate over all cache keys. */
-  keys() {
-    return this.cache.keys();
-  }
-  /** Current number of entries. */
-  get size() {
-    return this.cache.size;
-  }
-}

package/dist/runtime/utils/cookie.d.ts

@@ -1,24 +0,0 @@
-import type { 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/runtime/utils/cookie.js

@@ -1,22 +0,0 @@
-export const DEFAULT_COOKIE_NAME = "user-locale";
-export const DEFAULT_HASH_COOKIE_NAME = "hash-locale";
-export const DEFAULT_COOKIE_MAX_AGE = 60 * 60 * 24 * 365;
-export function getLocaleCookieName(config) {
-  if (config.localeCookie === null) return null;
-  return config.localeCookie || DEFAULT_COOKIE_NAME;
-}
-export function getHashCookieName(config) {
-  if (!config.hashMode) return null;
-  return DEFAULT_HASH_COOKIE_NAME;
-}
-export function getLocaleCookieOptions() {
-  const date = /* @__PURE__ */ new Date();
-  date.setTime(date.getTime() + DEFAULT_COOKIE_MAX_AGE * 1e3);
-  return {
-    expires: date,
-    maxAge: DEFAULT_COOKIE_MAX_AGE,
-    path: "/",
-    watch: true,
-    sameSite: "lax"
-  };
-}

package/dist/runtime/utils/deep-merge.d.ts

@@ -1,15 +0,0 @@
-/**
- * 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>;

package/dist/runtime/utils/deep-merge.js

@@ -1,14 +0,0 @@
-export function deepMergeTranslations(target, source) {
-  const result = { ...target };
-  for (const key in source) {
-    if (key === "__proto__" || key === "constructor") continue;
-    const src = source[key];
-    const dst = result[key];
-    if (src !== null && typeof src === "object" && !Array.isArray(src) && dst !== null && typeof dst === "object" && !Array.isArray(dst)) {
-      result[key] = { ...dst, ...src };
-    } else {
-      result[key] = src;
-    }
-  }
-  return result;
-}