@form-engine-ts/react 4.3.2 → 4.5.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-import { QuestionType, FormField, ChoiceOption, FormPage, FormSchema, DisplayCondition, JsonValue, SchemaIssue, FormPolicy, Question, FieldOption, TranslationReport, ValidationError, FormValues, TranslationAdapter, AsyncTranslationAdapter, PopulateTranslationOptions, FormValue, ValidationIssue, AnswerValidationResult, FieldType } from '@form-engine-ts/core';
+import { QuestionType, FormField, ChoiceOption, FormPage, FormSchema, DisplayCondition, JsonValue, SchemaIssue, FormPolicy, Question, FieldOption, TranslationReport, ValidationIssue, ValidationError, FormValues, TranslationAdapter, AsyncTranslationAdapter, PopulateTranslationOptions, FormValue, AnswerValidationResult, TranslationSlot, FieldType } from '@form-engine-ts/core';
 export { QuestionType } from '@form-engine-ts/core';
 import * as react from 'react';
-import { ReactNode, ComponentType, KeyboardEvent, MouseEvent } from 'react';
+import { ReactNode, ComponentType, KeyboardEvent, MouseEvent, CSSProperties } from 'react';
 import { SensitiveDataFinding } from '@form-engine-ts/privacy';
 
 interface SubmissionAttempt {
@@ -37,7 +37,13 @@ interface FormBuilderOptions {
     readonly policy?: FormPolicy;
     readonly idFactory?: (kind: BuilderIdKind, existingIds: ReadonlySet<string>) => string;
     readonly factories?: BuilderFactories;
+    readonly fieldEditorMode?: FieldEditorMode;
+    readonly activeFieldId?: string;
+    readonly defaultActiveFieldId?: string;
+    readonly onActiveFieldChange?: (fieldId: string | undefined) => void;
 }
+type FieldEditorMode = "all" | "single";
+type UseFormBuilderOptions = FormBuilderOptions;
 type BuilderActionError = {
     readonly type: "invalid_id";
     readonly kind: BuilderIdKind;
@@ -104,8 +110,19 @@ interface FormBuilderResult {
     readonly addLocale: (locale: string) => BuilderActionResult;
     readonly setDefaultLocale: (locale: string) => BuilderActionResult;
     readonly validationIssues: readonly SchemaIssue[];
+    readonly activeFieldId?: string;
+    readonly setActiveFieldId?: (fieldId: string | undefined) => void;
+    readonly getFieldEditorProps?: (fieldId: string) => {
+        readonly isActive: boolean;
+        readonly isVisible: boolean;
+        readonly onSelect: () => void;
+    };
+}
+interface UseFormBuilderResult extends FormBuilderResult {
+    readonly setActiveFieldId: (fieldId: string | undefined) => void;
+    readonly getFieldEditorProps: NonNullable<FormBuilderResult["getFieldEditorProps"]>;
 }
-declare function useFormBuilder({ schema, onChange, policy, idFactory, factories }: FormBuilderOptions): FormBuilderResult;
+declare function useFormBuilder({ schema, onChange, policy, idFactory, factories, fieldEditorMode, activeFieldId: controlledActiveFieldId, defaultActiveFieldId, onActiveFieldChange }: FormBuilderOptions): FormBuilderResult;
 
 interface SubmissionReceipt {
     readonly formId: string;
@@ -376,7 +393,11 @@ interface BuilderTranslationActionsSlotProps extends BuilderSlotBaseProps {
     readonly onClearTranslationError?: () => void;
     readonly translationAdapterAvailable?: boolean;
 }
-type FormBuilderSectionName = "basicSettings" | "completionMessage" | "questions" | "addQuestion" | "localization";
+type FormBuilderSectionName = "basicSettings" | "completionMessage" | "questions" | "addQuestion" | "localization" | "submissionSettings";
+interface FormBuilderSubmissionSettingsOptions {
+    readonly enabled: boolean;
+    readonly placement?: "beforeQuestions" | "afterQuestions" | "bottom";
+}
 interface FormBuilderSlots {
     readonly toolbar?: ComponentType<BuilderToolbarSlotProps>;
     readonly fieldEditor?: ComponentType<BuilderFieldEditorSlotProps>;
@@ -478,13 +499,23 @@ type SubmissionGuardResult = {
 type SubmissionGuard = (schema: FormSchema, values: Record<string, unknown>) => SubmissionGuardResult | Promise<SubmissionGuardResult>;
 type FormSuccessRenderMode = "append" | "replace";
 type ChoiceFieldLayoutMode = "default" | "grouped";
+interface ChoiceFieldTypeLayoutMap {
+    readonly radio?: ChoiceFieldLayoutMode;
+    readonly checkbox?: ChoiceFieldLayoutMode;
+    readonly "multi-select"?: ChoiceFieldLayoutMode;
+    readonly select?: ChoiceFieldLayoutMode;
+}
+type FieldError = ValidationIssue & {
+    readonly message: string;
+};
 interface FormRendererAppearance {
     /**
-     * Layout preset for radio and checkbox questions.
+     * Layout preset for choice questions (radio, checkbox, and multi-select).
      * - "default": keep the flat question layout.
      * - "grouped": render a bordered fieldset and legend.
+     * - An object can configure each choice question type independently.
      */
-    readonly choiceField?: ChoiceFieldLayoutMode;
+    readonly choiceField?: ChoiceFieldLayoutMode | ChoiceFieldTypeLayoutMap;
 }
 type SubmissionConfirmationRenderMode = "inline" | "replace" | "dialog";
 interface SubmissionConfirmationOptions {
@@ -513,6 +544,23 @@ interface FormFieldsSlotProps {
     readonly children: ReactNode;
     readonly className?: string;
 }
+interface ChoiceGroupSlotProps {
+    readonly field: Question;
+    readonly title: string;
+    readonly description?: string;
+    readonly required?: boolean;
+    readonly error?: FieldError;
+    readonly disabled?: boolean;
+    readonly readOnly?: boolean;
+    readonly children: ReactNode;
+    readonly className?: string;
+}
+interface FormRendererSlotProps {
+    readonly choiceGroup?: {
+        readonly className?: string;
+        readonly style?: CSSProperties;
+    };
+}
 interface FormRendererSlots {
     readonly renderHeader?: (props: {
         readonly title: string;
@@ -563,6 +611,7 @@ interface FormRendererSlots {
         readonly current: number;
         readonly max: number;
     }) => ReactNode;
+    readonly renderChoiceGroup?: (props: ChoiceGroupSlotProps) => ReactNode;
 }
 interface SubmissionProtectionProps {
     readonly submissionGuards?: readonly SubmissionGuard[];
@@ -604,8 +653,13 @@ interface FormBuilderProps {
     readonly sectionOrder?: readonly FormBuilderSectionName[];
     readonly disableDefaultStyles?: boolean;
     readonly unstyled?: boolean;
+    readonly fieldEditorMode?: "all" | "single";
+    readonly activeFieldId?: string;
+    readonly defaultActiveFieldId?: string;
+    readonly onActiveFieldChange?: (fieldId: string | undefined) => void;
+    readonly submissionSettingsOptions?: FormBuilderSubmissionSettingsOptions;
 }
-declare function FormBuilder({ schema, onChange, locale, translator, translationAdapter, translationOptions, onTranslationReport, policy, idFactory, factories, className, defaultFieldType, onActionError, createManualTranslationMetadata, readOnly, features, fieldEditorControls, fieldTypeOptions, components: componentOverrides, slots, sectionOrder, disableDefaultStyles, unstyled }: FormBuilderProps): react.JSX.Element;
+declare function FormBuilder({ schema, onChange, locale, translator, translationAdapter, translationOptions, onTranslationReport, policy, idFactory, factories, className, defaultFieldType, onActionError, createManualTranslationMetadata, readOnly, features, fieldEditorControls, fieldTypeOptions, components: componentOverrides, slots, sectionOrder, disableDefaultStyles, unstyled, fieldEditorMode, activeFieldId, defaultActiveFieldId, onActiveFieldChange, submissionSettingsOptions }: FormBuilderProps): react.JSX.Element;
 
 type SubmitStatus = "idle" | "submitting" | "success" | "error";
 interface FormContextValue {
@@ -646,6 +700,39 @@ interface FieldState {
 }
 declare function useField(fieldId: string): FieldState;
 
+interface UseTranslationWorkspaceOptions {
+    readonly schema: FormSchema;
+    readonly onChange?: (schema: FormSchema) => void;
+    readonly sourceLocale?: string;
+    readonly targetLocale?: string;
+    readonly translationAdapter?: TranslationAdapter | AsyncTranslationAdapter;
+    readonly readOnly?: boolean;
+}
+interface TranslationSummary {
+    readonly totalSlots: number;
+    readonly translatedCount: number;
+    readonly missingCount: number;
+    readonly staleCount: number;
+    readonly manualCount: number;
+    readonly completionPercentage: number;
+}
+interface UseTranslationWorkspaceResult {
+    readonly sourceLocale: string;
+    readonly targetLocale: string;
+    readonly targetLocales: readonly string[];
+    readonly setTargetLocale: (locale: string) => void;
+    readonly slots: readonly TranslationSlot[];
+    readonly summary: TranslationSummary;
+    readonly addLocale: (locale: string) => void;
+    readonly removeLocale: (locale: string) => void;
+    readonly setTranslation: (slot: TranslationSlot, text: string) => void;
+    readonly translateAll: (options?: PopulateTranslationOptions) => Promise<TranslationReport>;
+    readonly translateSlot: (slot: TranslationSlot) => Promise<void>;
+    readonly isTranslating: boolean;
+    readonly error?: string;
+}
+declare function useTranslationWorkspace({ schema, onChange, sourceLocale, targetLocale, translationAdapter, readOnly }: UseTranslationWorkspaceOptions): UseTranslationWorkspaceResult;
+
 declare const BUILDER_TRANSLATION_KEYS: {
     readonly ADD_FIELD: "builder.actions.addField";
     readonly SELECT_FIELD_TYPE: "builder.fields.selectType";
@@ -665,6 +752,7 @@ declare const BUILDER_TRANSLATION_ALIASES: Readonly<Record<string, string>>;
 declare function isTranslationUnresolved(result: unknown, key: string, aliases?: readonly string[]): boolean;
 declare function resolveTranslation(key: string, aliases: readonly string[], adapter?: TranslationAdapter, defaultCatalog?: Readonly<Record<string, string>>, params?: Readonly<Record<string, unknown>>, locale?: string): string;
 
+declare function resolveChoiceFieldLayout(type: FieldType, appearance?: FormRendererAppearance, groupedChoiceFieldsLegacy?: boolean): "default" | "grouped";
 interface FieldComponentProps {
     readonly field: FormField;
     readonly value: FormValue;
@@ -681,6 +769,7 @@ interface FormRendererPresentationProps extends SubmissionProtectionProps {
     readonly components?: FieldComponents;
     readonly className?: string;
     readonly appearance?: FormRendererAppearance;
+    readonly slotProps?: FormRendererSlotProps;
     /** @deprecated Use appearance.choiceField="grouped" instead. */
     readonly groupedChoiceFields?: boolean;
     /**
@@ -716,4 +805,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 ComponentBaseProps, type FieldComponentProps, type FieldComponents, type FieldEditorControlsConfig, type FieldEditorHeaderSlotProps, 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 FormCompletionSlotProps, type FormContextValue, type FormFieldsSlotProps, FormProvider, type FormProviderProps, FormRenderer, type FormRendererAppearance, type FormRendererMessages, type FormRendererPresentationProps, type FormRendererProps, 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 UseSubmissionReceiptsResult, createLocalStorageSubmissionAttemptStore, createLocalStorageSubmissionReceiptStore, isTranslationUnresolved, resolveFieldEditorControls, resolveFieldTypeSelectOptions, resolveInitialFieldType, resolveTranslation, submissionReceiptQueryKey, useField, useForm, useFormBuilder, useSubmissionReceipts };
+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 };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { QuestionType, FormField, ChoiceOption, FormPage, FormSchema, DisplayCondition, JsonValue, SchemaIssue, FormPolicy, Question, FieldOption, TranslationReport, ValidationError, FormValues, TranslationAdapter, AsyncTranslationAdapter, PopulateTranslationOptions, FormValue, ValidationIssue, AnswerValidationResult, FieldType } from '@form-engine-ts/core';
+import { QuestionType, FormField, ChoiceOption, FormPage, FormSchema, DisplayCondition, JsonValue, SchemaIssue, FormPolicy, Question, FieldOption, TranslationReport, ValidationIssue, ValidationError, FormValues, TranslationAdapter, AsyncTranslationAdapter, PopulateTranslationOptions, FormValue, AnswerValidationResult, TranslationSlot, FieldType } from '@form-engine-ts/core';
 export { QuestionType } from '@form-engine-ts/core';
 import * as react from 'react';
-import { ReactNode, ComponentType, KeyboardEvent, MouseEvent } from 'react';
+import { ReactNode, ComponentType, KeyboardEvent, MouseEvent, CSSProperties } from 'react';
 import { SensitiveDataFinding } from '@form-engine-ts/privacy';
 
 interface SubmissionAttempt {
@@ -37,7 +37,13 @@ interface FormBuilderOptions {
     readonly policy?: FormPolicy;
     readonly idFactory?: (kind: BuilderIdKind, existingIds: ReadonlySet<string>) => string;
     readonly factories?: BuilderFactories;
+    readonly fieldEditorMode?: FieldEditorMode;
+    readonly activeFieldId?: string;
+    readonly defaultActiveFieldId?: string;
+    readonly onActiveFieldChange?: (fieldId: string | undefined) => void;
 }
+type FieldEditorMode = "all" | "single";
+type UseFormBuilderOptions = FormBuilderOptions;
 type BuilderActionError = {
     readonly type: "invalid_id";
     readonly kind: BuilderIdKind;
@@ -104,8 +110,19 @@ interface FormBuilderResult {
     readonly addLocale: (locale: string) => BuilderActionResult;
     readonly setDefaultLocale: (locale: string) => BuilderActionResult;
     readonly validationIssues: readonly SchemaIssue[];
+    readonly activeFieldId?: string;
+    readonly setActiveFieldId?: (fieldId: string | undefined) => void;
+    readonly getFieldEditorProps?: (fieldId: string) => {
+        readonly isActive: boolean;
+        readonly isVisible: boolean;
+        readonly onSelect: () => void;
+    };
+}
+interface UseFormBuilderResult extends FormBuilderResult {
+    readonly setActiveFieldId: (fieldId: string | undefined) => void;
+    readonly getFieldEditorProps: NonNullable<FormBuilderResult["getFieldEditorProps"]>;
 }
-declare function useFormBuilder({ schema, onChange, policy, idFactory, factories }: FormBuilderOptions): FormBuilderResult;
+declare function useFormBuilder({ schema, onChange, policy, idFactory, factories, fieldEditorMode, activeFieldId: controlledActiveFieldId, defaultActiveFieldId, onActiveFieldChange }: FormBuilderOptions): FormBuilderResult;
 
 interface SubmissionReceipt {
     readonly formId: string;
@@ -376,7 +393,11 @@ interface BuilderTranslationActionsSlotProps extends BuilderSlotBaseProps {
     readonly onClearTranslationError?: () => void;
     readonly translationAdapterAvailable?: boolean;
 }
-type FormBuilderSectionName = "basicSettings" | "completionMessage" | "questions" | "addQuestion" | "localization";
+type FormBuilderSectionName = "basicSettings" | "completionMessage" | "questions" | "addQuestion" | "localization" | "submissionSettings";
+interface FormBuilderSubmissionSettingsOptions {
+    readonly enabled: boolean;
+    readonly placement?: "beforeQuestions" | "afterQuestions" | "bottom";
+}
 interface FormBuilderSlots {
     readonly toolbar?: ComponentType<BuilderToolbarSlotProps>;
     readonly fieldEditor?: ComponentType<BuilderFieldEditorSlotProps>;
@@ -478,13 +499,23 @@ type SubmissionGuardResult = {
 type SubmissionGuard = (schema: FormSchema, values: Record<string, unknown>) => SubmissionGuardResult | Promise<SubmissionGuardResult>;
 type FormSuccessRenderMode = "append" | "replace";
 type ChoiceFieldLayoutMode = "default" | "grouped";
+interface ChoiceFieldTypeLayoutMap {
+    readonly radio?: ChoiceFieldLayoutMode;
+    readonly checkbox?: ChoiceFieldLayoutMode;
+    readonly "multi-select"?: ChoiceFieldLayoutMode;
+    readonly select?: ChoiceFieldLayoutMode;
+}
+type FieldError = ValidationIssue & {
+    readonly message: string;
+};
 interface FormRendererAppearance {
     /**
-     * Layout preset for radio and checkbox questions.
+     * Layout preset for choice questions (radio, checkbox, and multi-select).
      * - "default": keep the flat question layout.
      * - "grouped": render a bordered fieldset and legend.
+     * - An object can configure each choice question type independently.
      */
-    readonly choiceField?: ChoiceFieldLayoutMode;
+    readonly choiceField?: ChoiceFieldLayoutMode | ChoiceFieldTypeLayoutMap;
 }
 type SubmissionConfirmationRenderMode = "inline" | "replace" | "dialog";
 interface SubmissionConfirmationOptions {
@@ -513,6 +544,23 @@ interface FormFieldsSlotProps {
     readonly children: ReactNode;
     readonly className?: string;
 }
+interface ChoiceGroupSlotProps {
+    readonly field: Question;
+    readonly title: string;
+    readonly description?: string;
+    readonly required?: boolean;
+    readonly error?: FieldError;
+    readonly disabled?: boolean;
+    readonly readOnly?: boolean;
+    readonly children: ReactNode;
+    readonly className?: string;
+}
+interface FormRendererSlotProps {
+    readonly choiceGroup?: {
+        readonly className?: string;
+        readonly style?: CSSProperties;
+    };
+}
 interface FormRendererSlots {
     readonly renderHeader?: (props: {
         readonly title: string;
@@ -563,6 +611,7 @@ interface FormRendererSlots {
         readonly current: number;
         readonly max: number;
     }) => ReactNode;
+    readonly renderChoiceGroup?: (props: ChoiceGroupSlotProps) => ReactNode;
 }
 interface SubmissionProtectionProps {
     readonly submissionGuards?: readonly SubmissionGuard[];
@@ -604,8 +653,13 @@ interface FormBuilderProps {
     readonly sectionOrder?: readonly FormBuilderSectionName[];
     readonly disableDefaultStyles?: boolean;
     readonly unstyled?: boolean;
+    readonly fieldEditorMode?: "all" | "single";
+    readonly activeFieldId?: string;
+    readonly defaultActiveFieldId?: string;
+    readonly onActiveFieldChange?: (fieldId: string | undefined) => void;
+    readonly submissionSettingsOptions?: FormBuilderSubmissionSettingsOptions;
 }
-declare function FormBuilder({ schema, onChange, locale, translator, translationAdapter, translationOptions, onTranslationReport, policy, idFactory, factories, className, defaultFieldType, onActionError, createManualTranslationMetadata, readOnly, features, fieldEditorControls, fieldTypeOptions, components: componentOverrides, slots, sectionOrder, disableDefaultStyles, unstyled }: FormBuilderProps): react.JSX.Element;
+declare function FormBuilder({ schema, onChange, locale, translator, translationAdapter, translationOptions, onTranslationReport, policy, idFactory, factories, className, defaultFieldType, onActionError, createManualTranslationMetadata, readOnly, features, fieldEditorControls, fieldTypeOptions, components: componentOverrides, slots, sectionOrder, disableDefaultStyles, unstyled, fieldEditorMode, activeFieldId, defaultActiveFieldId, onActiveFieldChange, submissionSettingsOptions }: FormBuilderProps): react.JSX.Element;
 
 type SubmitStatus = "idle" | "submitting" | "success" | "error";
 interface FormContextValue {
@@ -646,6 +700,39 @@ interface FieldState {
 }
 declare function useField(fieldId: string): FieldState;
 
+interface UseTranslationWorkspaceOptions {
+    readonly schema: FormSchema;
+    readonly onChange?: (schema: FormSchema) => void;
+    readonly sourceLocale?: string;
+    readonly targetLocale?: string;
+    readonly translationAdapter?: TranslationAdapter | AsyncTranslationAdapter;
+    readonly readOnly?: boolean;
+}
+interface TranslationSummary {
+    readonly totalSlots: number;
+    readonly translatedCount: number;
+    readonly missingCount: number;
+    readonly staleCount: number;
+    readonly manualCount: number;
+    readonly completionPercentage: number;
+}
+interface UseTranslationWorkspaceResult {
+    readonly sourceLocale: string;
+    readonly targetLocale: string;
+    readonly targetLocales: readonly string[];
+    readonly setTargetLocale: (locale: string) => void;
+    readonly slots: readonly TranslationSlot[];
+    readonly summary: TranslationSummary;
+    readonly addLocale: (locale: string) => void;
+    readonly removeLocale: (locale: string) => void;
+    readonly setTranslation: (slot: TranslationSlot, text: string) => void;
+    readonly translateAll: (options?: PopulateTranslationOptions) => Promise<TranslationReport>;
+    readonly translateSlot: (slot: TranslationSlot) => Promise<void>;
+    readonly isTranslating: boolean;
+    readonly error?: string;
+}
+declare function useTranslationWorkspace({ schema, onChange, sourceLocale, targetLocale, translationAdapter, readOnly }: UseTranslationWorkspaceOptions): UseTranslationWorkspaceResult;
+
 declare const BUILDER_TRANSLATION_KEYS: {
     readonly ADD_FIELD: "builder.actions.addField";
     readonly SELECT_FIELD_TYPE: "builder.fields.selectType";
@@ -665,6 +752,7 @@ declare const BUILDER_TRANSLATION_ALIASES: Readonly<Record<string, string>>;
 declare function isTranslationUnresolved(result: unknown, key: string, aliases?: readonly string[]): boolean;
 declare function resolveTranslation(key: string, aliases: readonly string[], adapter?: TranslationAdapter, defaultCatalog?: Readonly<Record<string, string>>, params?: Readonly<Record<string, unknown>>, locale?: string): string;
 
+declare function resolveChoiceFieldLayout(type: FieldType, appearance?: FormRendererAppearance, groupedChoiceFieldsLegacy?: boolean): "default" | "grouped";
 interface FieldComponentProps {
     readonly field: FormField;
     readonly value: FormValue;
@@ -681,6 +769,7 @@ interface FormRendererPresentationProps extends SubmissionProtectionProps {
     readonly components?: FieldComponents;
     readonly className?: string;
     readonly appearance?: FormRendererAppearance;
+    readonly slotProps?: FormRendererSlotProps;
     /** @deprecated Use appearance.choiceField="grouped" instead. */
     readonly groupedChoiceFields?: boolean;
     /**
@@ -716,4 +805,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 ComponentBaseProps, type FieldComponentProps, type FieldComponents, type FieldEditorControlsConfig, type FieldEditorHeaderSlotProps, 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 FormCompletionSlotProps, type FormContextValue, type FormFieldsSlotProps, FormProvider, type FormProviderProps, FormRenderer, type FormRendererAppearance, type FormRendererMessages, type FormRendererPresentationProps, type FormRendererProps, 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 UseSubmissionReceiptsResult, createLocalStorageSubmissionAttemptStore, createLocalStorageSubmissionReceiptStore, isTranslationUnresolved, resolveFieldEditorControls, resolveFieldTypeSelectOptions, resolveInitialFieldType, resolveTranslation, submissionReceiptQueryKey, useField, useForm, useFormBuilder, useSubmissionReceipts };
+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 };