@form-engine-ts/react 5.1.0 → 6.0.0

package/README.md

@@ -89,6 +89,10 @@ 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.
+
 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

@@ -3421,26 +3421,27 @@ function workspaceLocaleValidationError(validation, currentLocales, requestedLoc
   }
   return { type: "custom_validation_failed", message: error.message };
 }
-function manualMetadata(sourceText, sourceLocale) {
+function translationMetadata(sourceText, sourceLocale, mode) {
   return {
     sourceLocale,
     sourceTextHash: (0, import_core5.computeSourceTextHash)(sourceText),
-    translationSource: "manual",
-    editedAt: (/* @__PURE__ */ new Date()).toISOString()
+    translationSource: mode,
+    ...mode === "manual" ? { editedAt: (/* @__PURE__ */ new Date()).toISOString() } : { translatedAt: (/* @__PURE__ */ new Date()).toISOString() }
   };
 }
-function setNodeMetadata(node, slot, text, sourceLocale) {
+function setNodeMetadata(node, slot, text, sourceLocale, mode) {
   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]: manualMetadata(slot.sourceText, sourceLocale) };
+  const nextMetadata = text.trim().length === 0 ? Object.fromEntries(Object.entries(localeMetadata ?? {}).filter(([key]) => key !== slot.property)) : { ...localeMetadata, [slot.property]: translationMetadata(slot.sourceText, sourceLocale, mode) };
   return { ...node, translationMetadata: { ...node.translationMetadata, [slot.locale]: nextMetadata } };
 }
-function updateSchemaTranslation(schema, slot, text, sourceLocale) {
+function updateSchemaTranslation(schema, slot, text, sourceLocale, mode = "manual") {
   if (slot.kind === "form") {
     return setNodeMetadata(
       { ...schema, translations: updateTranslationMap(schema.translations, slot.locale, slot.property, text) },
       slot,
       text,
-      sourceLocale
+      sourceLocale,
+      mode
     );
   }
   if (slot.kind === "field") {
@@ -3449,7 +3450,7 @@ function updateSchemaTranslation(schema, slot, text, sourceLocale) {
       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);
+        return setNodeMetadata({ ...field, translations }, slot, text, sourceLocale, mode);
       })
     };
   }
@@ -3465,7 +3466,7 @@ function updateSchemaTranslation(schema, slot, text, sourceLocale) {
             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);
+            return setNodeMetadata({ ...option, translations }, slot, text, sourceLocale, mode);
           })
         };
       })
@@ -3477,7 +3478,7 @@ function updateSchemaTranslation(schema, slot, text, sourceLocale) {
       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);
+        return setNodeMetadata({ ...page, translations }, slot, text, sourceLocale, mode);
       })
     }
   };
