@intlayer/core 8.4.4 → 8.4.6

package/dist/cjs/interpreter/getIntlayer.cjs

@@ -1 +1,41 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../getContent-DrqM8pqO.cjs`);exports.getIntlayer=e.d;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_interpreter_getDictionary = require('./getDictionary.cjs');
+let _intlayer_config_built = require("@intlayer/config/built");
+_intlayer_config_built = require_runtime.__toESM(_intlayer_config_built);
+let _intlayer_config_logger = require("@intlayer/config/logger");
+let _intlayer_dictionaries_entry = require("@intlayer/dictionaries-entry");
+
+//#region src/interpreter/getIntlayer.ts
+/**
+* Creates a Recursive Proxy that returns the path of the accessed key
+* stringified. This prevents the app from crashing on undefined access.
+*/
+const createSafeFallback = (path = "") => {
+	return new Proxy(() => path, {
+		get: (_target, prop) => {
+			if (prop === "toJSON" || prop === Symbol.toPrimitive || prop === "toString") return () => path;
+			if (prop === "then") return;
+			return createSafeFallback(path ? `${path}.${String(prop)}` : String(prop));
+		},
+		apply: () => {
+			return path;
+		}
+	});
+};
+const getIntlayer = (key, locale, plugins) => {
+	const dictionary = (0, _intlayer_dictionaries_entry.getDictionaries)()[key];
+	if (!dictionary) {
+		(0, _intlayer_config_logger.getAppLogger)(_intlayer_config_built.default)(`Dictionary ${(0, _intlayer_config_logger.colorizeKey)(key)} was not found. Using fallback proxy.`, {
+			level: "warn",
+			isVerbose: true
+		});
+		if (process.env.NODE_ENV === "development") return createSafeFallback(key);
+		return createSafeFallback(key);
+	}
+	return require_interpreter_getDictionary.getDictionary(dictionary, locale, plugins);
+};
+
+//#endregion
+exports.getIntlayer = getIntlayer;
+//# sourceMappingURL=getIntlayer.cjs.map

package/dist/cjs/interpreter/getIntlayer.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getIntlayer.cjs","names":["configuration","getDictionary"],"sources":["../../../src/interpreter/getIntlayer.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport { colorizeKey, getAppLogger } from '@intlayer/config/logger';\nimport { getDictionaries } from '@intlayer/dictionaries-entry';\nimport type {\n  DeclaredLocales,\n  DictionaryKeys,\n  DictionaryRegistryContent,\n  DictionaryRegistryElement,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport type {\n  DeepTransformContent,\n  IInterpreterPluginState,\n  Plugins,\n} from './getContent';\nimport { getDictionary } from './getDictionary';\n\n/**\n * Creates a Recursive Proxy that returns the path of the accessed key\n * stringified. This prevents the app from crashing on undefined access.\n */\nconst createSafeFallback = (path = ''): any => {\n  return new Proxy(\n    // Target is a function so it can be called if the dictionary expects a function\n    () => path,\n    {\n      get: (_target, prop) => {\n        // Handle common object methods to prevent infinite recursion or weird behavior\n        if (\n          prop === 'toJSON' ||\n          prop === Symbol.toPrimitive ||\n          prop === 'toString'\n        ) {\n          return () => path;\n        }\n        if (prop === 'then') {\n          return undefined; // Prevent it from being treated as a Promise\n        }\n\n        // Recursively build the path (e.g., \"myDictionary.home.title\")\n        const nextPath = path ? `${path}.${String(prop)}` : String(prop);\n        return createSafeFallback(nextPath);\n      },\n      // If the code tries to execute the missing key as a function: t.title()\n      apply: () => {\n        return path;\n      },\n    }\n  );\n};\n\nexport const getIntlayer = <\n  T extends DictionaryKeys,\n  L extends LocalesValues = DeclaredLocales,\n>(\n  key: T,\n  locale?: L,\n  plugins?: Plugins[]\n): DeepTransformContent<\n  DictionaryRegistryContent<T>,\n  IInterpreterPluginState,\n  L\n> => {\n  const dictionaries = getDictionaries();\n  const dictionary = dictionaries[key as T] as DictionaryRegistryElement<T>;\n\n  if (!dictionary) {\n    // Log a warning instead of throwing (so developers know it's missing)\n    const logger = getAppLogger(configuration);\n    logger(\n      `Dictionary ${colorizeKey(key as string)} was not found. Using fallback proxy.`,\n      {\n        level: 'warn',\n        isVerbose: true,\n      }\n    );\n\n    if (process.env.NODE_ENV === 'development') {\n      // Return the Safe Proxy\n      // We initialize it with the dictionary key name so the UI shows \"my-dictionary.someKey\"\n      return createSafeFallback(key as string);\n    }\n\n    return createSafeFallback(key as string);\n  }\n\n  return getDictionary<DictionaryRegistryElement<T>, L>(\n    dictionary,\n    locale,\n    plugins\n  );\n};\n"],"mappings":";;;;;;;;;;;;;AAqBA,MAAM,sBAAsB,OAAO,OAAY;AAC7C,QAAO,IAAI,YAEH,MACN;EACE,MAAM,SAAS,SAAS;AAEtB,OACE,SAAS,YACT,SAAS,OAAO,eAChB,SAAS,WAET,cAAa;AAEf,OAAI,SAAS,OACX;AAKF,UAAO,mBADU,OAAO,GAAG,KAAK,GAAG,OAAO,KAAK,KAAK,OAAO,KAAK,CAC7B;;EAGrC,aAAa;AACX,UAAO;;EAEV,CACF;;AAGH,MAAa,eAIX,KACA,QACA,YAKG;CAEH,MAAM,gEADgC,CACN;AAEhC,KAAI,CAAC,YAAY;AAGf,4CAD4BA,+BAAc,CAExC,uDAA0B,IAAc,CAAC,wCACzC;GACE,OAAO;GACP,WAAW;GACZ,CACF;AAED,MAAI,QAAQ,IAAI,aAAa,cAG3B,QAAO,mBAAmB,IAAc;AAG1C,SAAO,mBAAmB,IAAc;;AAG1C,QAAOC,gDACL,YACA,QACA,QACD"}

package/dist/cjs/interpreter/getNesting.cjs

@@ -1 +1,37 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../getContent-DrqM8pqO.cjs`);exports.getNesting=e.u;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_interpreter_getIntlayer = require('./getIntlayer.cjs');
+
+//#region src/interpreter/getNesting.ts
+/**
+* Extracts content from another dictionary by its key and an optional path.
+*
+* This allows for reusing content across different dictionaries.
+*
+* @param dictionaryKey - The key of the dictionary to nest.
+* @param path - Optional dot-separated path to a specific field within the nested dictionary.
+* @param props - Optional properties like locale and plugins.
+* @returns The nested content.
+*
+* @example
+* ```ts
+* const content = getNesting("common", "buttons.save");
+* // 'Save'
+* ```
+*/
+const getNesting = (dictionaryKey, path, props) => {
+	const dictionary = require_interpreter_getIntlayer.getIntlayer(dictionaryKey, props?.locale, props?.plugins);
+	if (typeof path === "string") {
+		const pathArray = path.split(".");
+		let current = dictionary;
+		for (const key of pathArray) {
+			current = current?.[key];
+			if (current === void 0) return dictionary;
+		}
+		return current;
+	}
+	return dictionary;
+};
+
+//#endregion
+exports.getNesting = getNesting;
+//# sourceMappingURL=getNesting.cjs.map

