@form-engine-ts/react 6.2.0 → 6.3.0

package/README.md

@@ -97,8 +97,9 @@ 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. Comparison row slots receive locale labels, read-only state, field type,
-question and option indexes, plus async single-translation 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);
       })
     }
   };
@@ -3504,7 +3531,8 @@ function useTranslationWorkspace({
   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 ?? "");
@@ -3518,20 +3546,31 @@ function useTranslationWorkspace({
   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]
@@ -3565,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 },
@@ -3575,7 +3614,7 @@ function useTranslationWorkspace({
         metadata
       });
     },
-    [commit, currentSchema, onTranslationChange, readOnly, sourceLocale]
+    [commit, currentSchema, metadataFactory, onTranslationChange, readOnly, sourceLocale]
   );
   const addLocale = (0, import_react5.useCallback)(
     (locale) => {
@@ -3587,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,
@@ -3613,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) => {
@@ -3772,6 +3818,7 @@ function useTranslationWorkspace({
             ...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);
@@ -3844,6 +3891,7 @@ function useTranslationWorkspace({
       readOnly,
       slots,
       sourceLocale,
+      metadataFactory,
       translationAdapter,
       signal
     ]
@@ -3880,8 +3928,8 @@ function useTranslationWorkspace({
           sourceLocale,
           controller.signal
         );
-        const metadata = translationMetadata(slot.sourceText, sourceLocale, "automatic");
-        commit(updateSchemaTranslation(currentSchema, slot, text, sourceLocale, "automatic"));
+        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 },
@@ -3904,6 +3952,7 @@ function useTranslationWorkspace({
           cause
         };
         setError(workspaceError);
+        onTranslationError?.({ targetLocale: slot.locale, error: workspaceError });
         return { success: false, error: workspaceError };
       } finally {
         if (operationSignal !== void 0 && abortListener !== void 0) {
@@ -3914,7 +3963,17 @@ function useTranslationWorkspace({
         setIsTranslating(false);
       }
     },
-    [commit, currentSchema, onTranslationChange, onTranslationError, readOnly, signal, sourceLocale, translationAdapter]
+    [
+      commit,
+      currentSchema,
+      metadataFactory,
+      onTranslationChange,
+      onTranslationError,
+      readOnly,
+      signal,
+      sourceLocale,
+      translationAdapter
+    ]
   );
   return {
     sourceLocale,
@@ -3969,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;
@@ -3986,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 },
@@ -4019,23 +4080,45 @@ function useTranslationComparison({
   targetLocale,
   translationAdapter,
   readOnly = false,
+  availableLocales,
+  policy,
   onChange,
   onTranslationChange,
   onTranslationReport,
   onTranslationError,
-  signal
+  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 },
     ...onTranslationReport === void 0 ? {} : { onTranslationReport },
     ...onTranslationError === void 0 ? {} : { onTranslationError },
-    ...signal === void 0 ? {} : { signal }
+    ...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)(
@@ -4073,6 +4156,13 @@ function useTranslationComparison({
   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,

package/dist/index.d.cts

@@ -154,6 +154,11 @@ interface UseTranslationWorkspaceOptions {
         readonly error: TranslationWorkspaceError;
     }) => void;
     readonly onTranslationChange?: (event: TranslationSlotChangeEvent) => void;
+    readonly createTranslationMetadata?: (params: {
+        readonly slot: TranslationSlot;
+        readonly translatedText: string;
+        readonly mode: "manual" | "automatic";
+    }) => Readonly<Record<string, _form_engine_ts_core.JsonValue>>;
     readonly validateLocale?: ((locale: string, currentLocales: readonly string[]) => LocaleValidationResult) | CustomLocaleValidator;
 }
 interface LocaleValidationContext {
@@ -166,7 +171,7 @@ type CustomLocaleValidator = (locale: string, context: LocaleValidationContext)
 interface LocaleValidationResult {
     readonly valid: boolean;
     readonly error?: {
-        readonly type: "locale_not_allowed" | "max_locales_exceeded" | "invalid_locale_format" | "locale_already_exists" | "custom_validation_failed";
+        readonly type: "locale_not_allowed" | "max_locales_exceeded" | "invalid_locale_format" | "locale_already_exists" | "source_locale" | "custom_validation_failed";
         readonly message: string;
     };
 }
@@ -184,6 +189,9 @@ type TranslationWorkspaceError = {
 } | {
     readonly type: "locale_already_exists";
     readonly locale: string;
+} | {
+    readonly type: "source_locale";
+    readonly locale: string;
 } | {
     readonly type: "invalid_locale_format";
     readonly locale: string;
@@ -243,8 +251,8 @@ interface UseTranslationWorkspaceResult {
     readonly progress?: TranslationProgress;
     readonly error?: TranslationWorkspaceError;
 }
-declare const validateLocalePipeline: (locale: string, schema: FormSchema, policy?: FormPolicy, customValidator?: ((locale: string, currentLocales: readonly string[]) => LocaleValidationResult) | CustomLocaleValidator, availableLocales?: readonly (string | LocaleOption)[]) => LocaleValidationResult;
-declare function useTranslationWorkspace({ schema, onChange, sourceLocale, targetLocale, translationAdapter, signal, readOnly, policy, availableLocales, onLocaleAdded, onLocaleRemoved, onLocaleChange, beforeRemoveLocale, confirmRemoveLocale, slots: workspaceSlots, onTranslationStart, onTranslationSuccess, onTranslationReport, onTranslationError, onTranslationChange, validateLocale }: UseTranslationWorkspaceOptions): UseTranslationWorkspaceResult;
+declare const validateLocalePipeline: (locale: string, schema: FormSchema, policy?: FormPolicy, customValidator?: ((locale: string, currentLocales: readonly string[]) => LocaleValidationResult) | CustomLocaleValidator, availableLocales?: readonly (string | LocaleOption)[], sourceLocale?: string) => LocaleValidationResult;
+declare function useTranslationWorkspace({ schema, onChange, sourceLocale, targetLocale, translationAdapter, signal, readOnly, policy, availableLocales, onLocaleAdded, onLocaleRemoved, onLocaleChange, beforeRemoveLocale, confirmRemoveLocale, slots: workspaceSlots, onTranslationStart, onTranslationSuccess, onTranslationReport, onTranslationError, onTranslationChange, validateLocale, createTranslationMetadata: metadataFactory }: UseTranslationWorkspaceOptions): UseTranslationWorkspaceResult;
 
 interface SubmissionReceipt {
     readonly formId: string;
@@ -529,6 +537,7 @@ interface TranslationSlotRowProps {
 interface TranslationComparisonItem {
     readonly id: string;
     readonly path: string;
+    readonly nodeId?: string;
     readonly targetKind: "form" | "page" | "field" | "option";
     readonly targetProperty: "title" | "description" | "label" | "completionMessage";
     readonly nodeTitle?: string;
@@ -558,6 +567,7 @@ interface TranslationComparisonHeaderProps {
 }
 interface TranslationComparisonItemRowProps {
     readonly item: TranslationComparisonItem;
+    readonly nodeKind?: "form" | "page" | "field" | "option";
     readonly questionIndex?: number;
     readonly fieldType?: string;
     readonly optionIndex?: number;
@@ -571,6 +581,8 @@ interface UseTranslationComparisonOptions {
     readonly schema: FormSchema;
     readonly sourceLocale?: string;
     readonly targetLocale: string;
+    readonly availableLocales?: readonly (string | LocaleOption)[];
+    readonly policy?: FormPolicy;
     readonly translationAdapter?: TranslationAdapter | AsyncTranslationAdapter;
     readonly signal?: AbortSignal;
     readonly readOnly?: boolean;
@@ -581,10 +593,31 @@ interface UseTranslationComparisonOptions {
         readonly targetLocale: string;
         readonly error: TranslationWorkspaceError;
     }) => void;
+    readonly onLocaleAdded?: (locale: string) => void;
+    readonly onLocaleRemoved?: (locale: string) => void;
+    readonly onLocaleChange?: (locale: string) => void;
+    readonly beforeRemoveLocale?: (locale: string, context: {
+        readonly slotCount: number;
+    }) => Promise<boolean> | boolean;
+    readonly confirmRemoveLocale?: (props: ConfirmRemoveLocaleSlotProps) => ReactNode;
+    readonly onTranslationStart?: (params: {
+        readonly targetLocale: string;
+        readonly mode: "manual" | "automatic";
+    }) => void;
+    readonly onTranslationSuccess?: (payload: TranslationEventPayload) => void;
+    readonly validateLocale?: UseTranslationWorkspaceOptions["validateLocale"];
+    readonly createTranslationMetadata?: UseTranslationWorkspaceOptions["createTranslationMetadata"];
 }
 interface UseTranslationComparisonResult {
     readonly sourceLocale: string;
     readonly targetLocale: string;
+    readonly targetLocales: readonly string[];
+    readonly localeOptions: readonly LocaleOption[];
+    readonly setTargetLocale: (locale: string) => void;
+    readonly addLocale: UseTranslationWorkspaceResult["addLocale"];
+    readonly isAddLocaleAllowed: UseTranslationWorkspaceResult["isAddLocaleAllowed"];
+    readonly removeLocale: UseTranslationWorkspaceResult["removeLocale"];
+    readonly removeLocaleConfirmation?: ReactNode;
     readonly items: readonly TranslationComparisonItem[];
     readonly summary: TranslationComparisonSummary;
     readonly isTranslating: boolean;
@@ -962,7 +995,7 @@ interface FieldState {
 }
 declare function useField(fieldId: string): FieldState;
 
-declare function useTranslationComparison({ schema, sourceLocale, targetLocale, translationAdapter, readOnly, onChange, onTranslationChange, onTranslationReport, onTranslationError, signal }: UseTranslationComparisonOptions): UseTranslationComparisonResult;
+declare function useTranslationComparison({ schema, sourceLocale, targetLocale, translationAdapter, readOnly, availableLocales, policy, onChange, onTranslationChange, onTranslationReport, onTranslationError, signal, onLocaleAdded, onLocaleRemoved, onLocaleChange, beforeRemoveLocale, confirmRemoveLocale, onTranslationStart, onTranslationSuccess, validateLocale, createTranslationMetadata }: UseTranslationComparisonOptions): UseTranslationComparisonResult;
 
 declare const BUILDER_TRANSLATION_KEYS: {
     readonly ADD_FIELD: "builder.actions.addField";

package/dist/index.d.ts

@@ -154,6 +154,11 @@ interface UseTranslationWorkspaceOptions {
         readonly error: TranslationWorkspaceError;
     }) => void;
     readonly onTranslationChange?: (event: TranslationSlotChangeEvent) => void;
+    readonly createTranslationMetadata?: (params: {
+        readonly slot: TranslationSlot;
+        readonly translatedText: string;
+        readonly mode: "manual" | "automatic";
+    }) => Readonly<Record<string, _form_engine_ts_core.JsonValue>>;
     readonly validateLocale?: ((locale: string, currentLocales: readonly string[]) => LocaleValidationResult) | CustomLocaleValidator;
 }
 interface LocaleValidationContext {
@@ -166,7 +171,7 @@ type CustomLocaleValidator = (locale: string, context: LocaleValidationContext)
 interface LocaleValidationResult {
     readonly valid: boolean;
     readonly error?: {
-        readonly type: "locale_not_allowed" | "max_locales_exceeded" | "invalid_locale_format" | "locale_already_exists" | "custom_validation_failed";
+        readonly type: "locale_not_allowed" | "max_locales_exceeded" | "invalid_locale_format" | "locale_already_exists" | "source_locale" | "custom_validation_failed";
         readonly message: string;
     };
 }
@@ -184,6 +189,9 @@ type TranslationWorkspaceError = {
 } | {
     readonly type: "locale_already_exists";
     readonly locale: string;
+} | {
+    readonly type: "source_locale";
+    readonly locale: string;
 } | {
     readonly type: "invalid_locale_format";
     readonly locale: string;
@@ -243,8 +251,8 @@ interface UseTranslationWorkspaceResult {
     readonly progress?: TranslationProgress;
     readonly error?: TranslationWorkspaceError;
 }
-declare const validateLocalePipeline: (locale: string, schema: FormSchema, policy?: FormPolicy, customValidator?: ((locale: string, currentLocales: readonly string[]) => LocaleValidationResult) | CustomLocaleValidator, availableLocales?: readonly (string | LocaleOption)[]) => LocaleValidationResult;
-declare function useTranslationWorkspace({ schema, onChange, sourceLocale, targetLocale, translationAdapter, signal, readOnly, policy, availableLocales, onLocaleAdded, onLocaleRemoved, onLocaleChange, beforeRemoveLocale, confirmRemoveLocale, slots: workspaceSlots, onTranslationStart, onTranslationSuccess, onTranslationReport, onTranslationError, onTranslationChange, validateLocale }: UseTranslationWorkspaceOptions): UseTranslationWorkspaceResult;
+declare const validateLocalePipeline: (locale: string, schema: FormSchema, policy?: FormPolicy, customValidator?: ((locale: string, currentLocales: readonly string[]) => LocaleValidationResult) | CustomLocaleValidator, availableLocales?: readonly (string | LocaleOption)[], sourceLocale?: string) => LocaleValidationResult;
+declare function useTranslationWorkspace({ schema, onChange, sourceLocale, targetLocale, translationAdapter, signal, readOnly, policy, availableLocales, onLocaleAdded, onLocaleRemoved, onLocaleChange, beforeRemoveLocale, confirmRemoveLocale, slots: workspaceSlots, onTranslationStart, onTranslationSuccess, onTranslationReport, onTranslationError, onTranslationChange, validateLocale, createTranslationMetadata: metadataFactory }: UseTranslationWorkspaceOptions): UseTranslationWorkspaceResult;
 
 interface SubmissionReceipt {
     readonly formId: string;
@@ -529,6 +537,7 @@ interface TranslationSlotRowProps {
 interface TranslationComparisonItem {
     readonly id: string;
     readonly path: string;
+    readonly nodeId?: string;
     readonly targetKind: "form" | "page" | "field" | "option";
     readonly targetProperty: "title" | "description" | "label" | "completionMessage";
     readonly nodeTitle?: string;
@@ -558,6 +567,7 @@ interface TranslationComparisonHeaderProps {
 }
 interface TranslationComparisonItemRowProps {
     readonly item: TranslationComparisonItem;
+    readonly nodeKind?: "form" | "page" | "field" | "option";
     readonly questionIndex?: number;
     readonly fieldType?: string;
     readonly optionIndex?: number;
@@ -571,6 +581,8 @@ interface UseTranslationComparisonOptions {
     readonly schema: FormSchema;
     readonly sourceLocale?: string;
     readonly targetLocale: string;
+    readonly availableLocales?: readonly (string | LocaleOption)[];
+    readonly policy?: FormPolicy;
     readonly translationAdapter?: TranslationAdapter | AsyncTranslationAdapter;
     readonly signal?: AbortSignal;
     readonly readOnly?: boolean;
@@ -581,10 +593,31 @@ interface UseTranslationComparisonOptions {
         readonly targetLocale: string;
         readonly error: TranslationWorkspaceError;
     }) => void;
+    readonly onLocaleAdded?: (locale: string) => void;
+    readonly onLocaleRemoved?: (locale: string) => void;
+    readonly onLocaleChange?: (locale: string) => void;
+    readonly beforeRemoveLocale?: (locale: string, context: {
+        readonly slotCount: number;
+    }) => Promise<boolean> | boolean;
+    readonly confirmRemoveLocale?: (props: ConfirmRemoveLocaleSlotProps) => ReactNode;
+    readonly onTranslationStart?: (params: {
+        readonly targetLocale: string;
+        readonly mode: "manual" | "automatic";
+    }) => void;
+    readonly onTranslationSuccess?: (payload: TranslationEventPayload) => void;
+    readonly validateLocale?: UseTranslationWorkspaceOptions["validateLocale"];
+    readonly createTranslationMetadata?: UseTranslationWorkspaceOptions["createTranslationMetadata"];
 }
 interface UseTranslationComparisonResult {
     readonly sourceLocale: string;
     readonly targetLocale: string;
+    readonly targetLocales: readonly string[];
+    readonly localeOptions: readonly LocaleOption[];
+    readonly setTargetLocale: (locale: string) => void;
+    readonly addLocale: UseTranslationWorkspaceResult["addLocale"];
+    readonly isAddLocaleAllowed: UseTranslationWorkspaceResult["isAddLocaleAllowed"];
+    readonly removeLocale: UseTranslationWorkspaceResult["removeLocale"];
+    readonly removeLocaleConfirmation?: ReactNode;
     readonly items: readonly TranslationComparisonItem[];
     readonly summary: TranslationComparisonSummary;
     readonly isTranslating: boolean;
@@ -962,7 +995,7 @@ interface FieldState {
 }
 declare function useField(fieldId: string): FieldState;
 
-declare function useTranslationComparison({ schema, sourceLocale, targetLocale, translationAdapter, readOnly, onChange, onTranslationChange, onTranslationReport, onTranslationError, signal }: UseTranslationComparisonOptions): UseTranslationComparisonResult;
+declare function useTranslationComparison({ schema, sourceLocale, targetLocale, translationAdapter, readOnly, availableLocales, policy, onChange, onTranslationChange, onTranslationReport, onTranslationError, signal, onLocaleAdded, onLocaleRemoved, onLocaleChange, beforeRemoveLocale, confirmRemoveLocale, onTranslationStart, onTranslationSuccess, validateLocale, createTranslationMetadata }: UseTranslationComparisonOptions): UseTranslationComparisonResult;
 
 declare const BUILDER_TRANSLATION_KEYS: {
     readonly ADD_FIELD: "builder.actions.addField";

package/dist/index.js

@@ -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);
       })
     }
   };
@@ -3480,7 +3507,8 @@ function useTranslationWorkspace({
   onTranslationReport,
   onTranslationError,
   onTranslationChange,
-  validateLocale
+  validateLocale,
+  createTranslationMetadata: metadataFactory
 }) {
   const [draftSchema, setDraftSchema] = useState4(schema);
   const [selectedLocale, setSelectedLocale] = useState4(normalizeLocale(targetLocale ?? "") ?? targetLocale ?? "");
@@ -3494,20 +3522,31 @@ function useTranslationWorkspace({
   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]
@@ -3541,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 },
@@ -3551,7 +3590,7 @@ function useTranslationWorkspace({
         metadata
       });
     },
-    [commit, currentSchema, onTranslationChange, readOnly, sourceLocale]
+    [commit, currentSchema, metadataFactory, onTranslationChange, readOnly, sourceLocale]
   );
   const addLocale = useCallback3(
     (locale) => {
@@ -3563,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,
@@ -3589,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) => {
@@ -3748,6 +3794,7 @@ function useTranslationWorkspace({
             ...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);
@@ -3820,6 +3867,7 @@ function useTranslationWorkspace({
       readOnly,
       slots,
       sourceLocale,
+      metadataFactory,
       translationAdapter,
       signal
     ]
@@ -3856,8 +3904,8 @@ function useTranslationWorkspace({
           sourceLocale,
           controller.signal
         );
-        const metadata = translationMetadata(slot.sourceText, sourceLocale, "automatic");
-        commit(updateSchemaTranslation(currentSchema, slot, text, sourceLocale, "automatic"));
+        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 },
@@ -3880,6 +3928,7 @@ function useTranslationWorkspace({
           cause
         };
         setError(workspaceError);
+        onTranslationError?.({ targetLocale: slot.locale, error: workspaceError });
         return { success: false, error: workspaceError };
       } finally {
         if (operationSignal !== void 0 && abortListener !== void 0) {
@@ -3890,7 +3939,17 @@ function useTranslationWorkspace({
         setIsTranslating(false);
       }
     },
-    [commit, currentSchema, onTranslationChange, onTranslationError, readOnly, signal, sourceLocale, translationAdapter]
+    [
+      commit,
+      currentSchema,
+      metadataFactory,
+      onTranslationChange,
+      onTranslationError,
+      readOnly,
+      signal,
+      sourceLocale,
+      translationAdapter
+    ]
   );
   return {
     sourceLocale,
@@ -3945,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;
@@ -3962,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 },
@@ -3995,23 +4056,45 @@ function useTranslationComparison({
   targetLocale,
   translationAdapter,
   readOnly = false,
+  availableLocales,
+  policy,
   onChange,
   onTranslationChange,
   onTranslationReport,
   onTranslationError,
-  signal
+  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 },
     ...onTranslationReport === void 0 ? {} : { onTranslationReport },
     ...onTranslationError === void 0 ? {} : { onTranslationError },
-    ...signal === void 0 ? {} : { signal }
+    ...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(
@@ -4049,6 +4132,13 @@ function useTranslationComparison({
   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,

package/package.json

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