@braze/sanity-plugin-ai-translation 0.2.67 → 0.2.69

package/dist/index.js

@@ -1,6 +1,6 @@
 import { getPublishedId, pathToString, useClient, defineType, defineField, definePlugin } from "sanity";
 import { jsx, jsxs, Fragment } from "react/jsx-runtime";
-import { WarningOutlineIcon, SearchIcon, CheckmarkIcon, ErrorOutlineIcon, CircleIcon, ArrowRightIcon, ResetIcon, PanelRightIcon, TranslateIcon } from "@sanity/icons";
+import { WarningOutlineIcon, SyncIcon, SearchIcon, CheckmarkIcon, ErrorOutlineIcon, CircleIcon, ArrowRightIcon, ResetIcon, PanelRightIcon, TranslateIcon } from "@sanity/icons";
 import { createContext, useReducer, useRef, useEffect, useContext, useMemo, useState, useCallback } from "react";
 import defaults from "lodash.defaults";
 import { Card, Stack, Flex, Text, Box, Heading, Button, Spinner, Inline, Checkbox, Grid, Radio, TextInput, Badge, Select, Label, Code, Tooltip } from "@sanity/ui";
@@ -122,6 +122,8 @@ const isLoggingEnabled = () => process.env.NEXT_PUBLIC_SANITY_STUDIO_AI_TRANSLAT
     mode: "new",
     newReleaseTitle: ""
   },
+  reconcilingStatus: "idle",
+  reconciliationProgress: void 0,
   dispatch: () => {
   }
 }), translationReducer = (context, action) => {
@@ -207,8 +209,24 @@ const isLoggingEnabled = () => process.env.NEXT_PUBLIC_SANITY_STUDIO_AI_TRANSLAT
         releaseConfig: {
           ...context.releaseConfig,
           conflicts: void 0,
-          replaceExisting: void 0
-        }
+          replaceExisting: void 0,
+          skipConflicts: void 0
+        },
+        // Reset reconciliation state
+        reconcilingStatus: "idle",
+        reconciliationProgress: void 0
+      };
+    case "SET_RECONCILING_STATUS":
+      return {
+        ...context,
+        reconcilingStatus: action.payload,
+        // Clear progress when returning to idle or on error
+        reconciliationProgress: action.payload === "idle" || action.payload === "error" ? void 0 : context.reconciliationProgress
+      };
+    case "SET_RECONCILIATION_PROGRESS":
+      return {
+        ...context,
+        reconciliationProgress: action.payload
       };
     default:
       return context;
