@form-engine-ts/react 4.5.0 → 4.7.0

package/README.md

@@ -79,6 +79,12 @@ 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`. Built-in BCP 47, duplicate, and policy checks always run
+before the optional `validateLocale` callback, which receives the locale, default locale, current locales, and policy.
+Use `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

@@ -39,7 +39,8 @@ __export(index_exports, {
   useForm: () => useForm,
   useFormBuilder: () => useFormBuilder,
   useSubmissionReceipts: () => useSubmissionReceipts,
-  useTranslationWorkspace: () => useTranslationWorkspace
+  useTranslationWorkspace: () => useTranslationWorkspace,
+  validateLocalePipeline: () => validateLocalePipeline
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -3281,6 +3282,88 @@ function asAsyncAdapter(adapter) {
     )
   };
 }
+function isValidBcp47Locale(locale) {
+  const language = locale.split("-")[0];
+  if (language === void 0 || !/^[a-z]{2,3}$/iu.test(language)) return false;
+  try {
+    Intl.getCanonicalLocales(locale);
+    return true;
+  } catch {
+    return false;
+  }
+}
+var validateLocalePipeline = (locale, schema, policy, customValidator) => {
+  const currentLocales = schema.supportedLocales ?? [];
+  const defaultLocale = schema.defaultLocale ?? "";
+  if (!isValidBcp47Locale(locale)) {
+    return {
+      valid: false,
+      error: {
+        type: "invalid_locale_format",
+        message: `Invalid BCP 47 locale format: "${locale}"`
+      }
+    };
+  }
+  if (locale === defaultLocale || currentLocales.includes(locale)) {
+    return {
+      valid: false,
+      error: {
+        type: "locale_already_exists",
+        message: `Locale "${locale}" is already registered.`
+      }
+    };
+  }
+  if (policy?.allowedLocales !== void 0 && !policy.allowedLocales.includes(locale)) {
+    return {
+      valid: false,
+      error: {
+        type: "locale_not_allowed",
+        message: `Locale "${locale}" is not allowed by policy.`
+      }
+    };
+  }
+  const totalLocalesCount = 1 + currentLocales.length;
+  if (policy?.maxLocales !== void 0 && totalLocalesCount >= policy.maxLocales) {
+    return {
+      valid: false,
+      error: {
+        type: "max_locales_exceeded",
+        message: `Cannot add locale: maximum allowed locales limit (${policy.maxLocales}) reached.`
+      }
+    };
+  }
+  if (customValidator !== void 0) {
+    const customContext = policy === void 0 ? Object.assign([...currentLocales], { locale, defaultLocale, currentLocales }) : Object.assign([...currentLocales], { locale, defaultLocale, currentLocales, policy });
+    const customResult = customValidator(locale, customContext);
+    if (customResult === false) {
+      return {
+        valid: false,
+        error: {
+          type: "custom_validation_failed",
+          message: `Custom validation rejected locale "${locale}".`
+        }
+      };
+    }
+    if (typeof customResult === "string") {
+      return {
+        valid: false,
+        error: { type: "custom_validation_failed", message: customResult }
+      };
+    }
+    if (typeof customResult === "object" && customResult !== null && !customResult.valid) return customResult;
+  }
+  return { valid: true };
+};
+function workspaceLocaleValidationMessage(validation) {
+  if (validation.error?.type === "locale_not_allowed") {
+    return validation.error.message.replace(" is not allowed by policy.", " is not allowed by the form policy.");
+  }
+  if (validation.error?.type === "max_locales_exceeded") {
+    const maximum = validation.error.message.match(/\((\d+)\)/u)?.[1];
+    return maximum === void 0 ? validation.error.message : `At most ${maximum} locales are allowed by the form policy.`;
+  }
+  return validation.error?.message ?? "Locale is not valid.";
+}
 function manualMetadata(sourceText, sourceLocale) {
   return {
     sourceLocale,
@@ -3348,7 +3431,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 +3486,31 @@ 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 validation = validateLocalePipeline(normalized, currentSchema, policy, validateLocale);
+      if (!validation.valid) return { success: false, error: workspaceLocaleValidationMessage(validation) };
       commit({
         ...currentSchema,
         supportedLocales: [.../* @__PURE__ */ new Set([...currentSchema.supportedLocales ?? [], normalized])]
       });
       setSelectedLocale(normalized);
+      return { success: true };
+    },
+    [commit, currentSchema, policy, readOnly, validateLocale]
+  );
+  const isAddLocaleAllowed = (0, import_react4.useCallback)(
+    (locale) => {
+      if (readOnly) return false;
+      const normalized = locale.trim();
+      return validateLocalePipeline(normalized, currentSchema, policy, validateLocale).valid;
     },
-    [commit, currentSchema, readOnly]
+    [currentSchema, policy, readOnly, 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 +3571,7 @@ function useTranslationWorkspace({
     slots,
     summary,
     addLocale,
+    isAddLocaleAllowed,
     removeLocale,
     setTranslation,
     translateAll,
@@ -4784,5 +4878,6 @@ function FormRenderer(props) {
   useForm,
   useFormBuilder,
   useSubmissionReceipts,
-  useTranslationWorkspace
+  useTranslationWorkspace,
+  validateLocalePipeline
 });

package/dist/index.d.cts

@@ -707,6 +707,22 @@ interface UseTranslationWorkspaceOptions {
     readonly targetLocale?: string;
     readonly translationAdapter?: TranslationAdapter | AsyncTranslationAdapter;
     readonly readOnly?: boolean;
+    readonly policy?: FormPolicy;
+    readonly validateLocale?: ((locale: string, currentLocales: readonly string[]) => LocaleValidationResult) | CustomLocaleValidator;
+}
+interface LocaleValidationContext {
+    readonly locale: string;
+    readonly defaultLocale: string;
+    readonly currentLocales: readonly string[];
+    readonly policy?: FormPolicy;
+}
+type CustomLocaleValidator = (locale: string, context: LocaleValidationContext) => LocaleValidationResult | boolean | string | undefined | void;
+interface LocaleValidationResult {
+    readonly valid: boolean;
+    readonly error?: {
+        readonly type: "locale_not_allowed" | "max_locales_exceeded" | "invalid_locale_format" | "locale_already_exists" | "custom_validation_failed";
+        readonly message: string;
+    };
 }
 interface TranslationSummary {
     readonly totalSlots: number;
@@ -723,7 +739,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 +751,8 @@ interface UseTranslationWorkspaceResult {
     readonly isTranslating: boolean;
     readonly error?: string;
 }
-declare function useTranslationWorkspace({ schema, onChange, sourceLocale, targetLocale, translationAdapter, readOnly }: UseTranslationWorkspaceOptions): UseTranslationWorkspaceResult;
+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, validateLocale }: UseTranslationWorkspaceOptions): UseTranslationWorkspaceResult;
 
 declare const BUILDER_TRANSLATION_KEYS: {
     readonly ADD_FIELD: "builder.actions.addField";
@@ -805,4 +826,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 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, 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 UseFormBuilderOptions, type UseFormBuilderResult, type UseSubmissionReceiptsResult, type UseTranslationWorkspaceOptions, type UseTranslationWorkspaceResult, createLocalStorageSubmissionAttemptStore, createLocalStorageSubmissionReceiptStore, isTranslationUnresolved, resolveChoiceFieldLayout, resolveFieldEditorControls, resolveFieldTypeSelectOptions, resolveInitialFieldType, resolveTranslation, submissionReceiptQueryKey, useField, useForm, useFormBuilder, useSubmissionReceipts, useTranslationWorkspace, validateLocalePipeline };

package/dist/index.d.ts

@@ -707,6 +707,22 @@ interface UseTranslationWorkspaceOptions {
     readonly targetLocale?: string;
     readonly translationAdapter?: TranslationAdapter | AsyncTranslationAdapter;
     readonly readOnly?: boolean;
+    readonly policy?: FormPolicy;
+    readonly validateLocale?: ((locale: string, currentLocales: readonly string[]) => LocaleValidationResult) | CustomLocaleValidator;
+}
+interface LocaleValidationContext {
+    readonly locale: string;
+    readonly defaultLocale: string;
+    readonly currentLocales: readonly string[];
+    readonly policy?: FormPolicy;
+}
+type CustomLocaleValidator = (locale: string, context: LocaleValidationContext) => LocaleValidationResult | boolean | string | undefined | void;
+interface LocaleValidationResult {
+    readonly valid: boolean;
+    readonly error?: {
+        readonly type: "locale_not_allowed" | "max_locales_exceeded" | "invalid_locale_format" | "locale_already_exists" | "custom_validation_failed";
+        readonly message: string;
+    };
 }
 interface TranslationSummary {
     readonly totalSlots: number;
@@ -723,7 +739,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 +751,8 @@ interface UseTranslationWorkspaceResult {
     readonly isTranslating: boolean;
     readonly error?: string;
 }
-declare function useTranslationWorkspace({ schema, onChange, sourceLocale, targetLocale, translationAdapter, readOnly }: UseTranslationWorkspaceOptions): UseTranslationWorkspaceResult;
+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, validateLocale }: UseTranslationWorkspaceOptions): UseTranslationWorkspaceResult;
 
 declare const BUILDER_TRANSLATION_KEYS: {
     readonly ADD_FIELD: "builder.actions.addField";
@@ -805,4 +826,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 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, 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 UseFormBuilderOptions, type UseFormBuilderResult, type UseSubmissionReceiptsResult, type UseTranslationWorkspaceOptions, type UseTranslationWorkspaceResult, createLocalStorageSubmissionAttemptStore, createLocalStorageSubmissionReceiptStore, isTranslationUnresolved, resolveChoiceFieldLayout, resolveFieldEditorControls, resolveFieldTypeSelectOptions, resolveInitialFieldType, resolveTranslation, submissionReceiptQueryKey, useField, useForm, useFormBuilder, useSubmissionReceipts, useTranslationWorkspace, validateLocalePipeline };

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,88 @@ function asAsyncAdapter(adapter) {
     )
   };
 }
