@form-engine-ts/react 4.5.0 → 4.6.0

package/README.md

@@ -79,6 +79,11 @@ single-slot or batch translation with stale/manual status handling. The MUI pack
 `setActiveFieldId` to keep one field editor open at a time. Set `submissionSettingsOptions={{ enabled: true }}` to expose
 schema-driven pre-submit confirmation controls in the builder.
 
+`useTranslationWorkspace` validates added locales against `policy.allowedLocales` and `policy.maxLocales` and returns
+a structured `{ success, error }` result from `addLocale`. Use `validateLocale` for application-specific BCP 47 or
+tenant rules, and `isAddLocaleAllowed` to disable locale controls before submission. Removing a locale also clears its
+localized values and metadata; the default locale remains protected.
+
 ## Headless builder and renderer lifecycle
 
 `useFormBuilder({ schema, onChange, policy, idFactory, factories })` exposes controlled field, option, page, condition,

package/dist/index.cjs

@@ -3281,6 +3281,38 @@ function asAsyncAdapter(adapter) {
     )
   };
 }
+function validateLocaleByPolicy(locale, currentLocales, policy) {
+  if (locale.length === 0) {
+    return {
+      valid: false,
+      error: { type: "invalid_locale_format", message: "Locale must not be empty." }
+    };
+  }
+  try {
+    Intl.getCanonicalLocales(locale);
+  } catch {
+    return {
+      valid: false,
+      error: { type: "invalid_locale_format", message: `Locale "${locale}" is not a valid BCP 47 locale.` }
+    };
+  }
+  if (policy?.allowedLocales !== void 0 && !policy.allowedLocales.includes(locale)) {
+    return {
+      valid: false,
+      error: { type: "locale_not_allowed", message: `Locale "${locale}" is not allowed by the form policy.` }
+    };
+  }
+  if (policy?.maxLocales !== void 0 && !currentLocales.includes(locale) && currentLocales.length >= policy.maxLocales) {
+    return {
+      valid: false,
+      error: {
+        type: "max_locales_exceeded",
+        message: `At most ${policy.maxLocales} locales are allowed by the form policy.`
+      }
+    };
+  }
+  return { valid: true };
+}
 function manualMetadata(sourceText, sourceLocale) {
   return {
     sourceLocale,
@@ -3348,7 +3380,9 @@ function useTranslationWorkspace({
   sourceLocale = schema.defaultLocale ?? "en",
   targetLocale,
   translationAdapter,
-  readOnly = false
+  readOnly = false,
+  policy,
+  validateLocale
 }) {
   const [draftSchema, setDraftSchema] = (0, import_react4.useState)(schema);
   const [selectedLocale, setSelectedLocale] = (0, import_react4.useState)(targetLocale ?? "");
@@ -3401,23 +3435,50 @@ function useTranslationWorkspace({
   );
   const addLocale = (0, import_react4.useCallback)(
     (locale) => {
-      if (readOnly || locale.trim().length === 0) return;
+      if (readOnly) return { success: false, error: "Workspace is read-only." };
       const normalized = locale.trim();
+      const currentLocales = [
+        .../* @__PURE__ */ new Set([
+          ...currentSchema.defaultLocale === void 0 ? [] : [currentSchema.defaultLocale],
+          sourceLocale,
+          ...(0, import_core4.collectSchemaLocales)(currentSchema).allUniqueLocales
+        ])
+      ];
+      const validation = validateLocale?.(normalized, currentLocales) ?? validateLocaleByPolicy(normalized, currentLocales, policy);
+      if (!validation.valid) return { success: false, error: validation.error?.message ?? "Locale is not valid." };
+      const alreadyRegistered = normalized === sourceLocale || normalized === currentSchema.defaultLocale || (currentSchema.supportedLocales ?? []).includes(normalized);
+      if (alreadyRegistered) {
+        setSelectedLocale(normalized);
+        return { success: true };
+      }
       commit({
         ...currentSchema,
         supportedLocales: [.../* @__PURE__ */ new Set([...currentSchema.supportedLocales ?? [], normalized])]
       });
       setSelectedLocale(normalized);
+      return { success: true };
+    },
+    [commit, currentSchema, policy, readOnly, sourceLocale, validateLocale]
+  );
+  const isAddLocaleAllowed = (0, import_react4.useCallback)(
+    (locale) => {
+      if (readOnly) return false;
+      const normalized = locale.trim();
+      const currentLocales = [
+        .../* @__PURE__ */ new Set([
+          ...currentSchema.defaultLocale === void 0 ? [] : [currentSchema.defaultLocale],
+          sourceLocale,
+          ...(0, import_core4.collectSchemaLocales)(currentSchema).allUniqueLocales
+        ])
+      ];
+      return (validateLocale?.(normalized, currentLocales) ?? validateLocaleByPolicy(normalized, currentLocales, policy)).valid;
     },
-    [commit, currentSchema, readOnly]
+    [currentSchema, policy, readOnly, sourceLocale, validateLocale]
   );
   const removeLocale = (0, import_react4.useCallback)(
     (locale) => {
-      if (readOnly || locale === sourceLocale) return;
-      commit({
-        ...currentSchema,
-        supportedLocales: (currentSchema.supportedLocales ?? []).filter((candidate) => candidate !== locale)
-      });
+      if (readOnly || locale === sourceLocale || locale === currentSchema.defaultLocale) return;
+      commit((0, import_core4.removeLocaleFromSchema)(currentSchema, locale));
       if (activeLocale === locale) setSelectedLocale("");
     },
     [activeLocale, commit, currentSchema, readOnly, sourceLocale]
@@ -3478,6 +3539,7 @@ function useTranslationWorkspace({
     slots,
     summary,
     addLocale,
+    isAddLocaleAllowed,
     removeLocale,
     setTranslation,
     translateAll,

package/dist/index.d.cts

@@ -707,6 +707,15 @@ interface UseTranslationWorkspaceOptions {
     readonly targetLocale?: string;
     readonly translationAdapter?: TranslationAdapter | AsyncTranslationAdapter;
     readonly readOnly?: boolean;
+    readonly policy?: FormPolicy;
+    readonly validateLocale?: (locale: string, currentLocales: readonly string[]) => LocaleValidationResult;
+}
+interface LocaleValidationResult {
+    readonly valid: boolean;
+    readonly error?: {
+        readonly type: "locale_not_allowed" | "max_locales_exceeded" | "invalid_locale_format";
+        readonly message: string;
+    };
 }
 interface TranslationSummary {
     readonly totalSlots: number;
@@ -723,7 +732,11 @@ interface UseTranslationWorkspaceResult {
     readonly setTargetLocale: (locale: string) => void;
     readonly slots: readonly TranslationSlot[];
     readonly summary: TranslationSummary;
-    readonly addLocale: (locale: string) => void;
+    readonly addLocale: (locale: string) => {
+        readonly success: boolean;
+        readonly error?: string;
+    };
+    readonly isAddLocaleAllowed: (locale: string) => boolean;
     readonly removeLocale: (locale: string) => void;
     readonly setTranslation: (slot: TranslationSlot, text: string) => void;
     readonly translateAll: (options?: PopulateTranslationOptions) => Promise<TranslationReport>;
@@ -731,7 +744,7 @@ interface UseTranslationWorkspaceResult {
     readonly isTranslating: boolean;
     readonly error?: string;
 }
-declare function useTranslationWorkspace({ schema, onChange, sourceLocale, targetLocale, translationAdapter, readOnly }: UseTranslationWorkspaceOptions): UseTranslationWorkspaceResult;
+declare function useTranslationWorkspace({ schema, onChange, sourceLocale, targetLocale, translationAdapter, readOnly, policy, validateLocale }: UseTranslationWorkspaceOptions): UseTranslationWorkspaceResult;
 
 declare const BUILDER_TRANSLATION_KEYS: {
     readonly ADD_FIELD: "builder.actions.addField";
@@ -805,4 +818,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 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, 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 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 UseFormBuilderOptions, type UseFormBuilderResult, type UseSubmissionReceiptsResult, type UseTranslationWorkspaceOptions, type UseTranslationWorkspaceResult, createLocalStorageSubmissionAttemptStore, createLocalStorageSubmissionReceiptStore, isTranslationUnresolved, resolveChoiceFieldLayout, resolveFieldEditorControls, resolveFieldTypeSelectOptions, resolveInitialFieldType, resolveTranslation, submissionReceiptQueryKey, useField, useForm, useFormBuilder, useSubmissionReceipts, useTranslationWorkspace };
+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 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, 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 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 UseFormBuilderOptions, type UseFormBuilderResult, type UseSubmissionReceiptsResult, type UseTranslationWorkspaceOptions, type UseTranslationWorkspaceResult, createLocalStorageSubmissionAttemptStore, createLocalStorageSubmissionReceiptStore, isTranslationUnresolved, resolveChoiceFieldLayout, resolveFieldEditorControls, resolveFieldTypeSelectOptions, resolveInitialFieldType, resolveTranslation, submissionReceiptQueryKey, useField, useForm, useFormBuilder, useSubmissionReceipts, useTranslationWorkspace };

package/dist/index.d.ts

@@ -707,6 +707,15 @@ interface UseTranslationWorkspaceOptions {
     readonly targetLocale?: string;
     readonly translationAdapter?: TranslationAdapter | AsyncTranslationAdapter;
     readonly readOnly?: boolean;
+    readonly policy?: FormPolicy;
+    readonly validateLocale?: (locale: string, currentLocales: readonly string[]) => LocaleValidationResult;
+}
+interface LocaleValidationResult {
+    readonly valid: boolean;
+    readonly error?: {
+        readonly type: "locale_not_allowed" | "max_locales_exceeded" | "invalid_locale_format";
+        readonly message: string;
+    };
 }
 interface TranslationSummary {
     readonly totalSlots: number;
@@ -723,7 +732,11 @@ interface UseTranslationWorkspaceResult {
     readonly setTargetLocale: (locale: string) => void;
     readonly slots: readonly TranslationSlot[];
     readonly summary: TranslationSummary;
-    readonly addLocale: (locale: string) => void;
+    readonly addLocale: (locale: string) => {
+        readonly success: boolean;
+        readonly error?: string;
+    };
+    readonly isAddLocaleAllowed: (locale: string) => boolean;
     readonly removeLocale: (locale: string) => void;
     readonly setTranslation: (slot: TranslationSlot, text: string) => void;
     readonly translateAll: (options?: PopulateTranslationOptions) => Promise<TranslationReport>;
@@ -731,7 +744,7 @@ interface UseTranslationWorkspaceResult {
     readonly isTranslating: boolean;
     readonly error?: string;
 }
-declare function useTranslationWorkspace({ schema, onChange, sourceLocale, targetLocale, translationAdapter, readOnly }: UseTranslationWorkspaceOptions): UseTranslationWorkspaceResult;
+declare function useTranslationWorkspace({ schema, onChange, sourceLocale, targetLocale, translationAdapter, readOnly, policy, validateLocale }: UseTranslationWorkspaceOptions): UseTranslationWorkspaceResult;
 
 declare const BUILDER_TRANSLATION_KEYS: {
     readonly ADD_FIELD: "builder.actions.addField";
@@ -805,4 +818,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 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, 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 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 UseFormBuilderOptions, type UseFormBuilderResult, type UseSubmissionReceiptsResult, type UseTranslationWorkspaceOptions, type UseTranslationWorkspaceResult, createLocalStorageSubmissionAttemptStore, createLocalStorageSubmissionReceiptStore, isTranslationUnresolved, resolveChoiceFieldLayout, resolveFieldEditorControls, resolveFieldTypeSelectOptions, resolveInitialFieldType, resolveTranslation, submissionReceiptQueryKey, useField, useForm, useFormBuilder, useSubmissionReceipts, useTranslationWorkspace };
+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 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, 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 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 UseFormBuilderOptions, type UseFormBuilderResult, type UseSubmissionReceiptsResult, type UseTranslationWorkspaceOptions, type UseTranslationWorkspaceResult, createLocalStorageSubmissionAttemptStore, createLocalStorageSubmissionReceiptStore, isTranslationUnresolved, resolveChoiceFieldLayout, resolveFieldEditorControls, resolveFieldTypeSelectOptions, resolveInitialFieldType, resolveTranslation, submissionReceiptQueryKey, useField, useForm, useFormBuilder, useSubmissionReceipts, useTranslationWorkspace };

package/dist/index.js

@@ -3238,7 +3238,8 @@ import {
   collectSchemaLocales as collectSchemaLocales2,
   collectTranslationSlots,
   computeSourceTextHash,
-  populateSchemaTranslations as populateSchemaTranslations2
+  populateSchemaTranslations as populateSchemaTranslations2,
+  removeLocaleFromSchema
 } from "@form-engine-ts/core";
 import { useCallback as useCallback3, useMemo as useMemo3, useState as useState4 } from "react";
 function updateTranslationMap(translations, locale, property, text) {
@@ -3256,6 +3257,38 @@ function asAsyncAdapter(adapter) {
     )
   };
 }
+function validateLocaleByPolicy(locale, currentLocales, policy) {
+  if (locale.length === 0) {
+    return {
+      valid: false,
+      error: { type: "invalid_locale_format", message: "Locale must not be empty." }
+    };
+  }
+  try {
+    Intl.getCanonicalLocales(locale);
+  } catch {
+    return {
+      valid: false,
+      error: { type: "invalid_locale_format", message: `Locale "${locale}" is not a valid BCP 47 locale.` }
+    };
+  }
+  if (policy?.allowedLocales !== void 0 && !policy.allowedLocales.includes(locale)) {
+    return {
+      valid: false,
+      error: { type: "locale_not_allowed", message: `Locale "${locale}" is not allowed by the form policy.` }
+    };
+  }
+  if (policy?.maxLocales !== void 0 && !currentLocales.includes(locale) && currentLocales.length >= policy.maxLocales) {
+    return {
+      valid: false,
+      error: {
+        type: "max_locales_exceeded",
+        message: `At most ${policy.maxLocales} locales are allowed by the form policy.`
+      }
+    };
+  }
+  return { valid: true };
+}
 function manualMetadata(sourceText, sourceLocale) {
   return {
     sourceLocale,
@@ -3323,7 +3356,9 @@ function useTranslationWorkspace({
   sourceLocale = schema.defaultLocale ?? "en",
   targetLocale,
   translationAdapter,
-  readOnly = false
+  readOnly = false,
+  policy,
+  validateLocale
 }) {
   const [draftSchema, setDraftSchema] = useState4(schema);
   const [selectedLocale, setSelectedLocale] = useState4(targetLocale ?? "");
@@ -3376,23 +3411,50 @@ function useTranslationWorkspace({
   );
   const addLocale = useCallback3(
     (locale) => {
-      if (readOnly || locale.trim().length === 0) return;
+      if (readOnly) return { success: false, error: "Workspace is read-only." };
       const normalized = locale.trim();
+      const currentLocales = [
+        .../* @__PURE__ */ new Set([
+          ...currentSchema.defaultLocale === void 0 ? [] : [currentSchema.defaultLocale],
+          sourceLocale,
+          ...collectSchemaLocales2(currentSchema).allUniqueLocales
+        ])
+      ];
+      const validation = validateLocale?.(normalized, currentLocales) ?? validateLocaleByPolicy(normalized, currentLocales, policy);
+      if (!validation.valid) return { success: false, error: validation.error?.message ?? "Locale is not valid." };
+      const alreadyRegistered = normalized === sourceLocale || normalized === currentSchema.defaultLocale || (currentSchema.supportedLocales ?? []).includes(normalized);
+      if (alreadyRegistered) {
+        setSelectedLocale(normalized);
+        return { success: true };
+      }
       commit({
         ...currentSchema,
         supportedLocales: [.../* @__PURE__ */ new Set([...currentSchema.supportedLocales ?? [], normalized])]
       });
       setSelectedLocale(normalized);
+      return { success: true };
+    },
+    [commit, currentSchema, policy, readOnly, sourceLocale, validateLocale]
+  );
+  const isAddLocaleAllowed = useCallback3(
+    (locale) => {
+      if (readOnly) return false;
+      const normalized = locale.trim();
+      const currentLocales = [
+        .../* @__PURE__ */ new Set([
+          ...currentSchema.defaultLocale === void 0 ? [] : [currentSchema.defaultLocale],
+          sourceLocale,
+          ...collectSchemaLocales2(currentSchema).allUniqueLocales
+        ])
+      ];
+      return (validateLocale?.(normalized, currentLocales) ?? validateLocaleByPolicy(normalized, currentLocales, policy)).valid;
     },
-    [commit, currentSchema, readOnly]
+    [currentSchema, policy, readOnly, sourceLocale, validateLocale]
   );
   const removeLocale = useCallback3(
     (locale) => {
-      if (readOnly || locale === sourceLocale) return;
-      commit({
-        ...currentSchema,
-        supportedLocales: (currentSchema.supportedLocales ?? []).filter((candidate) => candidate !== locale)
-      });
+      if (readOnly || locale === sourceLocale || locale === currentSchema.defaultLocale) return;
+      commit(removeLocaleFromSchema(currentSchema, locale));
       if (activeLocale === locale) setSelectedLocale("");
     },
     [activeLocale, commit, currentSchema, readOnly, sourceLocale]
@@ -3453,6 +3515,7 @@ function useTranslationWorkspace({
     slots,
     summary,
     addLocale,
+    isAddLocaleAllowed,
     removeLocale,
     setTranslation,
     translateAll,

package/package.json

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