@form-engine-ts/react 5.0.1 → 5.1.0

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,
@@ -3478,11 +3490,15 @@ function useTranslationWorkspace({
   translationAdapter,
   readOnly = false,
   policy,
+  availableLocales,
+  onLocaleAdded,
+  onLocaleRemoved,
+  onLocaleChange,
   beforeRemoveLocale,
   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 currentSchema = onChange === void 0 ? draftSchema : schema;
@@ -3493,6 +3509,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]
@@ -3540,14 +3565,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,33 +3588,38 @@ 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, locale).length;
+      const slotCount = (0, import_core5.collectTranslationSlots)(currentSchema, normalized).length;
       if (beforeRemoveLocale === void 0) {
         remove();
         return true;
       }
       try {
-        const decision = beforeRemoveLocale(locale, { slotCount });
+        const decision = beforeRemoveLocale(normalized, { slotCount });
         if (typeof decision === "boolean") {
           if (!decision) return false;
           remove();
@@ -3610,7 +3640,7 @@ function useTranslationWorkspace({
         return Promise.reject(cause);
       }
     },
-    [activeLocale, beforeRemoveLocale, commit, currentSchema, readOnly, sourceLocale]
+    [activeLocale, beforeRemoveLocale, commit, currentSchema, onLocaleRemoved, readOnly, sourceLocale]
   );
   const translateAll = (0, import_react5.useCallback)(
     async (options = {}) => {
@@ -3629,6 +3659,23 @@ 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);
       try {
@@ -3656,7 +3703,7 @@ function useTranslationWorkspace({
         setIsTranslating(false);
       }
     },
-    [activeLocale, commit, currentSchema, readOnly, translationAdapter]
+    [activeLocale, commit, currentSchema, localeOptions, readOnly, slots, translationAdapter]
   );
   const translateSlot = (0, import_react5.useCallback)(
     async (slot) => {
@@ -3694,7 +3741,12 @@ function useTranslationWorkspace({
     sourceLocale,
     targetLocale: activeLocale,
     targetLocales,
-    setTargetLocale: setSelectedLocale,
+    localeOptions,
+    setTargetLocale: (locale) => {
+      const normalized = (0, import_core5.normalizeLocale)(locale) ?? locale;
+      setSelectedLocale(normalized);
+      onLocaleChange?.(normalized);
+    },
     slots,
     summary,
     addLocale,

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, TranslationAdapter, AsyncTranslationAdapter, PopulateTranslationOptions, FormValue, AnswerValidationResult, TranslationSlot, 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,52 @@ 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 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;
+}
 interface LocalizationSummaryContext {
     readonly defaultLocale: string;
     readonly supportedLocales: readonly string[];
@@ -708,6 +755,10 @@ 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;
@@ -766,6 +817,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;
@@ -788,8 +840,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, validateLocale }: UseTranslationWorkspaceOptions): UseTranslationWorkspaceResult;
 
 declare const BUILDER_TRANSLATION_KEYS: {
     readonly ADD_FIELD: "builder.actions.addField";
@@ -879,4 +931,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 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 };

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, TranslationAdapter, AsyncTranslationAdapter, PopulateTranslationOptions, FormValue, AnswerValidationResult, TranslationSlot, 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,52 @@ 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 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;
+}
 interface LocalizationSummaryContext {
     readonly defaultLocale: string;
     readonly supportedLocales: readonly string[];
@@ -708,6 +755,10 @@ 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;
@@ -766,6 +817,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;
@@ -788,8 +840,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, validateLocale }: UseTranslationWorkspaceOptions): UseTranslationWorkspaceResult;
 
 declare const BUILDER_TRANSLATION_KEYS: {
     readonly ADD_FIELD: "builder.actions.addField";
@@ -879,4 +931,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 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 };

package/dist/index.js

@@ -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,
@@ -3451,11 +3463,15 @@ function useTranslationWorkspace({
   translationAdapter,
   readOnly = false,
   policy,
+  availableLocales,
+  onLocaleAdded,
+  onLocaleRemoved,
+  onLocaleChange,
   beforeRemoveLocale,
   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 currentSchema = onChange === void 0 ? draftSchema : schema;
@@ -3466,6 +3482,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]
@@ -3513,14 +3538,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,33 +3561,38 @@ 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, locale).length;
+      const slotCount = collectTranslationSlots(currentSchema, normalized).length;
       if (beforeRemoveLocale === void 0) {
         remove();
         return true;
       }
       try {
-        const decision = beforeRemoveLocale(locale, { slotCount });
+        const decision = beforeRemoveLocale(normalized, { slotCount });
         if (typeof decision === "boolean") {
           if (!decision) return false;
           remove();
@@ -3583,7 +3613,7 @@ function useTranslationWorkspace({
         return Promise.reject(cause);
       }
     },
-    [activeLocale, beforeRemoveLocale, commit, currentSchema, readOnly, sourceLocale]
+    [activeLocale, beforeRemoveLocale, commit, currentSchema, onLocaleRemoved, readOnly, sourceLocale]
   );
   const translateAll = useCallback3(
     async (options = {}) => {
@@ -3602,6 +3632,23 @@ 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);
       try {
@@ -3629,7 +3676,7 @@ function useTranslationWorkspace({
         setIsTranslating(false);
       }
     },
-    [activeLocale, commit, currentSchema, readOnly, translationAdapter]
+    [activeLocale, commit, currentSchema, localeOptions, readOnly, slots, translationAdapter]
   );
   const translateSlot = useCallback3(
     async (slot) => {
@@ -3667,7 +3714,12 @@ function useTranslationWorkspace({
     sourceLocale,
     targetLocale: activeLocale,
     targetLocales,
-    setTargetLocale: setSelectedLocale,
+    localeOptions,
+    setTargetLocale: (locale) => {
+      const normalized = normalizeLocale(locale) ?? locale;
+      setSelectedLocale(normalized);
+      onLocaleChange?.(normalized);
+    },
     slots,
     summary,
     addLocale,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@form-engine-ts/react",
-  "version": "5.0.1",
+  "version": "5.1.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": "5.1.0",
+    "@form-engine-ts/privacy": "5.1.0"
   },
   "peerDependencies": {
     "react": ">=18.2 <20",