@sonata-innovations/fiber-fbre 3.2.0 → 3.3.0

package/dist/index.d.ts

@@ -31,6 +31,7 @@ import { ComponentYesNoProperties } from '@sonata-innovations/fiber-types';
 import { ConditionGroup } from '@sonata-innovations/fiber-types';
 import { ConditionOperator } from '@sonata-innovations/fiber-types';
 import { ConditionRule } from '@sonata-innovations/fiber-types';
+import { ConfirmationConfig } from '@sonata-innovations/fiber-types';
 import { ControlsConfig } from '@sonata-innovations/fiber-types';
 import { DateFormat } from '@sonata-innovations/fiber-types';
 import { FC } from 'react';
@@ -143,6 +144,22 @@ export { ConditionOperator }
 
 export { ConditionRule }
 
+export { ConfirmationConfig }
+
+/**
+ * Parent-supplied override for the terminal confirmation screen.
+ *
+ * Returned (directly or via a resolved Promise) from `onFlowComplete`. When an
+ * object is returned it replaces the flow's configured `confirmation` message —
+ * useful for content only known after submit, e.g. a server-generated
+ * reference number. `title`/`body` support the same `${...}` reference markup
+ * as the configured message.
+ */
+export declare type ConfirmationResult = {
+    title?: string;
+    body?: string;
+};
+
 export { ControlsConfig }
 
 export { DateFormat }
@@ -173,7 +190,15 @@ declare interface FBRECallbackProps {
     screenIndex?: number;
     context?: Record<string, string | boolean | number>;
     storeRef?: React.MutableRefObject<StoreApi<FBREStoreState> | null>;
-    onFlowComplete: (data: any) => void | Promise<void>;
+    /**
+     * Called when the flow is submitted, with the collected {@link FlowData}.
+     * Return (or resolve with) a {@link ConfirmationResult} to override the
+     * flow's configured confirmation message — e.g. with a server-generated
+     * reference number. Returning a Promise keeps the submit button in its
+     * in-flight state until it settles; a rejection surfaces as a completion
+     * error and the confirmation is not shown.
+     */
+    onFlowComplete: (data: FlowData) => void | ConfirmationResult | Promise<void | ConfirmationResult>;
     onScreenChange?: (index: number, data: any) => void;
     onScreenValidationChange?: (index: number, data: any) => void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sonata-innovations/fiber-fbre",
-	"version": "3.2.0",
+	"version": "3.3.0",
 	"description": "Fiber Render Engine — renders Flow JSON forms with conditional logic, validation, and screen transitions",
 	"keywords": ["fiber", "form-builder", "form-renderer", "react", "flow-json", "data-collection"],
 	"license": "MIT",