package/dist/cjs/interpreter/getNesting.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getNesting.cjs","names":["getIntlayer"],"sources":["../../../src/interpreter/getNesting.ts"],"sourcesContent":["import type { DictionaryKeys, DictionaryRegistryContent } from '@intlayer/types/module_augmentation';\nimport type { GetSubPath } from '@intlayer/types/dictionary';\nimport type { ValidDotPathsFor } from '../transpiler';\nimport type {\n  DeepTransformContent,\n  IInterpreterPluginState,\n  NodeProps,\n} from './getContent';\nimport { getIntlayer } from './getIntlayer';\n\nexport type GetNestingResult<\n  K extends DictionaryKeys,\n  P = undefined,\n  S = IInterpreterPluginState,\n> = GetSubPath<DeepTransformContent<DictionaryRegistryContent<K>, S>, P>;\n\n/**\n * Extracts content from another dictionary by its key and an optional path.\n *\n * This allows for reusing content across different dictionaries.\n *\n * @param dictionaryKey - The key of the dictionary to nest.\n * @param path - Optional dot-separated path to a specific field within the nested dictionary.\n * @param props - Optional properties like locale and plugins.\n * @returns The nested content.\n *\n * @example\n * ```ts\n * const content = getNesting(\"common\", \"buttons.save\");\n * // 'Save'\n * ```\n */\nexport const getNesting = <K extends DictionaryKeys, P>(\n  dictionaryKey: K,\n  path?: P extends ValidDotPathsFor<K> ? P : never,\n  props?: NodeProps\n): GetNestingResult<K, P> => {\n  const dictionary = getIntlayer(dictionaryKey, props?.locale, props?.plugins);\n\n  if (typeof path === 'string') {\n    const pathArray = (path as string).split('.');\n    let current: any = dictionary;\n\n    for (const key of pathArray) {\n      // Safely traverse down the object using the path\n      current = current?.[key];\n      // If we cannot find the path, return the whole dictionary as a fallback\n      if (current === undefined) {\n        return dictionary as any;\n      }\n    }\n\n    return current;\n  }\n\n  // Default or error handling if path is not a string or otherwise undefined\n  return dictionary as any;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAgCA,MAAa,cACX,eACA,MACA,UAC2B;CAC3B,MAAM,aAAaA,4CAAY,eAAe,OAAO,QAAQ,OAAO,QAAQ;AAE5E,KAAI,OAAO,SAAS,UAAU;EAC5B,MAAM,YAAa,KAAgB,MAAM,IAAI;EAC7C,IAAI,UAAe;AAEnB,OAAK,MAAM,OAAO,WAAW;AAE3B,aAAU,UAAU;AAEpB,OAAI,YAAY,OACd,QAAO;;AAIX,SAAO;;AAIT,QAAO"}

package/dist/cjs/interpreter/getTranslation.cjs

@@ -1,2 +1,88 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=e=>{if(typeof e!=`object`||!e||e instanceof Promise||typeof e.then==`function`||e.$$typeof!==void 0||e.__v_isVNode!==void 0||e._isVNode!==void 0||e.isJSX!==void 0)return!1;let t=Object.getPrototypeOf(e);return t===Object.prototype||t===null||Array.isArray(e)},t=(n,r)=>{if(n===void 0)return r;if(r===void 0||Array.isArray(n))return n;if(e(n)&&e(r)){let e={...n};for(let i of Object.keys(r))i===`__proto__`||i===`constructor`||(Object.hasOwn(n,i)?e[i]=t(n[i],r[i]):e[i]=r[i]);return e}return n},n=(t,r=new WeakSet)=>{if(typeof t!=`object`||!t||r.has(t)||(r.add(t),!e(t)))return t;if(Array.isArray(t))return t.map(e=>n(e,r));let i={};for(let[e,a]of Object.entries(t))a!==void 0&&(i[e]=n(a,r));return i},r=(e,r,i)=>{let a=[],o=t=>e[t],s=o(r);if(typeof s==`string`)return s;if(s!==void 0&&a.push(s),r.includes(`-`)){let t=r.split(`-`)[0];if(t in e){let e=o(t);if(typeof e==`string`){if(a.length===0)return e}else e!==void 0&&a.push(e)}}if(i!==void 0&&i!==r){if(i in e){let e=o(i);if(typeof e==`string`){if(a.length===0)return e}else e!==void 0&&a.push(e)}if(i.includes(`-`)){let t=i.split(`-`)[0];if(t!==r.split(`-`)[0]&&t in e){let e=o(t);if(typeof e==`string`){if(a.length===0)return e}else e!==void 0&&a.push(e)}}}if(a.length===0)return;let c=a.filter(e=>e!==void 0).map(e=>n(e));return c.length===1||Array.isArray(c[0])?c[0]:c.reduce((e,n)=>t(e,n))};exports.getTranslation=r;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/interpreter/getTranslation.ts
+/**
+* Check if a value is a plain object that can be safely merged.
+* Returns false for Promises, React elements, class instances, etc.
+*/
+const isPlainObject = (value) => {
+	if (value === null || typeof value !== "object") return false;
+	if (typeof value.then === "function") return false;
+	if (value.$$typeof !== void 0 || value.__v_isVNode !== void 0 || value._isVNode !== void 0 || value.isJSX !== void 0) return false;
+	const proto = Object.getPrototypeOf(value);
+	return proto === Object.prototype || proto === null || Array.isArray(value);
+};
+/**
+* Recursively merges two objects, skipping undefined source values.
+* First argument takes precedence. Arrays replace rather than merge.
+*/
+const deepMerge = (target, source) => {
+	if (target === void 0) return source;
+	if (source === void 0) return target;
+	if (Array.isArray(target)) return target;
+	if (isPlainObject(target) && isPlainObject(source)) {
+		const result = { ...target };
+		for (const key of Object.keys(source)) {
+			if (key === "__proto__" || key === "constructor" || source[key] === void 0) continue;
+			result[key] = target[key] !== void 0 ? deepMerge(target[key], source[key]) : source[key];
+		}
+		return result;
+	}
+	return target;
+};
+/**
+* Picks the appropriate content from a locale map based on the provided locale.
+*
+* It handles:
+* 1. Exact locale match (e.g., 'en-US').
+* 2. Generic locale fallback (e.g., 'en' if 'en-US' is not found).
+* 3. Explicit fallback locale.
+* 4. Deep merging of objects to ensure partial translations are complemented by fallbacks.
+*
+* @param languageContent - A map of locales to content.
+* @param locale - The target locale to retrieve.
+* @param fallback - Optional fallback locale if the target is not found.
+* @returns The translated content.
+*
+* @example
+* ```ts
+* const content = getTranslation({
+*   en: 'Hello',
+*   fr: 'Bonjour',
+* }, 'fr');
+* // 'Bonjour'
+* ```
+*/
+const getTranslation = (languageContent, locale, fallback) => {
+	const get = (loc) => languageContent[loc];
+	const seen = /* @__PURE__ */ new Set();
+	const locales = [];
+	const addLocale = (loc) => {
+		if (loc && !seen.has(loc)) {
+			seen.add(loc);
+			locales.push(loc);
+		}
+	};
+	addLocale(locale);
+	if (locale.includes("-")) addLocale(locale.split("-")[0]);
+	addLocale(fallback);
+	if (fallback?.includes("-")) addLocale(fallback.split("-")[0]);
+	const results = [];
+	for (const loc of locales) {
+		const val = get(loc);
+		if (val === void 0) continue;
+		if (typeof val === "string") {
+			if (results.length === 0) return val;
+			continue;
+		}
+		results.push(val);
+	}
+	if (results.length === 0) return void 0;
+	if (results.length === 1) return results[0];
+	if (Array.isArray(results[0])) return results[0];
+	return results.reduce((acc, curr) => deepMerge(acc, curr));
+};
+
+//#endregion
+exports.getTranslation = getTranslation;
 //# sourceMappingURL=getTranslation.cjs.map

package/dist/cjs/interpreter/getTranslation.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"getTranslation.cjs","names":[],"sources":["../../../src/interpreter/getTranslation.ts"],"sourcesContent":["import type {\n  LocalesValues,\n  StrictModeLocaleMap,\n} from '@intlayer/types/module_augmentation';\n\n/**\n * Check if a value is a plain object that can be safely processed.\n * Returns false for Promises, React elements, class instances, etc.\n */\nconst isPlainObject = (value: unknown): boolean => {\n  if (value === null || typeof value !== 'object') {\n    return false;\n  }\n\n  // Don't process Promises (e.g., Next.js 15+ params)\n  if (value instanceof Promise || typeof (value as any).then === 'function') {\n    return false;\n  }\n\n  // Don't process React elements or other framework VNodes\n  if (\n    (value as any).$$typeof !== undefined ||\n    (value as any).__v_isVNode !== undefined ||\n    (value as any)._isVNode !== undefined ||\n    (value as any).isJSX !== undefined\n  ) {\n    return false;\n  }\n\n  // Only process plain objects and arrays\n  const proto = Object.getPrototypeOf(value);\n  return proto === Object.prototype || proto === null || Array.isArray(value);\n};\n\n/**\n * Recursively merges two objects.\n * Resembles the behavior of `defu` but respects `isPlainObject` to avoid merging React elements.\n * Arrays are replaced, not merged.\n */\nconst deepMergeObjects = (target: any, source: any): any => {\n  if (target === undefined) return source;\n  if (source === undefined) return target;\n\n  if (Array.isArray(target)) return target;\n\n  if (isPlainObject(target) && isPlainObject(source)) {\n    const result = { ...target };\n    for (const key of Object.keys(source)) {\n      if (key === '__proto__' || key === 'constructor') continue;\n\n      if (Object.hasOwn(target, key)) {\n        result[key] = deepMergeObjects(target[key], source[key]);\n      } else {\n        result[key] = source[key];\n      }\n    }\n    return result;\n  }\n\n  return target;\n};\n\n/**\n * Recursively removes undefined values from an object.\n * Handles circular references by tracking visited objects.\n */\nconst removeUndefinedValues = <T>(\n  object: T,\n  visited = new WeakSet<object>()\n): T => {\n  if (typeof object !== 'object' || object === null) {\n    return object;\n  }\n\n  // Handle circular references - return original to avoid infinite recursion\n  if (visited.has(object)) {\n    return object;\n  }\n  visited.add(object);\n\n  // Don't process non-plain objects (Promises, React elements, etc.)\n  if (!isPlainObject(object)) {\n    return object;\n  }\n\n  if (Array.isArray(object)) {\n    return object.map((item) => removeUndefinedValues(item, visited)) as T;\n  }\n\n  const result: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(object)) {\n    if (value !== undefined) {\n      result[key] = removeUndefinedValues(value, visited);\n    }\n  }\n  return result as T;\n};\n\n/**\n * Picks the appropriate content from a locale map based on the provided locale.\n *\n * It handles:\n * 1. Exact locale match (e.g., 'en-US').\n * 2. Generic locale fallback (e.g., 'en' if 'en-US' is not found).\n * 3. Explicit fallback locale.\n * 4. Deep merging of objects to ensure partial translations are complemented by fallbacks.\n *\n * @param languageContent - A map of locales to content.\n * @param locale - The target locale to retrieve.\n * @param fallback - Optional fallback locale if the target is not found.\n * @returns The translated content.\n *\n * @example\n * ```ts\n * const content = getTranslation({\n *   en: 'Hello',\n *   fr: 'Bonjour',\n * }, 'fr');\n * // 'Bonjour'\n * ```\n */\nexport const getTranslation = <Content = string>(\n  languageContent: StrictModeLocaleMap<Content>,\n  locale: LocalesValues,\n  fallback?: LocalesValues\n): Content => {\n  const results: Content[] = [];\n\n  const getContent = (loc: string) =>\n    languageContent[loc as keyof typeof languageContent];\n\n  // Get Target Content\n  const content = getContent(locale);\n  if (typeof content === 'string') {\n    return content;\n  } else if (content !== undefined) {\n    results.push(content);\n  }\n\n  // Get Target Generic Content (e.g. 'en' from 'en-US')\n  if (locale.includes('-')) {\n    const genericLocale = locale.split('-')[0];\n    if (genericLocale in languageContent) {\n      const genericContent = getContent(genericLocale);\n\n      if (typeof genericContent === 'string') {\n        // If we haven't found specific content yet, return generic string\n        if (results.length === 0) return genericContent;\n      } else if (genericContent !== undefined) {\n        results.push(genericContent);\n      }\n    }\n  }\n\n  // Get Fallback Content\n  if (fallback !== undefined && fallback !== locale) {\n    // 3a. Fallback Specific\n    if (fallback in languageContent) {\n      const fallbackContent = getContent(fallback);\n\n      if (typeof fallbackContent === 'string') {\n        if (results.length === 0) return fallbackContent;\n      } else if (fallbackContent !== undefined) {\n        results.push(fallbackContent);\n      }\n    }\n\n    // Fallback Generic (The missing piece: e.g. 'en' from 'en-GB' fallback)\n    if (fallback.includes('-')) {\n      const genericFallback = fallback.split('-')[0];\n      const genericLocale = locale.split('-')[0];\n\n      // Only add if it's different from the target generic (to avoid duplication)\n      // and exists in the dictionary\n      if (\n        genericFallback !== genericLocale &&\n        genericFallback in languageContent\n      ) {\n        const genericFallbackContent = getContent(genericFallback);\n\n        if (typeof genericFallbackContent === 'string') {\n          if (results.length === 0) return genericFallbackContent;\n        } else if (genericFallbackContent !== undefined) {\n          results.push(genericFallbackContent);\n        }\n      }\n    }\n  }\n\n  if (results.length === 0) {\n    return undefined as Content;\n  }\n\n  // Clean undefined values so they don't overwrite fallbacks\n  // Order: [Target, Generic, Fallback, FallbackGeneric]\n  // defu first argument takes precedence, so Target wins\n  const cleanResults = results\n    .filter((item) => typeof item !== 'undefined')\n    .map((item) => removeUndefinedValues(item));\n\n  // If only one result, return it directly (no merging needed)\n  if (cleanResults.length === 1) {\n    return cleanResults[0];\n  }\n\n  // If the first result is an array, return it directly (arrays replace, don't merge)\n  // defu would incorrectly convert arrays to objects with numeric keys\n  if (Array.isArray(cleanResults[0])) {\n    return cleanResults[0];\n  }\n\n  // Merge objects with custom merge - first argument takes precedence\n  // Cast to object[] since by this point we've already returned early for strings, arrays, and single results\n  return (cleanResults as object[]).reduce((acc, curr) =>\n    deepMergeObjects(acc, curr)\n  ) as Content;\n};\n"],"mappings":"mEASA,MAAM,EAAiB,GAA4B,CAWjD,GAVsB,OAAO,GAAU,WAAnC,GAKA,aAAiB,SAAW,OAAQ,EAAc,MAAS,YAM5D,EAAc,WAAa,IAAA,IAC3B,EAAc,cAAgB,IAAA,IAC9B,EAAc,WAAa,IAAA,IAC3B,EAAc,QAAU,IAAA,GAEzB,MAAO,GAIT,IAAM,EAAQ,OAAO,eAAe,EAAM,CAC1C,OAAO,IAAU,OAAO,WAAa,IAAU,MAAQ,MAAM,QAAQ,EAAM,EAQvE,GAAoB,EAAa,IAAqB,CAC1D,GAAI,IAAW,IAAA,GAAW,OAAO,EAGjC,GAFI,IAAW,IAAA,IAEX,MAAM,QAAQ,EAAO,CAAE,OAAO,EAElC,GAAI,EAAc,EAAO,EAAI,EAAc,EAAO,CAAE,CAClD,IAAM,EAAS,CAAE,GAAG,EAAQ,CAC5B,IAAK,IAAM,KAAO,OAAO,KAAK,EAAO,CAC/B,IAAQ,aAAe,IAAQ,gBAE/B,OAAO,OAAO,EAAQ,EAAI,CAC5B,EAAO,GAAO,EAAiB,EAAO,GAAM,EAAO,GAAK,CAExD,EAAO,GAAO,EAAO,IAGzB,OAAO,EAGT,OAAO,GAOH,GACJ,EACA,EAAU,IAAI,UACR,CAYN,GAXI,OAAO,GAAW,WAAY,GAK9B,EAAQ,IAAI,EAAO,GAGvB,EAAQ,IAAI,EAAO,CAGf,CAAC,EAAc,EAAO,EACxB,OAAO,EAGT,GAAI,MAAM,QAAQ,EAAO,CACvB,OAAO,EAAO,IAAK,GAAS,EAAsB,EAAM,EAAQ,CAAC,CAGnE,IAAM,EAAkC,EAAE,CAC1C,IAAK,GAAM,CAAC,EAAK,KAAU,OAAO,QAAQ,EAAO,CAC3C,IAAU,IAAA,KACZ,EAAO,GAAO,EAAsB,EAAO,EAAQ,EAGvD,OAAO,GA0BI,GACX,EACA,EACA,IACY,CACZ,IAAM,EAAqB,EAAE,CAEvB,EAAc,GAClB,EAAgB,GAGZ,EAAU,EAAW,EAAO,CAClC,GAAI,OAAO,GAAY,SACrB,OAAO,EAMT,GALW,IAAY,IAAA,IACrB,EAAQ,KAAK,EAAQ,CAInB,EAAO,SAAS,IAAI,CAAE,CACxB,IAAM,EAAgB,EAAO,MAAM,IAAI,CAAC,GACxC,GAAI,KAAiB,EAAiB,CACpC,IAAM,EAAiB,EAAW,EAAc,CAEhD,GAAI,OAAO,GAAmB,aAExB,EAAQ,SAAW,EAAG,OAAO,OACxB,IAAmB,IAAA,IAC5B,EAAQ,KAAK,EAAe,EAMlC,GAAI,IAAa,IAAA,IAAa,IAAa,EAAQ,CAEjD,GAAI,KAAY,EAAiB,CAC/B,IAAM,EAAkB,EAAW,EAAS,CAE5C,GAAI,OAAO,GAAoB,aACzB,EAAQ,SAAW,EAAG,OAAO,OACxB,IAAoB,IAAA,IAC7B,EAAQ,KAAK,EAAgB,CAKjC,GAAI,EAAS,SAAS,IAAI,CAAE,CAC1B,IAAM,EAAkB,EAAS,MAAM,IAAI,CAAC,GAK5C,GACE,IALoB,EAAO,MAAM,IAAI,CAAC,IAMtC,KAAmB,EACnB,CACA,IAAM,EAAyB,EAAW,EAAgB,CAE1D,GAAI,OAAO,GAA2B,aAChC,EAAQ,SAAW,EAAG,OAAO,OACxB,IAA2B,IAAA,IACpC,EAAQ,KAAK,EAAuB,GAM5C,GAAI,EAAQ,SAAW,EACrB,OAMF,IAAM,EAAe,EAClB,OAAQ,GAAgB,IAAS,OAAY,CAC7C,IAAK,GAAS,EAAsB,EAAK,CAAC,CAe7C,OAZI,EAAa,SAAW,GAMxB,MAAM,QAAQ,EAAa,GAAG,CACzB,EAAa,GAKd,EAA0B,QAAQ,EAAK,IAC7C,EAAiB,EAAK,EAAK,CAC5B"}
+{"version":3,"file":"getTranslation.cjs","names":[],"sources":["../../../src/interpreter/getTranslation.ts"],"sourcesContent":["import type {\n  LocalesValues,\n  StrictModeLocaleMap,\n} from '@intlayer/types/module_augmentation';\n\n/**\n * Check if a value is a plain object that can be safely merged.\n * Returns false for Promises, React elements, class instances, etc.\n */\nconst isPlainObject = (value: unknown): boolean => {\n  if (value === null || typeof value !== 'object') return false;\n  if (typeof (value as any).then === 'function') return false;\n  if (\n    (value as any).$$typeof !== undefined ||\n    (value as any).__v_isVNode !== undefined ||\n    (value as any)._isVNode !== undefined ||\n    (value as any).isJSX !== undefined\n  ) {\n    return false;\n  }\n  const proto = Object.getPrototypeOf(value);\n  return proto === Object.prototype || proto === null || Array.isArray(value);\n};\n\n/**\n * Recursively merges two objects, skipping undefined source values.\n * First argument takes precedence. Arrays replace rather than merge.\n */\nconst deepMerge = (target: any, source: any): any => {\n  if (target === undefined) return source;\n  if (source === undefined) return target;\n  if (Array.isArray(target)) return target;\n  if (isPlainObject(target) && isPlainObject(source)) {\n    const result = { ...target };\n\n    for (const key of Object.keys(source)) {\n      if (\n        key === '__proto__' ||\n        key === 'constructor' ||\n        source[key] === undefined\n      )\n        continue;\n      result[key] =\n        target[key] !== undefined\n          ? deepMerge(target[key], source[key])\n          : source[key];\n    }\n    return result;\n  }\n  return target;\n};\n\n/**\n * Picks the appropriate content from a locale map based on the provided locale.\n *\n * It handles:\n * 1. Exact locale match (e.g., 'en-US').\n * 2. Generic locale fallback (e.g., 'en' if 'en-US' is not found).\n * 3. Explicit fallback locale.\n * 4. Deep merging of objects to ensure partial translations are complemented by fallbacks.\n *\n * @param languageContent - A map of locales to content.\n * @param locale - The target locale to retrieve.\n * @param fallback - Optional fallback locale if the target is not found.\n * @returns The translated content.\n *\n * @example\n * ```ts\n * const content = getTranslation({\n *   en: 'Hello',\n *   fr: 'Bonjour',\n * }, 'fr');\n * // 'Bonjour'\n * ```\n */\nexport const getTranslation = <Content = string>(\n  languageContent: StrictModeLocaleMap<Content>,\n  locale: LocalesValues,\n  fallback?: LocalesValues\n): Content => {\n  const get = (loc: string): Content | undefined =>\n    languageContent[loc as keyof typeof languageContent];\n\n  // Build priority-ordered locale candidates (most specific first), deduped\n  const seen = new Set<string>();\n  const locales: string[] = [];\n  const addLocale = (loc: string | undefined) => {\n    if (loc && !seen.has(loc)) {\n      seen.add(loc);\n      locales.push(loc);\n    }\n  };\n\n  addLocale(locale);\n  if (locale.includes('-')) addLocale(locale.split('-')[0]);\n\n  addLocale(fallback);\n  if (fallback?.includes('-')) addLocale(fallback.split('-')[0]);\n\n  // Collect results: strings exit early (if no higher-priority object was found),\n  // objects are accumulated for deep merging.\n  const results: Content[] = [];\n\n  for (const loc of locales) {\n    const val = get(loc);\n\n    if (val === undefined) continue;\n    if (typeof val === 'string') {\n      if (results.length === 0) return val;\n      continue; // an object at higher priority takes precedence\n    }\n\n    results.push(val);\n  }\n\n  if (results.length === 0) return undefined as Content;\n  if (results.length === 1) return results[0];\n  if (Array.isArray(results[0])) return results[0];\n\n  // Merge objects: first result (most specific) takes precedence\n  return (results as object[]).reduce((acc, curr) =>\n    deepMerge(acc, curr)\n  ) as Content;\n};\n"],"mappings":";;;;;;;AASA,MAAM,iBAAiB,UAA4B;AACjD,KAAI,UAAU,QAAQ,OAAO,UAAU,SAAU,QAAO;AACxD,KAAI,OAAQ,MAAc,SAAS,WAAY,QAAO;AACtD,KACG,MAAc,aAAa,UAC3B,MAAc,gBAAgB,UAC9B,MAAc,aAAa,UAC3B,MAAc,UAAU,OAEzB,QAAO;CAET,MAAM,QAAQ,OAAO,eAAe,MAAM;AAC1C,QAAO,UAAU,OAAO,aAAa,UAAU,QAAQ,MAAM,QAAQ,MAAM;;;;;;AAO7E,MAAM,aAAa,QAAa,WAAqB;AACnD,KAAI,WAAW,OAAW,QAAO;AACjC,KAAI,WAAW,OAAW,QAAO;AACjC,KAAI,MAAM,QAAQ,OAAO,CAAE,QAAO;AAClC,KAAI,cAAc,OAAO,IAAI,cAAc,OAAO,EAAE;EAClD,MAAM,SAAS,EAAE,GAAG,QAAQ;AAE5B,OAAK,MAAM,OAAO,OAAO,KAAK,OAAO,EAAE;AACrC,OACE,QAAQ,eACR,QAAQ,iBACR,OAAO,SAAS,OAEhB;AACF,UAAO,OACL,OAAO,SAAS,SACZ,UAAU,OAAO,MAAM,OAAO,KAAK,GACnC,OAAO;;AAEf,SAAO;;AAET,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;AA0BT,MAAa,kBACX,iBACA,QACA,aACY;CACZ,MAAM,OAAO,QACX,gBAAgB;CAGlB,MAAM,uBAAO,IAAI,KAAa;CAC9B,MAAM,UAAoB,EAAE;CAC5B,MAAM,aAAa,QAA4B;AAC7C,MAAI,OAAO,CAAC,KAAK,IAAI,IAAI,EAAE;AACzB,QAAK,IAAI,IAAI;AACb,WAAQ,KAAK,IAAI;;;AAIrB,WAAU,OAAO;AACjB,KAAI,OAAO,SAAS,IAAI,CAAE,WAAU,OAAO,MAAM,IAAI,CAAC,GAAG;AAEzD,WAAU,SAAS;AACnB,KAAI,UAAU,SAAS,IAAI,CAAE,WAAU,SAAS,MAAM,IAAI,CAAC,GAAG;CAI9D,MAAM,UAAqB,EAAE;AAE7B,MAAK,MAAM,OAAO,SAAS;EACzB,MAAM,MAAM,IAAI,IAAI;AAEpB,MAAI,QAAQ,OAAW;AACvB,MAAI,OAAO,QAAQ,UAAU;AAC3B,OAAI,QAAQ,WAAW,EAAG,QAAO;AACjC;;AAGF,UAAQ,KAAK,IAAI;;AAGnB,KAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,KAAI,QAAQ,WAAW,EAAG,QAAO,QAAQ;AACzC,KAAI,MAAM,QAAQ,QAAQ,GAAG,CAAE,QAAO,QAAQ;AAG9C,QAAQ,QAAqB,QAAQ,KAAK,SACxC,UAAU,KAAK,KAAK,CACrB"}

package/dist/cjs/interpreter/index.cjs

@@ -1 +1,32 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./getCondition.cjs`),t=require(`./getContent/deepTransform.cjs`),n=require(`./getEnumeration.cjs`),r=require(`../getContent-DrqM8pqO.cjs`),i=require(`./getTranslation.cjs`),a=require(`./getHTML.cjs`),o=require(`./splitAndJoinInsertion.cjs`);exports.conditionPlugin=r.r,exports.deepTransformNode=t.deepTransformNode,exports.enumerationPlugin=r.i,exports.filePlugin=r.a,exports.findMatchingCondition=n.findMatchingCondition,exports.genderPlugin=r.o,exports.getBasePlugins=r.t,exports.getCondition=e.getCondition,exports.getContent=r.n,exports.getDictionary=r.f,exports.getEnumeration=n.getEnumeration,exports.getHTML=a.getHTML,exports.getIntlayer=r.d,exports.getNesting=r.u,exports.getTranslation=i.getTranslation,exports.insertionPlugin=r.s,exports.nestedPlugin=r.c,exports.splitInsertionTemplate=o.splitInsertionTemplate,exports.translationPlugin=r.l;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_interpreter_getCondition = require('./getCondition.cjs');
+const require_interpreter_getContent_deepTransform = require('./getContent/deepTransform.cjs');
+const require_interpreter_getEnumeration = require('./getEnumeration.cjs');
+const require_interpreter_getDictionary = require('./getDictionary.cjs');
+const require_interpreter_getIntlayer = require('./getIntlayer.cjs');
+const require_interpreter_getNesting = require('./getNesting.cjs');
+const require_interpreter_getTranslation = require('./getTranslation.cjs');
+const require_interpreter_getContent_plugins = require('./getContent/plugins.cjs');
+const require_interpreter_getContent_getContent = require('./getContent/getContent.cjs');
+const require_interpreter_getHTML = require('./getHTML.cjs');
+const require_interpreter_splitAndJoinInsertion = require('./splitAndJoinInsertion.cjs');
+
+exports.conditionPlugin = require_interpreter_getContent_plugins.conditionPlugin;
+exports.deepTransformNode = require_interpreter_getContent_deepTransform.deepTransformNode;
+exports.enumerationPlugin = require_interpreter_getContent_plugins.enumerationPlugin;
+exports.filePlugin = require_interpreter_getContent_plugins.filePlugin;
+exports.findMatchingCondition = require_interpreter_getEnumeration.findMatchingCondition;
+exports.genderPlugin = require_interpreter_getContent_plugins.genderPlugin;
+exports.getBasePlugins = require_interpreter_getContent_getContent.getBasePlugins;
+exports.getCondition = require_interpreter_getCondition.getCondition;
+exports.getContent = require_interpreter_getContent_getContent.getContent;
+exports.getDictionary = require_interpreter_getDictionary.getDictionary;
+exports.getEnumeration = require_interpreter_getEnumeration.getEnumeration;
+exports.getHTML = require_interpreter_getHTML.getHTML;
+exports.getIntlayer = require_interpreter_getIntlayer.getIntlayer;
+exports.getNesting = require_interpreter_getNesting.getNesting;
+exports.getTranslation = require_interpreter_getTranslation.getTranslation;
+exports.insertionPlugin = require_interpreter_getContent_plugins.insertionPlugin;
+exports.nestedPlugin = require_interpreter_getContent_plugins.nestedPlugin;
+exports.splitInsertionTemplate = require_interpreter_splitAndJoinInsertion.splitInsertionTemplate;
+exports.translationPlugin = require_interpreter_getContent_plugins.translationPlugin;

package/dist/cjs/interpreter/splitAndJoinInsertion.cjs

@@ -1,2 +1,56 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=e=>e!=null&&typeof e!=`string`&&typeof e!=`number`&&typeof e!=`boolean`,t=(t,n={})=>{let r=n??{};if(!Object.values(r).some(e))return{isSimple:!0,parts:t.replace(/\{\{\s*(.*?)\s*\}\}/g,(e,t)=>(r[t.trim()]??``).toString())};let i=[],a=0,o=/\{\{\s*(.*?)\s*\}\}/g,s=o.exec(t);for(;s!==null;){s.index>a&&i.push(t.substring(a,s.index));let e=r[s[1].trim()];e!=null&&i.push(e),a=s.index+s[0].length,s=o.exec(t)}return a<t.length&&i.push(t.substring(a)),{isSimple:!1,parts:i}};exports.splitInsertionTemplate=t;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/interpreter/splitAndJoinInsertion.ts
+/**
+* Check if a value is a complex object (not a primitive)
+* Used to determine if values need to be wrapped in fragments
+*/
+const isComplexValue = (value) => {
+	return value !== null && value !== void 0 && typeof value !== "string" && typeof value !== "number" && typeof value !== "boolean";
+};
+/**
+* Core logic for splitting insertion strings and joining with values.
+* Returns an array of parts that can be wrapped by framework-specific Fragment implementations.
+*
+* @param template - The template string with {{ placeholder }} syntax
+* @param values - Map of placeholder names to their replacement values
+* @returns Object with `isSimple` flag and `parts` array
+*
+* @example
+* ```ts
+* const result = splitInsertionTemplate('Hello {{ name }}!', { name: 'World' });
+* // { isSimple: true, parts: 'Hello World!' }
+*
+* const result = splitInsertionTemplate('Hello {{ name }}!', { name: <Component /> });
+* // { isSimple: false, parts: ['Hello ', <Component />, '!'] }
+* ```
+*/
+const splitInsertionTemplate = (template, values = {}) => {
+	const safeValues = values ?? {};
+	if (!Object.values(safeValues).some(isComplexValue)) return {
+		isSimple: true,
+		parts: template.replace(/\{\{\s*(.*?)\s*\}\}/g, (_, key) => {
+			return (safeValues[key.trim()] ?? "").toString();
+		})
+	};
+	const parts = [];
+	let lastIndex = 0;
+	const regex = /\{\{\s*(.*?)\s*\}\}/g;
+	let match = regex.exec(template);
+	while (match !== null) {
+		if (match.index > lastIndex) parts.push(template.substring(lastIndex, match.index));
+		const value = safeValues[match[1].trim()];
+		if (value !== void 0 && value !== null) parts.push(value);
+		lastIndex = match.index + match[0].length;
+		match = regex.exec(template);
+	}
+	if (lastIndex < template.length) parts.push(template.substring(lastIndex));
+	return {
+		isSimple: false,
+		parts
+	};
+};
+
+//#endregion
+exports.splitInsertionTemplate = splitInsertionTemplate;
 //# sourceMappingURL=splitAndJoinInsertion.cjs.map

package/dist/cjs/interpreter/splitAndJoinInsertion.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"splitAndJoinInsertion.cjs","names":[],"sources":["../../../src/interpreter/splitAndJoinInsertion.ts"],"sourcesContent":["/**\n * Check if a value is a complex object (not a primitive)\n * Used to determine if values need to be wrapped in fragments\n */\nconst isComplexValue = (value: any): boolean => {\n  return (\n    value !== null &&\n    value !== undefined &&\n    typeof value !== 'string' &&\n    typeof value !== 'number' &&\n    typeof value !== 'boolean'\n  );\n};\n\n/**\n * Core logic for splitting insertion strings and joining with values.\n * Returns an array of parts that can be wrapped by framework-specific Fragment implementations.\n *\n * @param template - The template string with {{ placeholder }} syntax\n * @param values - Map of placeholder names to their replacement values\n * @returns Object with `isSimple` flag and `parts` array\n *\n * @example\n * ```ts\n * const result = splitInsertionTemplate('Hello {{ name }}!', { name: 'World' });\n * // { isSimple: true, parts: 'Hello World!' }\n *\n * const result = splitInsertionTemplate('Hello {{ name }}!', { name: <Component /> });\n * // { isSimple: false, parts: ['Hello ', <Component />, '!'] }\n * ```\n */\nexport const splitInsertionTemplate = <T = any>(\n  template: string,\n  values: Record<string, T> = {}\n): { isSimple: boolean; parts: string | T[] } => {\n  const safeValues = values ?? {};\n\n  // Check if any value is a complex object (React/Vue node, etc.)\n  const hasComplexValue = Object.values(safeValues).some(isComplexValue);\n\n  if (!hasComplexValue) {\n    // Simple string replacement\n    const result = template.replace(/\\{\\{\\s*(.*?)\\s*\\}\\}/g, (_, key) => {\n      const trimmedKey = key.trim();\n      return (safeValues[trimmedKey] ?? '').toString();\n    });\n    return { isSimple: true, parts: result };\n  }\n\n  // Split the template by placeholders while keeping the structure\n  const parts: any[] = [];\n  let lastIndex = 0;\n  const regex = /\\{\\{\\s*(.*?)\\s*\\}\\}/g;\n  let match: RegExpExecArray | null = regex.exec(template);\n\n  while (match !== null) {\n    // Add text before the placeholder\n    if (match.index > lastIndex) {\n      parts.push(template.substring(lastIndex, match.index));\n    }\n\n    // Add the replaced value\n    const key = match[1].trim();\n    const value = safeValues[key];\n    if (value !== undefined && value !== null) {\n      parts.push(value);\n    }\n\n    lastIndex = match.index + match[0].length;\n    match = regex.exec(template);\n  }\n\n  // Add remaining text\n  if (lastIndex < template.length) {\n    parts.push(template.substring(lastIndex));\n  }\n\n  return { isSimple: false, parts };\n};\n"],"mappings":"mEAIA,MAAM,EAAkB,GAEpB,GAAU,MAEV,OAAO,GAAU,UACjB,OAAO,GAAU,UACjB,OAAO,GAAU,UAqBR,GACX,EACA,EAA4B,EAAE,GACiB,CAC/C,IAAM,EAAa,GAAU,EAAE,CAK/B,GAAI,CAFoB,OAAO,OAAO,EAAW,CAAC,KAAK,EAAe,CAQpE,MAAO,CAAE,SAAU,GAAM,MAJV,EAAS,QAAQ,wBAAyB,EAAG,KAElD,EADW,EAAI,MAAM,GACK,IAAI,UAAU,CAChD,CACsC,CAI1C,IAAM,EAAe,EAAE,CACnB,EAAY,EACV,EAAQ,uBACV,EAAgC,EAAM,KAAK,EAAS,CAExD,KAAO,IAAU,MAAM,CAEjB,EAAM,MAAQ,GAChB,EAAM,KAAK,EAAS,UAAU,EAAW,EAAM,MAAM,CAAC,CAKxD,IAAM,EAAQ,EADF,EAAM,GAAG,MAAM,EAEvB,GAAiC,MACnC,EAAM,KAAK,EAAM,CAGnB,EAAY,EAAM,MAAQ,EAAM,GAAG,OACnC,EAAQ,EAAM,KAAK,EAAS,CAQ9B,OAJI,EAAY,EAAS,QACvB,EAAM,KAAK,EAAS,UAAU,EAAU,CAAC,CAGpC,CAAE,SAAU,GAAO,QAAO"}
+{"version":3,"file":"splitAndJoinInsertion.cjs","names":[],"sources":["../../../src/interpreter/splitAndJoinInsertion.ts"],"sourcesContent":["/**\n * Check if a value is a complex object (not a primitive)\n * Used to determine if values need to be wrapped in fragments\n */\nconst isComplexValue = (value: any): boolean => {\n  return (\n    value !== null &&\n    value !== undefined &&\n    typeof value !== 'string' &&\n    typeof value !== 'number' &&\n    typeof value !== 'boolean'\n  );\n};\n\n/**\n * Core logic for splitting insertion strings and joining with values.\n * Returns an array of parts that can be wrapped by framework-specific Fragment implementations.\n *\n * @param template - The template string with {{ placeholder }} syntax\n * @param values - Map of placeholder names to their replacement values\n * @returns Object with `isSimple` flag and `parts` array\n *\n * @example\n * ```ts\n * const result = splitInsertionTemplate('Hello {{ name }}!', { name: 'World' });\n * // { isSimple: true, parts: 'Hello World!' }\n *\n * const result = splitInsertionTemplate('Hello {{ name }}!', { name: <Component /> });\n * // { isSimple: false, parts: ['Hello ', <Component />, '!'] }\n * ```\n */\nexport const splitInsertionTemplate = <T = any>(\n  template: string,\n  values: Record<string, T> = {}\n): { isSimple: boolean; parts: string | T[] } => {\n  const safeValues = values ?? {};\n\n  // Check if any value is a complex object (React/Vue node, etc.)\n  const hasComplexValue = Object.values(safeValues).some(isComplexValue);\n\n  if (!hasComplexValue) {\n    // Simple string replacement\n    const result = template.replace(/\\{\\{\\s*(.*?)\\s*\\}\\}/g, (_, key) => {\n      const trimmedKey = key.trim();\n      return (safeValues[trimmedKey] ?? '').toString();\n    });\n    return { isSimple: true, parts: result };\n  }\n\n  // Split the template by placeholders while keeping the structure\n  const parts: any[] = [];\n  let lastIndex = 0;\n  const regex = /\\{\\{\\s*(.*?)\\s*\\}\\}/g;\n  let match: RegExpExecArray | null = regex.exec(template);\n\n  while (match !== null) {\n    // Add text before the placeholder\n    if (match.index > lastIndex) {\n      parts.push(template.substring(lastIndex, match.index));\n    }\n\n    // Add the replaced value\n    const key = match[1].trim();\n    const value = safeValues[key];\n    if (value !== undefined && value !== null) {\n      parts.push(value);\n    }\n\n    lastIndex = match.index + match[0].length;\n    match = regex.exec(template);\n  }\n\n  // Add remaining text\n  if (lastIndex < template.length) {\n    parts.push(template.substring(lastIndex));\n  }\n\n  return { isSimple: false, parts };\n};\n"],"mappings":";;;;;;;AAIA,MAAM,kBAAkB,UAAwB;AAC9C,QACE,UAAU,QACV,UAAU,UACV,OAAO,UAAU,YACjB,OAAO,UAAU,YACjB,OAAO,UAAU;;;;;;;;;;;;;;;;;;;AAqBrB,MAAa,0BACX,UACA,SAA4B,EAAE,KACiB;CAC/C,MAAM,aAAa,UAAU,EAAE;AAK/B,KAAI,CAFoB,OAAO,OAAO,WAAW,CAAC,KAAK,eAAe,CAQpE,QAAO;EAAE,UAAU;EAAM,OAJV,SAAS,QAAQ,yBAAyB,GAAG,QAAQ;AAElE,WAAQ,WADW,IAAI,MAAM,KACK,IAAI,UAAU;IAChD;EACsC;CAI1C,MAAM,QAAe,EAAE;CACvB,IAAI,YAAY;CAChB,MAAM,QAAQ;CACd,IAAI,QAAgC,MAAM,KAAK,SAAS;AAExD,QAAO,UAAU,MAAM;AAErB,MAAI,MAAM,QAAQ,UAChB,OAAM,KAAK,SAAS,UAAU,WAAW,MAAM,MAAM,CAAC;EAKxD,MAAM,QAAQ,WADF,MAAM,GAAG,MAAM;AAE3B,MAAI,UAAU,UAAa,UAAU,KACnC,OAAM,KAAK,MAAM;AAGnB,cAAY,MAAM,QAAQ,MAAM,GAAG;AACnC,UAAQ,MAAM,KAAK,SAAS;;AAI9B,KAAI,YAAY,SAAS,OACvB,OAAM,KAAK,SAAS,UAAU,UAAU,CAAC;AAG3C,QAAO;EAAE,UAAU;EAAO;EAAO"}

package/dist/cjs/localization/getBrowserLocale.cjs

@@ -1,2 +1,144 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../chunk-Bmb41Sf3.cjs`),t=require(`../utils/localeStorage.cjs`),n=require(`./localeDetector.cjs`);let r=require(`@intlayer/config/built`);r=e.t(r);let i=require(`@intlayer/types/locales`),a=function(e){return e.Querystring=`querystring`,e.Storage=`storage`,e.Navigator=`navigator`,e.HtmlTag=`htmlTag`,e}({});const o={getCookie:e=>document.cookie.split(`;`).find(t=>t.trim().startsWith(`${e}=`))?.split(`=`)[1],getLocaleStorage:e=>localStorage.getItem(e),getSessionStorage:e=>sessionStorage.getItem(e),isCookieEnabled:!0,setCookieStore:(e,t,n)=>cookieStore.set({name:e,value:t,path:n.path,domain:n.domain,expires:n.expires,sameSite:n.sameSite}),setCookieString:(e,t)=>{document.cookie=t},setSessionStorage:(e,t)=>sessionStorage.setItem(e,t),setLocaleStorage:(e,t)=>localStorage.setItem(e,t)},s=()=>({order:[a.Querystring,a.Storage,a.Navigator,a.HtmlTag],lookupQuerystring:`locale`,htmlTag:typeof document<`u`?document.documentElement:null}),c=(e,i)=>{let o={},s=()=>{if(typeof window>`u`)return;let e=window.location.search||``,t=new URLSearchParams(e).get(i.lookupQuerystring??``);t&&(o[a.Querystring]=t)},c=()=>{if(typeof window>`u`)return;let e=t.getLocaleFromStorage({getCookie:e=>{try{let t=document.cookie.split(`;`),n=`${e}=`,r=t.find(e=>e.trim().startsWith(n));if(r)return r.split(`=`)[1].trim()}catch{}},getSessionStorage:e=>{try{return window.sessionStorage.getItem(e)??void 0}catch{}},getLocaleStorage:e=>{try{return window.localStorage.getItem(e)??void 0}catch{}}});e&&(o[a.Storage]=e)},l=()=>{if(typeof navigator>`u`)return;let{internationalization:e}=r.default,t=navigator.languages??[navigator.language],i=n.localeDetector({"accept-language":t.join(`,`)},e.locales,e.defaultLocale);i&&(o[a.Navigator]=i)},u=()=>{let e=i.htmlTag;if(e&&typeof e.getAttribute==`function`){let t=e.getAttribute(`lang`);if(t){let{internationalization:e}=r.default,i=n.localeDetector({"accept-language":t},e.locales,e.defaultLocale);o[a.HtmlTag]=i}}},d={[a.Querystring]:s,[a.Storage]:c,[a.Navigator]:l,[a.HtmlTag]:u};return e.forEach(e=>{d[e]?.()}),o},l=(e,t)=>{let{internationalization:n}=r.default;for(let r of t){let t=e[r];if(t&&n.locales.includes(t))return t}return n?.defaultLocale??i.ENGLISH},u=(e={})=>{let t={...s(),...e};return l(c(t.order??[],t),t.order??[])};exports.LanguageDetector=a,exports.getBrowserLocale=u,exports.localeStorageOptions=o;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_utils_localeStorage = require('../utils/localeStorage.cjs');
+const require_localization_localeDetector = require('./localeDetector.cjs');
+let _intlayer_config_built = require("@intlayer/config/built");
+_intlayer_config_built = require_runtime.__toESM(_intlayer_config_built);
+let _intlayer_types_locales = require("@intlayer/types/locales");
+
+//#region src/localization/getBrowserLocale.tsx
+let LanguageDetector = /* @__PURE__ */ function(LanguageDetector) {
+	LanguageDetector["Querystring"] = "querystring";
+	LanguageDetector["Storage"] = "storage";
+	LanguageDetector["Navigator"] = "navigator";
+	LanguageDetector["HtmlTag"] = "htmlTag";
+	return LanguageDetector;
+}({});
+const localeStorageOptions = {
+	getCookie: (name) => document.cookie.split(";").find((c) => c.trim().startsWith(`${name}=`))?.split("=")[1],
+	getLocaleStorage: (name) => localStorage.getItem(name),
+	getSessionStorage: (name) => sessionStorage.getItem(name),
+	isCookieEnabled: true,
+	setCookieStore: (name, value, attributes) => cookieStore.set({
+		name,
+		value,
+		path: attributes.path,
+		domain: attributes.domain,
+		expires: attributes.expires,
+		sameSite: attributes.sameSite
+	}),
+	setCookieString: (_name, cookie) => {
+		document.cookie = cookie;
+	},
+	setSessionStorage: (name, value) => sessionStorage.setItem(name, value),
+	setLocaleStorage: (name, value) => localStorage.setItem(name, value)
+};
+const getDefaultsOptions = () => {
+	return {
+		order: [
+			LanguageDetector.Querystring,
+			LanguageDetector.Storage,
+			LanguageDetector.Navigator,
+			LanguageDetector.HtmlTag
+		],
+		lookupQuerystring: "locale",
+		htmlTag: typeof document !== "undefined" ? document.documentElement : null
+	};
+};
+const detectLanguage = (order, options) => {
+	const detected = {};
+	const queryStringDetector = () => {
+		if (typeof window === "undefined") return;
+		const search = window.location.search || "";
+		const value = new URLSearchParams(search).get(options.lookupQuerystring ?? "");
+		if (value) detected[LanguageDetector.Querystring] = value;
+	};
+	const storageDetector = () => {
+		if (typeof window === "undefined") return;
+		const locale = require_utils_localeStorage.getLocaleFromStorage({
+			getCookie: (name) => {
+				try {
+					const cookies = document.cookie.split(";");
+					const cookieName = `${name}=`;
+					const cookie = cookies.find((cookie) => cookie.trim().startsWith(cookieName));
+					if (cookie) return cookie.split("=")[1].trim();
+				} catch {}
+			},
+			getSessionStorage: (name) => {
+				try {
+					return window.sessionStorage.getItem(name) ?? void 0;
+				} catch {}
+			},
+			getLocaleStorage: (name) => {
+				try {
+					return window.localStorage.getItem(name) ?? void 0;
+				} catch {}
+			}
+		});
+		if (locale) detected[LanguageDetector.Storage] = locale;
+	};
+	const navigatorDetector = () => {
+		if (typeof navigator === "undefined") return;
+		const { internationalization } = _intlayer_config_built.default;
+		const languages = navigator.languages ?? [navigator.language];
+		const locale = require_localization_localeDetector.localeDetector({ "accept-language": languages.join(",") }, internationalization.locales, internationalization.defaultLocale);
+		if (locale) detected[LanguageDetector.Navigator] = locale;
+	};
+	const htmlTagDetector = () => {
+		const htmlTag = options.htmlTag;
+		if (htmlTag && typeof htmlTag.getAttribute === "function") {
+			const lang = htmlTag.getAttribute("lang");
+			if (lang) {
+				const { internationalization } = _intlayer_config_built.default;
+				const locale = require_localization_localeDetector.localeDetector({ "accept-language": lang }, internationalization.locales, internationalization.defaultLocale);
+				detected[LanguageDetector.HtmlTag] = locale;
+			}
+		}
+	};
+	const detectors = {
+		[LanguageDetector.Querystring]: queryStringDetector,
+		[LanguageDetector.Storage]: storageDetector,
+		[LanguageDetector.Navigator]: navigatorDetector,
+		[LanguageDetector.HtmlTag]: htmlTagDetector
+	};
+	order.forEach((detectorName) => {
+		detectors[detectorName]?.();
+	});
+	return detected;
+};
+const getFirstAvailableLocale = (locales, order) => {
+	const { internationalization } = _intlayer_config_built.default;
+	for (const detector of order) {
+		const locale = locales[detector];
+		if (locale && internationalization.locales.includes(locale)) return locale;
+	}
+	return internationalization?.defaultLocale ?? _intlayer_types_locales.ENGLISH;
+};
+/**
+* Core language detector function for browser environments.
+*
+* Detects the user's preferred locale by checking multiple sources in order:
+* 1. Query string parameter
+* 2. Storage (cookies, localStorage, sessionStorage) - uses getLocaleFromStorage
+* 3. Navigator languages - uses localeDetector
+* 4. HTML lang attribute - uses localeDetector
+*
+* @param userOptions - Optional configuration for detection order and lookup keys
+* @returns The detected locale or the default locale
+*
+* @example
+* const locale = getBrowserLocale({ order: [LanguageDetector.Storage, LanguageDetector.Navigator] });
+*/
+const getBrowserLocale = (userOptions = {}) => {
+	const options = {
+		...getDefaultsOptions(),
+		...userOptions
+	};
+	return getFirstAvailableLocale(detectLanguage(options.order ?? [], options), options.order ?? []);
+};
+
+//#endregion
+exports.LanguageDetector = LanguageDetector;
+exports.getBrowserLocale = getBrowserLocale;
+exports.localeStorageOptions = localeStorageOptions;
 //# sourceMappingURL=getBrowserLocale.cjs.map

package/dist/cjs/localization/getBrowserLocale.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"getBrowserLocale.cjs","names":["getLocaleFromStorage","configuration","localeDetector","ENGLISH"],"sources":["../../../src/localization/getBrowserLocale.tsx"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport { ENGLISH } from '@intlayer/types/locales';\nimport {\n  getLocaleFromStorage,\n  type LocaleStorageOptions,\n} from '../utils/localeStorage';\nimport { localeDetector } from './localeDetector';\n\nexport enum LanguageDetector {\n  Querystring = 'querystring',\n  Storage = 'storage',\n  Navigator = 'navigator',\n  HtmlTag = 'htmlTag',\n}\n\nexport const localeStorageOptions: LocaleStorageOptions = {\n  getCookie: (name: string) =>\n    document.cookie\n      .split(';')\n      .find((c) => c.trim().startsWith(`${name}=`))\n      ?.split('=')[1],\n  getLocaleStorage: (name: string) => localStorage.getItem(name),\n  getSessionStorage: (name: string) => sessionStorage.getItem(name),\n  isCookieEnabled: true,\n  setCookieStore: (name, value, attributes) =>\n    cookieStore.set({\n      name,\n      value,\n      path: attributes.path,\n      domain: attributes.domain,\n      expires: attributes.expires,\n      sameSite: attributes.sameSite,\n    }),\n  setCookieString: (_name, cookie) => {\n    // biome-ignore lint/suspicious/noDocumentCookie: set cookie fallback\n    document.cookie = cookie;\n  },\n  setSessionStorage: (name, value) => sessionStorage.setItem(name, value),\n  setLocaleStorage: (name, value) => localStorage.setItem(name, value),\n};\n\n// Default settings for the language detector\ntype LanguageDetectorOptions = {\n  order?: LanguageDetector[];\n  lookupQuerystring?: string;\n  htmlTag?: HTMLElement | null;\n};\n\nconst getDefaultsOptions = (): LanguageDetectorOptions => {\n  return {\n    order: [\n      LanguageDetector.Querystring,\n      LanguageDetector.Storage,\n      LanguageDetector.Navigator,\n      LanguageDetector.HtmlTag,\n    ],\n    lookupQuerystring: 'locale',\n    htmlTag: typeof document !== 'undefined' ? document.documentElement : null,\n  };\n};\n\nconst detectLanguage = (\n  order: string[],\n  options: LanguageDetectorOptions\n): Record<LanguageDetector, Locale | undefined> => {\n  const detected: Record<LanguageDetector, Locale | undefined> = {} as Record<\n    LanguageDetector,\n    Locale | undefined\n  >;\n\n  const queryStringDetector = () => {\n    if (typeof window === 'undefined') return;\n    const search = window.location.search || '';\n    const params = new URLSearchParams(search);\n    const value = params.get(options.lookupQuerystring ?? '');\n    if (value) {\n      detected[LanguageDetector.Querystring] = value as Locale;\n    }\n  };\n\n  const storageDetector = () => {\n    if (typeof window === 'undefined') return;\n\n    const locale = getLocaleFromStorage({\n      getCookie: (name: string) => {\n        try {\n          const cookies = document.cookie.split(';');\n          const cookieName = `${name}=`;\n\n          const cookie = cookies.find((cookie) =>\n            cookie.trim().startsWith(cookieName)\n          );\n\n          if (cookie) {\n            return cookie.split('=')[1].trim();\n          }\n        } catch {}\n        return undefined;\n      },\n      getSessionStorage: (name: string) => {\n        try {\n          return window.sessionStorage.getItem(name) ?? undefined;\n        } catch {}\n        return undefined;\n      },\n      getLocaleStorage: (name: string) => {\n        try {\n          return window.localStorage.getItem(name) ?? undefined;\n        } catch {}\n        return undefined;\n      },\n    });\n\n    if (locale) {\n      detected[LanguageDetector.Storage] = locale;\n    }\n  };\n\n  const navigatorDetector = () => {\n    if (typeof navigator === 'undefined') return;\n\n    const { internationalization } = configuration;\n    const languages = navigator.languages ?? [navigator.language];\n\n    // Use localeDetector to find the best matching locale\n    const locale = localeDetector(\n      { 'accept-language': languages.join(',') },\n      internationalization.locales,\n      internationalization.defaultLocale\n    );\n\n    if (locale) {\n      detected[LanguageDetector.Navigator] = locale;\n    }\n  };\n\n  const htmlTagDetector = () => {\n    const htmlTag = options.htmlTag;\n    if (htmlTag && typeof htmlTag.getAttribute === 'function') {\n      const lang = htmlTag.getAttribute('lang');\n      if (lang) {\n        const { internationalization } = configuration;\n\n        // Validate and resolve the locale\n        const locale = localeDetector(\n          { 'accept-language': lang },\n          internationalization.locales,\n          internationalization.defaultLocale\n        );\n\n        detected[LanguageDetector.HtmlTag] = locale;\n      }\n    }\n  };\n\n  // Map detector names to their corresponding functions\n  const detectors: Record<string, () => void> = {\n    [LanguageDetector.Querystring]: queryStringDetector,\n    [LanguageDetector.Storage]: storageDetector,\n    [LanguageDetector.Navigator]: navigatorDetector,\n    [LanguageDetector.HtmlTag]: htmlTagDetector,\n  };\n\n  // Use the provided order to run each detector\n  order.forEach((detectorName) => {\n    detectors[detectorName]?.();\n  });\n\n  return detected;\n};\n\nconst getFirstAvailableLocale = (\n  locales: Record<LanguageDetector, Locale | undefined>,\n  order: LanguageDetector[]\n): Locale => {\n  const { internationalization } = configuration;\n\n  for (const detector of order) {\n    const locale = locales[detector];\n\n    if (locale && internationalization.locales.includes(locale)) {\n      return locale;\n    }\n  }\n\n  return internationalization?.defaultLocale ?? ENGLISH;\n};\n\n/**\n * Core language detector function for browser environments.\n *\n * Detects the user's preferred locale by checking multiple sources in order:\n * 1. Query string parameter\n * 2. Storage (cookies, localStorage, sessionStorage) - uses getLocaleFromStorage\n * 3. Navigator languages - uses localeDetector\n * 4. HTML lang attribute - uses localeDetector\n *\n * @param userOptions - Optional configuration for detection order and lookup keys\n * @returns The detected locale or the default locale\n *\n * @example\n * const locale = getBrowserLocale({ order: [LanguageDetector.Storage, LanguageDetector.Navigator] });\n */\nexport const getBrowserLocale = (\n  userOptions: LanguageDetectorOptions | undefined = {}\n): Locale => {\n  const options = { ...getDefaultsOptions(), ...userOptions };\n\n  const locales = detectLanguage(options.order ?? [], options);\n\n  return getFirstAvailableLocale(locales, options.order ?? []);\n};\n"],"mappings":"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"}
+{"version":3,"file":"getBrowserLocale.cjs","names":["getLocaleFromStorage","configuration","localeDetector","ENGLISH"],"sources":["../../../src/localization/getBrowserLocale.tsx"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport { ENGLISH } from '@intlayer/types/locales';\nimport {\n  getLocaleFromStorage,\n  type LocaleStorageOptions,\n} from '../utils/localeStorage';\nimport { localeDetector } from './localeDetector';\n\nexport enum LanguageDetector {\n  Querystring = 'querystring',\n  Storage = 'storage',\n  Navigator = 'navigator',\n  HtmlTag = 'htmlTag',\n}\n\nexport const localeStorageOptions: LocaleStorageOptions = {\n  getCookie: (name: string) =>\n    document.cookie\n      .split(';')\n      .find((c) => c.trim().startsWith(`${name}=`))\n      ?.split('=')[1],\n  getLocaleStorage: (name: string) => localStorage.getItem(name),\n  getSessionStorage: (name: string) => sessionStorage.getItem(name),\n  isCookieEnabled: true,\n  setCookieStore: (name, value, attributes) =>\n    cookieStore.set({\n      name,\n      value,\n      path: attributes.path,\n      domain: attributes.domain,\n      expires: attributes.expires,\n      sameSite: attributes.sameSite,\n    }),\n  setCookieString: (_name, cookie) => {\n    // biome-ignore lint/suspicious/noDocumentCookie: set cookie fallback\n    document.cookie = cookie;\n  },\n  setSessionStorage: (name, value) => sessionStorage.setItem(name, value),\n  setLocaleStorage: (name, value) => localStorage.setItem(name, value),\n};\n\n// Default settings for the language detector\ntype LanguageDetectorOptions = {\n  order?: LanguageDetector[];\n  lookupQuerystring?: string;\n  htmlTag?: HTMLElement | null;\n};\n\nconst getDefaultsOptions = (): LanguageDetectorOptions => {\n  return {\n    order: [\n      LanguageDetector.Querystring,\n      LanguageDetector.Storage,\n      LanguageDetector.Navigator,\n      LanguageDetector.HtmlTag,\n    ],\n    lookupQuerystring: 'locale',\n    htmlTag: typeof document !== 'undefined' ? document.documentElement : null,\n  };\n};\n\nconst detectLanguage = (\n  order: string[],\n  options: LanguageDetectorOptions\n): Record<LanguageDetector, Locale | undefined> => {\n  const detected: Record<LanguageDetector, Locale | undefined> = {} as Record<\n    LanguageDetector,\n    Locale | undefined\n  >;\n\n  const queryStringDetector = () => {\n    if (typeof window === 'undefined') return;\n    const search = window.location.search || '';\n    const params = new URLSearchParams(search);\n    const value = params.get(options.lookupQuerystring ?? '');\n    if (value) {\n      detected[LanguageDetector.Querystring] = value as Locale;\n    }\n  };\n\n  const storageDetector = () => {\n    if (typeof window === 'undefined') return;\n\n    const locale = getLocaleFromStorage({\n      getCookie: (name: string) => {\n        try {\n          const cookies = document.cookie.split(';');\n          const cookieName = `${name}=`;\n\n          const cookie = cookies.find((cookie) =>\n            cookie.trim().startsWith(cookieName)\n          );\n\n          if (cookie) {\n            return cookie.split('=')[1].trim();\n          }\n        } catch {}\n        return undefined;\n      },\n      getSessionStorage: (name: string) => {\n        try {\n          return window.sessionStorage.getItem(name) ?? undefined;\n        } catch {}\n        return undefined;\n      },\n      getLocaleStorage: (name: string) => {\n        try {\n          return window.localStorage.getItem(name) ?? undefined;\n        } catch {}\n        return undefined;\n      },\n    });\n\n    if (locale) {\n      detected[LanguageDetector.Storage] = locale;\n    }\n  };\n\n  const navigatorDetector = () => {\n    if (typeof navigator === 'undefined') return;\n\n    const { internationalization } = configuration;\n    const languages = navigator.languages ?? [navigator.language];\n\n    // Use localeDetector to find the best matching locale\n    const locale = localeDetector(\n      { 'accept-language': languages.join(',') },\n      internationalization.locales,\n      internationalization.defaultLocale\n    );\n\n    if (locale) {\n      detected[LanguageDetector.Navigator] = locale;\n    }\n  };\n\n  const htmlTagDetector = () => {\n    const htmlTag = options.htmlTag;\n    if (htmlTag && typeof htmlTag.getAttribute === 'function') {\n      const lang = htmlTag.getAttribute('lang');\n      if (lang) {\n        const { internationalization } = configuration;\n\n        // Validate and resolve the locale\n        const locale = localeDetector(\n          { 'accept-language': lang },\n          internationalization.locales,\n          internationalization.defaultLocale\n        );\n\n        detected[LanguageDetector.HtmlTag] = locale;\n      }\n    }\n  };\n\n  // Map detector names to their corresponding functions\n  const detectors: Record<string, () => void> = {\n    [LanguageDetector.Querystring]: queryStringDetector,\n    [LanguageDetector.Storage]: storageDetector,\n    [LanguageDetector.Navigator]: navigatorDetector,\n    [LanguageDetector.HtmlTag]: htmlTagDetector,\n  };\n\n  // Use the provided order to run each detector\n  order.forEach((detectorName) => {\n    detectors[detectorName]?.();\n  });\n\n  return detected;\n};\n\nconst getFirstAvailableLocale = (\n  locales: Record<LanguageDetector, Locale | undefined>,\n  order: LanguageDetector[]\n): Locale => {\n  const { internationalization } = configuration;\n\n  for (const detector of order) {\n    const locale = locales[detector];\n\n    if (locale && internationalization.locales.includes(locale)) {\n      return locale;\n    }\n  }\n\n  return internationalization?.defaultLocale ?? ENGLISH;\n};\n\n/**\n * Core language detector function for browser environments.\n *\n * Detects the user's preferred locale by checking multiple sources in order:\n * 1. Query string parameter\n * 2. Storage (cookies, localStorage, sessionStorage) - uses getLocaleFromStorage\n * 3. Navigator languages - uses localeDetector\n * 4. HTML lang attribute - uses localeDetector\n *\n * @param userOptions - Optional configuration for detection order and lookup keys\n * @returns The detected locale or the default locale\n *\n * @example\n * const locale = getBrowserLocale({ order: [LanguageDetector.Storage, LanguageDetector.Navigator] });\n */\nexport const getBrowserLocale = (\n  userOptions: LanguageDetectorOptions | undefined = {}\n): Locale => {\n  const options = { ...getDefaultsOptions(), ...userOptions };\n\n  const locales = detectLanguage(options.order ?? [], options);\n\n  return getFirstAvailableLocale(locales, options.order ?? []);\n};\n"],"mappings":"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"}

package/dist/cjs/localization/getHTMLTextDir.cjs

@@ -1,2 +1,41 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`../chunk-Bmb41Sf3.cjs`);let e=require(`@intlayer/types/locales`);const t=t=>{switch(t){case e.ARABIC:case e.ARABIC_UNITED_ARAB_EMIRATES:case e.ARABIC_BAHRAIN:case e.ARABIC_ALGERIA:case e.ARABIC_EGYPT:case e.ARABIC_IRAQ:case e.ARABIC_JORDAN:case e.ARABIC_KUWAIT:case e.ARABIC_LEBANON:case e.ARABIC_LIBYA:case e.ARABIC_MOROCCO:case e.ARABIC_OMAN:case e.ARABIC_QATAR:case e.ARABIC_SAUDI_ARABIA:case e.ARABIC_SYRIA:case e.ARABIC_TUNISIA:case e.ARABIC_YEMEN:case e.ARABIC_MAURITANIA:case e.ARABIC_PALESTINE:case e.ARABIC_SUDAN:case e.ARABIC_DJIBOUTI:case e.ARABIC_SOMALIA:case e.ARABIC_CHAD:case e.ARABIC_COMOROS:case e.HEBREW:case e.HEBREW_ISRAEL:case e.FARSI:case e.FARSI_IRAN:case e.URDU:case e.URDU_ISLAMIC_REPUBLIC_OF_PAKISTAN:case e.PASHTO:case e.PASHTO_AFGHANISTAN:case e.SYRIAC:case e.SYRIAC_SYRIA:case e.DIVEHI:case e.DIVEHI_MALDIVES:case e.YIDDISH:case e.YIDDISH_WORLD:return`rtl`;default:return`ltr`}};exports.getHTMLTextDir=t;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/localization/getHTMLTextDir.ts
+/**
+* Returns the text direction of the given locale.
+*
+* Example:
+*
+* getHTMLTextDir('en-US') // 'ltr'
+* getHTMLTextDir('en') // 'ltr'
+* getHTMLTextDir('fr-CA') // 'ltr'
+* getHTMLTextDir('fr') // 'ltr'
+*
+* @param locale The locale to get the text direction for.
+* @returns The text direction of the given locale.
+*/
+const getHTMLTextDir = (locale) => {
+	if (!locale) return "ltr";
+	try {
+		const localeInfo = new Intl.Locale(locale);
+		if ("getTextInfo" in localeInfo) return localeInfo.getTextInfo().direction;
+		if ("textInfo" in localeInfo) return localeInfo.textInfo.direction;
+		const maximized = localeInfo.maximize();
+		return [
+			"Arab",
+			"Hebr",
+			"Thaa",
+			"Syrc",
+			"Mand",
+			"Adlm",
+			"Rohg",
+			"Nkoo"
+		].includes(maximized.script ?? "") ? "rtl" : "ltr";
+	} catch {
+		return "ltr";
+	}
+};
+
+//#endregion
+exports.getHTMLTextDir = getHTMLTextDir;
 //# sourceMappingURL=getHTMLTextDir.cjs.map