@form-engine-ts/react 2.9.4 → 2.9.6

package/dist/index.cjs

@@ -23,6 +23,7 @@ __export(index_exports, {
   FormBuilder: () => FormBuilder,
   FormProvider: () => FormProvider,
   FormRenderer: () => FormRenderer,
+  FormSubmissionError: () => FormSubmissionError,
   createLocalStorageSubmissionAttemptStore: () => createLocalStorageSubmissionAttemptStore,
   createLocalStorageSubmissionReceiptStore: () => createLocalStorageSubmissionReceiptStore,
   resolveInitialFieldType: () => resolveInitialFieldType,
@@ -1088,7 +1089,7 @@ function BuilderButton(props) {
       ...props,
       className: primitiveClassName(props.className, "feb-button", context.unstyled),
       disabled: context.readOnly || props.disabled === true,
-      readOnly: context.readOnly
+      readOnly: context.readOnly || props.readOnly === true
     }
   );
 }
@@ -1103,7 +1104,7 @@ function BuilderIconButton(props) {
       icon,
       className: primitiveClassName(props.className, "feb-icon-button", context.unstyled),
       disabled: context.readOnly || props.disabled === true,
-      readOnly: context.readOnly
+      readOnly: context.readOnly || props.readOnly === true
     }
   );
 }
@@ -1116,7 +1117,7 @@ function BuilderTextInput(props) {
       ...props,
       className: primitiveClassName(props.className, "feb-input", context.unstyled),
       disabled: context.readOnly || props.disabled === true,
-      readOnly: context.readOnly
+      readOnly: context.readOnly || props.readOnly === true
     }
   );
 }
@@ -1129,7 +1130,7 @@ function BuilderTextArea(props) {
       ...props,
       className: primitiveClassName(props.className, "feb-textarea", context.unstyled),
       disabled: context.readOnly || props.disabled === true,
-      readOnly: context.readOnly
+      readOnly: context.readOnly || props.readOnly === true
     }
   );
 }
@@ -1142,7 +1143,7 @@ function BuilderSelect(props) {
       ...props,
       className: primitiveClassName(props.className, "feb-select", context.unstyled),
       disabled: context.readOnly || props.disabled === true,
-      readOnly: context.readOnly
+      readOnly: context.readOnly || props.readOnly === true
     }
   );
 }
@@ -1155,7 +1156,7 @@ function BuilderCheckbox(props) {
       ...props,
       className: primitiveClassName(props.className, "feb-checkbox", context.unstyled),
       disabled: context.readOnly || props.disabled === true,
-      readOnly: context.readOnly
+      readOnly: context.readOnly || props.readOnly === true
     }
   );
 }
