@form-engine-ts/react 2.9.6 → 3.1.0

package/dist/index.d.cts

@@ -1,6 +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';
+export { QuestionType } from '@form-engine-ts/core';
 import * as react from 'react';
-import { ReactNode, ComponentType, MouseEvent } from 'react';
-import { QuestionType, FormField, ChoiceOption, FormPage, FormSchema, DisplayCondition, JsonValue, SchemaIssue, FormPolicy, FieldOption, TranslationReport, ValidationError, FormValues, TranslationAdapter, AsyncTranslationAdapter, PopulateTranslationOptions, FormValue, ValidationIssue, AnswerValidationResult, FieldType } from '@form-engine-ts/core';
+import { ReactNode, ComponentType, KeyboardEvent, MouseEvent } from 'react';
 import { SensitiveDataFinding } from '@form-engine-ts/privacy';
 
 interface SubmissionAttempt {
@@ -139,6 +140,7 @@ interface ComponentBaseProps {
 type BuilderActionIconType = "moveUp" | "moveDown" | "delete" | "add" | "edit" | "settings" | "translate" | "close" | "dragHandle";
 interface BuilderButtonProps extends ComponentBaseProps {
     readonly onClick?: () => void;
+    readonly noWrap?: boolean;
     readonly variant?: "primary" | "secondary" | "danger";
     readonly children: ReactNode;
     readonly title?: string;
@@ -165,6 +167,7 @@ interface InputComponentProps extends ComponentBaseProps {
     readonly helperText?: string;
     readonly value: string;
     readonly onChange: (value: string) => void;
+    readonly onKeyDown?: (event: KeyboardEvent<HTMLElement>) => void;
     readonly placeholder?: string;
     readonly maxLength?: number;
 }
@@ -181,10 +184,21 @@ interface BuilderTextAreaProps extends InputComponentProps {
 interface BuilderSelectOption {
     readonly label: string;
     readonly value: string;
+    readonly icon?: ReactNode;
+    readonly description?: string;
     readonly disabled?: boolean;
+    readonly kind?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+interface SelectComponentProps extends InputComponentProps {
+    readonly options: readonly (string | BuilderSelectOption)[];
+    readonly renderOption?: (option: BuilderSelectOption) => ReactNode;
+    readonly renderValue?: (option: BuilderSelectOption | undefined) => ReactNode;
 }
 interface BuilderSelectProps extends InputComponentProps {
     readonly options: readonly BuilderSelectOption[];
+    readonly renderOption?: (option: BuilderSelectOption) => ReactNode;
+    readonly renderValue?: (option: BuilderSelectOption | undefined) => ReactNode;
 }
 interface BuilderCheckboxProps extends ComponentBaseProps {
     readonly name?: string;
@@ -227,6 +241,7 @@ interface FormBuilderComponents {
         readonly message: string;
     }>;
     readonly renderIcon?: (actionType: BuilderActionIconType) => ReactNode;
+    readonly renderFieldTypeIcon?: (type: QuestionType) => ReactNode;
 }
 type FormBuilderActions = Omit<FormBuilderResult, "schema" | "validationIssues">;
 interface ManualTranslationTarget {
@@ -263,6 +278,21 @@ interface BuilderFieldEditorSlotProps extends BuilderSlotBaseProps {
         readonly localization?: boolean;
         readonly conditions?: boolean;
     };
+    readonly slots?: Pick<FormBuilderSlots, "fieldTypeSelect" | "fieldEditorHeader">;
+}
+interface FieldTypeSelectSlotProps {
+    readonly currentType: QuestionType;
+    readonly allowedTypes: readonly QuestionType[];
+    readonly onChangeType: (nextType: QuestionType) => void;
+    readonly disabled?: boolean;
+    readonly readOnly?: boolean;
+    readonly renderIcon?: (type: QuestionType) => ReactNode;
+}
+interface FieldEditorHeaderSlotProps {
+    readonly field: Question;
+    readonly index: number;
+    readonly totalFields: number;
+    readonly actions: FormBuilderActions;
 }
 interface BuilderOptionEditorSlotProps extends BuilderSlotBaseProps {
     readonly field: FormField & {
@@ -289,6 +319,11 @@ interface BuilderLocalizationSlotProps extends BuilderSlotBaseProps {
     readonly policy?: FormPolicy;
     readonly translationAdapterAvailable?: boolean;
 }
+interface LocalizationSummaryContext {
+    readonly defaultLocale: string;
+    readonly supportedLocales: readonly string[];
+    readonly totalLocales: number;
+}
 interface BuilderTranslationActionsSlotProps extends BuilderSlotBaseProps {
     readonly currentLocale: string;
     readonly onAutoTranslate: () => void;
@@ -302,6 +337,8 @@ type FormBuilderSectionName = "basicSettings" | "completionMessage" | "questions
 interface FormBuilderSlots {
     readonly toolbar?: ComponentType<BuilderToolbarSlotProps>;
     readonly fieldEditor?: ComponentType<BuilderFieldEditorSlotProps>;
+    readonly fieldTypeSelect?: ComponentType<FieldTypeSelectSlotProps>;
+    readonly fieldEditorHeader?: ComponentType<FieldEditorHeaderSlotProps>;
     readonly optionEditor?: ComponentType<BuilderOptionEditorSlotProps>;
     readonly pages?: ComponentType<BuilderPagesSlotProps>;
     readonly localization?: ComponentType<BuilderLocalizationSlotProps>;
@@ -338,6 +375,26 @@ interface SubmitResponse {
     readonly submissionId?: string;
     readonly submittedAt?: string;
 }
+interface SubmitContext {
+    readonly attemptId: string;
+    readonly formId: string;
+    readonly formVersion: number;
+    readonly locale?: string;
+    readonly submittedAt: string;
+}
+interface FormRendererMessages {
+    readonly submitButton?: string;
+    readonly submittingButton?: string;
+    readonly retryButton?: string;
+    readonly requiredField?: string;
+    readonly alreadySubmittedTitle?: string;
+    readonly alreadySubmittedMessage?: string;
+    readonly serverErrorSummary?: string;
+    readonly confirmSensitiveDataTitle?: string;
+    readonly confirmSensitiveDataMessage?: string;
+    readonly confirmButton?: string;
+    readonly cancelButton?: string;
+}
 interface FormSubmittedAnswerItem {
     readonly fieldId: string;
     readonly title: string;
@@ -350,7 +407,7 @@ interface FormSubmittedAnswerItem {
 interface FormCompletionSlotProps {
     readonly message?: string;
     readonly schema: FormSchema;
-    readonly answers: Record<string, unknown>;
+    readonly answers: Readonly<Record<string, unknown>>;
     readonly submittedItems: readonly FormSubmittedAnswerItem[];
     readonly response?: SubmitResponse;
     readonly onReset?: () => void;
@@ -363,7 +420,7 @@ declare class FormSubmissionError extends Error {
     readonly payload: FormServerErrorPayload;
     constructor(message: string, payload?: FormServerErrorPayload);
 }
-type FormSubmitHandler = (answers: FormValues) => SubmitResponse | void | Promise<SubmitResponse | undefined> | Promise<void>;
+type FormSubmitHandler = (answers: FormValues, context: SubmitContext) => SubmitResponse | void | Promise<SubmitResponse | undefined> | Promise<void>;
 type SubmissionGuardResult = {
     readonly status: "allow";
 } | {
@@ -427,8 +484,7 @@ interface FormRendererSlots {
     readonly renderValidationSummary?: (props: {
         readonly issues: readonly ValidationError[];
     }) => ReactNode;
-    /** Additional completion data is supplied at runtime; use renderSubmittedValues for typed summary rendering. */
-    readonly renderCompletion?: (props: {
+    readonly renderCompletion?: (props: FormCompletionSlotProps & {
         readonly message: string;
     }) => ReactNode;
     readonly renderSubmittedValues?: (props: {
@@ -507,7 +563,7 @@ interface FormContextValue {
     readonly restoreValues: (values: FormValues) => void;
     readonly validatePage: (pageIndex: number) => AnswerValidationResult;
     readonly reset: () => void;
-    readonly submit: (beforeSubmit?: BeforeSubmit, prepareSubmission?: (values: FormValues) => FormValues | Promise<FormValues>) => Promise<SubmitResult>;
+    readonly submit: (beforeSubmit?: BeforeSubmit, submitContext?: SubmitContext) => Promise<SubmitResult>;
     readonly translate: (key: string, params?: Readonly<Record<string, string | number>>) => string;
 }
 interface FormProviderProps {
@@ -529,6 +585,23 @@ interface FieldState {
 }
 declare function useField(fieldId: string): FieldState;
 
+declare const BUILDER_TRANSLATION_KEYS: {
+    readonly ADD_FIELD: "builder.actions.addField";
+    readonly SELECT_FIELD_TYPE: "builder.fields.selectType";
+    readonly SELECT_LOCALE_TO_ADD: "builder.localization.selectLocaleToAdd";
+    readonly FIELD_TYPE_TEXT: "builder.fields.typeText";
+    readonly FIELD_TYPE_TEXTAREA: "builder.fields.typeTextarea";
+    readonly FIELD_TYPE_NUMBER: "builder.fields.typeNumber";
+    readonly FIELD_TYPE_RATING: "builder.fields.typeRating";
+    readonly FIELD_TYPE_RADIO: "builder.fields.typeRadio";
+    readonly FIELD_TYPE_CHECKBOX: "builder.fields.typeCheckbox";
+    readonly FIELD_TYPE_SELECT: "builder.fields.typeSelect";
+    readonly FIELD_TYPE_MULTI_SELECT: "builder.fields.typeMultiSelect";
+};
+type BuilderTranslationKey = (typeof BUILDER_TRANSLATION_KEYS)[keyof typeof BUILDER_TRANSLATION_KEYS];
+/** Legacy keys are checked when an older catalog does not contain a canonical key. */
+declare const BUILDER_TRANSLATION_ALIASES: Readonly<Record<string, string>>;
+
 interface FieldComponentProps {
     readonly field: FormField;
     readonly value: FormValue;
@@ -556,6 +629,9 @@ interface FormRendererPresentationProps extends SubmissionProtectionProps {
     readonly hideFormOnSuccess?: boolean;
     readonly successMessageKey?: string;
     readonly errorMessageKey?: string;
+    readonly attemptIdFactory?: () => string;
+    readonly messages?: Partial<FormRendererMessages>;
+    readonly messageResolver?: (key: keyof FormRendererMessages, defaultText: string) => string;
     readonly autoSaveKey?: string;
     readonly beforeSubmit?: BeforeSubmit;
     readonly onDraftSave?: (draft: FormValues) => void;
@@ -572,4 +648,4 @@ interface StandaloneFormRendererProps extends FormRendererPresentationProps {
 type FormRendererProps = FormRendererPresentationProps | StandaloneFormRendererProps;
 declare function FormRenderer(props: FormRendererProps): react.JSX.Element;
 
-export { 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 ComponentBaseProps, type FieldComponentProps, type FieldComponents, type FieldState, 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 FormRendererPresentationProps, type FormRendererProps, type FormRendererSlots, type FormServerErrorPayload, FormSubmissionError, type FormSubmitHandler, type FormSubmitState, type FormSubmitStatus, type FormSubmittedAnswerItem, type FormSuccessRenderMode, type IconButtonProps, type InputComponentProps, type ManualTranslationContext, type ManualTranslationTarget, type RenderSubmitButtonProps, type StandaloneFormRendererProps, type SubmissionAttempt, type SubmissionAttemptStore, type SubmissionConfirmationRenderMode, type SubmissionConfirmationSlotProps, type SubmissionGuard, type SubmissionGuardResult, type SubmissionProtectionProps, type SubmissionReceipt, type SubmissionReceiptQuery, type SubmissionReceiptStore, type SubmitResponse, type SubmitResult, type SubmitStatus, type UseSubmissionReceiptsResult, createLocalStorageSubmissionAttemptStore, createLocalStorageSubmissionReceiptStore, resolveInitialFieldType, 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 ComponentBaseProps, type FieldComponentProps, type FieldComponents, type FieldEditorHeaderSlotProps, type FieldState, 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 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 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, resolveInitialFieldType, submissionReceiptQueryKey, useField, useForm, useFormBuilder, useSubmissionReceipts };

package/dist/index.d.ts

@@ -1,6 +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';
+export { QuestionType } from '@form-engine-ts/core';
 import * as react from 'react';
-import { ReactNode, ComponentType, MouseEvent } from 'react';
-import { QuestionType, FormField, ChoiceOption, FormPage, FormSchema, DisplayCondition, JsonValue, SchemaIssue, FormPolicy, FieldOption, TranslationReport, ValidationError, FormValues, TranslationAdapter, AsyncTranslationAdapter, PopulateTranslationOptions, FormValue, ValidationIssue, AnswerValidationResult, FieldType } from '@form-engine-ts/core';
+import { ReactNode, ComponentType, KeyboardEvent, MouseEvent } from 'react';
 import { SensitiveDataFinding } from '@form-engine-ts/privacy';
 
 interface SubmissionAttempt {
@@ -139,6 +140,7 @@ interface ComponentBaseProps {
 type BuilderActionIconType = "moveUp" | "moveDown" | "delete" | "add" | "edit" | "settings" | "translate" | "close" | "dragHandle";
 interface BuilderButtonProps extends ComponentBaseProps {
     readonly onClick?: () => void;
+    readonly noWrap?: boolean;
     readonly variant?: "primary" | "secondary" | "danger";
     readonly children: ReactNode;
     readonly title?: string;
@@ -165,6 +167,7 @@ interface InputComponentProps extends ComponentBaseProps {
     readonly helperText?: string;
     readonly value: string;
     readonly onChange: (value: string) => void;
+    readonly onKeyDown?: (event: KeyboardEvent<HTMLElement>) => void;
     readonly placeholder?: string;
     readonly maxLength?: number;
 }
@@ -181,10 +184,21 @@ interface BuilderTextAreaProps extends InputComponentProps {
 interface BuilderSelectOption {
     readonly label: string;
     readonly value: string;
+    readonly icon?: ReactNode;
+    readonly description?: string;
     readonly disabled?: boolean;
+    readonly kind?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+interface SelectComponentProps extends InputComponentProps {
+    readonly options: readonly (string | BuilderSelectOption)[];
+    readonly renderOption?: (option: BuilderSelectOption) => ReactNode;
+    readonly renderValue?: (option: BuilderSelectOption | undefined) => ReactNode;
 }
 interface BuilderSelectProps extends InputComponentProps {
     readonly options: readonly BuilderSelectOption[];
+    readonly renderOption?: (option: BuilderSelectOption) => ReactNode;
+    readonly renderValue?: (option: BuilderSelectOption | undefined) => ReactNode;
 }
 interface BuilderCheckboxProps extends ComponentBaseProps {
     readonly name?: string;
@@ -227,6 +241,7 @@ interface FormBuilderComponents {
         readonly message: string;
     }>;
     readonly renderIcon?: (actionType: BuilderActionIconType) => ReactNode;
+    readonly renderFieldTypeIcon?: (type: QuestionType) => ReactNode;
 }
 type FormBuilderActions = Omit<FormBuilderResult, "schema" | "validationIssues">;
 interface ManualTranslationTarget {
@@ -263,6 +278,21 @@ interface BuilderFieldEditorSlotProps extends BuilderSlotBaseProps {
         readonly localization?: boolean;
         readonly conditions?: boolean;
     };
+    readonly slots?: Pick<FormBuilderSlots, "fieldTypeSelect" | "fieldEditorHeader">;
+}
+interface FieldTypeSelectSlotProps {
+    readonly currentType: QuestionType;
+    readonly allowedTypes: readonly QuestionType[];
+    readonly onChangeType: (nextType: QuestionType) => void;
+    readonly disabled?: boolean;
+    readonly readOnly?: boolean;
+    readonly renderIcon?: (type: QuestionType) => ReactNode;
+}
+interface FieldEditorHeaderSlotProps {
+    readonly field: Question;
+    readonly index: number;
+    readonly totalFields: number;
+    readonly actions: FormBuilderActions;
 }
 interface BuilderOptionEditorSlotProps extends BuilderSlotBaseProps {
     readonly field: FormField & {
@@ -289,6 +319,11 @@ interface BuilderLocalizationSlotProps extends BuilderSlotBaseProps {
     readonly policy?: FormPolicy;
     readonly translationAdapterAvailable?: boolean;
 }
+interface LocalizationSummaryContext {
+    readonly defaultLocale: string;
+    readonly supportedLocales: readonly string[];
+    readonly totalLocales: number;
+}
 interface BuilderTranslationActionsSlotProps extends BuilderSlotBaseProps {
     readonly currentLocale: string;
     readonly onAutoTranslate: () => void;
@@ -302,6 +337,8 @@ type FormBuilderSectionName = "basicSettings" | "completionMessage" | "questions
 interface FormBuilderSlots {
     readonly toolbar?: ComponentType<BuilderToolbarSlotProps>;
     readonly fieldEditor?: ComponentType<BuilderFieldEditorSlotProps>;
+    readonly fieldTypeSelect?: ComponentType<FieldTypeSelectSlotProps>;
+    readonly fieldEditorHeader?: ComponentType<FieldEditorHeaderSlotProps>;
     readonly optionEditor?: ComponentType<BuilderOptionEditorSlotProps>;
     readonly pages?: ComponentType<BuilderPagesSlotProps>;
     readonly localization?: ComponentType<BuilderLocalizationSlotProps>;
@@ -338,6 +375,26 @@ interface SubmitResponse {
     readonly submissionId?: string;
     readonly submittedAt?: string;
 }
+interface SubmitContext {
+    readonly attemptId: string;
+    readonly formId: string;
+    readonly formVersion: number;
+    readonly locale?: string;
+    readonly submittedAt: string;
+}
+interface FormRendererMessages {
+    readonly submitButton?: string;
+    readonly submittingButton?: string;
+    readonly retryButton?: string;
+    readonly requiredField?: string;
+    readonly alreadySubmittedTitle?: string;
+    readonly alreadySubmittedMessage?: string;
+    readonly serverErrorSummary?: string;
+    readonly confirmSensitiveDataTitle?: string;
+    readonly confirmSensitiveDataMessage?: string;
+    readonly confirmButton?: string;
+    readonly cancelButton?: string;
+}
 interface FormSubmittedAnswerItem {
     readonly fieldId: string;
     readonly title: string;
@@ -350,7 +407,7 @@ interface FormSubmittedAnswerItem {
 interface FormCompletionSlotProps {
     readonly message?: string;
     readonly schema: FormSchema;
-    readonly answers: Record<string, unknown>;
+    readonly answers: Readonly<Record<string, unknown>>;
     readonly submittedItems: readonly FormSubmittedAnswerItem[];
     readonly response?: SubmitResponse;
     readonly onReset?: () => void;
@@ -363,7 +420,7 @@ declare class FormSubmissionError extends Error {
     readonly payload: FormServerErrorPayload;
     constructor(message: string, payload?: FormServerErrorPayload);
 }
-type FormSubmitHandler = (answers: FormValues) => SubmitResponse | void | Promise<SubmitResponse | undefined> | Promise<void>;
+type FormSubmitHandler = (answers: FormValues, context: SubmitContext) => SubmitResponse | void | Promise<SubmitResponse | undefined> | Promise<void>;
 type SubmissionGuardResult = {
     readonly status: "allow";
 } | {
@@ -427,8 +484,7 @@ interface FormRendererSlots {
     readonly renderValidationSummary?: (props: {
         readonly issues: readonly ValidationError[];
     }) => ReactNode;
-    /** Additional completion data is supplied at runtime; use renderSubmittedValues for typed summary rendering. */
-    readonly renderCompletion?: (props: {
+    readonly renderCompletion?: (props: FormCompletionSlotProps & {
         readonly message: string;
     }) => ReactNode;
     readonly renderSubmittedValues?: (props: {
@@ -507,7 +563,7 @@ interface FormContextValue {
     readonly restoreValues: (values: FormValues) => void;
     readonly validatePage: (pageIndex: number) => AnswerValidationResult;
     readonly reset: () => void;
-    readonly submit: (beforeSubmit?: BeforeSubmit, prepareSubmission?: (values: FormValues) => FormValues | Promise<FormValues>) => Promise<SubmitResult>;
+    readonly submit: (beforeSubmit?: BeforeSubmit, submitContext?: SubmitContext) => Promise<SubmitResult>;
     readonly translate: (key: string, params?: Readonly<Record<string, string | number>>) => string;
 }
 interface FormProviderProps {
@@ -529,6 +585,23 @@ interface FieldState {
 }
 declare function useField(fieldId: string): FieldState;
 
+declare const BUILDER_TRANSLATION_KEYS: {
+    readonly ADD_FIELD: "builder.actions.addField";
+    readonly SELECT_FIELD_TYPE: "builder.fields.selectType";
+    readonly SELECT_LOCALE_TO_ADD: "builder.localization.selectLocaleToAdd";
+    readonly FIELD_TYPE_TEXT: "builder.fields.typeText";
+    readonly FIELD_TYPE_TEXTAREA: "builder.fields.typeTextarea";
+    readonly FIELD_TYPE_NUMBER: "builder.fields.typeNumber";
+    readonly FIELD_TYPE_RATING: "builder.fields.typeRating";
+    readonly FIELD_TYPE_RADIO: "builder.fields.typeRadio";
+    readonly FIELD_TYPE_CHECKBOX: "builder.fields.typeCheckbox";
+    readonly FIELD_TYPE_SELECT: "builder.fields.typeSelect";
+    readonly FIELD_TYPE_MULTI_SELECT: "builder.fields.typeMultiSelect";
+};
+type BuilderTranslationKey = (typeof BUILDER_TRANSLATION_KEYS)[keyof typeof BUILDER_TRANSLATION_KEYS];
+/** Legacy keys are checked when an older catalog does not contain a canonical key. */
+declare const BUILDER_TRANSLATION_ALIASES: Readonly<Record<string, string>>;
+
 interface FieldComponentProps {
     readonly field: FormField;
     readonly value: FormValue;
@@ -556,6 +629,9 @@ interface FormRendererPresentationProps extends SubmissionProtectionProps {
     readonly hideFormOnSuccess?: boolean;
     readonly successMessageKey?: string;
     readonly errorMessageKey?: string;
+    readonly attemptIdFactory?: () => string;
+    readonly messages?: Partial<FormRendererMessages>;
+    readonly messageResolver?: (key: keyof FormRendererMessages, defaultText: string) => string;
     readonly autoSaveKey?: string;
     readonly beforeSubmit?: BeforeSubmit;
     readonly onDraftSave?: (draft: FormValues) => void;
@@ -572,4 +648,4 @@ interface StandaloneFormRendererProps extends FormRendererPresentationProps {
 type FormRendererProps = FormRendererPresentationProps | StandaloneFormRendererProps;
 declare function FormRenderer(props: FormRendererProps): react.JSX.Element;
 
-export { 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 ComponentBaseProps, type FieldComponentProps, type FieldComponents, type FieldState, 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 FormRendererPresentationProps, type FormRendererProps, type FormRendererSlots, type FormServerErrorPayload, FormSubmissionError, type FormSubmitHandler, type FormSubmitState, type FormSubmitStatus, type FormSubmittedAnswerItem, type FormSuccessRenderMode, type IconButtonProps, type InputComponentProps, type ManualTranslationContext, type ManualTranslationTarget, type RenderSubmitButtonProps, type StandaloneFormRendererProps, type SubmissionAttempt, type SubmissionAttemptStore, type SubmissionConfirmationRenderMode, type SubmissionConfirmationSlotProps, type SubmissionGuard, type SubmissionGuardResult, type SubmissionProtectionProps, type SubmissionReceipt, type SubmissionReceiptQuery, type SubmissionReceiptStore, type SubmitResponse, type SubmitResult, type SubmitStatus, type UseSubmissionReceiptsResult, createLocalStorageSubmissionAttemptStore, createLocalStorageSubmissionReceiptStore, resolveInitialFieldType, 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 ComponentBaseProps, type FieldComponentProps, type FieldComponents, type FieldEditorHeaderSlotProps, type FieldState, 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 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 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, resolveInitialFieldType, submissionReceiptQueryKey, useField, useForm, useFormBuilder, useSubmissionReceipts };