@@ -3495,13 +3496,22 @@ function useTranslationWorkspace({
   onLocaleRemoved,
   onLocaleChange,
   beforeRemoveLocale,
+  confirmRemoveLocale,
+  slots: workspaceSlots,
+  onTranslationStart,
+  onTranslationSuccess,
+  onTranslationError,
+  onTranslationChange,
   validateLocale
 }) {
   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 [error, setError] = (0, import_react5.useState)();
+  const [pendingRemoval, setPendingRemoval] = (0, import_react5.useState)();
+  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(
@@ -3551,9 +3561,17 @@ function useTranslationWorkspace({
   const setTranslation = (0, import_react5.useCallback)(
     (slot, text) => {
       if (readOnly) return;
-      commit(updateSchemaTranslation(currentSchema, slot, text, sourceLocale));
+      const metadata = translationMetadata(slot.sourceText, sourceLocale, "manual");
+      commit(updateSchemaTranslation(currentSchema, slot, text, sourceLocale, "manual"));
+      onTranslationChange?.({
+        slot,
+        ...slot.existingText === void 0 ? {} : { previousText: slot.existingText },
+        nextText: text,
+        mode: "manual",
+        metadata
+      });
     },
-    [commit, currentSchema, readOnly, sourceLocale]
+    [commit, currentSchema, onTranslationChange, readOnly, sourceLocale]
   );
   const addLocale = (0, import_react5.useCallback)(
     (locale) => {
@@ -3614,21 +3632,36 @@ function useTranslationWorkspace({
         onLocaleRemoved?.(normalized);
       };
       const slotCount = (0, import_core5.collectTranslationSlots)(currentSchema, normalized).length;
+      const translatedSlotsCount = (0, import_core5.collectTranslationSlots)(currentSchema, normalized).filter(
+        (slot) => slot.existingText !== void 0 && slot.existingText.trim().length > 0
+      ).length;
+      const requestConfirmation = () => new Promise((resolve) => {
+        pendingRemovalResolver.current = resolve;
+        setPendingRemoval({
+          locale: normalized,
+          localeLabel: localeOptions.find((option) => option.locale === normalized)?.label ?? normalized,
+          translatedSlotsCount
+        });
+      });
+      const removeAfterApproval = () => {
+        if (confirmRemoveLocaleRenderer === void 0) {
+          remove();
+          return true;
+        }
+        return requestConfirmation();
+      };
       if (beforeRemoveLocale === void 0) {
-        remove();
-        return true;
+        return removeAfterApproval();
       }
       try {
         const decision = beforeRemoveLocale(normalized, { slotCount });
         if (typeof decision === "boolean") {
           if (!decision) return false;
-          remove();
-          return true;
+          return removeAfterApproval();
         }
         return decision.then((allowed) => {
           if (!allowed) return false;
-          remove();
-          return true;
+          return removeAfterApproval();
         });
       } catch (cause) {
         const workspaceError = {
@@ -3640,8 +3673,45 @@ function useTranslationWorkspace({
         return Promise.reject(cause);
       }
     },
-    [activeLocale, beforeRemoveLocale, commit, currentSchema, onLocaleRemoved, readOnly, sourceLocale]
+    [
+      activeLocale,
+      beforeRemoveLocale,
+      commit,
+      confirmRemoveLocaleRenderer,
+      currentSchema,
+      localeOptions,
+      onLocaleRemoved,
+      readOnly,
+      sourceLocale
+    ]
   );
+  const confirmPendingRemoval = (0, import_react5.useCallback)(() => {
+    const pending = pendingRemoval;
+    const resolve = pendingRemovalResolver.current;
+    if (pending === void 0 || resolve === void 0) return;
+    pendingRemovalResolver.current = void 0;
+    setPendingRemoval(void 0);
+    commit((0, import_core5.removeLocaleFromSchema)(currentSchema, pending.locale));
+    if (activeLocale === pending.locale) setSelectedLocale("");
+    onLocaleRemoved?.(pending.locale);
+    resolve(true);
+  }, [activeLocale, commit, currentSchema, onLocaleRemoved, pendingRemoval]);
+  const cancelPendingRemoval = (0, import_react5.useCallback)(() => {
+    const resolve = pendingRemovalResolver.current;
+    if (resolve === void 0) return;
+    pendingRemovalResolver.current = void 0;
+    setPendingRemoval(void 0);
+    resolve(false);
+  }, []);
+  const removeLocaleConfirmation = (0, import_react5.useMemo)(() => {
+    if (confirmRemoveLocaleRenderer === void 0 || pendingRemoval === void 0) return null;
+    return confirmRemoveLocaleRenderer({
+      ...pendingRemoval,
+      isOpen: true,
+      onConfirm: confirmPendingRemoval,
+      onCancel: cancelPendingRemoval
+    });
+  }, [cancelPendingRemoval, confirmPendingRemoval, confirmRemoveLocaleRenderer, pendingRemoval]);
   const translateAll = (0, import_react5.useCallback)(
     async (options = {}) => {
       if (readOnly) {
@@ -3678,6 +3748,7 @@ function useTranslationWorkspace({
       }
       setIsTranslating(true);
       setError(void 0);
+      onTranslationStart?.({ targetLocale: activeLocale, mode: "automatic" });
       try {
         const populated = await (0, import_core5.populateSchemaTranslations)(
           currentSchema,
@@ -3690,6 +3761,17 @@ function useTranslationWorkspace({
           }
         );
         commit(populated.schema);
+        const missingSlotsCount = (0, import_core5.collectTranslationSlots)(populated.schema, activeLocale).filter(
+          (slot) => slot.status === "missing"
+        ).length;
+        onTranslationSuccess?.({
+          sourceLocale,
+          targetLocale: activeLocale,
+          mode: "automatic",
+          updatedSlots: populated.report.updatedSlots,
+          skippedSlots: populated.report.skippedSlots,
+          missingSlotsCount
+        });
         return { success: true, report: populated.report };
       } catch (cause) {
         const workspaceError = {
@@ -3698,12 +3780,25 @@ function useTranslationWorkspace({
           cause
         };
         setError(workspaceError);
+        onTranslationError?.({ targetLocale: activeLocale, error: workspaceError });
         return { success: false, error: workspaceError };
       } finally {
         setIsTranslating(false);
       }
     },
-    [activeLocale, commit, currentSchema, localeOptions, readOnly, slots, translationAdapter]
+    [
+      activeLocale,
+      commit,
+      currentSchema,
+      localeOptions,
+      onTranslationError,
+      onTranslationStart,
+      onTranslationSuccess,
+      readOnly,
+      slots,
+      sourceLocale,
+      translationAdapter
+    ]
   );
   const translateSlot = (0, import_react5.useCallback)(
     async (slot) => {
@@ -3721,7 +3816,15 @@ function useTranslationWorkspace({
       setError(void 0);
       try {
         const text = await asAsyncAdapter(translationAdapter).translateText(slot.sourceText, slot.locale, sourceLocale);
-        commit(updateSchemaTranslation(currentSchema, slot, text, sourceLocale));
+        const metadata = translationMetadata(slot.sourceText, sourceLocale, "automatic");
+        commit(updateSchemaTranslation(currentSchema, slot, text, sourceLocale, "automatic"));
+        onTranslationChange?.({
+          slot,
+          ...slot.existingText === void 0 ? {} : { previousText: slot.existingText },
+          nextText: text,
+          mode: "automatic",
+          metadata
+        });
         return { success: true };
       } catch (cause) {
         const workspaceError = {
@@ -3735,7 +3838,7 @@ function useTranslationWorkspace({
         setIsTranslating(false);
       }
     },
-    [commit, currentSchema, readOnly, sourceLocale, translationAdapter]
+    [commit, currentSchema, onTranslationChange, readOnly, sourceLocale, translationAdapter]
   );
   return {
     sourceLocale,
@@ -3752,6 +3855,7 @@ function useTranslationWorkspace({
     addLocale,
     isAddLocaleAllowed,
     removeLocale,
+    ...removeLocaleConfirmation === null ? {} : { removeLocaleConfirmation },
     setTranslation,
     translateAll,
     translateSlot,

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import * as _form_engine_ts_core from '@form-engine-ts/core';
-import { QuestionType, FormField, ChoiceOption, FormPage, FormSchema, DisplayCondition, JsonValue, SchemaIssue, FormPolicy, Question, FieldOption, TranslationReport, ValidationIssue, ValidationError, FormValues, LocaleOption, TranslationAdapter, AsyncTranslationAdapter, PopulateTranslationOptions, FormValue, AnswerValidationResult, TranslationSlot, FormEngineTranslator, FormEngineMessages, FieldType } from '@form-engine-ts/core';
+import { QuestionType, FormField, ChoiceOption, FormPage, FormSchema, DisplayCondition, JsonValue, SchemaIssue, FormPolicy, Question, FieldOption, TranslationReport, ValidationIssue, ValidationError, FormValues, LocaleOption, TranslationSlot, CanonicalTranslationMetadata, TranslationAdapter, AsyncTranslationAdapter, PopulateTranslationOptions, FormValue, AnswerValidationResult, FormEngineTranslator, FormEngineMessages, FieldType } from '@form-engine-ts/core';
 export { QuestionType } from '@form-engine-ts/core';
 import * as react from 'react';
 import { ReactNode, ComponentType, KeyboardEvent, MouseEvent, CSSProperties } from 'react';
@@ -417,6 +417,29 @@ interface TranslationWorkspaceActionsProps {
     readonly isTranslating: boolean;
     readonly readOnly: boolean;
 }
+interface TranslationEventPayload {
+    readonly sourceLocale: string;
+    readonly targetLocale: string;
+    readonly mode: "manual" | "automatic";
+    readonly updatedSlots: readonly TranslationSlot[];
+    readonly skippedSlots: readonly TranslationSlot[];
+    readonly missingSlotsCount: number;
+}
+interface TranslationSlotChangeEvent {
+    readonly slot: TranslationSlot;
+    readonly previousText?: string;
+    readonly nextText: string;
+    readonly mode: "manual" | "automatic";
+    readonly metadata: CanonicalTranslationMetadata;
+}
+interface ConfirmRemoveLocaleSlotProps {
+    readonly locale: string;
+    readonly localeLabel: string;
+    readonly translatedSlotsCount: number;
+    readonly isOpen: boolean;
+    readonly onConfirm: () => void;
+    readonly onCancel: () => void;
+}
 interface TranslationWorkspaceSlots {
     readonly renderHeader?: (props: TranslationWorkspaceHeaderProps) => ReactNode;
     readonly renderSlotRow?: (props: TranslationSlotRowProps) => ReactNode;
@@ -425,6 +448,7 @@ interface TranslationWorkspaceSlots {
         readonly status: _form_engine_ts_core.TranslationStatus;
     }) => ReactNode;
     readonly renderActions?: (props: TranslationWorkspaceActionsProps) => ReactNode;
+    readonly confirmRemoveLocale?: (props: ConfirmRemoveLocaleSlotProps) => ReactNode;
 }
 interface LocalizationSummaryContext {
     readonly defaultLocale: string;
@@ -762,6 +786,18 @@ interface UseTranslationWorkspaceOptions {
     readonly beforeRemoveLocale?: (locale: string, context: {
         readonly slotCount: number;
     }) => Promise<boolean> | boolean;
+    readonly confirmRemoveLocale?: (props: ConfirmRemoveLocaleSlotProps) => ReactNode;
+    readonly slots?: Pick<TranslationWorkspaceSlots, "confirmRemoveLocale">;
+    readonly onTranslationStart?: (params: {
+        readonly targetLocale: string;
+        readonly mode: "manual" | "automatic";
+    }) => void;
+    readonly onTranslationSuccess?: (payload: TranslationEventPayload) => void;
+    readonly onTranslationError?: (params: {
+        readonly targetLocale: string;
+        readonly error: TranslationWorkspaceError;
+    }) => void;
+    readonly onTranslationChange?: (event: TranslationSlotChangeEvent) => void;
     readonly validateLocale?: ((locale: string, currentLocales: readonly string[]) => LocaleValidationResult) | CustomLocaleValidator;
 }
 interface LocaleValidationContext {
@@ -827,6 +863,7 @@ interface UseTranslationWorkspaceResult {
     };
     readonly isAddLocaleAllowed: (locale: string) => boolean;
     readonly removeLocale: (locale: string) => boolean | Promise<boolean>;
+    readonly removeLocaleConfirmation?: ReactNode;
     readonly setTranslation: (slot: TranslationSlot, text: string) => void;
     readonly translateAll: (options?: PopulateTranslationOptions) => Promise<{
         readonly success: boolean;
@@ -841,7 +878,7 @@ interface UseTranslationWorkspaceResult {
     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, readOnly, policy, availableLocales, onLocaleAdded, onLocaleRemoved, onLocaleChange, beforeRemoveLocale, validateLocale }: UseTranslationWorkspaceOptions): UseTranslationWorkspaceResult;
+declare function useTranslationWorkspace({ schema, onChange, sourceLocale, targetLocale, translationAdapter, readOnly, policy, availableLocales, onLocaleAdded, onLocaleRemoved, onLocaleChange, beforeRemoveLocale, confirmRemoveLocale, slots: workspaceSlots, onTranslationStart, onTranslationSuccess, onTranslationError, onTranslationChange, validateLocale }: UseTranslationWorkspaceOptions): UseTranslationWorkspaceResult;
 
 declare const BUILDER_TRANSLATION_KEYS: {
     readonly ADD_FIELD: "builder.actions.addField";
@@ -931,4 +968,4 @@ interface StandaloneFormRendererProps extends FormRendererPresentationProps {
 type FormRendererProps = FormRendererPresentationProps | StandaloneFormRendererProps;
 declare function FormRenderer(props: FormRendererProps): react.JSX.Element;
 
-export { BUILDER_TRANSLATION_ALIASES, BUILDER_TRANSLATION_KEYS, type BeforeSubmit, type BuilderActionContext, type BuilderActionError, type BuilderActionIconType, type BuilderActionResult, type BuilderButtonProps, type BuilderCheckboxProps, type BuilderErrorMessageProps, type BuilderFactories, type BuilderFieldEditorSlotProps, type BuilderFieldsetProps, type BuilderIconButtonProps, type BuilderIdKind, type BuilderLocalizationSlotProps, type BuilderOptionEditorSlotProps, type BuilderPagesSlotProps, type BuilderPolicy, type BuilderSectionProps, type BuilderSelectOption, type BuilderSelectProps, type BuilderSlotActions, type BuilderTextAreaProps, type BuilderTextInputProps, type BuilderTextTarget, type BuilderToolbarSlotProps, type BuilderTranslationActionsSlotProps, type BuilderTranslationKey, type ChoiceFieldLayoutMode, type ChoiceFieldTypeLayoutMap, type ChoiceGroupSlotProps, type ComponentBaseProps, type CustomLocaleValidator, type FieldComponentProps, type FieldComponents, type FieldEditorControlsConfig, type FieldEditorHeaderSlotProps, type FieldEditorMode, type FieldError, type FieldPropertyControlMode, type FieldState, type FieldTypeSelectOptionsConfig, type FieldTypeSelectOptionsContext, type FieldTypeSelectOptionsSorter, type FieldTypeSelectOptionsTransformer, type FieldTypeSelectSlotProps, FormBuilder, type FormBuilderActions, type FormBuilderComponents, type FormBuilderFeatures, type FormBuilderOptions, type FormBuilderProps, type FormBuilderResult, type FormBuilderSectionName, type FormBuilderSlots, type FormBuilderSubmissionSettingsOptions, type FormCompletionSlotProps, type FormContextValue, FormEngineI18nContext, type FormEngineI18nContextValue, FormEngineI18nProvider, type FormEngineI18nProviderProps, type FormFieldsSlotProps, FormProvider, type FormProviderProps, FormRenderer, type FormRendererAppearance, type FormRendererMessages, type FormRendererPresentationProps, type FormRendererProps, type FormRendererSlotProps, type FormRendererSlots, type FormServerErrorPayload, FormSubmissionError, type FormSubmitHandler, type FormSubmitState, type FormSubmitStatus, type FormSubmittedAnswerItem, type FormSuccessRenderMode, type IconButtonProps, type InputComponentProps, type LocaleSelectorProps, type LocaleValidationContext, type LocaleValidationResult, type LocalizationSummaryContext, type ManualTranslationContext, type ManualTranslationTarget, type RenderSubmitButtonProps, type SelectComponentProps, type StandaloneFormRendererProps, type SubmissionAttempt, type SubmissionAttemptStore, type SubmissionConfirmationOptions, type SubmissionConfirmationRenderMode, type SubmissionConfirmationSlotProps, type SubmissionGuard, type SubmissionGuardResult, type SubmissionProtectionProps, type SubmissionReceipt, type SubmissionReceiptQuery, type SubmissionReceiptStore, type SubmitContext, type SubmitResponse, type SubmitResult, type SubmitStatus, type TranslationSlotRowProps, type TranslationSummary, type TranslationWorkspaceActionsProps, type TranslationWorkspaceError, type TranslationWorkspaceHeaderProps, type TranslationWorkspaceSlots, type UseFormBuilderOptions, type UseFormBuilderResult, type UseSubmissionReceiptsResult, type UseTranslationWorkspaceOptions, type UseTranslationWorkspaceResult, createLocalStorageSubmissionAttemptStore, createLocalStorageSubmissionReceiptStore, isTranslationUnresolved, resolveChoiceFieldLayout, resolveFieldEditorControls, resolveFieldTypeSelectOptions, resolveInitialFieldType, resolveTranslation, submissionReceiptQueryKey, useField, useForm, useFormBuilder, useFormEngineI18n, useSubmissionReceipts, useTranslationWorkspace, validateLocalePipeline };
+export { BUILDER_TRANSLATION_ALIASES, BUILDER_TRANSLATION_KEYS, type BeforeSubmit, type BuilderActionContext, type BuilderActionError, type BuilderActionIconType, type BuilderActionResult, type BuilderButtonProps, type BuilderCheckboxProps, type BuilderErrorMessageProps, type BuilderFactories, type BuilderFieldEditorSlotProps, type BuilderFieldsetProps, type BuilderIconButtonProps, type BuilderIdKind, type BuilderLocalizationSlotProps, type BuilderOptionEditorSlotProps, type BuilderPagesSlotProps, type BuilderPolicy, type BuilderSectionProps, type BuilderSelectOption, type BuilderSelectProps, type BuilderSlotActions, type BuilderTextAreaProps, type BuilderTextInputProps, type BuilderTextTarget, type BuilderToolbarSlotProps, type BuilderTranslationActionsSlotProps, type BuilderTranslationKey, type ChoiceFieldLayoutMode, type ChoiceFieldTypeLayoutMap, type ChoiceGroupSlotProps, type ComponentBaseProps, type ConfirmRemoveLocaleSlotProps, type CustomLocaleValidator, type FieldComponentProps, type FieldComponents, type FieldEditorControlsConfig, type FieldEditorHeaderSlotProps, type FieldEditorMode, type FieldError, type FieldPropertyControlMode, type FieldState, type FieldTypeSelectOptionsConfig, type FieldTypeSelectOptionsContext, type FieldTypeSelectOptionsSorter, type FieldTypeSelectOptionsTransformer, type FieldTypeSelectSlotProps, FormBuilder, type FormBuilderActions, type FormBuilderComponents, type FormBuilderFeatures, type FormBuilderOptions, type FormBuilderProps, type FormBuilderResult, type FormBuilderSectionName, type FormBuilderSlots, type FormBuilderSubmissionSettingsOptions, type FormCompletionSlotProps, type FormContextValue, FormEngineI18nContext, type FormEngineI18nContextValue, FormEngineI18nProvider, type FormEngineI18nProviderProps, type FormFieldsSlotProps, FormProvider, type FormProviderProps, FormRenderer, type FormRendererAppearance, type FormRendererMessages, type FormRendererPresentationProps, type FormRendererProps, type FormRendererSlotProps, type FormRendererSlots, type FormServerErrorPayload, FormSubmissionError, type FormSubmitHandler, type FormSubmitState, type FormSubmitStatus, type FormSubmittedAnswerItem, type FormSuccessRenderMode, type IconButtonProps, type InputComponentProps, type LocaleSelectorProps, type LocaleValidationContext, type LocaleValidationResult, type LocalizationSummaryContext, type ManualTranslationContext, type ManualTranslationTarget, type RenderSubmitButtonProps, type SelectComponentProps, type StandaloneFormRendererProps, type SubmissionAttempt, type SubmissionAttemptStore, type SubmissionConfirmationOptions, type SubmissionConfirmationRenderMode, type SubmissionConfirmationSlotProps, type SubmissionGuard, type SubmissionGuardResult, type SubmissionProtectionProps, type SubmissionReceipt, type SubmissionReceiptQuery, type SubmissionReceiptStore, type SubmitContext, type SubmitResponse, type SubmitResult, type SubmitStatus, type TranslationEventPayload, type TranslationSlotChangeEvent, type TranslationSlotRowProps, type TranslationSummary, type TranslationWorkspaceActionsProps, type TranslationWorkspaceError, type TranslationWorkspaceHeaderProps, type TranslationWorkspaceSlots, type UseFormBuilderOptions, type UseFormBuilderResult, type UseSubmissionReceiptsResult, type UseTranslationWorkspaceOptions, type UseTranslationWorkspaceResult, createLocalStorageSubmissionAttemptStore, createLocalStorageSubmissionReceiptStore, isTranslationUnresolved, resolveChoiceFieldLayout, resolveFieldEditorControls, resolveFieldTypeSelectOptions, resolveInitialFieldType, resolveTranslation, submissionReceiptQueryKey, useField, useForm, useFormBuilder, useFormEngineI18n, useSubmissionReceipts, useTranslationWorkspace, validateLocalePipeline };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _form_engine_ts_core from '@form-engine-ts/core';
-import { QuestionType, FormField, ChoiceOption, FormPage, FormSchema, DisplayCondition, JsonValue, SchemaIssue, FormPolicy, Question, FieldOption, TranslationReport, ValidationIssue, ValidationError, FormValues, LocaleOption, TranslationAdapter, AsyncTranslationAdapter, PopulateTranslationOptions, FormValue, AnswerValidationResult, TranslationSlot, FormEngineTranslator, FormEngineMessages, FieldType } from '@form-engine-ts/core';
+import { QuestionType, FormField, ChoiceOption, FormPage, FormSchema, DisplayCondition, JsonValue, SchemaIssue, FormPolicy, Question, FieldOption, TranslationReport, ValidationIssue, ValidationError, FormValues, LocaleOption, TranslationSlot, CanonicalTranslationMetadata, TranslationAdapter, AsyncTranslationAdapter, PopulateTranslationOptions, FormValue, AnswerValidationResult, FormEngineTranslator, FormEngineMessages, FieldType } from '@form-engine-ts/core';
 export { QuestionType } from '@form-engine-ts/core';
 import * as react from 'react';
 import { ReactNode, ComponentType, KeyboardEvent, MouseEvent, CSSProperties } from 'react';
@@ -417,6 +417,29 @@ interface TranslationWorkspaceActionsProps {
     readonly isTranslating: boolean;
     readonly readOnly: boolean;
 }
+interface TranslationEventPayload {
+    readonly sourceLocale: string;
+    readonly targetLocale: string;
+    readonly mode: "manual" | "automatic";
+    readonly updatedSlots: readonly TranslationSlot[];
+    readonly skippedSlots: readonly TranslationSlot[];
+    readonly missingSlotsCount: number;
+}
+interface TranslationSlotChangeEvent {
+    readonly slot: TranslationSlot;
+    readonly previousText?: string;
+    readonly nextText: string;
+    readonly mode: "manual" | "automatic";
+    readonly metadata: CanonicalTranslationMetadata;
+}
+interface ConfirmRemoveLocaleSlotProps {
+    readonly locale: string;
+    readonly localeLabel: string;
+    readonly translatedSlotsCount: number;
+    readonly isOpen: boolean;
+    readonly onConfirm: () => void;
+    readonly onCancel: () => void;
+}
 interface TranslationWorkspaceSlots {
     readonly renderHeader?: (props: TranslationWorkspaceHeaderProps) => ReactNode;
     readonly renderSlotRow?: (props: TranslationSlotRowProps) => ReactNode;
@@ -425,6 +448,7 @@ interface TranslationWorkspaceSlots {
         readonly status: _form_engine_ts_core.TranslationStatus;
     }) => ReactNode;
     readonly renderActions?: (props: TranslationWorkspaceActionsProps) => ReactNode;
+    readonly confirmRemoveLocale?: (props: ConfirmRemoveLocaleSlotProps) => ReactNode;
 }
 interface LocalizationSummaryContext {
     readonly defaultLocale: string;
@@ -762,6 +786,18 @@ interface UseTranslationWorkspaceOptions {
     readonly beforeRemoveLocale?: (locale: string, context: {
         readonly slotCount: number;
     }) => Promise<boolean> | boolean;
+    readonly confirmRemoveLocale?: (props: ConfirmRemoveLocaleSlotProps) => ReactNode;
+    readonly slots?: Pick<TranslationWorkspaceSlots, "confirmRemoveLocale">;
+    readonly onTranslationStart?: (params: {
+        readonly targetLocale: string;
+        readonly mode: "manual" | "automatic";
+    }) => void;
+    readonly onTranslationSuccess?: (payload: TranslationEventPayload) => void;
+    readonly onTranslationError?: (params: {
+        readonly targetLocale: string;
+        readonly error: TranslationWorkspaceError;
+    }) => void;
+    readonly onTranslationChange?: (event: TranslationSlotChangeEvent) => void;
     readonly validateLocale?: ((locale: string, currentLocales: readonly string[]) => LocaleValidationResult) | CustomLocaleValidator;
 }
 interface LocaleValidationContext {
@@ -827,6 +863,7 @@ interface UseTranslationWorkspaceResult {
     };
     readonly isAddLocaleAllowed: (locale: string) => boolean;
     readonly removeLocale: (locale: string) => boolean | Promise<boolean>;
+    readonly removeLocaleConfirmation?: ReactNode;
     readonly setTranslation: (slot: TranslationSlot, text: string) => void;
     readonly translateAll: (options?: PopulateTranslationOptions) => Promise<{
         readonly success: boolean;
@@ -841,7 +878,7 @@ interface UseTranslationWorkspaceResult {
     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, readOnly, policy, availableLocales, onLocaleAdded, onLocaleRemoved, onLocaleChange, beforeRemoveLocale, validateLocale }: UseTranslationWorkspaceOptions): UseTranslationWorkspaceResult;
+declare function useTranslationWorkspace({ schema, onChange, sourceLocale, targetLocale, translationAdapter, readOnly, policy, availableLocales, onLocaleAdded, onLocaleRemoved, onLocaleChange, beforeRemoveLocale, confirmRemoveLocale, slots: workspaceSlots, onTranslationStart, onTranslationSuccess, onTranslationError, onTranslationChange, validateLocale }: UseTranslationWorkspaceOptions): UseTranslationWorkspaceResult;
 
 declare const BUILDER_TRANSLATION_KEYS: {
     readonly ADD_FIELD: "builder.actions.addField";
@@ -931,4 +968,4 @@ interface StandaloneFormRendererProps extends FormRendererPresentationProps {
 type FormRendererProps = FormRendererPresentationProps | StandaloneFormRendererProps;
 declare function FormRenderer(props: FormRendererProps): react.JSX.Element;
 
-export { BUILDER_TRANSLATION_ALIASES, BUILDER_TRANSLATION_KEYS, type BeforeSubmit, type BuilderActionContext, type BuilderActionError, type BuilderActionIconType, type BuilderActionResult, type BuilderButtonProps, type BuilderCheckboxProps, type BuilderErrorMessageProps, type BuilderFactories, type BuilderFieldEditorSlotProps, type BuilderFieldsetProps, type BuilderIconButtonProps, type BuilderIdKind, type BuilderLocalizationSlotProps, type BuilderOptionEditorSlotProps, type BuilderPagesSlotProps, type BuilderPolicy, type BuilderSectionProps, type BuilderSelectOption, type BuilderSelectProps, type BuilderSlotActions, type BuilderTextAreaProps, type BuilderTextInputProps, type BuilderTextTarget, type BuilderToolbarSlotProps, type BuilderTranslationActionsSlotProps, type BuilderTranslationKey, type ChoiceFieldLayoutMode, type ChoiceFieldTypeLayoutMap, type ChoiceGroupSlotProps, type ComponentBaseProps, type CustomLocaleValidator, type FieldComponentProps, type FieldComponents, type FieldEditorControlsConfig, type FieldEditorHeaderSlotProps, type FieldEditorMode, type FieldError, type FieldPropertyControlMode, type FieldState, type FieldTypeSelectOptionsConfig, type FieldTypeSelectOptionsContext, type FieldTypeSelectOptionsSorter, type FieldTypeSelectOptionsTransformer, type FieldTypeSelectSlotProps, FormBuilder, type FormBuilderActions, type FormBuilderComponents, type FormBuilderFeatures, type FormBuilderOptions, type FormBuilderProps, type FormBuilderResult, type FormBuilderSectionName, type FormBuilderSlots, type FormBuilderSubmissionSettingsOptions, type FormCompletionSlotProps, type FormContextValue, FormEngineI18nContext, type FormEngineI18nContextValue, FormEngineI18nProvider, type FormEngineI18nProviderProps, type FormFieldsSlotProps, FormProvider, type FormProviderProps, FormRenderer, type FormRendererAppearance, type FormRendererMessages, type FormRendererPresentationProps, type FormRendererProps, type FormRendererSlotProps, type FormRendererSlots, type FormServerErrorPayload, FormSubmissionError, type FormSubmitHandler, type FormSubmitState, type FormSubmitStatus, type FormSubmittedAnswerItem, type FormSuccessRenderMode, type IconButtonProps, type InputComponentProps, type LocaleSelectorProps, type LocaleValidationContext, type LocaleValidationResult, type LocalizationSummaryContext, type ManualTranslationContext, type ManualTranslationTarget, type RenderSubmitButtonProps, type SelectComponentProps, type StandaloneFormRendererProps, type SubmissionAttempt, type SubmissionAttemptStore, type SubmissionConfirmationOptions, type SubmissionConfirmationRenderMode, type SubmissionConfirmationSlotProps, type SubmissionGuard, type SubmissionGuardResult, type SubmissionProtectionProps, type SubmissionReceipt, type SubmissionReceiptQuery, type SubmissionReceiptStore, type SubmitContext, type SubmitResponse, type SubmitResult, type SubmitStatus, type TranslationSlotRowProps, type TranslationSummary, type TranslationWorkspaceActionsProps, type TranslationWorkspaceError, type TranslationWorkspaceHeaderProps, type TranslationWorkspaceSlots, type UseFormBuilderOptions, type UseFormBuilderResult, type UseSubmissionReceiptsResult, type UseTranslationWorkspaceOptions, type UseTranslationWorkspaceResult, createLocalStorageSubmissionAttemptStore, createLocalStorageSubmissionReceiptStore, isTranslationUnresolved, resolveChoiceFieldLayout, resolveFieldEditorControls, resolveFieldTypeSelectOptions, resolveInitialFieldType, resolveTranslation, submissionReceiptQueryKey, useField, useForm, useFormBuilder, useFormEngineI18n, useSubmissionReceipts, useTranslationWorkspace, validateLocalePipeline };
+export { BUILDER_TRANSLATION_ALIASES, BUILDER_TRANSLATION_KEYS, type BeforeSubmit, type BuilderActionContext, type BuilderActionError, type BuilderActionIconType, type BuilderActionResult, type BuilderButtonProps, type BuilderCheckboxProps, type BuilderErrorMessageProps, type BuilderFactories, type BuilderFieldEditorSlotProps, type BuilderFieldsetProps, type BuilderIconButtonProps, type BuilderIdKind, type BuilderLocalizationSlotProps, type BuilderOptionEditorSlotProps, type BuilderPagesSlotProps, type BuilderPolicy, type BuilderSectionProps, type BuilderSelectOption, type BuilderSelectProps, type BuilderSlotActions, type BuilderTextAreaProps, type BuilderTextInputProps, type BuilderTextTarget, type BuilderToolbarSlotProps, type BuilderTranslationActionsSlotProps, type BuilderTranslationKey, type ChoiceFieldLayoutMode, type ChoiceFieldTypeLayoutMap, type ChoiceGroupSlotProps, type ComponentBaseProps, type ConfirmRemoveLocaleSlotProps, type CustomLocaleValidator, type FieldComponentProps, type FieldComponents, type FieldEditorControlsConfig, type FieldEditorHeaderSlotProps, type FieldEditorMode, type FieldError, type FieldPropertyControlMode, type FieldState, type FieldTypeSelectOptionsConfig, type FieldTypeSelectOptionsContext, type FieldTypeSelectOptionsSorter, type FieldTypeSelectOptionsTransformer, type FieldTypeSelectSlotProps, FormBuilder, type FormBuilderActions, type FormBuilderComponents, type FormBuilderFeatures, type FormBuilderOptions, type FormBuilderProps, type FormBuilderResult, type FormBuilderSectionName, type FormBuilderSlots, type FormBuilderSubmissionSettingsOptions, type FormCompletionSlotProps, type FormContextValue, FormEngineI18nContext, type FormEngineI18nContextValue, FormEngineI18nProvider, type FormEngineI18nProviderProps, type FormFieldsSlotProps, FormProvider, type FormProviderProps, FormRenderer, type FormRendererAppearance, type FormRendererMessages, type FormRendererPresentationProps, type FormRendererProps, type FormRendererSlotProps, type FormRendererSlots, type FormServerErrorPayload, FormSubmissionError, type FormSubmitHandler, type FormSubmitState, type FormSubmitStatus, type FormSubmittedAnswerItem, type FormSuccessRenderMode, type IconButtonProps, type InputComponentProps, type LocaleSelectorProps, type LocaleValidationContext, type LocaleValidationResult, type LocalizationSummaryContext, type ManualTranslationContext, type ManualTranslationTarget, type RenderSubmitButtonProps, type SelectComponentProps, type StandaloneFormRendererProps, type SubmissionAttempt, type SubmissionAttemptStore, type SubmissionConfirmationOptions, type SubmissionConfirmationRenderMode, type SubmissionConfirmationSlotProps, type SubmissionGuard, type SubmissionGuardResult, type SubmissionProtectionProps, type SubmissionReceipt, type SubmissionReceiptQuery, type SubmissionReceiptStore, type SubmitContext, type SubmitResponse, type SubmitResult, type SubmitStatus, type TranslationEventPayload, type TranslationSlotChangeEvent, type TranslationSlotRowProps, type TranslationSummary, type TranslationWorkspaceActionsProps, type TranslationWorkspaceError, type TranslationWorkspaceHeaderProps, type TranslationWorkspaceSlots, type UseFormBuilderOptions, type UseFormBuilderResult, type UseSubmissionReceiptsResult, type UseTranslationWorkspaceOptions, type UseTranslationWorkspaceResult, createLocalStorageSubmissionAttemptStore, createLocalStorageSubmissionReceiptStore, isTranslationUnresolved, resolveChoiceFieldLayout, resolveFieldEditorControls, resolveFieldTypeSelectOptions, resolveInitialFieldType, resolveTranslation, submissionReceiptQueryKey, useField, useForm, useFormBuilder, useFormEngineI18n, useSubmissionReceipts, useTranslationWorkspace, validateLocalePipeline };

package/dist/index.js

@@ -3282,7 +3282,7 @@ import {
   populateSchemaTranslations as populateSchemaTranslations2,
   removeLocaleFromSchema
 } from "@form-engine-ts/core";
-import { useCallback as useCallback3, useMemo as useMemo4, useState as useState4 } from "react";
+import { useCallback as useCallback3, useMemo as useMemo4, useRef as useRef2, useState as useState4 } from "react";
 function updateTranslationMap(translations, locale, property, text) {
   if (property === "label") return translations ?? {};
   const current = translations?.[locale];
@@ -3394,26 +3394,27 @@ function workspaceLocaleValidationError(validation, currentLocales, requestedLoc
   }
   return { type: "custom_validation_failed", message: error.message };
 }
-function manualMetadata(sourceText, sourceLocale) {
+function translationMetadata(sourceText, sourceLocale, mode) {
   return {
     sourceLocale,
     sourceTextHash: computeSourceTextHash(sourceText),
-    translationSource: "manual",
-    editedAt: (/* @__PURE__ */ new Date()).toISOString()
+    translationSource: mode,
+    ...mode === "manual" ? { editedAt: (/* @__PURE__ */ new Date()).toISOString() } : { translatedAt: (/* @__PURE__ */ new Date()).toISOString() }
   };
 }
-function setNodeMetadata(node, slot, text, sourceLocale) {
+function setNodeMetadata(node, slot, text, sourceLocale, mode) {
   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]: manualMetadata(slot.sourceText, sourceLocale) };
+  const nextMetadata = text.trim().length === 0 ? Object.fromEntries(Object.entries(localeMetadata ?? {}).filter(([key]) => key !== slot.property)) : { ...localeMetadata, [slot.property]: translationMetadata(slot.sourceText, sourceLocale, mode) };
   return { ...node, translationMetadata: { ...node.translationMetadata, [slot.locale]: nextMetadata } };
 }
-function updateSchemaTranslation(schema, slot, text, sourceLocale) {
+function updateSchemaTranslation(schema, slot, text, sourceLocale, mode = "manual") {
   if (slot.kind === "form") {
     return setNodeMetadata(
       { ...schema, translations: updateTranslationMap(schema.translations, slot.locale, slot.property, text) },
       slot,
       text,
-      sourceLocale
+      sourceLocale,
+      mode
     );
   }
   if (slot.kind === "field") {
@@ -3422,7 +3423,7 @@ function updateSchemaTranslation(schema, slot, text, sourceLocale) {
       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);
+        return setNodeMetadata({ ...field, translations }, slot, text, sourceLocale, mode);
       })
     };
   }
@@ -3438,7 +3439,7 @@ function updateSchemaTranslation(schema, slot, text, sourceLocale) {
             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);
+            return setNodeMetadata({ ...option, translations }, slot, text, sourceLocale, mode);
           })
         };
       })
@@ -3450,7 +3451,7 @@ function updateSchemaTranslation(schema, slot, text, sourceLocale) {
       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);
+        return setNodeMetadata({ ...page, translations }, slot, text, sourceLocale, mode);
       })
     }
   };
@@ -3468,13 +3469,22 @@ function useTranslationWorkspace({
   onLocaleRemoved,
   onLocaleChange,
   beforeRemoveLocale,
+  confirmRemoveLocale,
+  slots: workspaceSlots,
+  onTranslationStart,
+  onTranslationSuccess,
+  onTranslationError,
+  onTranslationChange,
   validateLocale
 }) {
   const [draftSchema, setDraftSchema] = useState4(schema);
   const [selectedLocale, setSelectedLocale] = useState4(normalizeLocale(targetLocale ?? "") ?? targetLocale ?? "");
   const [isTranslating, setIsTranslating] = useState4(false);
   const [error, setError] = useState4();
+  const [pendingRemoval, setPendingRemoval] = useState4();
+  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(
@@ -3524,9 +3534,17 @@ function useTranslationWorkspace({
   const setTranslation = useCallback3(
     (slot, text) => {
       if (readOnly) return;
-      commit(updateSchemaTranslation(currentSchema, slot, text, sourceLocale));
+      const metadata = translationMetadata(slot.sourceText, sourceLocale, "manual");
+      commit(updateSchemaTranslation(currentSchema, slot, text, sourceLocale, "manual"));
+      onTranslationChange?.({
+        slot,
+        ...slot.existingText === void 0 ? {} : { previousText: slot.existingText },
+        nextText: text,
+        mode: "manual",
+        metadata
+      });
     },
-    [commit, currentSchema, readOnly, sourceLocale]
+    [commit, currentSchema, onTranslationChange, readOnly, sourceLocale]
   );
   const addLocale = useCallback3(
     (locale) => {
@@ -3587,21 +3605,36 @@ function useTranslationWorkspace({
         onLocaleRemoved?.(normalized);
       };
       const slotCount = collectTranslationSlots(currentSchema, normalized).length;
+      const translatedSlotsCount = collectTranslationSlots(currentSchema, normalized).filter(
+        (slot) => slot.existingText !== void 0 && slot.existingText.trim().length > 0
+      ).length;
+      const requestConfirmation = () => new Promise((resolve) => {
+        pendingRemovalResolver.current = resolve;
+        setPendingRemoval({
+          locale: normalized,
+          localeLabel: localeOptions.find((option) => option.locale === normalized)?.label ?? normalized,
+          translatedSlotsCount
+        });
+      });
+      const removeAfterApproval = () => {
+        if (confirmRemoveLocaleRenderer === void 0) {
+          remove();
+          return true;
+        }
+        return requestConfirmation();
+      };
       if (beforeRemoveLocale === void 0) {
-        remove();
-        return true;
+        return removeAfterApproval();
       }
       try {
         const decision = beforeRemoveLocale(normalized, { slotCount });
         if (typeof decision === "boolean") {
           if (!decision) return false;
-          remove();
-          return true;
+          return removeAfterApproval();
         }
         return decision.then((allowed) => {
           if (!allowed) return false;
-          remove();
-          return true;
+          return removeAfterApproval();
         });
       } catch (cause) {
         const workspaceError = {
@@ -3613,8 +3646,45 @@ function useTranslationWorkspace({
         return Promise.reject(cause);
       }
     },
-    [activeLocale, beforeRemoveLocale, commit, currentSchema, onLocaleRemoved, readOnly, sourceLocale]
+    [
+      activeLocale,
+      beforeRemoveLocale,
+      commit,
+      confirmRemoveLocaleRenderer,
+      currentSchema,
+      localeOptions,
+      onLocaleRemoved,
+      readOnly,
+      sourceLocale
+    ]
   );
+  const confirmPendingRemoval = useCallback3(() => {
+    const pending = pendingRemoval;
+    const resolve = pendingRemovalResolver.current;
+    if (pending === void 0 || resolve === void 0) return;
+    pendingRemovalResolver.current = void 0;
+    setPendingRemoval(void 0);
+    commit(removeLocaleFromSchema(currentSchema, pending.locale));
+    if (activeLocale === pending.locale) setSelectedLocale("");
+    onLocaleRemoved?.(pending.locale);
+    resolve(true);
+  }, [activeLocale, commit, currentSchema, onLocaleRemoved, pendingRemoval]);
+  const cancelPendingRemoval = useCallback3(() => {
+    const resolve = pendingRemovalResolver.current;
+    if (resolve === void 0) return;
+    pendingRemovalResolver.current = void 0;
+    setPendingRemoval(void 0);
+    resolve(false);
+  }, []);
+  const removeLocaleConfirmation = useMemo4(() => {
+    if (confirmRemoveLocaleRenderer === void 0 || pendingRemoval === void 0) return null;
+    return confirmRemoveLocaleRenderer({
+      ...pendingRemoval,
+      isOpen: true,
+      onConfirm: confirmPendingRemoval,
+      onCancel: cancelPendingRemoval
+    });
+  }, [cancelPendingRemoval, confirmPendingRemoval, confirmRemoveLocaleRenderer, pendingRemoval]);
   const translateAll = useCallback3(
     async (options = {}) => {
       if (readOnly) {
@@ -3651,6 +3721,7 @@ function useTranslationWorkspace({
       }
       setIsTranslating(true);
       setError(void 0);
+      onTranslationStart?.({ targetLocale: activeLocale, mode: "automatic" });
       try {
         const populated = await populateSchemaTranslations2(
           currentSchema,
@@ -3663,6 +3734,17 @@ function useTranslationWorkspace({
           }
         );
         commit(populated.schema);
+        const missingSlotsCount = collectTranslationSlots(populated.schema, activeLocale).filter(
+          (slot) => slot.status === "missing"
+        ).length;
+        onTranslationSuccess?.({
+          sourceLocale,
+          targetLocale: activeLocale,
+          mode: "automatic",
+          updatedSlots: populated.report.updatedSlots,
+          skippedSlots: populated.report.skippedSlots,
+          missingSlotsCount
+        });
         return { success: true, report: populated.report };
       } catch (cause) {
         const workspaceError = {
@@ -3671,12 +3753,25 @@ function useTranslationWorkspace({
           cause
         };
         setError(workspaceError);
+        onTranslationError?.({ targetLocale: activeLocale, error: workspaceError });
         return { success: false, error: workspaceError };
       } finally {
         setIsTranslating(false);
       }
     },
-    [activeLocale, commit, currentSchema, localeOptions, readOnly, slots, translationAdapter]
+    [
+      activeLocale,
+      commit,
+      currentSchema,
+      localeOptions,
+      onTranslationError,
+      onTranslationStart,
+      onTranslationSuccess,
+      readOnly,
+      slots,
+      sourceLocale,
+      translationAdapter
+    ]
   );
   const translateSlot = useCallback3(
     async (slot) => {
@@ -3694,7 +3789,15 @@ function useTranslationWorkspace({
       setError(void 0);
       try {
         const text = await asAsyncAdapter(translationAdapter).translateText(slot.sourceText, slot.locale, sourceLocale);
-        commit(updateSchemaTranslation(currentSchema, slot, text, sourceLocale));
+        const metadata = translationMetadata(slot.sourceText, sourceLocale, "automatic");
+        commit(updateSchemaTranslation(currentSchema, slot, text, sourceLocale, "automatic"));
+        onTranslationChange?.({
+          slot,
+          ...slot.existingText === void 0 ? {} : { previousText: slot.existingText },
+          nextText: text,
+          mode: "automatic",
+          metadata
+        });
         return { success: true };
       } catch (cause) {
         const workspaceError = {
@@ -3708,7 +3811,7 @@ function useTranslationWorkspace({
         setIsTranslating(false);
       }
     },
-    [commit, currentSchema, readOnly, sourceLocale, translationAdapter]
+    [commit, currentSchema, onTranslationChange, readOnly, sourceLocale, translationAdapter]
   );
   return {
     sourceLocale,
@@ -3725,6 +3828,7 @@ function useTranslationWorkspace({
     addLocale,
     isAddLocaleAllowed,
     removeLocale,
+    ...removeLocaleConfirmation === null ? {} : { removeLocaleConfirmation },
     setTranslation,
     translateAll,
     translateSlot,
@@ -3862,7 +3966,7 @@ import {
   useEffect as useEffect3,
   useId,
   useMemo as useMemo6,
-  useRef as useRef2,
+  useRef as useRef3,
   useState as useState6
 } from "react";
 import { Fragment as Fragment3, jsx as jsx4, jsxs as jsxs2 } from "react/jsx-runtime";
@@ -4378,8 +4482,8 @@ function ContextFormRenderer({
   const i18n = useFormEngineI18n();
   const isProviderValue = useContext4(FormEngineI18nProviderScopeContext);
   const prefix = useId().replace(/:/g, "");
-  const formRef = useRef2(null);
-  const loadedDraftKey = useRef2(null);
+  const formRef = useRef3(null);
+  const loadedDraftKey = useRef3(null);
   const [draftRestored, setDraftRestored] = useState6(false);
   const [currentPageIndex, setCurrentPageIndex] = useState6(0);
   const [focusFieldId, setFocusFieldId] = useState6(null);
@@ -4389,10 +4493,10 @@ function ContextFormRenderer({
   const [receipt, setReceipt] = useState6(null);
   const [completionData, setCompletionData] = useState6(null);
   const [receiptLoaded, setReceiptLoaded] = useState6(receiptStore === void 0);
-  const rendererSubmissionInFlight = useRef2(false);
-  const fallbackAttemptId = useRef2(null);
-  const completionRef = useRef2(null);
-  const confirmationRef = useRef2(null);
+  const rendererSubmissionInFlight = useRef3(false);
+  const fallbackAttemptId = useRef3(null);
+  const completionRef = useRef3(null);
+  const confirmationRef = useRef3(null);
   const pages = form.schema.pages;
   const visiblePageIndexes = useMemo6(
     () => pages === void 0 ? [] : pages.flatMap((page, index) => form.pageVisibility[page.id] === true ? [index] : []),

package/package.json

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