+function isValidBcp47Locale(locale) {
+  const language = locale.split("-")[0];
+  if (language === void 0 || !/^[a-z]{2,3}$/iu.test(language)) return false;
+  try {
+    Intl.getCanonicalLocales(locale);
+    return true;
+  } catch {
+    return false;
+  }
+}
+var validateLocalePipeline = (locale, schema, policy, customValidator) => {
+  const currentLocales = schema.supportedLocales ?? [];
+  const defaultLocale = schema.defaultLocale ?? "";
+  if (!isValidBcp47Locale(locale)) {
+    return {
+      valid: false,
+      error: {
+        type: "invalid_locale_format",
+        message: `Invalid BCP 47 locale format: "${locale}"`
+      }
+    };
+  }
+  if (locale === defaultLocale || currentLocales.includes(locale)) {
+    return {
+      valid: false,
+      error: {
+        type: "locale_already_exists",
+        message: `Locale "${locale}" is already registered.`
+      }
+    };
+  }
+  if (policy?.allowedLocales !== void 0 && !policy.allowedLocales.includes(locale)) {
+    return {
+      valid: false,
+      error: {
+        type: "locale_not_allowed",
+        message: `Locale "${locale}" is not allowed by policy.`
+      }
+    };
+  }
+  const totalLocalesCount = 1 + currentLocales.length;
+  if (policy?.maxLocales !== void 0 && totalLocalesCount >= policy.maxLocales) {
+    return {
+      valid: false,
+      error: {
+        type: "max_locales_exceeded",
+        message: `Cannot add locale: maximum allowed locales limit (${policy.maxLocales}) reached.`
+      }
+    };
+  }
+  if (customValidator !== void 0) {
+    const customContext = policy === void 0 ? Object.assign([...currentLocales], { locale, defaultLocale, currentLocales }) : Object.assign([...currentLocales], { locale, defaultLocale, currentLocales, policy });
+    const customResult = customValidator(locale, customContext);
+    if (customResult === false) {
+      return {
+        valid: false,
+        error: {
+          type: "custom_validation_failed",
+          message: `Custom validation rejected locale "${locale}".`
+        }
+      };
+    }
+    if (typeof customResult === "string") {
+      return {
+        valid: false,
+        error: { type: "custom_validation_failed", message: customResult }
+      };
+    }
+    if (typeof customResult === "object" && customResult !== null && !customResult.valid) return customResult;
+  }
+  return { valid: true };
+};
+function workspaceLocaleValidationMessage(validation) {
+  if (validation.error?.type === "locale_not_allowed") {
+    return validation.error.message.replace(" is not allowed by policy.", " is not allowed by the form policy.");
+  }
+  if (validation.error?.type === "max_locales_exceeded") {
+    const maximum = validation.error.message.match(/\((\d+)\)/u)?.[1];
+    return maximum === void 0 ? validation.error.message : `At most ${maximum} locales are allowed by the form policy.`;
+  }
+  return validation.error?.message ?? "Locale is not valid.";
+}
 function manualMetadata(sourceText, sourceLocale) {
   return {
     sourceLocale,
@@ -3323,7 +3406,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 +3461,31 @@ 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 validation = validateLocalePipeline(normalized, currentSchema, policy, validateLocale);
+      if (!validation.valid) return { success: false, error: workspaceLocaleValidationMessage(validation) };
       commit({
         ...currentSchema,
         supportedLocales: [.../* @__PURE__ */ new Set([...currentSchema.supportedLocales ?? [], normalized])]
       });
       setSelectedLocale(normalized);
+      return { success: true };
+    },
+    [commit, currentSchema, policy, readOnly, validateLocale]
+  );
+  const isAddLocaleAllowed = useCallback3(
+    (locale) => {
+      if (readOnly) return false;
+      const normalized = locale.trim();
+      return validateLocalePipeline(normalized, currentSchema, policy, validateLocale).valid;
     },
-    [commit, currentSchema, readOnly]
+    [currentSchema, policy, readOnly, 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 +3546,7 @@ function useTranslationWorkspace({
     slots,
     summary,
     addLocale,
+    isAddLocaleAllowed,
     removeLocale,
     setTranslation,
     translateAll,
@@ -4769,5 +4863,6 @@ export {
   useForm,
   useFormBuilder,
   useSubmissionReceipts,
-  useTranslationWorkspace
+  useTranslationWorkspace,
+  validateLocalePipeline
 };

package/package.json

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