@form-engine-ts/react 6.1.0 → 6.3.0

package/README.md

@@ -89,13 +89,17 @@ underscore-separated values such as `EN_us` are accepted as compatibility input.
 Use `isAddLocaleAllowed` to disable locale controls before submission. Removing a locale also clears its
 localized values and metadata; the default locale remains protected.
 
-`useTranslationWorkspace` can notify `onTranslationStart`, `onTranslationSuccess`, `onTranslationError`, and
-`onTranslationChange` with typed lifecycle payloads. The MUI workspace accepts a `confirmRemoveLocale` slot for an
-async confirmation UI; its `onConfirm` callback completes the locale removal.
+`useTranslationWorkspace` accepts either a synchronous or asynchronous translation adapter, forwards an optional
+`AbortSignal`, and exposes `cancelTranslation`, progress, and typed partial-failure/cancellation errors. It can notify
+`onTranslationStart`, `onTranslationSuccess`, `onTranslationReport`, `onTranslationError`, and `onTranslationChange`
+with typed lifecycle payloads. The MUI workspace accepts a `confirmRemoveLocale` slot for an async confirmation UI;
+its `onConfirm` callback completes the locale removal.
 
 `useTranslationComparison` provides a focused, controlled comparison model for form, page, field, and option text.
 Its items expose source text, target text, status, canonical metadata, and path-based `updateTranslation`,
-`translateSingle`, and `translateAll` actions.
+`translateSingle`, and `translateAll` actions. Comparison row slots receive `nodeKind`, locale labels, read-only state,
+field type, question and option indexes, metadata, plus async single-translation actions. Use
+`createTranslationMetadata` to add provider/model/hash fields while the canonical metadata fields are retained.
 
 Wrap a builder or renderer in `FormEngineI18nProvider` to supply a UI locale and typed Core translator independently
 from the schema's `defaultLocale` and `supportedLocales`:

package/dist/index.cjs

@@ -3325,7 +3325,7 @@ function asAsyncAdapter(adapter) {
     )
   };
 }
