@form-engine-ts/react 6.1.0 → 6.3.0

package/dist/index.js

@@ -3274,7 +3274,7 @@ function useField(fieldId) {
 
 // src/hooks/useTranslationComparison.ts
 import { computeSourceTextHash as computeSourceTextHash2 } from "@form-engine-ts/core";
-import { useCallback as useCallback4, useMemo as useMemo5 } from "react";
+import { useCallback as useCallback4, useMemo as useMemo5, useState as useState5 } from "react";
 
 // src/hooks/useTranslationWorkspace.ts
 import {
@@ -3301,7 +3301,7 @@ function asAsyncAdapter(adapter) {
     )
   };
 }
-var validateLocalePipeline = (locale, schema, policy, customValidator, availableLocales) => {
+var validateLocalePipeline = (locale, schema, policy, customValidator, availableLocales, sourceLocale) => {
   const canonicalLocale = normalizeLocale(locale);
   if (canonicalLocale === null) {
     return {
@@ -3313,20 +3313,17 @@ var validateLocalePipeline = (locale, schema, policy, customValidator, available
     };
   }
   const currentLocales = (schema.supportedLocales ?? []).map((candidate) => normalizeLocale(candidate) ?? candidate);
-  const defaultLocale = schema.defaultLocale === void 0 ? "" : normalizeLocale(schema.defaultLocale) ?? schema.defaultLocale;
-  if (availableLocales !== void 0 && !availableLocales.some((candidate) => {
-    const value = typeof candidate === "string" ? candidate : candidate.locale;
-    return normalizeLocale(value) === canonicalLocale;
-  })) {
+  const defaultLocale = 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: {
@@ -3335,6 +3332,18 @@ var validateLocalePipeline = (locale, schema, policy, customValidator, available
       }
     };
   }
+  if (availableLocales !== void 0 && !availableLocales.some((candidate) => {
+    const value = typeof candidate === "string" ? candidate : candidate.locale;
+    return 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) => normalizeLocale(candidate) === canonicalLocale)) {
     return {
       valid: false,
@@ -3388,6 +3397,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 };
   }
@@ -3405,19 +3415,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") {
@@ -3426,7 +3446,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
+        );
       })
     };
   }
@@ -3442,7 +3469,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);
           })
         };
       })
@@ -3454,7 +3481,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);
       })
     }
   };
