@intlayer/core 8.3.3 → 8.4.0-canary.0

package/dist/cjs/dictionaryManipulator/getContentNodeByKeyPath.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"getContentNodeByKeyPath.cjs","names":["NodeType"],"sources":["../../../src/dictionaryManipulator/getContentNodeByKeyPath.ts"],"sourcesContent":["import type { Locale } from '@intlayer/types/allLocales';\nimport type { ContentNode } from '@intlayer/types/dictionary';\nimport type { KeyPath } from '@intlayer/types/keyPath';\nimport { NodeType } from '@intlayer/types/nodeType';\n\nexport const getContentNodeByKeyPath = (\n  dictionaryContent: ContentNode,\n  keyPath: KeyPath[],\n  fallbackLocale?: Locale\n): ContentNode => {\n  let currentValue: any = structuredClone(dictionaryContent);\n\n  for (const keyObj of keyPath) {\n    // Auto-resolve translation nodes when fallbackLocale is provided\n    if (fallbackLocale && currentValue?.nodeType === NodeType.Translation) {\n      currentValue = currentValue?.[NodeType.Translation]?.[fallbackLocale];\n    }\n\n    if (keyObj.type === NodeType.Object || keyObj.type === NodeType.Array) {\n      currentValue = currentValue?.[keyObj.key];\n    }\n\n    if (\n      keyObj.type === NodeType.Translation ||\n      keyObj.type === NodeType.Condition ||\n      keyObj.type === NodeType.Enumeration\n    ) {\n      currentValue = currentValue?.[keyObj.type]?.[keyObj.key];\n    }\n\n    if (\n      keyObj.type === NodeType.Markdown ||\n      keyObj.type === NodeType.HTML ||\n      keyObj.type === NodeType.Insertion ||\n      keyObj.type === NodeType.File\n    ) {\n      currentValue = currentValue?.[keyObj.type];\n    }\n  }\n\n  return currentValue as ContentNode;\n};\n"],"mappings":"0JAKA,MAAa,GACX,EACA,EACA,IACgB,CAChB,IAAI,EAAoB,gBAAgB,EAAkB,CAE1D,IAAK,IAAM,KAAU,EAEf,GAAkB,GAAc,WAAaA,EAAAA,SAAS,cACxD,EAAe,IAAeA,EAAAA,SAAS,eAAe,KAGpD,EAAO,OAASA,EAAAA,SAAS,QAAU,EAAO,OAASA,EAAAA,SAAS,SAC9D,EAAe,IAAe,EAAO,OAIrC,EAAO,OAASA,EAAAA,SAAS,aACzB,EAAO,OAASA,EAAAA,SAAS,WACzB,EAAO,OAASA,EAAAA,SAAS,eAEzB,EAAe,IAAe,EAAO,QAAQ,EAAO,OAIpD,EAAO,OAASA,EAAAA,SAAS,UACzB,EAAO,OAASA,EAAAA,SAAS,MACzB,EAAO,OAASA,EAAAA,SAAS,WACzB,EAAO,OAASA,EAAAA,SAAS,QAEzB,EAAe,IAAe,EAAO,OAIzC,OAAO"}
+{"version":3,"file":"getContentNodeByKeyPath.cjs","names":["NodeType"],"sources":["../../../src/dictionaryManipulator/getContentNodeByKeyPath.ts"],"sourcesContent":["import type { ContentNode } from '@intlayer/types/dictionary';\nimport type { KeyPath } from '@intlayer/types/keyPath';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { NodeType } from '@intlayer/types/nodeType';\n\nexport const getContentNodeByKeyPath = (\n  dictionaryContent: ContentNode,\n  keyPath: KeyPath[],\n  fallbackLocale?: LocalesValues\n): ContentNode => {\n  let currentValue: any = structuredClone(dictionaryContent);\n\n  for (const keyObj of keyPath) {\n    // Auto-resolve translation nodes when fallbackLocale is provided\n    if (fallbackLocale && currentValue?.nodeType === NodeType.Translation) {\n      currentValue = currentValue?.[NodeType.Translation]?.[fallbackLocale];\n    }\n\n    if (keyObj.type === NodeType.Object || keyObj.type === NodeType.Array) {\n      currentValue = currentValue?.[keyObj.key];\n    }\n\n    if (\n      keyObj.type === NodeType.Translation ||\n      keyObj.type === NodeType.Condition ||\n      keyObj.type === NodeType.Enumeration\n    ) {\n      currentValue = currentValue?.[keyObj.type]?.[keyObj.key];\n    }\n\n    if (\n      keyObj.type === NodeType.Markdown ||\n      keyObj.type === NodeType.HTML ||\n      keyObj.type === NodeType.Insertion ||\n      keyObj.type === NodeType.File\n    ) {\n      currentValue = currentValue?.[keyObj.type];\n    }\n  }\n\n  return currentValue as ContentNode;\n};\n"],"mappings":"0JAKA,MAAa,GACX,EACA,EACA,IACgB,CAChB,IAAI,EAAoB,gBAAgB,EAAkB,CAE1D,IAAK,IAAM,KAAU,EAEf,GAAkB,GAAc,WAAaA,EAAAA,SAAS,cACxD,EAAe,IAAeA,EAAAA,SAAS,eAAe,KAGpD,EAAO,OAASA,EAAAA,SAAS,QAAU,EAAO,OAASA,EAAAA,SAAS,SAC9D,EAAe,IAAe,EAAO,OAIrC,EAAO,OAASA,EAAAA,SAAS,aACzB,EAAO,OAASA,EAAAA,SAAS,WACzB,EAAO,OAASA,EAAAA,SAAS,eAEzB,EAAe,IAAe,EAAO,QAAQ,EAAO,OAIpD,EAAO,OAASA,EAAAA,SAAS,UACzB,EAAO,OAASA,EAAAA,SAAS,MACzB,EAAO,OAASA,EAAAA,SAAS,WACzB,EAAO,OAASA,EAAAA,SAAS,QAEzB,EAAe,IAAe,EAAO,OAIzC,OAAO"}

