@bagelink/vue 1.15.447 → 1.15.450

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bagelink/vue",
   "type": "module",
-  "version": "1.15.447",
+  "version": "1.15.450",
   "description": "Bagel core sdk packages",
   "author": {
     "name": "Bagel Studio",

package/src/form-flow/FormFlowPlayer.vue

@@ -23,7 +23,7 @@ import { fromJSONSchema } from './form-flow'
 import type { JSONSchemaOptionsSourceLoader } from './form-flow'
 import Btn from '../components/Btn.vue'
 import FormFlow from './FormFlow.vue'
-import type { FormStepEventPayload } from './structure'
+import type { FormStepCompleteEventPayload, FormStepEventPayload } from './structure'
 import { autoAdvanceFieldKey, entryStepKey, pathProgress, resolveNext, stepAutoAdvances, stepByKey } from './structure'
 
 export interface Props {
@@ -83,6 +83,8 @@ const emit = defineEmits<{
 	'progress': [value: number]
 	/** Fired when a step is entered (including the first). */
 	'stepEnter': [payload: FormStepEventPayload]
+	/** Fired after approval, immediately before successful forward navigation. */
+	'stepComplete': [payload: FormStepCompleteEventPayload]
 	/** Fired when the form is submitted from a terminal step. */
 	'formComplete': [payload: FormStepEventPayload]
 	/** The form is about to redirect to `url` (fired even if `redirect` is off). */
@@ -227,6 +229,12 @@ async function onPrimary() {
 	// Advance to the resolved next step.
 	const target = nextKey.value
 	if (target && currentKey.value) {
+		const destination = stepByKey(props.structure, target)
+		emit('stepComplete', {
+			...buildPayload(currentKey.value),
+			destinationStepKey: target,
+			destinationStepTitle: destination?.title ?? '',
+		})
 		slideDir.value = 'next'
 		history.value.push(currentKey.value)
 		currentKey.value = target

package/src/form-flow/structure.ts

@@ -77,6 +77,12 @@ export interface FormStepEventPayload {
 	formData: Record<string, any>
 }
 
+/** A validated, approved transition from a completed step to its destination. */
+export interface FormStepCompleteEventPayload extends FormStepEventPayload {
+	destinationStepKey: string
+	destinationStepTitle: string
+}
+
 /** An empty structure (single-step / not-yet-built). */
 export function emptyStructure(): FormStructure {
 	return { steps: [], transitions: [] }