@intlayer/core 9.0.2 → 9.1.1

package/dist/cjs/dictionaryManipulator/editDictionaryByKeyPath.cjs

@@ -13,29 +13,29 @@ const editDictionaryByKeyPath = (dictionaryContent, keyPath, newValue) => {
 		for (let i = 0; i < keyPath.length; i++) {
 			const keyObj = keyPath[i];
 			parentValue = currentValue;
-			if (keyObj.type === _intlayer_types_nodeType.OBJECT || keyObj.type === _intlayer_types_nodeType.ARRAY) {
+			if (keyObj?.type === _intlayer_types_nodeType.OBJECT || keyObj?.type === _intlayer_types_nodeType.ARRAY) {
 				lastKeys = [keyObj.key];
 				if (!currentValue[keyObj.key] || typeof currentValue[keyObj.key] !== "object") currentValue[keyObj.key] = {};
 				currentValue = currentValue[keyObj.key];
 			}
-			if (keyObj.type === _intlayer_types_nodeType.TRANSLATION || keyObj.type === _intlayer_types_nodeType.ENUMERATION || keyObj.type === _intlayer_types_nodeType.PLURAL) {
+			if (keyObj?.type === _intlayer_types_nodeType.TRANSLATION || keyObj?.type === _intlayer_types_nodeType.ENUMERATION || keyObj?.type === _intlayer_types_nodeType.PLURAL || keyObj?.type === _intlayer_types_nodeType.GENDER || keyObj?.type === _intlayer_types_nodeType.SELECT) {
 				lastKeys = [keyObj.type, keyObj.key];
 				if (!currentValue[keyObj.type] || typeof currentValue[keyObj.type] !== "object") currentValue[keyObj.type] = {};
 				if (!currentValue[keyObj.type][keyObj.key] || typeof currentValue[keyObj.type][keyObj.key] !== "object") currentValue[keyObj.type][keyObj.key] = {};
 				currentValue = currentValue[keyObj.type][keyObj.key];
 			}
-			if (keyObj.type === _intlayer_types_nodeType.ENUMERATION || keyObj.type === _intlayer_types_nodeType.PLURAL || keyObj.type === _intlayer_types_nodeType.CONDITION) {
+			if (keyObj?.type === _intlayer_types_nodeType.ENUMERATION || keyObj?.type === _intlayer_types_nodeType.PLURAL || keyObj?.type === _intlayer_types_nodeType.CONDITION) {
 				if (keyObj.type !== _intlayer_types_nodeType.ENUMERATION && keyObj.type !== _intlayer_types_nodeType.PLURAL) {
 					lastKeys = [keyObj.type, keyObj.key];
 					currentValue = currentValue[keyObj.type][keyObj.key];
 				}
 			}
-			if (keyObj.type === _intlayer_types_nodeType.MARKDOWN || keyObj.type === _intlayer_types_nodeType.HTML || keyObj.type === _intlayer_types_nodeType.INSERTION) {
+			if (keyObj?.type === _intlayer_types_nodeType.MARKDOWN || keyObj?.type === _intlayer_types_nodeType.HTML || keyObj?.type === _intlayer_types_nodeType.INSERTION) {
 				lastKeys = [keyObj.type];
 				if (currentValue[keyObj.type] == null) currentValue[keyObj.type] = "";
 				currentValue = currentValue[keyObj.type];
 			}
-			if (keyObj.type === _intlayer_types_nodeType.FILE) {
+			if (keyObj?.type === _intlayer_types_nodeType.FILE) {
 				lastKeys = ["content"];
 				currentValue = currentValue.content;
 			}

package/dist/cjs/dictionaryManipulator/editDictionaryByKeyPath.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"editDictionaryByKeyPath.cjs","names":["NodeTypes"],"sources":["../../../src/dictionaryManipulator/editDictionaryByKeyPath.ts"],"sourcesContent":["import type { ContentNode } from '@intlayer/types/dictionary';\nimport type { KeyPath } from '@intlayer/types/keyPath';\nimport * as NodeTypes from '@intlayer/types/nodeType';\n\ntype LastKeyType = string | number;\n\nexport const editDictionaryByKeyPath = (\n  dictionaryContent: ContentNode,\n  keyPath: KeyPath[],\n  newValue: ContentNode\n): ContentNode => {\n  let currentValue: any = dictionaryContent;\n  let parentValue: any = null;\n  let lastKeys: LastKeyType[] = [];\n\n  if (keyPath.length === 0) {\n    return newValue;\n  }\n\n  try {\n    for (let i = 0; i < keyPath.length; i++) {\n      const keyObj = keyPath[i];\n      parentValue = currentValue;\n\n      if (keyObj.type === NodeTypes.OBJECT || keyObj.type === NodeTypes.ARRAY) {\n        lastKeys = [keyObj.key];\n\n        if (\n          !currentValue[keyObj.key] ||\n          typeof currentValue[keyObj.key] !== 'object'\n        ) {\n          currentValue[keyObj.key] = {};\n        }\n        currentValue = currentValue[keyObj.key];\n      }\n\n      if (\n        keyObj.type === NodeTypes.TRANSLATION ||\n        keyObj.type === NodeTypes.ENUMERATION ||\n        keyObj.type === NodeTypes.PLURAL\n      ) {\n        lastKeys = [keyObj.type, keyObj.key];\n\n        if (\n          !currentValue[keyObj.type] ||\n          typeof currentValue[keyObj.type] !== 'object'\n        ) {\n          currentValue[keyObj.type] = {};\n        }\n\n        if (\n          !currentValue[keyObj.type][keyObj.key] ||\n          typeof currentValue[keyObj.type][keyObj.key] !== 'object'\n        ) {\n          currentValue[keyObj.type][keyObj.key] = {};\n        }\n        currentValue = currentValue[keyObj.type][keyObj.key];\n      }\n\n      if (\n        keyObj.type === NodeTypes.ENUMERATION ||\n        keyObj.type === NodeTypes.PLURAL ||\n        keyObj.type === NodeTypes.CONDITION\n      ) {\n        // Note: Logic above already handles Enumeration/Plural, ensure no duplication in your actual file\n        // or keep the specific block if your logic differs.\n        // The important part is below in the final update block.\n\n        // Assuming this block runs for Condition/Gender/etc:\n\n        if (\n          keyObj.type !== NodeTypes.ENUMERATION &&\n          keyObj.type !== NodeTypes.PLURAL\n        ) {\n          lastKeys = [keyObj.type, keyObj.key];\n          currentValue = currentValue[keyObj.type][keyObj.key];\n        }\n      }\n\n      if (\n        keyObj.type === NodeTypes.MARKDOWN ||\n        keyObj.type === NodeTypes.HTML ||\n        keyObj.type === NodeTypes.INSERTION\n      ) {\n        lastKeys = [keyObj.type];\n\n        if (currentValue[keyObj.type] == null) {\n          currentValue[keyObj.type] = '';\n        }\n        currentValue = currentValue[keyObj.type];\n      }\n\n      if (keyObj.type === NodeTypes.FILE) {\n        lastKeys = ['content'];\n        currentValue = currentValue.content;\n      }\n\n      // Only update the value when processing the last key in the keyPath.\n\n      if (i === keyPath.length - 1 && parentValue && lastKeys.length > 0) {\n        let target = parentValue;\n\n        // Drill down to the container holding the value to be changed\n        for (const key of lastKeys.slice(0, -1)) {\n          target = target[key];\n        }\n\n        const finalKey = lastKeys[lastKeys.length - 1];\n\n        if (typeof newValue === 'undefined') {\n          // Use splice for arrays to re-index the list, use delete for objects\n\n          if (Array.isArray(target)) {\n            const index = Number(finalKey);\n\n            if (!Number.isNaN(index) && index >= 0 && index < target.length) {\n              target.splice(index, 1);\n            }\n          } else {\n            delete target[finalKey];\n          }\n        } else {\n          target[finalKey] = newValue;\n        }\n      }\n    }\n\n    return dictionaryContent;\n  } catch (error) {\n    console.error(\n      'Cannot edit dictionary by key path',\n      { dictionaryContent, keyPath, newValue },\n      error\n    );\n    return dictionaryContent;\n  }\n};\n"],"mappings":";;;;;;AAMA,MAAa,2BACX,mBACA,SACA,aACgB;CAChB,IAAI,eAAoB;CACxB,IAAI,cAAmB;CACvB,IAAI,WAA0B,CAAC;CAE/B,IAAI,QAAQ,WAAW,GACrB,OAAO;CAGT,IAAI;EACF,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;GACvC,MAAM,SAAS,QAAQ;GACvB,cAAc;GAEd,IAAI,OAAO,SAASA,yBAAU,UAAU,OAAO,SAASA,yBAAU,OAAO;IACvE,WAAW,CAAC,OAAO,GAAG;IAEtB,IACE,CAAC,aAAa,OAAO,QACrB,OAAO,aAAa,OAAO,SAAS,UAEpC,aAAa,OAAO,OAAO,CAAC;IAE9B,eAAe,aAAa,OAAO;GACrC;GAEA,IACE,OAAO,SAASA,yBAAU,eAC1B,OAAO,SAASA,yBAAU,eAC1B,OAAO,SAASA,yBAAU,QAC1B;IACA,WAAW,CAAC,OAAO,MAAM,OAAO,GAAG;IAEnC,IACE,CAAC,aAAa,OAAO,SACrB,OAAO,aAAa,OAAO,UAAU,UAErC,aAAa,OAAO,QAAQ,CAAC;IAG/B,IACE,CAAC,aAAa,OAAO,KAAK,CAAC,OAAO,QAClC,OAAO,aAAa,OAAO,KAAK,CAAC,OAAO,SAAS,UAEjD,aAAa,OAAO,KAAK,CAAC,OAAO,OAAO,CAAC;IAE3C,eAAe,aAAa,OAAO,KAAK,CAAC,OAAO;GAClD;GAEA,IACE,OAAO,SAASA,yBAAU,eAC1B,OAAO,SAASA,yBAAU,UAC1B,OAAO,SAASA,yBAAU,WAQ1B;QACE,OAAO,SAASA,yBAAU,eAC1B,OAAO,SAASA,yBAAU,QAC1B;KACA,WAAW,CAAC,OAAO,MAAM,OAAO,GAAG;KACnC,eAAe,aAAa,OAAO,KAAK,CAAC,OAAO;IAClD;;GAGF,IACE,OAAO,SAASA,yBAAU,YAC1B,OAAO,SAASA,yBAAU,QAC1B,OAAO,SAASA,yBAAU,WAC1B;IACA,WAAW,CAAC,OAAO,IAAI;IAEvB,IAAI,aAAa,OAAO,SAAS,MAC/B,aAAa,OAAO,QAAQ;IAE9B,eAAe,aAAa,OAAO;GACrC;GAEA,IAAI,OAAO,SAASA,yBAAU,MAAM;IAClC,WAAW,CAAC,SAAS;IACrB,eAAe,aAAa;GAC9B;GAIA,IAAI,MAAM,QAAQ,SAAS,KAAK,eAAe,SAAS,SAAS,GAAG;IAClE,IAAI,SAAS;IAGb,KAAK,MAAM,OAAO,SAAS,MAAM,GAAG,EAAE,GACpC,SAAS,OAAO;IAGlB,MAAM,WAAW,SAAS,SAAS,SAAS;IAE5C,IAAI,OAAO,aAAa,aAGtB,IAAI,MAAM,QAAQ,MAAM,GAAG;KACzB,MAAM,QAAQ,OAAO,QAAQ;KAE7B,IAAI,CAAC,OAAO,MAAM,KAAK,KAAK,SAAS,KAAK,QAAQ,OAAO,QACvD,OAAO,OAAO,OAAO,CAAC;IAE1B,OACE,OAAO,OAAO;SAGhB,OAAO,YAAY;GAEvB;EACF;EAEA,OAAO;CACT,SAAS,OAAO;EACd,QAAQ,MACN,sCACA;GAAE;GAAmB;GAAS;EAAS,GACvC,KACF;EACA,OAAO;CACT;AACF"}
+{"version":3,"file":"editDictionaryByKeyPath.cjs","names":["NodeTypes"],"sources":["../../../src/dictionaryManipulator/editDictionaryByKeyPath.ts"],"sourcesContent":["import type { ContentNode } from '@intlayer/types/dictionary';\nimport type { KeyPath } from '@intlayer/types/keyPath';\nimport * as NodeTypes from '@intlayer/types/nodeType';\n\ntype LastKeyType = string | number;\n\nexport const editDictionaryByKeyPath = (\n  dictionaryContent: ContentNode,\n  keyPath: KeyPath[],\n  newValue: ContentNode\n): ContentNode => {\n  let currentValue: any = dictionaryContent;\n  let parentValue: any = null;\n  let lastKeys: LastKeyType[] = [];\n\n  if (keyPath.length === 0) {\n    return newValue;\n  }\n\n  try {\n    for (let i = 0; i < keyPath.length; i++) {\n      const keyObj = keyPath[i];\n      parentValue = currentValue;\n\n      if (\n        keyObj?.type === NodeTypes.OBJECT ||\n        keyObj?.type === NodeTypes.ARRAY\n      ) {\n        lastKeys = [keyObj.key];\n\n        if (\n          !currentValue[keyObj.key] ||\n          typeof currentValue[keyObj.key] !== 'object'\n        ) {\n          currentValue[keyObj.key] = {};\n        }\n        currentValue = currentValue[keyObj.key];\n      }\n\n      if (\n        keyObj?.type === NodeTypes.TRANSLATION ||\n        keyObj?.type === NodeTypes.ENUMERATION ||\n        keyObj?.type === NodeTypes.PLURAL ||\n        keyObj?.type === NodeTypes.GENDER ||\n        keyObj?.type === NodeTypes.SELECT\n      ) {\n        lastKeys = [keyObj.type, keyObj.key];\n\n        if (\n          !currentValue[keyObj.type] ||\n          typeof currentValue[keyObj.type] !== 'object'\n        ) {\n          currentValue[keyObj.type] = {};\n        }\n\n        if (\n          !currentValue[keyObj.type][keyObj.key] ||\n          typeof currentValue[keyObj.type][keyObj.key] !== 'object'\n        ) {\n          currentValue[keyObj.type][keyObj.key] = {};\n        }\n        currentValue = currentValue[keyObj.type][keyObj.key];\n      }\n\n      if (\n        keyObj?.type === NodeTypes.ENUMERATION ||\n        keyObj?.type === NodeTypes.PLURAL ||\n        keyObj?.type === NodeTypes.CONDITION\n      ) {\n        // Note: Logic above already handles Enumeration/Plural, ensure no duplication in your actual file\n        // or keep the specific block if your logic differs.\n        // The important part is below in the final update block.\n\n        // Assuming this block runs for Condition/Gender/etc:\n\n        if (\n          keyObj.type !== NodeTypes.ENUMERATION &&\n          keyObj.type !== NodeTypes.PLURAL\n        ) {\n          lastKeys = [keyObj.type, keyObj.key];\n          currentValue = currentValue[keyObj.type][keyObj.key];\n        }\n      }\n\n      if (\n        keyObj?.type === NodeTypes.MARKDOWN ||\n        keyObj?.type === NodeTypes.HTML ||\n        keyObj?.type === NodeTypes.INSERTION\n      ) {\n        lastKeys = [keyObj.type];\n\n        if (currentValue[keyObj.type] == null) {\n          currentValue[keyObj.type] = '';\n        }\n        currentValue = currentValue[keyObj.type];\n      }\n\n      if (keyObj?.type === NodeTypes.FILE) {\n        lastKeys = ['content'];\n        currentValue = currentValue.content;\n      }\n\n      // Only update the value when processing the last key in the keyPath.\n\n      if (i === keyPath.length - 1 && parentValue && lastKeys.length > 0) {\n        let target = parentValue;\n\n        // Drill down to the container holding the value to be changed\n        for (const key of lastKeys.slice(0, -1)) {\n          target = target[key];\n        }\n\n        const finalKey = lastKeys[lastKeys.length - 1];\n\n        if (typeof newValue === 'undefined') {\n          // Use splice for arrays to re-index the list, use delete for objects\n\n          if (Array.isArray(target)) {\n            const index = Number(finalKey);\n\n            if (!Number.isNaN(index) && index >= 0 && index < target.length) {\n              target.splice(index, 1);\n            }\n          } else {\n            delete target[finalKey];\n          }\n        } else {\n          target[finalKey] = newValue;\n        }\n      }\n    }\n\n    return dictionaryContent;\n  } catch (error) {\n    console.error(\n      'Cannot edit dictionary by key path',\n      { dictionaryContent, keyPath, newValue },\n      error\n    );\n    return dictionaryContent;\n  }\n};\n"],"mappings":";;;;;;AAMA,MAAa,2BACX,mBACA,SACA,aACgB;CAChB,IAAI,eAAoB;CACxB,IAAI,cAAmB;CACvB,IAAI,WAA0B,CAAC;CAE/B,IAAI,QAAQ,WAAW,GACrB,OAAO;CAGT,IAAI;EACF,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;GACvC,MAAM,SAAS,QAAQ;GACvB,cAAc;GAEd,IACE,QAAQ,SAASA,yBAAU,UAC3B,QAAQ,SAASA,yBAAU,OAC3B;IACA,WAAW,CAAC,OAAO,GAAG;IAEtB,IACE,CAAC,aAAa,OAAO,QACrB,OAAO,aAAa,OAAO,SAAS,UAEpC,aAAa,OAAO,OAAO,CAAC;IAE9B,eAAe,aAAa,OAAO;GACrC;GAEA,IACE,QAAQ,SAASA,yBAAU,eAC3B,QAAQ,SAASA,yBAAU,eAC3B,QAAQ,SAASA,yBAAU,UAC3B,QAAQ,SAASA,yBAAU,UAC3B,QAAQ,SAASA,yBAAU,QAC3B;IACA,WAAW,CAAC,OAAO,MAAM,OAAO,GAAG;IAEnC,IACE,CAAC,aAAa,OAAO,SACrB,OAAO,aAAa,OAAO,UAAU,UAErC,aAAa,OAAO,QAAQ,CAAC;IAG/B,IACE,CAAC,aAAa,OAAO,KAAK,CAAC,OAAO,QAClC,OAAO,aAAa,OAAO,KAAK,CAAC,OAAO,SAAS,UAEjD,aAAa,OAAO,KAAK,CAAC,OAAO,OAAO,CAAC;IAE3C,eAAe,aAAa,OAAO,KAAK,CAAC,OAAO;GAClD;GAEA,IACE,QAAQ,SAASA,yBAAU,eAC3B,QAAQ,SAASA,yBAAU,UAC3B,QAAQ,SAASA,yBAAU,WAQ3B;QACE,OAAO,SAASA,yBAAU,eAC1B,OAAO,SAASA,yBAAU,QAC1B;KACA,WAAW,CAAC,OAAO,MAAM,OAAO,GAAG;KACnC,eAAe,aAAa,OAAO,KAAK,CAAC,OAAO;IAClD;;GAGF,IACE,QAAQ,SAASA,yBAAU,YAC3B,QAAQ,SAASA,yBAAU,QAC3B,QAAQ,SAASA,yBAAU,WAC3B;IACA,WAAW,CAAC,OAAO,IAAI;IAEvB,IAAI,aAAa,OAAO,SAAS,MAC/B,aAAa,OAAO,QAAQ;IAE9B,eAAe,aAAa,OAAO;GACrC;GAEA,IAAI,QAAQ,SAASA,yBAAU,MAAM;IACnC,WAAW,CAAC,SAAS;IACrB,eAAe,aAAa;GAC9B;GAIA,IAAI,MAAM,QAAQ,SAAS,KAAK,eAAe,SAAS,SAAS,GAAG;IAClE,IAAI,SAAS;IAGb,KAAK,MAAM,OAAO,SAAS,MAAM,GAAG,EAAE,GACpC,SAAS,OAAO;IAGlB,MAAM,WAAW,SAAS,SAAS,SAAS;IAE5C,IAAI,OAAO,aAAa,aAGtB,IAAI,MAAM,QAAQ,MAAM,GAAG;KACzB,MAAM,QAAQ,OAAO,QAAQ;KAE7B,IAAI,CAAC,OAAO,MAAM,KAAK,KAAK,SAAS,KAAK,QAAQ,OAAO,QACvD,OAAO,OAAO,OAAO,CAAC;IAE1B,OACE,OAAO,OAAO;SAGhB,OAAO,YAAY;GAEvB;EACF;EAEA,OAAO;CACT,SAAS,OAAO;EACd,QAAQ,MACN,sCACA;GAAE;GAAmB;GAAS;EAAS,GACvC,KACF;EACA,OAAO;CACT;AACF"}

package/dist/cjs/dictionaryManipulator/getContentNodeByKeyPath.cjs

@@ -9,7 +9,7 @@ const getContentNodeByKeyPath = (dictionaryContent, keyPath, fallbackLocale) =>
 	for (const keyObj of keyPath) {
 		if (fallbackLocale && currentValue?.nodeType === _intlayer_types_nodeType.TRANSLATION) currentValue = currentValue?.[_intlayer_types_nodeType.TRANSLATION]?.[fallbackLocale];
 		if (keyObj.type === _intlayer_types_nodeType.OBJECT || keyObj.type === _intlayer_types_nodeType.ARRAY) currentValue = currentValue?.[keyObj.key];
-		if (keyObj.type === _intlayer_types_nodeType.TRANSLATION || keyObj.type === _intlayer_types_nodeType.CONDITION || keyObj.type === _intlayer_types_nodeType.ENUMERATION || keyObj.type === _intlayer_types_nodeType.PLURAL) currentValue = currentValue?.[keyObj.type]?.[keyObj.key];
+		if (keyObj.type === _intlayer_types_nodeType.TRANSLATION || keyObj.type === _intlayer_types_nodeType.CONDITION || keyObj.type === _intlayer_types_nodeType.ENUMERATION || keyObj.type === _intlayer_types_nodeType.PLURAL || keyObj.type === _intlayer_types_nodeType.GENDER || keyObj.type === _intlayer_types_nodeType.SELECT) currentValue = currentValue?.[keyObj.type]?.[keyObj.key];
 		if (keyObj.type === _intlayer_types_nodeType.MARKDOWN || keyObj.type === _intlayer_types_nodeType.HTML || keyObj.type === _intlayer_types_nodeType.INSERTION || keyObj.type === _intlayer_types_nodeType.FILE) currentValue = currentValue?.[keyObj.type];
 	}
 	return currentValue;

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

@@ -1 +1 @@
-{"version":3,"file":"getContentNodeByKeyPath.cjs","names":["NodeTypes"],"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 * as NodeTypes 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 === NodeTypes.TRANSLATION) {\n      currentValue = currentValue?.[NodeTypes.TRANSLATION]?.[fallbackLocale];\n    }\n\n    if (keyObj.type === NodeTypes.OBJECT || keyObj.type === NodeTypes.ARRAY) {\n      currentValue = currentValue?.[keyObj.key];\n    }\n\n    if (\n      keyObj.type === NodeTypes.TRANSLATION ||\n      keyObj.type === NodeTypes.CONDITION ||\n      keyObj.type === NodeTypes.ENUMERATION ||\n      keyObj.type === NodeTypes.PLURAL\n    ) {\n      currentValue = currentValue?.[keyObj.type]?.[keyObj.key];\n    }\n\n    if (\n      keyObj.type === NodeTypes.MARKDOWN ||\n      keyObj.type === NodeTypes.HTML ||\n      keyObj.type === NodeTypes.INSERTION ||\n      keyObj.type === NodeTypes.FILE\n    ) {\n      currentValue = currentValue?.[keyObj.type];\n    }\n  }\n\n  return currentValue as ContentNode;\n};\n"],"mappings":";;;;;;AAKA,MAAa,2BACX,mBACA,SACA,mBACgB;CAChB,IAAI,eAAoB,gBAAgB,iBAAiB;CAEzD,KAAK,MAAM,UAAU,SAAS;EAE5B,IAAI,kBAAkB,cAAc,aAAaA,yBAAU,aACzD,eAAe,eAAeA,yBAAU,YAAY,GAAG;EAGzD,IAAI,OAAO,SAASA,yBAAU,UAAU,OAAO,SAASA,yBAAU,OAChE,eAAe,eAAe,OAAO;EAGvC,IACE,OAAO,SAASA,yBAAU,eAC1B,OAAO,SAASA,yBAAU,aAC1B,OAAO,SAASA,yBAAU,eAC1B,OAAO,SAASA,yBAAU,QAE1B,eAAe,eAAe,OAAO,KAAK,GAAG,OAAO;EAGtD,IACE,OAAO,SAASA,yBAAU,YAC1B,OAAO,SAASA,yBAAU,QAC1B,OAAO,SAASA,yBAAU,aAC1B,OAAO,SAASA,yBAAU,MAE1B,eAAe,eAAe,OAAO;CAEzC;CAEA,OAAO;AACT"}
+{"version":3,"file":"getContentNodeByKeyPath.cjs","names":["NodeTypes"],"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 * as NodeTypes 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 === NodeTypes.TRANSLATION) {\n      currentValue = currentValue?.[NodeTypes.TRANSLATION]?.[fallbackLocale];\n    }\n\n    if (keyObj.type === NodeTypes.OBJECT || keyObj.type === NodeTypes.ARRAY) {\n      currentValue = currentValue?.[keyObj.key];\n    }\n\n    if (\n      keyObj.type === NodeTypes.TRANSLATION ||\n      keyObj.type === NodeTypes.CONDITION ||\n      keyObj.type === NodeTypes.ENUMERATION ||\n      keyObj.type === NodeTypes.PLURAL ||\n      keyObj.type === NodeTypes.GENDER ||\n      keyObj.type === NodeTypes.SELECT\n    ) {\n      currentValue = currentValue?.[keyObj.type]?.[keyObj.key];\n    }\n\n    if (\n      keyObj.type === NodeTypes.MARKDOWN ||\n      keyObj.type === NodeTypes.HTML ||\n      keyObj.type === NodeTypes.INSERTION ||\n      keyObj.type === NodeTypes.FILE\n    ) {\n      currentValue = currentValue?.[keyObj.type];\n    }\n  }\n\n  return currentValue as ContentNode;\n};\n"],"mappings":";;;;;;AAKA,MAAa,2BACX,mBACA,SACA,mBACgB;CAChB,IAAI,eAAoB,gBAAgB,iBAAiB;CAEzD,KAAK,MAAM,UAAU,SAAS;EAE5B,IAAI,kBAAkB,cAAc,aAAaA,yBAAU,aACzD,eAAe,eAAeA,yBAAU,YAAY,GAAG;EAGzD,IAAI,OAAO,SAASA,yBAAU,UAAU,OAAO,SAASA,yBAAU,OAChE,eAAe,eAAe,OAAO;EAGvC,IACE,OAAO,SAASA,yBAAU,eAC1B,OAAO,SAASA,yBAAU,aAC1B,OAAO,SAASA,yBAAU,eAC1B,OAAO,SAASA,yBAAU,UAC1B,OAAO,SAASA,yBAAU,UAC1B,OAAO,SAASA,yBAAU,QAE1B,eAAe,eAAe,OAAO,KAAK,GAAG,OAAO;EAGtD,IACE,OAAO,SAASA,yBAAU,YAC1B,OAAO,SAASA,yBAAU,QAC1B,OAAO,SAASA,yBAAU,aAC1B,OAAO,SAASA,yBAAU,MAE1B,eAAe,eAAe,OAAO;CAEzC;CAEA,OAAO;AACT"}

package/dist/cjs/dictionaryManipulator/getDefaultNode.cjs

@@ -29,6 +29,21 @@ const getDefaultNode = (nodeType, locales, content) => {
 				false: clonedContent ?? ""
 			}
 		};
+		case _intlayer_types_nodeType.GENDER: return {
+			nodeType: _intlayer_types_nodeType.GENDER,
+			[_intlayer_types_nodeType.GENDER]: {
+				male: clonedContent ?? "",
+				female: clonedContent ?? "",
+				fallback: clonedContent ?? ""
+			}
+		};
+		case _intlayer_types_nodeType.SELECT: return {
+			nodeType: _intlayer_types_nodeType.SELECT,
+			[_intlayer_types_nodeType.SELECT]: {
+				case1: clonedContent ?? "",
+				fallback: clonedContent ?? ""
+			}
+		};
 		case _intlayer_types_nodeType.INSERTION: return {
 			nodeType: _intlayer_types_nodeType.INSERTION,
 			[_intlayer_types_nodeType.INSERTION]: { insertion: clonedContent ?? "" }

package/dist/cjs/dictionaryManipulator/getDefaultNode.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"getDefaultNode.cjs","names":["NodeTypes"],"sources":["../../../src/dictionaryManipulator/getDefaultNode.ts"],"sourcesContent":["import type { ContentNode } from '@intlayer/types/dictionary';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\n\nimport type { NodeType } from '@intlayer/types/nodeType';\nimport * as NodeTypes from '@intlayer/types/nodeType';\n\nexport const getDefaultNode = (\n  nodeType: NodeType,\n  locales: LocalesValues[],\n  content?: ContentNode\n): ContentNode => {\n  const clonedContent = structuredClone(content);\n  switch (nodeType) {\n    case NodeTypes.TRANSLATION:\n      return {\n        nodeType: NodeTypes.TRANSLATION,\n        [NodeTypes.TRANSLATION]: Object.assign(\n          {},\n          ...locales.map((locale) => ({\n            [locale]: structuredClone(clonedContent) ?? '',\n          }))\n        ),\n      } as ContentNode;\n\n    case NodeTypes.ENUMERATION:\n      return {\n        nodeType: NodeTypes.ENUMERATION,\n        [NodeTypes.ENUMERATION]: {\n          '1': clonedContent ?? '',\n        },\n      } as ContentNode;\n\n    case NodeTypes.PLURAL:\n      return {\n        nodeType: NodeTypes.PLURAL,\n        [NodeTypes.PLURAL]: {\n          one: clonedContent ?? '',\n          other: clonedContent ?? '',\n        },\n      } as ContentNode;\n\n    case NodeTypes.CONDITION:\n      return {\n        nodeType: NodeTypes.CONDITION,\n        [NodeTypes.CONDITION]: {\n          true: clonedContent ?? '',\n          false: clonedContent ?? '',\n        },\n      } as ContentNode;\n\n    case NodeTypes.INSERTION:\n      return {\n        nodeType: NodeTypes.INSERTION,\n        [NodeTypes.INSERTION]: {\n          insertion: clonedContent ?? '',\n        },\n      } as unknown as ContentNode;\n\n    case NodeTypes.NESTED:\n      return {\n        nodeType: NodeTypes.NESTED,\n        [NodeTypes.NESTED]: {\n          dictionaryKey: '',\n        },\n      } as ContentNode;\n\n    case NodeTypes.MARKDOWN:\n      return {\n        nodeType: NodeTypes.MARKDOWN,\n        [NodeTypes.MARKDOWN]: clonedContent ?? '',\n      } as ContentNode;\n\n    case NodeTypes.HTML:\n      return {\n        nodeType: NodeTypes.HTML,\n        [NodeTypes.HTML]: clonedContent ?? '',\n        customComponents: [],\n      } as ContentNode;\n\n    case NodeTypes.FILE:\n      return {\n        nodeType: NodeTypes.FILE,\n        [NodeTypes.FILE]: clonedContent ?? '',\n      } as ContentNode;\n\n    case NodeTypes.OBJECT:\n      return {\n        newKey: clonedContent ?? '',\n      } as unknown as ContentNode;\n\n    case NodeTypes.ARRAY:\n      return [clonedContent ?? ''] as unknown as ContentNode;\n\n    case NodeTypes.TEXT:\n      return clonedContent ?? '';\n\n    case NodeTypes.NUMBER:\n      return clonedContent ?? 0;\n\n    case NodeTypes.BOOLEAN:\n      return clonedContent ?? true;\n\n    default:\n      return clonedContent ?? '';\n  }\n};\n"],"mappings":";;;;;;AAMA,MAAa,kBACX,UACA,SACA,YACgB;CAChB,MAAM,gBAAgB,gBAAgB,OAAO;CAC7C,QAAQ,UAAR;EACE,KAAKA,yBAAU,aACb,OAAO;GACL,UAAUA,yBAAU;IACnBA,yBAAU,cAAc,OAAO,OAC9B,CAAC,GACD,GAAG,QAAQ,KAAK,YAAY,GACzB,SAAS,gBAAgB,aAAa,KAAK,GAC9C,EAAE,CACJ;EACF;EAEF,KAAKA,yBAAU,aACb,OAAO;GACL,UAAUA,yBAAU;IACnBA,yBAAU,cAAc,EACvB,KAAK,iBAAiB,GACxB;EACF;EAEF,KAAKA,yBAAU,QACb,OAAO;GACL,UAAUA,yBAAU;IACnBA,yBAAU,SAAS;IAClB,KAAK,iBAAiB;IACtB,OAAO,iBAAiB;GAC1B;EACF;EAEF,KAAKA,yBAAU,WACb,OAAO;GACL,UAAUA,yBAAU;IACnBA,yBAAU,YAAY;IACrB,MAAM,iBAAiB;IACvB,OAAO,iBAAiB;GAC1B;EACF;EAEF,KAAKA,yBAAU,WACb,OAAO;GACL,UAAUA,yBAAU;IACnBA,yBAAU,YAAY,EACrB,WAAW,iBAAiB,GAC9B;EACF;EAEF,KAAKA,yBAAU,QACb,OAAO;GACL,UAAUA,yBAAU;IACnBA,yBAAU,SAAS,EAClB,eAAe,GACjB;EACF;EAEF,KAAKA,yBAAU,UACb,OAAO;GACL,UAAUA,yBAAU;IACnBA,yBAAU,WAAW,iBAAiB;EACzC;EAEF,KAAKA,yBAAU,MACb,OAAO;GACL,UAAUA,yBAAU;IACnBA,yBAAU,OAAO,iBAAiB;GACnC,kBAAkB,CAAC;EACrB;EAEF,KAAKA,yBAAU,MACb,OAAO;GACL,UAAUA,yBAAU;IACnBA,yBAAU,OAAO,iBAAiB;EACrC;EAEF,KAAKA,yBAAU,QACb,OAAO,EACL,QAAQ,iBAAiB,GAC3B;EAEF,KAAKA,yBAAU,OACb,OAAO,CAAC,iBAAiB,EAAE;EAE7B,KAAKA,yBAAU,MACb,OAAO,iBAAiB;EAE1B,KAAKA,yBAAU,QACb,OAAO,iBAAiB;EAE1B,KAAKA,yBAAU,SACb,OAAO,iBAAiB;EAE1B,SACE,OAAO,iBAAiB;CAC5B;AACF"}
+{"version":3,"file":"getDefaultNode.cjs","names":["NodeTypes"],"sources":["../../../src/dictionaryManipulator/getDefaultNode.ts"],"sourcesContent":["import type { ContentNode } from '@intlayer/types/dictionary';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\n\nimport type { NodeType } from '@intlayer/types/nodeType';\nimport * as NodeTypes from '@intlayer/types/nodeType';\n\nexport const getDefaultNode = (\n  nodeType: NodeType,\n  locales: LocalesValues[],\n  content?: ContentNode\n): ContentNode => {\n  const clonedContent = structuredClone(content);\n  switch (nodeType) {\n    case NodeTypes.TRANSLATION:\n      return {\n        nodeType: NodeTypes.TRANSLATION,\n        [NodeTypes.TRANSLATION]: Object.assign(\n          {},\n          ...locales.map((locale) => ({\n            [locale]: structuredClone(clonedContent) ?? '',\n          }))\n        ),\n      } as ContentNode;\n\n    case NodeTypes.ENUMERATION:\n      return {\n        nodeType: NodeTypes.ENUMERATION,\n        [NodeTypes.ENUMERATION]: {\n          '1': clonedContent ?? '',\n        },\n      } as ContentNode;\n\n    case NodeTypes.PLURAL:\n      return {\n        nodeType: NodeTypes.PLURAL,\n        [NodeTypes.PLURAL]: {\n          one: clonedContent ?? '',\n          other: clonedContent ?? '',\n        },\n      } as ContentNode;\n\n    case NodeTypes.CONDITION:\n      return {\n        nodeType: NodeTypes.CONDITION,\n        [NodeTypes.CONDITION]: {\n          true: clonedContent ?? '',\n          false: clonedContent ?? '',\n        },\n      } as ContentNode;\n\n    case NodeTypes.GENDER:\n      return {\n        nodeType: NodeTypes.GENDER,\n        [NodeTypes.GENDER]: {\n          male: clonedContent ?? '',\n          female: clonedContent ?? '',\n          fallback: clonedContent ?? '',\n        },\n      } as ContentNode;\n\n    case NodeTypes.SELECT:\n      return {\n        nodeType: NodeTypes.SELECT,\n        [NodeTypes.SELECT]: {\n          case1: clonedContent ?? '',\n          fallback: clonedContent ?? '',\n        },\n      } as ContentNode;\n\n    case NodeTypes.INSERTION:\n      return {\n        nodeType: NodeTypes.INSERTION,\n        [NodeTypes.INSERTION]: {\n          insertion: clonedContent ?? '',\n        },\n      } as unknown as ContentNode;\n\n    case NodeTypes.NESTED:\n      return {\n        nodeType: NodeTypes.NESTED,\n        [NodeTypes.NESTED]: {\n          dictionaryKey: '',\n        },\n      } as ContentNode;\n\n    case NodeTypes.MARKDOWN:\n      return {\n        nodeType: NodeTypes.MARKDOWN,\n        [NodeTypes.MARKDOWN]: clonedContent ?? '',\n      } as ContentNode;\n\n    case NodeTypes.HTML:\n      return {\n        nodeType: NodeTypes.HTML,\n        [NodeTypes.HTML]: clonedContent ?? '',\n        customComponents: [],\n      } as ContentNode;\n\n    case NodeTypes.FILE:\n      return {\n        nodeType: NodeTypes.FILE,\n        [NodeTypes.FILE]: clonedContent ?? '',\n      } as ContentNode;\n\n    case NodeTypes.OBJECT:\n      return {\n        newKey: clonedContent ?? '',\n      } as unknown as ContentNode;\n\n    case NodeTypes.ARRAY:\n      return [clonedContent ?? ''] as unknown as ContentNode;\n\n    case NodeTypes.TEXT:\n      return clonedContent ?? '';\n\n    case NodeTypes.NUMBER:\n      return clonedContent ?? 0;\n\n    case NodeTypes.BOOLEAN:\n      return clonedContent ?? true;\n\n    default:\n      return clonedContent ?? '';\n  }\n};\n"],"mappings":";;;;;;AAMA,MAAa,kBACX,UACA,SACA,YACgB;CAChB,MAAM,gBAAgB,gBAAgB,OAAO;CAC7C,QAAQ,UAAR;EACE,KAAKA,yBAAU,aACb,OAAO;GACL,UAAUA,yBAAU;IACnBA,yBAAU,cAAc,OAAO,OAC9B,CAAC,GACD,GAAG,QAAQ,KAAK,YAAY,GACzB,SAAS,gBAAgB,aAAa,KAAK,GAC9C,EAAE,CACJ;EACF;EAEF,KAAKA,yBAAU,aACb,OAAO;GACL,UAAUA,yBAAU;IACnBA,yBAAU,cAAc,EACvB,KAAK,iBAAiB,GACxB;EACF;EAEF,KAAKA,yBAAU,QACb,OAAO;GACL,UAAUA,yBAAU;IACnBA,yBAAU,SAAS;IAClB,KAAK,iBAAiB;IACtB,OAAO,iBAAiB;GAC1B;EACF;EAEF,KAAKA,yBAAU,WACb,OAAO;GACL,UAAUA,yBAAU;IACnBA,yBAAU,YAAY;IACrB,MAAM,iBAAiB;IACvB,OAAO,iBAAiB;GAC1B;EACF;EAEF,KAAKA,yBAAU,QACb,OAAO;GACL,UAAUA,yBAAU;IACnBA,yBAAU,SAAS;IAClB,MAAM,iBAAiB;IACvB,QAAQ,iBAAiB;IACzB,UAAU,iBAAiB;GAC7B;EACF;EAEF,KAAKA,yBAAU,QACb,OAAO;GACL,UAAUA,yBAAU;IACnBA,yBAAU,SAAS;IAClB,OAAO,iBAAiB;IACxB,UAAU,iBAAiB;GAC7B;EACF;EAEF,KAAKA,yBAAU,WACb,OAAO;GACL,UAAUA,yBAAU;IACnBA,yBAAU,YAAY,EACrB,WAAW,iBAAiB,GAC9B;EACF;EAEF,KAAKA,yBAAU,QACb,OAAO;GACL,UAAUA,yBAAU;IACnBA,yBAAU,SAAS,EAClB,eAAe,GACjB;EACF;EAEF,KAAKA,yBAAU,UACb,OAAO;GACL,UAAUA,yBAAU;IACnBA,yBAAU,WAAW,iBAAiB;EACzC;EAEF,KAAKA,yBAAU,MACb,OAAO;GACL,UAAUA,yBAAU;IACnBA,yBAAU,OAAO,iBAAiB;GACnC,kBAAkB,CAAC;EACrB;EAEF,KAAKA,yBAAU,MACb,OAAO;GACL,UAAUA,yBAAU;IACnBA,yBAAU,OAAO,iBAAiB;EACrC;EAEF,KAAKA,yBAAU,QACb,OAAO,EACL,QAAQ,iBAAiB,GAC3B;EAEF,KAAKA,yBAAU,OACb,OAAO,CAAC,iBAAiB,EAAE;EAE7B,KAAKA,yBAAU,MACb,OAAO,iBAAiB;EAE1B,KAAKA,yBAAU,QACb,OAAO,iBAAiB;EAE1B,KAAKA,yBAAU,SACb,OAAO,iBAAiB;EAE1B,SACE,OAAO,iBAAiB;CAC5B;AACF"}

package/dist/cjs/dictionaryManipulator/getEmptyNode.cjs

@@ -11,7 +11,7 @@ const getEmptyNode = (section) => {
 	if (typeof section?.nodeType === "string") {
 		const typedNode = section;
 		const content = typedNode[typedNode.nodeType];
-		if (typedNode.nodeType === _intlayer_types_nodeType.TRANSLATION || typedNode.nodeType === _intlayer_types_nodeType.ENUMERATION || typedNode.nodeType === _intlayer_types_nodeType.PLURAL || typedNode.nodeType === _intlayer_types_nodeType.CONDITION || typedNode.nodeType === _intlayer_types_nodeType.INSERTION || typedNode.nodeType === _intlayer_types_nodeType.HTML) return getEmptyNode(content);
+		if (typedNode.nodeType === _intlayer_types_nodeType.TRANSLATION || typedNode.nodeType === _intlayer_types_nodeType.ENUMERATION || typedNode.nodeType === _intlayer_types_nodeType.PLURAL || typedNode.nodeType === _intlayer_types_nodeType.CONDITION || typedNode.nodeType === _intlayer_types_nodeType.INSERTION || typedNode.nodeType === _intlayer_types_nodeType.GENDER || typedNode.nodeType === _intlayer_types_nodeType.SELECT || typedNode.nodeType === _intlayer_types_nodeType.HTML) return getEmptyNode(content);
 		if (typedNode.nodeType === _intlayer_types_nodeType.NESTED) return "dictionary-key";
 		if (typedNode.nodeType === _intlayer_types_nodeType.FILE) return "file/path";
 		if (typedNode.nodeType === _intlayer_types_nodeType.MARKDOWN) return getEmptyNode(content);

package/dist/cjs/dictionaryManipulator/getEmptyNode.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"getEmptyNode.cjs","names":["NodeTypes"],"sources":["../../../src/dictionaryManipulator/getEmptyNode.ts"],"sourcesContent":["import type { ContentNode, TypedNode } from '@intlayer/types/dictionary';\n\nimport * as NodeTypes from '@intlayer/types/nodeType';\n\nexport const getEmptyNode = (section: ContentNode): ContentNode => {\n  if (typeof section === 'string') {\n    return '';\n  }\n  if (typeof section === 'number') {\n    return 0;\n  }\n  if (typeof section === 'boolean') {\n    return true;\n  }\n  if (typeof (section as TypedNode)?.nodeType === 'string') {\n    const typedNode = section as TypedNode;\n    const content =\n      typedNode[typedNode.nodeType as unknown as keyof typeof typedNode];\n\n    if (\n      typedNode.nodeType === NodeTypes.TRANSLATION ||\n      typedNode.nodeType === NodeTypes.ENUMERATION ||\n      typedNode.nodeType === NodeTypes.PLURAL ||\n      typedNode.nodeType === NodeTypes.CONDITION ||\n      typedNode.nodeType === NodeTypes.INSERTION ||\n      typedNode.nodeType === NodeTypes.HTML\n    ) {\n      return getEmptyNode(content as ContentNode);\n    }\n\n    if (typedNode.nodeType === NodeTypes.NESTED) {\n      return 'dictionary-key';\n    }\n\n    if (typedNode.nodeType === NodeTypes.FILE) {\n      return 'file/path';\n    }\n\n    if (typedNode.nodeType === NodeTypes.MARKDOWN) {\n      return getEmptyNode(content as ContentNode);\n    }\n\n    return content;\n  }\n\n  if (!section || typeof section !== 'object') {\n    return section;\n  }\n\n  if (Array.isArray(section)) {\n    return (section as ContentNode[]).map(\n      getEmptyNode\n    ) as unknown as ContentNode;\n  }\n\n  const mappedSectionObject = Object.entries(section).map(([key, value]) => [\n    key,\n    getEmptyNode(value as ContentNode),\n  ]);\n\n  const mappedSectionArray = Object.fromEntries(mappedSectionObject);\n\n  return mappedSectionArray;\n};\n"],"mappings":";;;;;;AAIA,MAAa,gBAAgB,YAAsC;CACjE,IAAI,OAAO,YAAY,UACrB,OAAO;CAET,IAAI,OAAO,YAAY,UACrB,OAAO;CAET,IAAI,OAAO,YAAY,WACrB,OAAO;CAET,IAAI,OAAQ,SAAuB,aAAa,UAAU;EACxD,MAAM,YAAY;EAClB,MAAM,UACJ,UAAU,UAAU;EAEtB,IACE,UAAU,aAAaA,yBAAU,eACjC,UAAU,aAAaA,yBAAU,eACjC,UAAU,aAAaA,yBAAU,UACjC,UAAU,aAAaA,yBAAU,aACjC,UAAU,aAAaA,yBAAU,aACjC,UAAU,aAAaA,yBAAU,MAEjC,OAAO,aAAa,OAAsB;EAG5C,IAAI,UAAU,aAAaA,yBAAU,QACnC,OAAO;EAGT,IAAI,UAAU,aAAaA,yBAAU,MACnC,OAAO;EAGT,IAAI,UAAU,aAAaA,yBAAU,UACnC,OAAO,aAAa,OAAsB;EAG5C,OAAO;CACT;CAEA,IAAI,CAAC,WAAW,OAAO,YAAY,UACjC,OAAO;CAGT,IAAI,MAAM,QAAQ,OAAO,GACvB,OAAQ,QAA0B,IAChC,YACF;CAGF,MAAM,sBAAsB,OAAO,QAAQ,OAAO,CAAC,CAAC,KAAK,CAAC,KAAK,WAAW,CACxE,KACA,aAAa,KAAoB,CACnC,CAAC;CAID,OAF2B,OAAO,YAAY,mBAEtB;AAC1B"}
+{"version":3,"file":"getEmptyNode.cjs","names":["NodeTypes"],"sources":["../../../src/dictionaryManipulator/getEmptyNode.ts"],"sourcesContent":["import type { ContentNode, TypedNode } from '@intlayer/types/dictionary';\n\nimport * as NodeTypes from '@intlayer/types/nodeType';\n\nexport const getEmptyNode = (section: ContentNode): ContentNode => {\n  if (typeof section === 'string') {\n    return '';\n  }\n  if (typeof section === 'number') {\n    return 0;\n  }\n  if (typeof section === 'boolean') {\n    return true;\n  }\n  if (typeof (section as TypedNode)?.nodeType === 'string') {\n    const typedNode = section as TypedNode;\n    const content =\n      typedNode[typedNode.nodeType as unknown as keyof typeof typedNode];\n\n    if (\n      typedNode.nodeType === NodeTypes.TRANSLATION ||\n      typedNode.nodeType === NodeTypes.ENUMERATION ||\n      typedNode.nodeType === NodeTypes.PLURAL ||\n      typedNode.nodeType === NodeTypes.CONDITION ||\n      typedNode.nodeType === NodeTypes.INSERTION ||\n      typedNode.nodeType === NodeTypes.GENDER ||\n      typedNode.nodeType === NodeTypes.SELECT ||\n      typedNode.nodeType === NodeTypes.HTML\n    ) {\n      return getEmptyNode(content as ContentNode);\n    }\n\n    if (typedNode.nodeType === NodeTypes.NESTED) {\n      return 'dictionary-key';\n    }\n\n    if (typedNode.nodeType === NodeTypes.FILE) {\n      return 'file/path';\n    }\n\n    if (typedNode.nodeType === NodeTypes.MARKDOWN) {\n      return getEmptyNode(content as ContentNode);\n    }\n\n    return content;\n  }\n\n  if (!section || typeof section !== 'object') {\n    return section;\n  }\n\n  if (Array.isArray(section)) {\n    return (section as ContentNode[]).map(\n      getEmptyNode\n    ) as unknown as ContentNode;\n  }\n\n  const mappedSectionObject = Object.entries(section).map(([key, value]) => [\n    key,\n    getEmptyNode(value as ContentNode),\n  ]);\n\n  const mappedSectionArray = Object.fromEntries(mappedSectionObject);\n\n  return mappedSectionArray;\n};\n"],"mappings":";;;;;;AAIA,MAAa,gBAAgB,YAAsC;CACjE,IAAI,OAAO,YAAY,UACrB,OAAO;CAET,IAAI,OAAO,YAAY,UACrB,OAAO;CAET,IAAI,OAAO,YAAY,WACrB,OAAO;CAET,IAAI,OAAQ,SAAuB,aAAa,UAAU;EACxD,MAAM,YAAY;EAClB,MAAM,UACJ,UAAU,UAAU;EAEtB,IACE,UAAU,aAAaA,yBAAU,eACjC,UAAU,aAAaA,yBAAU,eACjC,UAAU,aAAaA,yBAAU,UACjC,UAAU,aAAaA,yBAAU,aACjC,UAAU,aAAaA,yBAAU,aACjC,UAAU,aAAaA,yBAAU,UACjC,UAAU,aAAaA,yBAAU,UACjC,UAAU,aAAaA,yBAAU,MAEjC,OAAO,aAAa,OAAsB;EAG5C,IAAI,UAAU,aAAaA,yBAAU,QACnC,OAAO;EAGT,IAAI,UAAU,aAAaA,yBAAU,MACnC,OAAO;EAGT,IAAI,UAAU,aAAaA,yBAAU,UACnC,OAAO,aAAa,OAAsB;EAG5C,OAAO;CACT;CAEA,IAAI,CAAC,WAAW,OAAO,YAAY,UACjC,OAAO;CAGT,IAAI,MAAM,QAAQ,OAAO,GACvB,OAAQ,QAA0B,IAChC,YACF;CAGF,MAAM,sBAAsB,OAAO,QAAQ,OAAO,CAAC,CAAC,KAAK,CAAC,KAAK,WAAW,CACxE,KACA,aAAa,KAAoB,CACnC,CAAC;CAID,OAF2B,OAAO,YAAY,mBAEtB;AAC1B"}

package/dist/cjs/dictionaryManipulator/getNodeChildren.cjs

@@ -12,7 +12,7 @@ const getNodeChildren = (section) => {
 		const typedNode = section;
 		const content = typedNode[typedNode.nodeType];
 		if (typedNode.nodeType === _intlayer_types_nodeType.MARKDOWN || typedNode.nodeType === _intlayer_types_nodeType.HTML) return content;
-		if (typedNode.nodeType === _intlayer_types_nodeType.TRANSLATION || typedNode.nodeType === _intlayer_types_nodeType.ENUMERATION || typedNode.nodeType === _intlayer_types_nodeType.PLURAL || typedNode.nodeType === _intlayer_types_nodeType.CONDITION || typedNode.nodeType === _intlayer_types_nodeType.INSERTION || typedNode.nodeType === _intlayer_types_nodeType.GENDER || typedNode.nodeType === _intlayer_types_nodeType.FILE) return content[Object.keys(content)[0]];
+		if (typedNode.nodeType === _intlayer_types_nodeType.TRANSLATION || typedNode.nodeType === _intlayer_types_nodeType.ENUMERATION || typedNode.nodeType === _intlayer_types_nodeType.PLURAL || typedNode.nodeType === _intlayer_types_nodeType.CONDITION || typedNode.nodeType === _intlayer_types_nodeType.INSERTION || typedNode.nodeType === _intlayer_types_nodeType.GENDER || typedNode.nodeType === _intlayer_types_nodeType.SELECT || typedNode.nodeType === _intlayer_types_nodeType.FILE) return content[Object.keys(content)[0]];
 		if (typedNode.nodeType === _intlayer_types_nodeType.NESTED) return;
 		return content;
 	}

package/dist/cjs/dictionaryManipulator/getNodeChildren.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"getNodeChildren.cjs","names":["NodeTypes"],"sources":["../../../src/dictionaryManipulator/getNodeChildren.ts"],"sourcesContent":["import type { ContentNode, TypedNode } from '@intlayer/types/dictionary';\n\nimport * as NodeTypes from '@intlayer/types/nodeType';\n\nexport const getNodeChildren = (section: ContentNode): ContentNode => {\n  if (typeof section === 'string') {\n    return section;\n  }\n  if (typeof section === 'number') {\n    return section;\n  }\n  if (typeof section === 'boolean') {\n    return section;\n  }\n  if (typeof (section as TypedNode)?.nodeType === 'string') {\n    const typedNode = section as TypedNode;\n    const content =\n      typedNode[typedNode.nodeType as unknown as keyof typeof typedNode];\n\n    if (\n      typedNode.nodeType === NodeTypes.MARKDOWN ||\n      typedNode.nodeType === NodeTypes.HTML\n    ) {\n      return content as ContentNode;\n    }\n\n    if (\n      typedNode.nodeType === NodeTypes.TRANSLATION ||\n      typedNode.nodeType === NodeTypes.ENUMERATION ||\n      typedNode.nodeType === NodeTypes.PLURAL ||\n      typedNode.nodeType === NodeTypes.CONDITION ||\n      typedNode.nodeType === NodeTypes.INSERTION ||\n      typedNode.nodeType === NodeTypes.GENDER ||\n      typedNode.nodeType === NodeTypes.FILE\n    ) {\n      const firstKey = Object.keys(content)[0] as keyof typeof content;\n      return content[firstKey] as ContentNode;\n    }\n\n    if (typedNode.nodeType === NodeTypes.NESTED) {\n      return undefined;\n    }\n\n    return content;\n  }\n\n  if (!section || typeof section !== 'object') {\n    return section;\n  }\n\n  if (Array.isArray(section)) {\n    return (section as ContentNode[])[0];\n  }\n\n  return section;\n};\n"],"mappings":";;;;;;AAIA,MAAa,mBAAmB,YAAsC;CACpE,IAAI,OAAO,YAAY,UACrB,OAAO;CAET,IAAI,OAAO,YAAY,UACrB,OAAO;CAET,IAAI,OAAO,YAAY,WACrB,OAAO;CAET,IAAI,OAAQ,SAAuB,aAAa,UAAU;EACxD,MAAM,YAAY;EAClB,MAAM,UACJ,UAAU,UAAU;EAEtB,IACE,UAAU,aAAaA,yBAAU,YACjC,UAAU,aAAaA,yBAAU,MAEjC,OAAO;EAGT,IACE,UAAU,aAAaA,yBAAU,eACjC,UAAU,aAAaA,yBAAU,eACjC,UAAU,aAAaA,yBAAU,UACjC,UAAU,aAAaA,yBAAU,aACjC,UAAU,aAAaA,yBAAU,aACjC,UAAU,aAAaA,yBAAU,UACjC,UAAU,aAAaA,yBAAU,MAGjC,OAAO,QADU,OAAO,KAAK,OAAO,CAAC,CAAC;EAIxC,IAAI,UAAU,aAAaA,yBAAU,QACnC;EAGF,OAAO;CACT;CAEA,IAAI,CAAC,WAAW,OAAO,YAAY,UACjC,OAAO;CAGT,IAAI,MAAM,QAAQ,OAAO,GACvB,OAAQ,QAA0B;CAGpC,OAAO;AACT"}
+{"version":3,"file":"getNodeChildren.cjs","names":["NodeTypes"],"sources":["../../../src/dictionaryManipulator/getNodeChildren.ts"],"sourcesContent":["import type { ContentNode, TypedNode } from '@intlayer/types/dictionary';\n\nimport * as NodeTypes from '@intlayer/types/nodeType';\n\nexport const getNodeChildren = (section: ContentNode): ContentNode => {\n  if (typeof section === 'string') {\n    return section;\n  }\n  if (typeof section === 'number') {\n    return section;\n  }\n  if (typeof section === 'boolean') {\n    return section;\n  }\n  if (typeof (section as TypedNode)?.nodeType === 'string') {\n    const typedNode = section as TypedNode;\n    const content =\n      typedNode[typedNode.nodeType as unknown as keyof typeof typedNode];\n\n    if (\n      typedNode.nodeType === NodeTypes.MARKDOWN ||\n      typedNode.nodeType === NodeTypes.HTML\n    ) {\n      return content as ContentNode;\n    }\n\n    if (\n      typedNode.nodeType === NodeTypes.TRANSLATION ||\n      typedNode.nodeType === NodeTypes.ENUMERATION ||\n      typedNode.nodeType === NodeTypes.PLURAL ||\n      typedNode.nodeType === NodeTypes.CONDITION ||\n      typedNode.nodeType === NodeTypes.INSERTION ||\n      typedNode.nodeType === NodeTypes.GENDER ||\n      typedNode.nodeType === NodeTypes.SELECT ||\n      typedNode.nodeType === NodeTypes.FILE\n    ) {\n      const firstKey = Object.keys(content)[0] as keyof typeof content;\n      return content[firstKey] as ContentNode;\n    }\n\n    if (typedNode.nodeType === NodeTypes.NESTED) {\n      return undefined;\n    }\n\n    return content;\n  }\n\n  if (!section || typeof section !== 'object') {\n    return section;\n  }\n\n  if (Array.isArray(section)) {\n    return (section as ContentNode[])[0];\n  }\n\n  return section;\n};\n"],"mappings":";;;;;;AAIA,MAAa,mBAAmB,YAAsC;CACpE,IAAI,OAAO,YAAY,UACrB,OAAO;CAET,IAAI,OAAO,YAAY,UACrB,OAAO;CAET,IAAI,OAAO,YAAY,WACrB,OAAO;CAET,IAAI,OAAQ,SAAuB,aAAa,UAAU;EACxD,MAAM,YAAY;EAClB,MAAM,UACJ,UAAU,UAAU;EAEtB,IACE,UAAU,aAAaA,yBAAU,YACjC,UAAU,aAAaA,yBAAU,MAEjC,OAAO;EAGT,IACE,UAAU,aAAaA,yBAAU,eACjC,UAAU,aAAaA,yBAAU,eACjC,UAAU,aAAaA,yBAAU,UACjC,UAAU,aAAaA,yBAAU,aACjC,UAAU,aAAaA,yBAAU,aACjC,UAAU,aAAaA,yBAAU,UACjC,UAAU,aAAaA,yBAAU,UACjC,UAAU,aAAaA,yBAAU,MAGjC,OAAO,QADU,OAAO,KAAK,OAAO,CAAC,CAAC;EAIxC,IAAI,UAAU,aAAaA,yBAAU,QACnC;EAGF,OAAO;CACT;CAEA,IAAI,CAAC,WAAW,OAAO,YAAY,UACjC,OAAO;CAGT,IAAI,MAAM,QAAQ,OAAO,GACvB,OAAQ,QAA0B;CAGpC,OAAO;AACT"}

package/dist/cjs/dictionaryManipulator/getNodeType.cjs

@@ -12,30 +12,38 @@ const isTypedNode = (content) => {
 	return typeof content === "object" && content !== null && "nodeType" in content && typeof content.nodeType === "string";
 };
 /**
-* Type guard to check if content is a valid NodeType
+* Every known {@link NodeType}, as a lookup record.
+*
+* Typed as `Record<NodeType, true>` so that adding a node type to
+* `@intlayer/types` without registering it here becomes a compile-time error.
 */
-const isValidNodeType = (nodeType) => {
-	return [
-		_intlayer_types_nodeType.TRANSLATION,
-		_intlayer_types_nodeType.ENUMERATION,
-		_intlayer_types_nodeType.PLURAL,
-		_intlayer_types_nodeType.CONDITION,
-		_intlayer_types_nodeType.INSERTION,
-		_intlayer_types_nodeType.FILE,
-		_intlayer_types_nodeType.OBJECT,
-		_intlayer_types_nodeType.ARRAY,
-		_intlayer_types_nodeType.NESTED,
-		_intlayer_types_nodeType.REACT_NODE,
-		_intlayer_types_nodeType.MARKDOWN,
-		_intlayer_types_nodeType.HTML,
-		_intlayer_types_nodeType.TEXT,
-		_intlayer_types_nodeType.NUMBER,
-		_intlayer_types_nodeType.BOOLEAN,
-		_intlayer_types_nodeType.GENDER,
-		_intlayer_types_nodeType.NULL,
-		_intlayer_types_nodeType.UNKNOWN
-	].includes(nodeType);
+const validNodeTypes = {
+	[_intlayer_types_nodeType.TRANSLATION]: true,
+	[_intlayer_types_nodeType.ENUMERATION]: true,
+	[_intlayer_types_nodeType.PLURAL]: true,
+	[_intlayer_types_nodeType.CONDITION]: true,
+	[_intlayer_types_nodeType.INSERTION]: true,
+	[_intlayer_types_nodeType.FILE]: true,
+	[_intlayer_types_nodeType.OBJECT]: true,
+	[_intlayer_types_nodeType.ARRAY]: true,
+	[_intlayer_types_nodeType.NESTED]: true,
+	[_intlayer_types_nodeType.REACT_NODE]: true,
+	[_intlayer_types_nodeType.PREACT_NODE]: true,
+	[_intlayer_types_nodeType.SOLID_NODE]: true,
+	[_intlayer_types_nodeType.MARKDOWN]: true,
+	[_intlayer_types_nodeType.HTML]: true,
+	[_intlayer_types_nodeType.TEXT]: true,
+	[_intlayer_types_nodeType.NUMBER]: true,
+	[_intlayer_types_nodeType.BOOLEAN]: true,
+	[_intlayer_types_nodeType.GENDER]: true,
+	[_intlayer_types_nodeType.SELECT]: true,
+	[_intlayer_types_nodeType.NULL]: true,
+	[_intlayer_types_nodeType.UNKNOWN]: true
 };
+/**
+* Type guard to check if a raw string is a valid {@link NodeType}
+*/
+const isValidNodeType = (nodeType) => Object.hasOwn(validNodeTypes, nodeType);
 const getNodeType = (content) => {
 	if (typeof content === "string") return _intlayer_types_nodeType.TEXT;
 	if (isTypedNode(content)) {

package/dist/cjs/dictionaryManipulator/getNodeType.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"getNodeType.cjs","names":["NodeTypes","isValidElement"],"sources":["../../../src/dictionaryManipulator/getNodeType.ts"],"sourcesContent":["import type { ContentNode, TypedNode } from '@intlayer/types/dictionary';\n\nimport type { NodeType } from '@intlayer/types/nodeType';\nimport * as NodeTypes from '@intlayer/types/nodeType';\nimport { isValidElement } from '../utils/isValidReactElement';\n\n/**\n * Type guard to check if content is a TypedNode\n */\nconst isTypedNode = (content: unknown): content is TypedNode => {\n  return (\n    typeof content === 'object' &&\n    content !== null &&\n    'nodeType' in content &&\n    typeof (content as TypedNode).nodeType === 'string'\n  );\n};\n\n/**\n * Type guard to check if content is a valid NodeType\n */\nconst isValidNodeType = (nodeType: string): nodeType is NodeType => {\n  return [\n    NodeTypes.TRANSLATION,\n    NodeTypes.ENUMERATION,\n    NodeTypes.PLURAL,\n    NodeTypes.CONDITION,\n    NodeTypes.INSERTION,\n    NodeTypes.FILE,\n    NodeTypes.OBJECT,\n    NodeTypes.ARRAY,\n    NodeTypes.NESTED,\n    NodeTypes.REACT_NODE,\n    NodeTypes.MARKDOWN,\n    NodeTypes.HTML,\n    NodeTypes.TEXT,\n    NodeTypes.NUMBER,\n    NodeTypes.BOOLEAN,\n    NodeTypes.GENDER,\n    NodeTypes.NULL,\n    NodeTypes.UNKNOWN,\n  ].includes(nodeType as NodeType);\n};\n\nexport const getNodeType = (content: ContentNode): NodeType => {\n  if (typeof content === 'string') {\n    return NodeTypes.TEXT;\n  }\n\n  if (isTypedNode(content)) {\n    const nodeType = content.nodeType;\n    if (isValidNodeType(nodeType)) {\n      return nodeType;\n    }\n    // Fallback for unknown node types\n    return NodeTypes.UNKNOWN;\n  }\n\n  if (Array.isArray(content)) {\n    return NodeTypes.ARRAY;\n  }\n\n  if (isValidElement(content)) {\n    return NodeTypes.REACT_NODE;\n  }\n\n  if (typeof content === 'number') {\n    return NodeTypes.NUMBER;\n  }\n\n  if (typeof content === 'boolean') {\n    return NodeTypes.BOOLEAN;\n  }\n\n  if (content && typeof content === 'object') {\n    return NodeTypes.OBJECT;\n  }\n\n  if (content === null) {\n    return NodeTypes.NULL;\n  }\n\n  return NodeTypes.UNKNOWN;\n};\n"],"mappings":";;;;;;;;;;AASA,MAAM,eAAe,YAA2C;CAC9D,OACE,OAAO,YAAY,YACnB,YAAY,QACZ,cAAc,WACd,OAAQ,QAAsB,aAAa;AAE/C;;;;AAKA,MAAM,mBAAmB,aAA2C;CAClE,OAAO;EACLA,yBAAU;EACVA,yBAAU;EACVA,yBAAU;EACVA,yBAAU;EACVA,yBAAU;EACVA,yBAAU;EACVA,yBAAU;EACVA,yBAAU;EACVA,yBAAU;EACVA,yBAAU;EACVA,yBAAU;EACVA,yBAAU;EACVA,yBAAU;EACVA,yBAAU;EACVA,yBAAU;EACVA,yBAAU;EACVA,yBAAU;EACVA,yBAAU;CACZ,CAAC,CAAC,SAAS,QAAoB;AACjC;AAEA,MAAa,eAAe,YAAmC;CAC7D,IAAI,OAAO,YAAY,UACrB,OAAOA,yBAAU;CAGnB,IAAI,YAAY,OAAO,GAAG;EACxB,MAAM,WAAW,QAAQ;EACzB,IAAI,gBAAgB,QAAQ,GAC1B,OAAO;EAGT,OAAOA,yBAAU;CACnB;CAEA,IAAI,MAAM,QAAQ,OAAO,GACvB,OAAOA,yBAAU;CAGnB,IAAIC,iDAAe,OAAO,GACxB,OAAOD,yBAAU;CAGnB,IAAI,OAAO,YAAY,UACrB,OAAOA,yBAAU;CAGnB,IAAI,OAAO,YAAY,WACrB,OAAOA,yBAAU;CAGnB,IAAI,WAAW,OAAO,YAAY,UAChC,OAAOA,yBAAU;CAGnB,IAAI,YAAY,MACd,OAAOA,yBAAU;CAGnB,OAAOA,yBAAU;AACnB"}
+{"version":3,"file":"getNodeType.cjs","names":["NodeTypes","isValidElement"],"sources":["../../../src/dictionaryManipulator/getNodeType.ts"],"sourcesContent":["import type { ContentNode, TypedNode } from '@intlayer/types/dictionary';\n\nimport type { NodeType } from '@intlayer/types/nodeType';\nimport * as NodeTypes from '@intlayer/types/nodeType';\nimport { isValidElement } from '../utils/isValidReactElement';\n\n/**\n * Type guard to check if content is a TypedNode\n */\nconst isTypedNode = (content: unknown): content is TypedNode => {\n  return (\n    typeof content === 'object' &&\n    content !== null &&\n    'nodeType' in content &&\n    typeof (content as TypedNode).nodeType === 'string'\n  );\n};\n\n/**\n * Every known {@link NodeType}, as a lookup record.\n *\n * Typed as `Record<NodeType, true>` so that adding a node type to\n * `@intlayer/types` without registering it here becomes a compile-time error.\n */\nconst validNodeTypes: Record<NodeType, true> = {\n  [NodeTypes.TRANSLATION]: true,\n  [NodeTypes.ENUMERATION]: true,\n  [NodeTypes.PLURAL]: true,\n  [NodeTypes.CONDITION]: true,\n  [NodeTypes.INSERTION]: true,\n  [NodeTypes.FILE]: true,\n  [NodeTypes.OBJECT]: true,\n  [NodeTypes.ARRAY]: true,\n  [NodeTypes.NESTED]: true,\n  [NodeTypes.REACT_NODE]: true,\n  [NodeTypes.PREACT_NODE]: true,\n  [NodeTypes.SOLID_NODE]: true,\n  [NodeTypes.MARKDOWN]: true,\n  [NodeTypes.HTML]: true,\n  [NodeTypes.TEXT]: true,\n  [NodeTypes.NUMBER]: true,\n  [NodeTypes.BOOLEAN]: true,\n  [NodeTypes.GENDER]: true,\n  [NodeTypes.SELECT]: true,\n  [NodeTypes.NULL]: true,\n  [NodeTypes.UNKNOWN]: true,\n};\n\n/**\n * Type guard to check if a raw string is a valid {@link NodeType}\n */\nconst isValidNodeType = (nodeType: string): nodeType is NodeType =>\n  Object.hasOwn(validNodeTypes, nodeType);\n\nexport const getNodeType = (content: ContentNode): NodeType => {\n  if (typeof content === 'string') {\n    return NodeTypes.TEXT;\n  }\n\n  if (isTypedNode(content)) {\n    const nodeType = content.nodeType;\n    if (isValidNodeType(nodeType)) {\n      return nodeType;\n    }\n    // Fallback for unknown node types\n    return NodeTypes.UNKNOWN;\n  }\n\n  if (Array.isArray(content)) {\n    return NodeTypes.ARRAY;\n  }\n\n  if (isValidElement(content)) {\n    return NodeTypes.REACT_NODE;\n  }\n\n  if (typeof content === 'number') {\n    return NodeTypes.NUMBER;\n  }\n\n  if (typeof content === 'boolean') {\n    return NodeTypes.BOOLEAN;\n  }\n\n  if (content && typeof content === 'object') {\n    return NodeTypes.OBJECT;\n  }\n\n  if (content === null) {\n    return NodeTypes.NULL;\n  }\n\n  return NodeTypes.UNKNOWN;\n};\n"],"mappings":";;;;;;;;;;AASA,MAAM,eAAe,YAA2C;CAC9D,OACE,OAAO,YAAY,YACnB,YAAY,QACZ,cAAc,WACd,OAAQ,QAAsB,aAAa;AAE/C;;;;;;;AAQA,MAAM,iBAAyC;EAC5CA,yBAAU,cAAc;EACxBA,yBAAU,cAAc;EACxBA,yBAAU,SAAS;EACnBA,yBAAU,YAAY;EACtBA,yBAAU,YAAY;EACtBA,yBAAU,OAAO;EACjBA,yBAAU,SAAS;EACnBA,yBAAU,QAAQ;EAClBA,yBAAU,SAAS;EACnBA,yBAAU,aAAa;EACvBA,yBAAU,cAAc;EACxBA,yBAAU,aAAa;EACvBA,yBAAU,WAAW;EACrBA,yBAAU,OAAO;EACjBA,yBAAU,OAAO;EACjBA,yBAAU,SAAS;EACnBA,yBAAU,UAAU;EACpBA,yBAAU,SAAS;EACnBA,yBAAU,SAAS;EACnBA,yBAAU,OAAO;EACjBA,yBAAU,UAAU;AACvB;;;;AAKA,MAAM,mBAAmB,aACvB,OAAO,OAAO,gBAAgB,QAAQ;AAExC,MAAa,eAAe,YAAmC;CAC7D,IAAI,OAAO,YAAY,UACrB,OAAOA,yBAAU;CAGnB,IAAI,YAAY,OAAO,GAAG;EACxB,MAAM,WAAW,QAAQ;EACzB,IAAI,gBAAgB,QAAQ,GAC1B,OAAO;EAGT,OAAOA,yBAAU;CACnB;CAEA,IAAI,MAAM,QAAQ,OAAO,GACvB,OAAOA,yBAAU;CAGnB,IAAIC,iDAAe,OAAO,GACxB,OAAOD,yBAAU;CAGnB,IAAI,OAAO,YAAY,UACrB,OAAOA,yBAAU;CAGnB,IAAI,OAAO,YAAY,WACrB,OAAOA,yBAAU;CAGnB,IAAI,WAAW,OAAO,YAAY,UAChC,OAAOA,yBAAU;CAGnB,IAAI,YAAY,MACd,OAAOA,yBAAU;CAGnB,OAAOA,yBAAU;AACnB"}

package/dist/cjs/dictionaryManipulator/index.cjs

@@ -15,6 +15,7 @@ const require_dictionaryManipulator_renameContentNodeByKeyPath = require('./rena
 const require_dictionaryManipulator_updateNodeChildren = require('./updateNodeChildren.cjs');
 
 exports.COMPOSITE_ID_SEPARATOR = require_dictionaryManipulator_qualifiedDictionary.COMPOSITE_ID_SEPARATOR;
+exports.DEFAULT_VARIANT_ID = require_dictionaryManipulator_qualifiedDictionary.DEFAULT_VARIANT_ID;
 exports.QUALIFIER_DYNAMIC_TYPES_KEY = require_dictionaryManipulator_qualifiedDictionary.QUALIFIER_DYNAMIC_TYPES_KEY;
 exports.QUALIFIER_ORDER = require_dictionaryManipulator_qualifiedDictionary.QUALIFIER_ORDER;
 exports.editDictionaryByKeyPath = require_dictionaryManipulator_editDictionaryByKeyPath.editDictionaryByKeyPath;

package/dist/cjs/dictionaryManipulator/mergeQualifiedDictionaries.cjs

@@ -15,7 +15,10 @@ let _intlayer_config_logger = require("@intlayer/config/logger");
 *   `variant → item`). Dictionaries are grouped by their composite id
 *   (one segment per dimension), merged within each group (locale completion /
 *   priority overrides preserved), and a `QualifiedDictionaryGroup` is returned.
-*   Unqualified siblings act as shared base content merged into every entry.
+*   Unqualified siblings act as shared base content merged into every entry —
+*   and, on a variant-only key, also materialize the `default` entry when no
+*   declaration claims it. Every other variant entry then inherits from that
+*   `default` entry, so a variant only declares the fields it overrides.
 *
 * Every qualified entry must declare ALL dimensions of the group; an entry that
 * declares only a subset is ambiguous and is rejected with an error log.
@@ -45,10 +48,30 @@ const mergeQualifiedDictionaries = (dictionaries) => {
 			entriesDictionaries.set(compositeId, existingEntries);
 		}
 	});
+	if (groupQualifierTypes.length === 1 && groupQualifierTypes[0] === "variant" && baseDictionaries.length > 0 && !entriesDictionaries.has("default")) entriesDictionaries.set(require_dictionaryManipulator_qualifiedDictionary.DEFAULT_VARIANT_ID, []);
 	const content = {};
 	let importMode;
+	const variantIndex = groupQualifierTypes.indexOf("variant");
+	/**
+	* The id of the entry a composite id inherits from — itself with its variant
+	* segment swapped for `default` (`'promo/2'` → `'default/2'`). `undefined`
+	* for the default entries themselves and for keys with no variant dimension.
+	*/
+	const getInheritedEntryId = (compositeId) => {
+		if (variantIndex === -1) return void 0;
+		const segments = compositeId.split("/");
+		if (segments[variantIndex] === "default") return void 0;
+		segments[variantIndex] = require_dictionaryManipulator_qualifiedDictionary.DEFAULT_VARIANT_ID;
+		return segments.join("/");
+	};
 	for (const [compositeId, qualifiedDictionaries] of entriesDictionaries) {
-		content[compositeId] = require_dictionaryManipulator_mergeDictionaries.mergeDictionaries([...qualifiedDictionaries, ...baseDictionaries]).content;
+		const inheritedEntryId = getInheritedEntryId(compositeId);
+		const inheritedDictionaries = inheritedEntryId ? entriesDictionaries.get(inheritedEntryId) ?? [] : [];
+		content[compositeId] = require_dictionaryManipulator_mergeDictionaries.mergeDictionaries([
+			...qualifiedDictionaries,
+			...inheritedDictionaries,
+			...baseDictionaries
+		]).content;
 		const [firstQualified] = qualifiedDictionaries;
 		importMode ??= firstQualified?.importMode;
 	}

package/dist/cjs/dictionaryManipulator/mergeQualifiedDictionaries.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"mergeQualifiedDictionaries.cjs","names":["getDictionaryQualifierTypes","QUALIFIER_ORDER","mergeDictionaries","getDictionaryCompositeIds"],"sources":["../../../src/dictionaryManipulator/mergeQualifiedDictionaries.ts"],"sourcesContent":["import { log } from '@intlayer/config/built';\nimport { colorizeKey, getAppLogger } from '@intlayer/config/logger';\nimport type {\n  Dictionary,\n  DictionaryQualifierType,\n  QualifiedDictionaryGroup,\n} from '@intlayer/types/dictionary';\nimport { mergeDictionaries } from './mergeDictionaries';\nimport {\n  getDictionaryCompositeIds,\n  getDictionaryQualifierTypes,\n  QUALIFIER_ORDER,\n} from './qualifiedDictionary';\n\n/**\n * Merges sibling dictionaries sharing the same key, honouring qualifiers.\n *\n * - No dictionary declares a qualifier → behaves exactly like\n *   `mergeDictionaries` (single merged dictionary).\n * - At least one dictionary declares a qualifier → the group's dimension set is\n *   the union of every declared dimension (in canonical order\n *   `variant → item`). Dictionaries are grouped by their composite id\n *   (one segment per dimension), merged within each group (locale completion /\n *   priority overrides preserved), and a `QualifiedDictionaryGroup` is returned.\n *   Unqualified siblings act as shared base content merged into every entry.\n *\n * Every qualified entry must declare ALL dimensions of the group; an entry that\n * declares only a subset is ambiguous and is rejected with an error log.\n */\nexport const mergeQualifiedDictionaries = (\n  dictionaries: Dictionary[]\n): Dictionary | QualifiedDictionaryGroup => {\n  const perDictionaryTypes = dictionaries.map(getDictionaryQualifierTypes);\n\n  const declaredDimensions = new Set<DictionaryQualifierType>();\n  for (const types of perDictionaryTypes) {\n    for (const type of types) declaredDimensions.add(type);\n  }\n\n  // Canonical order, restricted to the dimensions actually declared.\n  const groupQualifierTypes = QUALIFIER_ORDER.filter((qualifierType) =>\n    declaredDimensions.has(qualifierType)\n  );\n\n  if (groupQualifierTypes.length === 0) {\n    return mergeDictionaries(dictionaries);\n  }\n\n  const appLogger = getAppLogger({ log });\n\n  const baseDictionaries: Dictionary[] = [];\n  const entriesDictionaries = new Map<string, Dictionary[]>();\n\n  dictionaries.forEach((dictionary, index) => {\n    if (perDictionaryTypes[index]?.length === 0) {\n      baseDictionaries.push(dictionary);\n      return;\n    }\n\n    // A dictionary may map to several composite ids (array variant fan-out):\n    // its content is registered under every id it lists.\n    const compositeIds = getDictionaryCompositeIds(\n      dictionary,\n      groupQualifierTypes\n    );\n\n    if (compositeIds === undefined) {\n      appLogger(\n        `Dictionary ${colorizeKey(dictionary.key)} declares (${perDictionaryTypes[index].join(', ')}) but the key's dimensions are (${groupQualifierTypes.join(', ')}); every entry must declare all of them. Entry ignored${dictionary.filePath ? ` - ${dictionary.filePath}` : ''}.`,\n        { level: 'error' }\n      );\n      return;\n    }\n\n    for (const compositeId of compositeIds) {\n      const existingEntries = entriesDictionaries.get(compositeId) ?? [];\n      existingEntries.push(dictionary);\n      entriesDictionaries.set(compositeId, existingEntries);\n    }\n  });\n\n  // `content` maps each composite id to its resolved content node directly; the\n  // qualifier coordinates live in the key, not in a per-entry wrapper. For an\n  // object variant the variant segment is the canonical serialization of the\n  // object, so it fully identifies the entry — no side-map is needed.\n  const content: Record<string, unknown> = {};\n\n  let importMode: Dictionary['importMode'];\n\n  for (const [compositeId, qualifiedDictionaries] of entriesDictionaries) {\n    // Unqualified siblings act as shared base content: appended last so the\n    // qualified entries take precedence (mergeDictionaries prefers first).\n    const mergedEntry = mergeDictionaries([\n      ...qualifiedDictionaries,\n      ...baseDictionaries,\n    ]);\n\n    content[compositeId] = mergedEntry.content;\n\n    const [firstQualified] = qualifiedDictionaries;\n\n    importMode ??= firstQualified?.importMode;\n  }\n\n  const localIds = Array.from(\n    new Set(\n      dictionaries\n        .filter((dictionary) => dictionary.localId)\n        .map((dictionary) => dictionary.localId!)\n    )\n  );\n\n  return {\n    key: dictionaries[0]!.key,\n    qualifierTypes: groupQualifierTypes,\n    content,\n    ...(importMode !== undefined && { importMode }),\n    localIds,\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AA6BA,MAAa,8BACX,iBAC0C;CAC1C,MAAM,qBAAqB,aAAa,IAAIA,6EAA2B;CAEvE,MAAM,qCAAqB,IAAI,IAA6B;CAC5D,KAAK,MAAM,SAAS,oBAClB,KAAK,MAAM,QAAQ,OAAO,mBAAmB,IAAI,IAAI;CAIvD,MAAM,sBAAsBC,kEAAgB,QAAQ,kBAClD,mBAAmB,IAAI,aAAa,CACtC;CAEA,IAAI,oBAAoB,WAAW,GACjC,OAAOC,kEAAkB,YAAY;CAGvC,MAAM,sDAAyB,EAAE,gCAAI,CAAC;CAEtC,MAAM,mBAAiC,CAAC;CACxC,MAAM,sCAAsB,IAAI,IAA0B;CAE1D,aAAa,SAAS,YAAY,UAAU;EAC1C,IAAI,mBAAmB,MAAM,EAAE,WAAW,GAAG;GAC3C,iBAAiB,KAAK,UAAU;GAChC;EACF;EAIA,MAAM,eAAeC,4EACnB,YACA,mBACF;EAEA,IAAI,iBAAiB,QAAW;GAC9B,UACE,uDAA0B,WAAW,GAAG,EAAE,aAAa,mBAAmB,MAAM,CAAC,KAAK,IAAI,EAAE,kCAAkC,oBAAoB,KAAK,IAAI,EAAE,wDAAwD,WAAW,WAAW,MAAM,WAAW,aAAa,GAAG,IAC5Q,EAAE,OAAO,QAAQ,CACnB;GACA;EACF;EAEA,KAAK,MAAM,eAAe,cAAc;GACtC,MAAM,kBAAkB,oBAAoB,IAAI,WAAW,KAAK,CAAC;GACjE,gBAAgB,KAAK,UAAU;GAC/B,oBAAoB,IAAI,aAAa,eAAe;EACtD;CACF,CAAC;CAMD,MAAM,UAAmC,CAAC;CAE1C,IAAI;CAEJ,KAAK,MAAM,CAAC,aAAa,0BAA0B,qBAAqB;EAQtE,QAAQ,eALYD,kEAAkB,CACpC,GAAG,uBACH,GAAG,gBACL,CAEiC,CAAC,CAAC;EAEnC,MAAM,CAAC,kBAAkB;EAEzB,eAAe,gBAAgB;CACjC;CAEA,MAAM,WAAW,MAAM,KACrB,IAAI,IACF,aACG,QAAQ,eAAe,WAAW,OAAO,CAAC,CAC1C,KAAK,eAAe,WAAW,OAAQ,CAC5C,CACF;CAEA,OAAO;EACL,KAAK,aAAa,EAAE,CAAE;EACtB,gBAAgB;EAChB;EACA,GAAI,eAAe,UAAa,EAAE,WAAW;EAC7C;CACF;AACF"}
+{"version":3,"file":"mergeQualifiedDictionaries.cjs","names":["getDictionaryQualifierTypes","QUALIFIER_ORDER","mergeDictionaries","getDictionaryCompositeIds","DEFAULT_VARIANT_ID"],"sources":["../../../src/dictionaryManipulator/mergeQualifiedDictionaries.ts"],"sourcesContent":["import { log } from '@intlayer/config/built';\nimport { colorizeKey, getAppLogger } from '@intlayer/config/logger';\nimport type {\n  Dictionary,\n  DictionaryQualifierType,\n  QualifiedDictionaryGroup,\n} from '@intlayer/types/dictionary';\nimport { mergeDictionaries } from './mergeDictionaries';\nimport {\n  COMPOSITE_ID_SEPARATOR,\n  DEFAULT_VARIANT_ID,\n  getDictionaryCompositeIds,\n  getDictionaryQualifierTypes,\n  QUALIFIER_ORDER,\n} from './qualifiedDictionary';\n\n/**\n * Merges sibling dictionaries sharing the same key, honouring qualifiers.\n *\n * - No dictionary declares a qualifier → behaves exactly like\n *   `mergeDictionaries` (single merged dictionary).\n * - At least one dictionary declares a qualifier → the group's dimension set is\n *   the union of every declared dimension (in canonical order\n *   `variant → item`). Dictionaries are grouped by their composite id\n *   (one segment per dimension), merged within each group (locale completion /\n *   priority overrides preserved), and a `QualifiedDictionaryGroup` is returned.\n *   Unqualified siblings act as shared base content merged into every entry —\n *   and, on a variant-only key, also materialize the `default` entry when no\n *   declaration claims it. Every other variant entry then inherits from that\n *   `default` entry, so a variant only declares the fields it overrides.\n *\n * Every qualified entry must declare ALL dimensions of the group; an entry that\n * declares only a subset is ambiguous and is rejected with an error log.\n */\nexport const mergeQualifiedDictionaries = (\n  dictionaries: Dictionary[]\n): Dictionary | QualifiedDictionaryGroup => {\n  const perDictionaryTypes = dictionaries.map(getDictionaryQualifierTypes);\n\n  const declaredDimensions = new Set<DictionaryQualifierType>();\n  for (const types of perDictionaryTypes) {\n    for (const type of types) declaredDimensions.add(type);\n  }\n\n  // Canonical order, restricted to the dimensions actually declared.\n  const groupQualifierTypes = QUALIFIER_ORDER.filter((qualifierType) =>\n    declaredDimensions.has(qualifierType)\n  );\n\n  if (groupQualifierTypes.length === 0) {\n    return mergeDictionaries(dictionaries);\n  }\n\n  const appLogger = getAppLogger({ log });\n\n  const baseDictionaries: Dictionary[] = [];\n  const entriesDictionaries = new Map<string, Dictionary[]>();\n\n  dictionaries.forEach((dictionary, index) => {\n    if (perDictionaryTypes[index]?.length === 0) {\n      baseDictionaries.push(dictionary);\n      return;\n    }\n\n    // A dictionary may map to several composite ids (array variant fan-out):\n    // its content is registered under every id it lists.\n    const compositeIds = getDictionaryCompositeIds(\n      dictionary,\n      groupQualifierTypes\n    );\n\n    if (compositeIds === undefined) {\n      appLogger(\n        `Dictionary ${colorizeKey(dictionary.key)} declares (${perDictionaryTypes[index].join(', ')}) but the key's dimensions are (${groupQualifierTypes.join(', ')}); every entry must declare all of them. Entry ignored${dictionary.filePath ? ` - ${dictionary.filePath}` : ''}.`,\n        { level: 'error' }\n      );\n      return;\n    }\n\n    for (const compositeId of compositeIds) {\n      const existingEntries = entriesDictionaries.get(compositeId) ?? [];\n      existingEntries.push(dictionary);\n      entriesDictionaries.set(compositeId, existingEntries);\n    }\n  });\n\n  // Unqualified siblings are the key's base content. On a variant key they also\n  // materialize the `default` entry when no declaration claims it, so the key\n  // still resolves when no variant is selected — and so variants that declare\n  // no entry of their own can fall back to it. Registering an empty entry list\n  // is enough: the merge loop below appends the base dictionaries to it.\n  //\n  // Composite (variant × item) keys are excluded: base content carries no item\n  // index, so it cannot be placed on the collection axis.\n  const isVariantOnlyGroup =\n    groupQualifierTypes.length === 1 && groupQualifierTypes[0] === 'variant';\n\n  if (\n    isVariantOnlyGroup &&\n    baseDictionaries.length > 0 &&\n    !entriesDictionaries.has(DEFAULT_VARIANT_ID)\n  ) {\n    entriesDictionaries.set(DEFAULT_VARIANT_ID, []);\n  }\n\n  // `content` maps each composite id to its resolved content node directly; the\n  // qualifier coordinates live in the key, not in a per-entry wrapper. For an\n  // object variant the variant segment is the canonical serialization of the\n  // object, so it fully identifies the entry — no side-map is needed.\n  const content: Record<string, unknown> = {};\n\n  let importMode: Dictionary['importMode'];\n\n  const variantIndex = groupQualifierTypes.indexOf('variant');\n\n  /**\n   * The id of the entry a composite id inherits from — itself with its variant\n   * segment swapped for `default` (`'promo/2'` → `'default/2'`). `undefined`\n   * for the default entries themselves and for keys with no variant dimension.\n   */\n  const getInheritedEntryId = (compositeId: string): string | undefined => {\n    if (variantIndex === -1) return undefined;\n\n    const segments = compositeId.split(COMPOSITE_ID_SEPARATOR);\n    if (segments[variantIndex] === DEFAULT_VARIANT_ID) return undefined;\n\n    segments[variantIndex] = DEFAULT_VARIANT_ID;\n    return segments.join(COMPOSITE_ID_SEPARATOR);\n  };\n\n  for (const [compositeId, qualifiedDictionaries] of entriesDictionaries) {\n    // Precedence, highest first: the entry's own declarations, then the\n    // `default` variant it inherits from, then the unqualified siblings shared\n    // by the whole key (mergeDictionaries prefers the first occurrence).\n    //\n    // Inheriting from `default` is what makes a variant declaration partial: it\n    // only has to declare the fields whose wording actually differs, and every\n    // other field is completed from the default entry.\n    const inheritedEntryId = getInheritedEntryId(compositeId);\n    const inheritedDictionaries = inheritedEntryId\n      ? (entriesDictionaries.get(inheritedEntryId) ?? [])\n      : [];\n\n    const mergedEntry = mergeDictionaries([\n      ...qualifiedDictionaries,\n      ...inheritedDictionaries,\n      ...baseDictionaries,\n    ]);\n\n    content[compositeId] = mergedEntry.content;\n\n    const [firstQualified] = qualifiedDictionaries;\n\n    importMode ??= firstQualified?.importMode;\n  }\n\n  const localIds = Array.from(\n    new Set(\n      dictionaries\n        .filter((dictionary) => dictionary.localId)\n        .map((dictionary) => dictionary.localId!)\n    )\n  );\n\n  return {\n    key: dictionaries[0]!.key,\n    qualifierTypes: groupQualifierTypes,\n    content,\n    ...(importMode !== undefined && { importMode }),\n    localIds,\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,MAAa,8BACX,iBAC0C;CAC1C,MAAM,qBAAqB,aAAa,IAAIA,6EAA2B;CAEvE,MAAM,qCAAqB,IAAI,IAA6B;CAC5D,KAAK,MAAM,SAAS,oBAClB,KAAK,MAAM,QAAQ,OAAO,mBAAmB,IAAI,IAAI;CAIvD,MAAM,sBAAsBC,kEAAgB,QAAQ,kBAClD,mBAAmB,IAAI,aAAa,CACtC;CAEA,IAAI,oBAAoB,WAAW,GACjC,OAAOC,kEAAkB,YAAY;CAGvC,MAAM,sDAAyB,EAAE,gCAAI,CAAC;CAEtC,MAAM,mBAAiC,CAAC;CACxC,MAAM,sCAAsB,IAAI,IAA0B;CAE1D,aAAa,SAAS,YAAY,UAAU;EAC1C,IAAI,mBAAmB,MAAM,EAAE,WAAW,GAAG;GAC3C,iBAAiB,KAAK,UAAU;GAChC;EACF;EAIA,MAAM,eAAeC,4EACnB,YACA,mBACF;EAEA,IAAI,iBAAiB,QAAW;GAC9B,UACE,uDAA0B,WAAW,GAAG,EAAE,aAAa,mBAAmB,MAAM,CAAC,KAAK,IAAI,EAAE,kCAAkC,oBAAoB,KAAK,IAAI,EAAE,wDAAwD,WAAW,WAAW,MAAM,WAAW,aAAa,GAAG,IAC5Q,EAAE,OAAO,QAAQ,CACnB;GACA;EACF;EAEA,KAAK,MAAM,eAAe,cAAc;GACtC,MAAM,kBAAkB,oBAAoB,IAAI,WAAW,KAAK,CAAC;GACjE,gBAAgB,KAAK,UAAU;GAC/B,oBAAoB,IAAI,aAAa,eAAe;EACtD;CACF,CAAC;CAaD,IAFE,oBAAoB,WAAW,KAAK,oBAAoB,OAAO,aAI/D,iBAAiB,SAAS,KAC1B,CAAC,oBAAoB,aAAsB,GAE3C,oBAAoB,IAAIC,sEAAoB,CAAC,CAAC;CAOhD,MAAM,UAAmC,CAAC;CAE1C,IAAI;CAEJ,MAAM,eAAe,oBAAoB,QAAQ,SAAS;;;;;;CAO1D,MAAM,uBAAuB,gBAA4C;EACvE,IAAI,iBAAiB,IAAI,OAAO;EAEhC,MAAM,WAAW,YAAY,SAA4B;EACzD,IAAI,SAAS,6BAAsC,OAAO;EAE1D,SAAS,gBAAgBA;EACzB,OAAO,SAAS,QAA2B;CAC7C;CAEA,KAAK,MAAM,CAAC,aAAa,0BAA0B,qBAAqB;EAQtE,MAAM,mBAAmB,oBAAoB,WAAW;EACxD,MAAM,wBAAwB,mBACzB,oBAAoB,IAAI,gBAAgB,KAAK,CAAC,IAC/C,CAAC;EAQL,QAAQ,eANYF,kEAAkB;GACpC,GAAG;GACH,GAAG;GACH,GAAG;EACL,CAEiC,CAAC,CAAC;EAEnC,MAAM,CAAC,kBAAkB;EAEzB,eAAe,gBAAgB;CACjC;CAEA,MAAM,WAAW,MAAM,KACrB,IAAI,IACF,aACG,QAAQ,eAAe,WAAW,OAAO,CAAC,CAC1C,KAAK,eAAe,WAAW,OAAQ,CAC5C,CACF;CAEA,OAAO;EACL,KAAK,aAAa,EAAE,CAAE;EACtB,gBAAgB;EAChB;EACA,GAAI,eAAe,UAAa,EAAE,WAAW;EAC7C;CACF;AACF"}

package/dist/cjs/dictionaryManipulator/qualifiedDictionary.cjs

@@ -13,6 +13,12 @@ const QUALIFIER_ORDER = ["variant", "item"];
 */
 const COMPOSITE_ID_SEPARATOR = "/";
 /**
+* Identity of the implicit fallback variant. A selector that pins no variant
+* resolves to it, and a variant that declares no entry of its own falls back to
+* it — so a key only has to ship the entries that actually differ.
+*/
+const DEFAULT_VARIANT_ID = "default";
+/**
 * Characters kept verbatim in an encoded qualifier segment. Everything else is
 * percent-encoded so a segment can never contain the composite-id separator
 * (`/`), path-hostile characters (`\` `:` `*` `?` `"` `<` `>` `|`, control
@@ -51,7 +57,7 @@ const encodeSegmentText = (raw, unsafeChars) => {
 * an object variant in a selector must equal the one declared on the dictionary.
 */
 const serializeVariant = (variant) => {
-	if (variant === void 0) return "default";
+	if (variant === void 0) return DEFAULT_VARIANT_ID;
 	if (typeof variant === "string") return encodeSegmentText(variant, SEGMENT_UNSAFE_CHARS);
 	return Object.keys(variant).sort().map((field) => `${encodeSegmentText(field, COMPONENT_UNSAFE_CHARS)}=${encodeSegmentText(String(variant[field]), COMPONENT_UNSAFE_CHARS)}`).join("&");
 };
@@ -107,16 +113,33 @@ const getDictionaryCompositeIds = (dictionary, qualifierTypes) => {
 	return compositeIds;
 };
 /**
+* Resolves the variant id a selector actually targets among the ids a key
+* declares — the sparse-override fallback.
+*
+* The requested id wins when the key declares it. Otherwise the key falls back
+* to its `default` entry, so a variant only has to be declared where its
+* wording differs. When the key declares no `default` either, the requested id
+* is returned unchanged and the caller resolves to `null` / `[]`.
+*
+* @param requestedVariantId - The serialized variant id the selector asks for.
+* @param isVariantIdDeclared - Whether the key declares an entry for an id.
+*/
+const resolveEffectiveVariantId = (requestedVariantId, isVariantIdDeclared) => {
+	if (isVariantIdDeclared(requestedVariantId)) return requestedVariantId;
+	return isVariantIdDeclared("default") ? DEFAULT_VARIANT_ID : requestedVariantId;
+};
+/**
 * Tests whether a composite entry id matches a selector across every declared
 * dimension. Segments are compared in their encoded form (both the stored id
 * and the selector go through {@link serializeVariant}). The `item` dimension
 * matches any value when the selector does not provide one (open collection
-* axis).
+* axis); the `variant` dimension is compared against the already-resolved
+* effective id, so the fallback is applied consistently across dimensions.
 */
-const compositeIdMatchesSelector = (compositeId, qualifierTypes, selector) => {
+const compositeIdMatchesSelector = (compositeId, qualifierTypes, selector, effectiveVariantId) => {
 	const segments = compositeId.split("/");
 	return qualifierTypes.every((qualifierType, index) => {
-		if (qualifierType === "variant") return segments[index] === serializeVariant(selector?.variant);
+		if (qualifierType === "variant") return segments[index] === effectiveVariantId;
 		return selector?.item === void 0 || segments[index] === String(selector.item);
 	});
 };
@@ -156,8 +179,10 @@ const reconstructQualifiedEntry = (group, compositeId) => {
 * - Plain dictionary → returned as-is (selector ignored)
 * - `item` declared but not selected → every matching entry ordered by index
 * - `item` selected → the matching entry or null
-* - `variant` defaults to the `default` entry when not selected; an object
-*   variant resolves only when the selector provides an equal object
+* - `variant` defaults to the `default` entry when not selected, and falls back
+*   to it when the selected variant declares no entry of its own; an object
+*   variant resolves only when the selector provides an equal object (or, again,
+*   through the `default` fallback)
 *
 * Dimensions compose: e.g. a variant × item key with `{ variant: 'promo' }`
 * returns every promo item as an array; adding `{ item: 2 }` narrows to one.
@@ -166,7 +191,10 @@ const resolveQualifiedDictionary = (dictionaryOrGroup, selector) => {
 	if (!isQualifiedDictionaryGroup(dictionaryOrGroup)) return dictionaryOrGroup;
 	const { qualifierTypes, content } = dictionaryOrGroup;
 	const itemAxisOpen = qualifierTypes.includes("item") && selector?.item === void 0;
-	const matchedEntries = Object.keys(content).filter((compositeId) => compositeIdMatchesSelector(compositeId, qualifierTypes, selector)).map((compositeId) => reconstructQualifiedEntry(dictionaryOrGroup, compositeId));
+	const compositeIds = Object.keys(content);
+	const variantIndex = qualifierTypes.indexOf("variant");
+	const effectiveVariantId = variantIndex === -1 ? DEFAULT_VARIANT_ID : resolveEffectiveVariantId(serializeVariant(selector?.variant), (variantId) => compositeIds.some((compositeId) => compositeId.split("/")[variantIndex] === variantId));
+	const matchedEntries = compositeIds.filter((compositeId) => compositeIdMatchesSelector(compositeId, qualifierTypes, selector, effectiveVariantId)).map((compositeId) => reconstructQualifiedEntry(dictionaryOrGroup, compositeId));
 	if (itemAxisOpen) return matchedEntries.sort((left, right) => (left.item ?? 0) - (right.item ?? 0));
 	return matchedEntries[0] ?? null;
 };
@@ -233,7 +261,7 @@ const collectQualifiedChunks = (loaderMap, key, locale, selector) => {
 			for (const segment of Object.keys(tree).sort((left, right) => Number(left) - Number(right))) walk(tree[segment], rest, [...segments, segment]);
 			return true;
 		}
-		const segment = dimension === "variant" ? serializeVariant(selector?.variant) : String(selector?.item);
+		const segment = dimension === "variant" ? resolveEffectiveVariantId(serializeVariant(selector?.variant), (variantId) => tree[variantId] !== void 0) : String(selector?.item);
 		const child = tree[segment];
 		if (!child) return false;
 		return walk(child, rest, [...segments, segment]);
@@ -249,11 +277,11 @@ const collectQualifiedChunks = (loaderMap, key, locale, selector) => {
 * loading only the chunk(s) the selector actually targets.
 *
 * Walks the nested loader tree one dimension at a time (canonical order
-* `variant → item`): `variant` defaults to `default` (or descends by the
-* serialized object identity), and `item` either narrows to the selected index
-* or — when no item is given — expands into every sibling chunk (the collection
-* axis). Semantics mirror {@link resolveQualifiedDictionary} so dynamic and
-* static modes behave alike.
+* `variant → item`): `variant` descends by the serialized id, falling back to
+* `default` when the selected variant has no chunk of its own, and `item`
+* either narrows to the selected index or — when no item is given — expands
+* into every sibling chunk (the collection axis). Semantics mirror
+* {@link resolveQualifiedDictionary} so dynamic and static modes behave alike.
 *
 * The Suspense mechanism is injected through `loadChunk` so the same logic
 * serves both the client (suspender cache) and the server (`react.use`). Every
@@ -299,6 +327,7 @@ const resolveQualifiedDynamicContentAsync = async (params) => {
 
 //#endregion
 exports.COMPOSITE_ID_SEPARATOR = COMPOSITE_ID_SEPARATOR;
+exports.DEFAULT_VARIANT_ID = DEFAULT_VARIANT_ID;
 exports.QUALIFIER_DYNAMIC_TYPES_KEY = QUALIFIER_DYNAMIC_TYPES_KEY;
 exports.QUALIFIER_ORDER = QUALIFIER_ORDER;
 exports.getDictionaryCompositeIds = getDictionaryCompositeIds;