package/dist/cjs/interpreter/getContent/deepTransform.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"deepTransform.cjs","names":["NodeType"],"sources":["../../../../src/interpreter/getContent/deepTransform.ts"],"sourcesContent":["import type { KeyPath } from '@intlayer/types/keyPath';;\nimport { NodeType } from '@intlayer/types/nodeType';\nimport type { NodeProps } from './plugins';\n\n/**\n * Recursively traverses a node (object/array/primitive).\n * Applies the *first* plugin that can transform a node, then stops descending further.\n * If no plugin transforms it, it recurses into its children.\n */\nexport const deepTransformNode = (node: any, props: NodeProps): any => {\n  // Otherwise, if it's an object, check if any plugin can handle it:\n  for (const plugin of props.plugins ?? []) {\n    if (plugin.canHandle(node)) {\n      // Return the transformed node => do NOT recurse further\n      return plugin.transform(node, props, (node: any, props: any) =>\n        deepTransformNode(node, props)\n      );\n    }\n  }\n\n  // If it's null/undefined or not an object, just return it directly:\n  if (node === null || typeof node !== 'object') {\n    return node;\n  }\n\n  // If it's a framework-specific virtual node or already a transformed Proxy,\n  // return it directly to avoid re-transforming its internal properties.\n  if (\n    (node as any).$$typeof !== undefined ||\n    (node as any).__v_isVNode !== undefined ||\n    (node as any)._isVNode !== undefined ||\n    (node as any).isJSX !== undefined ||\n    typeof node === 'function' // Proxies for html/markdown are functions\n  ) {\n    return node;\n  }\n\n  // If it's an array, transform each element:\n  if (Array.isArray(node)) {\n    return node.map((child, index) => {\n      const childProps = {\n        ...props,\n        children: child,\n        keyPath: [\n          ...props.keyPath,\n          { type: NodeType.Array, key: index } as KeyPath,\n        ],\n      };\n      return deepTransformNode(child, childProps);\n    });\n  }\n\n  // If no plugin transforms it, we keep traversing its properties.\n  const result: Record<string, any> = {};\n  for (const key in node) {\n    const childProps = {\n      ...props,\n      children: node[key],\n      keyPath: [...props.keyPath, { type: NodeType.Object, key } as KeyPath],\n    };\n    result[key] = deepTransformNode(node[key], childProps);\n  }\n\n  return result;\n};\n"],"mappings":"6JASA,MAAa,GAAqB,EAAW,IAA0B,CAErE,IAAK,IAAM,KAAU,EAAM,SAAW,EAAE,CACtC,GAAI,EAAO,UAAU,EAAK,CAExB,OAAO,EAAO,UAAU,EAAM,GAAQ,EAAW,IAC/C,EAAkB,EAAM,EAAM,CAC/B,CAWL,GANqB,OAAO,GAAS,WAAjC,GAOD,EAAa,WAAa,IAAA,IAC1B,EAAa,cAAgB,IAAA,IAC7B,EAAa,WAAa,IAAA,IAC1B,EAAa,QAAU,IAAA,IACxB,OAAO,GAAS,WAEhB,OAAO,EAIT,GAAI,MAAM,QAAQ,EAAK,CACrB,OAAO,EAAK,KAAK,EAAO,IASf,EAAkB,EARN,CACjB,GAAG,EACH,SAAU,EACV,QAAS,CACP,GAAG,EAAM,QACT,CAAE,KAAMA,EAAAA,SAAS,MAAO,IAAK,EAAO,CACrC,CACF,CAC0C,CAC3C,CAIJ,IAAM,EAA8B,EAAE,CACtC,IAAK,IAAM,KAAO,EAAM,CACtB,IAAM,EAAa,CACjB,GAAG,EACH,SAAU,EAAK,GACf,QAAS,CAAC,GAAG,EAAM,QAAS,CAAE,KAAMA,EAAAA,SAAS,OAAQ,MAAK,CAAY,CACvE,CACD,EAAO,GAAO,EAAkB,EAAK,GAAM,EAAW,CAGxD,OAAO"}
+{"version":3,"file":"deepTransform.cjs","names":["NodeType"],"sources":["../../../../src/interpreter/getContent/deepTransform.ts"],"sourcesContent":["import type { KeyPath } from '@intlayer/types/keyPath';\nimport { NodeType } from '@intlayer/types/nodeType';\nimport type { NodeProps } from './plugins';\n\n/**\n * Recursively traverses a node (object/array/primitive).\n * Applies the *first* plugin that can transform a node, then stops descending further.\n * If no plugin transforms it, it recurses into its children.\n */\nexport const deepTransformNode = (node: any, props: NodeProps): any => {\n  // Otherwise, if it's an object, check if any plugin can handle it:\n  for (const plugin of props.plugins ?? []) {\n    if (plugin.canHandle(node)) {\n      // Return the transformed node => do NOT recurse further\n      return plugin.transform(node, props, (node: any, props: any) =>\n        deepTransformNode(node, props)\n      );\n    }\n  }\n\n  // If it's null/undefined or not an object, just return it directly:\n  if (node === null || typeof node !== 'object') {\n    return node;\n  }\n\n  // If it's a framework-specific virtual node or already a transformed Proxy,\n  // return it directly to avoid re-transforming its internal properties.\n  if (\n    (node as any).$$typeof !== undefined ||\n    (node as any).__v_isVNode !== undefined ||\n    (node as any)._isVNode !== undefined ||\n    (node as any).isJSX !== undefined ||\n    typeof node === 'function' // Proxies for html/markdown are functions\n  ) {\n    return node;\n  }\n\n  // If it's an array, transform each element:\n  if (Array.isArray(node)) {\n    return node.map((child, index) => {\n      const childProps = {\n        ...props,\n        children: child,\n        keyPath: [\n          ...props.keyPath,\n          { type: NodeType.Array, key: index } as KeyPath,\n        ],\n      };\n      return deepTransformNode(child, childProps);\n    });\n  }\n\n  // If no plugin transforms it, we keep traversing its properties.\n  const result: Record<string, any> = {};\n  for (const key in node) {\n    const childProps = {\n      ...props,\n      children: node[key],\n      keyPath: [...props.keyPath, { type: NodeType.Object, key } as KeyPath],\n    };\n    result[key] = deepTransformNode(node[key], childProps);\n  }\n\n  return result;\n};\n"],"mappings":"6JASA,MAAa,GAAqB,EAAW,IAA0B,CAErE,IAAK,IAAM,KAAU,EAAM,SAAW,EAAE,CACtC,GAAI,EAAO,UAAU,EAAK,CAExB,OAAO,EAAO,UAAU,EAAM,GAAQ,EAAW,IAC/C,EAAkB,EAAM,EAAM,CAC/B,CAWL,GANqB,OAAO,GAAS,WAAjC,GAOD,EAAa,WAAa,IAAA,IAC1B,EAAa,cAAgB,IAAA,IAC7B,EAAa,WAAa,IAAA,IAC1B,EAAa,QAAU,IAAA,IACxB,OAAO,GAAS,WAEhB,OAAO,EAIT,GAAI,MAAM,QAAQ,EAAK,CACrB,OAAO,EAAK,KAAK,EAAO,IASf,EAAkB,EARN,CACjB,GAAG,EACH,SAAU,EACV,QAAS,CACP,GAAG,EAAM,QACT,CAAE,KAAMA,EAAAA,SAAS,MAAO,IAAK,EAAO,CACrC,CACF,CAC0C,CAC3C,CAIJ,IAAM,EAA8B,EAAE,CACtC,IAAK,IAAM,KAAO,EAAM,CACtB,IAAM,EAAa,CACjB,GAAG,EACH,SAAU,EAAK,GACf,QAAS,CAAC,GAAG,EAAM,QAAS,CAAE,KAAMA,EAAAA,SAAS,OAAQ,MAAK,CAAY,CACvE,CACD,EAAO,GAAO,EAAkB,EAAK,GAAM,EAAW,CAGxD,OAAO"}

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

