@form-engine-ts/react 5.0.1 → 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

@@ -3325,7 +3325,7 @@ function asAsyncAdapter(adapter) {
     )
   };
 }
-var validateLocalePipeline = (locale, schema, policy, customValidator) => {
+var validateLocalePipeline = (locale, schema, policy, customValidator, availableLocales) => {
   const canonicalLocale = (0, import_core5.normalizeLocale)(locale);
   if (canonicalLocale === null) {
     return {
@@ -3338,6 +3338,18 @@ var validateLocalePipeline = (locale, schema, policy, customValidator) => {
   }
   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;
+  })) {
+    return {
+      valid: false,
+      error: {
+        type: "locale_not_allowed",
+        message: `Locale "${canonicalLocale}" is not available in the locale catalog.`
+      }
+    };
+  }
   if (canonicalLocale === defaultLocale || currentLocales.includes(canonicalLocale)) {
     return {
       valid: false,
@@ -3409,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") {
@@ -3437,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);
       })
     };
   }
@@ -3453,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);
           })
         };
       })
@@ -3465,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);
       })
     }
   };
@@ -3478,14 +3491,27 @@ function useTranslationWorkspace({
   translationAdapter,
   readOnly = false,
   policy,
+  availableLocales,
+  onLocaleAdded,
+  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)(targetLocale ?? "");
+  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(
@@ -3493,6 +3519,15 @@ function useTranslationWorkspace({
     );
   }, [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 slots = (0, import_react5.useMemo)(
     () => activeLocale.length === 0 ? [] : (0, import_core5.collectTranslationSlots)(currentSchema, activeLocale),
     [activeLocale, currentSchema]
@@ -3526,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) => {
@@ -3540,14 +3583,14 @@ function useTranslationWorkspace({
       const normalized = (0, import_core5.normalizeLocale)(locale);
       if (normalized === null) {
         const workspaceError = workspaceLocaleValidationError(
-          validateLocalePipeline(locale, currentSchema, policy, validateLocale),
+          validateLocalePipeline(locale, currentSchema, policy, validateLocale, availableLocales),
           (0, import_core5.collectSchemaLocales)(currentSchema).allUniqueLocales.size,
           locale
         );
         setError(workspaceError);
         return { success: false, error: workspaceError };
       }
-      const validation = validateLocalePipeline(normalized, currentSchema, policy, validateLocale);
+      const validation = validateLocalePipeline(normalized, currentSchema, policy, validateLocale, availableLocales);
       if (!validation.valid) {
         const workspaceError = workspaceLocaleValidationError(
           validation,
@@ -3563,42 +3606,62 @@ function useTranslationWorkspace({
         supportedLocales: [.../* @__PURE__ */ new Set([...currentSchema.supportedLocales ?? [], normalized])]
       });
       setSelectedLocale(normalized);
+      onLocaleAdded?.(normalized);
       return { success: true };
     },
-    [commit, currentSchema, policy, readOnly, validateLocale]
+    [availableLocales, commit, currentSchema, onLocaleAdded, policy, readOnly, 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).valid;
+      return validateLocalePipeline(normalized, currentSchema, policy, validateLocale, availableLocales).valid;
     },
-    [currentSchema, policy, readOnly, validateLocale]
+    [availableLocales, currentSchema, policy, readOnly, validateLocale]
   );
   const removeLocale = (0, import_react5.useCallback)(
     (locale) => {
-      if (readOnly || locale === sourceLocale || locale === currentSchema.defaultLocale) return false;
+      const normalized = (0, import_core5.normalizeLocale)(locale) ?? locale;
+      const normalizedSourceLocale = (0, import_core5.normalizeLocale)(sourceLocale) ?? sourceLocale;
+      const normalizedDefaultLocale = currentSchema.defaultLocale === void 0 ? void 0 : (0, import_core5.normalizeLocale)(currentSchema.defaultLocale) ?? currentSchema.defaultLocale;
+      if (readOnly || normalized === normalizedSourceLocale || normalized === normalizedDefaultLocale) return false;
       const remove = () => {
-        commit((0, import_core5.removeLocaleFromSchema)(currentSchema, locale));
-        if (activeLocale === locale) setSelectedLocale("");
+        commit((0, import_core5.removeLocaleFromSchema)(currentSchema, normalized));
+        if (activeLocale === normalized) setSelectedLocale("");
+        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();
       };
-      const slotCount = (0, import_core5.collectTranslationSlots)(currentSchema, locale).length;
       if (beforeRemoveLocale === void 0) {
-        remove();
-        return true;
+        return removeAfterApproval();
       }
       try {
-        const decision = beforeRemoveLocale(locale, { slotCount });
+        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 = {
@@ -3610,8 +3673,45 @@ function useTranslationWorkspace({
         return Promise.reject(cause);
       }
     },
-    [activeLocale, beforeRemoveLocale, commit, currentSchema, 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) {
@@ -3629,8 +3729,26 @@ function useTranslationWorkspace({
         setError(workspaceError);
         return { success: false, error: workspaceError };
       }
+      const selectedLocaleOption = localeOptions.find(
+        (option) => ((0, import_core5.normalizeLocale)(option.locale) ?? option.locale) === activeLocale
+      );
+      if (selectedLocaleOption?.translatable === false) {
+        setError(void 0);
+        return {
+          success: true,
+          report: {
+            updatedSlots: [],
+            skippedSlots: slots,
+            staleSlots: [],
+            skippedReasons: Object.fromEntries(
+              slots.map((slot) => [slot.path ?? `${slot.kind}.${slot.nodeId}.${slot.property}`, "unsupported"])
+            )
+          }
+        };
+      }
       setIsTranslating(true);
       setError(void 0);
+      onTranslationStart?.({ targetLocale: activeLocale, mode: "automatic" });
       try {
         const populated = await (0, import_core5.populateSchemaTranslations)(
           currentSchema,
@@ -3643,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 = {
@@ -3651,12 +3780,25 @@ function useTranslationWorkspace({
           cause
         };
         setError(workspaceError);
+        onTranslationError?.({ targetLocale: activeLocale, error: workspaceError });
         return { success: false, error: workspaceError };
       } finally {
         setIsTranslating(false);
       }
     },
-    [activeLocale, commit, currentSchema, readOnly, translationAdapter]
+    [
+      activeLocale,
+      commit,
+      currentSchema,
+      localeOptions,
+      onTranslationError,
+      onTranslationStart,
+      onTranslationSuccess,
+      readOnly,
+      slots,
+      sourceLocale,
+      translationAdapter
+    ]
   );
   const translateSlot = (0, import_react5.useCallback)(
     async (slot) => {
@@ -3674,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 = {
@@ -3688,18 +3838,24 @@ function useTranslationWorkspace({
         setIsTranslating(false);
       }
     },
-    [commit, currentSchema, readOnly, sourceLocale, translationAdapter]
+    [commit, currentSchema, onTranslationChange, readOnly, sourceLocale, translationAdapter]
   );
   return {
     sourceLocale,
     targetLocale: activeLocale,
     targetLocales,
-    setTargetLocale: setSelectedLocale,
+    localeOptions,
+    setTargetLocale: (locale) => {
+      const normalized = (0, import_core5.normalizeLocale)(locale) ?? locale;
+      setSelectedLocale(normalized);
+      onLocaleChange?.(normalized);
+    },
     slots,
     summary,
     addLocale,
     isAddLocaleAllowed,
     removeLocale,
+    ...removeLocaleConfirmation === null ? {} : { removeLocaleConfirmation },
     setTranslation,
     translateAll,
     translateSlot,

package/dist/index.d.cts

@@ -1,4 +1,5 @@
-import { QuestionType, FormField, ChoiceOption, FormPage, FormSchema, DisplayCondition, JsonValue, SchemaIssue, FormPolicy, Question, FieldOption, TranslationReport, ValidationIssue, ValidationError, FormValues, TranslationAdapter, AsyncTranslationAdapter, PopulateTranslationOptions, FormValue, AnswerValidationResult, TranslationSlot, FormEngineTranslator, FormEngineMessages, FieldType } from '@form-engine-ts/core';
+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, 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';
@@ -379,6 +380,76 @@ interface BuilderLocalizationSlotProps extends BuilderSlotBaseProps {
     readonly policy?: FormPolicy;
     readonly translationAdapterAvailable?: boolean;
 }
+interface TranslationWorkspaceHeaderProps {
+    readonly schema: FormSchema;
+    readonly sourceLocale: string;
+    readonly targetLocale: string;
+    readonly summary: {
+        readonly totalSlots: number;
+        readonly translatedCount: number;
+        readonly missingCount: number;
+        readonly staleCount: number;
+        readonly manualCount: number;
+        readonly completionPercentage: number;
+    };
+    readonly onTranslateAll: () => void;
+    readonly isTranslating: boolean;
+    readonly readOnly: boolean;
+}
+interface TranslationSlotRowProps {
+    readonly slot: _form_engine_ts_core.TranslationSlot;
+    readonly readOnly: boolean;
+    readonly onChange: (text: string) => void;
+    readonly onTranslate: () => void;
+}
+interface LocaleSelectorProps {
+    readonly targetLocale: string;
+    readonly targetLocales: readonly string[];
+    readonly localeOptions: readonly LocaleOption[];
+    readonly newLocale: string;
+    readonly readOnly: boolean;
+    readonly onTargetLocaleChange: (locale: string) => void;
+    readonly onNewLocaleChange: (locale: string) => void;
+    readonly onAddLocale: () => void;
+}
+interface TranslationWorkspaceActionsProps {
+    readonly onTranslateAll: () => void;
+    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;
+    readonly renderLocaleSelector?: (props: LocaleSelectorProps) => ReactNode;
+    readonly renderStatusBadge?: (props: {
+        readonly status: _form_engine_ts_core.TranslationStatus;
+    }) => ReactNode;
+    readonly renderActions?: (props: TranslationWorkspaceActionsProps) => ReactNode;
+    readonly confirmRemoveLocale?: (props: ConfirmRemoveLocaleSlotProps) => ReactNode;
+}
 interface LocalizationSummaryContext {
     readonly defaultLocale: string;
     readonly supportedLocales: readonly string[];
@@ -708,9 +779,25 @@ interface UseTranslationWorkspaceOptions {
     readonly translationAdapter?: TranslationAdapter | AsyncTranslationAdapter;
     readonly readOnly?: boolean;
     readonly policy?: FormPolicy;
+    readonly availableLocales?: readonly (string | LocaleOption)[];
+    readonly onLocaleAdded?: (locale: string) => void;
+    readonly onLocaleRemoved?: (locale: string) => void;
+    readonly onLocaleChange?: (targetLocale: string) => void;
     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 {
@@ -766,6 +853,7 @@ interface UseTranslationWorkspaceResult {
     readonly sourceLocale: string;
     readonly targetLocale: string;
     readonly targetLocales: readonly string[];
+    readonly localeOptions: readonly LocaleOption[];
     readonly setTargetLocale: (locale: string) => void;
     readonly slots: readonly TranslationSlot[];
     readonly summary: TranslationSummary;
@@ -775,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;
@@ -788,8 +877,8 @@ interface UseTranslationWorkspaceResult {
     readonly isTranslating: boolean;
     readonly error?: TranslationWorkspaceError;
 }
-declare const validateLocalePipeline: (locale: string, schema: FormSchema, policy?: FormPolicy, customValidator?: ((locale: string, currentLocales: readonly string[]) => LocaleValidationResult) | CustomLocaleValidator) => LocaleValidationResult;
-declare function useTranslationWorkspace({ schema, onChange, sourceLocale, targetLocale, translationAdapter, readOnly, policy, beforeRemoveLocale, validateLocale }: UseTranslationWorkspaceOptions): UseTranslationWorkspaceResult;
+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, confirmRemoveLocale, slots: workspaceSlots, onTranslationStart, onTranslationSuccess, onTranslationError, onTranslationChange, validateLocale }: UseTranslationWorkspaceOptions): UseTranslationWorkspaceResult;
 
 declare const BUILDER_TRANSLATION_KEYS: {
     readonly ADD_FIELD: "builder.actions.addField";
@@ -879,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 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 TranslationSummary, type TranslationWorkspaceError, 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,4 +1,5 @@
-import { QuestionType, FormField, ChoiceOption, FormPage, FormSchema, DisplayCondition, JsonValue, SchemaIssue, FormPolicy, Question, FieldOption, TranslationReport, ValidationIssue, ValidationError, FormValues, TranslationAdapter, AsyncTranslationAdapter, PopulateTranslationOptions, FormValue, AnswerValidationResult, TranslationSlot, FormEngineTranslator, FormEngineMessages, FieldType } from '@form-engine-ts/core';
+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, 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';
@@ -379,6 +380,76 @@ interface BuilderLocalizationSlotProps extends BuilderSlotBaseProps {
     readonly policy?: FormPolicy;
     readonly translationAdapterAvailable?: boolean;
 }
+interface TranslationWorkspaceHeaderProps {
+    readonly schema: FormSchema;
+    readonly sourceLocale: string;
+    readonly targetLocale: string;
+    readonly summary: {
+        readonly totalSlots: number;
+        readonly translatedCount: number;
+        readonly missingCount: number;
+        readonly staleCount: number;
+        readonly manualCount: number;
+        readonly completionPercentage: number;
+    };
+    readonly onTranslateAll: () => void;
+    readonly isTranslating: boolean;
+    readonly readOnly: boolean;
+}
+interface TranslationSlotRowProps {
+    readonly slot: _form_engine_ts_core.TranslationSlot;
+    readonly readOnly: boolean;
+    readonly onChange: (text: string) => void;
+    readonly onTranslate: () => void;
+}
+interface LocaleSelectorProps {
+    readonly targetLocale: string;
+    readonly targetLocales: readonly string[];
+    readonly localeOptions: readonly LocaleOption[];
+    readonly newLocale: string;
+    readonly readOnly: boolean;
+    readonly onTargetLocaleChange: (locale: string) => void;
+    readonly onNewLocaleChange: (locale: string) => void;
+    readonly onAddLocale: () => void;
+}
+interface TranslationWorkspaceActionsProps {
+    readonly onTranslateAll: () => void;
+    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;
+    readonly renderLocaleSelector?: (props: LocaleSelectorProps) => ReactNode;
+    readonly renderStatusBadge?: (props: {
+        readonly status: _form_engine_ts_core.TranslationStatus;
+    }) => ReactNode;
+    readonly renderActions?: (props: TranslationWorkspaceActionsProps) => ReactNode;
+    readonly confirmRemoveLocale?: (props: ConfirmRemoveLocaleSlotProps) => ReactNode;
+}
 interface LocalizationSummaryContext {
     readonly defaultLocale: string;
     readonly supportedLocales: readonly string[];
@@ -708,9 +779,25 @@ interface UseTranslationWorkspaceOptions {
     readonly translationAdapter?: TranslationAdapter | AsyncTranslationAdapter;
     readonly readOnly?: boolean;
     readonly policy?: FormPolicy;
+    readonly availableLocales?: readonly (string | LocaleOption)[];
+    readonly onLocaleAdded?: (locale: string) => void;
+    readonly onLocaleRemoved?: (locale: string) => void;
+    readonly onLocaleChange?: (targetLocale: string) => void;
     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 {
@@ -766,6 +853,7 @@ interface UseTranslationWorkspaceResult {
     readonly sourceLocale: string;
     readonly targetLocale: string;
     readonly targetLocales: readonly string[];
+    readonly localeOptions: readonly LocaleOption[];
     readonly setTargetLocale: (locale: string) => void;
     readonly slots: readonly TranslationSlot[];
     readonly summary: TranslationSummary;
@@ -775,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;
@@ -788,8 +877,8 @@ interface UseTranslationWorkspaceResult {
     readonly isTranslating: boolean;
     readonly error?: TranslationWorkspaceError;
 }
-declare const validateLocalePipeline: (locale: string, schema: FormSchema, policy?: FormPolicy, customValidator?: ((locale: string, currentLocales: readonly string[]) => LocaleValidationResult) | CustomLocaleValidator) => LocaleValidationResult;
-declare function useTranslationWorkspace({ schema, onChange, sourceLocale, targetLocale, translationAdapter, readOnly, policy, beforeRemoveLocale, validateLocale }: UseTranslationWorkspaceOptions): UseTranslationWorkspaceResult;
+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, confirmRemoveLocale, slots: workspaceSlots, onTranslationStart, onTranslationSuccess, onTranslationError, onTranslationChange, validateLocale }: UseTranslationWorkspaceOptions): UseTranslationWorkspaceResult;
 
 declare const BUILDER_TRANSLATION_KEYS: {
     readonly ADD_FIELD: "builder.actions.addField";
@@ -879,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 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 TranslationSummary, type TranslationWorkspaceError, 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];
@@ -3298,7 +3298,7 @@ function asAsyncAdapter(adapter) {
     )
   };
 }
-var validateLocalePipeline = (locale, schema, policy, customValidator) => {
+var validateLocalePipeline = (locale, schema, policy, customValidator, availableLocales) => {
   const canonicalLocale = normalizeLocale(locale);
   if (canonicalLocale === null) {
     return {
@@ -3311,6 +3311,18 @@ var validateLocalePipeline = (locale, schema, policy, customValidator) => {
   }
   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;
+  })) {
+    return {
+      valid: false,
+      error: {
+        type: "locale_not_allowed",
+        message: `Locale "${canonicalLocale}" is not available in the locale catalog.`
+      }
+    };
+  }
   if (canonicalLocale === defaultLocale || currentLocales.includes(canonicalLocale)) {
     return {
       valid: false,
@@ -3382,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") {
@@ -3410,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);
       })
     };
   }
@@ -3426,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);
           })
         };
       })
@@ -3438,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);
       })
     }
   };
@@ -3451,14 +3464,27 @@ function useTranslationWorkspace({
   translationAdapter,
   readOnly = false,
   policy,
+  availableLocales,
+  onLocaleAdded,
+  onLocaleRemoved,
+  onLocaleChange,
   beforeRemoveLocale,
+  confirmRemoveLocale,
+  slots: workspaceSlots,
+  onTranslationStart,
+  onTranslationSuccess,
+  onTranslationError,
+  onTranslationChange,
   validateLocale
 }) {
   const [draftSchema, setDraftSchema] = useState4(schema);
-  const [selectedLocale, setSelectedLocale] = useState4(targetLocale ?? "");
+  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(
@@ -3466,6 +3492,15 @@ function useTranslationWorkspace({
     );
   }, [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 slots = useMemo4(
     () => activeLocale.length === 0 ? [] : collectTranslationSlots(currentSchema, activeLocale),
     [activeLocale, currentSchema]
@@ -3499,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) => {
@@ -3513,14 +3556,14 @@ function useTranslationWorkspace({
       const normalized = normalizeLocale(locale);
       if (normalized === null) {
         const workspaceError = workspaceLocaleValidationError(
-          validateLocalePipeline(locale, currentSchema, policy, validateLocale),
+          validateLocalePipeline(locale, currentSchema, policy, validateLocale, availableLocales),
           collectSchemaLocales2(currentSchema).allUniqueLocales.size,
           locale
         );
         setError(workspaceError);
         return { success: false, error: workspaceError };
       }
-      const validation = validateLocalePipeline(normalized, currentSchema, policy, validateLocale);
+      const validation = validateLocalePipeline(normalized, currentSchema, policy, validateLocale, availableLocales);
       if (!validation.valid) {
         const workspaceError = workspaceLocaleValidationError(
           validation,
@@ -3536,42 +3579,62 @@ function useTranslationWorkspace({
         supportedLocales: [.../* @__PURE__ */ new Set([...currentSchema.supportedLocales ?? [], normalized])]
       });
       setSelectedLocale(normalized);
+      onLocaleAdded?.(normalized);
       return { success: true };
     },
-    [commit, currentSchema, policy, readOnly, validateLocale]
+    [availableLocales, commit, currentSchema, onLocaleAdded, policy, readOnly, validateLocale]
   );
   const isAddLocaleAllowed = useCallback3(
     (locale) => {
       if (readOnly) return false;
       const normalized = normalizeLocale(locale);
       if (normalized === null) return false;
-      return validateLocalePipeline(normalized, currentSchema, policy, validateLocale).valid;
+      return validateLocalePipeline(normalized, currentSchema, policy, validateLocale, availableLocales).valid;
     },
-    [currentSchema, policy, readOnly, validateLocale]
+    [availableLocales, currentSchema, policy, readOnly, validateLocale]
   );
   const removeLocale = useCallback3(
     (locale) => {
-      if (readOnly || locale === sourceLocale || locale === currentSchema.defaultLocale) return false;
+      const normalized = normalizeLocale(locale) ?? locale;
+      const normalizedSourceLocale = normalizeLocale(sourceLocale) ?? sourceLocale;
+      const normalizedDefaultLocale = currentSchema.defaultLocale === void 0 ? void 0 : normalizeLocale(currentSchema.defaultLocale) ?? currentSchema.defaultLocale;
+      if (readOnly || normalized === normalizedSourceLocale || normalized === normalizedDefaultLocale) return false;
       const remove = () => {
-        commit(removeLocaleFromSchema(currentSchema, locale));
-        if (activeLocale === locale) setSelectedLocale("");
+        commit(removeLocaleFromSchema(currentSchema, normalized));
+        if (activeLocale === normalized) setSelectedLocale("");
+        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();
       };
-      const slotCount = collectTranslationSlots(currentSchema, locale).length;
       if (beforeRemoveLocale === void 0) {
-        remove();
-        return true;
+        return removeAfterApproval();
       }
       try {
-        const decision = beforeRemoveLocale(locale, { slotCount });
+        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 = {
@@ -3583,8 +3646,45 @@ function useTranslationWorkspace({
         return Promise.reject(cause);
       }
     },
-    [activeLocale, beforeRemoveLocale, commit, currentSchema, 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) {
@@ -3602,8 +3702,26 @@ function useTranslationWorkspace({
         setError(workspaceError);
         return { success: false, error: workspaceError };
       }
+      const selectedLocaleOption = localeOptions.find(
+        (option) => (normalizeLocale(option.locale) ?? option.locale) === activeLocale
+      );
+      if (selectedLocaleOption?.translatable === false) {
+        setError(void 0);
+        return {
+          success: true,
+          report: {
+            updatedSlots: [],
+            skippedSlots: slots,
+            staleSlots: [],
+            skippedReasons: Object.fromEntries(
+              slots.map((slot) => [slot.path ?? `${slot.kind}.${slot.nodeId}.${slot.property}`, "unsupported"])
+            )
+          }
+        };
+      }
       setIsTranslating(true);
       setError(void 0);
+      onTranslationStart?.({ targetLocale: activeLocale, mode: "automatic" });
       try {
         const populated = await populateSchemaTranslations2(
           currentSchema,
@@ -3616,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 = {
@@ -3624,12 +3753,25 @@ function useTranslationWorkspace({
           cause
         };
         setError(workspaceError);
+        onTranslationError?.({ targetLocale: activeLocale, error: workspaceError });
         return { success: false, error: workspaceError };
       } finally {
         setIsTranslating(false);
       }
     },
-    [activeLocale, commit, currentSchema, readOnly, translationAdapter]
+    [
+      activeLocale,
+      commit,
+      currentSchema,
+      localeOptions,
+      onTranslationError,
+      onTranslationStart,
+      onTranslationSuccess,
+      readOnly,
+      slots,
+      sourceLocale,
+      translationAdapter
+    ]
   );
   const translateSlot = useCallback3(
     async (slot) => {
@@ -3647,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 = {
@@ -3661,18 +3811,24 @@ function useTranslationWorkspace({
         setIsTranslating(false);
       }
     },
-    [commit, currentSchema, readOnly, sourceLocale, translationAdapter]
+    [commit, currentSchema, onTranslationChange, readOnly, sourceLocale, translationAdapter]
   );
   return {
     sourceLocale,
     targetLocale: activeLocale,
     targetLocales,
-    setTargetLocale: setSelectedLocale,
+    localeOptions,
+    setTargetLocale: (locale) => {
+      const normalized = normalizeLocale(locale) ?? locale;
+      setSelectedLocale(normalized);
+      onLocaleChange?.(normalized);
+    },
     slots,
     summary,
     addLocale,
     isAddLocaleAllowed,
     removeLocale,
+    ...removeLocaleConfirmation === null ? {} : { removeLocaleConfirmation },
     setTranslation,
     translateAll,
     translateSlot,
@@ -3810,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";
@@ -4326,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);
@@ -4337,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.0.1",
+  "version": "6.0.0",
   "publishConfig": {
     "access": "public"
   },
@@ -42,8 +42,8 @@
     "typescript"
   ],
   "dependencies": {
-    "@form-engine-ts/core": "5.0.1",
-    "@form-engine-ts/privacy": "5.0.1"
+    "@form-engine-ts/core": "6.0.0",
+    "@form-engine-ts/privacy": "6.0.0"
   },
   "peerDependencies": {
     "react": ">=18.2 <20",