@@ -1301,6 +1302,59 @@ function fieldTypeKey(type) {
 function operatorKey(operator) {
   return `builder.operator.${operator}`;
 }
+function manualTranslationContext(schema, locale, target, property, translatedText) {
+  if (target.kind === "form") {
+    if (property !== "title" && property !== "description" && property !== "completionMessage") return void 0;
+    return {
+      locale,
+      kind: "form",
+      nodeId: schema.id,
+      property,
+      sourceText: schema[property] ?? "",
+      translatedText,
+      ...schema.translationMetadata?.[locale]?.[property] === void 0 ? {} : { existingTranslationMetadata: schema.translationMetadata[locale]?.[property] }
+    };
+  }
+  if (target.id === void 0) return void 0;
+  if (target.kind === "field") {
+    const field = schema.fields.find((candidate) => candidate.id === target.id);
+    if (field === void 0 || property !== "title" && property !== "description") return void 0;
+    return {
+      locale,
+      kind: "field",
+      nodeId: field.id,
+      property,
+      sourceText: field[property] ?? "",
+      translatedText,
+      ...field.translationMetadata?.[locale]?.[property] === void 0 ? {} : { existingTranslationMetadata: field.translationMetadata[locale]?.[property] }
+    };
+  }
+  if (target.kind === "page") {
+    const page = schema.pages?.find((candidate) => candidate.id === target.id);
+    if (page === void 0 || property !== "title" && property !== "description") return void 0;
+    return {
+      locale,
+      kind: "page",
+      nodeId: page.id,
+      property,
+      sourceText: page[property] ?? "",
+      translatedText,
+      ...page.translationMetadata?.[locale]?.[property] === void 0 ? {} : { existingTranslationMetadata: page.translationMetadata[locale]?.[property] }
+    };
+  }
+  if (property !== "label") return void 0;
+  const option = schema.fields.filter((field) => "options" in field).flatMap((field) => field.options).find((candidate) => candidate.id === target.id);
+  if (option === void 0) return void 0;
+  return {
+    locale,
+    kind: "option",
+    nodeId: option.id,
+    property,
+    sourceText: option.label,
+    translatedText,
+    ...option.translationMetadata?.[locale]?.[property] === void 0 ? {} : { existingTranslationMetadata: option.translationMetadata[locale]?.[property] }
+  };
+}
 function defaultConditionValue(field) {
   if (field.type === "checkbox") return true;
   if (field.type === "number" || field.type === "rating") return field.min ?? 1;
@@ -1559,25 +1613,30 @@ function FormBuilder({
       setIsTranslating(false);
     }
   };
-  const updateManualTranslation = (context) => {
-    if (readOnly) return;
-    const metadata = createManualTranslationMetadata?.(context);
-    const target = context.kind === "form" ? { kind: "form" } : { kind: context.kind, id: context.nodeId };
-    executeAction(
+  const setManualTranslation = (targetLocale, target, property, text) => {
+    if (readOnly) return { success: true };
+    const normalizedLocale = targetLocale.trim();
+    const context = manualTranslationContext(schema, normalizedLocale, target, property, text);
+    const metadata = context === void 0 ? void 0 : createManualTranslationMetadata?.(context);
+    return executeAction(
       () => headless.setLocaleTranslation(
-        context.locale,
+        normalizedLocale,
         target,
-        context.property,
-        context.translatedText,
+        property,
+        text,
         metadata === void 0 ? void 0 : { metadata }
       ),
       {
-        action: "setLocaleTranslation",
-        targetId: context.nodeId,
-        params: { locale: context.locale, kind: context.kind, property: context.property }
+        action: "setManualTranslation",
+        ...target.id === void 0 ? {} : { targetId: target.id },
+        params: { locale: normalizedLocale, kind: target.kind, property }
       }
     );
   };
+  const updateManualTranslation = (context) => {
+    const target = context.kind === "form" ? { kind: "form" } : { kind: context.kind, id: context.nodeId };
+    setManualTranslation(context.locale, target, context.property, context.translatedText);
+  };
   const updateFormTranslation = (property, translatedText) => {
     if (editingLocale.length === 0) return;
     updateManualTranslation({
@@ -1686,6 +1745,7 @@ function FormBuilder({
       ...target.id === void 0 ? {} : { targetId: target.id },
       params: { locale: targetLocale, property }
     }),
+    setManualTranslation,
     addLocale: (targetLocale) => executeAction(() => headless.addLocale(targetLocale), {
       action: "addLocale",
       params: { locale: targetLocale }
@@ -2598,6 +2658,17 @@ function FormProvider({
     },
     [validSchema, validationPageIndex]
   );
+  const setServerErrors = (0, import_react3.useCallback)((fieldErrors) => {
+    setErrors(
+      Object.fromEntries(
+        Object.entries(fieldErrors).map(([fieldId, message]) => [
+          fieldId,
+          { fieldId, code: "invalid_type", messageKey: message, params: {} }
+        ])
+      )
+    );
+    setValidationPageIndex(null);
+  }, []);
   const restoreValues = (0, import_react3.useCallback)(
     (restoredValues) => {
       const fieldIds = new Set(validSchema.fields.map((field) => field.id));
@@ -2682,6 +2753,7 @@ function FormProvider({
       submitError,
       isSubmitting: submitStatus === "submitting",
       setValue,
+      setServerErrors,
       restoreValues,
       validatePage,
       reset,
@@ -2695,6 +2767,7 @@ function FormProvider({
       reset,
       restoreValues,
       setValue,
+      setServerErrors,
       submit,
       submitError,
       submitStatus,
@@ -2841,6 +2914,18 @@ function useSubmissionReceipts(store, queries) {
 // src/renderer.tsx
 var import_core4 = require("@form-engine-ts/core");
 var import_react5 = require("react");
+
+// src/types.ts
+var FormSubmissionError = class extends Error {
+  payload;
+  constructor(message, payload) {
+    super(message);
+    this.name = "FormSubmissionError";
+    this.payload = payload ?? { formError: message };
+  }
+};
+
+// src/renderer.tsx
 var import_jsx_runtime3 = require("react/jsx-runtime");
 function describedBy(field, error, helpId, errorId) {
   const ids = [field.description === void 0 ? void 0 : helpId, error === void 0 ? void 0 : errorId].filter(
@@ -3037,6 +3122,30 @@ function isRecord(value) {
 function isFormValue(value) {
   return value === void 0 || typeof value === "string" || typeof value === "boolean" || typeof value === "number" && Number.isFinite(value) || Array.isArray(value) && value.every((item) => typeof item === "string");
 }
+function displaySubmittedValue(field, value, translate) {
+  if (value === void 0 || value === null) return "";
+  if (field.type === "checkbox") return value === true ? translate("form.yes") : translate("form.no");
+  if (field.type === "multi-select" && Array.isArray(value)) {
+    const labels = new Map(field.options.map((option) => [option.id, option.label]));
+    return value.map((item) => labels.get(item) ?? item).join(", ");
+  }
+  if ((field.type === "radio" || field.type === "select") && typeof value === "string") {
+    return field.options.find((option) => option.id === value)?.label ?? value;
+  }
+  if (Array.isArray(value)) return value.join(", ");
+  return String(value);
+}
+function buildSubmittedItems(schema, answers, visibility, translate, showHiddenFields) {
+  return schema.fields.filter((field) => showHiddenFields || visibility[field.id] === true).map((field) => ({
+    fieldId: field.id,
+    title: field.title,
+    type: field.type,
+    rawValue: answers[field.id],
+    displayValue: displaySubmittedValue(field, answers[field.id], translate),
+    visible: visibility[field.id] === true,
+    ...field.metadata === void 0 ? {} : { metadata: field.metadata }
+  }));
+}
 function parseDraft(serialized) {
   try {
     const value = JSON.parse(serialized);
@@ -3063,6 +3172,11 @@ function ContextFormRenderer({
   autoSaveKey,
   beforeSubmit,
   onDraftSave,
+  successRenderMode = "append",
+  submissionConfirmationRenderMode = "inline",
+  showHiddenFieldsInSummary = false,
+  fieldsClassName,
+  hideFormOnSuccess = false,
   submissionGuards = [],
   receiptStore,
   attemptStore,
@@ -3078,9 +3192,13 @@ function ContextFormRenderer({
   const [focusFieldId, setFocusFieldId] = (0, import_react5.useState)(null);
   const [confirmation, setConfirmation] = (0, import_react5.useState)(null);
   const [guardMessage, setGuardMessage] = (0, import_react5.useState)(null);
+  const [guardsPending, setGuardsPending] = (0, import_react5.useState)(false);
   const [receipt, setReceipt] = (0, import_react5.useState)(null);
+  const [completionData, setCompletionData] = (0, import_react5.useState)(null);
   const [receiptLoaded, setReceiptLoaded] = (0, import_react5.useState)(receiptStore === void 0);
   const rendererSubmissionInFlight = (0, import_react5.useRef)(false);
+  const completionRef = (0, import_react5.useRef)(null);
+  const confirmationRef = (0, import_react5.useRef)(null);
   const pages = form.schema.pages;
   const visiblePageIndexes = (0, import_react5.useMemo)(
     () => pages === void 0 ? [] : pages.flatMap((page, index) => form.pageVisibility[page.id] === true ? [index] : []),
@@ -3090,8 +3208,13 @@ function ContextFormRenderer({
   const activeVisibleIndex = visiblePageIndexes.indexOf(currentPageIndex);
   const fieldIds = activePage === void 0 ? void 0 : new Set(activePage.questionIds);
   const visibleValues = (0, import_react5.useMemo)(() => (0, import_core4.selectVisibleAnswers)(form.schema, form.values), [form.schema, form.values]);
-  const submitState = confirmation === null ? form.submitStatus : "confirming";
+  const submitState = confirmation === null && !guardsPending ? form.submitStatus : "confirming";
   const interactionLocked = submitState === "confirming" || submitState === "submitting";
+  const isReplaceMode = successRenderMode === "replace" || hideFormOnSuccess;
+  const focusSubmitButton = (0, import_react5.useCallback)(() => {
+    const button = formRef.current?.querySelector(".fe-submit, button[type='submit'], button");
+    button?.focus();
+  }, []);
   (0, import_react5.useEffect)(() => {
     let active = true;
     if (receiptStore === void 0) {
@@ -3131,6 +3254,25 @@ function ContextFormRenderer({
       setFocusFieldId(null);
     }
   }, [focusFieldId]);
+  (0, import_react5.useEffect)(() => {
+    if (!isReplaceMode || form.submitStatus !== "success") return;
+    completionRef.current?.focus();
+  }, [form.submitStatus, isReplaceMode]);
+  (0, import_react5.useEffect)(() => {
+    if (confirmation === null) return;
+    const confirmButton = confirmationRef.current?.querySelector("[data-fe-confirm], button");
+    confirmButton?.focus();
+    if (submissionConfirmationRenderMode !== "dialog") return;
+    const onKeyDown = (event) => {
+      if (event.key === "Escape") {
+        event.preventDefault();
+        setConfirmation(null);
+        globalThis.setTimeout(focusSubmitButton, 0);
+      }
+    };
+    globalThis.addEventListener("keydown", onKeyDown);
+    return () => globalThis.removeEventListener("keydown", onKeyDown);
+  }, [confirmation, focusSubmitButton, submissionConfirmationRenderMode]);
   (0, import_react5.useEffect)(() => {
     if (autoSaveKey === void 0 || typeof globalThis.localStorage === "undefined") return;
     const loadIdentity = `${autoSaveKey}:${form.schema.id}:${form.schema.version}`;
@@ -3196,13 +3338,14 @@ function ContextFormRenderer({
     };
   };
   const submitValues = async (guardsConfirmed = false) => {
-    if (rendererSubmissionInFlight.current || confirmation !== null && !guardsConfirmed) {
+    if (rendererSubmissionInFlight.current || submitState === "submitting" || submitState === "success" || confirmation !== null && !guardsConfirmed) {
       return { status: "cancelled" };
     }
     const validation = (0, import_core4.validateAnswers)(form.schema, form.values);
     const firstInvalidFieldId = validation.issues[0]?.fieldId;
     if (validation.valid && !guardsConfirmed && submissionGuards.length > 0) {
       rendererSubmissionInFlight.current = true;
+      setGuardsPending(true);
       try {
         const guardResult = await runSubmissionGuards(submissionGuards);
         if (guardResult.status === "block") {
@@ -3219,6 +3362,7 @@ function ContextFormRenderer({
         }
       } finally {
         rendererSubmissionInFlight.current = false;
+        setGuardsPending(false);
       }
     }
     setGuardMessage(null);
@@ -3244,7 +3388,33 @@ function ContextFormRenderer({
         focusFirstIssue(firstInvalidFieldId);
         return result;
       }
+      if (result.status === "error") {
+        if (result.error instanceof FormSubmissionError) {
+          const fieldErrors = result.error.payload.fieldErrors ?? {};
+          form.setServerErrors?.(fieldErrors);
+          const firstServerFieldId = Object.keys(fieldErrors)[0];
+          if (firstServerFieldId !== void 0) {
+            const invalidPageIndex = pages?.findIndex((page) => page.questionIds.includes(firstServerFieldId));
+            if (invalidPageIndex !== void 0 && invalidPageIndex >= 0) setCurrentPageIndex(invalidPageIndex);
+            focusFirstIssue(firstServerFieldId);
+          }
+        }
+        return result;
+      }
       if (result.status !== "success") return result;
+      const submittedAnswers = { ...form.values };
+      const submittedItems = buildSubmittedItems(
+        form.schema,
+        submittedAnswers,
+        form.visibility,
+        (key) => form.translate(key),
+        showHiddenFieldsInSummary
+      );
+      setCompletionData({
+        answers: submittedAnswers,
+        submittedItems,
+        ...result.response === void 0 ? {} : { response: result.response }
+      });
       if (receiptStore !== void 0) {
         const response = result.response;
         const submissionId = response?.submissionId ?? submissionAttempt?.attemptId;
@@ -3256,7 +3426,6 @@ function ContextFormRenderer({
         };
         try {
           await receiptStore.save(storedReceipt);
-          setReceipt(storedReceipt);
         } catch (cause) {
           const error = cause instanceof Error ? cause : new Error(String(cause));
           try {
@@ -3283,7 +3452,7 @@ function ContextFormRenderer({
   };
   const handleSubmit = (event) => {
     event.preventDefault();
-    if (interactionLocked) return;
+    if (submitState === "submitting" || submitState === "confirming" || submitState === "success") return;
     void submitValues();
   };
   const confirmSubmission = () => {
@@ -3292,6 +3461,7 @@ function ContextFormRenderer({
   };
   const cancelSubmission = () => {
     setConfirmation(null);
+    globalThis.setTimeout(focusSubmitButton, 0);
   };
   const resetReceipt = async () => {
     if (receiptStore === void 0) return;
@@ -3302,7 +3472,58 @@ function ContextFormRenderer({
   const validationIssues = Object.values(form.errors).filter((issue) => issue !== void 0);
   const canPrev = pages !== void 0 && activeVisibleIndex > 0;
   const canNext = pages !== void 0 && activeVisibleIndex < visiblePageIndexes.length - 1;
-  const renderSubmitButton = () => slots.renderSubmitButton?.({ isSubmitting: interactionLocked, onSubmit: () => void submitValues() }) ?? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("button", { className: "fe-submit", type: "submit", disabled: interactionLocked, children: form.translate(form.schema.submitLabelKey ?? "form.submit") });
+  const renderSubmitButton = () => {
+    const submitButtonProps = {
+      isSubmitting: submitState === "submitting",
+      submitStatus: submitState,
+      disabled: interactionLocked || submitState === "success",
+      onSubmit: () => void submitValues()
+    };
+    return slots.renderSubmitButton?.(submitButtonProps) ?? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("button", { className: "fe-submit", type: "submit", disabled: submitButtonProps.disabled, children: form.translate(form.schema.submitLabelKey ?? "form.submit") });
+  };
+  const completionMessage = form.schema.completionMessage ?? (successMessageKey === void 0 ? "Submitted." : form.translate(successMessageKey));
+  const activeCompletionData = completionData ?? {
+    answers: { ...form.values },
+    submittedItems: buildSubmittedItems(
+      form.schema,
+      form.values,
+      form.visibility,
+      (key) => form.translate(key),
+      showHiddenFieldsInSummary
+    )
+  };
+  const completionProps = {
+    message: completionMessage,
+    schema: form.schema,
+    answers: activeCompletionData.answers,
+    submittedItems: activeCompletionData.submittedItems,
+    ...activeCompletionData.response === void 0 ? {} : { response: activeCompletionData.response },
+    onReset: form.reset
+  };
+  const completionRegion = /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { ref: completionRef, className: "fe-completion", role: "status", "aria-live": "polite", tabIndex: -1, children: [
+    slots.renderCompletion?.(completionProps) ?? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { children: completionMessage }),
+    slots.renderSubmittedValues?.({ items: activeCompletionData.submittedItems, schema: form.schema })
+  ] });
+  const confirmationContent = /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+    "div",
+    {
+      ref: confirmationRef,
+      className: "fe-submission-confirmation",
+      role: submissionConfirmationRenderMode === "dialog" ? void 0 : "dialog",
+      children: slots.renderSubmissionConfirmation?.({
+        findings: confirmation?.findings ?? [],
+        message: confirmation?.message ?? form.translate("form.confirmSensitiveData"),
+        schema: form.schema,
+        visibleValues,
+        onConfirm: confirmSubmission,
+        onCancel: cancelSubmission
+      }) ?? /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_jsx_runtime3.Fragment, { children: [
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("p", { children: confirmation?.message ?? form.translate("form.confirmSensitiveData") }),
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("button", { type: "button", "data-fe-confirm": "true", onClick: confirmSubmission, children: form.translate("form.confirmSubmission") }),
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("button", { type: "button", onClick: cancelSubmission, children: form.translate("form.cancelSubmission") })
+      ] })
+    }
+  );
   if (!receiptLoaded) return null;
   if (receipt !== null) {
     return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: `fe-form fe-already-submitted ${className}`.trim(), children: slots.renderAlreadySubmitted?.({
@@ -3313,129 +3534,139 @@ function ContextFormRenderer({
       receiptStore === void 0 ? null : /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("button", { type: "button", onClick: () => void resetReceipt(), children: form.translate("form.submitAnother") })
     ] }) });
   }
-  return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("form", { ref: formRef, className: `fe-form ${className}`.trim(), noValidate: true, onSubmit: handleSubmit, children: [
-    slots.renderHeader?.({
-      title: form.schema.title,
-      ...form.schema.description === void 0 ? {} : { description: form.schema.description }
-    }) ?? /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("header", { className: "fe-header", children: [
-      /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("h1", { children: form.schema.title }),
-      form.schema.description === void 0 ? null : /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("p", { children: form.schema.description }),
-      pages === void 0 ? null : /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { className: "fe-progress", children: [
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
-          "div",
-          {
-            className: "form-progress-bar",
-            role: "progressbar",
-            "aria-valuemin": 1,
-            "aria-valuemax": visiblePageIndexes.length,
-            "aria-valuenow": activeVisibleIndex + 1,
-            children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
-              "div",
-              {
-                className: "form-progress-fill",
-                style: { width: `${(activeVisibleIndex + 1) / visiblePageIndexes.length * 100}%` }
+  if (form.submitStatus === "success" && isReplaceMode) {
+    return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: `fe-form ${className}`.trim(), children: completionRegion });
+  }
+  if (confirmation !== null && submissionConfirmationRenderMode === "replace") {
+    return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: `fe-form ${className}`.trim(), children: confirmationContent });
+  }
+  return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_jsx_runtime3.Fragment, { children: [
+    /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
+      "form",
+      {
+        ref: formRef,
+        className: `fe-form ${className}`.trim(),
+        noValidate: true,
+        onSubmit: handleSubmit,
+        "aria-hidden": confirmation !== null && submissionConfirmationRenderMode === "dialog" ? true : void 0,
+        children: [
+          slots.renderHeader?.({
+            title: form.schema.title,
+            ...form.schema.description === void 0 ? {} : { description: form.schema.description }
+          }) ?? /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("header", { className: "fe-header", children: [
+            /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("h1", { children: form.schema.title }),
+            form.schema.description === void 0 ? null : /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("p", { children: form.schema.description }),
+            pages === void 0 ? null : /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { className: "fe-progress", children: [
+              /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+                "div",
+                {
+                  className: "form-progress-bar",
+                  role: "progressbar",
+                  "aria-valuemin": 1,
+                  "aria-valuemax": visiblePageIndexes.length,
+                  "aria-valuenow": activeVisibleIndex + 1,
+                  children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+                    "div",
+                    {
+                      className: "form-progress-fill",
+                      style: { width: `${(activeVisibleIndex + 1) / visiblePageIndexes.length * 100}%` }
+                    }
+                  )
+                }
+              ),
+              /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { children: form.translate("form.step", { current: activeVisibleIndex + 1, total: visiblePageIndexes.length }) })
+            ] }),
+            draftRestored ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { className: "form-draft-badge", children: form.translate("form.draftRestored") }) : null
+          ] }),
+          activePage === void 0 ? null : slots.renderPageHeader?.({
+            page: activePage,
+            pageIndex: activeVisibleIndex,
+            totalPages: visiblePageIndexes.length
+          }) ?? /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { className: "fe-page-header", children: [
+            activePage.title === void 0 ? null : /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("h2", { className: "fe-page-title", children: activePage.title }),
+            activePage.description === void 0 ? null : /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("p", { className: "fe-page-description", children: activePage.description })
+          ] }),
+          (() => {
+            const fieldChildren = form.schema.fields.filter((field) => form.visibility[field.id] === true && (fieldIds === void 0 || fieldIds.has(field.id))).map((field) => {
+              const error = form.errors[field.id];
+              const props = {
+                field,
+                value: form.values[field.id],
+                error,
+                setValue: (value) => form.setValue(field.id, value),
+                translate: form.translate,
+                inputId: `${prefix}-${field.id}`,
+                errorId: `${prefix}-${field.id}-error`,
+                helpId: `${prefix}-${field.id}-help`,
+                ...slots.renderCharacterCount === void 0 ? {} : { renderCharacterCount: slots.renderCharacterCount }
+              };
+              if (slots.renderField !== void 0) {
+                return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react5.Fragment, { children: slots.renderField({
+                  question: field,
+                  value: form.values[field.id],
+                  onChange: (value) => {
+                    if (isFormValue(value)) form.setValue(field.id, value);
+                  },
+                  ...error === void 0 ? {} : { error }
+                }) }, field.id);
               }
-            )
-          }
-        ),
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { children: form.translate("form.step", { current: activeVisibleIndex + 1, total: visiblePageIndexes.length }) })
-      ] }),
-      draftRestored ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { className: "form-draft-badge", children: form.translate("form.draftRestored") }) : null
-    ] }),
-    activePage === void 0 ? null : slots.renderPageHeader?.({
-      page: activePage,
-      pageIndex: activeVisibleIndex,
-      totalPages: visiblePageIndexes.length
-    }) ?? /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { className: "fe-page-header", children: [
-      activePage.title === void 0 ? null : /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("h2", { className: "fe-page-title", children: activePage.title }),
-      activePage.description === void 0 ? null : /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("p", { className: "fe-page-description", children: activePage.description })
-    ] }),
-    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: "fe-fields", children: form.schema.fields.filter((field) => form.visibility[field.id] === true && (fieldIds === void 0 || fieldIds.has(field.id))).map((field) => {
-      const error = form.errors[field.id];
-      const props = {
-        field,
-        value: form.values[field.id],
-        error,
-        setValue: (value) => form.setValue(field.id, value),
-        translate: form.translate,
-        inputId: `${prefix}-${field.id}`,
-        errorId: `${prefix}-${field.id}-error`,
-        helpId: `${prefix}-${field.id}-help`,
-        ...slots.renderCharacterCount === void 0 ? {} : { renderCharacterCount: slots.renderCharacterCount }
-      };
-      if (slots.renderField !== void 0) {
-        return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react5.Fragment, { children: slots.renderField({
-          question: field,
-          value: form.values[field.id],
-          onChange: (value) => {
-            if (isFormValue(value)) form.setValue(field.id, value);
-          },
-          ...error === void 0 ? {} : { error }
-        }) }, field.id);
+              const Component = components[field.type];
+              return Component === void 0 ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(DefaultField, { ...props }, field.id) : /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Component, { ...props }, field.id);
+            });
+            const fieldClassName = `fe-fields${fieldsClassName === void 0 ? "" : ` ${fieldsClassName}`}`;
+            return slots.renderFields?.({ children: fieldChildren, className: fieldClassName }) ?? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: fieldClassName, children: fieldChildren });
+          })(),
+          guardMessage === null ? null : /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { role: "alert", children: guardMessage }),
+          confirmation !== null && submissionConfirmationRenderMode === "inline" ? confirmationContent : null,
+          validationIssues.length === 0 ? null : slots.renderValidationSummary?.({ issues: validationIssues }) ?? /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { className: "fe-validation-summary", role: "alert", children: [
+            validationIssues.length,
+            " validation error",
+            validationIssues.length === 1 ? "" : "s",
+            "."
+          ] }),
+          pages === void 0 ? /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_jsx_runtime3.Fragment, { children: [
+            slots.renderNavigation?.({
+              currentPage: 0,
+              totalPages: 1,
+              canPrev: false,
+              canNext: false,
+              onPrev: () => void 0,
+              onNext: () => void 0
+            }),
+            renderSubmitButton()
+          ] }) : /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { className: "form-step-navigation", children: [
+            slots.renderNavigation?.({
+              currentPage: activeVisibleIndex,
+              totalPages: visiblePageIndexes.length,
+              canPrev,
+              canNext,
+              onPrev: () => {
+                if (!interactionLocked) setCurrentPageIndex(visiblePageIndexes[activeVisibleIndex - 1] ?? 0);
+              },
+              onNext: handleNext
+            }) ?? /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_jsx_runtime3.Fragment, { children: [
+              canPrev ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+                "button",
+                {
+                  className: "btn-prev",
+                  type: "button",
+                  disabled: interactionLocked,
+                  onClick: () => setCurrentPageIndex(visiblePageIndexes[activeVisibleIndex - 1] ?? 0),
+                  children: form.translate("form.back")
+                }
+              ) : null,
+              canNext ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("button", { className: "btn-next", type: "button", disabled: interactionLocked, onClick: handleNext, children: form.translate("form.next") }) : null
+            ] }),
+            canNext ? null : renderSubmitButton()
+          ] }),
+          /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { className: "fe-status", "aria-live": "polite", children: [
+            form.submitStatus === "success" ? completionRegion : null,
+            form.submitStatus === "error" && form.submitError !== null ? slots.renderSubmitError?.({ error: form.submitError, onRetry: () => void submitValues() }) ?? (form.submitError instanceof FormSubmissionError && form.submitError.payload.formError !== void 0 ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { role: "alert", children: form.submitError.payload.formError }) : errorMessageKey === void 0 ? null : /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { role: "alert", children: form.translate(errorMessageKey) })) : null
+          ] })
+        ]
       }
-      const Component = components[field.type];
-      return Component === void 0 ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(DefaultField, { ...props }, field.id) : /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Component, { ...props }, field.id);
-    }) }),
-    guardMessage === null ? null : /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { role: "alert", children: guardMessage }),
-    confirmation === null ? null : slots.renderSubmissionConfirmation?.({
-      findings: confirmation.findings,
-      message: confirmation.message ?? form.translate("form.confirmSensitiveData"),
-      schema: form.schema,
-      visibleValues,
-      onConfirm: confirmSubmission,
-      onCancel: cancelSubmission
-    }) ?? /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { className: "fe-submission-confirmation", role: "dialog", "aria-modal": "true", children: [
-      /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("p", { children: confirmation.message ?? form.translate("form.confirmSensitiveData") }),
-      /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("button", { type: "button", onClick: confirmSubmission, children: form.translate("form.confirmSubmission") }),
-      /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("button", { type: "button", onClick: cancelSubmission, children: form.translate("form.cancelSubmission") })
-    ] }),
-    validationIssues.length === 0 ? null : slots.renderValidationSummary?.({ issues: validationIssues }) ?? /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { className: "fe-validation-summary", role: "alert", children: [
-      validationIssues.length,
-      " validation error",
-      validationIssues.length === 1 ? "" : "s",
-      "."
-    ] }),
-    pages === void 0 ? /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_jsx_runtime3.Fragment, { children: [
-      slots.renderNavigation?.({
-        currentPage: 0,
-        totalPages: 1,
-        canPrev: false,
-        canNext: false,
-        onPrev: () => void 0,
-        onNext: () => void 0
-      }),
-      renderSubmitButton()
-    ] }) : /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { className: "form-step-navigation", children: [
-      slots.renderNavigation?.({
-        currentPage: activeVisibleIndex,
-        totalPages: visiblePageIndexes.length,
-        canPrev,
-        canNext,
-        onPrev: () => {
-          if (!interactionLocked) setCurrentPageIndex(visiblePageIndexes[activeVisibleIndex - 1] ?? 0);
-        },
-        onNext: handleNext
-      }) ?? /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_jsx_runtime3.Fragment, { children: [
-        canPrev ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
-          "button",
-          {
-            className: "btn-prev",
-            type: "button",
-            disabled: interactionLocked,
-            onClick: () => setCurrentPageIndex(visiblePageIndexes[activeVisibleIndex - 1] ?? 0),
-            children: form.translate("form.back")
-          }
-        ) : null,
-        canNext ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("button", { className: "btn-next", type: "button", disabled: interactionLocked, onClick: handleNext, children: form.translate("form.next") }) : null
-      ] }),
-      canNext ? null : renderSubmitButton()
-    ] }),
-    /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { className: "fe-status", "aria-live": "polite", children: [
-      form.submitStatus === "success" ? slots.renderCompletion?.({
-        message: form.schema.completionMessage ?? (successMessageKey === void 0 ? "Submitted." : form.translate(successMessageKey))
-      }) ?? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { role: "status", children: form.schema.completionMessage ?? (successMessageKey === void 0 ? "Submitted." : form.translate(successMessageKey)) }) : null,
-      form.submitStatus === "error" && form.submitError !== null ? slots.renderSubmitError?.({ error: form.submitError, onRetry: () => void submitValues() }) ?? (errorMessageKey === void 0 ? null : /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { role: "alert", children: form.translate(errorMessageKey) })) : null
-    ] })
+    ),
+    confirmation !== null && submissionConfirmationRenderMode === "dialog" ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: "fe-confirmation-dialog-backdrop", role: "dialog", "aria-modal": "true", children: confirmationContent }) : null
   ] });
 }
 var RENDERER_MESSAGES = {
@@ -3448,6 +3679,8 @@ var RENDERER_MESSAGES = {
   "form.confirmSensitiveData": "Sensitive data may be included. Confirm before submitting.",
   "form.confirmSubmission": "Confirm submission",
   "form.cancelSubmission": "Cancel",
+  "form.yes": "Yes",
+  "form.no": "No",
   "form.alreadySubmitted": "Already submitted.",
   "form.submitAnother": "Submit another response",
   "validation.required": "This field is required."
@@ -3489,6 +3722,7 @@ function FormRenderer(props) {
   FormBuilder,
   FormProvider,
   FormRenderer,
+  FormSubmissionError,
   createLocalStorageSubmissionAttemptStore,
   createLocalStorageSubmissionReceiptStore,
   resolveInitialFieldType,