@@ -3465,6 +3492,7 @@ function useTranslationWorkspace({
   sourceLocale = schema.defaultLocale ?? "en",
   targetLocale,
   translationAdapter,
+  signal,
   readOnly = false,
   policy,
   availableLocales,
@@ -3476,34 +3504,49 @@ function useTranslationWorkspace({
   slots: workspaceSlots,
   onTranslationStart,
   onTranslationSuccess,
+  onTranslationReport,
   onTranslationError,
   onTranslationChange,
-  validateLocale
+  validateLocale,
+  createTranslationMetadata: metadataFactory
 }) {
   const [draftSchema, setDraftSchema] = useState4(schema);
   const [selectedLocale, setSelectedLocale] = useState4(normalizeLocale(targetLocale ?? "") ?? targetLocale ?? "");
   const [isTranslating, setIsTranslating] = useState4(false);
+  const [progress, setProgress] = useState4();
   const [error, setError] = useState4();
   const [pendingRemoval, setPendingRemoval] = useState4();
+  const activeAbortController = useRef2(void 0);
   const pendingRemovalResolver = useRef2(void 0);
   const currentSchema = onChange === void 0 ? draftSchema : schema;
   const confirmRemoveLocaleRenderer = confirmRemoveLocale ?? workspaceSlots?.confirmRemoveLocale;
   const targetLocales = useMemo4(() => {
     const locales = collectSchemaLocales2(currentSchema).allUniqueLocales;
-    return [.../* @__PURE__ */ new Set([...currentSchema.supportedLocales ?? [], ...locales])].filter(
-      (locale) => locale !== sourceLocale
-    );
+    const normalizedSourceLocale = normalizeLocale(sourceLocale) ?? sourceLocale;
+    return [
+      ...new Set(
+        [...currentSchema.supportedLocales ?? [], ...locales].map((locale) => normalizeLocale(locale) ?? locale)
+      )
+    ].filter((locale) => locale !== normalizedSourceLocale);
   }, [currentSchema, sourceLocale]);
   const activeLocale = selectedLocale.length > 0 ? selectedLocale : targetLocales[0] ?? "";
   const localeOptions = useMemo4(() => {
     if (availableLocales === void 0) {
       return targetLocales.map((locale) => ({ locale, label: locale }));
     }
-    return availableLocales.map((candidate) => {
-      if (typeof candidate !== "string") return candidate;
-      return { locale: normalizeLocale(candidate) ?? candidate, label: candidate };
-    });
-  }, [availableLocales, targetLocales]);
+    const targetLocaleSet = new Set(targetLocales);
+    const allowedLocales = policy?.allowedLocales?.map((locale) => normalizeLocale(locale) ?? locale);
+    const options = /* @__PURE__ */ new Map();
+    for (const candidate of availableLocales) {
+      const option = typeof candidate === "string" ? { locale: normalizeLocale(candidate) ?? candidate, label: candidate } : { ...candidate, locale: 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 = useMemo4(
     () => activeLocale.length === 0 ? [] : collectTranslationSlots(currentSchema, activeLocale),
     [activeLocale, currentSchema]
@@ -3537,8 +3580,8 @@ function useTranslationWorkspace({
   const setTranslation = useCallback3(
     (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 },
@@ -3547,7 +3590,7 @@ function useTranslationWorkspace({
         metadata
       });
     },
-    [commit, currentSchema, onTranslationChange, readOnly, sourceLocale]
+    [commit, currentSchema, metadataFactory, onTranslationChange, readOnly, sourceLocale]
   );
   const addLocale = useCallback3(
     (locale) => {
@@ -3559,14 +3602,21 @@ function useTranslationWorkspace({
       const normalized = normalizeLocale(locale);
       if (normalized === null) {
         const workspaceError = workspaceLocaleValidationError(
-          validateLocalePipeline(locale, currentSchema, policy, validateLocale, availableLocales),
+          validateLocalePipeline(locale, currentSchema, policy, validateLocale, availableLocales, sourceLocale),
           collectSchemaLocales2(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,
@@ -3585,16 +3635,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 = useCallback3(
     (locale) => {
       if (readOnly) return false;
       const normalized = 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 = useCallback3(
     (locale) => {
@@ -3724,7 +3774,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 populateSchemaTranslations2(
           currentSchema,
@@ -3733,13 +3791,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 = 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,
@@ -3750,6 +3832,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),
@@ -3759,6 +3847,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);
       }
     },
@@ -3770,14 +3863,20 @@ function useTranslationWorkspace({
       onTranslationError,
       onTranslationStart,
       onTranslationSuccess,
+      onTranslationReport,
       readOnly,
       slots,
       sourceLocale,
-      translationAdapter
+      metadataFactory,
+      translationAdapter,
+      signal
     ]
   );
+  const cancelTranslation = useCallback3(() => {
+    activeAbortController.current?.abort(new DOMException("The translation was cancelled.", "AbortError"));
+  }, []);
   const translateSlot = useCallback3(
-    async (slot) => {
+    async (slot, options = {}) => {
       if (translationAdapter === void 0) {
         const workspaceError = { type: "adapter_not_configured" };
         setError(workspaceError);
@@ -3790,10 +3889,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 },
@@ -3801,20 +3913,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,
@@ -3835,7 +3970,9 @@ function useTranslationWorkspace({
     setTranslation,
     translateAll,
     translateSlot,
+    cancelTranslation,
     isTranslating,
+    ...progress === void 0 ? {} : { progress },
     ...error === void 0 ? {} : { error }
   };
 }
@@ -3845,6 +3982,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,
@@ -3852,7 +3990,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: computeSourceTextHash2(sourceText),
     translationSource: metadata?.isManual === true || metadata?.isManuallyEdited === true || metadata?.translationSource === "manual" ? "manual" : "automatic"
@@ -3863,6 +4004,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;
@@ -3880,6 +4022,7 @@ function comparisonItem(schema, slot, sourceLocale, hasAdapter) {
   return {
     id: path,
     path,
+    nodeId: slot.nodeId,
     targetKind: slot.kind,
     targetProperty: slot.property,
     ...nodeTitle === void 0 ? {} : { nodeTitle },
@@ -3913,18 +4056,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] = useState5();
   const items = useMemo5(
     () => workspace.slots.map((slot) => comparisonItem(schema, slot, sourceLocale, translationAdapter !== void 0)),
     [schema, sourceLocale, translationAdapter, workspace.slots]
@@ -3946,25 +4118,42 @@ function useTranslationComparison({
     },
     [itemByPath, workspace]
   );
-  const translateAll = useCallback4(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 = useCallback4(
+    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 }
   };
 }
 
 // src/receipt.ts
-import { useEffect as useEffect2, useMemo as useMemo6, useState as useState5 } from "react";
+import { useEffect as useEffect2, useMemo as useMemo6, useState as useState6 } from "react";
 function submissionReceiptQueryKey(formId, formVersion) {
   return `${formId}:v${formVersion}`;
 }
@@ -4042,7 +4231,7 @@ function useSubmissionReceipts(store, queries) {
       (entry) => Array.isArray(entry) && typeof entry[0] === "string" && typeof entry[1] === "number" && Number.isSafeInteger(entry[1]) ? [{ formId: entry[0], formVersion: entry[1] }] : []
     );
   }, [querySignature]);
-  const [state, setState] = useState5({
+  const [state, setState] = useState6({
     receipts: /* @__PURE__ */ new Map(),
     isLoading: stableQueries.length > 0,
     error: null
@@ -4095,7 +4284,7 @@ import {
   useId,
   useMemo as useMemo7,
   useRef as useRef3,
-  useState as useState6
+  useState as useState7
 } from "react";
 import { Fragment as Fragment3, jsx as jsx4, jsxs as jsxs2 } from "react/jsx-runtime";
 var isChoiceFieldType = (type) => type === "radio" || type === "checkbox" || type === "multi-select" || type === "select";
@@ -4612,15 +4801,15 @@ function ContextFormRenderer({
   const prefix = useId().replace(/:/g, "");
   const formRef = useRef3(null);
   const loadedDraftKey = useRef3(null);
-  const [draftRestored, setDraftRestored] = useState6(false);
-  const [currentPageIndex, setCurrentPageIndex] = useState6(0);
-  const [focusFieldId, setFocusFieldId] = useState6(null);
-  const [confirmation, setConfirmation] = useState6(null);
-  const [guardMessage, setGuardMessage] = useState6(null);
-  const [guardsPending, setGuardsPending] = useState6(false);
-  const [receipt, setReceipt] = useState6(null);
-  const [completionData, setCompletionData] = useState6(null);
-  const [receiptLoaded, setReceiptLoaded] = useState6(receiptStore === void 0);
+  const [draftRestored, setDraftRestored] = useState7(false);
+  const [currentPageIndex, setCurrentPageIndex] = useState7(0);
+  const [focusFieldId, setFocusFieldId] = useState7(null);
+  const [confirmation, setConfirmation] = useState7(null);
+  const [guardMessage, setGuardMessage] = useState7(null);
+  const [guardsPending, setGuardsPending] = useState7(false);
+  const [receipt, setReceipt] = useState7(null);
+  const [completionData, setCompletionData] = useState7(null);
+  const [receiptLoaded, setReceiptLoaded] = useState7(receiptStore === void 0);
   const rendererSubmissionInFlight = useRef3(false);
   const fallbackAttemptId = useRef3(null);
   const completionRef = useRef3(null);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@form-engine-ts/react",
-  "version": "6.1.0",
+  "version": "6.3.0",
   "publishConfig": {
     "access": "public"
   },
@@ -42,8 +42,8 @@
     "typescript"
   ],
   "dependencies": {
-    "@form-engine-ts/privacy": "6.1.0",
-    "@form-engine-ts/core": "6.1.0"
+    "@form-engine-ts/core": "6.3.0",
+    "@form-engine-ts/privacy": "6.3.0"
   },
   "peerDependencies": {
     "react": ">=18.2 <20",