@uniformdev/tms-sdk 20.50.2-alpha.1 → 20.50.2-alpha.109

package/dist/index.d.mts

@@ -29,13 +29,20 @@ type EntityTranslationResult<TResult = unknown> = {
     errorText?: string;
 };
 type MaybePromise<T> = T | Promise<T> | PromiseLike<T>;
+type CollectTranslationConfig = {
+    /**
+     * By default, if target locale value exists and different from source locale value, it will be skipped for translation.
+     * If `true`, target locale value mismatch will be ignored.
+     */
+    ignoreTargetLocaleValueMismatch?: boolean;
+};
 
 type CollectTranslationPayloadResult = {
     payload?: TranslationPayload;
     errorKind?: 'unknown' | 'invalid-args' | 'entity-source-locale-missing';
     errorText?: string;
 };
-declare const collectTranslationPayload: ({ uniformProjectId, uniformSourceLocale, uniformTargetLocale, uniformReleaseId, targetLang, entity, entityType, }: {
+declare const collectTranslationPayload: ({ uniformProjectId, uniformSourceLocale, uniformTargetLocale, uniformReleaseId, targetLang, entity, entityType, config, }: {
     uniformProjectId: string;
     uniformSourceLocale: string;
     uniformTargetLocale: string;
@@ -43,6 +50,7 @@ declare const collectTranslationPayload: ({ uniformProjectId, uniformSourceLocal
     targetLang: string;
     entity: RootComponentInstance | EntryData;
     entityType: EntityType;
+    config?: CollectTranslationConfig;
 }) => CollectTranslationPayloadResult;
 
 declare const getCompositionForTranslation: ({ canvasClient, compositionId, releaseId, state, }: {
@@ -118,4 +126,4 @@ declare const translateEntry: ({ entry, translationPayload, }: {
     translationPayload: TranslationPayload;
 }) => EntityTranslationResult<Entry>;
 
-export { type CollectTranslationPayloadResult, type ComponentTranslationPayload, type EntityTranslationResult, type EntityType, type MaybePromise, type MergeCompositionTranslationToUniformOptions, type MergeEntryTranslationToUniformOptions, type MergeTranslationToUniformOptions, type TranslationPayload, collectTranslationPayload, getCompositionForTranslation, getEntryForTranslation, mergeCompositionTranslationToUniform, mergeEntryTranslationToUniform, mergeTranslationToUniform, translateComposition, translateEntry };
+export { type CollectTranslationConfig, type CollectTranslationPayloadResult, type ComponentTranslationPayload, type EntityTranslationResult, type EntityType, type MaybePromise, type MergeCompositionTranslationToUniformOptions, type MergeEntryTranslationToUniformOptions, type MergeTranslationToUniformOptions, type TranslationPayload, collectTranslationPayload, getCompositionForTranslation, getEntryForTranslation, mergeCompositionTranslationToUniform, mergeEntryTranslationToUniform, mergeTranslationToUniform, translateComposition, translateEntry };

package/dist/index.d.ts

@@ -29,13 +29,20 @@ type EntityTranslationResult<TResult = unknown> = {
     errorText?: string;
 };
 type MaybePromise<T> = T | Promise<T> | PromiseLike<T>;
+type CollectTranslationConfig = {
+    /**
+     * By default, if target locale value exists and different from source locale value, it will be skipped for translation.
+     * If `true`, target locale value mismatch will be ignored.
+     */
+    ignoreTargetLocaleValueMismatch?: boolean;
+};
 
 type CollectTranslationPayloadResult = {
     payload?: TranslationPayload;
     errorKind?: 'unknown' | 'invalid-args' | 'entity-source-locale-missing';
     errorText?: string;
 };
-declare const collectTranslationPayload: ({ uniformProjectId, uniformSourceLocale, uniformTargetLocale, uniformReleaseId, targetLang, entity, entityType, }: {
+declare const collectTranslationPayload: ({ uniformProjectId, uniformSourceLocale, uniformTargetLocale, uniformReleaseId, targetLang, entity, entityType, config, }: {
     uniformProjectId: string;
     uniformSourceLocale: string;
     uniformTargetLocale: string;
@@ -43,6 +50,7 @@ declare const collectTranslationPayload: ({ uniformProjectId, uniformSourceLocal
     targetLang: string;
     entity: RootComponentInstance | EntryData;
     entityType: EntityType;
+    config?: CollectTranslationConfig;
 }) => CollectTranslationPayloadResult;
 
 declare const getCompositionForTranslation: ({ canvasClient, compositionId, releaseId, state, }: {
@@ -118,4 +126,4 @@ declare const translateEntry: ({ entry, translationPayload, }: {
     translationPayload: TranslationPayload;
 }) => EntityTranslationResult<Entry>;
 
-export { type CollectTranslationPayloadResult, type ComponentTranslationPayload, type EntityTranslationResult, type EntityType, type MaybePromise, type MergeCompositionTranslationToUniformOptions, type MergeEntryTranslationToUniformOptions, type MergeTranslationToUniformOptions, type TranslationPayload, collectTranslationPayload, getCompositionForTranslation, getEntryForTranslation, mergeCompositionTranslationToUniform, mergeEntryTranslationToUniform, mergeTranslationToUniform, translateComposition, translateEntry };
+export { type CollectTranslationConfig, type CollectTranslationPayloadResult, type ComponentTranslationPayload, type EntityTranslationResult, type EntityType, type MaybePromise, type MergeCompositionTranslationToUniformOptions, type MergeEntryTranslationToUniformOptions, type MergeTranslationToUniformOptions, type TranslationPayload, collectTranslationPayload, getCompositionForTranslation, getEntryForTranslation, mergeCompositionTranslationToUniform, mergeEntryTranslationToUniform, mergeTranslationToUniform, translateComposition, translateEntry };

package/dist/index.esm.js

@@ -1,6 +1,7 @@
 // src/collectTranslationPayload.ts
 import {
   bindVariables,
+  CANVAS_BLOCK_PARAM_TYPE as CANVAS_BLOCK_PARAM_TYPE2,
   walkNodeTree as walkNodeTree2
 } from "@uniformdev/canvas";
 import { isRichTextValue as isRichTextValue2, isRichTextValueConsideredEmpty as isRichTextValueConsideredEmpty2 } from "@uniformdev/richtext";
@@ -109,6 +110,7 @@ var getNodeMetaAttributesString = (node) => {
 
 // src/translationHelpers.ts
 import {
+  CANVAS_BLOCK_PARAM_TYPE,
   walkNodeTree
 } from "@uniformdev/canvas";
 import { isRichTextValueConsideredEmpty } from "@uniformdev/richtext";
@@ -287,6 +289,9 @@ var processComponentTranslation = ({
   });
   return { updated };
 };
+var isNestedParameterType = (type) => {
+  return type === CANVAS_BLOCK_PARAM_TYPE;
+};
 var processParameterTranslation = ({
   uniformSourceLocale,
   uniformTargetLocale,
@@ -297,6 +302,14 @@ var processParameterTranslation = ({
   if (originalParameter.type !== parameter.type) {
     return { updated: false };
   }
+  if (isNestedParameterType(originalParameter.type)) {
+    return processNestedParameterTranslation({
+      uniformSourceLocale,
+      uniformTargetLocale,
+      originalParameter,
+      parameter
+    });
+  }
   if (!originalParameter.locales && originalParameter.value === void 0) {
     return { updated: false };
   }
@@ -309,7 +322,7 @@ var processParameterTranslation = ({
     left: originalParameterSource,
     right: sourceValue
   });
-  const isTargetValueUntouched = isSameParameterValue({
+  const isTargetValueUntouched = originalTargetValue === void 0 ? true : isSameParameterValue({
     parameterType: originalParameter.type,
     left: (_d = originalParameter.locales) == null ? void 0 : _d[uniformTargetLocale],
     right: originalTargetValue
@@ -341,6 +354,39 @@ var processParameterTranslation = ({
   }
   return { updated: false };
 };
+var processNestedParameterTranslation = ({
+  uniformSourceLocale,
+  uniformTargetLocale,
+  originalParameter,
+  parameter
+}) => {
+  let updated = false;
+  if (originalParameter.type == CANVAS_BLOCK_PARAM_TYPE && Array.isArray(originalParameter.value) && Array.isArray(parameter.value)) {
+    const originalValue = originalParameter.value;
+    const translatedValue = parameter.value;
+    for (const translatedBlock of translatedValue) {
+      if (!translatedBlock._id || !translatedBlock.type) {
+        continue;
+      }
+      const originalBlock = originalValue.find(
+        (b) => b._id === translatedBlock._id && b.type === translatedBlock.type
+      );
+      if (!originalBlock) {
+        continue;
+      }
+      const { updated: blockUpdated } = processComponentTranslation({
+        uniformSourceLocale,
+        uniformTargetLocale,
+        originalNode: originalBlock,
+        translatedComponent: translatedBlock
+      });
+      if (blockUpdated) {
+        updated = true;
+      }
+    }
+  }
+  return { updated };
+};
 var processOverrideTranslation = ({
   uniformSourceLocale,
   uniformTargetLocale,
@@ -453,7 +499,8 @@ var collectTranslationPayload = ({
   uniformReleaseId,
   targetLang,
   entity,
-  entityType
+  entityType,
+  config = {}
 }) => {
   if (!uniformSourceLocale || !uniformTargetLocale || !targetLang || !entity) {
     return createErrorResult2("invalid-args");
@@ -477,16 +524,22 @@ var collectTranslationPayload = ({
     },
     components: {}
   };
-  walkNodeTree2(entity, ({ node, actions }) => {
+  walkNodeTree2(entity, ({ node, actions, ancestorsAndSelf }) => {
+    var _a;
     if (!node.type || !node._id) {
       actions.stopProcessingDescendants();
       return;
     }
+    if (((_a = ancestorsAndSelf.at(0)) == null ? void 0 : _a.type) === "block") {
+      actions.stopProcessingDescendants();
+      return;
+    }
     const { _id, type, parameters, _overrides } = collectFromNode({
       uniformSourceLocale,
       uniformTargetLocale,
       node,
-      deep: false
+      deep: false,
+      config
     });
     if (parameters || _overrides) {
       payload.components[node._id] = {
@@ -503,7 +556,8 @@ var collectFromNode = ({
   uniformSourceLocale,
   uniformTargetLocale,
   node,
-  deep
+  deep,
+  config
 }) => {
   var _a, _b, _c;
   const collectedParameters = {};
@@ -513,12 +567,24 @@ var collectFromNode = ({
   const entryFields = "fields" in node ? node.fields : void 0;
   Object.entries((_a = componentParameters != null ? componentParameters : entryFields) != null ? _a : {}).forEach(([paramKey, param]) => {
     var _a2, _b2;
+    if (isNestedParameterType(param.type)) {
+      const nestedParam = collectNestedParameter({
+        param,
+        uniformSourceLocale,
+        uniformTargetLocale,
+        config
+      });
+      if (nestedParam) {
+        collectedParameters[paramKey] = nestedParam;
+      }
+      return;
+    }
     const sourceLocaleValue = (_a2 = param.locales) == null ? void 0 : _a2[uniformSourceLocale];
     const targetLocaleValue = (_b2 = param.locales) == null ? void 0 : _b2[uniformTargetLocale];
     if (!canTranslateParameterValue(param, sourceLocaleValue)) {
       return;
     }
-    if (!isTargetLocaleUntouched(param.type, sourceLocaleValue, targetLocaleValue)) {
+    if (!config.ignoreTargetLocaleValueMismatch && !isTargetLocaleUntouched(param.type, sourceLocaleValue, targetLocaleValue)) {
       return;
     }
     collectedParameters[paramKey] = {
@@ -526,7 +592,7 @@ var collectFromNode = ({
       locales: {
         [TRANSLATION_PAYLOAD_SOURCE_KEY]: sourceLocaleValue,
         [TRANSLATION_PAYLOAD_TARGET_KEY]: preprocessTargetValue(param, sourceLocaleValue),
-        [TRANSLATION_PAYLOAD_ORIGINAL_TARGET_KEY]: targetLocaleValue
+        [TRANSLATION_PAYLOAD_ORIGINAL_TARGET_KEY]: !config.ignoreTargetLocaleValueMismatch ? targetLocaleValue : void 0
       }
     };
   });
@@ -541,7 +607,8 @@ var collectFromNode = ({
           uniformSourceLocale,
           uniformTargetLocale,
           node: slotComponent,
-          deep: true
+          deep: true,
+          config
         });
         const hasContent = collectedNode.parameters || collectedNode._overrides || collectedNode.slots;
         if (hasContent) {
@@ -554,23 +621,37 @@ var collectFromNode = ({
   Object.entries((_c = node._overrides) != null ? _c : {}).forEach(([overrideKey, override]) => {
     var _a2, _b2;
     Object.entries((_a2 = override.parameters) != null ? _a2 : {}).forEach(([paramKey, param]) => {
-      var _a3, _b3, _c2, _d, _e;
-      const sourceLocaleValue = (_a3 = param.locales) == null ? void 0 : _a3[uniformSourceLocale];
-      const targetLocaleValue = (_b3 = param.locales) == null ? void 0 : _b3[uniformTargetLocale];
+      var _a3, _b3, _c2, _d, _e, _f, _g, _h;
+      if (isNestedParameterType(param.type)) {
+        const nestedParam = collectNestedParameter({
+          param,
+          uniformSourceLocale,
+          uniformTargetLocale,
+          config
+        });
+        if (nestedParam) {
+          (_a3 = collectedOverrides[overrideKey]) != null ? _a3 : collectedOverrides[overrideKey] = {};
+          (_c2 = (_b3 = collectedOverrides[overrideKey]).parameters) != null ? _c2 : _b3.parameters = {};
+          collectedOverrides[overrideKey].parameters[paramKey] = nestedParam;
+        }
+        return;
+      }
+      const sourceLocaleValue = (_d = param.locales) == null ? void 0 : _d[uniformSourceLocale];
+      const targetLocaleValue = (_e = param.locales) == null ? void 0 : _e[uniformTargetLocale];
       if (!canTranslateParameterValue(param, sourceLocaleValue)) {
         return;
       }
-      if (!isTargetLocaleUntouched(param.type, sourceLocaleValue, targetLocaleValue)) {
+      if (!config.ignoreTargetLocaleValueMismatch && !isTargetLocaleUntouched(param.type, sourceLocaleValue, targetLocaleValue)) {
         return;
       }
-      (_c2 = collectedOverrides[overrideKey]) != null ? _c2 : collectedOverrides[overrideKey] = {};
-      (_e = (_d = collectedOverrides[overrideKey]).parameters) != null ? _e : _d.parameters = {};
+      (_f = collectedOverrides[overrideKey]) != null ? _f : collectedOverrides[overrideKey] = {};
+      (_h = (_g = collectedOverrides[overrideKey]).parameters) != null ? _h : _g.parameters = {};
       collectedOverrides[overrideKey].parameters[paramKey] = {
         type: param.type,
         locales: {
           [TRANSLATION_PAYLOAD_SOURCE_KEY]: sourceLocaleValue,
           [TRANSLATION_PAYLOAD_TARGET_KEY]: preprocessTargetValue(param, sourceLocaleValue),
-          [TRANSLATION_PAYLOAD_ORIGINAL_TARGET_KEY]: targetLocaleValue
+          [TRANSLATION_PAYLOAD_ORIGINAL_TARGET_KEY]: !config.ignoreTargetLocaleValueMismatch ? targetLocaleValue : void 0
         }
       };
     });
@@ -586,7 +667,8 @@ var collectFromNode = ({
           node: slotComponent,
           // keep tree structure for `Slot Sections`
           // to store whole `override` content in scope of current component
-          deep: true
+          deep: true,
+          config
         });
         const hasContent = collectedNode.parameters || collectedNode._overrides || collectedNode.slots;
         if (hasContent) {
@@ -609,6 +691,42 @@ var collectFromNode = ({
     _overrides: hasOverrides ? collectedOverrides : void 0
   };
 };
+var collectNestedParameter = ({
+  param,
+  uniformSourceLocale,
+  uniformTargetLocale,
+  config
+}) => {
+  if (param.type === CANVAS_BLOCK_PARAM_TYPE2 && Array.isArray(param.value)) {
+    const blockValue = param.value;
+    const collectedBlocks = [];
+    for (const blockEntry of blockValue) {
+      if (!blockEntry._id || !blockEntry.type) {
+        continue;
+      }
+      const collectedNode = collectFromNode({
+        uniformSourceLocale,
+        uniformTargetLocale,
+        node: blockEntry,
+        deep: false,
+        config
+      });
+      const hasContent = collectedNode.parameters || collectedNode._overrides;
+      if (hasContent) {
+        collectedNode.slots = void 0;
+        collectedBlocks.push(collectedNode);
+      }
+    }
+    if (collectedBlocks.length === 0) {
+      return void 0;
+    }
+    return {
+      type: CANVAS_BLOCK_PARAM_TYPE2,
+      value: collectedBlocks
+    };
+  }
+  return void 0;
+};
 var canTranslateParameterValue = (parameter, value) => {
   if (parameter.type === SUPPORTED_PARAM_TYPES.text) {
     if (typeof value !== "string" || !value) {

package/dist/index.js

@@ -315,6 +315,9 @@ var processComponentTranslation = ({
   });
   return { updated };
 };
+var isNestedParameterType = (type) => {
+  return type === import_canvas.CANVAS_BLOCK_PARAM_TYPE;
+};
 var processParameterTranslation = ({
   uniformSourceLocale,
   uniformTargetLocale,
@@ -325,6 +328,14 @@ var processParameterTranslation = ({
   if (originalParameter.type !== parameter.type) {
     return { updated: false };
   }
+  if (isNestedParameterType(originalParameter.type)) {
+    return processNestedParameterTranslation({
+      uniformSourceLocale,
+      uniformTargetLocale,
+      originalParameter,
+      parameter
+    });
+  }
   if (!originalParameter.locales && originalParameter.value === void 0) {
     return { updated: false };
   }
@@ -337,7 +348,7 @@ var processParameterTranslation = ({
     left: originalParameterSource,
     right: sourceValue
   });
-  const isTargetValueUntouched = isSameParameterValue({
+  const isTargetValueUntouched = originalTargetValue === void 0 ? true : isSameParameterValue({
     parameterType: originalParameter.type,
     left: (_d = originalParameter.locales) == null ? void 0 : _d[uniformTargetLocale],
     right: originalTargetValue
@@ -369,6 +380,39 @@ var processParameterTranslation = ({
   }
   return { updated: false };
 };
+var processNestedParameterTranslation = ({
+  uniformSourceLocale,
+  uniformTargetLocale,
+  originalParameter,
+  parameter
+}) => {
+  let updated = false;
+  if (originalParameter.type == import_canvas.CANVAS_BLOCK_PARAM_TYPE && Array.isArray(originalParameter.value) && Array.isArray(parameter.value)) {
+    const originalValue = originalParameter.value;
+    const translatedValue = parameter.value;
+    for (const translatedBlock of translatedValue) {
+      if (!translatedBlock._id || !translatedBlock.type) {
+        continue;
+      }
+      const originalBlock = originalValue.find(
+        (b) => b._id === translatedBlock._id && b.type === translatedBlock.type
+      );
+      if (!originalBlock) {
+        continue;
+      }
+      const { updated: blockUpdated } = processComponentTranslation({
+        uniformSourceLocale,
+        uniformTargetLocale,
+        originalNode: originalBlock,
+        translatedComponent: translatedBlock
+      });
+      if (blockUpdated) {
+        updated = true;
+      }
+    }
+  }
+  return { updated };
+};
 var processOverrideTranslation = ({
   uniformSourceLocale,
   uniformTargetLocale,
@@ -481,7 +525,8 @@ var collectTranslationPayload = ({
   uniformReleaseId,
   targetLang,
   entity,
-  entityType
+  entityType,
+  config = {}
 }) => {
   if (!uniformSourceLocale || !uniformTargetLocale || !targetLang || !entity) {
     return createErrorResult2("invalid-args");
@@ -505,16 +550,22 @@ var collectTranslationPayload = ({
     },
     components: {}
   };
-  (0, import_canvas2.walkNodeTree)(entity, ({ node, actions }) => {
+  (0, import_canvas2.walkNodeTree)(entity, ({ node, actions, ancestorsAndSelf }) => {
+    var _a;
     if (!node.type || !node._id) {
       actions.stopProcessingDescendants();
       return;
     }
+    if (((_a = ancestorsAndSelf.at(0)) == null ? void 0 : _a.type) === "block") {
+      actions.stopProcessingDescendants();
+      return;
+    }
     const { _id, type, parameters, _overrides } = collectFromNode({
       uniformSourceLocale,
       uniformTargetLocale,
       node,
-      deep: false
+      deep: false,
+      config
     });
     if (parameters || _overrides) {
       payload.components[node._id] = {
@@ -531,7 +582,8 @@ var collectFromNode = ({
   uniformSourceLocale,
   uniformTargetLocale,
   node,
-  deep
+  deep,
+  config
 }) => {
   var _a, _b, _c;
   const collectedParameters = {};
@@ -541,12 +593,24 @@ var collectFromNode = ({
   const entryFields = "fields" in node ? node.fields : void 0;
   Object.entries((_a = componentParameters != null ? componentParameters : entryFields) != null ? _a : {}).forEach(([paramKey, param]) => {
     var _a2, _b2;
+    if (isNestedParameterType(param.type)) {
+      const nestedParam = collectNestedParameter({
+        param,
+        uniformSourceLocale,
+        uniformTargetLocale,
+        config
+      });
+      if (nestedParam) {
+        collectedParameters[paramKey] = nestedParam;
+      }
+      return;
+    }
     const sourceLocaleValue = (_a2 = param.locales) == null ? void 0 : _a2[uniformSourceLocale];
     const targetLocaleValue = (_b2 = param.locales) == null ? void 0 : _b2[uniformTargetLocale];
     if (!canTranslateParameterValue(param, sourceLocaleValue)) {
       return;
     }
-    if (!isTargetLocaleUntouched(param.type, sourceLocaleValue, targetLocaleValue)) {
+    if (!config.ignoreTargetLocaleValueMismatch && !isTargetLocaleUntouched(param.type, sourceLocaleValue, targetLocaleValue)) {
       return;
     }
     collectedParameters[paramKey] = {
@@ -554,7 +618,7 @@ var collectFromNode = ({
       locales: {
         [TRANSLATION_PAYLOAD_SOURCE_KEY]: sourceLocaleValue,
         [TRANSLATION_PAYLOAD_TARGET_KEY]: preprocessTargetValue(param, sourceLocaleValue),
-        [TRANSLATION_PAYLOAD_ORIGINAL_TARGET_KEY]: targetLocaleValue
+        [TRANSLATION_PAYLOAD_ORIGINAL_TARGET_KEY]: !config.ignoreTargetLocaleValueMismatch ? targetLocaleValue : void 0
       }
     };
   });
@@ -569,7 +633,8 @@ var collectFromNode = ({
           uniformSourceLocale,
           uniformTargetLocale,
           node: slotComponent,
-          deep: true
+          deep: true,
+          config
         });
         const hasContent = collectedNode.parameters || collectedNode._overrides || collectedNode.slots;
         if (hasContent) {
@@ -582,23 +647,37 @@ var collectFromNode = ({
   Object.entries((_c = node._overrides) != null ? _c : {}).forEach(([overrideKey, override]) => {
     var _a2, _b2;
     Object.entries((_a2 = override.parameters) != null ? _a2 : {}).forEach(([paramKey, param]) => {
-      var _a3, _b3, _c2, _d, _e;
-      const sourceLocaleValue = (_a3 = param.locales) == null ? void 0 : _a3[uniformSourceLocale];
-      const targetLocaleValue = (_b3 = param.locales) == null ? void 0 : _b3[uniformTargetLocale];
+      var _a3, _b3, _c2, _d, _e, _f, _g, _h;
+      if (isNestedParameterType(param.type)) {
+        const nestedParam = collectNestedParameter({
+          param,
+          uniformSourceLocale,
+          uniformTargetLocale,
+          config
+        });
+        if (nestedParam) {
+          (_a3 = collectedOverrides[overrideKey]) != null ? _a3 : collectedOverrides[overrideKey] = {};
+          (_c2 = (_b3 = collectedOverrides[overrideKey]).parameters) != null ? _c2 : _b3.parameters = {};
+          collectedOverrides[overrideKey].parameters[paramKey] = nestedParam;
+        }
+        return;
+      }
+      const sourceLocaleValue = (_d = param.locales) == null ? void 0 : _d[uniformSourceLocale];
+      const targetLocaleValue = (_e = param.locales) == null ? void 0 : _e[uniformTargetLocale];
       if (!canTranslateParameterValue(param, sourceLocaleValue)) {
         return;
       }
-      if (!isTargetLocaleUntouched(param.type, sourceLocaleValue, targetLocaleValue)) {
+      if (!config.ignoreTargetLocaleValueMismatch && !isTargetLocaleUntouched(param.type, sourceLocaleValue, targetLocaleValue)) {
         return;
       }
-      (_c2 = collectedOverrides[overrideKey]) != null ? _c2 : collectedOverrides[overrideKey] = {};
-      (_e = (_d = collectedOverrides[overrideKey]).parameters) != null ? _e : _d.parameters = {};
+      (_f = collectedOverrides[overrideKey]) != null ? _f : collectedOverrides[overrideKey] = {};
+      (_h = (_g = collectedOverrides[overrideKey]).parameters) != null ? _h : _g.parameters = {};
       collectedOverrides[overrideKey].parameters[paramKey] = {
         type: param.type,
         locales: {
           [TRANSLATION_PAYLOAD_SOURCE_KEY]: sourceLocaleValue,
           [TRANSLATION_PAYLOAD_TARGET_KEY]: preprocessTargetValue(param, sourceLocaleValue),
-          [TRANSLATION_PAYLOAD_ORIGINAL_TARGET_KEY]: targetLocaleValue
+          [TRANSLATION_PAYLOAD_ORIGINAL_TARGET_KEY]: !config.ignoreTargetLocaleValueMismatch ? targetLocaleValue : void 0
         }
       };
     });
@@ -614,7 +693,8 @@ var collectFromNode = ({
           node: slotComponent,
           // keep tree structure for `Slot Sections`
           // to store whole `override` content in scope of current component
-          deep: true
+          deep: true,
+          config
         });
         const hasContent = collectedNode.parameters || collectedNode._overrides || collectedNode.slots;
         if (hasContent) {
@@ -637,6 +717,42 @@ var collectFromNode = ({
     _overrides: hasOverrides ? collectedOverrides : void 0
   };
 };
+var collectNestedParameter = ({
+  param,
+  uniformSourceLocale,
+  uniformTargetLocale,
+  config
+}) => {
+  if (param.type === import_canvas2.CANVAS_BLOCK_PARAM_TYPE && Array.isArray(param.value)) {
+    const blockValue = param.value;
+    const collectedBlocks = [];
+    for (const blockEntry of blockValue) {
+      if (!blockEntry._id || !blockEntry.type) {
+        continue;
+      }
+      const collectedNode = collectFromNode({
+        uniformSourceLocale,
+        uniformTargetLocale,
+        node: blockEntry,
+        deep: false,
+        config
+      });
+      const hasContent = collectedNode.parameters || collectedNode._overrides;
+      if (hasContent) {
+        collectedNode.slots = void 0;
+        collectedBlocks.push(collectedNode);
+      }
+    }
+    if (collectedBlocks.length === 0) {
+      return void 0;
+    }
+    return {
+      type: import_canvas2.CANVAS_BLOCK_PARAM_TYPE,
+      value: collectedBlocks
+    };
+  }
+  return void 0;
+};
 var canTranslateParameterValue = (parameter, value) => {
   if (parameter.type === SUPPORTED_PARAM_TYPES.text) {
     if (typeof value !== "string" || !value) {

package/dist/index.mjs

@@ -1,6 +1,7 @@
 // src/collectTranslationPayload.ts
 import {
   bindVariables,
+  CANVAS_BLOCK_PARAM_TYPE as CANVAS_BLOCK_PARAM_TYPE2,
   walkNodeTree as walkNodeTree2
 } from "@uniformdev/canvas";
 import { isRichTextValue as isRichTextValue2, isRichTextValueConsideredEmpty as isRichTextValueConsideredEmpty2 } from "@uniformdev/richtext";
@@ -109,6 +110,7 @@ var getNodeMetaAttributesString = (node) => {
 
 // src/translationHelpers.ts
 import {
+  CANVAS_BLOCK_PARAM_TYPE,
   walkNodeTree
 } from "@uniformdev/canvas";
 import { isRichTextValueConsideredEmpty } from "@uniformdev/richtext";
@@ -287,6 +289,9 @@ var processComponentTranslation = ({
   });
   return { updated };
 };
+var isNestedParameterType = (type) => {
+  return type === CANVAS_BLOCK_PARAM_TYPE;
+};
 var processParameterTranslation = ({
   uniformSourceLocale,
   uniformTargetLocale,
@@ -297,6 +302,14 @@ var processParameterTranslation = ({
   if (originalParameter.type !== parameter.type) {
     return { updated: false };
   }
+  if (isNestedParameterType(originalParameter.type)) {
+    return processNestedParameterTranslation({
+      uniformSourceLocale,
+      uniformTargetLocale,
+      originalParameter,
+      parameter
+    });
+  }
   if (!originalParameter.locales && originalParameter.value === void 0) {
     return { updated: false };
   }
@@ -309,7 +322,7 @@ var processParameterTranslation = ({
     left: originalParameterSource,
     right: sourceValue
   });
-  const isTargetValueUntouched = isSameParameterValue({
+  const isTargetValueUntouched = originalTargetValue === void 0 ? true : isSameParameterValue({
     parameterType: originalParameter.type,
     left: (_d = originalParameter.locales) == null ? void 0 : _d[uniformTargetLocale],
     right: originalTargetValue
@@ -341,6 +354,39 @@ var processParameterTranslation = ({
   }
   return { updated: false };
 };
+var processNestedParameterTranslation = ({
+  uniformSourceLocale,
+  uniformTargetLocale,
+  originalParameter,
+  parameter
+}) => {
+  let updated = false;
+  if (originalParameter.type == CANVAS_BLOCK_PARAM_TYPE && Array.isArray(originalParameter.value) && Array.isArray(parameter.value)) {
+    const originalValue = originalParameter.value;
+    const translatedValue = parameter.value;
+    for (const translatedBlock of translatedValue) {
+      if (!translatedBlock._id || !translatedBlock.type) {
+        continue;
+      }
+      const originalBlock = originalValue.find(
+        (b) => b._id === translatedBlock._id && b.type === translatedBlock.type
+      );
+      if (!originalBlock) {
+        continue;
+      }
+      const { updated: blockUpdated } = processComponentTranslation({
+        uniformSourceLocale,
+        uniformTargetLocale,
+        originalNode: originalBlock,
+        translatedComponent: translatedBlock
+      });
+      if (blockUpdated) {
+        updated = true;
+      }
+    }
+  }
+  return { updated };
+};
 var processOverrideTranslation = ({
   uniformSourceLocale,
   uniformTargetLocale,
@@ -453,7 +499,8 @@ var collectTranslationPayload = ({
   uniformReleaseId,
   targetLang,
   entity,
-  entityType
+  entityType,
+  config = {}
 }) => {
   if (!uniformSourceLocale || !uniformTargetLocale || !targetLang || !entity) {
     return createErrorResult2("invalid-args");
@@ -477,16 +524,22 @@ var collectTranslationPayload = ({
     },
     components: {}
   };
-  walkNodeTree2(entity, ({ node, actions }) => {
+  walkNodeTree2(entity, ({ node, actions, ancestorsAndSelf }) => {
+    var _a;
     if (!node.type || !node._id) {
       actions.stopProcessingDescendants();
       return;
     }
+    if (((_a = ancestorsAndSelf.at(0)) == null ? void 0 : _a.type) === "block") {
+      actions.stopProcessingDescendants();
+      return;
+    }
     const { _id, type, parameters, _overrides } = collectFromNode({
       uniformSourceLocale,
       uniformTargetLocale,
       node,
-      deep: false
+      deep: false,
+      config
     });
     if (parameters || _overrides) {
       payload.components[node._id] = {
@@ -503,7 +556,8 @@ var collectFromNode = ({
   uniformSourceLocale,
   uniformTargetLocale,
   node,
-  deep
+  deep,
+  config
 }) => {
   var _a, _b, _c;
   const collectedParameters = {};
@@ -513,12 +567,24 @@ var collectFromNode = ({
   const entryFields = "fields" in node ? node.fields : void 0;
   Object.entries((_a = componentParameters != null ? componentParameters : entryFields) != null ? _a : {}).forEach(([paramKey, param]) => {
     var _a2, _b2;
+    if (isNestedParameterType(param.type)) {
+      const nestedParam = collectNestedParameter({
+        param,
+        uniformSourceLocale,
+        uniformTargetLocale,
+        config
+      });
+      if (nestedParam) {
+        collectedParameters[paramKey] = nestedParam;
+      }
+      return;
+    }
     const sourceLocaleValue = (_a2 = param.locales) == null ? void 0 : _a2[uniformSourceLocale];
     const targetLocaleValue = (_b2 = param.locales) == null ? void 0 : _b2[uniformTargetLocale];
     if (!canTranslateParameterValue(param, sourceLocaleValue)) {
       return;
     }
-    if (!isTargetLocaleUntouched(param.type, sourceLocaleValue, targetLocaleValue)) {
+    if (!config.ignoreTargetLocaleValueMismatch && !isTargetLocaleUntouched(param.type, sourceLocaleValue, targetLocaleValue)) {
       return;
     }
     collectedParameters[paramKey] = {
@@ -526,7 +592,7 @@ var collectFromNode = ({
       locales: {
         [TRANSLATION_PAYLOAD_SOURCE_KEY]: sourceLocaleValue,
         [TRANSLATION_PAYLOAD_TARGET_KEY]: preprocessTargetValue(param, sourceLocaleValue),
-        [TRANSLATION_PAYLOAD_ORIGINAL_TARGET_KEY]: targetLocaleValue
+        [TRANSLATION_PAYLOAD_ORIGINAL_TARGET_KEY]: !config.ignoreTargetLocaleValueMismatch ? targetLocaleValue : void 0
       }
     };
   });
@@ -541,7 +607,8 @@ var collectFromNode = ({
           uniformSourceLocale,
           uniformTargetLocale,
           node: slotComponent,
-          deep: true
+          deep: true,
+          config
         });
         const hasContent = collectedNode.parameters || collectedNode._overrides || collectedNode.slots;
         if (hasContent) {
@@ -554,23 +621,37 @@ var collectFromNode = ({
   Object.entries((_c = node._overrides) != null ? _c : {}).forEach(([overrideKey, override]) => {
     var _a2, _b2;
     Object.entries((_a2 = override.parameters) != null ? _a2 : {}).forEach(([paramKey, param]) => {
-      var _a3, _b3, _c2, _d, _e;
-      const sourceLocaleValue = (_a3 = param.locales) == null ? void 0 : _a3[uniformSourceLocale];
-      const targetLocaleValue = (_b3 = param.locales) == null ? void 0 : _b3[uniformTargetLocale];
+      var _a3, _b3, _c2, _d, _e, _f, _g, _h;
+      if (isNestedParameterType(param.type)) {
+        const nestedParam = collectNestedParameter({
+          param,
+          uniformSourceLocale,
+          uniformTargetLocale,
+          config
+        });
+        if (nestedParam) {
+          (_a3 = collectedOverrides[overrideKey]) != null ? _a3 : collectedOverrides[overrideKey] = {};
+          (_c2 = (_b3 = collectedOverrides[overrideKey]).parameters) != null ? _c2 : _b3.parameters = {};
+          collectedOverrides[overrideKey].parameters[paramKey] = nestedParam;
+        }
+        return;
+      }
+      const sourceLocaleValue = (_d = param.locales) == null ? void 0 : _d[uniformSourceLocale];
+      const targetLocaleValue = (_e = param.locales) == null ? void 0 : _e[uniformTargetLocale];
       if (!canTranslateParameterValue(param, sourceLocaleValue)) {
         return;
       }
-      if (!isTargetLocaleUntouched(param.type, sourceLocaleValue, targetLocaleValue)) {
+      if (!config.ignoreTargetLocaleValueMismatch && !isTargetLocaleUntouched(param.type, sourceLocaleValue, targetLocaleValue)) {
         return;
       }
-      (_c2 = collectedOverrides[overrideKey]) != null ? _c2 : collectedOverrides[overrideKey] = {};
-      (_e = (_d = collectedOverrides[overrideKey]).parameters) != null ? _e : _d.parameters = {};
+      (_f = collectedOverrides[overrideKey]) != null ? _f : collectedOverrides[overrideKey] = {};
+      (_h = (_g = collectedOverrides[overrideKey]).parameters) != null ? _h : _g.parameters = {};
       collectedOverrides[overrideKey].parameters[paramKey] = {
         type: param.type,
         locales: {
           [TRANSLATION_PAYLOAD_SOURCE_KEY]: sourceLocaleValue,
           [TRANSLATION_PAYLOAD_TARGET_KEY]: preprocessTargetValue(param, sourceLocaleValue),
-          [TRANSLATION_PAYLOAD_ORIGINAL_TARGET_KEY]: targetLocaleValue
+          [TRANSLATION_PAYLOAD_ORIGINAL_TARGET_KEY]: !config.ignoreTargetLocaleValueMismatch ? targetLocaleValue : void 0
         }
       };
     });
@@ -586,7 +667,8 @@ var collectFromNode = ({
           node: slotComponent,
           // keep tree structure for `Slot Sections`
           // to store whole `override` content in scope of current component
-          deep: true
+          deep: true,
+          config
         });
         const hasContent = collectedNode.parameters || collectedNode._overrides || collectedNode.slots;
         if (hasContent) {
@@ -609,6 +691,42 @@ var collectFromNode = ({
     _overrides: hasOverrides ? collectedOverrides : void 0
   };
 };
+var collectNestedParameter = ({
+  param,
+  uniformSourceLocale,
+  uniformTargetLocale,
+  config
+}) => {
+  if (param.type === CANVAS_BLOCK_PARAM_TYPE2 && Array.isArray(param.value)) {
+    const blockValue = param.value;
+    const collectedBlocks = [];
+    for (const blockEntry of blockValue) {
+      if (!blockEntry._id || !blockEntry.type) {
+        continue;
+      }
+      const collectedNode = collectFromNode({
+        uniformSourceLocale,
+        uniformTargetLocale,
+        node: blockEntry,
+        deep: false,
+        config
+      });
+      const hasContent = collectedNode.parameters || collectedNode._overrides;
+      if (hasContent) {
+        collectedNode.slots = void 0;
+        collectedBlocks.push(collectedNode);
+      }
+    }
+    if (collectedBlocks.length === 0) {
+      return void 0;
+    }
+    return {
+      type: CANVAS_BLOCK_PARAM_TYPE2,
+      value: collectedBlocks
+    };
+  }
+  return void 0;
+};
 var canTranslateParameterValue = (parameter, value) => {
   if (parameter.type === SUPPORTED_PARAM_TYPES.text) {
     if (typeof value !== "string" || !value) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniformdev/tms-sdk",
-  "version": "20.50.2-alpha.1+8798ffc32d",
+  "version": "20.50.2-alpha.109+846837c66a",
   "description": "Uniform Translation Management System SDK",
   "license": "SEE LICENSE IN LICENSE.txt",
   "main": "./dist/index.js",
@@ -22,9 +22,8 @@
     "dev:ts": "tsup --watch",
     "clean": "rimraf dist",
     "test": "vitest run",
-    "lint": "eslint \"src/**/*.{js,ts,tsx}\"",
     "format": "prettier --write \"src/**/*.{js,ts,tsx}\"",
-    "document:prebuild": "api-extractor run --local"
+    "apidocs-extract": "api-extractor run --local"
   },
   "files": [
     "/dist"
@@ -33,12 +32,12 @@
     "access": "public"
   },
   "dependencies": {
-    "@uniformdev/canvas": "20.50.2-alpha.1+8798ffc32d",
-    "@uniformdev/mesh-sdk": "20.50.2-alpha.1+8798ffc32d",
-    "@uniformdev/richtext": "20.50.2-alpha.1+8798ffc32d",
+    "@uniformdev/canvas": "20.50.2-alpha.109+846837c66a",
+    "@uniformdev/mesh-sdk": "20.50.2-alpha.109+846837c66a",
+    "@uniformdev/richtext": "20.50.2-alpha.109+846837c66a",
     "dequal": "2.0.3",
-    "fast-xml-parser": "4.4.1",
+    "fast-xml-parser": "4.5.5",
     "immer": "10.1.3"
   },
-  "gitHead": "8798ffc32d405a5d357628861a40cd964e3ea6f0"
+  "gitHead": "846837c66ad0f518683c100615b59b27f91498ba"
 }