-var validateLocalePipeline = (locale, schema, policy, customValidator, availableLocales) => {
+var validateLocalePipeline = (locale, schema, policy, customValidator, availableLocales, sourceLocale) => {
   const canonicalLocale = (0, import_core5.normalizeLocale)(locale);
   if (canonicalLocale === null) {
     return {
@@ -3337,20 +3337,17 @@ var validateLocalePipeline = (locale, schema, policy, customValidator, available
     };
   }
   const currentLocales = (schema.supportedLocales ?? []).map((candidate) => (0, import_core5.normalizeLocale)(candidate) ?? candidate);
-  const defaultLocale = schema.defaultLocale === void 0 ? "" : (0, import_core5.normalizeLocale)(schema.defaultLocale) ?? schema.defaultLocale;
-  if (availableLocales !== void 0 && !availableLocales.some((candidate) => {
-    const value = typeof candidate === "string" ? candidate : candidate.locale;
-    return (0, import_core5.normalizeLocale)(value) === canonicalLocale;
-  })) {
+  const defaultLocale = (0, import_core5.normalizeLocale)(sourceLocale ?? schema.defaultLocale ?? "") ?? sourceLocale ?? schema.defaultLocale ?? "";
+  if (canonicalLocale === defaultLocale) {
     return {
       valid: false,
       error: {
-        type: "locale_not_allowed",
-        message: `Locale "${canonicalLocale}" is not available in the locale catalog.`
+        type: "source_locale",
+        message: `Locale "${canonicalLocale}" is the source locale and cannot be added as a translation.`
       }
     };
   }
-  if (canonicalLocale === defaultLocale || currentLocales.includes(canonicalLocale)) {
+  if (currentLocales.includes(canonicalLocale)) {
     return {
       valid: false,
       error: {
@@ -3359,6 +3356,18 @@ var validateLocalePipeline = (locale, schema, policy, customValidator, available
       }
     };
   }
+  if (availableLocales !== void 0 && !availableLocales.some((candidate) => {
+    const value = typeof candidate === "string" ? candidate : candidate.locale;
+    return (0, import_core5.normalizeLocale)(value) === canonicalLocale;
+  })) {
+    return {
+      valid: false,
+      error: {
+        type: "locale_not_allowed",
+        message: `Locale "${canonicalLocale}" is not available in the locale catalog.`
+      }
+    };
+  }
   if (policy?.allowedLocales !== void 0 && !policy.allowedLocales.some((candidate) => (0, import_core5.normalizeLocale)(candidate) === canonicalLocale)) {
     return {
       valid: false,
@@ -3412,6 +3421,7 @@ function workspaceLocaleValidationError(validation, currentLocales, requestedLoc
   if (error.type === "locale_already_exists") {
     return { type: "locale_already_exists", locale: requestedLocale };
   }
+  if (error.type === "source_locale") return { type: "source_locale", locale: requestedLocale };
   if (error.type === "invalid_locale_format") {
     return { type: "invalid_locale_format", locale: requestedLocale };
   }
@@ -3429,19 +3439,29 @@ function translationMetadata(sourceText, sourceLocale, mode) {
     ...mode === "manual" ? { editedAt: (/* @__PURE__ */ new Date()).toISOString() } : { translatedAt: (/* @__PURE__ */ new Date()).toISOString() }
   };
 }
-function setNodeMetadata(node, slot, text, sourceLocale, mode) {
+function createTranslationMetadata(slot, sourceLocale, translatedText, mode, factory) {
+  return {
+    ...factory?.({ slot, translatedText, mode }) ?? {},
+    ...translationMetadata(slot.sourceText, sourceLocale, mode)
+  };
+}
+function setNodeMetadata(node, slot, text, sourceLocale, mode, metadataOverride) {
   const localeMetadata = node.translationMetadata?.[slot.locale];
-  const nextMetadata = text.trim().length === 0 ? Object.fromEntries(Object.entries(localeMetadata ?? {}).filter(([key]) => key !== slot.property)) : { ...localeMetadata, [slot.property]: translationMetadata(slot.sourceText, sourceLocale, mode) };
+  const nextMetadata = text.trim().length === 0 ? Object.fromEntries(Object.entries(localeMetadata ?? {}).filter(([key]) => key !== slot.property)) : {
+    ...localeMetadata,
+    [slot.property]: metadataOverride ?? translationMetadata(slot.sourceText, sourceLocale, mode)
+  };
   return { ...node, translationMetadata: { ...node.translationMetadata, [slot.locale]: nextMetadata } };
 }
-function updateSchemaTranslation(schema, slot, text, sourceLocale, mode = "manual") {
+function updateSchemaTranslation(schema, slot, text, sourceLocale, mode = "manual", metadataOverride) {
   if (slot.kind === "form") {
     return setNodeMetadata(
       { ...schema, translations: updateTranslationMap(schema.translations, slot.locale, slot.property, text) },
       slot,
       text,
       sourceLocale,
-      mode
+      mode,
+      metadataOverride
     );
   }
   if (slot.kind === "field") {
@@ -3450,7 +3470,14 @@ function updateSchemaTranslation(schema, slot, text, sourceLocale, mode = "manua
       fields: schema.fields.map((field) => {
         if (field.id !== slot.nodeId) return field;
         const translations = updateTranslationMap(field.translations, slot.locale, slot.property, text);
-        return setNodeMetadata({ ...field, translations }, slot, text, sourceLocale, mode);
+        return setNodeMetadata(
+          { ...field, translations },
+          slot,
+          text,
+          sourceLocale,
+          mode,
+          metadataOverride
+        );
       })
     };
   }
@@ -3466,7 +3493,7 @@ function updateSchemaTranslation(schema, slot, text, sourceLocale, mode = "manua
             const translations = text.trim().length === 0 ? Object.fromEntries(
               Object.entries(option.translations ?? {}).filter(([locale]) => locale !== slot.locale)
             ) : { ...option.translations, [slot.locale]: text };
-            return setNodeMetadata({ ...option, translations }, slot, text, sourceLocale, mode);
+            return setNodeMetadata({ ...option, translations }, slot, text, sourceLocale, mode, metadataOverride);
           })
         };
       })
@@ -3478,7 +3505,7 @@ function updateSchemaTranslation(schema, slot, text, sourceLocale, mode = "manua
       pages: schema.pages.map((page) => {
         if (page.id !== slot.nodeId) return page;
         const translations = updateTranslationMap(page.translations, slot.locale, slot.property, text);
-        return setNodeMetadata({ ...page, translations }, slot, text, sourceLocale, mode);
+        return setNodeMetadata({ ...page, translations }, slot, text, sourceLocale, mode, metadataOverride);
       })
     }
   };
@@ -3489,6 +3516,7 @@ function useTranslationWorkspace({
   sourceLocale = schema.defaultLocale ?? "en",
   targetLocale,
   translationAdapter,
+  signal,
   readOnly = false,
   policy,
   availableLocales,
@@ -3500,34 +3528,49 @@ function useTranslationWorkspace({
   slots: workspaceSlots,
   onTranslationStart,
   onTranslationSuccess,
+  onTranslationReport,
   onTranslationError,
   onTranslationChange,
-  validateLocale
+  validateLocale,
+  createTranslationMetadata: metadataFactory
 }) {
   const [draftSchema, setDraftSchema] = (0, import_react5.useState)(schema);
   const [selectedLocale, setSelectedLocale] = (0, import_react5.useState)((0, import_core5.normalizeLocale)(targetLocale ?? "") ?? targetLocale ?? "");
   const [isTranslating, setIsTranslating] = (0, import_react5.useState)(false);
+  const [progress, setProgress] = (0, import_react5.useState)();
   const [error, setError] = (0, import_react5.useState)();
   const [pendingRemoval, setPendingRemoval] = (0, import_react5.useState)();
+  const activeAbortController = (0, import_react5.useRef)(void 0);
   const pendingRemovalResolver = (0, import_react5.useRef)(void 0);
   const currentSchema = onChange === void 0 ? draftSchema : schema;
   const confirmRemoveLocaleRenderer = confirmRemoveLocale ?? workspaceSlots?.confirmRemoveLocale;
   const targetLocales = (0, import_react5.useMemo)(() => {
     const locales = (0, import_core5.collectSchemaLocales)(currentSchema).allUniqueLocales;
-    return [.../* @__PURE__ */ new Set([...currentSchema.supportedLocales ?? [], ...locales])].filter(
-      (locale) => locale !== sourceLocale
-    );
+    const normalizedSourceLocale = (0, import_core5.normalizeLocale)(sourceLocale) ?? sourceLocale;
+    return [
+      ...new Set(
+        [...currentSchema.supportedLocales ?? [], ...locales].map((locale) => (0, import_core5.normalizeLocale)(locale) ?? locale)
+      )
+    ].filter((locale) => locale !== normalizedSourceLocale);
   }, [currentSchema, sourceLocale]);
   const activeLocale = selectedLocale.length > 0 ? selectedLocale : targetLocales[0] ?? "";
   const localeOptions = (0, import_react5.useMemo)(() => {
     if (availableLocales === void 0) {
       return targetLocales.map((locale) => ({ locale, label: locale }));
     }
-    return availableLocales.map((candidate) => {
-      if (typeof candidate !== "string") return candidate;
-      return { locale: (0, import_core5.normalizeLocale)(candidate) ?? candidate, label: candidate };
-    });
-  }, [availableLocales, targetLocales]);
+    const targetLocaleSet = new Set(targetLocales);
+    const allowedLocales = policy?.allowedLocales?.map((locale) => (0, import_core5.normalizeLocale)(locale) ?? locale);
+    const options = /* @__PURE__ */ new Map();
+    for (const candidate of availableLocales) {
+      const option = typeof candidate === "string" ? { locale: (0, import_core5.normalizeLocale)(candidate) ?? candidate, label: candidate } : { ...candidate, locale: (0, import_core5.normalizeLocale)(candidate.locale) ?? candidate.locale };
+      const allowed = allowedLocales === void 0 || allowedLocales.includes(option.locale);
+      if (allowed || targetLocaleSet.has(option.locale)) options.set(option.locale, option);
+    }
+    for (const locale of targetLocales) {
+      if (!options.has(locale)) options.set(locale, { locale, label: locale });
+    }
+    return [...options.values()];
+  }, [availableLocales, policy?.allowedLocales, targetLocales]);
   const slots = (0, import_react5.useMemo)(
     () => activeLocale.length === 0 ? [] : (0, import_core5.collectTranslationSlots)(currentSchema, activeLocale),
     [activeLocale, currentSchema]
@@ -3561,8 +3604,8 @@ function useTranslationWorkspace({
   const setTranslation = (0, import_react5.useCallback)(
     (slot, text) => {
       if (readOnly) return;
-      const metadata = translationMetadata(slot.sourceText, sourceLocale, "manual");
-      commit(updateSchemaTranslation(currentSchema, slot, text, sourceLocale, "manual"));
+      const metadata = createTranslationMetadata(slot, sourceLocale, text, "manual", metadataFactory);
+      commit(updateSchemaTranslation(currentSchema, slot, text, sourceLocale, "manual", metadata));
       onTranslationChange?.({
         slot,
         ...slot.existingText === void 0 ? {} : { previousText: slot.existingText },
@@ -3571,7 +3614,7 @@ function useTranslationWorkspace({
         metadata
       });
     },
-    [commit, currentSchema, onTranslationChange, readOnly, sourceLocale]
+    [commit, currentSchema, metadataFactory, onTranslationChange, readOnly, sourceLocale]
   );
   const addLocale = (0, import_react5.useCallback)(
     (locale) => {
@@ -3583,14 +3626,21 @@ function useTranslationWorkspace({
       const normalized = (0, import_core5.normalizeLocale)(locale);
       if (normalized === null) {
         const workspaceError = workspaceLocaleValidationError(
-          validateLocalePipeline(locale, currentSchema, policy, validateLocale, availableLocales),
+          validateLocalePipeline(locale, currentSchema, policy, validateLocale, availableLocales, sourceLocale),
           (0, import_core5.collectSchemaLocales)(currentSchema).allUniqueLocales.size,
           locale
         );
         setError(workspaceError);
         return { success: false, error: workspaceError };
       }
-      const validation = validateLocalePipeline(normalized, currentSchema, policy, validateLocale, availableLocales);
+      const validation = validateLocalePipeline(
+        normalized,
+        currentSchema,
+        policy,
+        validateLocale,
+        availableLocales,
+        sourceLocale
+      );
       if (!validation.valid) {
         const workspaceError = workspaceLocaleValidationError(
           validation,
@@ -3609,16 +3659,16 @@ function useTranslationWorkspace({
       onLocaleAdded?.(normalized);
       return { success: true };
     },
-    [availableLocales, commit, currentSchema, onLocaleAdded, policy, readOnly, validateLocale]
+    [availableLocales, commit, currentSchema, onLocaleAdded, policy, readOnly, sourceLocale, validateLocale]
   );
   const isAddLocaleAllowed = (0, import_react5.useCallback)(
     (locale) => {
       if (readOnly) return false;
       const normalized = (0, import_core5.normalizeLocale)(locale);
       if (normalized === null) return false;
-      return validateLocalePipeline(normalized, currentSchema, policy, validateLocale, availableLocales).valid;
+      return validateLocalePipeline(normalized, currentSchema, policy, validateLocale, availableLocales, sourceLocale).valid;
     },
-    [availableLocales, currentSchema, policy, readOnly, validateLocale]
+    [availableLocales, currentSchema, policy, readOnly, sourceLocale, validateLocale]
   );
   const removeLocale = (0, import_react5.useCallback)(
     (locale) => {
@@ -3748,7 +3798,15 @@ function useTranslationWorkspace({
       }
       setIsTranslating(true);
       setError(void 0);
+      setProgress(void 0);
       onTranslationStart?.({ targetLocale: activeLocale, mode: "automatic" });
+      const controller = new AbortController();
+      activeAbortController.current = controller;
+      const operationSignal = options.signal ?? signal;
+      const abortListener = operationSignal === void 0 ? void 0 : () => controller.abort(operationSignal.reason);
+      if (operationSignal?.aborted) controller.abort(operationSignal.reason);
+      else if (operationSignal !== void 0 && abortListener !== void 0)
+        operationSignal.addEventListener("abort", abortListener, { once: true });
       try {
         const populated = await (0, import_core5.populateSchemaTranslations)(
           currentSchema,
@@ -3757,13 +3815,37 @@ function useTranslationWorkspace({
           {
             overwrite: "stale-and-missing",
             preserveManualTranslations: true,
-            ...options
+            ...options,
+            continueOnError: true,
+            signal: controller.signal,
+            createMetadata: (slot, translatedText) => options.createMetadata?.(slot, translatedText) ?? createTranslationMetadata(slot, sourceLocale, translatedText, "automatic", metadataFactory),
+            onProgress: (nextProgress) => {
+              setProgress(nextProgress);
+              options.onProgress?.(nextProgress);
+            }
           }
         );
         commit(populated.schema);
+        onTranslationReport?.(populated.report);
         const missingSlotsCount = (0, import_core5.collectTranslationSlots)(populated.schema, activeLocale).filter(
           (slot) => slot.status === "missing"
         ).length;
+        if (populated.report.cancelled === true) {
+          const workspaceError = { type: "cancelled" };
+          setError(workspaceError);
+          onTranslationError?.({ targetLocale: activeLocale, error: workspaceError });
+          return { success: false, report: populated.report, error: workspaceError };
+        }
+        if ((populated.report.failed ?? 0) > 0) {
+          const workspaceError = {
+            type: "partial_failure",
+            succeeded: populated.report.succeeded ?? populated.report.updatedSlots.length,
+            failed: populated.report.failed ?? 0
+          };
+          setError(workspaceError);
+          onTranslationError?.({ targetLocale: activeLocale, error: workspaceError });
+          return { success: false, report: populated.report, error: workspaceError };
+        }
         onTranslationSuccess?.({
           sourceLocale,
           targetLocale: activeLocale,
@@ -3774,6 +3856,12 @@ function useTranslationWorkspace({
         });
         return { success: true, report: populated.report };
       } catch (cause) {
+        if (controller.signal.aborted || cause instanceof DOMException && cause.name === "AbortError") {
+          const workspaceError2 = { type: "cancelled" };
+          setError(workspaceError2);
+          onTranslationError?.({ targetLocale: activeLocale, error: workspaceError2 });
+          return { success: false, error: workspaceError2 };
+        }
         const workspaceError = {
           type: "translation_failed",
           message: cause instanceof Error ? cause.message : String(cause),
@@ -3783,6 +3871,11 @@ function useTranslationWorkspace({
         onTranslationError?.({ targetLocale: activeLocale, error: workspaceError });
         return { success: false, error: workspaceError };
       } finally {
+        if (operationSignal !== void 0 && abortListener !== void 0) {
+          const listener = abortListener;
+          operationSignal.removeEventListener("abort", listener);
+        }
+        if (activeAbortController.current === controller) activeAbortController.current = void 0;
         setIsTranslating(false);
       }
     },
@@ -3794,14 +3887,20 @@ function useTranslationWorkspace({
       onTranslationError,
       onTranslationStart,
       onTranslationSuccess,
+      onTranslationReport,
       readOnly,
       slots,
       sourceLocale,
-      translationAdapter
+      metadataFactory,
+      translationAdapter,
+      signal
     ]
   );
+  const cancelTranslation = (0, import_react5.useCallback)(() => {
+    activeAbortController.current?.abort(new DOMException("The translation was cancelled.", "AbortError"));
+  }, []);
   const translateSlot = (0, import_react5.useCallback)(
-    async (slot) => {
+    async (slot, options = {}) => {
       if (translationAdapter === void 0) {
         const workspaceError = { type: "adapter_not_configured" };
         setError(workspaceError);
@@ -3814,10 +3913,23 @@ function useTranslationWorkspace({
       }
       setIsTranslating(true);
       setError(void 0);
+      setProgress({ total: 1, completed: 0, succeeded: 0, failed: 0, percentage: 0 });
+      const controller = new AbortController();
+      activeAbortController.current = controller;
+      const operationSignal = options.signal ?? signal;
+      const abortListener = operationSignal === void 0 ? void 0 : () => controller.abort(operationSignal.reason);
+      if (operationSignal?.aborted) controller.abort(operationSignal.reason);
+      else if (operationSignal !== void 0 && abortListener !== void 0)
+        operationSignal.addEventListener("abort", abortListener, { once: true });
       try {
-        const text = await asAsyncAdapter(translationAdapter).translateText(slot.sourceText, slot.locale, sourceLocale);
-        const metadata = translationMetadata(slot.sourceText, sourceLocale, "automatic");
-        commit(updateSchemaTranslation(currentSchema, slot, text, sourceLocale, "automatic"));
+        const text = await asAsyncAdapter(translationAdapter).translateText(
+          slot.sourceText,
+          slot.locale,
+          sourceLocale,
+          controller.signal
+        );
+        const metadata = createTranslationMetadata(slot, sourceLocale, text, "automatic", metadataFactory);
+        commit(updateSchemaTranslation(currentSchema, slot, text, sourceLocale, "automatic", metadata));
         onTranslationChange?.({
           slot,
           ...slot.existingText === void 0 ? {} : { previousText: slot.existingText },
@@ -3825,20 +3937,43 @@ function useTranslationWorkspace({
           mode: "automatic",
           metadata
         });
+        setProgress({ total: 1, completed: 1, succeeded: 1, failed: 0, percentage: 100 });
         return { success: true };
       } catch (cause) {
+        if (controller.signal.aborted || cause instanceof DOMException && cause.name === "AbortError") {
+          const workspaceError2 = { type: "cancelled" };
+          setError(workspaceError2);
+          onTranslationError?.({ targetLocale: slot.locale, error: workspaceError2 });
+          return { success: false, error: workspaceError2 };
+        }
         const workspaceError = {
           type: "translation_failed",
           message: cause instanceof Error ? cause.message : String(cause),
           cause
         };
         setError(workspaceError);
+        onTranslationError?.({ targetLocale: slot.locale, error: workspaceError });
         return { success: false, error: workspaceError };
       } finally {
+        if (operationSignal !== void 0 && abortListener !== void 0) {
+          const listener = abortListener;
+          operationSignal.removeEventListener("abort", listener);
+        }
+        if (activeAbortController.current === controller) activeAbortController.current = void 0;
         setIsTranslating(false);
       }
     },
-    [commit, currentSchema, onTranslationChange, readOnly, sourceLocale, translationAdapter]
+    [
+      commit,
+      currentSchema,
+      metadataFactory,
+      onTranslationChange,
+      onTranslationError,
+      readOnly,
+      signal,
+      sourceLocale,
+      translationAdapter
+    ]
   );
   return {
     sourceLocale,
@@ -3859,7 +3994,9 @@ function useTranslationWorkspace({
     setTranslation,
     translateAll,
     translateSlot,
+    cancelTranslation,
     isTranslating,
+    ...progress === void 0 ? {} : { progress },
     ...error === void 0 ? {} : { error }
   };
 }
@@ -3869,6 +4006,7 @@ function canonicalMetadata(metadata, sourceText, sourceLocale, translatedText) {
   if (translatedText === void 0 || translatedText.trim().length === 0) return void 0;
   if (metadata !== void 0 && typeof metadata.sourceLocale === "string" && typeof metadata.sourceTextHash === "string" && (metadata.translationSource === "automatic" || metadata.translationSource === "manual")) {
     return {
+      ...metadata,
       sourceLocale: metadata.sourceLocale,
       sourceTextHash: metadata.sourceTextHash,
       translationSource: metadata.translationSource,
@@ -3876,7 +4014,10 @@ function canonicalMetadata(metadata, sourceText, sourceLocale, translatedText) {
       ...typeof metadata.editedAt === "string" ? { editedAt: metadata.editedAt } : {}
     };
   }
+  const canonicalKeys = /* @__PURE__ */ new Set(["sourceLocale", "sourceTextHash", "translationSource", "translatedAt", "editedAt"]);
+  const extensions = Object.fromEntries(Object.entries(metadata ?? {}).filter(([key]) => !canonicalKeys.has(key)));
   return {
+    ...extensions,
     sourceLocale: typeof metadata?.sourceLocale === "string" ? metadata.sourceLocale : sourceLocale,
     sourceTextHash: (0, import_core6.computeSourceTextHash)(sourceText),
     translationSource: metadata?.isManual === true || metadata?.isManuallyEdited === true || metadata?.translationSource === "manual" ? "manual" : "automatic"
@@ -3887,6 +4028,7 @@ function optionParentId(slot) {
   return /^fields\.([^.]+)\.options\./u.exec(slot.path)?.[1];
 }
 function getNodeTitle(schema, slot) {
+  if (slot.kind === "form") return schema.title;
   if (slot.kind === "field") return schema.fields.find((field) => field.id === slot.nodeId)?.title;
   if (slot.kind === "page") return schema.pages?.find((page) => page.id === slot.nodeId)?.title;
   if (slot.kind === "option") return schema.fields.find((field) => field.id === optionParentId(slot))?.title;
@@ -3904,6 +4046,7 @@ function comparisonItem(schema, slot, sourceLocale, hasAdapter) {
   return {
     id: path,
     path,
+    nodeId: slot.nodeId,
     targetKind: slot.kind,
     targetProperty: slot.property,
     ...nodeTitle === void 0 ? {} : { nodeTitle },
@@ -3937,18 +4080,47 @@ function useTranslationComparison({
   targetLocale,
   translationAdapter,
   readOnly = false,
+  availableLocales,
+  policy,
   onChange,
-  onTranslationChange
+  onTranslationChange,
+  onTranslationReport,
+  onTranslationError,
+  signal,
+  onLocaleAdded,
+  onLocaleRemoved,
+  onLocaleChange,
+  beforeRemoveLocale,
+  confirmRemoveLocale,
+  onTranslationStart,
+  onTranslationSuccess,
+  validateLocale,
+  createTranslationMetadata: createTranslationMetadata2
 }) {
   const workspace = useTranslationWorkspace({
     schema,
     sourceLocale,
     targetLocale,
+    ...availableLocales === void 0 ? {} : { availableLocales },
+    ...policy === void 0 ? {} : { policy },
     ...translationAdapter === void 0 ? {} : { translationAdapter },
     readOnly,
     ...onChange === void 0 ? {} : { onChange },
-    ...onTranslationChange === void 0 ? {} : { onTranslationChange }
+    ...onTranslationChange === void 0 ? {} : { onTranslationChange },
+    ...onTranslationReport === void 0 ? {} : { onTranslationReport },
+    ...onTranslationError === void 0 ? {} : { onTranslationError },
+    ...signal === void 0 ? {} : { signal },
+    ...onLocaleAdded === void 0 ? {} : { onLocaleAdded },
+    ...onLocaleRemoved === void 0 ? {} : { onLocaleRemoved },
+    ...onLocaleChange === void 0 ? {} : { onLocaleChange },
+    ...beforeRemoveLocale === void 0 ? {} : { beforeRemoveLocale },
+    ...confirmRemoveLocale === void 0 ? {} : { confirmRemoveLocale },
+    ...onTranslationStart === void 0 ? {} : { onTranslationStart },
+    ...onTranslationSuccess === void 0 ? {} : { onTranslationSuccess },
+    ...validateLocale === void 0 ? {} : { validateLocale },
+    ...createTranslationMetadata2 === void 0 ? {} : { createTranslationMetadata: createTranslationMetadata2 }
   });
+  const [report, setReport] = (0, import_react6.useState)();
   const items = (0, import_react6.useMemo)(
     () => workspace.slots.map((slot) => comparisonItem(schema, slot, sourceLocale, translationAdapter !== void 0)),
     [schema, sourceLocale, translationAdapter, workspace.slots]
@@ -3970,20 +4142,37 @@ function useTranslationComparison({
     },
     [itemByPath, workspace]
   );
-  const translateAll = (0, import_react6.useCallback)(async () => {
-    const result = await workspace.translateAll();
-    if (result.report !== void 0) return result.report;
-    throw new Error(result.error?.type ?? "Translation failed.");
-  }, [workspace]);
+  const translateAll = (0, import_react6.useCallback)(
+    async (options) => {
+      const result = await workspace.translateAll(options);
+      if (result.report !== void 0) {
+        setReport(result.report);
+        return result.report;
+      }
+      throw new Error(result.error?.type ?? "Translation failed.");
+    },
+    [workspace]
+  );
   return {
     sourceLocale: workspace.sourceLocale,
     targetLocale: workspace.targetLocale,
+    targetLocales: workspace.targetLocales,
+    localeOptions: workspace.localeOptions,
+    setTargetLocale: workspace.setTargetLocale,
+    addLocale: workspace.addLocale,
+    isAddLocaleAllowed: workspace.isAddLocaleAllowed,
+    removeLocale: workspace.removeLocale,
+    ...workspace.removeLocaleConfirmation === void 0 ? {} : { removeLocaleConfirmation: workspace.removeLocaleConfirmation },
     items,
     summary: summaryFor(items),
     isTranslating: workspace.isTranslating,
     updateTranslation,
     translateSingle,
-    translateAll
+    translateAll,
+    cancelTranslation: workspace.cancelTranslation,
+    ...workspace.progress === void 0 ? {} : { progress: workspace.progress },
+    ...workspace.error === void 0 ? {} : { error: workspace.error },
+    ...report === void 0 ? {} : { report }
   };
 }