@form-engine-ts/react 6.0.0 → 6.2.0

package/dist/index.js

@@ -922,7 +922,9 @@ function resolveTranslation(key, aliases, adapter, defaultCatalog, params = {},
 }
 
 // src/i18n/provider.tsx
-import { createFormEngineTranslator } from "@form-engine-ts/core";
+import {
+  createFormEngineTranslator
+} from "@form-engine-ts/core";
 import { createContext, useContext, useMemo as useMemo2 } from "react";
 import { jsx } from "react/jsx-runtime";
 var defaultTranslator = createFormEngineTranslator({ locale: "ja" });
@@ -936,6 +938,8 @@ function FormEngineI18nProvider({
   fallbackLocale = "en",
   messages,
   customCatalogs,
+  onMissingKey,
+  strict,
   translator: customTranslator,
   children
 }) {
@@ -945,9 +949,11 @@ function FormEngineI18nProvider({
       locale,
       fallbackLocale,
       ...messages === void 0 ? {} : { messages },
-      ...customCatalogs === void 0 ? {} : { customCatalogs }
+      ...customCatalogs === void 0 ? {} : { customCatalogs },
+      ...onMissingKey === void 0 ? {} : { onMissingKey },
+      ...strict === void 0 ? {} : { strict }
     });
-  }, [customCatalogs, customTranslator, fallbackLocale, locale, messages]);
+  }, [customCatalogs, customTranslator, fallbackLocale, locale, messages, onMissingKey, strict]);
   const value = useMemo2(() => ({ uiLocale: locale, translator }), [locale, translator]);
   return /* @__PURE__ */ jsx(FormEngineI18nProviderScopeContext.Provider, { value: true, children: /* @__PURE__ */ jsx(FormEngineI18nContext.Provider, { value, children }) });
 }