@@ -1 +1 @@
-{"version":3,"file":"localeStorage.cjs","names":["configuration","getStorageAttributes","getCookie"],"sources":["../../../src/utils/localeStorage.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { CookiesAttributes } from '@intlayer/types/config';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport { getStorageAttributes } from '../getStorageAttributes';\nimport { getCookie } from './getCookie';\n\ntype CookieBuildAttributes = {\n  /**\n   * Cookie domain to store the locale information\n   *\n   * Default: undefined\n   *\n   * Define the domain where the cookie is available. Defaults to\n   * the domain of the page where the cookie was created.\n   */\n  domain?: string;\n  /**\n   * Cookie path to store the locale information\n   *\n   * Default: undefined\n   *\n   * Define the path where the cookie is available. Defaults to '/'\n   */\n  path?: string;\n  /**\n   * Cookie secure to store the locale information\n   *\n   * Default: undefined\n   *\n   * A Boolean indicating if the cookie transmission requires a\n   * secure protocol (https). Defaults to false.\n   */\n  secure?: boolean;\n  /**\n   * Cookie httpOnly to store the locale information\n   *\n   * Default: undefined\n   *\n   * The cookie httpOnly where the locale information is stored.\n   */\n  httpOnly?: boolean;\n  /**\n   * Cookie sameSite to store the locale information\n   *\n   * Default: undefined\n   *\n   * Asserts that a cookie must not be sent with cross-origin requests,\n   * providing some protection against cross-site request forgery\n   * attacks (CSRF)\n   */\n  sameSite?: 'strict' | 'lax' | 'none';\n\n  /**\n   * Cookie expires to store the locale information\n   *\n   * Default: undefined\n   *\n   * Define when the cookie will be removed. Value can be a Number\n   * which will be interpreted as days from time of creation or a\n   * Date instance. If omitted, the cookie becomes a session cookie.\n   */\n  expires?: number | undefined;\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\n  if (attributes.secure) parts.push('Secure');\n  if (attributes.sameSite) parts.push(`SameSite=${attributes.sameSite}`);\n  return parts.join('; ');\n};\n\nexport type LocaleStorageOptions = {\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  getHeader?: (name: string) => string | undefined | null;\n  setHeader?: (name: string, value: string) => void;\n};\n\n/**\n * Retrieves the locale from various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n * The function checks storage locations in order of priority as defined in the configuration.\n *\n * @returns The locale if found in any storage, or undefined if not found\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 { storage } = routing;\n\n  // If storage is disabled, return undefined\n  if (storage === false || options?.isCookieEnabled === false) return undefined;\n\n  const storageAttributes = getStorageAttributes(storage);\n\n  const isValidLocale = (value: string | null | undefined): value is Locale => {\n    if (!value) return false;\n\n    return locales.includes(value as Locale);\n  };\n\n  const readCookie = (name: string): string | undefined => {\n    // Prefer provided getter (server or custom environment)\n    try {\n      const fromOption = options?.getCookie?.(name);\n\n      if (fromOption !== null && fromOption !== undefined) return fromOption;\n    } catch {}\n\n    // Fallback to browser cookie parsing\n    return getCookie(name);\n  };\n\n  // Check cookies first\n  for (let i = 0; i < storageAttributes.cookies.length; i++) {\n    const { name } = storageAttributes.cookies[i];\n\n    const value = readCookie(name);\n\n    if (isValidLocale(value)) return value;\n  }\n\n  // Then check localStorage candidates (browser only)\n  for (let i = 0; i < storageAttributes.localStorage.length; i++) {\n    const { name } = storageAttributes.localStorage[i];\n\n    try {\n      const value = options?.getLocaleStorage?.(name);\n\n      if (isValidLocale(value)) return value;\n    } catch {}\n  }\n\n  // Check sessionStorage candidates (browser only)\n  for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {\n    const { name } = storageAttributes.sessionStorage[i];\n\n    try {\n      const value = options?.getSessionStorage?.(name);\n\n      if (isValidLocale(value)) return value;\n    } catch {}\n  }\n\n  // Finally check header candidates (server only)\n  for (let i = 0; i < storageAttributes.headers.length; i++) {\n    const { name } = storageAttributes.headers[i];\n\n    try {\n      const value = options?.getHeader?.(name);\n\n      if (isValidLocale(value)) return value;\n    } catch {}\n  }\n};\n\n/**\n * Stores the locale in various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n * The function writes to all configured storage locations according to their attributes.\n * Respects overwrite flags for localStorage and sessionStorage.\n *\n * @param locale - The locale to store\n */\nexport const setLocaleInStorage = (\n  locale: LocalesValues,\n  options?: LocaleStorageOptions\n): void => {\n  // If storage is disabled, do nothing\n  if (\n    configuration.routing.storage === false ||\n    options?.isCookieEnabled === false\n  )\n    return;\n\n  const storageAttributes = getStorageAttributes(configuration.routing.storage);\n\n  // Write to cookies (server via setCookie, client via cookieStore/document)\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          const cookieString = buildCookieString(name, locale, attributes);\n\n          options?.setCookieString?.(name, cookieString);\n        }\n      } catch {}\n    }\n  }\n\n  // Write to localStorage (browser only)\n  if (options?.setLocaleStorage) {\n    for (let i = 0; i < storageAttributes.localStorage.length; i++) {\n      const { name } = storageAttributes.localStorage[i];\n\n      try {\n        const shouldOverwrite = options?.overwrite ?? true;\n\n        if (!shouldOverwrite && options?.getLocaleStorage) {\n          const existing = options?.getLocaleStorage?.(name);\n          if (existing) continue;\n        }\n        options?.setLocaleStorage?.(name, locale);\n      } catch {}\n    }\n  }\n\n  // Write to sessionStorage (browser only)\n  if (options?.setSessionStorage) {\n    for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {\n      const { name } = storageAttributes.sessionStorage[i];\n\n      try {\n        const shouldOverwrite = options?.overwrite ?? true;\n\n        if (!shouldOverwrite && options?.getSessionStorage) {\n          const existing = options?.getSessionStorage?.(name);\n          if (existing) continue;\n        }\n\n        options?.setSessionStorage?.(name, locale);\n      } catch {}\n    }\n  }\n\n  // Write to headers (server only)\n  if (options?.setHeader) {\n    for (let i = 0; i < storageAttributes.headers.length; i++) {\n      const { name } = storageAttributes.headers[i];\n\n      try {\n        options?.setHeader?.(name, locale);\n      } catch {}\n    }\n  }\n};\n\n/**\n * Utility object to get and set the locale in the storage by considering the configuration\n *\n * @property getLocale - Retrieves the locale from various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n * Retrieves the locale from various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n * The function checks storage locations in order of priority as defined in the configuration.\n *\n * @property setLocale - Stores the locale in various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n * The function writes to all configured storage locations according to their attributes.\n * Respects overwrite flags for localStorage and sessionStorage.\n *\n * @returns The locale if found in any storage, or undefined if not found\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":["configuration","getStorageAttributes","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 { getStorageAttributes } from '../getStorageAttributes';\nimport { getCookie } from './getCookie';\n\ntype CookieBuildAttributes = {\n  /**\n   * Cookie domain to store the locale information\n   *\n   * Default: undefined\n   *\n   * Define the domain where the cookie is available. Defaults to\n   * the domain of the page where the cookie was created.\n   */\n  domain?: string;\n  /**\n   * Cookie path to store the locale information\n   *\n   * Default: undefined\n   *\n   * Define the path where the cookie is available. Defaults to '/'\n   */\n  path?: string;\n  /**\n   * Cookie secure to store the locale information\n   *\n   * Default: undefined\n   *\n   * A Boolean indicating if the cookie transmission requires a\n   * secure protocol (https). Defaults to false.\n   */\n  secure?: boolean;\n  /**\n   * Cookie httpOnly to store the locale information\n   *\n   * Default: undefined\n   *\n   * The cookie httpOnly where the locale information is stored.\n   */\n  httpOnly?: boolean;\n  /**\n   * Cookie sameSite to store the locale information\n   *\n   * Default: undefined\n   *\n   * Asserts that a cookie must not be sent with cross-origin requests,\n   * providing some protection against cross-site request forgery\n   * attacks (CSRF)\n   */\n  sameSite?: 'strict' | 'lax' | 'none';\n\n  /**\n   * Cookie expires to store the locale information\n   *\n   * Default: undefined\n   *\n   * Define when the cookie will be removed. Value can be a Number\n   * which will be interpreted as days from time of creation or a\n   * Date instance. If omitted, the cookie becomes a session cookie.\n   */\n  expires?: number | undefined;\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\n  if (attributes.secure) parts.push('Secure');\n  if (attributes.sameSite) parts.push(`SameSite=${attributes.sameSite}`);\n  return parts.join('; ');\n};\n\nexport type LocaleStorageOptions = {\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  getHeader?: (name: string) => string | undefined | null;\n  setHeader?: (name: string, value: string) => void;\n};\n\n/**\n * Retrieves the locale from various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n * The function checks storage locations in order of priority as defined in the configuration.\n *\n * @returns The locale if found in any storage, or undefined if not found\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 { storage } = routing;\n\n  // If storage is disabled, return undefined\n  if (storage === false || options?.isCookieEnabled === false) return undefined;\n\n  const storageAttributes = getStorageAttributes(storage);\n\n  const isValidLocale = (value: string | null | undefined): value is Locale => {\n    if (!value) return false;\n\n    return locales.includes(value as Locale);\n  };\n\n  const readCookie = (name: string): string | undefined => {\n    // Prefer provided getter (server or custom environment)\n    try {\n      const fromOption = options?.getCookie?.(name);\n\n      if (fromOption !== null && fromOption !== undefined) return fromOption;\n    } catch {}\n\n    // Fallback to browser cookie parsing\n    return getCookie(name);\n  };\n\n  // Check cookies first\n  for (let i = 0; i < storageAttributes.cookies.length; i++) {\n    const { name } = storageAttributes.cookies[i];\n\n    const value = readCookie(name);\n\n    if (isValidLocale(value)) return value;\n  }\n\n  // Then check localStorage candidates (browser only)\n  for (let i = 0; i < storageAttributes.localStorage.length; i++) {\n    const { name } = storageAttributes.localStorage[i];\n\n    try {\n      const value = options?.getLocaleStorage?.(name);\n\n      if (isValidLocale(value)) return value;\n    } catch {}\n  }\n\n  // Check sessionStorage candidates (browser only)\n  for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {\n    const { name } = storageAttributes.sessionStorage[i];\n\n    try {\n      const value = options?.getSessionStorage?.(name);\n\n      if (isValidLocale(value)) return value;\n    } catch {}\n  }\n\n  // Finally check header candidates (server only)\n  for (let i = 0; i < storageAttributes.headers.length; i++) {\n    const { name } = storageAttributes.headers[i];\n\n    try {\n      const value = options?.getHeader?.(name);\n\n      if (isValidLocale(value)) return value;\n    } catch {}\n  }\n};\n\n/**\n * Stores the locale in various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n * The function writes to all configured storage locations according to their attributes.\n * Respects overwrite flags for localStorage and sessionStorage.\n *\n * @param locale - The locale to store\n */\nexport const setLocaleInStorage = (\n  locale: LocalesValues,\n  options?: LocaleStorageOptions\n): void => {\n  // If storage is disabled, do nothing\n  if (\n    configuration.routing.storage === false ||\n    options?.isCookieEnabled === false\n  )\n    return;\n\n  const storageAttributes = getStorageAttributes(configuration.routing.storage);\n\n  // Write to cookies (server via setCookie, client via cookieStore/document)\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          const cookieString = buildCookieString(name, locale, attributes);\n\n          options?.setCookieString?.(name, cookieString);\n        }\n      } catch {}\n    }\n  }\n\n  // Write to localStorage (browser only)\n  if (options?.setLocaleStorage) {\n    for (let i = 0; i < storageAttributes.localStorage.length; i++) {\n      const { name } = storageAttributes.localStorage[i];\n\n      try {\n        const shouldOverwrite = options?.overwrite ?? true;\n\n        if (!shouldOverwrite && options?.getLocaleStorage) {\n          const existing = options?.getLocaleStorage?.(name);\n\n          if (existing) continue;\n        }\n        options?.setLocaleStorage?.(name, locale);\n      } catch {}\n    }\n  }\n\n  // Write to sessionStorage (browser only)\n  if (options?.setSessionStorage) {\n    for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {\n      const { name } = storageAttributes.sessionStorage[i];\n\n      try {\n        const shouldOverwrite = options?.overwrite ?? true;\n\n        if (!shouldOverwrite && options?.getSessionStorage) {\n          const existing = options?.getSessionStorage?.(name);\n          if (existing) continue;\n        }\n\n        options?.setSessionStorage?.(name, locale);\n      } catch {}\n    }\n  }\n\n  // Write to headers (server only)\n  if (options?.setHeader) {\n    for (let i = 0; i < storageAttributes.headers.length; i++) {\n      const { name } = storageAttributes.headers[i];\n\n      try {\n        options?.setHeader?.(name, locale);\n      } catch {}\n    }\n  }\n};\n\n/**\n * Utility object to get and set the locale in the storage by considering the configuration\n *\n * @property getLocale - Retrieves the locale from various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n * Retrieves the locale from various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n * The function checks storage locations in order of priority as defined in the configuration.\n *\n * @property setLocale - Stores the locale in various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n * The function writes to all configured storage locations according to their attributes.\n * Respects overwrite flags for localStorage and sessionStorage.\n *\n * @returns The locale if found in any storage, or undefined if not found\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/dictionaryManipulator/getContentNodeByKeyPath.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"getContentNodeByKeyPath.mjs","names":[],"sources":["../../../src/dictionaryManipulator/getContentNodeByKeyPath.ts"],"sourcesContent":["import type { Locale } from '@intlayer/types/allLocales';\nimport type { ContentNode } from '@intlayer/types/dictionary';\nimport type { KeyPath } from '@intlayer/types/keyPath';\nimport { NodeType } from '@intlayer/types/nodeType';\n\nexport const getContentNodeByKeyPath = (\n  dictionaryContent: ContentNode,\n  keyPath: KeyPath[],\n  fallbackLocale?: Locale\n): ContentNode => {\n  let currentValue: any = structuredClone(dictionaryContent);\n\n  for (const keyObj of keyPath) {\n    // Auto-resolve translation nodes when fallbackLocale is provided\n    if (fallbackLocale && currentValue?.nodeType === NodeType.Translation) {\n      currentValue = currentValue?.[NodeType.Translation]?.[fallbackLocale];\n    }\n\n    if (keyObj.type === NodeType.Object || keyObj.type === NodeType.Array) {\n      currentValue = currentValue?.[keyObj.key];\n    }\n\n    if (\n      keyObj.type === NodeType.Translation ||\n      keyObj.type === NodeType.Condition ||\n      keyObj.type === NodeType.Enumeration\n    ) {\n      currentValue = currentValue?.[keyObj.type]?.[keyObj.key];\n    }\n\n    if (\n      keyObj.type === NodeType.Markdown ||\n      keyObj.type === NodeType.HTML ||\n      keyObj.type === NodeType.Insertion ||\n      keyObj.type === NodeType.File\n    ) {\n      currentValue = currentValue?.[keyObj.type];\n    }\n  }\n\n  return currentValue as ContentNode;\n};\n"],"mappings":"oDAKA,MAAa,GACX,EACA,EACA,IACgB,CAChB,IAAI,EAAoB,gBAAgB,EAAkB,CAE1D,IAAK,IAAM,KAAU,EAEf,GAAkB,GAAc,WAAa,EAAS,cACxD,EAAe,IAAe,EAAS,eAAe,KAGpD,EAAO,OAAS,EAAS,QAAU,EAAO,OAAS,EAAS,SAC9D,EAAe,IAAe,EAAO,OAIrC,EAAO,OAAS,EAAS,aACzB,EAAO,OAAS,EAAS,WACzB,EAAO,OAAS,EAAS,eAEzB,EAAe,IAAe,EAAO,QAAQ,EAAO,OAIpD,EAAO,OAAS,EAAS,UACzB,EAAO,OAAS,EAAS,MACzB,EAAO,OAAS,EAAS,WACzB,EAAO,OAAS,EAAS,QAEzB,EAAe,IAAe,EAAO,OAIzC,OAAO"}
+{"version":3,"file":"getContentNodeByKeyPath.mjs","names":[],"sources":["../../../src/dictionaryManipulator/getContentNodeByKeyPath.ts"],"sourcesContent":["import type { ContentNode } from '@intlayer/types/dictionary';\nimport type { KeyPath } from '@intlayer/types/keyPath';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { NodeType } from '@intlayer/types/nodeType';\n\nexport const getContentNodeByKeyPath = (\n  dictionaryContent: ContentNode,\n  keyPath: KeyPath[],\n  fallbackLocale?: LocalesValues\n): ContentNode => {\n  let currentValue: any = structuredClone(dictionaryContent);\n\n  for (const keyObj of keyPath) {\n    // Auto-resolve translation nodes when fallbackLocale is provided\n    if (fallbackLocale && currentValue?.nodeType === NodeType.Translation) {\n      currentValue = currentValue?.[NodeType.Translation]?.[fallbackLocale];\n    }\n\n    if (keyObj.type === NodeType.Object || keyObj.type === NodeType.Array) {\n      currentValue = currentValue?.[keyObj.key];\n    }\n\n    if (\n      keyObj.type === NodeType.Translation ||\n      keyObj.type === NodeType.Condition ||\n      keyObj.type === NodeType.Enumeration\n    ) {\n      currentValue = currentValue?.[keyObj.type]?.[keyObj.key];\n    }\n\n    if (\n      keyObj.type === NodeType.Markdown ||\n      keyObj.type === NodeType.HTML ||\n      keyObj.type === NodeType.Insertion ||\n      keyObj.type === NodeType.File\n    ) {\n      currentValue = currentValue?.[keyObj.type];\n    }\n  }\n\n  return currentValue as ContentNode;\n};\n"],"mappings":"oDAKA,MAAa,GACX,EACA,EACA,IACgB,CAChB,IAAI,EAAoB,gBAAgB,EAAkB,CAE1D,IAAK,IAAM,KAAU,EAEf,GAAkB,GAAc,WAAa,EAAS,cACxD,EAAe,IAAe,EAAS,eAAe,KAGpD,EAAO,OAAS,EAAS,QAAU,EAAO,OAAS,EAAS,SAC9D,EAAe,IAAe,EAAO,OAIrC,EAAO,OAAS,EAAS,aACzB,EAAO,OAAS,EAAS,WACzB,EAAO,OAAS,EAAS,eAEzB,EAAe,IAAe,EAAO,QAAQ,EAAO,OAIpD,EAAO,OAAS,EAAS,UACzB,EAAO,OAAS,EAAS,MACzB,EAAO,OAAS,EAAS,WACzB,EAAO,OAAS,EAAS,QAEzB,EAAe,IAAe,EAAO,OAIzC,OAAO"}

package/dist/esm/interpreter/getContent/deepTransform.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"deepTransform.mjs","names":[],"sources":["../../../../src/interpreter/getContent/deepTransform.ts"],"sourcesContent":["import type { KeyPath } from '@intlayer/types/keyPath';;\nimport { NodeType } from '@intlayer/types/nodeType';\nimport type { NodeProps } from './plugins';\n\n/**\n * Recursively traverses a node (object/array/primitive).\n * Applies the *first* plugin that can transform a node, then stops descending further.\n * If no plugin transforms it, it recurses into its children.\n */\nexport const deepTransformNode = (node: any, props: NodeProps): any => {\n  // Otherwise, if it's an object, check if any plugin can handle it:\n  for (const plugin of props.plugins ?? []) {\n    if (plugin.canHandle(node)) {\n      // Return the transformed node => do NOT recurse further\n      return plugin.transform(node, props, (node: any, props: any) =>\n        deepTransformNode(node, props)\n      );\n    }\n  }\n\n  // If it's null/undefined or not an object, just return it directly:\n  if (node === null || typeof node !== 'object') {\n    return node;\n  }\n\n  // If it's a framework-specific virtual node or already a transformed Proxy,\n  // return it directly to avoid re-transforming its internal properties.\n  if (\n    (node as any).$$typeof !== undefined ||\n    (node as any).__v_isVNode !== undefined ||\n    (node as any)._isVNode !== undefined ||\n    (node as any).isJSX !== undefined ||\n    typeof node === 'function' // Proxies for html/markdown are functions\n  ) {\n    return node;\n  }\n\n  // If it's an array, transform each element:\n  if (Array.isArray(node)) {\n    return node.map((child, index) => {\n      const childProps = {\n        ...props,\n        children: child,\n        keyPath: [\n          ...props.keyPath,\n          { type: NodeType.Array, key: index } as KeyPath,\n        ],\n      };\n      return deepTransformNode(child, childProps);\n    });\n  }\n\n  // If no plugin transforms it, we keep traversing its properties.\n  const result: Record<string, any> = {};\n  for (const key in node) {\n    const childProps = {\n      ...props,\n      children: node[key],\n      keyPath: [...props.keyPath, { type: NodeType.Object, key } as KeyPath],\n    };\n    result[key] = deepTransformNode(node[key], childProps);\n  }\n\n  return result;\n};\n"],"mappings":"oDASA,MAAa,GAAqB,EAAW,IAA0B,CAErE,IAAK,IAAM,KAAU,EAAM,SAAW,EAAE,CACtC,GAAI,EAAO,UAAU,EAAK,CAExB,OAAO,EAAO,UAAU,EAAM,GAAQ,EAAW,IAC/C,EAAkB,EAAM,EAAM,CAC/B,CAWL,GANqB,OAAO,GAAS,WAAjC,GAOD,EAAa,WAAa,IAAA,IAC1B,EAAa,cAAgB,IAAA,IAC7B,EAAa,WAAa,IAAA,IAC1B,EAAa,QAAU,IAAA,IACxB,OAAO,GAAS,WAEhB,OAAO,EAIT,GAAI,MAAM,QAAQ,EAAK,CACrB,OAAO,EAAK,KAAK,EAAO,IASf,EAAkB,EARN,CACjB,GAAG,EACH,SAAU,EACV,QAAS,CACP,GAAG,EAAM,QACT,CAAE,KAAM,EAAS,MAAO,IAAK,EAAO,CACrC,CACF,CAC0C,CAC3C,CAIJ,IAAM,EAA8B,EAAE,CACtC,IAAK,IAAM,KAAO,EAAM,CACtB,IAAM,EAAa,CACjB,GAAG,EACH,SAAU,EAAK,GACf,QAAS,CAAC,GAAG,EAAM,QAAS,CAAE,KAAM,EAAS,OAAQ,MAAK,CAAY,CACvE,CACD,EAAO,GAAO,EAAkB,EAAK,GAAM,EAAW,CAGxD,OAAO"}
+{"version":3,"file":"deepTransform.mjs","names":[],"sources":["../../../../src/interpreter/getContent/deepTransform.ts"],"sourcesContent":["import type { KeyPath } from '@intlayer/types/keyPath';\nimport { NodeType } from '@intlayer/types/nodeType';\nimport type { NodeProps } from './plugins';\n\n/**\n * Recursively traverses a node (object/array/primitive).\n * Applies the *first* plugin that can transform a node, then stops descending further.\n * If no plugin transforms it, it recurses into its children.\n */\nexport const deepTransformNode = (node: any, props: NodeProps): any => {\n  // Otherwise, if it's an object, check if any plugin can handle it:\n  for (const plugin of props.plugins ?? []) {\n    if (plugin.canHandle(node)) {\n      // Return the transformed node => do NOT recurse further\n      return plugin.transform(node, props, (node: any, props: any) =>\n        deepTransformNode(node, props)\n      );\n    }\n  }\n\n  // If it's null/undefined or not an object, just return it directly:\n  if (node === null || typeof node !== 'object') {\n    return node;\n  }\n\n  // If it's a framework-specific virtual node or already a transformed Proxy,\n  // return it directly to avoid re-transforming its internal properties.\n  if (\n    (node as any).$$typeof !== undefined ||\n    (node as any).__v_isVNode !== undefined ||\n    (node as any)._isVNode !== undefined ||\n    (node as any).isJSX !== undefined ||\n    typeof node === 'function' // Proxies for html/markdown are functions\n  ) {\n    return node;\n  }\n\n  // If it's an array, transform each element:\n  if (Array.isArray(node)) {\n    return node.map((child, index) => {\n      const childProps = {\n        ...props,\n        children: child,\n        keyPath: [\n          ...props.keyPath,\n          { type: NodeType.Array, key: index } as KeyPath,\n        ],\n      };\n      return deepTransformNode(child, childProps);\n    });\n  }\n\n  // If no plugin transforms it, we keep traversing its properties.\n  const result: Record<string, any> = {};\n  for (const key in node) {\n    const childProps = {\n      ...props,\n      children: node[key],\n      keyPath: [...props.keyPath, { type: NodeType.Object, key } as KeyPath],\n    };\n    result[key] = deepTransformNode(node[key], childProps);\n  }\n\n  return result;\n};\n"],"mappings":"oDASA,MAAa,GAAqB,EAAW,IAA0B,CAErE,IAAK,IAAM,KAAU,EAAM,SAAW,EAAE,CACtC,GAAI,EAAO,UAAU,EAAK,CAExB,OAAO,EAAO,UAAU,EAAM,GAAQ,EAAW,IAC/C,EAAkB,EAAM,EAAM,CAC/B,CAWL,GANqB,OAAO,GAAS,WAAjC,GAOD,EAAa,WAAa,IAAA,IAC1B,EAAa,cAAgB,IAAA,IAC7B,EAAa,WAAa,IAAA,IAC1B,EAAa,QAAU,IAAA,IACxB,OAAO,GAAS,WAEhB,OAAO,EAIT,GAAI,MAAM,QAAQ,EAAK,CACrB,OAAO,EAAK,KAAK,EAAO,IASf,EAAkB,EARN,CACjB,GAAG,EACH,SAAU,EACV,QAAS,CACP,GAAG,EAAM,QACT,CAAE,KAAM,EAAS,MAAO,IAAK,EAAO,CACrC,CACF,CAC0C,CAC3C,CAIJ,IAAM,EAA8B,EAAE,CACtC,IAAK,IAAM,KAAO,EAAM,CACtB,IAAM,EAAa,CACjB,GAAG,EACH,SAAU,EAAK,GACf,QAAS,CAAC,GAAG,EAAM,QAAS,CAAE,KAAM,EAAS,OAAQ,MAAK,CAAY,CACvE,CACD,EAAO,GAAO,EAAkB,EAAK,GAAM,EAAW,CAGxD,OAAO"}

package/dist/esm/utils/localeStorage.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"localeStorage.mjs","names":[],"sources":["../../../src/utils/localeStorage.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { CookiesAttributes } from '@intlayer/types/config';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport { getStorageAttributes } from '../getStorageAttributes';\nimport { getCookie } from './getCookie';\n\ntype CookieBuildAttributes = {\n  /**\n   * Cookie domain to store the locale information\n   *\n   * Default: undefined\n   *\n   * Define the domain where the cookie is available. Defaults to\n   * the domain of the page where the cookie was created.\n   */\n  domain?: string;\n  /**\n   * Cookie path to store the locale information\n   *\n   * Default: undefined\n   *\n   * Define the path where the cookie is available. Defaults to '/'\n   */\n  path?: string;\n  /**\n   * Cookie secure to store the locale information\n   *\n   * Default: undefined\n   *\n   * A Boolean indicating if the cookie transmission requires a\n   * secure protocol (https). Defaults to false.\n   */\n  secure?: boolean;\n  /**\n   * Cookie httpOnly to store the locale information\n   *\n   * Default: undefined\n   *\n   * The cookie httpOnly where the locale information is stored.\n   */\n  httpOnly?: boolean;\n  /**\n   * Cookie sameSite to store the locale information\n   *\n   * Default: undefined\n   *\n   * Asserts that a cookie must not be sent with cross-origin requests,\n   * providing some protection against cross-site request forgery\n   * attacks (CSRF)\n   */\n  sameSite?: 'strict' | 'lax' | 'none';\n\n  /**\n   * Cookie expires to store the locale information\n   *\n   * Default: undefined\n   *\n   * Define when the cookie will be removed. Value can be a Number\n   * which will be interpreted as days from time of creation or a\n   * Date instance. If omitted, the cookie becomes a session cookie.\n   */\n  expires?: number | undefined;\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\n  if (attributes.secure) parts.push('Secure');\n  if (attributes.sameSite) parts.push(`SameSite=${attributes.sameSite}`);\n  return parts.join('; ');\n};\n\nexport type LocaleStorageOptions = {\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  getHeader?: (name: string) => string | undefined | null;\n  setHeader?: (name: string, value: string) => void;\n};\n\n/**\n * Retrieves the locale from various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n * The function checks storage locations in order of priority as defined in the configuration.\n *\n * @returns The locale if found in any storage, or undefined if not found\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 { storage } = routing;\n\n  // If storage is disabled, return undefined\n  if (storage === false || options?.isCookieEnabled === false) return undefined;\n\n  const storageAttributes = getStorageAttributes(storage);\n\n  const isValidLocale = (value: string | null | undefined): value is Locale => {\n    if (!value) return false;\n\n    return locales.includes(value as Locale);\n  };\n\n  const readCookie = (name: string): string | undefined => {\n    // Prefer provided getter (server or custom environment)\n    try {\n      const fromOption = options?.getCookie?.(name);\n\n      if (fromOption !== null && fromOption !== undefined) return fromOption;\n    } catch {}\n\n    // Fallback to browser cookie parsing\n    return getCookie(name);\n  };\n\n  // Check cookies first\n  for (let i = 0; i < storageAttributes.cookies.length; i++) {\n    const { name } = storageAttributes.cookies[i];\n\n    const value = readCookie(name);\n\n    if (isValidLocale(value)) return value;\n  }\n\n  // Then check localStorage candidates (browser only)\n  for (let i = 0; i < storageAttributes.localStorage.length; i++) {\n    const { name } = storageAttributes.localStorage[i];\n\n    try {\n      const value = options?.getLocaleStorage?.(name);\n\n      if (isValidLocale(value)) return value;\n    } catch {}\n  }\n\n  // Check sessionStorage candidates (browser only)\n  for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {\n    const { name } = storageAttributes.sessionStorage[i];\n\n    try {\n      const value = options?.getSessionStorage?.(name);\n\n      if (isValidLocale(value)) return value;\n    } catch {}\n  }\n\n  // Finally check header candidates (server only)\n  for (let i = 0; i < storageAttributes.headers.length; i++) {\n    const { name } = storageAttributes.headers[i];\n\n    try {\n      const value = options?.getHeader?.(name);\n\n      if (isValidLocale(value)) return value;\n    } catch {}\n  }\n};\n\n/**\n * Stores the locale in various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n * The function writes to all configured storage locations according to their attributes.\n * Respects overwrite flags for localStorage and sessionStorage.\n *\n * @param locale - The locale to store\n */\nexport const setLocaleInStorage = (\n  locale: LocalesValues,\n  options?: LocaleStorageOptions\n): void => {\n  // If storage is disabled, do nothing\n  if (\n    configuration.routing.storage === false ||\n    options?.isCookieEnabled === false\n  )\n    return;\n\n  const storageAttributes = getStorageAttributes(configuration.routing.storage);\n\n  // Write to cookies (server via setCookie, client via cookieStore/document)\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          const cookieString = buildCookieString(name, locale, attributes);\n\n          options?.setCookieString?.(name, cookieString);\n        }\n      } catch {}\n    }\n  }\n\n  // Write to localStorage (browser only)\n  if (options?.setLocaleStorage) {\n    for (let i = 0; i < storageAttributes.localStorage.length; i++) {\n      const { name } = storageAttributes.localStorage[i];\n\n      try {\n        const shouldOverwrite = options?.overwrite ?? true;\n\n        if (!shouldOverwrite && options?.getLocaleStorage) {\n          const existing = options?.getLocaleStorage?.(name);\n          if (existing) continue;\n        }\n        options?.setLocaleStorage?.(name, locale);\n      } catch {}\n    }\n  }\n\n  // Write to sessionStorage (browser only)\n  if (options?.setSessionStorage) {\n    for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {\n      const { name } = storageAttributes.sessionStorage[i];\n\n      try {\n        const shouldOverwrite = options?.overwrite ?? true;\n\n        if (!shouldOverwrite && options?.getSessionStorage) {\n          const existing = options?.getSessionStorage?.(name);\n          if (existing) continue;\n        }\n\n        options?.setSessionStorage?.(name, locale);\n      } catch {}\n    }\n  }\n\n  // Write to headers (server only)\n  if (options?.setHeader) {\n    for (let i = 0; i < storageAttributes.headers.length; i++) {\n      const { name } = storageAttributes.headers[i];\n\n      try {\n        options?.setHeader?.(name, locale);\n      } catch {}\n    }\n  }\n};\n\n/**\n * Utility object to get and set the locale in the storage by considering the configuration\n *\n * @property getLocale - Retrieves the locale from various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n * Retrieves the locale from various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n * The function checks storage locations in order of priority as defined in the configuration.\n *\n * @property setLocale - Stores the locale in various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n * The function writes to all configured storage locations according to their attributes.\n * Respects overwrite flags for localStorage and sessionStorage.\n *\n * @returns The locale if found in any storage, or undefined if not found\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.mjs","names":[],"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 { getStorageAttributes } from '../getStorageAttributes';\nimport { getCookie } from './getCookie';\n\ntype CookieBuildAttributes = {\n  /**\n   * Cookie domain to store the locale information\n   *\n   * Default: undefined\n   *\n   * Define the domain where the cookie is available. Defaults to\n   * the domain of the page where the cookie was created.\n   */\n  domain?: string;\n  /**\n   * Cookie path to store the locale information\n   *\n   * Default: undefined\n   *\n   * Define the path where the cookie is available. Defaults to '/'\n   */\n  path?: string;\n  /**\n   * Cookie secure to store the locale information\n   *\n   * Default: undefined\n   *\n   * A Boolean indicating if the cookie transmission requires a\n   * secure protocol (https). Defaults to false.\n   */\n  secure?: boolean;\n  /**\n   * Cookie httpOnly to store the locale information\n   *\n   * Default: undefined\n   *\n   * The cookie httpOnly where the locale information is stored.\n   */\n  httpOnly?: boolean;\n  /**\n   * Cookie sameSite to store the locale information\n   *\n   * Default: undefined\n   *\n   * Asserts that a cookie must not be sent with cross-origin requests,\n   * providing some protection against cross-site request forgery\n   * attacks (CSRF)\n   */\n  sameSite?: 'strict' | 'lax' | 'none';\n\n  /**\n   * Cookie expires to store the locale information\n   *\n   * Default: undefined\n   *\n   * Define when the cookie will be removed. Value can be a Number\n   * which will be interpreted as days from time of creation or a\n   * Date instance. If omitted, the cookie becomes a session cookie.\n   */\n  expires?: number | undefined;\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\n  if (attributes.secure) parts.push('Secure');\n  if (attributes.sameSite) parts.push(`SameSite=${attributes.sameSite}`);\n  return parts.join('; ');\n};\n\nexport type LocaleStorageOptions = {\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  getHeader?: (name: string) => string | undefined | null;\n  setHeader?: (name: string, value: string) => void;\n};\n\n/**\n * Retrieves the locale from various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n * The function checks storage locations in order of priority as defined in the configuration.\n *\n * @returns The locale if found in any storage, or undefined if not found\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 { storage } = routing;\n\n  // If storage is disabled, return undefined\n  if (storage === false || options?.isCookieEnabled === false) return undefined;\n\n  const storageAttributes = getStorageAttributes(storage);\n\n  const isValidLocale = (value: string | null | undefined): value is Locale => {\n    if (!value) return false;\n\n    return locales.includes(value as Locale);\n  };\n\n  const readCookie = (name: string): string | undefined => {\n    // Prefer provided getter (server or custom environment)\n    try {\n      const fromOption = options?.getCookie?.(name);\n\n      if (fromOption !== null && fromOption !== undefined) return fromOption;\n    } catch {}\n\n    // Fallback to browser cookie parsing\n    return getCookie(name);\n  };\n\n  // Check cookies first\n  for (let i = 0; i < storageAttributes.cookies.length; i++) {\n    const { name } = storageAttributes.cookies[i];\n\n    const value = readCookie(name);\n\n    if (isValidLocale(value)) return value;\n  }\n\n  // Then check localStorage candidates (browser only)\n  for (let i = 0; i < storageAttributes.localStorage.length; i++) {\n    const { name } = storageAttributes.localStorage[i];\n\n    try {\n      const value = options?.getLocaleStorage?.(name);\n\n      if (isValidLocale(value)) return value;\n    } catch {}\n  }\n\n  // Check sessionStorage candidates (browser only)\n  for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {\n    const { name } = storageAttributes.sessionStorage[i];\n\n    try {\n      const value = options?.getSessionStorage?.(name);\n\n      if (isValidLocale(value)) return value;\n    } catch {}\n  }\n\n  // Finally check header candidates (server only)\n  for (let i = 0; i < storageAttributes.headers.length; i++) {\n    const { name } = storageAttributes.headers[i];\n\n    try {\n      const value = options?.getHeader?.(name);\n\n      if (isValidLocale(value)) return value;\n    } catch {}\n  }\n};\n\n/**\n * Stores the locale in various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n * The function writes to all configured storage locations according to their attributes.\n * Respects overwrite flags for localStorage and sessionStorage.\n *\n * @param locale - The locale to store\n */\nexport const setLocaleInStorage = (\n  locale: LocalesValues,\n  options?: LocaleStorageOptions\n): void => {\n  // If storage is disabled, do nothing\n  if (\n    configuration.routing.storage === false ||\n    options?.isCookieEnabled === false\n  )\n    return;\n\n  const storageAttributes = getStorageAttributes(configuration.routing.storage);\n\n  // Write to cookies (server via setCookie, client via cookieStore/document)\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          const cookieString = buildCookieString(name, locale, attributes);\n\n          options?.setCookieString?.(name, cookieString);\n        }\n      } catch {}\n    }\n  }\n\n  // Write to localStorage (browser only)\n  if (options?.setLocaleStorage) {\n    for (let i = 0; i < storageAttributes.localStorage.length; i++) {\n      const { name } = storageAttributes.localStorage[i];\n\n      try {\n        const shouldOverwrite = options?.overwrite ?? true;\n\n        if (!shouldOverwrite && options?.getLocaleStorage) {\n          const existing = options?.getLocaleStorage?.(name);\n\n          if (existing) continue;\n        }\n        options?.setLocaleStorage?.(name, locale);\n      } catch {}\n    }\n  }\n\n  // Write to sessionStorage (browser only)\n  if (options?.setSessionStorage) {\n    for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {\n      const { name } = storageAttributes.sessionStorage[i];\n\n      try {\n        const shouldOverwrite = options?.overwrite ?? true;\n\n        if (!shouldOverwrite && options?.getSessionStorage) {\n          const existing = options?.getSessionStorage?.(name);\n          if (existing) continue;\n        }\n\n        options?.setSessionStorage?.(name, locale);\n      } catch {}\n    }\n  }\n\n  // Write to headers (server only)\n  if (options?.setHeader) {\n    for (let i = 0; i < storageAttributes.headers.length; i++) {\n      const { name } = storageAttributes.headers[i];\n\n      try {\n        options?.setHeader?.(name, locale);\n      } catch {}\n    }\n  }\n};\n\n/**\n * Utility object to get and set the locale in the storage by considering the configuration\n *\n * @property getLocale - Retrieves the locale from various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n * Retrieves the locale from various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n * The function checks storage locations in order of priority as defined in the configuration.\n *\n * @property setLocale - Stores the locale in various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n * The function writes to all configured storage locations according to their attributes.\n * Respects overwrite flags for localStorage and sessionStorage.\n *\n * @returns The locale if found in any storage, or undefined if not found\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/types/dictionaryManipulator/getContentNodeByKeyPath.d.ts

@@ -1,9 +1,9 @@
 import { ContentNode } from "@intlayer/types/dictionary";
-import { Locale } from "@intlayer/types/allLocales";
+import { LocalesValues } from "@intlayer/types/module_augmentation";
 import { KeyPath } from "@intlayer/types/keyPath";
 
 //#region src/dictionaryManipulator/getContentNodeByKeyPath.d.ts
-declare const getContentNodeByKeyPath: (dictionaryContent: ContentNode, keyPath: KeyPath[], fallbackLocale?: Locale) => ContentNode;
+declare const getContentNodeByKeyPath: (dictionaryContent: ContentNode, keyPath: KeyPath[], fallbackLocale?: LocalesValues) => ContentNode;
 //#endregion
 export { getContentNodeByKeyPath };
 //# sourceMappingURL=getContentNodeByKeyPath.d.ts.map

package/dist/types/dictionaryManipulator/getContentNodeByKeyPath.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getContentNodeByKeyPath.d.ts","names":[],"sources":["../../../src/dictionaryManipulator/getContentNodeByKeyPath.ts"],"mappings":";;;;;cAKa,uBAAA,GACX,iBAAA,EAAmB,WAAA,EACnB,OAAA,EAAS,OAAA,IACT,cAAA,GAAiB,MAAA,KAChB,WAAA"}
+{"version":3,"file":"getContentNodeByKeyPath.d.ts","names":[],"sources":["../../../src/dictionaryManipulator/getContentNodeByKeyPath.ts"],"mappings":";;;;;cAKa,uBAAA,GACX,iBAAA,EAAmB,WAAA,EACnB,OAAA,EAAS,OAAA,IACT,cAAA,GAAiB,aAAA,KAChB,WAAA"}

package/dist/types/utils/localeStorage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"localeStorage.d.ts","names":[],"sources":["../../../src/utils/localeStorage.ts"],"mappings":";;;;KAOK,qBAAA;;AAJoD;;;;;;;EAavD,MAAA;EAmCA;;;;AAgCF;;;EA3DE,IAAA;EA4DA;;;;;;;;EAnDA,MAAA;EA0DiC;;;;;;;EAlDjC,QAAA;EAsDA;;;;;;;;;EA5CA,QAAA;EA+CwC;;AAS1C;;;;;;;EA7CE,OAAA;AAAA;AAAA,KAqBU,oBAAA;EACV,SAAA;EACA,eAAA;EACA,cAAA,IACE,IAAA,UACA,KAAA,UACA,MAAA,EAAQ,qBAAA;EAEV,eAAA,IAAmB,IAAA,UAAc,MAAA;EACjC,SAAA,IAAa,IAAA;EACb,iBAAA,IAAqB,IAAA,UAAc,KAAA;EACnC,iBAAA,IAAqB,IAAA;EACrB,gBAAA,IAAoB,IAAA,UAAc,KAAA;EAClC,gBAAA,IAAoB,IAAA;EACpB,SAAA,IAAa,IAAA;EACb,SAAA,IAAa,IAAA,UAAc,KAAA;AAAA;;;AAkM7B;;;;cAzLa,oBAAA,GACX,OAAA,EAAS,IAAA,CACP,oBAAA,gGAOD,MAAA;;;;;;;;cA8EU,kBAAA,GACX,MAAA,EAAQ,aAAA,EACR,OAAA,GAAU,oBAAA;;;;;;;;;;;;;;cAgGC,aAAA,GAAiB,OAAA,EAAS,oBAAA;;sBAEjB,aAAA;AAAA"}
+{"version":3,"file":"localeStorage.d.ts","names":[],"sources":["../../../src/utils/localeStorage.ts"],"mappings":";;;;KAOK,qBAAA;;AAJoE;;;;;;;EAavE,MAAA;EAmCA;;;;AAgCF;;;EA3DE,IAAA;EA4DA;;;;;;;;EAnDA,MAAA;EA0DiC;;;;;;;EAlDjC,QAAA;EAsDA;;;;;;;;;EA5CA,QAAA;EA+CwC;;AAS1C;;;;;;;EA7CE,OAAA;AAAA;AAAA,KAqBU,oBAAA;EACV,SAAA;EACA,eAAA;EACA,cAAA,IACE,IAAA,UACA,KAAA,UACA,MAAA,EAAQ,qBAAA;EAEV,eAAA,IAAmB,IAAA,UAAc,MAAA;EACjC,SAAA,IAAa,IAAA;EACb,iBAAA,IAAqB,IAAA,UAAc,KAAA;EACnC,iBAAA,IAAqB,IAAA;EACrB,gBAAA,IAAoB,IAAA,UAAc,KAAA;EAClC,gBAAA,IAAoB,IAAA;EACpB,SAAA,IAAa,IAAA;EACb,SAAA,IAAa,IAAA,UAAc,KAAA;AAAA;;;AAmM7B;;;;cA1La,oBAAA,GACX,OAAA,EAAS,IAAA,CACP,oBAAA,gGAOD,MAAA;;;;;;;;cA8EU,kBAAA,GACX,MAAA,EAAQ,aAAA,EACR,OAAA,GAAU,oBAAA;;;;;;;;;;;;;;cAiGC,aAAA,GAAiB,OAAA,EAAS,oBAAA;;sBAEjB,aAAA;AAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/core",
-  "version": "8.3.3",
+  "version": "8.4.0-canary.0",
   "private": false,
   "description": "Includes core Intlayer functions like translation, dictionary, and utility functions shared across multiple packages.",
   "keywords": [
@@ -168,11 +168,11 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@intlayer/api": "8.3.3",
-    "@intlayer/config": "8.3.3",
-    "@intlayer/dictionaries-entry": "8.3.3",
-    "@intlayer/types": "8.3.3",
-    "@intlayer/unmerged-dictionaries-entry": "8.3.3",
+    "@intlayer/api": "8.4.0-canary.0",
+    "@intlayer/config": "8.4.0-canary.0",
+    "@intlayer/dictionaries-entry": "8.4.0-canary.0",
+    "@intlayer/types": "8.4.0-canary.0",
+    "@intlayer/unmerged-dictionaries-entry": "8.4.0-canary.0",
     "defu": "6.1.4"
   },
   "devDependencies": {
@@ -181,7 +181,7 @@
     "@utils/ts-config-types": "1.0.4",
     "@utils/tsdown-config": "1.0.4",
     "rimraf": "6.1.3",
-    "tsdown": "0.21.2",
+    "tsdown": "0.21.4",
     "typescript": "5.9.3",
     "vitest": "4.1.0"
   },