@@ -238,7 +256,10 @@ const isLoggingEnabled = () => process.env.NEXT_PUBLIC_SANITY_STUDIO_AI_TRANSLAT
     releaseConfig: {
       mode: "new",
       newReleaseTitle: defaultReleaseTitle
-    }
+    },
+    // Reconciliation state for existing releases
+    reconcilingStatus: "idle",
+    reconciliationProgress: void 0
   };
   activeTranslation && devLog.info("Reconnecting to active translation", {
     documentId: document._id,
@@ -505,7 +526,7 @@ const DEFAULT_RETRY_OPTIONS = {
   logRetries: !0
 };
 function calculateDelay(attempt, options) {
-  const delay = options.initialDelayMs * Math.pow(options.backoffMultiplier, attempt);
+  const delay = options.initialDelayMs * options.backoffMultiplier ** attempt;
   return Math.min(delay, options.maxDelayMs);
 }
 function sleep(ms) {
@@ -924,6 +945,85 @@ const fetchTranslationPrompts = async ({
     translatedCount: translationMap.size,
     component: "updateReferences"
   }));
+}, updateBackwardReferences = async ({
+  client,
+  releaseId,
+  sourceDocumentIds,
+  targetLanguages,
+  sourceLanguage,
+  languageFieldName,
+  excludeDocumentIds
+}) => {
+  if (!sourceDocumentIds.length || !targetLanguages.length)
+    return;
+  const normalizedSourceIds = sourceDocumentIds.map((id) => getPublishedId(id));
+  devLog.debug("Starting backward reference update", {
+    releaseId,
+    sourceDocumentCount: normalizedSourceIds.length,
+    targetLanguages,
+    excludeCount: excludeDocumentIds.length,
+    component: "updateBackwardReferences"
+  });
+  try {
+    for (const targetLanguage of targetLanguages) {
+      const existingDocsWithStaleRefs = await client.fetch(
+        `*[
+          _id match "versions." + $releaseId + ".*" &&
+          @[$languageFieldName] == $targetLanguage &&
+          !(_id in $excludeIds)
+        ] {
+          _id,
+          "hasStaleRefs": count(*[
+            _id in $sourceDocumentIds && 
+            ^references(@._id)
+          ]) > 0
+        }[hasStaleRefs == true]`,
+        {
+          releaseId,
+          targetLanguage,
+          languageFieldName,
+          excludeIds: excludeDocumentIds,
+          sourceDocumentIds: normalizedSourceIds
+        }
+      );
+      if (existingDocsWithStaleRefs.length === 0) {
+        devLog.debug("No existing documents with stale references found", {
+          releaseId,
+          targetLanguage,
+          component: "updateBackwardReferences"
+        });
+        continue;
+      }
+      devLog.info("Found existing documents with stale references", {
+        releaseId,
+        targetLanguage,
+        count: existingDocsWithStaleRefs.length,
+        documentIds: existingDocsWithStaleRefs.map((d) => d._id),
+        component: "updateBackwardReferences"
+      }), await Promise.all(
+        existingDocsWithStaleRefs.map(async ({ _id }) => {
+          await localizeReferences({
+            client,
+            documentId: _id,
+            sourceLanguage,
+            languageFieldName
+          });
+        })
+      ), devLog.info("Updated backward references", {
+        releaseId,
+        targetLanguage,
+        updatedCount: existingDocsWithStaleRefs.length,
+        component: "updateBackwardReferences"
+      });
+    }
+  } catch (error) {
+    devLog.error("Error updating backward references", error instanceof Error ? error : new Error(String(error)), {
+      releaseId,
+      sourceDocumentIds: normalizedSourceIds,
+      targetLanguages,
+      component: "updateBackwardReferences"
+    });
+  }
 }, setupTranslationJobStatuses = (dispatch, sourceDocuments, targetLanguages, mainSourceDocumentId) => {
   for (const sourceDocument of sourceDocuments)
     for (const lang of targetLanguages) {
@@ -1659,13 +1759,6 @@ const globalTransformRegistry = new TransformRegistry(), callGPT5 = async (apiKe
         } else
           root.push(node);
         remainder && (lines[i] = remainder, i--);
-      } else if (content.endsWith(closingTag)) {
-        const textContent = content.substring(0, content.lastIndexOf("<"));
-        if (node.text = unescapeXml(textContent), stack.length > 0) {
-          const parent = stack[stack.length - 1];
-          parent && parent.children.push(node);
-        } else
-          root.push(node);
       } else if (attributes.type && typeof attributes.type == "string" && attributes.type.startsWith("translatable.")) {
         const contentLines = [];
         for (i++; i < lines.length; ) {
@@ -1921,10 +2014,17 @@ const globalTransformRegistry = new TransformRegistry(), callGPT5 = async (apiKe
     });
     return;
   }
-  node.text !== void 0 && !node.attributes.readonly && (get(doc, path) !== void 0 ? set(doc, path, node.text) : devLog.debug("Skipping field not present in original document", {
-    path: path.join("."),
-    attemptedValue: node.text
-  }));
+  if (node.text !== void 0 && !node.attributes.readonly) {
+    const existingValue = get(doc, path);
+    existingValue !== void 0 && typeof existingValue == "string" ? set(doc, path, node.text) : existingValue !== void 0 ? devLog.debug("Skipping field - existing value is not a string (would corrupt structure)", {
+      path: path.join("."),
+      existingType: typeof existingValue,
+      attemptedValue: node.text?.substring(0, 50)
+    }) : devLog.debug("Skipping field not present in original document", {
+      path: path.join("."),
+      attemptedValue: node.text
+    });
+  }
 }, applyBlockChanges = (block, blockNode) => {
   if (blockNode.attributes._key && block._key !== blockNode.attributes._key) {
     devLog.warn("Block key mismatch, skipping", {
@@ -1955,7 +2055,11 @@ const globalTransformRegistry = new TransformRegistry(), callGPT5 = async (apiKe
     });
     return;
   }
-  fieldNode.text !== void 0 && !fieldNode.attributes.readonly && (fieldName in block ? block[fieldName] = fieldNode.text : devLog.debug("Skipping block field not present in original", {
+  fieldNode.text !== void 0 && !fieldNode.attributes.readonly && (fieldName in block && typeof block[fieldName] == "string" ? block[fieldName] = fieldNode.text : fieldName in block ? devLog.debug("Skipping block field - existing value is not a string (would corrupt structure)", {
+    fieldName,
+    existingType: typeof block[fieldName],
+    attemptedValue: fieldNode.text?.substring(0, 50)
+  }) : devLog.debug("Skipping block field not present in original", {
     fieldName,
     attemptedValue: fieldNode.text
   }));
@@ -2793,8 +2897,28 @@ ${protectedPhrases.join(", ")}`, buildStyleGuideSection = (globalPrompt, localeP
       sourceDocument
     });
     setupTranslationJobStatuses(dispatch, sourceDocuments, targetLanguages, sourceDocument._id);
-    const translationTasks = sourceDocumentIds.flatMap(
+    const shouldSkipConflict = (documentId, targetLanguage) => !releaseConfig.skipConflicts || releaseConfig.skipConflicts.length === 0 ? !1 : releaseConfig.skipConflicts.some(
+      (conflict) => conflict.sourceDocumentId === documentId && conflict.targetLanguage === targetLanguage
+    ), skippedCount = sourceDocumentIds.reduce((count, documentId) => count + targetLanguages.filter((lang) => shouldSkipConflict(documentId, lang)).length, 0), translationTasks = sourceDocumentIds.flatMap(
       (documentId) => targetLanguages.map(async (targetLanguage) => {
+        if (shouldSkipConflict(documentId, targetLanguage)) {
+          const docInfo = sourceDocuments.find((d) => d._id === documentId);
+          devLog.info("Skipping conflicting translation", {
+            documentId,
+            targetLanguage,
+            reason: "User chose to skip conflicts"
+          }), dispatch({
+            type: "SET_TRANSLATION_JOB_STATUS",
+            payload: {
+              _id: documentId,
+              _type: docInfo?._type,
+              language: targetLanguage,
+              status: "skipped",
+              title: docInfo?.title
+            }
+          });
+          return;
+        }
         try {
           await translationSemaphore.withPermit(async () => {
             const document = await client.withConfig({
@@ -2833,12 +2957,13 @@ ${protectedPhrases.join(", ")}`, buildStyleGuideSection = (globalPrompt, localeP
           );
         }
       })
-    ), results = await Promise.allSettled(translationTasks), succeeded = results.filter((r) => r.status === "fulfilled").length, failed = results.filter((r) => r.status === "rejected").length;
+    ), results = await Promise.allSettled(translationTasks), succeeded = results.filter((r) => r.status === "fulfilled").length - skippedCount, failed = results.filter((r) => r.status === "rejected").length;
     devLog.info("Translation tasks completed", {
       ...logContext,
       total: results.length,
       succeeded,
       failed,
+      skipped: skippedCount,
       targetDocuments: versionedTargetDocumentIds.length
     }), dispatch({
       type: "SET_OVERALL_STATUS",
@@ -2852,7 +2977,15 @@ ${protectedPhrases.join(", ")}`, buildStyleGuideSection = (globalPrompt, localeP
           languageFieldName
         });
       })
-    );
+    ), releaseConfig.mode === "existing" && releaseId && await updateBackwardReferences({
+      client,
+      releaseId,
+      sourceDocumentIds,
+      targetLanguages,
+      sourceLanguage,
+      languageFieldName,
+      excludeDocumentIds: versionedTargetDocumentIds
+    });
     const hasAnyFailures = failed > 0;
     hasAnyFailures && succeeded === 0 ? (devLog.error("All translation tasks failed", void 0, logContext), dispatch({ type: "SET_OVERALL_STATUS", payload: "error" }), updateActiveTranslationStatus(sourceDocument._id, "error"), cleanupActiveTranslation(sourceDocument._id)) : hasAnyFailures ? (devLog.warn("Translation completed with some failures", {
       ...logContext,
@@ -2879,8 +3012,14 @@ ${protectedPhrases.join(", ")}`, buildStyleGuideSection = (globalPrompt, localeP
       }
     throw devLog.timeEnd("translateDocumentSet"), devLog.groupEnd(), dispatch({ type: "SET_OVERALL_STATUS", payload: "error" }), updateActiveTranslationStatus(sourceDocument._id, "error"), cleanupActiveTranslation(sourceDocument._id), error;
   }
-}, ReleaseConflictWarning = ({ conflicts, onCancel, onReplace }) => {
-  const uniqueDocuments = useMemo(() => new Set(conflicts.map((c) => c.sourceDocumentId)).size, [conflicts]), summaryText = useMemo(() => conflicts.length === 1 ? "1 translation" : uniqueDocuments === 1 ? `${conflicts.length} translations` : `${conflicts.length} translations across ${uniqueDocuments} documents`, [conflicts.length, uniqueDocuments]);
+}, ReleaseConflictWarning = ({
+  conflicts,
+  totalTranslations,
+  onCancel,
+  onReplace,
+  onSkipConflicts
+}) => {
+  const uniqueDocuments = useMemo(() => new Set(conflicts.map((c) => c.sourceDocumentId)).size, [conflicts]), nonConflictingCount = totalTranslations - conflicts.length, hasNonConflicting = nonConflictingCount > 0, summaryText = useMemo(() => conflicts.length === 1 ? "1 translation" : uniqueDocuments === 1 ? `${conflicts.length} translations` : `${conflicts.length} translations across ${uniqueDocuments} documents`, [conflicts.length, uniqueDocuments]);
   return /* @__PURE__ */ jsx(Card, { tone: "caution", padding: 4, border: !0, radius: 2, children: /* @__PURE__ */ jsxs(Stack, { space: 4, children: [
     /* @__PURE__ */ jsxs(Flex, { align: "center", gap: 2, children: [
       /* @__PURE__ */ jsx(Text, { size: 2, children: /* @__PURE__ */ jsx(WarningOutlineIcon, {}) }),
@@ -2904,13 +3043,34 @@ ${protectedPhrases.join(", ")}`, buildStyleGuideSection = (globalPrompt, localeP
         " \u2014 Go back and select a different release, or create a new one."
       ] }),
       /* @__PURE__ */ jsxs(Text, { size: 1, children: [
-        /* @__PURE__ */ jsx("strong", { children: "Replace" }),
+        /* @__PURE__ */ jsx("strong", { children: "Replace All" }),
         " \u2014 Delete the existing translations in this release and create new ones."
+      ] }),
+      /* @__PURE__ */ jsxs(Text, { size: 1, children: [
+        /* @__PURE__ */ jsx("strong", { children: "Skip Conflicts" }),
+        " \u2014 Translate only the ",
+        nonConflictingCount,
+        " non-conflicting translation",
+        nonConflictingCount !== 1 ? "s" : "",
+        ", leaving existing ones unchanged.",
+        !hasNonConflicting && " (All translations have conflicts)"
       ] })
     ] }),
-    /* @__PURE__ */ jsxs(Flex, { gap: 2, justify: "flex-end", children: [
+    /* @__PURE__ */ jsxs(Flex, { gap: 2, justify: "space-between", children: [
       /* @__PURE__ */ jsx(Button, { mode: "ghost", text: "Cancel", onClick: onCancel }),
-      /* @__PURE__ */ jsx(Button, { mode: "ghost", tone: "caution", text: "Replace Existing", onClick: onReplace })
+      /* @__PURE__ */ jsxs(Flex, { gap: 2, justify: "flex-end", children: [
+        /* @__PURE__ */ jsx(Button, { mode: "bleed", tone: "caution", text: "Replace All", onClick: onReplace }),
+        /* @__PURE__ */ jsx(
+          Button,
+          {
+            mode: "ghost",
+            tone: "caution",
+            text: "Skip Conflicts",
+            onClick: onSkipConflicts,
+            disabled: !hasNonConflicting
+          }
+        )
+      ] })
     ] })
   ] }) });
 }, ActionButtonBar = ({ setIsDialogOpen }) => {
@@ -2924,12 +3084,12 @@ ${protectedPhrases.join(", ")}`, buildStyleGuideSection = (globalPrompt, localeP
     selectedTargetLanguages,
     translationMode,
     releaseConfig
-  } = useTranslationContext(), client = useClient({ apiVersion: "vX" }), [conflictContext, setConflictContext] = useState(null), [isCheckingConflicts, setIsCheckingConflicts] = useState(!1), filteredReferences = references.filter((ref) => selectedReferenceIds.has(ref._id));
+  } = useTranslationContext(), client = useClient({ apiVersion: "vX" }), [conflictContext, setConflictContext] = useState(null), [isCheckingConflicts, setIsCheckingConflicts] = useState(!1), filteredReferences = references.filter((ref) => selectedReferenceIds.has(ref._id)), totalTranslations = useMemo(() => (1 + filteredReferences.length) * selectedTargetLanguages.length, [filteredReferences.length, selectedTargetLanguages.length]);
   useEffect(() => {
     releaseConfig.mode === "new" && conflictContext && setConflictContext(null);
   }, [releaseConfig.mode, conflictContext]);
   const startTranslation = useCallback(
-    (replaceExisting, overrideReleaseId) => {
+    (replaceExisting, overrideReleaseId, skipConflicts) => {
       setConflictContext(null), translateDocumentSet({
         sourceDocument: document,
         targetLanguages: selectedTargetLanguages,
@@ -2946,6 +3106,7 @@ ${protectedPhrases.join(", ")}`, buildStyleGuideSection = (globalPrompt, localeP
         releaseConfig: {
           ...releaseConfig,
           replaceExisting,
+          skipConflicts,
           // Use the override release ID if provided (from conflict context),
           // otherwise use the current releaseConfig value
           existingReleaseId: overrideReleaseId ?? releaseConfig.existingReleaseId
@@ -2992,10 +3153,20 @@ ${protectedPhrases.join(", ")}`, buildStyleGuideSection = (globalPrompt, localeP
       }
     }
     startTranslation(!1);
-  }, [releaseConfig, client, document, selectedTargetLanguages, config.languageFieldName, startTranslation, filteredReferences]), handleCancelConflict = useCallback(() => {
+  }, [
+    releaseConfig,
+    client,
+    document,
+    selectedTargetLanguages,
+    config.languageFieldName,
+    startTranslation,
+    filteredReferences
+  ]), handleCancelConflict = useCallback(() => {
     setConflictContext(null);
   }, []), handleReplaceConflict = useCallback(() => {
     conflictContext && startTranslation(!0, conflictContext.releaseId);
+  }, [startTranslation, conflictContext]), handleSkipConflicts = useCallback(() => {
+    conflictContext && startTranslation(!1, conflictContext.releaseId, conflictContext.conflicts);
   }, [startTranslation, conflictContext]), handleSelectAll = useCallback(() => {
     dispatch({
       type: "SET_SELECTED_TARGET_LANGUAGES",
@@ -3011,8 +3182,10 @@ ${protectedPhrases.join(", ")}`, buildStyleGuideSection = (globalPrompt, localeP
     ReleaseConflictWarning,
     {
       conflicts: conflictContext.conflicts,
+      totalTranslations,
       onCancel: handleCancelConflict,
-      onReplace: handleReplaceConflict
+      onReplace: handleReplaceConflict,
+      onSkipConflicts: handleSkipConflicts
     }
   ) }) : /* @__PURE__ */ jsxs(Flex, { justify: "space-between", gap: 2, children: [
     /* @__PURE__ */ jsxs(Flex, { justify: "flex-start", gap: 2, children: [
@@ -3094,8 +3267,184 @@ ${protectedPhrases.join(", ")}`, buildStyleGuideSection = (globalPrompt, localeP
     documentId: document._id
   });
   return /* @__PURE__ */ jsx(Card, { padding: 4, muted: !0, border: !0, children: /* @__PURE__ */ jsx(Grid, { columns: [1, 2], gap: 3, children: config?.supportedLanguages.map((lang) => /* @__PURE__ */ jsx(LanguageCheckbox, { lang, isLoading: loading }, lang.id)) }) });
+}, reconcileReleaseReferences = async ({
+  client,
+  releaseId,
+  sourceLanguage,
+  languageFieldName,
+  onProgress
+}) => {
+  devLog.info("Starting release reference reconciliation", {
+    releaseId,
+    sourceLanguage,
+    component: "reconcileReleaseReferences"
+  });
+  try {
+    const docsInRelease = await client.fetch(
+      `*[_id match "versions." + $releaseId + ".*"] {
+        _id,
+        "language": @[$languageFieldName]
+      }`,
+      { releaseId, languageFieldName }
+    );
+    if (docsInRelease.length === 0)
+      return devLog.info("No documents found in release", {
+        releaseId,
+        component: "reconcileReleaseReferences"
+      }), { total: 0, updated: 0, errors: 0 };
+    devLog.info("Found documents in release", {
+      releaseId,
+      count: docsInRelease.length,
+      component: "reconcileReleaseReferences"
+    });
+    let updated = 0, errors = 0;
+    for (let i = 0; i < docsInRelease.length; i++) {
+      const doc = docsInRelease[i];
+      onProgress && onProgress(i + 1, docsInRelease.length);
+      try {
+        if (!doc.language) {
+          devLog.warn("Document missing language field, skipping", {
+            documentId: doc._id,
+            component: "reconcileReleaseReferences"
+          });
+          continue;
+        }
+        await localizeReferences({
+          client,
+          documentId: doc._id,
+          sourceLanguage,
+          languageFieldName
+        }), updated++;
+      } catch (error) {
+        errors++, devLog.error(
+          "Failed to reconcile references for document",
+          error instanceof Error ? error : new Error(String(error)),
+          {
+            documentId: doc._id,
+            component: "reconcileReleaseReferences"
+          }
+        );
+      }
+    }
+    const result = {
+      total: docsInRelease.length,
+      updated,
+      errors
+    };
+    return devLog.info("Release reference reconciliation complete", {
+      releaseId,
+      ...result,
+      component: "reconcileReleaseReferences"
+    }), result;
+  } catch (error) {
+    throw devLog.error("Failed to reconcile release references", error instanceof Error ? error : new Error(String(error)), {
+      releaseId,
+      component: "reconcileReleaseReferences"
+    }), error;
+  }
+}, ReconcileReferencesButton = ({ sourceLanguage }) => {
+  const { dispatch, releaseConfig, overallStatus, reconcilingStatus, reconciliationProgress, config } = useTranslationContext(), client = useClient({ apiVersion: "vX" }), [documentCount, setDocumentCount] = useState(null), [isLoadingCount, setIsLoadingCount] = useState(!1), releaseId = releaseConfig.existingReleaseId, languageFieldName = config?.languageFieldName ?? "language";
+  useEffect(() => {
+    if (!releaseId || releaseConfig.mode !== "existing") {
+      setDocumentCount(null);
+      return;
+    }
+    (async () => {
+      setIsLoadingCount(!0);
+      try {
+        const count = await client.fetch('count(*[_id match "versions." + $releaseId + ".*"])', { releaseId });
+        setDocumentCount(count), devLog.debug("Fetched release document count", {
+          releaseId,
+          count,
+          component: "ReconcileReferencesButton"
+        });
+      } catch (error) {
+        devLog.error(
+          "Failed to fetch release document count",
+          error instanceof Error ? error : new Error(String(error)),
+          {
+            releaseId,
+            component: "ReconcileReferencesButton"
+          }
+        ), setDocumentCount(null);
+      } finally {
+        setIsLoadingCount(!1);
+      }
+    })();
+  }, [releaseId, releaseConfig.mode, client]);
+  const handleReconcile = useCallback(async () => {
+    if (releaseId) {
+      devLog.info("Starting reference reconciliation", {
+        releaseId,
+        sourceLanguage,
+        component: "ReconcileReferencesButton"
+      }), dispatch({ type: "SET_RECONCILING_STATUS", payload: "reconciling" });
+      try {
+        const result = await reconcileReleaseReferences({
+          client,
+          releaseId,
+          sourceLanguage,
+          languageFieldName,
+          onProgress: (current, total) => {
+            dispatch({
+              type: "SET_RECONCILIATION_PROGRESS",
+              payload: { current, total }
+            });
+          }
+        });
+        devLog.info("Reference reconciliation completed", {
+          releaseId,
+          ...result,
+          component: "ReconcileReferencesButton"
+        }), dispatch({ type: "SET_RECONCILING_STATUS", payload: "completed" }), setTimeout(() => {
+          dispatch({ type: "SET_RECONCILING_STATUS", payload: "idle" });
+        }, 2e3);
+      } catch (error) {
+        devLog.error("Reference reconciliation failed", error instanceof Error ? error : new Error(String(error)), {
+          releaseId,
+          component: "ReconcileReferencesButton"
+        }), dispatch({ type: "SET_RECONCILING_STATUS", payload: "error" });
+      }
+    }
+  }, [releaseId, sourceLanguage, languageFieldName, client, dispatch]);
+  if (releaseConfig.mode !== "existing" || !releaseId)
+    return null;
+  const isTranslating = overallStatus === "translating" || overallStatus === "linking_references", isReconciling = reconcilingStatus === "reconciling";
+  return /* @__PURE__ */ jsx(Card, { padding: 3, border: !0, radius: 2, tone: reconcilingStatus === "error" ? "critical" : "default", children: /* @__PURE__ */ jsxs(Stack, { space: 3, children: [
+    /* @__PURE__ */ jsxs(Flex, { align: "center", justify: "space-between", gap: 3, children: [
+      /* @__PURE__ */ jsxs(Stack, { space: 2, children: [
+        /* @__PURE__ */ jsx(Text, { size: 1, weight: "medium", children: "Reconcile References" }),
+        /* @__PURE__ */ jsx(Text, { size: 1, muted: !0, children: isLoadingCount ? "Loading..." : documentCount === null ? "Unable to load document count" : documentCount === 0 ? "No documents in release" : /* @__PURE__ */ jsxs(Fragment, { children: [
+          documentCount,
+          " document",
+          documentCount !== 1 ? "s" : "",
+          " in release"
+        ] }) })
+      ] }),
+      /* @__PURE__ */ jsx(
+        Button,
+        {
+          icon: isReconciling ? Spinner : SyncIcon,
+          text: reconcilingStatus === "completed" ? "Done!" : reconcilingStatus === "error" ? "Retry" : isReconciling ? "Reconciling..." : "Reconcile",
+          tone: reconcilingStatus === "completed" ? "positive" : reconcilingStatus === "error" ? "critical" : "default",
+          mode: "ghost",
+          onClick: handleReconcile,
+          disabled: (isTranslating || isReconciling || isLoadingCount || documentCount === 0) && reconcilingStatus !== "error"
+        }
+      )
+    ] }),
+    isReconciling && reconciliationProgress && /* @__PURE__ */ jsx(Flex, { align: "center", gap: 2, children: /* @__PURE__ */ jsxs(Text, { size: 1, muted: !0, children: [
+      "Processing ",
+      reconciliationProgress.current,
+      " of ",
+      reconciliationProgress.total,
+      "..."
+    ] }) }),
+    reconcilingStatus === "error" && /* @__PURE__ */ jsx(Text, { size: 1, muted: !0, children: "Reconciliation failed. Click Retry to try again." }),
+    reconcilingStatus === "idle" && documentCount !== null && documentCount > 0 && /* @__PURE__ */ jsx(Text, { size: 1, muted: !0, children: "Updates all document references to point to their translated versions in this release." })
+  ] }) });
 }, ReleaseSelectionPanel = () => {
-  const { dispatch, releaseConfig } = useTranslationContext(), client = useClient({ apiVersion: "vX" }), [releases, setReleases] = useState([]), [isLoading, setIsLoading] = useState(!1), [error, setError] = useState(null), [searchQuery, setSearchQuery] = useState("");
+  const { dispatch, releaseConfig, document, config } = useTranslationContext(), client = useClient({ apiVersion: "vX" }), languageFieldName = config?.languageFieldName ?? "language", sourceLanguage = document?.[languageFieldName], [releases, setReleases] = useState([]), [isLoading, setIsLoading] = useState(!1), [error, setError] = useState(null), [searchQuery, setSearchQuery] = useState(""), [showReconcileUI, setShowReconcileUI] = useState(!1);
   useEffect(() => {
     (async () => {
       setIsLoading(!0), setError(null);
@@ -3208,12 +3557,33 @@ ${protectedPhrases.join(", ")}`, buildStyleGuideSection = (globalPrompt, localeP
               radius: 2,
               tone: isSelected ? "primary" : "default",
               style: { cursor: "pointer" },
-              onClick: () => handleSelectRelease(releaseName),
+              onClick: () => {
+                handleSelectRelease(releaseName), isSelected || setShowReconcileUI(!1);
+              },
               border: !0,
               muted: isSelected,
               children: /* @__PURE__ */ jsxs(Flex, { direction: "column", gap: 3, children: [
-                /* @__PURE__ */ jsx(Text, { size: 1, children: release.metadata.title }),
-                /* @__PURE__ */ jsx(Text, { size: 1, muted: !0, children: formatDate(release._createdAt) })
+                /* @__PURE__ */ jsxs(Flex, { justify: "space-between", align: "center", children: [
+                  /* @__PURE__ */ jsxs(Flex, { direction: "column", gap: 2, children: [
+                    /* @__PURE__ */ jsx(Text, { size: 1, children: release.metadata.title }),
+                    /* @__PURE__ */ jsx(Text, { size: 1, muted: !0, children: formatDate(release._createdAt) })
+                  ] }),
+                  isSelected && sourceLanguage && /* @__PURE__ */ jsx(
+                    Button,
+                    {
+                      icon: SyncIcon,
+                      text: showReconcileUI ? "Hide" : "Reconcile References",
+                      mode: "bleed",
+                      tone: "primary",
+                      fontSize: 0,
+                      padding: 2,
+                      onClick: (e) => {
+                        e.stopPropagation(), setShowReconcileUI(!showReconcileUI);
+                      }
+                    }
+                  )
+                ] }),
+                releaseConfig.existingReleaseId && sourceLanguage && showReconcileUI && /* @__PURE__ */ jsx(ReconcileReferencesButton, { sourceLanguage })
               ] })
             },
             release._id
@@ -3440,13 +3810,7 @@ ${protectedPhrases.join(", ")}`, buildStyleGuideSection = (globalPrompt, localeP
     /* @__PURE__ */ jsx(Box, { style: { maxHeight: "400px", overflowY: "auto" }, children: /* @__PURE__ */ jsx(Stack, { space: 2, children: filteredReferences.length === 0 ? /* @__PURE__ */ jsx(Text, { size: 1, muted: !0, children: "No references match the selected filter." }) : filteredReferences.map((reference) => {
       const isSelected = selectedReferenceIds.has(reference._id), displayTitle = reference.title || reference._id;
       return /* @__PURE__ */ jsx(Card, { padding: 3, border: !0, radius: 2, children: /* @__PURE__ */ jsxs(Flex, { align: "center", gap: 3, children: [
-        /* @__PURE__ */ jsx(
-          Checkbox,
-          {
-            checked: isSelected,
-            onChange: () => handleToggleReference(reference._id)
-          }
-        ),
+        /* @__PURE__ */ jsx(Checkbox, { checked: isSelected, onChange: () => handleToggleReference(reference._id) }),
         /* @__PURE__ */ jsxs(Flex, { flex: 1, align: "center", gap: 2, children: [
           /* @__PURE__ */ jsx(Text, { size: 1, children: displayTitle }),
           /* @__PURE__ */ jsx(Badge, { tone: "primary", fontSize: 0, children: reference._type })
@@ -3455,15 +3819,7 @@ ${protectedPhrases.join(", ")}`, buildStyleGuideSection = (globalPrompt, localeP
     }) }) })
   ] }) });
 }, ReferenceConfigPanel = () => {
-  const {
-    dispatch,
-    document,
-    shouldTranslateReferences,
-    maxReferenceDepth,
-    config,
-    references,
-    selectedReferenceIds
-  } = useTranslationContext(), client = useClient({ apiVersion: "vX" }), [isLoadingReferences, setIsLoadingReferences] = useState(!1), [showSelectionPanel, setShowSelectionPanel] = useState(!1), maxDepth = config.maxReferenceDepth || 3;
+  const { dispatch, document, shouldTranslateReferences, maxReferenceDepth, config, references, selectedReferenceIds } = useTranslationContext(), client = useClient({ apiVersion: "vX" }), [isLoadingReferences, setIsLoadingReferences] = useState(!1), [showSelectionPanel, setShowSelectionPanel] = useState(!1), maxDepth = config.maxReferenceDepth || 3;
   useEffect(() => {
     (async () => {
       if (setIsLoadingReferences(!0), !shouldTranslateReferences) {