@atscript/vue-wf 0.1.63 → 0.1.64

package/README.md

@@ -17,6 +17,7 @@ Part of the [atscript-ui](https://github.com/moostjs/atscript-ui) monorepo.
 - `<AsWfForm>` — single component that drives the full workflow: posts current state, renders the next step's form, validates with the schema returned by the server, and resumes after pauses
 - Hooks for custom transport, error display, and per-step UI overrides
 - Built on [`@atscript/vue-form`](../vue-form), so all form-rendering primitives (field types, default renderers, layout grid) carry over
+- Default `AsWfFinish` screen + `wf.finish.*` scoped slots + `navigate` prop + `@dismiss` / `@action` events for the unified `WfFinished` terminal envelope. See [Finish Screens](https://ui.atscript.dev/workflows/finish-screens).
 
 ## Install
 

package/dist/as-wf-finish-B7mz8kVT.mjs

@@ -0,0 +1,206 @@
+import { Fragment, computed, createCommentVNode, createElementBlock, createElementVNode, defineComponent, normalizeStyle, onMounted, onUnmounted, openBlock, ref, renderList, renderSlot, toDisplayString, watch } from "vue";
+//#region src/components/defaults/as-wf-finish.vue?vue&type=script&setup=true&lang.ts
+const _hoisted_1 = {
+	key: 0,
+	class: "sr-only",
+	"aria-live": "polite"
+};
+const _hoisted_2 = ["data-level"];
+const _hoisted_3 = {
+	key: 0,
+	class: "as-wf-finish-actions"
+};
+const _hoisted_4 = { class: "as-wf-finish-skip-label" };
+const _hoisted_5 = {
+	class: "as-wf-finish-countdown",
+	"aria-live": "polite"
+};
+const _hoisted_6 = {
+	key: 2,
+	class: "as-wf-finish-actions"
+};
+const _hoisted_7 = ["autofocus", "onClick"];
+//#endregion
+//#region src/components/defaults/as-wf-finish.vue
+var as_wf_finish_default = /* @__PURE__ */ defineComponent({
+	__name: "as-wf-finish",
+	props: {
+		payload: {
+			type: [Object, null],
+			required: true
+		},
+		navigate: {
+			type: Function,
+			required: false
+		}
+	},
+	emits: ["dismiss", "action"],
+	setup(__props, { emit: __emit }) {
+		const props = __props;
+		const emit = __emit;
+		async function dispatchRedirect(url) {
+			if (props.navigate) {
+				await props.navigate(url);
+				return;
+			}
+			const loc = globalThis.location;
+			if (loc?.assign) {
+				loc.assign(url);
+				return;
+			}
+			console.error(`[AsWfFinish] Cannot redirect to "${url}": no \`navigate\` prop and no browser environment. Pass a \`navigate\` prop to AsWfForm / AsWfFinish.`);
+		}
+		function runAction(action) {
+			emit("action", action);
+			if (action.type === "redirect") {
+				dispatchRedirect(action.target);
+				return;
+			}
+			if (action.type === "reload") {
+				window.location.reload();
+				return;
+			}
+			if (action.type === "dismiss") emit("dismiss");
+		}
+		const end = computed(() => props.payload?.end ?? null);
+		const message = computed(() => props.payload?.message ?? null);
+		let autoTimer;
+		let countdownInterval;
+		let autoStartedAt = 0;
+		const totalSeconds = ref(0);
+		const secondsRemaining = ref(0);
+		const autoCancelled = ref(false);
+		function clearAutoTimers() {
+			if (autoTimer !== void 0) {
+				clearTimeout(autoTimer);
+				autoTimer = void 0;
+			}
+			if (countdownInterval !== void 0) {
+				clearInterval(countdownInterval);
+				countdownInterval = void 0;
+			}
+		}
+		function startAutoTimer() {
+			const e = end.value;
+			if (!e || e.mode !== "auto") return;
+			clearAutoTimers();
+			autoCancelled.value = false;
+			autoStartedAt = Date.now();
+			totalSeconds.value = Math.ceil(e.timeoutMs / 1e3);
+			secondsRemaining.value = totalSeconds.value;
+			autoTimer = setTimeout(() => {
+				clearAutoTimers();
+				runAction(e.action);
+			}, e.timeoutMs);
+			countdownInterval = setInterval(() => {
+				const elapsed = Date.now() - autoStartedAt;
+				const remainMs = Math.max(0, e.timeoutMs - elapsed);
+				const next = Math.ceil(remainMs / 1e3);
+				if (next !== secondsRemaining.value) secondsRemaining.value = next;
+			}, 250);
+		}
+		function skipAuto() {
+			const e = end.value;
+			if (!e || e.mode !== "auto") return;
+			const behavior = e.skipButton?.behavior ?? "now";
+			clearAutoTimers();
+			if (behavior === "now") runAction(e.action);
+			else autoCancelled.value = true;
+		}
+		function cancelAuto() {
+			clearAutoTimers();
+			autoCancelled.value = true;
+		}
+		function applyMode() {
+			const e = end.value;
+			if (!e) return;
+			if (e.mode === "immediate") {
+				runAction(e.action);
+				return;
+			}
+			if (e.mode === "auto") startAutoTimer();
+		}
+		onMounted(() => applyMode());
+		watch(() => props.payload, (next, prev) => {
+			if (next === prev) return;
+			clearAutoTimers();
+			applyMode();
+		});
+		onUnmounted(() => clearAutoTimers());
+		const manualPrimary = computed(() => end.value?.mode === "manual" ? end.value.primary ?? null : null);
+		const manualOptions = computed(() => end.value?.mode === "manual" ? end.value.options ?? [] : []);
+		function onKeydown(ev) {
+			if (ev.key !== "Enter") return;
+			const target = manualPrimary.value ?? manualOptions.value[0] ?? null;
+			if (!target) return;
+			ev.preventDefault();
+			runAction(target.action);
+		}
+		function triggerButton(btn) {
+			runAction(btn.action);
+		}
+		const skipScope = computed(() => {
+			const e = end.value;
+			if (e?.mode !== "auto" || !e.skipButton) return null;
+			const behavior = e.skipButton.behavior ?? "now";
+			return {
+				label: e.skipButton.label,
+				behavior
+			};
+		});
+		return (_ctx, _cache) => {
+			return end.value?.mode === "immediate" ? (openBlock(), createElementBlock("span", _hoisted_1, "Redirecting…")) : (openBlock(), createElementBlock("div", {
+				key: 1,
+				class: "as-wf-finish",
+				onKeydown
+			}, [
+				message.value ? renderSlot(_ctx.$slots, "message", {
+					key: 0,
+					message: message.value
+				}, () => [createElementVNode("div", {
+					class: "as-wf-finish-message",
+					"data-level": message.value.level,
+					role: "status"
+				}, toDisplayString(message.value.text), 9, _hoisted_2)]) : createCommentVNode("v-if", true),
+				end.value?.mode === "auto" && !autoCancelled.value ? (openBlock(), createElementBlock(Fragment, { key: 1 }, [skipScope.value ? (openBlock(), createElementBlock("div", _hoisted_3, [renderSlot(_ctx.$slots, "skip", {
+					button: skipScope.value,
+					trigger: skipAuto
+				}, () => [createElementVNode("button", {
+					type: "button",
+					class: "as-wf-finish-skip",
+					style: normalizeStyle({ "--progress-duration": `${end.value.timeoutMs}ms` }),
+					onClick: skipAuto
+				}, [_cache[1] || (_cache[1] = createElementVNode("span", { class: "as-wf-finish-skip-fill" }, null, -1)), createElementVNode("span", _hoisted_4, toDisplayString(skipScope.value.label), 1)], 4)])])) : createCommentVNode("v-if", true), renderSlot(_ctx.$slots, "countdown", {
+					secondsRemaining: secondsRemaining.value,
+					totalSeconds: totalSeconds.value,
+					skip: skipAuto,
+					cancel: cancelAuto
+				}, () => [createElementVNode("div", _hoisted_5, " Continuing in " + toDisplayString(secondsRemaining.value) + "… ", 1)])], 64)) : createCommentVNode("v-if", true),
+				end.value?.mode === "manual" ? (openBlock(), createElementBlock("div", _hoisted_6, [manualPrimary.value ? renderSlot(_ctx.$slots, "primary", {
+					key: 0,
+					button: manualPrimary.value,
+					trigger: () => triggerButton(manualPrimary.value)
+				}, () => [createElementVNode("button", {
+					type: "button",
+					class: "as-wf-finish-primary",
+					autofocus: "",
+					onClick: _cache[0] || (_cache[0] = ($event) => triggerButton(manualPrimary.value))
+				}, toDisplayString(manualPrimary.value.label), 1)]) : createCommentVNode("v-if", true), (openBlock(true), createElementBlock(Fragment, null, renderList(manualOptions.value, (btn, index) => {
+					return renderSlot(_ctx.$slots, "option", {
+						key: index,
+						button: btn,
+						index,
+						trigger: () => triggerButton(btn)
+					}, () => [createElementVNode("button", {
+						type: "button",
+						class: "as-wf-finish-option",
+						autofocus: !manualPrimary.value && index === 0,
+						onClick: ($event) => triggerButton(btn)
+					}, toDisplayString(btn.label), 9, _hoisted_7)]);
+				}), 128))])) : createCommentVNode("v-if", true)
+			], 32));
+		};
+	}
+});
+//#endregion
+export { as_wf_finish_default as t };

package/dist/as-wf-finish.d.mts

@@ -0,0 +1,2 @@
+import { t as _default } from "./as-wf-finish.vue-BrMzuLaH.mjs";
+export { _default as default };

package/dist/as-wf-finish.mjs

@@ -0,0 +1,2 @@
+import { t as as_wf_finish_default } from "./as-wf-finish-B7mz8kVT.mjs";
+export { as_wf_finish_default as default };

package/dist/as-wf-finish.vue-BrMzuLaH.d.mts

@@ -0,0 +1,64 @@
+import { a as WfMessage, n as WfButton, r as WfFinished, t as WfAction } from "./index-KRfH1NOi.mjs";
+import * as vue from "vue";
+
+//#region src/components/defaults/as-wf-finish.vue.d.ts
+type __VLS_Props = {
+  payload: WfFinished | null;
+  /**
+   * Consumer-provided navigation handler. Receives the redirect target URL —
+   * the consumer decides cross-origin vs in-app routing. Mirrors the
+   * `navigate` option on `@atscript/db-client`'s `Client`: one handler
+   * across the stack.
+   */
+  navigate?: (url: string) => void | Promise<void>;
+};
+declare function skipAuto(): void;
+declare function cancelAuto(): void;
+declare var __VLS_1: {
+    message: WfMessage;
+  }, __VLS_3: {
+    button: {
+      readonly label: string;
+      readonly behavior: "now" | "cancel";
+    };
+    trigger: typeof skipAuto;
+  }, __VLS_5: {
+    secondsRemaining: number;
+    totalSeconds: number;
+    skip: typeof skipAuto;
+    cancel: typeof cancelAuto;
+  }, __VLS_7: {
+    button: WfButton;
+    trigger: () => void;
+  }, __VLS_9: {
+    button: WfButton;
+    index: number;
+    trigger: () => void;
+  };
+type __VLS_Slots = {} & {
+  message?: (props: typeof __VLS_1) => any;
+} & {
+  skip?: (props: typeof __VLS_3) => any;
+} & {
+  countdown?: (props: typeof __VLS_5) => any;
+} & {
+  primary?: (props: typeof __VLS_7) => any;
+} & {
+  option?: (props: typeof __VLS_9) => any;
+};
+declare const __VLS_base: vue.DefineComponent<__VLS_Props, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
+  dismiss: () => any;
+  action: (action: WfAction) => any;
+}, string, vue.PublicProps, Readonly<__VLS_Props> & Readonly<{
+  onDismiss?: (() => any) | undefined;
+  onAction?: ((action: WfAction) => any) | undefined;
+}>, {}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+type __VLS_WithSlots<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
+//#endregion
+export { _default as t };

package/dist/{as-wf-form-CBBvLmgY.mjs → as-wf-form-CxIEWOyU.mjs}

@@ -1,4 +1,5 @@
-import { computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, defineComponent, guardReactiveProps, normalizeProps, onMounted, onUnmounted, openBlock, reactive, ref, renderSlot, shallowRef, toDisplayString, toRaw, unref, watch, withCtx } from "vue";
+import { t as as_wf_finish_default } from "./as-wf-finish-B7mz8kVT.mjs";
+import { computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createSlots, createVNode, defineComponent, guardReactiveProps, normalizeProps, onMounted, onUnmounted, openBlock, reactive, ref, renderSlot, shallowRef, toDisplayString, toRaw, unref, watch, withCtx } from "vue";
 import { WF_ACTION_WITH_DATA, createFormData, createFormDef, getFieldMeta } from "@atscript/ui";
 import { deserializeAnnotatedType } from "@atscript/typescript/utils";
 import { AsForm } from "@atscript/vue-form";
@@ -12,6 +13,7 @@ function useWfForm(options) {
 	const formContext = shallowRef({});
 	const errors = shallowRef({});
 	const response = shallowRef(null);
+	const finishedPayload = shallowRef(null);
 	const error = shallowRef(null);
 	const loading = ref(false);
 	const finished = ref(false);
@@ -48,6 +50,7 @@ function useWfForm(options) {
 		if (data.finished) {
 			finished.value = true;
 			response.value = data;
+			finishedPayload.value = data;
 			formDef.value = null;
 			formData.value = null;
 			lastPayloadJson = void 0;
@@ -56,6 +59,7 @@ function useWfForm(options) {
 		if (data.sent === true || typeof data.outlet === "string") {
 			finished.value = true;
 			response.value = data;
+			finishedPayload.value = null;
 			formDef.value = null;
 			formData.value = null;
 			lastPayloadJson = void 0;
@@ -97,14 +101,20 @@ function useWfForm(options) {
 				signal,
 				body: JSON.stringify(buildBody(body))
 			});
+			const data = await res.json().catch(() => null);
+			if (data && typeof data === "object" && !Array.isArray(data)) extractToken(data);
 			if (!res.ok) {
 				error.value = {
-					message: (await res.json().catch(() => ({ message: res.statusText }))).message ?? res.statusText,
+					message: data?.message ?? res.statusText,
 					status: res.status
 				};
 				return;
 			}
-			processResponse(await res.json());
+			if (!data) {
+				error.value = { message: "Unexpected response format" };
+				return;
+			}
+			processResponse(data);
 		} catch (err) {
 			if (err instanceof DOMException && err.name === "AbortError") return;
 			error.value = { message: err instanceof Error ? err.message : "Network error" };
@@ -115,6 +125,9 @@ function useWfForm(options) {
 	async function start(input) {
 		const initialToken = readInitialToken();
 		if (initialToken) token = initialToken;
+		if (import.meta.env?.DEV && !initialToken && transport !== "query") {
+			if (new URLSearchParams(window.location.search).get(tokenName)) console.warn(`[useWfForm] URL contains ?${tokenName}=… but no \`initialToken\` was passed and \`tokenTransport\` is "${transport}". Workflow will start fresh instead of resuming the magic-link flow. Pass \`initial-token="route.query.${tokenName}"\` or set \`tokenTransport: "query"\`.`);
+		}
 		const body = { [wfidName]: options.name };
 		if (input) body.input = input;
 		if (initialToken) body[tokenName] = initialToken;
@@ -146,6 +159,7 @@ function useWfForm(options) {
 		loading,
 		finished,
 		response,
+		finishedPayload,
 		error,
 		start,
 		submit,
@@ -156,7 +170,10 @@ function useWfForm(options) {
 }
 //#endregion
 //#region src/components/as-wf-form.vue?vue&type=script&setup=true&lang.ts
-const _hoisted_1 = { key: 0 };
+const _hoisted_1 = {
+	key: 0,
+	class: "as-wf-form-loading"
+};
 const _hoisted_2 = { key: 1 };
 const _hoisted_3 = { key: 2 };
 const _hoisted_4 = { key: 3 };
@@ -186,6 +203,10 @@ var as_wf_form_default = /* @__PURE__ */ defineComponent({
 			type: Function,
 			required: false
 		},
+		navigate: {
+			type: Function,
+			required: false
+		},
 		path: {
 			type: String,
 			required: true
@@ -236,7 +257,9 @@ var as_wf_form_default = /* @__PURE__ */ defineComponent({
 		"error",
 		"form",
 		"submit",
-		"loading"
+		"loading",
+		"dismiss",
+		"action"
 	],
 	setup(__props, { emit: __emit }) {
 		const props = __props;
@@ -289,10 +312,47 @@ var as_wf_form_default = /* @__PURE__ */ defineComponent({
 					submit: onSubmit,
 					retry: unref(wf).retry
 				}
-			}, () => [unref(wf).loading.value && !unref(wf).formDef.value ? (openBlock(), createElementBlock("div", _hoisted_1, [renderSlot(_ctx.$slots, "wf.loading")])) : unref(wf).error.value && !unref(wf).formDef.value ? (openBlock(), createElementBlock("div", _hoisted_2, [renderSlot(_ctx.$slots, "wf.error", {
+			}, () => [unref(wf).loading.value && !unref(wf).formDef.value ? (openBlock(), createElementBlock("div", _hoisted_1, [renderSlot(_ctx.$slots, "wf.loading", {}, () => [_cache[2] || (_cache[2] = createElementVNode("div", { class: "as-form-overlay" }, [createElementVNode("span", {
+				class: "as-form-overlay-icon",
+				"aria-hidden": "true"
+			})], -1))])])) : unref(wf).error.value && !unref(wf).formDef.value ? (openBlock(), createElementBlock("div", _hoisted_2, [renderSlot(_ctx.$slots, "wf.error", {
 				error: unref(wf).error.value,
 				retry: unref(wf).retry
-			}, () => [createElementVNode("div", null, toDisplayString(unref(wf).error.value?.message ?? "Error"), 1)])])) : unref(wf).finished.value ? (openBlock(), createElementBlock("div", _hoisted_3, [renderSlot(_ctx.$slots, "wf.finished", { response: unref(wf).response.value })])) : unref(wf).formDef.value && unref(wf).formData.value ? (openBlock(), createElementBlock("div", _hoisted_4, [unref(wf).error.value ? renderSlot(_ctx.$slots, "form.error", {
+			}, () => [createElementVNode("div", null, toDisplayString(unref(wf).error.value?.message ?? "Error"), 1)])])) : unref(wf).finished.value ? (openBlock(), createElementBlock("div", _hoisted_3, [renderSlot(_ctx.$slots, "wf.finished", {
+				response: unref(wf).response.value,
+				payload: unref(wf).finishedPayload.value
+			}, () => [createCommentVNode("\n          Per `feedback_vue_empty_slot`: a `<template #x>` registered on a child\n          short-circuits the child's default fallback even when its content is\n          empty. So we only forward slot names that the AsWfForm consumer\n          actually provided — otherwise AsWfFinish's defaults render.\n        "), createVNode(as_wf_finish_default, {
+				payload: unref(wf).finishedPayload.value,
+				navigate: __props.navigate,
+				onDismiss: _cache[0] || (_cache[0] = () => emit("dismiss")),
+				onAction: _cache[1] || (_cache[1] = (a) => emit("action", a))
+			}, createSlots({ _: 2 }, [
+				_ctx.$slots["wf.finish.message"] ? {
+					name: "message",
+					fn: withCtx((scope) => [renderSlot(_ctx.$slots, "wf.finish.message", normalizeProps(guardReactiveProps(scope)))]),
+					key: "0"
+				} : void 0,
+				_ctx.$slots["wf.finish.countdown"] ? {
+					name: "countdown",
+					fn: withCtx((scope) => [renderSlot(_ctx.$slots, "wf.finish.countdown", normalizeProps(guardReactiveProps(scope)))]),
+					key: "1"
+				} : void 0,
+				_ctx.$slots["wf.finish.skip"] ? {
+					name: "skip",
+					fn: withCtx((scope) => [renderSlot(_ctx.$slots, "wf.finish.skip", normalizeProps(guardReactiveProps(scope)))]),
+					key: "2"
+				} : void 0,
+				_ctx.$slots["wf.finish.primary"] ? {
+					name: "primary",
+					fn: withCtx((scope) => [renderSlot(_ctx.$slots, "wf.finish.primary", normalizeProps(guardReactiveProps(scope)))]),
+					key: "3"
+				} : void 0,
+				_ctx.$slots["wf.finish.option"] ? {
+					name: "option",
+					fn: withCtx((scope) => [renderSlot(_ctx.$slots, "wf.finish.option", normalizeProps(guardReactiveProps(scope)))]),
+					key: "4"
+				} : void 0
+			]), 1032, ["payload", "navigate"])])])) : unref(wf).formDef.value && unref(wf).formData.value ? (openBlock(), createElementBlock("div", _hoisted_4, [unref(wf).error.value ? renderSlot(_ctx.$slots, "form.error", {
 				key: 0,
 				error: unref(wf).error.value,
 				retry: unref(wf).retry

package/dist/as-wf-form.d.mts

@@ -1,2 +1,2 @@
-import { t as _default } from "./as-wf-form.vue-BP739hjJ.mjs";
+import { t as _default } from "./as-wf-form.vue-CBujwX55.mjs";
 export { _default as default };

package/dist/as-wf-form.mjs

@@ -1,2 +1,3 @@
-import { t as as_wf_form_default } from "./as-wf-form-CBBvLmgY.mjs";
+import { t as as_wf_form_default } from "./as-wf-form-CxIEWOyU.mjs";
+import "./as-wf-finish-B7mz8kVT.mjs";
 export { as_wf_form_default as default };

package/dist/{as-wf-form.vue-BP739hjJ.d.mts → as-wf-form.vue-CBujwX55.d.mts}

@@ -1,3 +1,4 @@
+import { a as WfMessage, n as WfButton, r as WfFinished, t as WfAction } from "./index-KRfH1NOi.mjs";
 import * as vue from "vue";
 import { Component, Ref, ShallowRef } from "vue";
 import { ClientFactory, FormDef } from "@atscript/ui";
@@ -51,6 +52,8 @@ interface UseWfFormReturn {
   loading: Ref<boolean>;
   finished: Ref<boolean>;
   response: ShallowRef<unknown>;
+  /** Typed envelope on finish — null while running, on outlet pause, or before first response. */
+  finishedPayload: ShallowRef<WfFinished | null>;
   error: ShallowRef<unknown>;
   start: (input?: Record<string, unknown>) => Promise<void>;
   submit: (data: unknown) => Promise<void>;
@@ -70,6 +73,12 @@ interface AsWfFormProps extends UseWfFormOptions {
   components?: Record<string, Component>;
   /** Per-form client factory override (FK value-help). Forwarded to AsForm. */
   clientFactory?: ClientFactory;
+  /**
+   * Consumer-provided navigation handler forwarded to `<AsWfFinish>`. Pairs
+   * with `@atscript/db-client`'s `Client({ navigate })` option so one handler
+   * covers both workflow redirects and DB navigate-actions.
+   */
+  navigate?: (url: string) => void | Promise<void>;
 }
 declare function onSubmit(data: unknown): void;
 declare var __VLS_1: {
@@ -94,31 +103,52 @@ declare var __VLS_1: {
     retry: () => Promise<void>;
   }, __VLS_7: {
     response: unknown;
-  }, __VLS_9: {
+    payload: WfFinished<unknown> | null;
+  }, __VLS_19: {
+    message: WfMessage;
+  }, __VLS_22: {
+    secondsRemaining: number;
+    totalSeconds: number;
+    skip: () => void;
+    cancel: () => void;
+  }, __VLS_25: {
+    button: {
+      readonly label: string;
+      readonly behavior: "now" | "cancel";
+    };
+    trigger: () => void;
+  }, __VLS_28: {
+    button: WfButton;
+    trigger: () => void;
+  }, __VLS_31: {
+    button: WfButton;
+    index: number;
+    trigger: () => void;
+  }, __VLS_33: {
     error: {};
     retry: () => Promise<void>;
-  }, __VLS_22: {
+  }, __VLS_46: {
     loading: boolean;
     clearErrors: () => void;
     reset: () => Promise<void>;
     setErrors: (errors: Record<string, string>) => void;
     formContext: Record<string, unknown> | undefined;
     disabled: boolean;
-  }, __VLS_25: {
+  }, __VLS_49: {
     loading: boolean;
     clearErrors: () => void;
     reset: () => Promise<void>;
     setErrors: (errors: Record<string, string>) => void;
     formContext: Record<string, unknown> | undefined;
     disabled: boolean;
-  }, __VLS_28: {
+  }, __VLS_52: {
     loading: boolean;
     clearErrors: () => void;
     reset: () => Promise<void>;
     setErrors: (errors: Record<string, string>) => void;
     disabled: boolean;
     formContext: Record<string, unknown> | undefined;
-  }, __VLS_31: {
+  }, __VLS_55: {
     loading: boolean;
     disabled: boolean;
     text: string;
@@ -126,7 +156,7 @@ declare var __VLS_1: {
     reset: () => Promise<void>;
     setErrors: (errors: Record<string, string>) => void;
     formContext: Record<string, unknown> | undefined;
-  }, __VLS_34: {
+  }, __VLS_58: {
     loading: boolean;
     disabled: boolean;
     clearErrors: () => void;
@@ -143,33 +173,47 @@ type __VLS_Slots = {} & {
 } & {
   'wf.finished'?: (props: typeof __VLS_7) => any;
 } & {
-  'form.error'?: (props: typeof __VLS_9) => any;
+  'wf.finish.message'?: (props: typeof __VLS_19) => any;
+} & {
+  'wf.finish.countdown'?: (props: typeof __VLS_22) => any;
+} & {
+  'wf.finish.skip'?: (props: typeof __VLS_25) => any;
+} & {
+  'wf.finish.primary'?: (props: typeof __VLS_28) => any;
+} & {
+  'wf.finish.option'?: (props: typeof __VLS_31) => any;
 } & {
-  'form.header'?: (props: typeof __VLS_22) => any;
+  'form.error'?: (props: typeof __VLS_33) => any;
 } & {
-  'form.before'?: (props: typeof __VLS_25) => any;
+  'form.header'?: (props: typeof __VLS_46) => any;
 } & {
-  'form.after'?: (props: typeof __VLS_28) => any;
+  'form.before'?: (props: typeof __VLS_49) => any;
 } & {
-  'form.submit'?: (props: typeof __VLS_31) => any;
+  'form.after'?: (props: typeof __VLS_52) => any;
 } & {
-  'form.footer'?: (props: typeof __VLS_34) => any;
+  'form.submit'?: (props: typeof __VLS_55) => any;
+} & {
+  'form.footer'?: (props: typeof __VLS_58) => any;
 };
 declare const __VLS_base: vue.DefineComponent<AsWfFormProps, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
-  finished: (response: unknown) => any;
+  dismiss: () => any;
+  action: (action: WfAction) => any;
   error: (error: {
     message: string;
     status?: number;
   }) => any;
+  finished: (response: unknown) => any;
   submit: (data: unknown) => any;
   loading: (isLoading: boolean) => any;
   form: (def: FormDef, context?: Record<string, unknown> | undefined) => any;
 }, string, vue.PublicProps, Readonly<AsWfFormProps> & Readonly<{
-  onFinished?: ((response: unknown) => any) | undefined;
+  onDismiss?: (() => any) | undefined;
+  onAction?: ((action: WfAction) => any) | undefined;
   onError?: ((error: {
     message: string;
     status?: number;
   }) => any) | undefined;
+  onFinished?: ((response: unknown) => any) | undefined;
   onSubmit?: ((data: unknown) => any) | undefined;
   onLoading?: ((isLoading: boolean) => any) | undefined;
   onForm?: ((def: FormDef, context?: Record<string, unknown> | undefined) => any) | undefined;

package/dist/index-KRfH1NOi.d.mts

@@ -0,0 +1,44 @@
+//#region ../moost-wf/src/wf-finished.d.ts
+interface WfFinished<TData = unknown> {
+  finished: true;
+  data?: TData;
+  message?: WfMessage;
+  end?: WfFinishedEnd;
+  aborted?: boolean;
+  reason?: string;
+}
+interface WfMessage {
+  level: "info" | "success" | "warn" | "error";
+  text: string;
+}
+type WfFinishedEnd = {
+  mode: "immediate";
+  action: WfAction;
+} | {
+  mode: "auto";
+  timeoutMs: number;
+  action: WfAction;
+  skipButton?: {
+    label: string;
+    behavior?: "now" | "cancel";
+  };
+} | {
+  mode: "manual";
+  primary?: WfButton;
+  options?: WfButton[];
+};
+interface WfButton {
+  label: string;
+  action: WfAction;
+}
+type WfAction = {
+  type: "redirect";
+  target: string;
+  reason?: string;
+} | {
+  type: "reload";
+} | {
+  type: "dismiss";
+};
+//#endregion
+export { WfMessage as a, WfFinishedEnd as i, WfButton as n, WfFinished as r, WfAction as t };

package/dist/index.d.mts

@@ -1,2 +1,4 @@
-import { i as useWfForm, n as UseWfFormOptions, r as UseWfFormReturn, t as _default } from "./as-wf-form.vue-BP739hjJ.mjs";
-export { _default as AsWfForm, type UseWfFormOptions, type UseWfFormReturn, useWfForm };
+import { a as WfMessage, i as WfFinishedEnd, n as WfButton, r as WfFinished, t as WfAction } from "./index-KRfH1NOi.mjs";
+import { i as useWfForm, n as UseWfFormOptions, r as UseWfFormReturn, t as _default$1 } from "./as-wf-form.vue-CBujwX55.mjs";
+import { t as _default } from "./as-wf-finish.vue-BrMzuLaH.mjs";
+export { _default as AsWfFinish, _default$1 as AsWfForm, type UseWfFormOptions, type UseWfFormReturn, type WfAction, type WfButton, type WfFinished, type WfFinishedEnd, type WfMessage, useWfForm };

package/dist/index.mjs

@@ -1,2 +1,3 @@
-import { n as useWfForm, t as as_wf_form_default } from "./as-wf-form-CBBvLmgY.mjs";
-export { as_wf_form_default as AsWfForm, useWfForm };
+import { n as useWfForm, t as as_wf_form_default } from "./as-wf-form-CxIEWOyU.mjs";
+import { t as as_wf_finish_default } from "./as-wf-finish-B7mz8kVT.mjs";
+export { as_wf_finish_default as AsWfFinish, as_wf_form_default as AsWfForm, useWfForm };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/vue-wf",
-  "version": "0.1.63",
+  "version": "0.1.64",
   "description": "Workflow form integration for Vue 3 — HTTP round-trip loop driven by atscript type metadata",
   "keywords": [
     "atscript",
@@ -36,6 +36,10 @@
       "types": "./dist/index.d.mts",
       "import": "./dist/index.mjs"
     },
+    "./as-wf-finish": {
+      "types": "./dist/as-wf-finish.d.mts",
+      "import": "./dist/as-wf-finish.mjs"
+    },
     "./as-wf-form": {
       "types": "./dist/as-wf-form.d.mts",
       "import": "./dist/as-wf-form.mjs"
@@ -46,7 +50,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@atscript/ui": "^0.1.63"
+    "@atscript/ui": "^0.1.64"
   },
   "devDependencies": {
     "@atscript/core": "^0.1.56",
@@ -58,13 +62,13 @@
     "vitest": "npm:@voidzero-dev/vite-plus-test@latest",
     "vue": "^3",
     "vue-tsc": "^3.2.6",
-    "@atscript/moost-wf": "^0.1.63",
-    "@atscript/vue-form": "^0.1.63"
+    "@atscript/moost-wf": "^0.1.64",
+    "@atscript/vue-form": "^0.1.64"
   },
   "peerDependencies": {
     "@atscript/typescript": "^0.1.56",
     "vue": "^3",
-    "@atscript/vue-form": "^0.1.63"
+    "@atscript/vue-form": "^0.1.64"
   },
   "scripts": {
     "build": "node ../../scripts/gen-exports.mjs && vp pack",