@@ -2524,6 +2530,7 @@ function FormBuilder({
               LocalizationSlot,
               {
                 schema,
+                onChange,
                 translate,
                 currentLocale: editingLocale,
                 onCurrentLocaleChange: setEditingLocale,
@@ -3048,24 +3055,14 @@ import {
   assertValidFormSchema,
   calculateFieldVisibility,
   calculatePageVisibility,
+  FormSubmissionError,
+  isFormSubmissionSerializedError,
   resolveLocalizedSchema,
   selectVisibleAnswers,
   validateAnswers,
   validatePageAnswers
 } from "@form-engine-ts/core";
 import { createContext as createContext3, useCallback as useCallback2, useContext as useContext3, useEffect, useMemo as useMemo3, useRef, useState as useState3 } from "react";
-
-// src/types.ts
-var FormSubmissionError = class extends Error {
-  payload;
-  constructor(message, payload) {
-    super(message);
-    this.name = "FormSubmissionError";
-    this.payload = payload ?? { formError: message };
-  }
-};
-
-// src/context.tsx
 import { jsx as jsx3 } from "react/jsx-runtime";
 var FormContext = createContext3(null);
 function issuesByField(issues) {
@@ -3202,10 +3199,12 @@ function FormProvider({
         setSubmitStatus("success");
         return response === void 0 ? { status: "success" } : { status: "success", response };
       } catch (cause) {
-        const error = isServerErrorPayload(cause) ? new FormSubmissionError(
-          cause.formError ?? (cause instanceof Error ? cause.message : "Form submission failed."),
-          cause
-        ) : cause instanceof Error ? cause : new Error(String(cause));
+        const error = isFormSubmissionSerializedError(cause) ? new FormSubmissionError(cause) : isServerErrorPayload(cause) ? new FormSubmissionError({
+          code: "VALIDATION_FAILED",
+          messageKey: cause.formError ?? "Submission failed",
+          fieldErrors: cause.fieldErrors ?? {},
+          formErrors: cause.formError === void 0 ? [] : [cause.formError]
+        }) : cause instanceof Error ? cause : new Error(String(cause));
         setSubmitError(error);
         setSubmitStatus("error");
         return { status: "error", error };
@@ -3273,6 +3272,10 @@ function useField(fieldId) {
   return { field, value: form.values[fieldId], error: form.errors[fieldId], setValue };
 }
 
+// src/hooks/useTranslationComparison.ts
+import { computeSourceTextHash as computeSourceTextHash2 } from "@form-engine-ts/core";
+import { useCallback as useCallback4, useMemo as useMemo5, useState as useState5 } from "react";
+
 // src/hooks/useTranslationWorkspace.ts
 import {
   collectSchemaLocales as collectSchemaLocales2,
@@ -3462,6 +3465,7 @@ function useTranslationWorkspace({
   sourceLocale = schema.defaultLocale ?? "en",
   targetLocale,
   translationAdapter,
+  signal,
   readOnly = false,
   policy,
   availableLocales,
@@ -3473,6 +3477,7 @@ function useTranslationWorkspace({
   slots: workspaceSlots,
   onTranslationStart,
   onTranslationSuccess,
+  onTranslationReport,
   onTranslationError,
   onTranslationChange,
   validateLocale
@@ -3480,8 +3485,10 @@ function useTranslationWorkspace({
   const [draftSchema, setDraftSchema] = useState4(schema);
   const [selectedLocale, setSelectedLocale] = useState4(normalizeLocale(targetLocale ?? "") ?? targetLocale ?? "");
   const [isTranslating, setIsTranslating] = useState4(false);
+  const [progress, setProgress] = useState4();
   const [error, setError] = useState4();
   const [pendingRemoval, setPendingRemoval] = useState4();
+  const activeAbortController = useRef2(void 0);
   const pendingRemovalResolver = useRef2(void 0);
   const currentSchema = onChange === void 0 ? draftSchema : schema;
   const confirmRemoveLocaleRenderer = confirmRemoveLocale ?? workspaceSlots?.confirmRemoveLocale;
@@ -3721,7 +3728,15 @@ function useTranslationWorkspace({
       }
       setIsTranslating(true);
       setError(void 0);
+      setProgress(void 0);
       onTranslationStart?.({ targetLocale: activeLocale, mode: "automatic" });
+      const controller = new AbortController();
+      activeAbortController.current = controller;
+      const operationSignal = options.signal ?? signal;
+      const abortListener = operationSignal === void 0 ? void 0 : () => controller.abort(operationSignal.reason);
+      if (operationSignal?.aborted) controller.abort(operationSignal.reason);
+      else if (operationSignal !== void 0 && abortListener !== void 0)
+        operationSignal.addEventListener("abort", abortListener, { once: true });
       try {
         const populated = await populateSchemaTranslations2(
           currentSchema,
@@ -3730,13 +3745,36 @@ function useTranslationWorkspace({
           {
             overwrite: "stale-and-missing",
             preserveManualTranslations: true,
-            ...options
+            ...options,
+            continueOnError: true,
+            signal: controller.signal,
+            onProgress: (nextProgress) => {
+              setProgress(nextProgress);
+              options.onProgress?.(nextProgress);
+            }
           }
         );
         commit(populated.schema);
+        onTranslationReport?.(populated.report);
         const missingSlotsCount = collectTranslationSlots(populated.schema, activeLocale).filter(
           (slot) => slot.status === "missing"
         ).length;
+        if (populated.report.cancelled === true) {
+          const workspaceError = { type: "cancelled" };
+          setError(workspaceError);
+          onTranslationError?.({ targetLocale: activeLocale, error: workspaceError });
+          return { success: false, report: populated.report, error: workspaceError };
+        }
+        if ((populated.report.failed ?? 0) > 0) {
+          const workspaceError = {
+            type: "partial_failure",
+            succeeded: populated.report.succeeded ?? populated.report.updatedSlots.length,
+            failed: populated.report.failed ?? 0
+          };
+          setError(workspaceError);
+          onTranslationError?.({ targetLocale: activeLocale, error: workspaceError });
+          return { success: false, report: populated.report, error: workspaceError };
+        }
         onTranslationSuccess?.({
           sourceLocale,
           targetLocale: activeLocale,
@@ -3747,6 +3785,12 @@ function useTranslationWorkspace({
         });
         return { success: true, report: populated.report };
       } catch (cause) {
+        if (controller.signal.aborted || cause instanceof DOMException && cause.name === "AbortError") {
+          const workspaceError2 = { type: "cancelled" };
+          setError(workspaceError2);
+          onTranslationError?.({ targetLocale: activeLocale, error: workspaceError2 });
+          return { success: false, error: workspaceError2 };
+        }
         const workspaceError = {
           type: "translation_failed",
           message: cause instanceof Error ? cause.message : String(cause),
@@ -3756,6 +3800,11 @@ function useTranslationWorkspace({
         onTranslationError?.({ targetLocale: activeLocale, error: workspaceError });
         return { success: false, error: workspaceError };
       } finally {
+        if (operationSignal !== void 0 && abortListener !== void 0) {
+          const listener = abortListener;
+          operationSignal.removeEventListener("abort", listener);
+        }
+        if (activeAbortController.current === controller) activeAbortController.current = void 0;
         setIsTranslating(false);
       }
     },
@@ -3767,14 +3816,19 @@ function useTranslationWorkspace({
       onTranslationError,
       onTranslationStart,
       onTranslationSuccess,
+      onTranslationReport,
       readOnly,
       slots,
       sourceLocale,
-      translationAdapter
+      translationAdapter,
+      signal
     ]
   );
+  const cancelTranslation = useCallback3(() => {
+    activeAbortController.current?.abort(new DOMException("The translation was cancelled.", "AbortError"));
+  }, []);
   const translateSlot = useCallback3(
-    async (slot) => {
+    async (slot, options = {}) => {
       if (translationAdapter === void 0) {
         const workspaceError = { type: "adapter_not_configured" };
         setError(workspaceError);
@@ -3787,8 +3841,21 @@ function useTranslationWorkspace({
       }
       setIsTranslating(true);
       setError(void 0);
+      setProgress({ total: 1, completed: 0, succeeded: 0, failed: 0, percentage: 0 });
+      const controller = new AbortController();
+      activeAbortController.current = controller;
+      const operationSignal = options.signal ?? signal;
+      const abortListener = operationSignal === void 0 ? void 0 : () => controller.abort(operationSignal.reason);
+      if (operationSignal?.aborted) controller.abort(operationSignal.reason);
+      else if (operationSignal !== void 0 && abortListener !== void 0)
+        operationSignal.addEventListener("abort", abortListener, { once: true });
       try {
-        const text = await asAsyncAdapter(translationAdapter).translateText(slot.sourceText, slot.locale, sourceLocale);
+        const text = await asAsyncAdapter(translationAdapter).translateText(
+          slot.sourceText,
+          slot.locale,
+          sourceLocale,
+          controller.signal
+        );
         const metadata = translationMetadata(slot.sourceText, sourceLocale, "automatic");
         commit(updateSchemaTranslation(currentSchema, slot, text, sourceLocale, "automatic"));
         onTranslationChange?.({
@@ -3798,8 +3865,15 @@ function useTranslationWorkspace({
           mode: "automatic",
           metadata
         });
+        setProgress({ total: 1, completed: 1, succeeded: 1, failed: 0, percentage: 100 });
         return { success: true };
       } catch (cause) {
+        if (controller.signal.aborted || cause instanceof DOMException && cause.name === "AbortError") {
+          const workspaceError2 = { type: "cancelled" };
+          setError(workspaceError2);
+          onTranslationError?.({ targetLocale: slot.locale, error: workspaceError2 });
+          return { success: false, error: workspaceError2 };
+        }
         const workspaceError = {
           type: "translation_failed",
           message: cause instanceof Error ? cause.message : String(cause),
@@ -3808,10 +3882,15 @@ function useTranslationWorkspace({
         setError(workspaceError);
         return { success: false, error: workspaceError };
       } finally {
+        if (operationSignal !== void 0 && abortListener !== void 0) {
+          const listener = abortListener;
+          operationSignal.removeEventListener("abort", listener);
+        }
+        if (activeAbortController.current === controller) activeAbortController.current = void 0;
         setIsTranslating(false);
       }
     },
-    [commit, currentSchema, onTranslationChange, readOnly, sourceLocale, translationAdapter]
+    [commit, currentSchema, onTranslationChange, onTranslationError, readOnly, signal, sourceLocale, translationAdapter]
   );
   return {
     sourceLocale,
@@ -3832,13 +3911,159 @@ function useTranslationWorkspace({
     setTranslation,
     translateAll,
     translateSlot,
+    cancelTranslation,
     isTranslating,
+    ...progress === void 0 ? {} : { progress },
     ...error === void 0 ? {} : { error }
   };
 }
 
+// src/hooks/useTranslationComparison.ts
+function canonicalMetadata(metadata, sourceText, sourceLocale, translatedText) {
+  if (translatedText === void 0 || translatedText.trim().length === 0) return void 0;
+  if (metadata !== void 0 && typeof metadata.sourceLocale === "string" && typeof metadata.sourceTextHash === "string" && (metadata.translationSource === "automatic" || metadata.translationSource === "manual")) {
+    return {
+      ...metadata,
+      sourceLocale: metadata.sourceLocale,
+      sourceTextHash: metadata.sourceTextHash,
+      translationSource: metadata.translationSource,
+      ...typeof metadata.translatedAt === "string" ? { translatedAt: metadata.translatedAt } : {},
+      ...typeof metadata.editedAt === "string" ? { editedAt: metadata.editedAt } : {}
+    };
+  }
+  const canonicalKeys = /* @__PURE__ */ new Set(["sourceLocale", "sourceTextHash", "translationSource", "translatedAt", "editedAt"]);
+  const extensions = Object.fromEntries(Object.entries(metadata ?? {}).filter(([key]) => !canonicalKeys.has(key)));
+  return {
+    ...extensions,
+    sourceLocale: typeof metadata?.sourceLocale === "string" ? metadata.sourceLocale : sourceLocale,
+    sourceTextHash: computeSourceTextHash2(sourceText),
+    translationSource: metadata?.isManual === true || metadata?.isManuallyEdited === true || metadata?.translationSource === "manual" ? "manual" : "automatic"
+  };
+}
+function optionParentId(slot) {
+  if (slot.kind !== "option" || slot.path === void 0) return void 0;
+  return /^fields\.([^.]+)\.options\./u.exec(slot.path)?.[1];
+}
+function getNodeTitle(schema, slot) {
+  if (slot.kind === "field") return schema.fields.find((field) => field.id === slot.nodeId)?.title;
+  if (slot.kind === "page") return schema.pages?.find((page) => page.id === slot.nodeId)?.title;
+  if (slot.kind === "option") return schema.fields.find((field) => field.id === optionParentId(slot))?.title;
+  return void 0;
+}
+function comparisonItem(schema, slot, sourceLocale, hasAdapter) {
+  const path = slot.path ?? `${slot.kind}.${slot.nodeId}.${slot.property}`;
+  const nodeTitle = getNodeTitle(schema, slot);
+  const metadata = canonicalMetadata(
+    slot.existingTranslationMetadata,
+    slot.sourceText,
+    sourceLocale,
+    slot.existingText
+  );
+  return {
+    id: path,
+    path,
+    targetKind: slot.kind,
+    targetProperty: slot.property,
+    ...nodeTitle === void 0 ? {} : { nodeTitle },
+    sourceText: slot.sourceText,
+    translatedText: slot.existingText ?? "",
+    status: slot.status ?? "missing",
+    ...metadata === void 0 ? {} : { metadata },
+    translatable: hasAdapter && slot.sourceText.trim().length > 0
+  };
+}
+function summaryFor(items) {
+  const counts = {
+    missing: 0,
+    translated: 0,
+    stale: 0,
+    manual: 0,
+    "manual-stale": 0
+  };
+  for (const item of items) counts[item.status] += 1;
+  return {
+    total: items.length,
+    translated: counts.translated + counts.manual,
+    missing: counts.missing,
+    stale: counts.stale + counts["manual-stale"],
+    manual: counts.manual + counts["manual-stale"]
+  };
+}
+function useTranslationComparison({
+  schema,
+  sourceLocale = schema.defaultLocale ?? "en",
+  targetLocale,
+  translationAdapter,
+  readOnly = false,
+  onChange,
+  onTranslationChange,
+  onTranslationReport,
+  onTranslationError,
+  signal
+}) {
+  const workspace = useTranslationWorkspace({
+    schema,
+    sourceLocale,
+    targetLocale,
+    ...translationAdapter === void 0 ? {} : { translationAdapter },
+    readOnly,
+    ...onChange === void 0 ? {} : { onChange },
+    ...onTranslationChange === void 0 ? {} : { onTranslationChange },
+    ...onTranslationReport === void 0 ? {} : { onTranslationReport },
+    ...onTranslationError === void 0 ? {} : { onTranslationError },
+    ...signal === void 0 ? {} : { signal }
+  });
+  const [report, setReport] = useState5();
+  const items = useMemo5(
+    () => workspace.slots.map((slot) => comparisonItem(schema, slot, sourceLocale, translationAdapter !== void 0)),
+    [schema, sourceLocale, translationAdapter, workspace.slots]
+  );
+  const itemByPath = useMemo5(() => new Map(workspace.slots.map((slot) => [slot.path, slot])), [workspace.slots]);
+  const updateTranslation = useCallback4(
+    (path, text) => {
+      const slot = itemByPath.get(path);
+      if (slot !== void 0) workspace.setTranslation(slot, text);
+    },
+    [itemByPath, workspace]
+  );
+  const translateSingle = useCallback4(
+    async (path) => {
+      const slot = itemByPath.get(path);
+      if (slot === void 0) return;
+      const result = await workspace.translateSlot(slot);
+      if (!result.success) throw new Error(result.error?.type ?? "Translation failed.");
+    },
+    [itemByPath, workspace]
+  );
+  const translateAll = useCallback4(
+    async (options) => {
+      const result = await workspace.translateAll(options);
+      if (result.report !== void 0) {
+        setReport(result.report);
+        return result.report;
+      }
+      throw new Error(result.error?.type ?? "Translation failed.");
+    },
+    [workspace]
+  );
+  return {
+    sourceLocale: workspace.sourceLocale,
+    targetLocale: workspace.targetLocale,
+    items,
+    summary: summaryFor(items),
+    isTranslating: workspace.isTranslating,
+    updateTranslation,
+    translateSingle,
+    translateAll,
+    cancelTranslation: workspace.cancelTranslation,
+    ...workspace.progress === void 0 ? {} : { progress: workspace.progress },
+    ...workspace.error === void 0 ? {} : { error: workspace.error },
+    ...report === void 0 ? {} : { report }
+  };
+}
+
 // src/receipt.ts
-import { useEffect as useEffect2, useMemo as useMemo5, useState as useState5 } from "react";
+import { useEffect as useEffect2, useMemo as useMemo6, useState as useState6 } from "react";
 function submissionReceiptQueryKey(formId, formVersion) {
   return `${formId}:v${formVersion}`;
 }
@@ -3909,14 +4134,14 @@ function createLocalStorageSubmissionReceiptStore(options = {}) {
 }
 function useSubmissionReceipts(store, queries) {
   const querySignature = JSON.stringify(queries.map(({ formId, formVersion }) => [formId, formVersion]));
-  const stableQueries = useMemo5(() => {
+  const stableQueries = useMemo6(() => {
     const parsed = JSON.parse(querySignature);
     if (!Array.isArray(parsed)) return [];
     return parsed.flatMap(
       (entry) => Array.isArray(entry) && typeof entry[0] === "string" && typeof entry[1] === "number" && Number.isSafeInteger(entry[1]) ? [{ formId: entry[0], formVersion: entry[1] }] : []
     );
   }, [querySignature]);
-  const [state, setState] = useState5({
+  const [state, setState] = useState6({
     receipts: /* @__PURE__ */ new Map(),
     isLoading: stableQueries.length > 0,
     error: null
@@ -3956,18 +4181,20 @@ function useSubmissionReceipts(store, queries) {
 
 // src/renderer.tsx
 import {
+  FormSubmissionError as FormSubmissionError2,
+  isFormSubmissionSerializedError as isFormSubmissionSerializedError2,
   selectVisibleAnswers as selectVisibleAnswers2,
   validateAnswers as validateAnswers2
 } from "@form-engine-ts/core";
 import {
   Fragment as Fragment2,
-  useCallback as useCallback4,
+  useCallback as useCallback5,
   useContext as useContext4,
   useEffect as useEffect3,
   useId,
-  useMemo as useMemo6,
+  useMemo as useMemo7,
   useRef as useRef3,
-  useState as useState6
+  useState as useState7
 } from "react";
 import { Fragment as Fragment3, jsx as jsx4, jsxs as jsxs2 } from "react/jsx-runtime";
 var isChoiceFieldType = (type) => type === "radio" || type === "checkbox" || type === "multi-select" || type === "select";
@@ -4484,29 +4711,29 @@ function ContextFormRenderer({
   const prefix = useId().replace(/:/g, "");
   const formRef = useRef3(null);
   const loadedDraftKey = useRef3(null);
-  const [draftRestored, setDraftRestored] = useState6(false);
-  const [currentPageIndex, setCurrentPageIndex] = useState6(0);
-  const [focusFieldId, setFocusFieldId] = useState6(null);
-  const [confirmation, setConfirmation] = useState6(null);
-  const [guardMessage, setGuardMessage] = useState6(null);
-  const [guardsPending, setGuardsPending] = useState6(false);
-  const [receipt, setReceipt] = useState6(null);
-  const [completionData, setCompletionData] = useState6(null);
-  const [receiptLoaded, setReceiptLoaded] = useState6(receiptStore === void 0);
+  const [draftRestored, setDraftRestored] = useState7(false);
+  const [currentPageIndex, setCurrentPageIndex] = useState7(0);
+  const [focusFieldId, setFocusFieldId] = useState7(null);
+  const [confirmation, setConfirmation] = useState7(null);
+  const [guardMessage, setGuardMessage] = useState7(null);
+  const [guardsPending, setGuardsPending] = useState7(false);
+  const [receipt, setReceipt] = useState7(null);
+  const [completionData, setCompletionData] = useState7(null);
+  const [receiptLoaded, setReceiptLoaded] = useState7(receiptStore === void 0);
   const rendererSubmissionInFlight = useRef3(false);
   const fallbackAttemptId = useRef3(null);
   const completionRef = useRef3(null);
   const confirmationRef = useRef3(null);
   const pages = form.schema.pages;
-  const visiblePageIndexes = useMemo6(
+  const visiblePageIndexes = useMemo7(
     () => pages === void 0 ? [] : pages.flatMap((page, index) => form.pageVisibility[page.id] === true ? [index] : []),
     [form.pageVisibility, pages]
   );
   const activePage = pages?.[currentPageIndex];
   const activeVisibleIndex = visiblePageIndexes.indexOf(currentPageIndex);
   const fieldIds = activePage === void 0 ? void 0 : new Set(activePage.questionIds);
-  const visibleValues = useMemo6(() => selectVisibleAnswers2(form.schema, form.values), [form.schema, form.values]);
-  const visibleItems = useMemo6(
+  const visibleValues = useMemo7(() => selectVisibleAnswers2(form.schema, form.values), [form.schema, form.values]);
+  const visibleItems = useMemo7(
     () => buildSubmittedItems(form.schema, form.values, form.visibility, (key) => form.translate(key), false),
     [form.schema, form.translate, form.values, form.visibility]
   );
@@ -4515,7 +4742,7 @@ function ContextFormRenderer({
   const submitState = confirmation === null && !guardsPending ? form.submitStatus : "confirming";
   const interactionLocked = submitState === "confirming" || submitState === "submitting";
   const isReplaceMode = successRenderMode === "replace" || hideFormOnSuccess;
-  const resolveMessage = useCallback4(
+  const resolveMessage = useCallback5(
     (key, fallback) => {
       const providerDefault = isProviderValue ? i18n.translator(`renderer.${key}`) : void 0;
       const defaultText = fallback ?? (providerDefault === "" ? void 0 : providerDefault) ?? DEFAULT_RENDERER_MESSAGES[form.locale.toLowerCase().startsWith("ja") ? "ja" : "en"][key] ?? key;
@@ -4524,11 +4751,11 @@ function ContextFormRenderer({
     },
     [form.locale, i18n, isProviderValue, messageResolver, messages]
   );
-  const fieldTranslate = useCallback4(
+  const fieldTranslate = useCallback5(
     (key, params) => key === "validation.required" && (messages.requiredField !== void 0 || messageResolver !== void 0) ? resolveMessage("requiredField") : form.translate(key, params),
     [form.translate, messageResolver, messages.requiredField, resolveMessage]
   );
-  const focusSubmitButton = useCallback4(() => {
+  const focusSubmitButton = useCallback5(() => {
     const button = formRef.current?.querySelector(".fe-submit, button[type='submit'], button");
     button?.focus();
   }, []);
@@ -4739,8 +4966,9 @@ function ContextFormRenderer({
         return result;
       }
       if (result.status === "error") {
-        if (result.error instanceof FormSubmissionError) {
-          const fieldErrors = result.error.payload.fieldErrors ?? {};
+        const payload = result.error instanceof FormSubmissionError2 ? result.error.payload : isFormSubmissionSerializedError2(result.error) ? result.error : void 0;
+        if (payload !== void 0) {
+          const fieldErrors = payload.fieldErrors ?? {};
           form.setServerErrors?.(fieldErrors);
           const firstServerFieldId = form.schema.fields.find((field) => Object.hasOwn(fieldErrors, field.id))?.id ?? Object.keys(fieldErrors)[0];
           if (firstServerFieldId !== void 0) {
@@ -4748,6 +4976,9 @@ function ContextFormRenderer({
             if (invalidPageIndex !== void 0 && invalidPageIndex >= 0) setCurrentPageIndex(invalidPageIndex);
             focusFirstIssue(firstServerFieldId);
           }
+          if (payload.piiFindings !== void 0 && payload.piiFindings.length > 0) {
+            setConfirmation({ findings: payload.piiFindings, generic: false });
+          }
         }
         return result;
       }
@@ -5049,8 +5280,8 @@ function ContextFormRenderer({
           ] }),
           /* @__PURE__ */ jsxs2("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__ */ jsxs2("div", { role: "alert", children: [
-              form.submitError.payload.formError,
+            form.submitStatus === "error" && form.submitError !== null ? slots.renderSubmitError?.({ error: form.submitError, onRetry: () => void submitValues() }) ?? (form.submitError instanceof FormSubmissionError2 && (form.submitError.payload.formErrors?.length ?? 0) > 0 ? /* @__PURE__ */ jsxs2("div", { role: "alert", children: [
+              form.submitError.payload.formErrors?.map((message) => /* @__PURE__ */ jsx4("div", { children: message }, message)),
               /* @__PURE__ */ jsx4("button", { type: "button", onClick: () => void submitValues(), children: resolveMessage("retryButton") })
             ] }) : /* @__PURE__ */ jsxs2("div", { role: "alert", children: [
               errorMessageKey === void 0 ? resolveMessage("serverErrorSummary") : form.translate(errorMessageKey),
@@ -5133,6 +5364,9 @@ function FormRenderer(props) {
     }
   );
 }
+
+// src/types.ts
+import { FormSubmissionError as FormSubmissionError3 } from "@form-engine-ts/core";
 export {
   BUILDER_TRANSLATION_ALIASES,
   BUILDER_TRANSLATION_KEYS,
@@ -5141,7 +5375,7 @@ export {
   FormEngineI18nProvider,
   FormProvider,
   FormRenderer,
-  FormSubmissionError,
+  FormSubmissionError3 as FormSubmissionError,
   createLocalStorageSubmissionAttemptStore,
   createLocalStorageSubmissionReceiptStore,
   isTranslationUnresolved,
@@ -5156,6 +5390,7 @@ export {
   useFormBuilder,
   useFormEngineI18n,
   useSubmissionReceipts,
+  useTranslationComparison,
   useTranslationWorkspace,
   validateLocalePipeline
 };

package/package.json

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