@intlayer/core 8.6.3 → 8.6.4

package/dist/cjs/utils/localeStorage.cjs

@@ -2,7 +2,6 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 const require_utils_getCookie = require('./getCookie.cjs');
 let _intlayer_config_built = require("@intlayer/config/built");
-_intlayer_config_built = require_runtime.__toESM(_intlayer_config_built);
 
 //#region src/utils/localeStorage.ts
 /**
@@ -36,20 +35,19 @@ const buildCookieString = (name, value, attributes) => {
 * Does not read from headers — use `getLocaleFromStorageServer` for that.
 */
 const getLocaleFromStorageClient = (options) => {
-	const { routing, internationalization } = _intlayer_config_built.default;
-	const { locales } = internationalization;
-	const storageAttributes = routing.storage;
+	const { locales } = _intlayer_config_built.internationalization;
+	const storageAttributes = _intlayer_config_built.routing.storage;
 	if (options?.isCookieEnabled === false) return void 0;
 	const isValidLocale = (value) => !!value && locales.includes(value);
-	if (!TREE_SHAKE_STORAGE_COOKIES) for (let i = 0; i < storageAttributes.cookies.length; i++) try {
+	if (!TREE_SHAKE_STORAGE_COOKIES) for (let i = 0; i < (storageAttributes.cookies ?? []).length; i++) try {
 		const value = options?.getCookie?.(storageAttributes.cookies[i].name);
 		if (isValidLocale(value)) return value;
 	} catch {}
-	if (!TREE_SHAKE_STORAGE_LOCAL_STORAGE) for (let i = 0; i < storageAttributes.localStorage.length; i++) try {
+	if (!TREE_SHAKE_STORAGE_LOCAL_STORAGE) for (let i = 0; i < (storageAttributes.localStorage ?? []).length; i++) try {
 		const value = options?.getLocaleStorage?.(storageAttributes.localStorage[i].name);
 		if (isValidLocale(value)) return value;
 	} catch {}
-	if (!TREE_SHAKE_STORAGE_SESSION_STORAGE) for (let i = 0; i < storageAttributes.sessionStorage.length; i++) try {
+	if (!TREE_SHAKE_STORAGE_SESSION_STORAGE && storageAttributes.sessionStorage) for (let i = 0; i < storageAttributes.sessionStorage.length; i++) try {
 		const value = options?.getSessionStorage?.(storageAttributes.sessionStorage[i].name);
 		if (isValidLocale(value)) return value;
 	} catch {}
@@ -60,10 +58,9 @@ const getLocaleFromStorageClient = (options) => {
 * Does not write to headers — use `setLocaleInStorageServer` for that.
 */
 const setLocaleInStorageClient = (locale, options) => {
-	const { routing } = _intlayer_config_built.default;
-	const storageAttributes = routing.storage;
+	const storageAttributes = _intlayer_config_built.routing.storage;
 	if (options?.isCookieEnabled === false) return;
-	if (!TREE_SHAKE_STORAGE_COOKIES) for (let i = 0; i < storageAttributes.cookies.length; i++) {
+	if (!TREE_SHAKE_STORAGE_COOKIES && storageAttributes.cookies) for (let i = 0; i < storageAttributes.cookies.length; i++) {
 		const { name, attributes } = storageAttributes.cookies[i];
 		try {
 			if (options?.setCookieStore) options.setCookieStore(name, locale, {
@@ -76,7 +73,7 @@ const setLocaleInStorageClient = (locale, options) => {
 			} catch {}
 		}
 	}
-	if (!TREE_SHAKE_STORAGE_LOCAL_STORAGE && options?.setLocaleStorage) for (let i = 0; i < storageAttributes.localStorage.length; i++) {
+	if (!TREE_SHAKE_STORAGE_LOCAL_STORAGE && storageAttributes.localStorage && options?.setLocaleStorage) for (let i = 0; i < storageAttributes.localStorage.length; i++) {
 		const { name } = storageAttributes.localStorage[i];
 		try {
 			if (!(options?.overwrite ?? true) && options?.getLocaleStorage) {
@@ -85,7 +82,7 @@ const setLocaleInStorageClient = (locale, options) => {
 			options.setLocaleStorage(name, locale);
 		} catch {}
 	}
-	if (!TREE_SHAKE_STORAGE_SESSION_STORAGE && options?.setSessionStorage) for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {
+	if (!TREE_SHAKE_STORAGE_SESSION_STORAGE && storageAttributes.sessionStorage && options?.setSessionStorage) for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {
 		const { name } = storageAttributes.sessionStorage[i];
 		try {
 			if (!(options?.overwrite ?? true) && options?.getSessionStorage) {
@@ -117,16 +114,15 @@ const LocaleStorageClient = (options) => ({
 * No browser cookie fallback — the caller must provide `getCookie`.
 */
 const getLocaleFromStorageServer = (options) => {
-	const { routing, internationalization } = _intlayer_config_built.default;
-	const { locales } = internationalization;
-	const storageAttributes = routing.storage;
+	const { locales } = _intlayer_config_built.internationalization;
+	const storageAttributes = _intlayer_config_built.routing.storage;
 	if (options?.isCookieEnabled === false) return void 0;
 	const isValidLocale = (value) => !!value && locales.includes(value);
-	if (!TREE_SHAKE_STORAGE_COOKIES) for (let i = 0; i < storageAttributes.cookies.length; i++) try {
+	if (!TREE_SHAKE_STORAGE_COOKIES && storageAttributes.cookies) for (let i = 0; i < storageAttributes.cookies.length; i++) try {
 		const value = options?.getCookie?.(storageAttributes.cookies[i].name);
 		if (isValidLocale(value)) return value;
 	} catch {}
-	if (!TREE_SHAKE_STORAGE_HEADERS) for (let i = 0; i < storageAttributes.headers.length; i++) try {
+	if (!TREE_SHAKE_STORAGE_HEADERS && storageAttributes.headers) for (let i = 0; i < storageAttributes.headers.length; i++) try {
 		const value = options?.getHeader?.(storageAttributes.headers[i].name);
 		if (isValidLocale(value)) return value;
 	} catch {}
@@ -136,10 +132,9 @@ const getLocaleFromStorageServer = (options) => {
 * Does not write to localStorage or sessionStorage.
 */
 const setLocaleInStorageServer = (locale, options) => {
-	const { routing } = _intlayer_config_built.default;
-	const storageAttributes = routing.storage;
+	const storageAttributes = _intlayer_config_built.routing.storage;
 	if (options?.isCookieEnabled === false) return;
-	if (!TREE_SHAKE_STORAGE_COOKIES) for (let i = 0; i < storageAttributes.cookies.length; i++) {
+	if (!TREE_SHAKE_STORAGE_COOKIES && storageAttributes.cookies) for (let i = 0; i < storageAttributes.cookies.length; i++) {
 		const { name, attributes } = storageAttributes.cookies[i];
 		try {
 			if (options?.setCookieStore) options.setCookieStore(name, locale, {
@@ -152,7 +147,7 @@ const setLocaleInStorageServer = (locale, options) => {
 			} catch {}
 		}
 	}
-	if (!TREE_SHAKE_STORAGE_HEADERS && options?.setHeader) for (let i = 0; i < storageAttributes.headers.length; i++) try {
+	if (!TREE_SHAKE_STORAGE_HEADERS && storageAttributes.headers && options?.setHeader) for (let i = 0; i < storageAttributes.headers.length; i++) try {
 		options.setHeader(storageAttributes.headers[i].name, locale);
 	} catch {}
 };
@@ -185,9 +180,8 @@ const LocaleStorageServer = (options) => ({
 * {@link getLocaleFromStorageServer} (server) instead.
 */
 const getLocaleFromStorage = (options) => {
-	const { routing, internationalization } = _intlayer_config_built.default;
-	const { locales } = internationalization;
-	const storageAttributes = routing.storage;
+	const { locales } = _intlayer_config_built.internationalization;
+	const storageAttributes = _intlayer_config_built.routing.storage;
 	if (options?.isCookieEnabled === false) return void 0;
 	const isValidLocale = (value) => !!value && locales.includes(value);
 	const readCookie = (name) => {
@@ -197,19 +191,19 @@ const getLocaleFromStorage = (options) => {
 		} catch {}
 		return require_utils_getCookie.getCookie(name);
 	};
-	if (!TREE_SHAKE_STORAGE_COOKIES) for (let i = 0; i < storageAttributes.cookies.length; i++) {
+	if (!TREE_SHAKE_STORAGE_COOKIES && storageAttributes.cookies) for (let i = 0; i < storageAttributes.cookies.length; i++) {
 		const value = readCookie(storageAttributes.cookies[i].name);
 		if (isValidLocale(value)) return value;
 	}
-	if (!TREE_SHAKE_STORAGE_LOCAL_STORAGE) for (let i = 0; i < storageAttributes.localStorage.length; i++) try {
+	if (!TREE_SHAKE_STORAGE_LOCAL_STORAGE && storageAttributes.localStorage) for (let i = 0; i < storageAttributes.localStorage.length; i++) try {
 		const value = options?.getLocaleStorage?.(storageAttributes.localStorage[i].name);
 		if (isValidLocale(value)) return value;
 	} catch {}
-	if (!TREE_SHAKE_STORAGE_SESSION_STORAGE) for (let i = 0; i < storageAttributes.sessionStorage.length; i++) try {
+	if (!TREE_SHAKE_STORAGE_SESSION_STORAGE && storageAttributes.sessionStorage) for (let i = 0; i < storageAttributes.sessionStorage.length; i++) try {
 		const value = options?.getSessionStorage?.(storageAttributes.sessionStorage[i].name);
 		if (isValidLocale(value)) return value;
 	} catch {}
-	if (!TREE_SHAKE_STORAGE_HEADERS) for (let i = 0; i < storageAttributes.headers.length; i++) try {
+	if (!TREE_SHAKE_STORAGE_HEADERS && storageAttributes.headers) for (let i = 0; i < storageAttributes.headers.length; i++) try {
 		const value = options?.getHeader?.(storageAttributes.headers[i].name);
 		if (isValidLocale(value)) return value;
 	} catch {}
@@ -222,10 +216,9 @@ const getLocaleFromStorage = (options) => {
 * {@link setLocaleInStorageServer} (server) instead.
 */
 const setLocaleInStorage = (locale, options) => {
-	const { routing } = _intlayer_config_built.default;
-	const storageAttributes = routing.storage;
+	const storageAttributes = _intlayer_config_built.routing.storage;
 	if (options?.isCookieEnabled === false) return;
-	if (!TREE_SHAKE_STORAGE_COOKIES) for (let i = 0; i < storageAttributes.cookies.length; i++) {
+	if (!TREE_SHAKE_STORAGE_COOKIES && storageAttributes.cookies) for (let i = 0; i < storageAttributes.cookies.length; i++) {
 		const { name, attributes } = storageAttributes.cookies[i];
 		try {
 			if (options?.setCookieStore) options.setCookieStore(name, locale, {
@@ -238,7 +231,7 @@ const setLocaleInStorage = (locale, options) => {
 			} catch {}
 		}
 	}
-	if (!TREE_SHAKE_STORAGE_LOCAL_STORAGE && options?.setLocaleStorage) for (let i = 0; i < storageAttributes.localStorage.length; i++) {
+	if (!TREE_SHAKE_STORAGE_LOCAL_STORAGE && storageAttributes.localStorage && options?.setLocaleStorage) for (let i = 0; i < storageAttributes.localStorage.length; i++) {
 		const { name } = storageAttributes.localStorage[i];
 		try {
 			if (!(options?.overwrite ?? true) && options?.getLocaleStorage) {
@@ -247,7 +240,7 @@ const setLocaleInStorage = (locale, options) => {
 			options.setLocaleStorage(name, locale);
 		} catch {}
 	}
-	if (!TREE_SHAKE_STORAGE_SESSION_STORAGE && options?.setSessionStorage) for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {
+	if (!TREE_SHAKE_STORAGE_SESSION_STORAGE && storageAttributes.sessionStorage && options?.setSessionStorage) for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {
 		const { name } = storageAttributes.sessionStorage[i];
 		try {
 			if (!(options?.overwrite ?? true) && options?.getSessionStorage) {
@@ -256,7 +249,7 @@ const setLocaleInStorage = (locale, options) => {
 			options.setSessionStorage(name, locale);
 		} catch {}
 	}
-	if (!TREE_SHAKE_STORAGE_HEADERS && options?.setHeader) for (let i = 0; i < storageAttributes.headers.length; i++) try {
+	if (!TREE_SHAKE_STORAGE_HEADERS && storageAttributes.headers && options?.setHeader) for (let i = 0; i < storageAttributes.headers.length; i++) try {
 		options.setHeader(storageAttributes.headers[i].name, locale);
 	} catch {}
 };

package/dist/cjs/utils/localeStorage.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"localeStorage.cjs","names":["configuration","getCookie"],"sources":["../../../src/utils/localeStorage.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { CookiesAttributes } from '@intlayer/types/config';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { getCookie } from './getCookie';\n\n// ── Tree-shake constants ──────────────────────────────────────────────────────\n// When these env vars are injected at build time, bundlers eliminate the\n// branches guarded by these constants.\n\n/**\n * True when cookie storage is explicitly disabled at build time.\n */\nconst TREE_SHAKE_STORAGE_COOKIES =\n  process.env['INTLAYER_ROUTING_STORAGE_COOKIES'] === 'false';\n\n/**\n * True when localStorage is explicitly disabled at build time.\n */\nconst TREE_SHAKE_STORAGE_LOCAL_STORAGE =\n  process.env['INTLAYER_ROUTING_STORAGE_LOCALSTORAGE'] === 'false';\n\n/**\n * True when sessionStorage is explicitly disabled at build time.\n */\nconst TREE_SHAKE_STORAGE_SESSION_STORAGE =\n  process.env['INTLAYER_ROUTING_STORAGE_SESSIONSTORAGE'] === 'false';\n\n/**\n * True when header storage is explicitly disabled at build time.\n */\nconst TREE_SHAKE_STORAGE_HEADERS =\n  process.env['INTLAYER_ROUTING_STORAGE_HEADERS'] === 'false';\n\n// ============================================================================\n// Shared types\n// ============================================================================\n\nexport type CookieBuildAttributes = {\n  domain?: string;\n  path?: string;\n  secure?: boolean;\n  httpOnly?: boolean;\n  sameSite?: 'strict' | 'lax' | 'none';\n  /** Expiry as milliseconds since epoch (Date.getTime()) or number of days */\n  expires?: number | undefined;\n};\n\n// ============================================================================\n// Shared helpers\n// ============================================================================\n\nconst buildCookieString = (\n  name: string,\n  value: string,\n  attributes: Omit<CookiesAttributes, 'name' | 'type'>\n): string => {\n  const encodedValue = encodeURIComponent(value);\n  const parts: string[] = [`${name}=${encodedValue}`];\n\n  if (attributes.path) parts.push(`Path=${attributes.path}`);\n  if (attributes.domain) parts.push(`Domain=${attributes.domain}`);\n  if (attributes.expires instanceof Date)\n    parts.push(`Expires=${attributes.expires.toUTCString()}`);\n  if (attributes.secure) parts.push('Secure');\n  if (attributes.sameSite) parts.push(`SameSite=${attributes.sameSite}`);\n  return parts.join('; ');\n};\n\n// ============================================================================\n// Client-specific types and functions\n// (cookies via browser APIs, localStorage, sessionStorage — no headers)\n// ============================================================================\n\nexport type LocaleStorageClientOptions = {\n  overwrite?: boolean;\n  isCookieEnabled?: boolean;\n  setCookieStore?: (\n    name: string,\n    value: string,\n    cookie: CookieBuildAttributes\n  ) => void;\n  setCookieString?: (name: string, cookie: string) => void;\n  getCookie?: (name: string) => string | undefined | null;\n  setSessionStorage?: (name: string, value: string) => void;\n  getSessionStorage?: (name: string) => string | undefined | null;\n  setLocaleStorage?: (name: string, value: string) => void;\n  getLocaleStorage?: (name: string) => string | undefined | null;\n};\n\n/**\n * Retrieves the locale from browser storage mechanisms\n * (cookies, localStorage, sessionStorage).\n * Does not read from headers — use `getLocaleFromStorageServer` for that.\n */\nexport const getLocaleFromStorageClient = (\n  options: LocaleStorageClientOptions\n): Locale | undefined => {\n  const { routing, internationalization } = configuration;\n  const { locales } = internationalization;\n  const storageAttributes = routing.storage;\n\n  if (options?.isCookieEnabled === false) return undefined;\n\n  const isValidLocale = (value: string | null | undefined): value is Locale =>\n    !!value && locales.includes(value as Locale);\n\n  if (!TREE_SHAKE_STORAGE_COOKIES) {\n    for (let i = 0; i < storageAttributes.cookies.length; i++) {\n      try {\n        const value = options?.getCookie?.(storageAttributes.cookies[i].name);\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_LOCAL_STORAGE) {\n    for (let i = 0; i < storageAttributes.localStorage.length; i++) {\n      try {\n        const value = options?.getLocaleStorage?.(\n          storageAttributes.localStorage[i].name\n        );\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_SESSION_STORAGE) {\n    for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {\n      try {\n        const value = options?.getSessionStorage?.(\n          storageAttributes.sessionStorage[i].name\n        );\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n};\n\n/**\n * Stores the locale in browser storage mechanisms\n * (cookies, localStorage, sessionStorage).\n * Does not write to headers — use `setLocaleInStorageServer` for that.\n */\nexport const setLocaleInStorageClient = (\n  locale: LocalesValues,\n  options?: LocaleStorageClientOptions\n): void => {\n  const { routing } = configuration;\n  const storageAttributes = routing.storage;\n\n  if (options?.isCookieEnabled === false) return;\n\n  if (!TREE_SHAKE_STORAGE_COOKIES) {\n    for (let i = 0; i < storageAttributes.cookies.length; i++) {\n      const { name, attributes } = storageAttributes.cookies[i];\n      try {\n        if (options?.setCookieStore) {\n          options.setCookieStore(name, locale, {\n            ...attributes,\n            expires:\n              attributes.expires instanceof Date\n                ? attributes.expires.getTime()\n                : attributes.expires,\n          });\n        }\n      } catch {\n        try {\n          if (options?.setCookieString) {\n            options.setCookieString(\n              name,\n              buildCookieString(name, locale, attributes)\n            );\n          }\n        } catch {}\n      }\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_LOCAL_STORAGE && options?.setLocaleStorage) {\n    for (let i = 0; i < storageAttributes.localStorage.length; i++) {\n      const { name } = storageAttributes.localStorage[i];\n      try {\n        if (!(options?.overwrite ?? true) && options?.getLocaleStorage) {\n          if (options.getLocaleStorage(name)) continue;\n        }\n        options.setLocaleStorage(name, locale);\n      } catch {}\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_SESSION_STORAGE && options?.setSessionStorage) {\n    for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {\n      const { name } = storageAttributes.sessionStorage[i];\n      try {\n        if (!(options?.overwrite ?? true) && options?.getSessionStorage) {\n          if (options.getSessionStorage(name)) continue;\n        }\n        options.setSessionStorage(name, locale);\n      } catch {}\n    }\n  }\n};\n\n/**\n * Client-side locale storage utility.\n * Handles cookies (browser), localStorage and sessionStorage.\n * Does not access headers.\n *\n * @example\n * ```ts\n * const storage = LocaleStorageClient(localeStorageOptions);\n * const locale = storage.getLocale();\n * storage.setLocale('fr');\n * ```\n */\nexport const LocaleStorageClient = (options: LocaleStorageClientOptions) => ({\n  getLocale: () => getLocaleFromStorageClient(options),\n  setLocale: (locale: LocalesValues) =>\n    setLocaleInStorageClient(locale, options),\n});\n\n// ============================================================================\n// Server-specific types and functions\n// (cookies via injected getter/setter, headers — no localStorage/sessionStorage)\n// ============================================================================\n\nexport type LocaleStorageServerOptions = {\n  overwrite?: boolean;\n  isCookieEnabled?: boolean;\n  setCookieStore?: (\n    name: string,\n    value: string,\n    cookie: CookieBuildAttributes\n  ) => void;\n  setCookieString?: (name: string, cookie: string) => void;\n  getCookie?: (name: string) => string | undefined | null;\n  getHeader?: (name: string) => string | undefined | null;\n  setHeader?: (name: string, value: string) => void;\n};\n\n/**\n * Retrieves the locale from server-side storage mechanisms (cookies, headers).\n * Does not access localStorage or sessionStorage.\n * No browser cookie fallback — the caller must provide `getCookie`.\n */\nexport const getLocaleFromStorageServer = (\n  options: LocaleStorageServerOptions\n): Locale | undefined => {\n  const { routing, internationalization } = configuration;\n  const { locales } = internationalization;\n  const storageAttributes = routing.storage;\n\n  if (options?.isCookieEnabled === false) return undefined;\n\n  const isValidLocale = (value: string | null | undefined): value is Locale =>\n    !!value && locales.includes(value as Locale);\n\n  if (!TREE_SHAKE_STORAGE_COOKIES) {\n    for (let i = 0; i < storageAttributes.cookies.length; i++) {\n      try {\n        const value = options?.getCookie?.(storageAttributes.cookies[i].name);\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_HEADERS) {\n    for (let i = 0; i < storageAttributes.headers.length; i++) {\n      try {\n        const value = options?.getHeader?.(storageAttributes.headers[i].name);\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n};\n\n/**\n * Stores the locale in server-side storage mechanisms (cookies, headers).\n * Does not write to localStorage or sessionStorage.\n */\nexport const setLocaleInStorageServer = (\n  locale: LocalesValues,\n  options?: LocaleStorageServerOptions\n): void => {\n  const { routing } = configuration;\n  const storageAttributes = routing.storage;\n\n  if (options?.isCookieEnabled === false) return;\n\n  if (!TREE_SHAKE_STORAGE_COOKIES) {\n    for (let i = 0; i < storageAttributes.cookies.length; i++) {\n      const { name, attributes } = storageAttributes.cookies[i];\n      try {\n        if (options?.setCookieStore) {\n          options.setCookieStore(name, locale, {\n            ...attributes,\n            expires:\n              attributes.expires instanceof Date\n                ? attributes.expires.getTime()\n                : attributes.expires,\n          });\n        }\n      } catch {\n        try {\n          if (options?.setCookieString) {\n            options.setCookieString(\n              name,\n              buildCookieString(name, locale, attributes)\n            );\n          }\n        } catch {}\n      }\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_HEADERS && options?.setHeader) {\n    for (let i = 0; i < storageAttributes.headers.length; i++) {\n      try {\n        options.setHeader(storageAttributes.headers[i].name, locale);\n      } catch {}\n    }\n  }\n};\n\n/**\n * Server-side locale storage utility.\n * Handles cookies (via injected getter/setter) and headers.\n * Does not access localStorage or sessionStorage.\n *\n * @example\n * ```ts\n * const storage = LocaleStorageServer({\n *   getCookie: (name) => req.cookies[name],\n *   setCookieStore: (name, value, attrs) => res.cookie(name, value, attrs),\n *   getHeader: (name) => req.headers[name],\n *   setHeader: (name, value) => res.setHeader(name, value),\n * });\n * const locale = storage.getLocale();\n * storage.setLocale('fr');\n * ```\n */\nexport const LocaleStorageServer = (options: LocaleStorageServerOptions) => ({\n  getLocale: () => getLocaleFromStorageServer(options),\n  setLocale: (locale: LocalesValues) =>\n    setLocaleInStorageServer(locale, options),\n});\n\n// ============================================================================\n// Deprecated: combined LocaleStorage\n// Use LocaleStorageClient or LocaleStorageServer instead\n// ============================================================================\n\n/**\n * @deprecated Use {@link LocaleStorageClientOptions} or {@link LocaleStorageServerOptions} instead.\n */\nexport type LocaleStorageOptions = LocaleStorageClientOptions &\n  LocaleStorageServerOptions;\n\n/**\n * Retrieves the locale from all storage mechanisms\n * (cookies, localStorage, sessionStorage, headers).\n *\n * @deprecated Use {@link getLocaleFromStorageClient} (browser) or\n * {@link getLocaleFromStorageServer} (server) instead.\n */\nexport const getLocaleFromStorage = (\n  options: Pick<\n    LocaleStorageOptions,\n    | 'getCookie'\n    | 'getSessionStorage'\n    | 'getLocaleStorage'\n    | 'getHeader'\n    | 'isCookieEnabled'\n  >\n): Locale | undefined => {\n  const { routing, internationalization } = configuration;\n  const { locales } = internationalization;\n  const storageAttributes = routing.storage;\n\n  if (options?.isCookieEnabled === false) return undefined;\n\n  const isValidLocale = (value: string | null | undefined): value is Locale =>\n    !!value && locales.includes(value as Locale);\n\n  const readCookie = (name: string): string | undefined => {\n    try {\n      const fromOption = options?.getCookie?.(name);\n      if (fromOption !== null && fromOption !== undefined) return fromOption;\n    } catch {}\n    // Browser fallback kept for backward compatibility\n    return getCookie(name);\n  };\n\n  if (!TREE_SHAKE_STORAGE_COOKIES) {\n    for (let i = 0; i < storageAttributes.cookies.length; i++) {\n      const value = readCookie(storageAttributes.cookies[i].name);\n      if (isValidLocale(value)) return value;\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_LOCAL_STORAGE) {\n    for (let i = 0; i < storageAttributes.localStorage.length; i++) {\n      try {\n        const value = options?.getLocaleStorage?.(\n          storageAttributes.localStorage[i].name\n        );\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_SESSION_STORAGE) {\n    for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {\n      try {\n        const value = options?.getSessionStorage?.(\n          storageAttributes.sessionStorage[i].name\n        );\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_HEADERS) {\n    for (let i = 0; i < storageAttributes.headers.length; i++) {\n      try {\n        const value = options?.getHeader?.(storageAttributes.headers[i].name);\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n};\n\n/**\n * Stores the locale in all configured storage mechanisms\n * (cookies, localStorage, sessionStorage, headers).\n *\n * @deprecated Use {@link setLocaleInStorageClient} (browser) or\n * {@link setLocaleInStorageServer} (server) instead.\n */\nexport const setLocaleInStorage = (\n  locale: LocalesValues,\n  options?: LocaleStorageOptions\n): void => {\n  const { routing } = configuration;\n  const storageAttributes = routing.storage;\n\n  if (options?.isCookieEnabled === false) return;\n\n  if (!TREE_SHAKE_STORAGE_COOKIES) {\n    for (let i = 0; i < storageAttributes.cookies.length; i++) {\n      const { name, attributes } = storageAttributes.cookies[i];\n      try {\n        if (options?.setCookieStore) {\n          options.setCookieStore(name, locale, {\n            ...attributes,\n            expires:\n              attributes.expires instanceof Date\n                ? attributes.expires.getTime()\n                : attributes.expires,\n          });\n        }\n      } catch {\n        try {\n          if (options?.setCookieString) {\n            options.setCookieString(\n              name,\n              buildCookieString(name, locale, attributes)\n            );\n          }\n        } catch {}\n      }\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_LOCAL_STORAGE && options?.setLocaleStorage) {\n    for (let i = 0; i < storageAttributes.localStorage.length; i++) {\n      const { name } = storageAttributes.localStorage[i];\n      try {\n        if (!(options?.overwrite ?? true) && options?.getLocaleStorage) {\n          if (options.getLocaleStorage(name)) continue;\n        }\n        options.setLocaleStorage(name, locale);\n      } catch {}\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_SESSION_STORAGE && options?.setSessionStorage) {\n    for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {\n      const { name } = storageAttributes.sessionStorage[i];\n      try {\n        if (!(options?.overwrite ?? true) && options?.getSessionStorage) {\n          if (options.getSessionStorage(name)) continue;\n        }\n        options.setSessionStorage(name, locale);\n      } catch {}\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_HEADERS && options?.setHeader) {\n    for (let i = 0; i < storageAttributes.headers.length; i++) {\n      try {\n        options.setHeader(storageAttributes.headers[i].name, locale);\n      } catch {}\n    }\n  }\n};\n\n/**\n * Utility object to get and set the locale in storage based on configuration.\n *\n * @deprecated Use {@link LocaleStorageClient} (browser) or\n * {@link LocaleStorageServer} (server) instead.\n */\nexport const LocaleStorage = (options: LocaleStorageOptions) => ({\n  getLocale: () => getLocaleFromStorage(options),\n  setLocale: (locale: LocalesValues) => setLocaleInStorage(locale, options),\n});\n"],"mappings":"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"}
+{"version":3,"file":"localeStorage.cjs","names":["internationalization","routing","getCookie"],"sources":["../../../src/utils/localeStorage.ts"],"sourcesContent":["import { internationalization, routing } from '@intlayer/config/built';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { CookiesAttributes } from '@intlayer/types/config';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { getCookie } from './getCookie';\n\n// ── Tree-shake constants ──────────────────────────────────────────────────────\n// When these env vars are injected at build time, bundlers eliminate the\n// branches guarded by these constants.\n\n/**\n * True when cookie storage is explicitly disabled at build time.\n */\nconst TREE_SHAKE_STORAGE_COOKIES =\n  process.env['INTLAYER_ROUTING_STORAGE_COOKIES'] === 'false';\n\n/**\n * True when localStorage is explicitly disabled at build time.\n */\nconst TREE_SHAKE_STORAGE_LOCAL_STORAGE =\n  process.env['INTLAYER_ROUTING_STORAGE_LOCALSTORAGE'] === 'false';\n\n/**\n * True when sessionStorage is explicitly disabled at build time.\n */\nconst TREE_SHAKE_STORAGE_SESSION_STORAGE =\n  process.env['INTLAYER_ROUTING_STORAGE_SESSIONSTORAGE'] === 'false';\n\n/**\n * True when header storage is explicitly disabled at build time.\n */\nconst TREE_SHAKE_STORAGE_HEADERS =\n  process.env['INTLAYER_ROUTING_STORAGE_HEADERS'] === 'false';\n\n// ============================================================================\n// Shared types\n// ============================================================================\n\nexport type CookieBuildAttributes = {\n  domain?: string;\n  path?: string;\n  secure?: boolean;\n  httpOnly?: boolean;\n  sameSite?: 'strict' | 'lax' | 'none';\n  /** Expiry as milliseconds since epoch (Date.getTime()) or number of days */\n  expires?: number | undefined;\n};\n\n// ============================================================================\n// Shared helpers\n// ============================================================================\n\nconst buildCookieString = (\n  name: string,\n  value: string,\n  attributes: Omit<CookiesAttributes, 'name' | 'type'>\n): string => {\n  const encodedValue = encodeURIComponent(value);\n  const parts: string[] = [`${name}=${encodedValue}`];\n\n  if (attributes.path) parts.push(`Path=${attributes.path}`);\n  if (attributes.domain) parts.push(`Domain=${attributes.domain}`);\n  if (attributes.expires instanceof Date)\n    parts.push(`Expires=${attributes.expires.toUTCString()}`);\n  if (attributes.secure) parts.push('Secure');\n  if (attributes.sameSite) parts.push(`SameSite=${attributes.sameSite}`);\n  return parts.join('; ');\n};\n\n// ============================================================================\n// Client-specific types and functions\n// (cookies via browser APIs, localStorage, sessionStorage — no headers)\n// ============================================================================\n\nexport type LocaleStorageClientOptions = {\n  overwrite?: boolean;\n  isCookieEnabled?: boolean;\n  setCookieStore?: (\n    name: string,\n    value: string,\n    cookie: CookieBuildAttributes\n  ) => void;\n  setCookieString?: (name: string, cookie: string) => void;\n  getCookie?: (name: string) => string | undefined | null;\n  setSessionStorage?: (name: string, value: string) => void;\n  getSessionStorage?: (name: string) => string | undefined | null;\n  setLocaleStorage?: (name: string, value: string) => void;\n  getLocaleStorage?: (name: string) => string | undefined | null;\n};\n\n/**\n * Retrieves the locale from browser storage mechanisms\n * (cookies, localStorage, sessionStorage).\n * Does not read from headers — use `getLocaleFromStorageServer` for that.\n */\nexport const getLocaleFromStorageClient = (\n  options: LocaleStorageClientOptions\n): Locale | undefined => {\n  const { locales } = internationalization;\n  const storageAttributes = routing.storage;\n\n  if (options?.isCookieEnabled === false) return undefined;\n\n  const isValidLocale = (value: string | null | undefined): value is Locale =>\n    !!value && locales.includes(value as Locale);\n\n  if (!TREE_SHAKE_STORAGE_COOKIES) {\n    for (let i = 0; i < (storageAttributes.cookies ?? []).length; i++) {\n      try {\n        const value = options?.getCookie?.(storageAttributes.cookies![i].name);\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_LOCAL_STORAGE) {\n    for (let i = 0; i < (storageAttributes.localStorage ?? []).length; i++) {\n      try {\n        const value = options?.getLocaleStorage?.(\n          storageAttributes.localStorage![i].name\n        );\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_SESSION_STORAGE && storageAttributes.sessionStorage) {\n    for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {\n      try {\n        const value = options?.getSessionStorage?.(\n          storageAttributes.sessionStorage[i].name\n        );\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n};\n\n/**\n * Stores the locale in browser storage mechanisms\n * (cookies, localStorage, sessionStorage).\n * Does not write to headers — use `setLocaleInStorageServer` for that.\n */\nexport const setLocaleInStorageClient = (\n  locale: LocalesValues,\n  options?: LocaleStorageClientOptions\n): void => {\n  const storageAttributes = routing.storage;\n\n  if (options?.isCookieEnabled === false) return;\n\n  if (!TREE_SHAKE_STORAGE_COOKIES && storageAttributes.cookies) {\n    for (let i = 0; i < storageAttributes.cookies.length; i++) {\n      const { name, attributes } = storageAttributes.cookies[i];\n      try {\n        if (options?.setCookieStore) {\n          options.setCookieStore(name, locale, {\n            ...attributes,\n            expires:\n              attributes.expires instanceof Date\n                ? attributes.expires.getTime()\n                : attributes.expires,\n          });\n        }\n      } catch {\n        try {\n          if (options?.setCookieString) {\n            options.setCookieString(\n              name,\n              buildCookieString(name, locale, attributes)\n            );\n          }\n        } catch {}\n      }\n    }\n  }\n\n  if (\n    !TREE_SHAKE_STORAGE_LOCAL_STORAGE &&\n    storageAttributes.localStorage &&\n    options?.setLocaleStorage\n  ) {\n    for (let i = 0; i < storageAttributes.localStorage.length; i++) {\n      const { name } = storageAttributes.localStorage[i];\n      try {\n        if (!(options?.overwrite ?? true) && options?.getLocaleStorage) {\n          if (options.getLocaleStorage(name)) continue;\n        }\n        options.setLocaleStorage(name, locale);\n      } catch {}\n    }\n  }\n\n  if (\n    !TREE_SHAKE_STORAGE_SESSION_STORAGE &&\n    storageAttributes.sessionStorage &&\n    options?.setSessionStorage\n  ) {\n    for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {\n      const { name } = storageAttributes.sessionStorage[i];\n      try {\n        if (!(options?.overwrite ?? true) && options?.getSessionStorage) {\n          if (options.getSessionStorage(name)) continue;\n        }\n        options.setSessionStorage(name, locale);\n      } catch {}\n    }\n  }\n};\n\n/**\n * Client-side locale storage utility.\n * Handles cookies (browser), localStorage and sessionStorage.\n * Does not access headers.\n *\n * @example\n * ```ts\n * const storage = LocaleStorageClient(localeStorageOptions);\n * const locale = storage.getLocale();\n * storage.setLocale('fr');\n * ```\n */\nexport const LocaleStorageClient = (options: LocaleStorageClientOptions) => ({\n  getLocale: () => getLocaleFromStorageClient(options),\n  setLocale: (locale: LocalesValues) =>\n    setLocaleInStorageClient(locale, options),\n});\n\n// ============================================================================\n// Server-specific types and functions\n// (cookies via injected getter/setter, headers — no localStorage/sessionStorage)\n// ============================================================================\n\nexport type LocaleStorageServerOptions = {\n  overwrite?: boolean;\n  isCookieEnabled?: boolean;\n  setCookieStore?: (\n    name: string,\n    value: string,\n    cookie: CookieBuildAttributes\n  ) => void;\n  setCookieString?: (name: string, cookie: string) => void;\n  getCookie?: (name: string) => string | undefined | null;\n  getHeader?: (name: string) => string | undefined | null;\n  setHeader?: (name: string, value: string) => void;\n};\n\n/**\n * Retrieves the locale from server-side storage mechanisms (cookies, headers).\n * Does not access localStorage or sessionStorage.\n * No browser cookie fallback — the caller must provide `getCookie`.\n */\nexport const getLocaleFromStorageServer = (\n  options: LocaleStorageServerOptions\n): Locale | undefined => {\n  const { locales } = internationalization;\n  const storageAttributes = routing.storage;\n\n  if (options?.isCookieEnabled === false) return undefined;\n\n  const isValidLocale = (value: string | null | undefined): value is Locale =>\n    !!value && locales.includes(value as Locale);\n\n  if (!TREE_SHAKE_STORAGE_COOKIES && storageAttributes.cookies) {\n    for (let i = 0; i < storageAttributes.cookies.length; i++) {\n      try {\n        const value = options?.getCookie?.(storageAttributes.cookies[i].name);\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_HEADERS && storageAttributes.headers) {\n    for (let i = 0; i < storageAttributes.headers.length; i++) {\n      try {\n        const value = options?.getHeader?.(storageAttributes.headers[i].name);\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n};\n\n/**\n * Stores the locale in server-side storage mechanisms (cookies, headers).\n * Does not write to localStorage or sessionStorage.\n */\nexport const setLocaleInStorageServer = (\n  locale: LocalesValues,\n  options?: LocaleStorageServerOptions\n): void => {\n  const storageAttributes = routing.storage;\n\n  if (options?.isCookieEnabled === false) return;\n\n  if (!TREE_SHAKE_STORAGE_COOKIES && storageAttributes.cookies) {\n    for (let i = 0; i < storageAttributes.cookies.length; i++) {\n      const { name, attributes } = storageAttributes.cookies[i];\n\n      try {\n        if (options?.setCookieStore) {\n          options.setCookieStore(name, locale, {\n            ...attributes,\n            expires:\n              attributes.expires instanceof Date\n                ? attributes.expires.getTime()\n                : attributes.expires,\n          });\n        }\n      } catch {\n        try {\n          if (options?.setCookieString) {\n            options.setCookieString(\n              name,\n              buildCookieString(name, locale, attributes)\n            );\n          }\n        } catch {}\n      }\n    }\n  }\n\n  if (\n    !TREE_SHAKE_STORAGE_HEADERS &&\n    storageAttributes.headers &&\n    options?.setHeader\n  ) {\n    for (let i = 0; i < storageAttributes.headers.length; i++) {\n      try {\n        options.setHeader(storageAttributes.headers[i].name, locale);\n      } catch {}\n    }\n  }\n};\n\n/**\n * Server-side locale storage utility.\n * Handles cookies (via injected getter/setter) and headers.\n * Does not access localStorage or sessionStorage.\n *\n * @example\n * ```ts\n * const storage = LocaleStorageServer({\n *   getCookie: (name) => req.cookies[name],\n *   setCookieStore: (name, value, attrs) => res.cookie(name, value, attrs),\n *   getHeader: (name) => req.headers[name],\n *   setHeader: (name, value) => res.setHeader(name, value),\n * });\n * const locale = storage.getLocale();\n * storage.setLocale('fr');\n * ```\n */\nexport const LocaleStorageServer = (options: LocaleStorageServerOptions) => ({\n  getLocale: () => getLocaleFromStorageServer(options),\n  setLocale: (locale: LocalesValues) =>\n    setLocaleInStorageServer(locale, options),\n});\n\n// ============================================================================\n// Deprecated: combined LocaleStorage\n// Use LocaleStorageClient or LocaleStorageServer instead\n// ============================================================================\n\n/**\n * @deprecated Use {@link LocaleStorageClientOptions} or {@link LocaleStorageServerOptions} instead.\n */\nexport type LocaleStorageOptions = LocaleStorageClientOptions &\n  LocaleStorageServerOptions;\n\n/**\n * Retrieves the locale from all storage mechanisms\n * (cookies, localStorage, sessionStorage, headers).\n *\n * @deprecated Use {@link getLocaleFromStorageClient} (browser) or\n * {@link getLocaleFromStorageServer} (server) instead.\n */\nexport const getLocaleFromStorage = (\n  options: Pick<\n    LocaleStorageOptions,\n    | 'getCookie'\n    | 'getSessionStorage'\n    | 'getLocaleStorage'\n    | 'getHeader'\n    | 'isCookieEnabled'\n  >\n): Locale | undefined => {\n  const { locales } = internationalization;\n  const storageAttributes = routing.storage;\n\n  if (options?.isCookieEnabled === false) return undefined;\n\n  const isValidLocale = (value: string | null | undefined): value is Locale =>\n    !!value && locales.includes(value as Locale);\n\n  const readCookie = (name: string): string | undefined => {\n    try {\n      const fromOption = options?.getCookie?.(name);\n      if (fromOption !== null && fromOption !== undefined) return fromOption;\n    } catch {}\n    // Browser fallback kept for backward compatibility\n    return getCookie(name);\n  };\n\n  if (!TREE_SHAKE_STORAGE_COOKIES && storageAttributes.cookies) {\n    for (let i = 0; i < storageAttributes.cookies.length; i++) {\n      const value = readCookie(storageAttributes.cookies[i].name);\n      if (isValidLocale(value)) return value;\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_LOCAL_STORAGE && storageAttributes.localStorage) {\n    for (let i = 0; i < storageAttributes.localStorage.length; i++) {\n      try {\n        const value = options?.getLocaleStorage?.(\n          storageAttributes.localStorage[i].name\n        );\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_SESSION_STORAGE && storageAttributes.sessionStorage) {\n    for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {\n      try {\n        const value = options?.getSessionStorage?.(\n          storageAttributes.sessionStorage[i].name\n        );\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_HEADERS && storageAttributes.headers) {\n    for (let i = 0; i < storageAttributes.headers.length; i++) {\n      try {\n        const value = options?.getHeader?.(storageAttributes.headers[i].name);\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n};\n\n/**\n * Stores the locale in all configured storage mechanisms\n * (cookies, localStorage, sessionStorage, headers).\n *\n * @deprecated Use {@link setLocaleInStorageClient} (browser) or\n * {@link setLocaleInStorageServer} (server) instead.\n */\nexport const setLocaleInStorage = (\n  locale: LocalesValues,\n  options?: LocaleStorageOptions\n): void => {\n  const storageAttributes = routing.storage;\n\n  if (options?.isCookieEnabled === false) return;\n\n  if (!TREE_SHAKE_STORAGE_COOKIES && storageAttributes.cookies) {\n    for (let i = 0; i < storageAttributes.cookies.length; i++) {\n      const { name, attributes } = storageAttributes.cookies[i];\n      try {\n        if (options?.setCookieStore) {\n          options.setCookieStore(name, locale, {\n            ...attributes,\n            expires:\n              attributes.expires instanceof Date\n                ? attributes.expires.getTime()\n                : attributes.expires,\n          });\n        }\n      } catch {\n        try {\n          if (options?.setCookieString) {\n            options.setCookieString(\n              name,\n              buildCookieString(name, locale, attributes)\n            );\n          }\n        } catch {}\n      }\n    }\n  }\n\n  if (\n    !TREE_SHAKE_STORAGE_LOCAL_STORAGE &&\n    storageAttributes.localStorage &&\n    options?.setLocaleStorage\n  ) {\n    for (let i = 0; i < storageAttributes.localStorage.length; i++) {\n      const { name } = storageAttributes.localStorage[i];\n      try {\n        if (!(options?.overwrite ?? true) && options?.getLocaleStorage) {\n          if (options.getLocaleStorage(name)) continue;\n        }\n        options.setLocaleStorage(name, locale);\n      } catch {}\n    }\n  }\n\n  if (\n    !TREE_SHAKE_STORAGE_SESSION_STORAGE &&\n    storageAttributes.sessionStorage &&\n    options?.setSessionStorage\n  ) {\n    for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {\n      const { name } = storageAttributes.sessionStorage[i];\n      try {\n        if (!(options?.overwrite ?? true) && options?.getSessionStorage) {\n          if (options.getSessionStorage(name)) continue;\n        }\n        options.setSessionStorage(name, locale);\n      } catch {}\n    }\n  }\n\n  if (\n    !TREE_SHAKE_STORAGE_HEADERS &&\n    storageAttributes.headers &&\n    options?.setHeader\n  ) {\n    for (let i = 0; i < storageAttributes.headers.length; i++) {\n      try {\n        options.setHeader(storageAttributes.headers[i].name, locale);\n      } catch {}\n    }\n  }\n};\n\n/**\n * Utility object to get and set the locale in storage based on configuration.\n *\n * @deprecated Use {@link LocaleStorageClient} (browser) or\n * {@link LocaleStorageServer} (server) instead.\n */\nexport const LocaleStorage = (options: LocaleStorageOptions) => ({\n  getLocale: () => getLocaleFromStorage(options),\n  setLocale: (locale: LocalesValues) => setLocaleInStorage(locale, options),\n});\n"],"mappings":"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"}

package/dist/esm/deepTransformPlugins/getFilterMissingTranslationsContent.mjs

@@ -2,7 +2,7 @@ import { deepTransformNode } from "../interpreter/getContent/deepTransform.mjs";
 import { getTranslation } from "../interpreter/getTranslation.mjs";
 import { t as translation } from "../transpiler/translation/translation.mjs";
 import * as NodeTypes from "@intlayer/types/nodeType";
-import configuration from "@intlayer/config/built";
+import { internationalization } from "@intlayer/config/built";
 
 //#region src/deepTransformPlugins/getFilterMissingTranslationsContent.ts
 /**
@@ -114,7 +114,7 @@ const filterMissingTranslationsOnlyPlugin = (localeToCheck) => ({
 					plugins: [...(props.plugins ?? []).filter((plugin) => plugin.id !== "filter-missing-translations-only-plugin")]
 				});
 			}
-			const baseLocale = configuration?.internationalization?.defaultLocale;
+			const baseLocale = internationalization?.defaultLocale;
 			const availableLocales = Object.keys(result);
 			if (availableLocales.length === 0) return;
 			const fallbackLocale = availableLocales.includes(baseLocale) ? baseLocale : availableLocales[0];

package/dist/esm/deepTransformPlugins/getFilterMissingTranslationsContent.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"getFilterMissingTranslationsContent.mjs","names":["tCore"],"sources":["../../../src/deepTransformPlugins/getFilterMissingTranslationsContent.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { ContentNode, Dictionary } from '@intlayer/types/dictionary';\nimport type { KeyPath } from '@intlayer/types/keyPath';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport * as NodeTypes from '@intlayer/types/nodeType';\nimport {\n  type DeepTransformContent,\n  getTranslation,\n  type NodeProps,\n  type Plugins,\n} from '../interpreter';\nimport { deepTransformNode } from '../interpreter/getContent/deepTransform';\nimport { type TranslationContent, t as tCore } from '../transpiler';\n\n/**\n * Helper function to check if a node or its children contain translation nodes\n */\nconst hasTranslationNodes = (node: any): boolean => {\n  if (typeof node !== 'object' || node === null) {\n    return false;\n  }\n\n  if (node?.nodeType === NodeTypes.TRANSLATION) {\n    return true;\n  }\n\n  if (Array.isArray(node)) {\n    return node.some(hasTranslationNodes);\n  }\n\n  return Object.values(node).some(hasTranslationNodes);\n};\n\n/**\n * Get all keys from an object, recursively\n */\nconst getObjectKeys = (obj: any): Set<string> => {\n  const keys = new Set<string>();\n\n  if (typeof obj !== 'object' || obj === null) {\n    return keys;\n  }\n\n  for (const key in obj) {\n    keys.add(key);\n  }\n\n  return keys;\n};\n\n/**\n * Check if two objects have the same structure (same keys)\n */\nconst hasSameStructure = (obj1: any, obj2: any): boolean => {\n  if (typeof obj1 !== 'object' || typeof obj2 !== 'object') {\n    return typeof obj1 === typeof obj2;\n  }\n\n  if (obj1 === null || obj2 === null) {\n    return obj1 === obj2;\n  }\n\n  if (Array.isArray(obj1) !== Array.isArray(obj2)) {\n    return false;\n  }\n\n  const keys1 = getObjectKeys(obj1);\n  const keys2 = getObjectKeys(obj2);\n\n  if (keys1.size !== keys2.size) {\n    return false;\n  }\n\n  for (const key of keys1) {\n    if (!keys2.has(key)) {\n      return false;\n    }\n  }\n\n  return true;\n};\n\n/**\n * Check if all locales in a translation node have the same structure (recursively)\n * Returns an object with locales that have missing keys\n */\nconst checkTranslationStructureConsistency = (\n  translationNode: Record<string, any>\n): { hasInconsistency: boolean; localesWithMissingKeys: Set<string> } => {\n  const locales = Object.keys(translationNode);\n  const localesWithMissingKeys = new Set<string>();\n\n  if (locales.length <= 1) {\n    return { hasInconsistency: false, localesWithMissingKeys };\n  }\n\n  // Helper function to check structure recursively\n  const checkStructureRecursive = (\n    path: string,\n    localeValues: Map<string, any>\n  ): Set<string> => {\n    const localesWithIssues = new Set<string>();\n\n    // Get all unique keys across all locale values at this path\n    const allKeys = new Set<string>();\n    const objectLocales = new Map<string, any>();\n\n    for (const [locale, value] of localeValues.entries()) {\n      if (\n        typeof value === 'object' &&\n        value !== null &&\n        !Array.isArray(value)\n      ) {\n        objectLocales.set(locale, value);\n        const keys = getObjectKeys(value);\n        for (const key of keys) {\n          allKeys.add(key);\n        }\n      }\n    }\n\n    // If no objects at this level, no inconsistency\n    if (objectLocales.size === 0) {\n      return localesWithIssues;\n    }\n\n    // Check if each locale has all the keys at this level\n    for (const [locale, value] of objectLocales.entries()) {\n      const keys = getObjectKeys(value);\n      if (keys.size !== allKeys.size) {\n        localesWithIssues.add(locale);\n      }\n    }\n\n    // Recursively check nested objects\n    for (const key of allKeys) {\n      const nestedValues = new Map<string, any>();\n      for (const [locale, value] of objectLocales.entries()) {\n        if (value[key] !== undefined) {\n          nestedValues.set(locale, value[key]);\n        }\n      }\n\n      if (nestedValues.size > 1) {\n        const nestedIssues = checkStructureRecursive(\n          path ? `${path}.${key}` : key,\n          nestedValues\n        );\n        for (const locale of nestedIssues) {\n          localesWithIssues.add(locale);\n        }\n      }\n    }\n\n    return localesWithIssues;\n  };\n\n  // Start recursive check from root\n  const rootValues = new Map<string, any>();\n  for (const locale of locales) {\n    rootValues.set(locale, translationNode[locale]);\n  }\n\n  const issuesFound = checkStructureRecursive('', rootValues);\n  const hasInconsistency = issuesFound.size > 0;\n\n  for (const locale of issuesFound) {\n    localesWithMissingKeys.add(locale);\n  }\n\n  return { hasInconsistency, localesWithMissingKeys };\n};\n\n/**\n * Check if array elements have consistent structures\n */\nconst checkArrayStructureConsistency = (arr: any[]): boolean => {\n  if (arr.length <= 1) {\n    return true;\n  }\n\n  const firstElement = arr[0];\n\n  for (let i = 1; i < arr.length; i++) {\n    if (!hasSameStructure(firstElement, arr[i])) {\n      return false;\n    }\n  }\n\n  return true;\n};\n\n/** Translation plugin. Replaces node with a locale string if nodeType = Translation. */\nexport const filterMissingTranslationsOnlyPlugin = (\n  localeToCheck: LocalesValues\n): Plugins => ({\n  id: 'filter-missing-translations-only-plugin',\n  canHandle: (node: ContentNode) => {\n    // Only handle objects and arrays, not primitives\n    return typeof node === 'object' && node !== null;\n  },\n  transform: (node: ContentNode, props, deepTransformNode) => {\n    if (typeof node === 'object' && node?.nodeType === NodeTypes.TRANSLATION) {\n      const result = structuredClone(\n        (node as TranslationContent)[NodeTypes.TRANSLATION]\n      );\n\n      const hasLocaleTranslation = Object.keys(result).includes(localeToCheck);\n\n      // Check for structural inconsistencies across locales\n      const { hasInconsistency, localesWithMissingKeys } =\n        checkTranslationStructureConsistency(result);\n\n      // If there's a structural inconsistency and the locale being checked\n      // has missing keys, treat it as a missing translation\n      const hasStructuralIssue =\n        hasInconsistency && localesWithMissingKeys.has(localeToCheck);\n\n      if (hasLocaleTranslation && !hasStructuralIssue) {\n        return undefined; // Return undefined to remove the node\n      }\n\n      // Transform nested content\n      for (const key in result) {\n        const childProps = {\n          ...props,\n          children: result[key as unknown as keyof typeof result],\n          keyPath: [\n            ...props.keyPath,\n            { type: NodeTypes.TRANSLATION, key } as KeyPath,\n          ],\n        };\n        result[key as unknown as keyof typeof result] = deepTransformNode(\n          result[key as unknown as keyof typeof result],\n          {\n            ...childProps,\n            plugins: [\n              ...(props.plugins ?? ([] as Plugins[])).filter(\n                (plugin) =>\n                  plugin.id !== 'filter-missing-translations-only-plugin'\n              ),\n            ],\n          }\n        );\n      }\n\n      // Return the base locale content as a translation node\n      // If base locale is missing, use any available locale as fallback\n      const baseLocale = configuration?.internationalization?.defaultLocale;\n      const availableLocales = Object.keys(result);\n\n      if (availableLocales.length === 0) {\n        return undefined; // No translations available\n      }\n\n      // Try to get the base locale first, then any available locale as fallback\n      const fallbackLocale = availableLocales.includes(baseLocale)\n        ? baseLocale\n        : availableLocales[0];\n\n      const fallbackValue = getTranslation(result, baseLocale, fallbackLocale);\n\n      // Return the translation node structure with only the fallback locale\n      return tCore({ [fallbackLocale]: fallbackValue });\n    } else if (\n      typeof node === 'object' &&\n      node !== null &&\n      !Array.isArray(node) &&\n      !node?.nodeType\n    ) {\n      // For regular objects, include only children that are related to translations\n      // - Keep children that contain translation nodes (directly or nested)\n      // - Keep arrays (they may mix translated and non-translated values)\n      // - Exclude primitive values (string/number/boolean/null/undefined) at object level\n      const result: Record<string, any> = {};\n      let hasMissingTranslations = false;\n      const arrayKeysIncluded: string[] = [];\n      const primitiveSiblingsToAppend: any[] = [];\n\n      for (const key in node as any) {\n        const originalChild = (node as any)[key];\n        const childProps = {\n          ...props,\n          children: originalChild,\n          keyPath: [\n            ...props.keyPath,\n            { type: NodeTypes.OBJECT, key } as KeyPath,\n          ],\n        };\n        const transformedChild = deepTransformNode(originalChild, childProps);\n\n        const isPrimitiveSibling =\n          originalChild === null ||\n          (typeof originalChild !== 'object' &&\n            typeof originalChild !== 'function');\n\n        if (isPrimitiveSibling) {\n          // Defer primitives; they may be appended to an array sibling later\n          if (originalChild !== undefined) {\n            primitiveSiblingsToAppend.push(originalChild);\n          }\n          continue;\n        }\n\n        const includeChild =\n          transformedChild !== undefined &&\n          (hasTranslationNodes(originalChild) || Array.isArray(originalChild));\n\n        if (includeChild) {\n          result[key] = transformedChild;\n          hasMissingTranslations = true;\n          if (Array.isArray(transformedChild)) {\n            arrayKeysIncluded.push(key);\n          }\n        }\n      }\n\n      // If any array child is present, append primitive siblings into the first array\n      if (\n        arrayKeysIncluded.length > 0 &&\n        primitiveSiblingsToAppend.length > 0\n      ) {\n        const targetArrayKey = arrayKeysIncluded[0];\n        // Ensure array exists in result (it should, but be defensive)\n        if (Array.isArray(result[targetArrayKey])) {\n          result[targetArrayKey] = [\n            ...result[targetArrayKey],\n            ...primitiveSiblingsToAppend,\n          ];\n          hasMissingTranslations = true;\n        }\n      }\n\n      // Only return the object if it has missing translations-related content\n      return hasMissingTranslations ? result : undefined;\n    } else if (Array.isArray(node)) {\n      // Check if array elements have consistent structures\n      const hasConsistentStructure = checkArrayStructureConsistency(node);\n\n      // For arrays, only include items that have missing translations\n      const result = node\n        .map((child, index) => {\n          const childProps = {\n            ...props,\n            children: child,\n            keyPath: [\n              ...props.keyPath,\n              { type: NodeTypes.ARRAY, key: index } as KeyPath,\n            ],\n          };\n          return deepTransformNode(child, childProps);\n        })\n        .filter((item) => item !== null && item !== undefined);\n\n      // If there's structural inconsistency in the array, include it\n      // even if it has no missing translations, to flag the issue\n      if (!hasConsistentStructure && result.length === 0) {\n        // Return a marker to indicate structural inconsistency\n        return node; // Return original array to show the issue\n      }\n\n      // Only return the array if it has items with missing translations\n      return result.length > 0 ? result : undefined;\n    }\n\n    return node; // Return non-translation content as is\n  },\n});\n\n/**\n * For each translation node, it compare is both localeToCheck and baseLocale are present.\n *\n * If yes, it should remove the node from the content.\n * If no, it should keep the node\n *\n * In complete mode, for large dictionaries, we want to filter all content that is already translated\n *\n * locale: fr\n *\n * { test1: t({ ar: 'Hello', en: 'Hello', fr: 'Bonjour' } }) -> {}\n * { test2: t({ ar: 'Hello', en: 'Hello' }) } -> { test2: t({ ar: 'Hello', en: 'Hello' }) }\n *\n */\nexport const getFilterMissingTranslationsContent = <\n  T extends ContentNode,\n  L extends LocalesValues = DeclaredLocales,\n>(\n  node: T,\n  localeToCheck: L,\n  nodeProps: NodeProps\n) => {\n  const plugins: Plugins[] = [\n    filterMissingTranslationsOnlyPlugin(localeToCheck),\n    ...(nodeProps.plugins ?? []),\n  ];\n\n  const result = deepTransformNode(node, {\n    ...nodeProps,\n    plugins,\n  }) as DeepTransformContent<T>;\n\n  // Stringify the result to remove the undefined values\n  if (result === undefined) {\n    // No missing translations found\n    return {} as DeepTransformContent<T>;\n  }\n  return JSON.parse(JSON.stringify(result));\n};\n\nexport const getFilterMissingTranslationsDictionary = (\n  dictionary: Dictionary,\n  localeToCheck: LocalesValues\n) => ({\n  ...dictionary,\n  content: getFilterMissingTranslationsContent(\n    dictionary.content,\n    localeToCheck,\n    {\n      dictionaryKey: dictionary.key,\n      keyPath: [],\n      plugins: [],\n    }\n  ),\n});\n"],"mappings":"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"}
+{"version":3,"file":"getFilterMissingTranslationsContent.mjs","names":["tCore"],"sources":["../../../src/deepTransformPlugins/getFilterMissingTranslationsContent.ts"],"sourcesContent":["import { internationalization } from '@intlayer/config/built';\nimport type { ContentNode, Dictionary } from '@intlayer/types/dictionary';\nimport type { KeyPath } from '@intlayer/types/keyPath';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport * as NodeTypes from '@intlayer/types/nodeType';\nimport {\n  type DeepTransformContent,\n  getTranslation,\n  type NodeProps,\n  type Plugins,\n} from '../interpreter';\nimport { deepTransformNode } from '../interpreter/getContent/deepTransform';\nimport { type TranslationContent, t as tCore } from '../transpiler';\n\n/**\n * Helper function to check if a node or its children contain translation nodes\n */\nconst hasTranslationNodes = (node: any): boolean => {\n  if (typeof node !== 'object' || node === null) {\n    return false;\n  }\n\n  if (node?.nodeType === NodeTypes.TRANSLATION) {\n    return true;\n  }\n\n  if (Array.isArray(node)) {\n    return node.some(hasTranslationNodes);\n  }\n\n  return Object.values(node).some(hasTranslationNodes);\n};\n\n/**\n * Get all keys from an object, recursively\n */\nconst getObjectKeys = (obj: any): Set<string> => {\n  const keys = new Set<string>();\n\n  if (typeof obj !== 'object' || obj === null) {\n    return keys;\n  }\n\n  for (const key in obj) {\n    keys.add(key);\n  }\n\n  return keys;\n};\n\n/**\n * Check if two objects have the same structure (same keys)\n */\nconst hasSameStructure = (obj1: any, obj2: any): boolean => {\n  if (typeof obj1 !== 'object' || typeof obj2 !== 'object') {\n    return typeof obj1 === typeof obj2;\n  }\n\n  if (obj1 === null || obj2 === null) {\n    return obj1 === obj2;\n  }\n\n  if (Array.isArray(obj1) !== Array.isArray(obj2)) {\n    return false;\n  }\n\n  const keys1 = getObjectKeys(obj1);\n  const keys2 = getObjectKeys(obj2);\n\n  if (keys1.size !== keys2.size) {\n    return false;\n  }\n\n  for (const key of keys1) {\n    if (!keys2.has(key)) {\n      return false;\n    }\n  }\n\n  return true;\n};\n\n/**\n * Check if all locales in a translation node have the same structure (recursively)\n * Returns an object with locales that have missing keys\n */\nconst checkTranslationStructureConsistency = (\n  translationNode: Record<string, any>\n): { hasInconsistency: boolean; localesWithMissingKeys: Set<string> } => {\n  const locales = Object.keys(translationNode);\n  const localesWithMissingKeys = new Set<string>();\n\n  if (locales.length <= 1) {\n    return { hasInconsistency: false, localesWithMissingKeys };\n  }\n\n  // Helper function to check structure recursively\n  const checkStructureRecursive = (\n    path: string,\n    localeValues: Map<string, any>\n  ): Set<string> => {\n    const localesWithIssues = new Set<string>();\n\n    // Get all unique keys across all locale values at this path\n    const allKeys = new Set<string>();\n    const objectLocales = new Map<string, any>();\n\n    for (const [locale, value] of localeValues.entries()) {\n      if (\n        typeof value === 'object' &&\n        value !== null &&\n        !Array.isArray(value)\n      ) {\n        objectLocales.set(locale, value);\n        const keys = getObjectKeys(value);\n        for (const key of keys) {\n          allKeys.add(key);\n        }\n      }\n    }\n\n    // If no objects at this level, no inconsistency\n    if (objectLocales.size === 0) {\n      return localesWithIssues;\n    }\n\n    // Check if each locale has all the keys at this level\n    for (const [locale, value] of objectLocales.entries()) {\n      const keys = getObjectKeys(value);\n      if (keys.size !== allKeys.size) {\n        localesWithIssues.add(locale);\n      }\n    }\n\n    // Recursively check nested objects\n    for (const key of allKeys) {\n      const nestedValues = new Map<string, any>();\n      for (const [locale, value] of objectLocales.entries()) {\n        if (value[key] !== undefined) {\n          nestedValues.set(locale, value[key]);\n        }\n      }\n\n      if (nestedValues.size > 1) {\n        const nestedIssues = checkStructureRecursive(\n          path ? `${path}.${key}` : key,\n          nestedValues\n        );\n        for (const locale of nestedIssues) {\n          localesWithIssues.add(locale);\n        }\n      }\n    }\n\n    return localesWithIssues;\n  };\n\n  // Start recursive check from root\n  const rootValues = new Map<string, any>();\n  for (const locale of locales) {\n    rootValues.set(locale, translationNode[locale]);\n  }\n\n  const issuesFound = checkStructureRecursive('', rootValues);\n  const hasInconsistency = issuesFound.size > 0;\n\n  for (const locale of issuesFound) {\n    localesWithMissingKeys.add(locale);\n  }\n\n  return { hasInconsistency, localesWithMissingKeys };\n};\n\n/**\n * Check if array elements have consistent structures\n */\nconst checkArrayStructureConsistency = (arr: any[]): boolean => {\n  if (arr.length <= 1) {\n    return true;\n  }\n\n  const firstElement = arr[0];\n\n  for (let i = 1; i < arr.length; i++) {\n    if (!hasSameStructure(firstElement, arr[i])) {\n      return false;\n    }\n  }\n\n  return true;\n};\n\n/** Translation plugin. Replaces node with a locale string if nodeType = Translation. */\nexport const filterMissingTranslationsOnlyPlugin = (\n  localeToCheck: LocalesValues\n): Plugins => ({\n  id: 'filter-missing-translations-only-plugin',\n  canHandle: (node: ContentNode) => {\n    // Only handle objects and arrays, not primitives\n    return typeof node === 'object' && node !== null;\n  },\n  transform: (node: ContentNode, props, deepTransformNode) => {\n    if (typeof node === 'object' && node?.nodeType === NodeTypes.TRANSLATION) {\n      const result = structuredClone(\n        (node as TranslationContent)[NodeTypes.TRANSLATION]\n      );\n\n      const hasLocaleTranslation = Object.keys(result).includes(localeToCheck);\n\n      // Check for structural inconsistencies across locales\n      const { hasInconsistency, localesWithMissingKeys } =\n        checkTranslationStructureConsistency(result);\n\n      // If there's a structural inconsistency and the locale being checked\n      // has missing keys, treat it as a missing translation\n      const hasStructuralIssue =\n        hasInconsistency && localesWithMissingKeys.has(localeToCheck);\n\n      if (hasLocaleTranslation && !hasStructuralIssue) {\n        return undefined; // Return undefined to remove the node\n      }\n\n      // Transform nested content\n      for (const key in result) {\n        const childProps = {\n          ...props,\n          children: result[key as unknown as keyof typeof result],\n          keyPath: [\n            ...props.keyPath,\n            { type: NodeTypes.TRANSLATION, key } as KeyPath,\n          ],\n        };\n        result[key as unknown as keyof typeof result] = deepTransformNode(\n          result[key as unknown as keyof typeof result],\n          {\n            ...childProps,\n            plugins: [\n              ...(props.plugins ?? ([] as Plugins[])).filter(\n                (plugin) =>\n                  plugin.id !== 'filter-missing-translations-only-plugin'\n              ),\n            ],\n          }\n        );\n      }\n\n      // Return the base locale content as a translation node\n      // If base locale is missing, use any available locale as fallback\n      const baseLocale = internationalization?.defaultLocale;\n\n      const availableLocales = Object.keys(result);\n\n      if (availableLocales.length === 0) {\n        return undefined; // No translations available\n      }\n\n      // Try to get the base locale first, then any available locale as fallback\n      const fallbackLocale = availableLocales.includes(baseLocale)\n        ? baseLocale\n        : availableLocales[0];\n\n      const fallbackValue = getTranslation(result, baseLocale, fallbackLocale);\n\n      // Return the translation node structure with only the fallback locale\n      return tCore({ [fallbackLocale]: fallbackValue });\n    } else if (\n      typeof node === 'object' &&\n      node !== null &&\n      !Array.isArray(node) &&\n      !node?.nodeType\n    ) {\n      // For regular objects, include only children that are related to translations\n      // - Keep children that contain translation nodes (directly or nested)\n      // - Keep arrays (they may mix translated and non-translated values)\n      // - Exclude primitive values (string/number/boolean/null/undefined) at object level\n      const result: Record<string, any> = {};\n      let hasMissingTranslations = false;\n      const arrayKeysIncluded: string[] = [];\n      const primitiveSiblingsToAppend: any[] = [];\n\n      for (const key in node as any) {\n        const originalChild = (node as any)[key];\n        const childProps = {\n          ...props,\n          children: originalChild,\n          keyPath: [\n            ...props.keyPath,\n            { type: NodeTypes.OBJECT, key } as KeyPath,\n          ],\n        };\n        const transformedChild = deepTransformNode(originalChild, childProps);\n\n        const isPrimitiveSibling =\n          originalChild === null ||\n          (typeof originalChild !== 'object' &&\n            typeof originalChild !== 'function');\n\n        if (isPrimitiveSibling) {\n          // Defer primitives; they may be appended to an array sibling later\n          if (originalChild !== undefined) {\n            primitiveSiblingsToAppend.push(originalChild);\n          }\n          continue;\n        }\n\n        const includeChild =\n          transformedChild !== undefined &&\n          (hasTranslationNodes(originalChild) || Array.isArray(originalChild));\n\n        if (includeChild) {\n          result[key] = transformedChild;\n          hasMissingTranslations = true;\n          if (Array.isArray(transformedChild)) {\n            arrayKeysIncluded.push(key);\n          }\n        }\n      }\n\n      // If any array child is present, append primitive siblings into the first array\n      if (\n        arrayKeysIncluded.length > 0 &&\n        primitiveSiblingsToAppend.length > 0\n      ) {\n        const targetArrayKey = arrayKeysIncluded[0];\n        // Ensure array exists in result (it should, but be defensive)\n        if (Array.isArray(result[targetArrayKey])) {\n          result[targetArrayKey] = [\n            ...result[targetArrayKey],\n            ...primitiveSiblingsToAppend,\n          ];\n          hasMissingTranslations = true;\n        }\n      }\n\n      // Only return the object if it has missing translations-related content\n      return hasMissingTranslations ? result : undefined;\n    } else if (Array.isArray(node)) {\n      // Check if array elements have consistent structures\n      const hasConsistentStructure = checkArrayStructureConsistency(node);\n\n      // For arrays, only include items that have missing translations\n      const result = node\n        .map((child, index) => {\n          const childProps = {\n            ...props,\n            children: child,\n            keyPath: [\n              ...props.keyPath,\n              { type: NodeTypes.ARRAY, key: index } as KeyPath,\n            ],\n          };\n          return deepTransformNode(child, childProps);\n        })\n        .filter((item) => item !== null && item !== undefined);\n\n      // If there's structural inconsistency in the array, include it\n      // even if it has no missing translations, to flag the issue\n      if (!hasConsistentStructure && result.length === 0) {\n        // Return a marker to indicate structural inconsistency\n        return node; // Return original array to show the issue\n      }\n\n      // Only return the array if it has items with missing translations\n      return result.length > 0 ? result : undefined;\n    }\n\n    return node; // Return non-translation content as is\n  },\n});\n\n/**\n * For each translation node, it compare is both localeToCheck and baseLocale are present.\n *\n * If yes, it should remove the node from the content.\n * If no, it should keep the node\n *\n * In complete mode, for large dictionaries, we want to filter all content that is already translated\n *\n * locale: fr\n *\n * { test1: t({ ar: 'Hello', en: 'Hello', fr: 'Bonjour' } }) -> {}\n * { test2: t({ ar: 'Hello', en: 'Hello' }) } -> { test2: t({ ar: 'Hello', en: 'Hello' }) }\n *\n */\nexport const getFilterMissingTranslationsContent = <\n  T extends ContentNode,\n  L extends LocalesValues = DeclaredLocales,\n>(\n  node: T,\n  localeToCheck: L,\n  nodeProps: NodeProps\n) => {\n  const plugins: Plugins[] = [\n    filterMissingTranslationsOnlyPlugin(localeToCheck),\n    ...(nodeProps.plugins ?? []),\n  ];\n\n  const result = deepTransformNode(node, {\n    ...nodeProps,\n    plugins,\n  }) as DeepTransformContent<T>;\n\n  // Stringify the result to remove the undefined values\n  if (result === undefined) {\n    // No missing translations found\n    return {} as DeepTransformContent<T>;\n  }\n  return JSON.parse(JSON.stringify(result));\n};\n\nexport const getFilterMissingTranslationsDictionary = (\n  dictionary: Dictionary,\n  localeToCheck: LocalesValues\n) => ({\n  ...dictionary,\n  content: getFilterMissingTranslationsContent(\n    dictionary.content,\n    localeToCheck,\n    {\n      dictionaryKey: dictionary.key,\n      keyPath: [],\n      plugins: [],\n    }\n  ),\n});\n"],"mappings":"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"}

package/dist/esm/deepTransformPlugins/getFilterTranslationsOnlyContent.mjs

@@ -1,7 +1,7 @@
 import { deepTransformNode } from "../interpreter/getContent/deepTransform.mjs";
 import { getTranslation } from "../interpreter/getTranslation.mjs";
 import * as NodeTypes from "@intlayer/types/nodeType";
-import configuration from "@intlayer/config/built";
+import { internationalization } from "@intlayer/config/built";
 
 //#region src/deepTransformPlugins/getFilterTranslationsOnlyContent.ts
 /**
@@ -70,14 +70,14 @@ const filterTranslationsOnlyPlugin = (locale, fallback) => ({
 * @param node The node to transform.
 * @param locale The locale to use if your transformers need it (e.g. for translations).
 */
-const getFilterTranslationsOnlyContent = (node, locale = configuration?.internationalization?.defaultLocale, nodeProps, fallback) => {
+const getFilterTranslationsOnlyContent = (node, locale = internationalization?.defaultLocale, nodeProps, fallback) => {
 	const plugins = [filterTranslationsOnlyPlugin(locale, fallback), ...nodeProps.plugins ?? []];
 	return deepTransformNode(node, {
 		...nodeProps,
 		plugins
 	});
 };
-const getFilterTranslationsOnlyDictionary = (dictionary, locale = configuration?.internationalization?.defaultLocale, fallback) => ({
+const getFilterTranslationsOnlyDictionary = (dictionary, locale = internationalization?.defaultLocale, fallback) => ({
 	...dictionary,
 	content: getFilterTranslationsOnlyContent(dictionary.content, locale, {
 		dictionaryKey: dictionary.key,

package/dist/esm/deepTransformPlugins/getFilterTranslationsOnlyContent.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"getFilterTranslationsOnlyContent.mjs","names":[],"sources":["../../../src/deepTransformPlugins/getFilterTranslationsOnlyContent.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { ContentNode, Dictionary } from '@intlayer/types/dictionary';\nimport type { KeyPath } from '@intlayer/types/keyPath';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport * as NodeTypes from '@intlayer/types/nodeType';\nimport {\n  type DeepTransformContent,\n  getTranslation,\n  type NodeProps,\n  type Plugins,\n} from '../interpreter';\nimport { deepTransformNode } from '../interpreter/getContent/deepTransform';\nimport type { TranslationContent } from '../transpiler';\n\n/**\n * Helper function to check if a node or its children contain translation nodes\n */\nconst hasTranslationNodes = (node: any): boolean => {\n  if (typeof node !== 'object' || node === null) {\n    return false;\n  }\n\n  if (node?.nodeType === NodeTypes.TRANSLATION) {\n    return true;\n  }\n\n  if (Array.isArray(node)) {\n    return node.some(hasTranslationNodes);\n  }\n\n  return Object.values(node).some(hasTranslationNodes);\n};\n\n/** Translation plugin. Replaces node with a locale string if nodeType = Translation. */\nexport const filterTranslationsOnlyPlugin = (\n  locale: LocalesValues,\n  fallback?: LocalesValues\n): Plugins => ({\n  id: 'filter-translations-only-plugin',\n  canHandle: (node: ContentNode) => {\n    // Only handle objects and arrays, not primitives\n    return typeof node === 'object' && node !== null;\n  },\n  transform: (node: ContentNode, props, deepTransformNode) => {\n    if (typeof node === 'object' && node?.nodeType === NodeTypes.TRANSLATION) {\n      const result = structuredClone(\n        (node as TranslationContent)[NodeTypes.TRANSLATION]\n      );\n\n      for (const key in result) {\n        const childProps = {\n          ...props,\n          children: result[key as unknown as keyof typeof result],\n          keyPath: [\n            ...props.keyPath,\n            { type: NodeTypes.TRANSLATION, key } as KeyPath,\n          ],\n        };\n        result[key as unknown as keyof typeof result] = deepTransformNode(\n          result[key as unknown as keyof typeof result],\n          {\n            ...childProps,\n            plugins: [\n              ...(props.plugins ?? ([] as Plugins[])).filter(\n                (plugin) => plugin.id !== 'filter-translations-only-plugin'\n              ),\n            ],\n          }\n        );\n      }\n      return getTranslation(result, locale, fallback);\n    } else if (\n      typeof node === 'object' &&\n      node !== null &&\n      !Array.isArray(node) &&\n      !node?.nodeType\n    ) {\n      // For regular objects, filter out properties that don't contain translations\n      const result: Record<string, any> = {};\n      for (const key in node as any) {\n        if (hasTranslationNodes(node[key as unknown as keyof typeof node])) {\n          const childProps = {\n            ...props,\n            children: node[key as unknown as keyof typeof node],\n            keyPath: [\n              ...props.keyPath,\n              { type: NodeTypes.OBJECT, key } as KeyPath,\n            ],\n          };\n          result[key] = deepTransformNode(\n            node[key as unknown as keyof typeof node],\n            childProps\n          );\n        }\n      }\n      return result;\n    } else if (Array.isArray(node)) {\n      // For arrays, keep all items but transform them\n      return node.map((child, index) => {\n        const childProps = {\n          ...props,\n          children: child,\n          keyPath: [\n            ...props.keyPath,\n            { type: NodeTypes.ARRAY, key: index } as KeyPath,\n          ],\n        };\n        return deepTransformNode(child, childProps);\n      });\n    }\n\n    return 'to remove from the object';\n  },\n});\n\n/**\n * Return the content of a node with only the translation plugin.\n *\n * @param node The node to transform.\n * @param locale The locale to use if your transformers need it (e.g. for translations).\n */\nexport const getFilterTranslationsOnlyContent = <\n  T extends ContentNode,\n  L extends LocalesValues = DeclaredLocales,\n>(\n  node: T,\n  locale: L = configuration?.internationalization?.defaultLocale as L,\n  nodeProps: NodeProps,\n  fallback?: LocalesValues\n) => {\n  const plugins: Plugins[] = [\n    filterTranslationsOnlyPlugin(locale, fallback),\n    ...(nodeProps.plugins ?? []),\n  ];\n\n  return deepTransformNode(node, {\n    ...nodeProps,\n    plugins,\n  }) as DeepTransformContent<T>;\n};\n\nexport const getFilterTranslationsOnlyDictionary = (\n  dictionary: Dictionary,\n  locale: LocalesValues = configuration?.internationalization\n    ?.defaultLocale as LocalesValues,\n  fallback?: LocalesValues\n) => ({\n  ...dictionary,\n  content: getFilterTranslationsOnlyContent(\n    dictionary.content,\n    locale,\n    { dictionaryKey: dictionary.key, keyPath: [] },\n    fallback\n  ),\n});\n"],"mappings":";;;;;;;;;AAoBA,MAAM,uBAAuB,SAAuB;AAClD,KAAI,OAAO,SAAS,YAAY,SAAS,KACvC,QAAO;AAGT,KAAI,MAAM,aAAa,UAAU,YAC/B,QAAO;AAGT,KAAI,MAAM,QAAQ,KAAK,CACrB,QAAO,KAAK,KAAK,oBAAoB;AAGvC,QAAO,OAAO,OAAO,KAAK,CAAC,KAAK,oBAAoB;;;AAItD,MAAa,gCACX,QACA,cACa;CACb,IAAI;CACJ,YAAY,SAAsB;AAEhC,SAAO,OAAO,SAAS,YAAY,SAAS;;CAE9C,YAAY,MAAmB,OAAO,sBAAsB;AAC1D,MAAI,OAAO,SAAS,YAAY,MAAM,aAAa,UAAU,aAAa;GACxE,MAAM,SAAS,gBACZ,KAA4B,UAAU,aACxC;AAED,QAAK,MAAM,OAAO,QAAQ;IACxB,MAAM,aAAa;KACjB,GAAG;KACH,UAAU,OAAO;KACjB,SAAS,CACP,GAAG,MAAM,SACT;MAAE,MAAM,UAAU;MAAa;MAAK,CACrC;KACF;AACD,WAAO,OAAyC,kBAC9C,OAAO,MACP;KACE,GAAG;KACH,SAAS,CACP,IAAI,MAAM,WAAY,EAAE,EAAgB,QACrC,WAAW,OAAO,OAAO,kCAC3B,CACF;KACF,CACF;;AAEH,UAAO,eAAe,QAAQ,QAAQ,SAAS;aAE/C,OAAO,SAAS,YAChB,SAAS,QACT,CAAC,MAAM,QAAQ,KAAK,IACpB,CAAC,MAAM,UACP;GAEA,MAAM,SAA8B,EAAE;AACtC,QAAK,MAAM,OAAO,KAChB,KAAI,oBAAoB,KAAK,KAAqC,EAAE;IAClE,MAAM,aAAa;KACjB,GAAG;KACH,UAAU,KAAK;KACf,SAAS,CACP,GAAG,MAAM,SACT;MAAE,MAAM,UAAU;MAAQ;MAAK,CAChC;KACF;AACD,WAAO,OAAO,kBACZ,KAAK,MACL,WACD;;AAGL,UAAO;aACE,MAAM,QAAQ,KAAK,CAE5B,QAAO,KAAK,KAAK,OAAO,UAAU;AAShC,UAAO,kBAAkB,OARN;IACjB,GAAG;IACH,UAAU;IACV,SAAS,CACP,GAAG,MAAM,SACT;KAAE,MAAM,UAAU;KAAO,KAAK;KAAO,CACtC;IACF,CAC0C;IAC3C;AAGJ,SAAO;;CAEV;;;;;;;AAQD,MAAa,oCAIX,MACA,SAAY,eAAe,sBAAsB,eACjD,WACA,aACG;CACH,MAAM,UAAqB,CACzB,6BAA6B,QAAQ,SAAS,EAC9C,GAAI,UAAU,WAAW,EAAE,CAC5B;AAED,QAAO,kBAAkB,MAAM;EAC7B,GAAG;EACH;EACD,CAAC;;AAGJ,MAAa,uCACX,YACA,SAAwB,eAAe,sBACnC,eACJ,cACI;CACJ,GAAG;CACH,SAAS,iCACP,WAAW,SACX,QACA;EAAE,eAAe,WAAW;EAAK,SAAS,EAAE;EAAE,EAC9C,SACD;CACF"}
+{"version":3,"file":"getFilterTranslationsOnlyContent.mjs","names":[],"sources":["../../../src/deepTransformPlugins/getFilterTranslationsOnlyContent.ts"],"sourcesContent":["import { internationalization } from '@intlayer/config/built';\nimport type { ContentNode, Dictionary } from '@intlayer/types/dictionary';\nimport type { KeyPath } from '@intlayer/types/keyPath';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport * as NodeTypes from '@intlayer/types/nodeType';\nimport {\n  type DeepTransformContent,\n  getTranslation,\n  type NodeProps,\n  type Plugins,\n} from '../interpreter';\nimport { deepTransformNode } from '../interpreter/getContent/deepTransform';\nimport type { TranslationContent } from '../transpiler';\n\n/**\n * Helper function to check if a node or its children contain translation nodes\n */\nconst hasTranslationNodes = (node: any): boolean => {\n  if (typeof node !== 'object' || node === null) {\n    return false;\n  }\n\n  if (node?.nodeType === NodeTypes.TRANSLATION) {\n    return true;\n  }\n\n  if (Array.isArray(node)) {\n    return node.some(hasTranslationNodes);\n  }\n\n  return Object.values(node).some(hasTranslationNodes);\n};\n\n/** Translation plugin. Replaces node with a locale string if nodeType = Translation. */\nexport const filterTranslationsOnlyPlugin = (\n  locale: LocalesValues,\n  fallback?: LocalesValues\n): Plugins => ({\n  id: 'filter-translations-only-plugin',\n  canHandle: (node: ContentNode) => {\n    // Only handle objects and arrays, not primitives\n    return typeof node === 'object' && node !== null;\n  },\n  transform: (node: ContentNode, props, deepTransformNode) => {\n    if (typeof node === 'object' && node?.nodeType === NodeTypes.TRANSLATION) {\n      const result = structuredClone(\n        (node as TranslationContent)[NodeTypes.TRANSLATION]\n      );\n\n      for (const key in result) {\n        const childProps = {\n          ...props,\n          children: result[key as unknown as keyof typeof result],\n          keyPath: [\n            ...props.keyPath,\n            { type: NodeTypes.TRANSLATION, key } as KeyPath,\n          ],\n        };\n        result[key as unknown as keyof typeof result] = deepTransformNode(\n          result[key as unknown as keyof typeof result],\n          {\n            ...childProps,\n            plugins: [\n              ...(props.plugins ?? ([] as Plugins[])).filter(\n                (plugin) => plugin.id !== 'filter-translations-only-plugin'\n              ),\n            ],\n          }\n        );\n      }\n      return getTranslation(result, locale, fallback);\n    } else if (\n      typeof node === 'object' &&\n      node !== null &&\n      !Array.isArray(node) &&\n      !node?.nodeType\n    ) {\n      // For regular objects, filter out properties that don't contain translations\n      const result: Record<string, any> = {};\n      for (const key in node as any) {\n        if (hasTranslationNodes(node[key as unknown as keyof typeof node])) {\n          const childProps = {\n            ...props,\n            children: node[key as unknown as keyof typeof node],\n            keyPath: [\n              ...props.keyPath,\n              { type: NodeTypes.OBJECT, key } as KeyPath,\n            ],\n          };\n          result[key] = deepTransformNode(\n            node[key as unknown as keyof typeof node],\n            childProps\n          );\n        }\n      }\n      return result;\n    } else if (Array.isArray(node)) {\n      // For arrays, keep all items but transform them\n      return node.map((child, index) => {\n        const childProps = {\n          ...props,\n          children: child,\n          keyPath: [\n            ...props.keyPath,\n            { type: NodeTypes.ARRAY, key: index } as KeyPath,\n          ],\n        };\n        return deepTransformNode(child, childProps);\n      });\n    }\n\n    return 'to remove from the object';\n  },\n});\n\n/**\n * Return the content of a node with only the translation plugin.\n *\n * @param node The node to transform.\n * @param locale The locale to use if your transformers need it (e.g. for translations).\n */\nexport const getFilterTranslationsOnlyContent = <\n  T extends ContentNode,\n  L extends LocalesValues = DeclaredLocales,\n>(\n  node: T,\n  locale: L = internationalization?.defaultLocale as L,\n\n  nodeProps: NodeProps,\n  fallback?: LocalesValues\n) => {\n  const plugins: Plugins[] = [\n    filterTranslationsOnlyPlugin(locale, fallback),\n    ...(nodeProps.plugins ?? []),\n  ];\n\n  return deepTransformNode(node, {\n    ...nodeProps,\n    plugins,\n  }) as DeepTransformContent<T>;\n};\n\nexport const getFilterTranslationsOnlyDictionary = (\n  dictionary: Dictionary,\n  locale: LocalesValues = internationalization?.defaultLocale as LocalesValues,\n\n  fallback?: LocalesValues\n) => ({\n  ...dictionary,\n  content: getFilterTranslationsOnlyContent(\n    dictionary.content,\n    locale,\n    { dictionaryKey: dictionary.key, keyPath: [] },\n    fallback\n  ),\n});\n"],"mappings":";;;;;;;;;AAoBA,MAAM,uBAAuB,SAAuB;AAClD,KAAI,OAAO,SAAS,YAAY,SAAS,KACvC,QAAO;AAGT,KAAI,MAAM,aAAa,UAAU,YAC/B,QAAO;AAGT,KAAI,MAAM,QAAQ,KAAK,CACrB,QAAO,KAAK,KAAK,oBAAoB;AAGvC,QAAO,OAAO,OAAO,KAAK,CAAC,KAAK,oBAAoB;;;AAItD,MAAa,gCACX,QACA,cACa;CACb,IAAI;CACJ,YAAY,SAAsB;AAEhC,SAAO,OAAO,SAAS,YAAY,SAAS;;CAE9C,YAAY,MAAmB,OAAO,sBAAsB;AAC1D,MAAI,OAAO,SAAS,YAAY,MAAM,aAAa,UAAU,aAAa;GACxE,MAAM,SAAS,gBACZ,KAA4B,UAAU,aACxC;AAED,QAAK,MAAM,OAAO,QAAQ;IACxB,MAAM,aAAa;KACjB,GAAG;KACH,UAAU,OAAO;KACjB,SAAS,CACP,GAAG,MAAM,SACT;MAAE,MAAM,UAAU;MAAa;MAAK,CACrC;KACF;AACD,WAAO,OAAyC,kBAC9C,OAAO,MACP;KACE,GAAG;KACH,SAAS,CACP,IAAI,MAAM,WAAY,EAAE,EAAgB,QACrC,WAAW,OAAO,OAAO,kCAC3B,CACF;KACF,CACF;;AAEH,UAAO,eAAe,QAAQ,QAAQ,SAAS;aAE/C,OAAO,SAAS,YAChB,SAAS,QACT,CAAC,MAAM,QAAQ,KAAK,IACpB,CAAC,MAAM,UACP;GAEA,MAAM,SAA8B,EAAE;AACtC,QAAK,MAAM,OAAO,KAChB,KAAI,oBAAoB,KAAK,KAAqC,EAAE;IAClE,MAAM,aAAa;KACjB,GAAG;KACH,UAAU,KAAK;KACf,SAAS,CACP,GAAG,MAAM,SACT;MAAE,MAAM,UAAU;MAAQ;MAAK,CAChC;KACF;AACD,WAAO,OAAO,kBACZ,KAAK,MACL,WACD;;AAGL,UAAO;aACE,MAAM,QAAQ,KAAK,CAE5B,QAAO,KAAK,KAAK,OAAO,UAAU;AAShC,UAAO,kBAAkB,OARN;IACjB,GAAG;IACH,UAAU;IACV,SAAS,CACP,GAAG,MAAM,SACT;KAAE,MAAM,UAAU;KAAO,KAAK;KAAO,CACtC;IACF,CAC0C;IAC3C;AAGJ,SAAO;;CAEV;;;;;;;AAQD,MAAa,oCAIX,MACA,SAAY,sBAAsB,eAElC,WACA,aACG;CACH,MAAM,UAAqB,CACzB,6BAA6B,QAAQ,SAAS,EAC9C,GAAI,UAAU,WAAW,EAAE,CAC5B;AAED,QAAO,kBAAkB,MAAM;EAC7B,GAAG;EACH;EACD,CAAC;;AAGJ,MAAa,uCACX,YACA,SAAwB,sBAAsB,eAE9C,cACI;CACJ,GAAG;CACH,SAAS,iCACP,WAAW,SACX,QACA;EAAE,eAAe,WAAW;EAAK,SAAS,EAAE;EAAE,EAC9C,SACD;CACF"}

package/dist/esm/deepTransformPlugins/getMissingLocalesContent.mjs

@@ -1,6 +1,6 @@
 import { deepTransformNode } from "../interpreter/getContent/deepTransform.mjs";
 import * as NodeTypes from "@intlayer/types/nodeType";
-import configuration from "@intlayer/config/built";
+import { internationalization } from "@intlayer/config/built";
 
 //#region src/deepTransformPlugins/getMissingLocalesContent.ts
 /**
@@ -127,7 +127,7 @@ const checkMissingLocalesPlugin = (locales, onMissingLocale) => ({
 * @param node The node to transform.
 * @param locales The locales to check for missing translations.
 */
-const getMissingLocalesContent = (node, locales = configuration?.internationalization?.locales, nodeProps) => {
+const getMissingLocalesContent = (node, locales = internationalization?.locales, nodeProps) => {
 	const missingLocales = /* @__PURE__ */ new Set();
 	const plugins = [checkMissingLocalesPlugin(locales, (locale) => missingLocales.add(locale)), ...nodeProps.plugins ?? []];
 	deepTransformNode(node, {
@@ -136,7 +136,7 @@ const getMissingLocalesContent = (node, locales = configuration?.internationaliz
 	});
 	return Array.from(missingLocales);
 };
-const getMissingLocalesContentFromDictionary = (dictionary, locales = configuration?.internationalization?.locales) => getMissingLocalesContent(dictionary.content, locales, {
+const getMissingLocalesContentFromDictionary = (dictionary, locales = internationalization?.locales) => getMissingLocalesContent(dictionary.content, locales, {
 	dictionaryKey: dictionary.key,
 	keyPath: []
 });

package/dist/esm/deepTransformPlugins/getMissingLocalesContent.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"getMissingLocalesContent.mjs","names":[],"sources":["../../../src/deepTransformPlugins/getMissingLocalesContent.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { ContentNode, Dictionary } from '@intlayer/types/dictionary';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport * as NodeTypes from '@intlayer/types/nodeType';\nimport type { DeepTransformContent, NodeProps, Plugins } from '../interpreter';\nimport { deepTransformNode } from '../interpreter/getContent/deepTransform';\nimport type { TranslationContent } from '../transpiler';\n\n/**\n * Returns all key paths present in obj, INCLUDING those whose leaf value is null.\n * Used for structural presence checks (a locale must have every key another locale has,\n * even if the value is a null placeholder).\n */\nconst getAllKeyPaths = (obj: any, prefix: string[] = []): string[][] => {\n  if (typeof obj !== 'object' || obj === null || Array.isArray(obj)) {\n    return [];\n  }\n\n  return Object.keys(obj).flatMap((key) => {\n    const newPath = [...prefix, key];\n    const value = obj[key];\n    // Stop recursing into null — include the path but don't descend further\n    if (value === null) {\n      return [newPath];\n    }\n    return [newPath, ...getAllKeyPaths(value, newPath)];\n  });\n};\n\n/**\n * Returns key paths whose leaf value is non-null.\n * Used for translation value checks (a locale must not have null where another locale\n * already has a real translated value).\n */\nconst getNonNullKeyPaths = (obj: any, prefix: string[] = []): string[][] => {\n  if (typeof obj !== 'object' || obj === null || Array.isArray(obj)) {\n    return [];\n  }\n\n  return Object.keys(obj).flatMap((key) => {\n    const newPath = [...prefix, key];\n    const value = obj[key];\n    // Skip null-valued keys entirely\n    if (value === null) {\n      return [];\n    }\n    return [newPath, ...getNonNullKeyPaths(value, newPath)];\n  });\n};\n\n/**\n * Returns true if the key path EXISTS in obj (even if the terminal value is null).\n * Used for the structural presence check.\n */\nconst hasKey = (obj: any, keyPath: string[]): boolean => {\n  let current = obj;\n  for (const key of keyPath) {\n    if (\n      current === undefined ||\n      current === null ||\n      typeof current !== 'object'\n    ) {\n      return false;\n    }\n    if (!(key in current)) {\n      return false;\n    }\n    current = current[key];\n  }\n  return true; // key exists; value may be null\n};\n\n/**\n * Returns true if the key path exists in obj AND the terminal value is non-null.\n * Used for the translation value check.\n */\nconst hasNonNullValue = (obj: any, keyPath: string[]): boolean => {\n  let current = obj;\n  for (const key of keyPath) {\n    if (\n      current === undefined ||\n      current === null ||\n      typeof current !== 'object'\n    ) {\n      return false;\n    }\n    if (!(key in current)) {\n      return false;\n    }\n    current = current[key];\n  }\n  // null is treated as a missing translation (e.g., i18next-scanner sets null for untranslated keys)\n  return current !== null;\n};\n\n/** Translation plugin. Replaces node with a locale string if nodeType = Translation. */\nexport const checkMissingLocalesPlugin = (\n  locales: Locale[],\n  onMissingLocale: (locale: Locale) => void\n): Plugins => ({\n  id: 'check-missing-locales-plugin',\n  canHandle: (node) =>\n    typeof node === 'object' && node?.nodeType === NodeTypes.TRANSLATION,\n  transform: (node: TranslationContent, props, deepTransformNode) => {\n    const translations = node[NodeTypes.TRANSLATION] as Record<string, any>;\n\n    /**\n     * Two path sets built from all locales' content:\n     *\n     * presentPaths — every key path that exists in ANY locale, even those whose value\n     *   is null. A locale that is missing a path from this set is structurally incomplete\n     *   (the key doesn't exist at all).\n     *\n     * nonNullPaths — every key path that has a non-null value in at least one locale.\n     *   A locale that has the key but with null, when another locale already has a real\n     *   value, needs translation.\n     */\n    const presentPaths = new Set<string>();\n    const nonNullPaths = new Set<string>();\n\n    for (const locale of locales) {\n      const value = translations[locale];\n      if (value && typeof value === 'object' && !Array.isArray(value)) {\n        getAllKeyPaths(value).forEach((path) => {\n          presentPaths.add(JSON.stringify(path));\n        });\n\n        getNonNullKeyPaths(value).forEach((path) => {\n          nonNullPaths.add(JSON.stringify(path));\n        });\n      }\n    }\n\n    // If no locale has any content at all (all are null/undefined), the key is\n    // universally pending — don't flag anyone.\n    const hasAnyDefinedValue = locales.some(\n      (locale) =>\n        translations[locale] !== undefined && translations[locale] !== null\n    );\n\n    for (const locale of locales) {\n      const value = translations[locale];\n\n      if (value === null) {\n        // Entire locale content is a null placeholder.\n        // Flag only when some other locale already has real content.\n        if (hasAnyDefinedValue) {\n          onMissingLocale(locale);\n        }\n        continue;\n      }\n\n      if (!value) {\n        // undefined / entirely absent\n        onMissingLocale(locale);\n        continue;\n      }\n\n      let flagged = false;\n\n      // Structural check: every key that exists in any locale must also exist here\n      // (even if the local value is null — at least the key must be present).\n      for (const pathStr of presentPaths) {\n        if (!hasKey(value, JSON.parse(pathStr))) {\n          onMissingLocale(locale);\n          flagged = true;\n          break;\n        }\n      }\n\n      if (!flagged) {\n        // Value check: every key that has a non-null value in some locale must also\n        // be non-null here (null = untranslated, needs filling).\n        for (const pathStr of nonNullPaths) {\n          if (!hasNonNullValue(value, JSON.parse(pathStr))) {\n            onMissingLocale(locale);\n            break;\n          }\n        }\n      }\n    }\n\n    // Continue traversal inside the translation values\n    for (const key in translations) {\n      const child = translations[key];\n      deepTransformNode(child, {\n        ...props,\n        children: child,\n      });\n    }\n\n    // Return the original node; the return value is ignored by the caller\n    return node;\n  },\n});\n\n/**\n * Return the content of a node with only the translation plugin.\n *\n * @param node The node to transform.\n * @param locales The locales to check for missing translations.\n */\nexport const getMissingLocalesContent = <T extends ContentNode>(\n  node: T,\n  locales: LocalesValues[] = configuration?.internationalization?.locales,\n  nodeProps: NodeProps\n): Locale[] => {\n  const missingLocales = new Set<Locale>();\n\n  const plugins: Plugins[] = [\n    checkMissingLocalesPlugin(locales as Locale[], (locale) =>\n      missingLocales.add(locale)\n    ),\n    ...(nodeProps.plugins ?? []),\n  ];\n\n  deepTransformNode(node, {\n    ...nodeProps,\n    plugins,\n  }) as DeepTransformContent<T>;\n\n  return Array.from(missingLocales);\n};\n\nexport const getMissingLocalesContentFromDictionary = (\n  dictionary: Dictionary,\n  locales: LocalesValues[] = configuration?.internationalization?.locales\n) =>\n  getMissingLocalesContent(dictionary.content, locales, {\n    dictionaryKey: dictionary.key,\n    keyPath: [],\n  });\n"],"mappings":"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"}
+{"version":3,"file":"getMissingLocalesContent.mjs","names":[],"sources":["../../../src/deepTransformPlugins/getMissingLocalesContent.ts"],"sourcesContent":["import { internationalization } from '@intlayer/config/built';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { ContentNode, Dictionary } from '@intlayer/types/dictionary';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport * as NodeTypes from '@intlayer/types/nodeType';\nimport type { DeepTransformContent, NodeProps, Plugins } from '../interpreter';\nimport { deepTransformNode } from '../interpreter/getContent/deepTransform';\nimport type { TranslationContent } from '../transpiler';\n\n/**\n * Returns all key paths present in obj, INCLUDING those whose leaf value is null.\n * Used for structural presence checks (a locale must have every key another locale has,\n * even if the value is a null placeholder).\n */\nconst getAllKeyPaths = (obj: any, prefix: string[] = []): string[][] => {\n  if (typeof obj !== 'object' || obj === null || Array.isArray(obj)) {\n    return [];\n  }\n\n  return Object.keys(obj).flatMap((key) => {\n    const newPath = [...prefix, key];\n    const value = obj[key];\n    // Stop recursing into null — include the path but don't descend further\n    if (value === null) {\n      return [newPath];\n    }\n    return [newPath, ...getAllKeyPaths(value, newPath)];\n  });\n};\n\n/**\n * Returns key paths whose leaf value is non-null.\n * Used for translation value checks (a locale must not have null where another locale\n * already has a real translated value).\n */\nconst getNonNullKeyPaths = (obj: any, prefix: string[] = []): string[][] => {\n  if (typeof obj !== 'object' || obj === null || Array.isArray(obj)) {\n    return [];\n  }\n\n  return Object.keys(obj).flatMap((key) => {\n    const newPath = [...prefix, key];\n    const value = obj[key];\n    // Skip null-valued keys entirely\n    if (value === null) {\n      return [];\n    }\n    return [newPath, ...getNonNullKeyPaths(value, newPath)];\n  });\n};\n\n/**\n * Returns true if the key path EXISTS in obj (even if the terminal value is null).\n * Used for the structural presence check.\n */\nconst hasKey = (obj: any, keyPath: string[]): boolean => {\n  let current = obj;\n  for (const key of keyPath) {\n    if (\n      current === undefined ||\n      current === null ||\n      typeof current !== 'object'\n    ) {\n      return false;\n    }\n    if (!(key in current)) {\n      return false;\n    }\n    current = current[key];\n  }\n  return true; // key exists; value may be null\n};\n\n/**\n * Returns true if the key path exists in obj AND the terminal value is non-null.\n * Used for the translation value check.\n */\nconst hasNonNullValue = (obj: any, keyPath: string[]): boolean => {\n  let current = obj;\n  for (const key of keyPath) {\n    if (\n      current === undefined ||\n      current === null ||\n      typeof current !== 'object'\n    ) {\n      return false;\n    }\n    if (!(key in current)) {\n      return false;\n    }\n    current = current[key];\n  }\n  // null is treated as a missing translation (e.g., i18next-scanner sets null for untranslated keys)\n  return current !== null;\n};\n\n/** Translation plugin. Replaces node with a locale string if nodeType = Translation. */\nexport const checkMissingLocalesPlugin = (\n  locales: Locale[],\n  onMissingLocale: (locale: Locale) => void\n): Plugins => ({\n  id: 'check-missing-locales-plugin',\n  canHandle: (node) =>\n    typeof node === 'object' && node?.nodeType === NodeTypes.TRANSLATION,\n  transform: (node: TranslationContent, props, deepTransformNode) => {\n    const translations = node[NodeTypes.TRANSLATION] as Record<string, any>;\n\n    /**\n     * Two path sets built from all locales' content:\n     *\n     * presentPaths — every key path that exists in ANY locale, even those whose value\n     *   is null. A locale that is missing a path from this set is structurally incomplete\n     *   (the key doesn't exist at all).\n     *\n     * nonNullPaths — every key path that has a non-null value in at least one locale.\n     *   A locale that has the key but with null, when another locale already has a real\n     *   value, needs translation.\n     */\n    const presentPaths = new Set<string>();\n    const nonNullPaths = new Set<string>();\n\n    for (const locale of locales) {\n      const value = translations[locale];\n      if (value && typeof value === 'object' && !Array.isArray(value)) {\n        getAllKeyPaths(value).forEach((path) => {\n          presentPaths.add(JSON.stringify(path));\n        });\n\n        getNonNullKeyPaths(value).forEach((path) => {\n          nonNullPaths.add(JSON.stringify(path));\n        });\n      }\n    }\n\n    // If no locale has any content at all (all are null/undefined), the key is\n    // universally pending — don't flag anyone.\n    const hasAnyDefinedValue = locales.some(\n      (locale) =>\n        translations[locale] !== undefined && translations[locale] !== null\n    );\n\n    for (const locale of locales) {\n      const value = translations[locale];\n\n      if (value === null) {\n        // Entire locale content is a null placeholder.\n        // Flag only when some other locale already has real content.\n        if (hasAnyDefinedValue) {\n          onMissingLocale(locale);\n        }\n        continue;\n      }\n\n      if (!value) {\n        // undefined / entirely absent\n        onMissingLocale(locale);\n        continue;\n      }\n\n      let flagged = false;\n\n      // Structural check: every key that exists in any locale must also exist here\n      // (even if the local value is null — at least the key must be present).\n      for (const pathStr of presentPaths) {\n        if (!hasKey(value, JSON.parse(pathStr))) {\n          onMissingLocale(locale);\n          flagged = true;\n          break;\n        }\n      }\n\n      if (!flagged) {\n        // Value check: every key that has a non-null value in some locale must also\n        // be non-null here (null = untranslated, needs filling).\n        for (const pathStr of nonNullPaths) {\n          if (!hasNonNullValue(value, JSON.parse(pathStr))) {\n            onMissingLocale(locale);\n            break;\n          }\n        }\n      }\n    }\n\n    // Continue traversal inside the translation values\n    for (const key in translations) {\n      const child = translations[key];\n      deepTransformNode(child, {\n        ...props,\n        children: child,\n      });\n    }\n\n    // Return the original node; the return value is ignored by the caller\n    return node;\n  },\n});\n\n/**\n * Return the content of a node with only the translation plugin.\n *\n * @param node The node to transform.\n * @param locales The locales to check for missing translations.\n */\nexport const getMissingLocalesContent = <T extends ContentNode>(\n  node: T,\n  locales: LocalesValues[] = internationalization?.locales,\n\n  nodeProps: NodeProps\n): Locale[] => {\n  const missingLocales = new Set<Locale>();\n\n  const plugins: Plugins[] = [\n    checkMissingLocalesPlugin(locales as Locale[], (locale) =>\n      missingLocales.add(locale)\n    ),\n    ...(nodeProps.plugins ?? []),\n  ];\n\n  deepTransformNode(node, {\n    ...nodeProps,\n    plugins,\n  }) as DeepTransformContent<T>;\n\n  return Array.from(missingLocales);\n};\n\nexport const getMissingLocalesContentFromDictionary = (\n  dictionary: Dictionary,\n  locales: LocalesValues[] = internationalization?.locales\n) =>\n  getMissingLocalesContent(dictionary.content, locales, {\n    dictionaryKey: dictionary.key,\n    keyPath: [],\n  });\n"],"mappings":"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"}

package/dist/esm/dictionaryManipulator/mergeDictionaries.mjs

@@ -1,11 +1,11 @@
 import { getMultilingualDictionary } from "../deepTransformPlugins/getMultilingualDictionary.mjs";
 import { getNodeType } from "./getNodeType.mjs";
-import configuration from "@intlayer/config/built";
+import { log } from "@intlayer/config/built";
 import { colorizeKey, getAppLogger } from "@intlayer/config/logger";
 
 //#region src/dictionaryManipulator/mergeDictionaries.ts
 const checkTypesMatch = (object1, object2, object2LocalId, dictionaryKey, path = []) => {
-	const appLogger = getAppLogger(configuration);
+	const appLogger = getAppLogger({ log });
 	if (object1 === void 0 || object1 === null || object2 === void 0 || object2 === null) return;
 	const type1 = getNodeType(object1);
 	const type2 = getNodeType(object2);

package/dist/esm/dictionaryManipulator/mergeDictionaries.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mergeDictionaries.mjs","names":[],"sources":["../../../src/dictionaryManipulator/mergeDictionaries.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport { colorizeKey, getAppLogger } from '@intlayer/config/logger';\nimport type { ContentNode, Dictionary, LocalDictionaryId } from '@intlayer/types/dictionary';\nimport { getMultilingualDictionary } from '../deepTransformPlugins';\nimport { getNodeType } from './getNodeType';\n\n// Extended type that includes arrays for internal merge operations\ntype MergeableContent = ContentNode | ContentNode[];\n\nconst checkTypesMatch = (\n  object1: ContentNode,\n  object2: ContentNode,\n  object2LocalId: LocalDictionaryId | undefined,\n  dictionaryKey: string,\n  path: string[] = []\n): void => {\n  const appLogger = getAppLogger(configuration);\n\n  // If either side is missing/undefined, allow merge without error\n  if (\n    object1 === undefined ||\n    object1 === null ||\n    object2 === undefined ||\n    object2 === null\n  )\n    return;\n\n  const type1 = getNodeType(object1);\n  const type2 = getNodeType(object2);\n\n  // Unknown types are treated as flexible; skip strict mismatch reporting\n  if (type1 === 'unknown' || type2 === 'unknown') return;\n\n  if (type1 !== type2) {\n    appLogger(\n      [\n        `Error: Dictionary ${colorizeKey(dictionaryKey)} has a multiple content files with type mismatch at path \"${path.join('.')}\": Cannot merge ${type1} with ${type2} while merging ${object2LocalId}`,\n      ],\n      {\n        level: 'error',\n      }\n    );\n\n    return;\n  }\n};\n\n// Custom merge function that prefers destination (first dictionary) values\nconst customMerge = (\n  destination: ContentNode,\n  source: ContentNode\n): MergeableContent => {\n  // If destination is undefined/null, use source\n  if (destination === undefined || destination === null) {\n    return source;\n  }\n\n  // If source is undefined/null, use destination\n  if (source === undefined || source === null) {\n    return destination;\n  }\n\n  // For primitive values, prefer destination (first dictionary)\n  if (typeof destination !== 'object' || typeof source !== 'object') {\n    return destination;\n  }\n\n  // For arrays, use our custom array merge\n  if (Array.isArray(destination) && Array.isArray(source)) {\n    return arrayMerge(\n      destination as ContentNode[],\n      source as ContentNode[]\n    ) as MergeableContent;\n  }\n\n  // For objects, recursively merge with our custom logic\n  if (typeof destination === 'object' && typeof source === 'object') {\n    const result: Record<string, MergeableContent> = {};\n    const allKeys = new Set([\n      ...Object.keys(destination as unknown as Record<string, ContentNode>),\n      ...Object.keys(source as unknown as Record<string, ContentNode>),\n    ]);\n\n    for (const key of allKeys) {\n      result[key] = customMerge(\n        (destination as unknown as Record<string, ContentNode>)[key],\n        (source as unknown as Record<string, ContentNode>)[key]\n      );\n    }\n\n    return result as unknown as MergeableContent;\n  }\n\n  // Fallback to destination\n  return destination;\n};\n\n// Custom array merge strategy that merges arrays by key when present, otherwise by index\nconst arrayMerge = (\n  destinationArray: ContentNode[],\n  sourceArray: ContentNode[]\n): MergeableContent[] => {\n  // Check if both arrays contain only primitives\n  const destHasOnlyPrimitives = destinationArray.every(\n    (item) => typeof item !== 'object' || item === null\n  );\n  const sourceHasOnlyPrimitives = sourceArray.every(\n    (item) => typeof item !== 'object' || item === null\n  );\n\n  // If both arrays contain only primitives, use the source array (second dictionary)\n  if (destHasOnlyPrimitives && sourceHasOnlyPrimitives) {\n    return sourceArray;\n  }\n\n  // Otherwise, merge by index with object merging logic\n  const result: MergeableContent[] = [];\n  const maxLength = Math.max(destinationArray.length, sourceArray.length);\n\n  for (let i = 0; i < maxLength; i++) {\n    const destItem = destinationArray[i];\n    const sourceItem = sourceArray[i];\n\n    if (destItem === undefined && sourceItem === undefined) {\n    } else if (destItem === undefined) {\n      // Only source exists, add it\n      result.push(sourceItem);\n    } else if (sourceItem === undefined) {\n      // Only destination exists, add it\n      result.push(destItem);\n    } else {\n      // Both exist, merge them\n      if (\n        typeof destItem === 'object' &&\n        typeof sourceItem === 'object' &&\n        destItem !== null &&\n        sourceItem !== null\n      ) {\n        // Check if both objects have a 'key' property for keyed merging\n        if (\n          'key' in destItem &&\n          'key' in sourceItem &&\n          (destItem as Record<string, string>).key ===\n            (sourceItem as Record<string, string>).key\n        ) {\n          // Merge objects with same key, preferring destination (first dictionary) values\n          result.push(customMerge(destItem, sourceItem));\n        } else {\n          // Merge objects by index, preferring destination (first dictionary) values\n          result.push(customMerge(destItem, sourceItem));\n        }\n      } else {\n        // For primitives or non-objects, use destination value (first dictionary)\n        result.push(destItem);\n      }\n    }\n  }\n\n  return result;\n};\n\nexport const mergeDictionaries = (dictionaries: Dictionary[]): Dictionary => {\n  const localIds = Array.from(\n    new Set<LocalDictionaryId>(\n      dictionaries.filter((dict) => dict.localId).map((dict) => dict.localId!)\n    )\n  );\n\n  const dictionariesKeys = dictionaries.map((dict) => dict.key);\n\n  // Check if all dictionaries have the same key\n  if (new Set(dictionariesKeys).size !== 1) {\n    throw new Error('All dictionaries must have the same key');\n  }\n\n  let mergedContent: Dictionary['content'] = dictionaries[0].content;\n\n  for (let i = 1; i < dictionaries.length; i++) {\n    // If the dictionary is a per-locale dictionary, transform it to a partial multilingual dictionary\n    const currentDictionary = getMultilingualDictionary(dictionaries[i]);\n\n    // Check types before merging\n    checkTypesMatch(\n      mergedContent,\n      currentDictionary.content,\n      currentDictionary.localId,\n      currentDictionary.key,\n      []\n    );\n\n    mergedContent = customMerge(\n      mergedContent,\n      currentDictionary.content\n    ) as ContentNode;\n  }\n\n  const mergedDictionary: Dictionary = {\n    key: dictionaries[0].key,\n    content: mergedContent,\n    localIds,\n  };\n\n  return mergedDictionary;\n};\n"],"mappings":";;;;;;AASA,MAAM,mBACJ,SACA,SACA,gBACA,eACA,OAAiB,EAAE,KACV;CACT,MAAM,YAAY,aAAa,cAAc;AAG7C,KACE,YAAY,UACZ,YAAY,QACZ,YAAY,UACZ,YAAY,KAEZ;CAEF,MAAM,QAAQ,YAAY,QAAQ;CAClC,MAAM,QAAQ,YAAY,QAAQ;AAGlC,KAAI,UAAU,aAAa,UAAU,UAAW;AAEhD,KAAI,UAAU,OAAO;AACnB,YACE,CACE,qBAAqB,YAAY,cAAc,CAAC,4DAA4D,KAAK,KAAK,IAAI,CAAC,kBAAkB,MAAM,QAAQ,MAAM,iBAAiB,iBACnL,EACD,EACE,OAAO,SACR,CACF;AAED;;;AAKJ,MAAM,eACJ,aACA,WACqB;AAErB,KAAI,gBAAgB,UAAa,gBAAgB,KAC/C,QAAO;AAIT,KAAI,WAAW,UAAa,WAAW,KACrC,QAAO;AAIT,KAAI,OAAO,gBAAgB,YAAY,OAAO,WAAW,SACvD,QAAO;AAIT,KAAI,MAAM,QAAQ,YAAY,IAAI,MAAM,QAAQ,OAAO,CACrD,QAAO,WACL,aACA,OACD;AAIH,KAAI,OAAO,gBAAgB,YAAY,OAAO,WAAW,UAAU;EACjE,MAAM,SAA2C,EAAE;EACnD,MAAM,UAAU,IAAI,IAAI,CACtB,GAAG,OAAO,KAAK,YAAsD,EACrE,GAAG,OAAO,KAAK,OAAiD,CACjE,CAAC;AAEF,OAAK,MAAM,OAAO,QAChB,QAAO,OAAO,YACX,YAAuD,MACvD,OAAkD,KACpD;AAGH,SAAO;;AAIT,QAAO;;AAIT,MAAM,cACJ,kBACA,gBACuB;CAEvB,MAAM,wBAAwB,iBAAiB,OAC5C,SAAS,OAAO,SAAS,YAAY,SAAS,KAChD;CACD,MAAM,0BAA0B,YAAY,OACzC,SAAS,OAAO,SAAS,YAAY,SAAS,KAChD;AAGD,KAAI,yBAAyB,wBAC3B,QAAO;CAIT,MAAM,SAA6B,EAAE;CACrC,MAAM,YAAY,KAAK,IAAI,iBAAiB,QAAQ,YAAY,OAAO;AAEvE,MAAK,IAAI,IAAI,GAAG,IAAI,WAAW,KAAK;EAClC,MAAM,WAAW,iBAAiB;EAClC,MAAM,aAAa,YAAY;AAE/B,MAAI,aAAa,UAAa,eAAe,QAAW,YAC7C,aAAa,OAEtB,QAAO,KAAK,WAAW;WACd,eAAe,OAExB,QAAO,KAAK,SAAS;WAInB,OAAO,aAAa,YACpB,OAAO,eAAe,YACtB,aAAa,QACb,eAAe,KAGf,KACE,SAAS,YACT,SAAS,cACR,SAAoC,QAClC,WAAsC,IAGzC,QAAO,KAAK,YAAY,UAAU,WAAW,CAAC;MAG9C,QAAO,KAAK,YAAY,UAAU,WAAW,CAAC;MAIhD,QAAO,KAAK,SAAS;;AAK3B,QAAO;;AAGT,MAAa,qBAAqB,iBAA2C;CAC3E,MAAM,WAAW,MAAM,KACrB,IAAI,IACF,aAAa,QAAQ,SAAS,KAAK,QAAQ,CAAC,KAAK,SAAS,KAAK,QAAS,CACzE,CACF;CAED,MAAM,mBAAmB,aAAa,KAAK,SAAS,KAAK,IAAI;AAG7D,KAAI,IAAI,IAAI,iBAAiB,CAAC,SAAS,EACrC,OAAM,IAAI,MAAM,0CAA0C;CAG5D,IAAI,gBAAuC,aAAa,GAAG;AAE3D,MAAK,IAAI,IAAI,GAAG,IAAI,aAAa,QAAQ,KAAK;EAE5C,MAAM,oBAAoB,0BAA0B,aAAa,GAAG;AAGpE,kBACE,eACA,kBAAkB,SAClB,kBAAkB,SAClB,kBAAkB,KAClB,EAAE,CACH;AAED,kBAAgB,YACd,eACA,kBAAkB,QACnB;;AASH,QANqC;EACnC,KAAK,aAAa,GAAG;EACrB,SAAS;EACT;EACD"}
+{"version":3,"file":"mergeDictionaries.mjs","names":[],"sources":["../../../src/dictionaryManipulator/mergeDictionaries.ts"],"sourcesContent":["import { log } from '@intlayer/config/built';\nimport { colorizeKey, getAppLogger } from '@intlayer/config/logger';\nimport type {\n  ContentNode,\n  Dictionary,\n  LocalDictionaryId,\n} from '@intlayer/types/dictionary';\nimport { getMultilingualDictionary } from '../deepTransformPlugins';\nimport { getNodeType } from './getNodeType';\n\n// Extended type that includes arrays for internal merge operations\ntype MergeableContent = ContentNode | ContentNode[];\n\nconst checkTypesMatch = (\n  object1: ContentNode,\n  object2: ContentNode,\n  object2LocalId: LocalDictionaryId | undefined,\n  dictionaryKey: string,\n  path: string[] = []\n): void => {\n  const appLogger = getAppLogger({ log });\n\n  // If either side is missing/undefined, allow merge without error\n  if (\n    object1 === undefined ||\n    object1 === null ||\n    object2 === undefined ||\n    object2 === null\n  )\n    return;\n\n  const type1 = getNodeType(object1);\n  const type2 = getNodeType(object2);\n\n  // Unknown types are treated as flexible; skip strict mismatch reporting\n  if (type1 === 'unknown' || type2 === 'unknown') return;\n\n  if (type1 !== type2) {\n    appLogger(\n      [\n        `Error: Dictionary ${colorizeKey(dictionaryKey)} has a multiple content files with type mismatch at path \"${path.join('.')}\": Cannot merge ${type1} with ${type2} while merging ${object2LocalId}`,\n      ],\n      {\n        level: 'error',\n      }\n    );\n\n    return;\n  }\n};\n\n// Custom merge function that prefers destination (first dictionary) values\nconst customMerge = (\n  destination: ContentNode,\n  source: ContentNode\n): MergeableContent => {\n  // If destination is undefined/null, use source\n  if (destination === undefined || destination === null) {\n    return source;\n  }\n\n  // If source is undefined/null, use destination\n  if (source === undefined || source === null) {\n    return destination;\n  }\n\n  // For primitive values, prefer destination (first dictionary)\n  if (typeof destination !== 'object' || typeof source !== 'object') {\n    return destination;\n  }\n\n  // For arrays, use our custom array merge\n  if (Array.isArray(destination) && Array.isArray(source)) {\n    return arrayMerge(\n      destination as ContentNode[],\n      source as ContentNode[]\n    ) as MergeableContent;\n  }\n\n  // For objects, recursively merge with our custom logic\n  if (typeof destination === 'object' && typeof source === 'object') {\n    const result: Record<string, MergeableContent> = {};\n    const allKeys = new Set([\n      ...Object.keys(destination as unknown as Record<string, ContentNode>),\n      ...Object.keys(source as unknown as Record<string, ContentNode>),\n    ]);\n\n    for (const key of allKeys) {\n      result[key] = customMerge(\n        (destination as unknown as Record<string, ContentNode>)[key],\n        (source as unknown as Record<string, ContentNode>)[key]\n      );\n    }\n\n    return result as unknown as MergeableContent;\n  }\n\n  // Fallback to destination\n  return destination;\n};\n\n// Custom array merge strategy that merges arrays by key when present, otherwise by index\nconst arrayMerge = (\n  destinationArray: ContentNode[],\n  sourceArray: ContentNode[]\n): MergeableContent[] => {\n  // Check if both arrays contain only primitives\n  const destHasOnlyPrimitives = destinationArray.every(\n    (item) => typeof item !== 'object' || item === null\n  );\n  const sourceHasOnlyPrimitives = sourceArray.every(\n    (item) => typeof item !== 'object' || item === null\n  );\n\n  // If both arrays contain only primitives, use the source array (second dictionary)\n  if (destHasOnlyPrimitives && sourceHasOnlyPrimitives) {\n    return sourceArray;\n  }\n\n  // Otherwise, merge by index with object merging logic\n  const result: MergeableContent[] = [];\n  const maxLength = Math.max(destinationArray.length, sourceArray.length);\n\n  for (let i = 0; i < maxLength; i++) {\n    const destItem = destinationArray[i];\n    const sourceItem = sourceArray[i];\n\n    if (destItem === undefined && sourceItem === undefined) {\n    } else if (destItem === undefined) {\n      // Only source exists, add it\n      result.push(sourceItem);\n    } else if (sourceItem === undefined) {\n      // Only destination exists, add it\n      result.push(destItem);\n    } else {\n      // Both exist, merge them\n      if (\n        typeof destItem === 'object' &&\n        typeof sourceItem === 'object' &&\n        destItem !== null &&\n        sourceItem !== null\n      ) {\n        // Check if both objects have a 'key' property for keyed merging\n        if (\n          'key' in destItem &&\n          'key' in sourceItem &&\n          (destItem as Record<string, string>).key ===\n            (sourceItem as Record<string, string>).key\n        ) {\n          // Merge objects with same key, preferring destination (first dictionary) values\n          result.push(customMerge(destItem, sourceItem));\n        } else {\n          // Merge objects by index, preferring destination (first dictionary) values\n          result.push(customMerge(destItem, sourceItem));\n        }\n      } else {\n        // For primitives or non-objects, use destination value (first dictionary)\n        result.push(destItem);\n      }\n    }\n  }\n\n  return result;\n};\n\nexport const mergeDictionaries = (dictionaries: Dictionary[]): Dictionary => {\n  const localIds = Array.from(\n    new Set<LocalDictionaryId>(\n      dictionaries.filter((dict) => dict.localId).map((dict) => dict.localId!)\n    )\n  );\n\n  const dictionariesKeys = dictionaries.map((dict) => dict.key);\n\n  // Check if all dictionaries have the same key\n  if (new Set(dictionariesKeys).size !== 1) {\n    throw new Error('All dictionaries must have the same key');\n  }\n\n  let mergedContent: Dictionary['content'] = dictionaries[0].content;\n\n  for (let i = 1; i < dictionaries.length; i++) {\n    // If the dictionary is a per-locale dictionary, transform it to a partial multilingual dictionary\n    const currentDictionary = getMultilingualDictionary(dictionaries[i]);\n\n    // Check types before merging\n    checkTypesMatch(\n      mergedContent,\n      currentDictionary.content,\n      currentDictionary.localId,\n      currentDictionary.key,\n      []\n    );\n\n    mergedContent = customMerge(\n      mergedContent,\n      currentDictionary.content\n    ) as ContentNode;\n  }\n\n  const mergedDictionary: Dictionary = {\n    key: dictionaries[0].key,\n    content: mergedContent,\n    localIds,\n  };\n\n  return mergedDictionary;\n};\n"],"mappings":";;;;;;AAaA,MAAM,mBACJ,SACA,SACA,gBACA,eACA,OAAiB,EAAE,KACV;CACT,MAAM,YAAY,aAAa,EAAE,KAAK,CAAC;AAGvC,KACE,YAAY,UACZ,YAAY,QACZ,YAAY,UACZ,YAAY,KAEZ;CAEF,MAAM,QAAQ,YAAY,QAAQ;CAClC,MAAM,QAAQ,YAAY,QAAQ;AAGlC,KAAI,UAAU,aAAa,UAAU,UAAW;AAEhD,KAAI,UAAU,OAAO;AACnB,YACE,CACE,qBAAqB,YAAY,cAAc,CAAC,4DAA4D,KAAK,KAAK,IAAI,CAAC,kBAAkB,MAAM,QAAQ,MAAM,iBAAiB,iBACnL,EACD,EACE,OAAO,SACR,CACF;AAED;;;AAKJ,MAAM,eACJ,aACA,WACqB;AAErB,KAAI,gBAAgB,UAAa,gBAAgB,KAC/C,QAAO;AAIT,KAAI,WAAW,UAAa,WAAW,KACrC,QAAO;AAIT,KAAI,OAAO,gBAAgB,YAAY,OAAO,WAAW,SACvD,QAAO;AAIT,KAAI,MAAM,QAAQ,YAAY,IAAI,MAAM,QAAQ,OAAO,CACrD,QAAO,WACL,aACA,OACD;AAIH,KAAI,OAAO,gBAAgB,YAAY,OAAO,WAAW,UAAU;EACjE,MAAM,SAA2C,EAAE;EACnD,MAAM,UAAU,IAAI,IAAI,CACtB,GAAG,OAAO,KAAK,YAAsD,EACrE,GAAG,OAAO,KAAK,OAAiD,CACjE,CAAC;AAEF,OAAK,MAAM,OAAO,QAChB,QAAO,OAAO,YACX,YAAuD,MACvD,OAAkD,KACpD;AAGH,SAAO;;AAIT,QAAO;;AAIT,MAAM,cACJ,kBACA,gBACuB;CAEvB,MAAM,wBAAwB,iBAAiB,OAC5C,SAAS,OAAO,SAAS,YAAY,SAAS,KAChD;CACD,MAAM,0BAA0B,YAAY,OACzC,SAAS,OAAO,SAAS,YAAY,SAAS,KAChD;AAGD,KAAI,yBAAyB,wBAC3B,QAAO;CAIT,MAAM,SAA6B,EAAE;CACrC,MAAM,YAAY,KAAK,IAAI,iBAAiB,QAAQ,YAAY,OAAO;AAEvE,MAAK,IAAI,IAAI,GAAG,IAAI,WAAW,KAAK;EAClC,MAAM,WAAW,iBAAiB;EAClC,MAAM,aAAa,YAAY;AAE/B,MAAI,aAAa,UAAa,eAAe,QAAW,YAC7C,aAAa,OAEtB,QAAO,KAAK,WAAW;WACd,eAAe,OAExB,QAAO,KAAK,SAAS;WAInB,OAAO,aAAa,YACpB,OAAO,eAAe,YACtB,aAAa,QACb,eAAe,KAGf,KACE,SAAS,YACT,SAAS,cACR,SAAoC,QAClC,WAAsC,IAGzC,QAAO,KAAK,YAAY,UAAU,WAAW,CAAC;MAG9C,QAAO,KAAK,YAAY,UAAU,WAAW,CAAC;MAIhD,QAAO,KAAK,SAAS;;AAK3B,QAAO;;AAGT,MAAa,qBAAqB,iBAA2C;CAC3E,MAAM,WAAW,MAAM,KACrB,IAAI,IACF,aAAa,QAAQ,SAAS,KAAK,QAAQ,CAAC,KAAK,SAAS,KAAK,QAAS,CACzE,CACF;CAED,MAAM,mBAAmB,aAAa,KAAK,SAAS,KAAK,IAAI;AAG7D,KAAI,IAAI,IAAI,iBAAiB,CAAC,SAAS,EACrC,OAAM,IAAI,MAAM,0CAA0C;CAG5D,IAAI,gBAAuC,aAAa,GAAG;AAE3D,MAAK,IAAI,IAAI,GAAG,IAAI,aAAa,QAAQ,KAAK;EAE5C,MAAM,oBAAoB,0BAA0B,aAAa,GAAG;AAGpE,kBACE,eACA,kBAAkB,SAClB,kBAAkB,SAClB,kBAAkB,KAClB,EAAE,CACH;AAED,kBAAgB,YACd,eACA,kBAAkB,QACnB;;AASH,QANqC;EACnC,KAAK,aAAa,GAAG;EACrB,SAAS;EACT;EACD"}