@atscript/vue-form 0.1.88 → 0.1.90

package/dist/{as-form-BpcP_wIF.cjs → as-form-BRuzVUsN.cjs}

@@ -207,6 +207,29 @@ function useAsForm(options) {
 	}));
 	const submitText = (0, vue.computed)(() => (0, _atscript_ui.resolveFormProp)(options.def().type, _atscript_ui.UI_FORM_FN_SUBMIT_TEXT, _atscript_ui.UI_FORM_SUBMIT_TEXT, ctx.value) ?? "Submit");
 	const submitDisabled = (0, vue.computed)(() => options.loading?.() === true || ((0, _atscript_ui.resolveFormProp)(options.def().type, _atscript_ui.UI_FORM_FN_SUBMIT_DISABLED, void 0, ctx.value) ?? false));
+	const resolveRootProp = (fnKey, staticKey) => {
+		const root = options.def().rootField;
+		return root ? (0, _atscript_ui.resolveFieldProp)(root.prop, fnKey, staticKey, ctx.value) : void 0;
+	};
+	const title = (0, vue.computed)(() => resolveRootProp(_atscript_ui.UI_FORM_FN_TITLE, _atscript_ui.META_LABEL));
+	const description = (0, vue.computed)(() => resolveRootProp(_atscript_ui.UI_FORM_FN_DESCRIPTION, _atscript_ui.META_DESCRIPTION));
+	const slotProps = (0, vue.computed)(() => ({
+		title: title.value,
+		description: description.value,
+		data: data.value,
+		errors: ext.effective.value,
+		formError: ext.formError.value,
+		disabled: submitDisabled.value,
+		loading: options.loading?.() === true,
+		submitText: submitText.value,
+		submit: onSubmit,
+		reset: resetState,
+		clearErrors,
+		setErrors,
+		dismissError: ext.dismissAt,
+		dismissFormError: ext.dismissForm,
+		formContext: formContext.value
+	}));
 	function supportsAction(def, actionId) {
 		return def.fields.some((f) => {
 			if ((0, _atscript_ui.getFieldMeta)(f.prop, _atscript_ui.UI_FORM_ACTION)?.id === actionId) return true;
@@ -260,6 +283,9 @@ function useAsForm(options) {
 		onSubmit,
 		submitText,
 		submitDisabled,
+		title,
+		description,
+		slotProps,
 		invokeAction,
 		dismissError: ext.dismissAt,
 		dismissFormError: ext.dismissForm,
@@ -369,46 +395,19 @@ var as_form_default = /* @__PURE__ */ (0, vue.defineComponent)({
 				inert: __props.loading,
 				onSubmit: _cache[1] || (_cache[1] = (0, vue.withModifiers)((...args) => (0, vue.unref)(form).onSubmit && (0, vue.unref)(form).onSubmit(...args), ["prevent"]))
 			}, [
-				(0, vue.renderSlot)(_ctx.$slots, "form.header", {
-					clearErrors: (0, vue.unref)(form).clearErrors,
-					reset: (0, vue.unref)(form).reset,
-					setErrors: (0, vue.unref)(form).setErrors,
-					formContext: __props.formContext,
-					disabled: (0, vue.unref)(form).submitDisabled.value
-				}),
-				(0, vue.renderSlot)(_ctx.$slots, "form.before", {
-					clearErrors: (0, vue.unref)(form).clearErrors,
-					reset: (0, vue.unref)(form).reset,
-					setErrors: (0, vue.unref)(form).setErrors,
-					formContext: __props.formContext,
-					disabled: (0, vue.unref)(form).submitDisabled.value
-				}),
+				(0, vue.renderSlot)(_ctx.$slots, "form.header", (0, vue.normalizeProps)((0, vue.guardReactiveProps)((0, vue.unref)(form).slotProps.value))),
+				(0, vue.renderSlot)(_ctx.$slots, "form.before", (0, vue.normalizeProps)((0, vue.guardReactiveProps)((0, vue.unref)(form).slotProps.value))),
 				(0, vue.createVNode)(require_as_field.as_field_default, { field: __props.def.rootField }, null, 8, ["field"]),
-				(0, vue.renderSlot)(_ctx.$slots, "form.after", {
-					clearErrors: (0, vue.unref)(form).clearErrors,
-					reset: (0, vue.unref)(form).reset,
-					setErrors: (0, vue.unref)(form).setErrors,
-					disabled: (0, vue.unref)(form).submitDisabled.value,
-					formContext: __props.formContext
-				}),
-				(0, vue.unref)(form).formError.value ? (0, vue.renderSlot)(_ctx.$slots, "form.error", {
-					key: 0,
+				(0, vue.renderSlot)(_ctx.$slots, "form.after", (0, vue.normalizeProps)((0, vue.guardReactiveProps)((0, vue.unref)(form).slotProps.value))),
+				(0, vue.unref)(form).formError.value ? (0, vue.renderSlot)(_ctx.$slots, "form.error", (0, vue.mergeProps)({ key: 0 }, (0, vue.unref)(form).slotProps.value, {
 					message: (0, vue.unref)(form).formError.value,
 					dismiss: (0, vue.unref)(form).dismissFormError
-				}, () => [(0, vue.createElementVNode)("div", _hoisted_2, [(0, vue.createElementVNode)("span", _hoisted_3, (0, vue.toDisplayString)((0, vue.unref)(form).formError.value), 1), (0, vue.createElementVNode)("button", {
+				}), () => [(0, vue.createElementVNode)("div", _hoisted_2, [(0, vue.createElementVNode)("span", _hoisted_3, (0, vue.toDisplayString)((0, vue.unref)(form).formError.value), 1), (0, vue.createElementVNode)("button", {
 					type: "button",
 					class: "as-form-error-dismiss",
 					onClick: _cache[0] || (_cache[0] = (...args) => (0, vue.unref)(form).dismissFormError && (0, vue.unref)(form).dismissFormError(...args))
 				}, " Dismiss ")])]) : (0, vue.createCommentVNode)("v-if", true),
-				!__props.hideSubmit ? (0, vue.renderSlot)(_ctx.$slots, "form.submit", {
-					key: 1,
-					disabled: (0, vue.unref)(form).submitDisabled.value,
-					text: (0, vue.unref)(form).submitText.value,
-					clearErrors: (0, vue.unref)(form).clearErrors,
-					reset: (0, vue.unref)(form).reset,
-					setErrors: (0, vue.unref)(form).setErrors,
-					formContext: __props.formContext
-				}, () => [(0, vue.createElementVNode)("button", {
+				!__props.hideSubmit ? (0, vue.renderSlot)(_ctx.$slots, "form.submit", (0, vue.mergeProps)({ key: 1 }, (0, vue.unref)(form).slotProps.value, { text: (0, vue.unref)(form).submitText.value }), () => [(0, vue.createElementVNode)("button", {
 					class: "as-submit-btn",
 					disabled: (0, vue.unref)(form).submitDisabled.value
 				}, (0, vue.toDisplayString)((0, vue.unref)(form).submitText.value), 9, _hoisted_4)]) : (0, vue.createCommentVNode)("v-if", true),
@@ -417,14 +416,8 @@ var as_form_default = /* @__PURE__ */ (0, vue.defineComponent)({
 					def: __props.def,
 					fields: __props.def.pushDownFields
 				}, null, 8, ["def", "fields"])])) : (0, vue.createCommentVNode)("v-if", true),
-				(0, vue.renderSlot)(_ctx.$slots, "form.footer", {
-					disabled: (0, vue.unref)(form).submitDisabled.value,
-					clearErrors: (0, vue.unref)(form).clearErrors,
-					reset: (0, vue.unref)(form).reset,
-					setErrors: (0, vue.unref)(form).setErrors,
-					formContext: __props.formContext
-				}),
-				__props.loading ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("div", _hoisted_6, [(0, vue.renderSlot)(_ctx.$slots, "form.loading", {}, () => [_cache[2] || (_cache[2] = (0, vue.createElementVNode)("span", {
+				(0, vue.renderSlot)(_ctx.$slots, "form.footer", (0, vue.normalizeProps)((0, vue.guardReactiveProps)((0, vue.unref)(form).slotProps.value))),
+				__props.loading ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("div", _hoisted_6, [(0, vue.renderSlot)(_ctx.$slots, "form.loading", (0, vue.normalizeProps)((0, vue.guardReactiveProps)((0, vue.unref)(form).slotProps.value)), () => [_cache[2] || (_cache[2] = (0, vue.createElementVNode)("span", {
 					class: "as-form-overlay-icon",
 					"aria-hidden": "true"
 				}, null, -1))])])) : (0, vue.createCommentVNode)("v-if", true)

package/dist/{as-form-Cb5orGFC.mjs → as-form-cszNv3LX.mjs}

@@ -3,8 +3,8 @@ import { n as provideAsNestedSectionsStore, r as useAsNestedSectionsStore, t as
 import { t as CLIENT_FACTORY_KEY } from "./use-as-value-help-CBykDEjZ.mjs";
 import { t as as_field_default } from "./as-field-CryuaPPU.mjs";
 import { t as as_iterator_default } from "./as-iterator-B0Jf2zn4.mjs";
-import { computed, createCommentVNode, createElementBlock, createElementVNode, createVNode, defineComponent, nextTick, openBlock, provide, reactive, ref, renderSlot, toDisplayString, toRaw, toValue, unref, watch, watchEffect, withModifiers } from "vue";
-import { UI_FORM_ACTION, UI_FORM_FN_SUBMIT_DISABLED, UI_FORM_FN_SUBMIT_TEXT, UI_FORM_SUBMIT_TEXT, WF_ACTION_WITH_DATA, buildDescendantErrorCounts, getFieldMeta, getFormValidator, iteratePathAncestors, mergeErrorMaps, resolveFormProp } from "@atscript/ui";
+import { computed, createCommentVNode, createElementBlock, createElementVNode, createVNode, defineComponent, guardReactiveProps, mergeProps, nextTick, normalizeProps, openBlock, provide, reactive, ref, renderSlot, toDisplayString, toRaw, toValue, unref, watch, watchEffect, withModifiers } from "vue";
+import { META_DESCRIPTION, META_LABEL, UI_FORM_ACTION, UI_FORM_FN_DESCRIPTION, UI_FORM_FN_SUBMIT_DISABLED, UI_FORM_FN_SUBMIT_TEXT, UI_FORM_FN_TITLE, UI_FORM_SUBMIT_TEXT, WF_ACTION_WITH_DATA, buildDescendantErrorCounts, getFieldMeta, getFormValidator, iteratePathAncestors, mergeErrorMaps, resolveFieldProp, resolveFormProp } from "@atscript/ui";
 //#region src/composables/use-as-external-errors.ts
 /**
 * Local dismissal state for externally-supplied errors.
@@ -207,6 +207,29 @@ function useAsForm(options) {
 	}));
 	const submitText = computed(() => resolveFormProp(options.def().type, UI_FORM_FN_SUBMIT_TEXT, UI_FORM_SUBMIT_TEXT, ctx.value) ?? "Submit");
 	const submitDisabled = computed(() => options.loading?.() === true || (resolveFormProp(options.def().type, UI_FORM_FN_SUBMIT_DISABLED, void 0, ctx.value) ?? false));
+	const resolveRootProp = (fnKey, staticKey) => {
+		const root = options.def().rootField;
+		return root ? resolveFieldProp(root.prop, fnKey, staticKey, ctx.value) : void 0;
+	};
+	const title = computed(() => resolveRootProp(UI_FORM_FN_TITLE, META_LABEL));
+	const description = computed(() => resolveRootProp(UI_FORM_FN_DESCRIPTION, META_DESCRIPTION));
+	const slotProps = computed(() => ({
+		title: title.value,
+		description: description.value,
+		data: data.value,
+		errors: ext.effective.value,
+		formError: ext.formError.value,
+		disabled: submitDisabled.value,
+		loading: options.loading?.() === true,
+		submitText: submitText.value,
+		submit: onSubmit,
+		reset: resetState,
+		clearErrors,
+		setErrors,
+		dismissError: ext.dismissAt,
+		dismissFormError: ext.dismissForm,
+		formContext: formContext.value
+	}));
 	function supportsAction(def, actionId) {
 		return def.fields.some((f) => {
 			if (getFieldMeta(f.prop, UI_FORM_ACTION)?.id === actionId) return true;
@@ -260,6 +283,9 @@ function useAsForm(options) {
 		onSubmit,
 		submitText,
 		submitDisabled,
+		title,
+		description,
+		slotProps,
 		invokeAction,
 		dismissError: ext.dismissAt,
 		dismissFormError: ext.dismissForm,
@@ -369,46 +395,19 @@ var as_form_default = /* @__PURE__ */ defineComponent({
 				inert: __props.loading,
 				onSubmit: _cache[1] || (_cache[1] = withModifiers((...args) => unref(form).onSubmit && unref(form).onSubmit(...args), ["prevent"]))
 			}, [
-				renderSlot(_ctx.$slots, "form.header", {
-					clearErrors: unref(form).clearErrors,
-					reset: unref(form).reset,
-					setErrors: unref(form).setErrors,
-					formContext: __props.formContext,
-					disabled: unref(form).submitDisabled.value
-				}),
-				renderSlot(_ctx.$slots, "form.before", {
-					clearErrors: unref(form).clearErrors,
-					reset: unref(form).reset,
-					setErrors: unref(form).setErrors,
-					formContext: __props.formContext,
-					disabled: unref(form).submitDisabled.value
-				}),
+				renderSlot(_ctx.$slots, "form.header", normalizeProps(guardReactiveProps(unref(form).slotProps.value))),
+				renderSlot(_ctx.$slots, "form.before", normalizeProps(guardReactiveProps(unref(form).slotProps.value))),
 				createVNode(as_field_default, { field: __props.def.rootField }, null, 8, ["field"]),
-				renderSlot(_ctx.$slots, "form.after", {
-					clearErrors: unref(form).clearErrors,
-					reset: unref(form).reset,
-					setErrors: unref(form).setErrors,
-					disabled: unref(form).submitDisabled.value,
-					formContext: __props.formContext
-				}),
-				unref(form).formError.value ? renderSlot(_ctx.$slots, "form.error", {
-					key: 0,
+				renderSlot(_ctx.$slots, "form.after", normalizeProps(guardReactiveProps(unref(form).slotProps.value))),
+				unref(form).formError.value ? renderSlot(_ctx.$slots, "form.error", mergeProps({ key: 0 }, unref(form).slotProps.value, {
 					message: unref(form).formError.value,
 					dismiss: unref(form).dismissFormError
-				}, () => [createElementVNode("div", _hoisted_2, [createElementVNode("span", _hoisted_3, toDisplayString(unref(form).formError.value), 1), createElementVNode("button", {
+				}), () => [createElementVNode("div", _hoisted_2, [createElementVNode("span", _hoisted_3, toDisplayString(unref(form).formError.value), 1), createElementVNode("button", {
 					type: "button",
 					class: "as-form-error-dismiss",
 					onClick: _cache[0] || (_cache[0] = (...args) => unref(form).dismissFormError && unref(form).dismissFormError(...args))
 				}, " Dismiss ")])]) : createCommentVNode("v-if", true),
-				!__props.hideSubmit ? renderSlot(_ctx.$slots, "form.submit", {
-					key: 1,
-					disabled: unref(form).submitDisabled.value,
-					text: unref(form).submitText.value,
-					clearErrors: unref(form).clearErrors,
-					reset: unref(form).reset,
-					setErrors: unref(form).setErrors,
-					formContext: __props.formContext
-				}, () => [createElementVNode("button", {
+				!__props.hideSubmit ? renderSlot(_ctx.$slots, "form.submit", mergeProps({ key: 1 }, unref(form).slotProps.value, { text: unref(form).submitText.value }), () => [createElementVNode("button", {
 					class: "as-submit-btn",
 					disabled: unref(form).submitDisabled.value
 				}, toDisplayString(unref(form).submitText.value), 9, _hoisted_4)]) : createCommentVNode("v-if", true),
@@ -417,14 +416,8 @@ var as_form_default = /* @__PURE__ */ defineComponent({
 					def: __props.def,
 					fields: __props.def.pushDownFields
 				}, null, 8, ["def", "fields"])])) : createCommentVNode("v-if", true),
-				renderSlot(_ctx.$slots, "form.footer", {
-					disabled: unref(form).submitDisabled.value,
-					clearErrors: unref(form).clearErrors,
-					reset: unref(form).reset,
-					setErrors: unref(form).setErrors,
-					formContext: __props.formContext
-				}),
-				__props.loading ? (openBlock(), createElementBlock("div", _hoisted_6, [renderSlot(_ctx.$slots, "form.loading", {}, () => [_cache[2] || (_cache[2] = createElementVNode("span", {
+				renderSlot(_ctx.$slots, "form.footer", normalizeProps(guardReactiveProps(unref(form).slotProps.value))),
+				__props.loading ? (openBlock(), createElementBlock("div", _hoisted_6, [renderSlot(_ctx.$slots, "form.loading", normalizeProps(guardReactiveProps(unref(form).slotProps.value)), () => [_cache[2] || (_cache[2] = createElementVNode("span", {
 					class: "as-form-overlay-icon",
 					"aria-hidden": "true"
 				}, null, -1))])])) : createCommentVNode("v-if", true)

package/dist/as-form.cjs

@@ -1,2 +1,2 @@
-const require_as_form = require("./as-form-BpcP_wIF.cjs");
+const require_as_form = require("./as-form-BRuzVUsN.cjs");
 module.exports = require_as_form.as_form_default;

package/dist/as-form.d.cts

@@ -1,2 +1,2 @@
-import { n as _default, t as Props } from "./as-form.vue-jWfGgDC2.cjs";
+import { n as _default, t as Props } from "./as-form.vue-yGdKLYxn.cjs";
 export { Props, _default as default };

package/dist/as-form.d.mts

@@ -1,2 +1,2 @@
-import { n as _default, t as Props } from "./as-form.vue-DLL244uG.mjs";
+import { n as _default, t as Props } from "./as-form.vue-Dop7SBeF.mjs";
 export { Props, _default as default };

package/dist/as-form.mjs

@@ -1,2 +1,2 @@
-import { t as as_form_default } from "./as-form-Cb5orGFC.mjs";
+import { t as as_form_default } from "./as-form-cszNv3LX.mjs";
 export { as_form_default as default };

package/dist/{as-form.vue-DLL244uG.d.mts → as-form.vue-Dop7SBeF.d.mts}

@@ -77,11 +77,11 @@ interface Props<TF, TC> {
 }
 declare const __VLS_export: <TFormData = any, TFormContext = any>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
   props: vue.PublicProps & __VLS_PrettifyLocal<Props<TFormData, TFormContext> & {
-    onSubmit?: ((data: TFormData) => any) | undefined;
     onError?: ((errors: {
       path: string;
       message: string;
     }[]) => any) | undefined;
+    onSubmit?: ((data: TFormData) => any) | undefined;
     onAction?: ((name: string, data: TFormData) => any) | undefined;
     "onUnsupported-action"?: ((name: string, data: TFormData) => any) | undefined;
     onChange?: ((type: TAsChangeType, path: string, value: unknown, formData: TFormData) => any) | undefined;
@@ -92,52 +92,133 @@ declare const __VLS_export: <TFormData = any, TFormContext = any>(__VLS_props: N
   attrs: any;
   slots: {
     'form.header'?: (props: {
-      clearErrors: () => void;
+      title: string | undefined;
+      description: string | undefined;
+      data: TFormData;
+      errors: Record<string, string | undefined> | undefined;
+      formError: string | undefined;
+      disabled: boolean;
+      loading: boolean;
+      submitText: string;
+      submit: () => void;
       reset: () => Promise<void>;
+      clearErrors: () => void;
       setErrors: (errors: Record<string, string>) => void;
+      dismissError: (path: string) => void;
+      dismissFormError: () => void;
       formContext: TFormContext | undefined;
-      disabled: boolean;
     }) => any;
   } & {
     'form.before'?: (props: {
-      clearErrors: () => void;
+      title: string | undefined;
+      description: string | undefined;
+      data: TFormData;
+      errors: Record<string, string | undefined> | undefined;
+      formError: string | undefined;
+      disabled: boolean;
+      loading: boolean;
+      submitText: string;
+      submit: () => void;
       reset: () => Promise<void>;
+      clearErrors: () => void;
       setErrors: (errors: Record<string, string>) => void;
+      dismissError: (path: string) => void;
+      dismissFormError: () => void;
       formContext: TFormContext | undefined;
-      disabled: boolean;
     }) => any;
   } & {
     'form.after'?: (props: {
-      clearErrors: () => void;
+      title: string | undefined;
+      description: string | undefined;
+      data: TFormData;
+      errors: Record<string, string | undefined> | undefined;
+      formError: string | undefined;
+      disabled: boolean;
+      loading: boolean;
+      submitText: string;
+      submit: () => void;
       reset: () => Promise<void>;
+      clearErrors: () => void;
       setErrors: (errors: Record<string, string>) => void;
-      disabled: boolean;
+      dismissError: (path: string) => void;
+      dismissFormError: () => void;
       formContext: TFormContext | undefined;
     }) => any;
   } & {
     'form.error'?: (props: {
       message: string;
       dismiss: () => void;
+      title: string | undefined;
+      description: string | undefined;
+      data: TFormData;
+      errors: Record<string, string | undefined> | undefined;
+      formError: string | undefined;
+      disabled: boolean;
+      loading: boolean;
+      submitText: string;
+      submit: () => void;
+      reset: () => Promise<void>;
+      clearErrors: () => void;
+      setErrors: (errors: Record<string, string>) => void;
+      dismissError: (path: string) => void;
+      dismissFormError: () => void;
+      formContext: TFormContext | undefined;
     }) => any;
   } & {
     'form.submit'?: (props: {
-      disabled: boolean;
       text: string;
-      clearErrors: () => void;
+      title: string | undefined;
+      description: string | undefined;
+      data: TFormData;
+      errors: Record<string, string | undefined> | undefined;
+      formError: string | undefined;
+      disabled: boolean;
+      loading: boolean;
+      submitText: string;
+      submit: () => void;
       reset: () => Promise<void>;
+      clearErrors: () => void;
       setErrors: (errors: Record<string, string>) => void;
+      dismissError: (path: string) => void;
+      dismissFormError: () => void;
       formContext: TFormContext | undefined;
     }) => any;
   } & {
     'form.footer'?: (props: {
+      title: string | undefined;
+      description: string | undefined;
+      data: TFormData;
+      errors: Record<string, string | undefined> | undefined;
+      formError: string | undefined;
       disabled: boolean;
-      clearErrors: () => void;
+      loading: boolean;
+      submitText: string;
+      submit: () => void;
       reset: () => Promise<void>;
+      clearErrors: () => void;
       setErrors: (errors: Record<string, string>) => void;
+      dismissError: (path: string) => void;
+      dismissFormError: () => void;
       formContext: TFormContext | undefined;
     }) => any;
   } & {
-    'form.loading'?: (props: {}) => any;
+    'form.loading'?: (props: {
+      title: string | undefined;
+      description: string | undefined;
+      data: TFormData;
+      errors: Record<string, string | undefined> | undefined;
+      formError: string | undefined;
+      disabled: boolean;
+      loading: boolean;
+      submitText: string;
+      submit: () => void;
+      reset: () => Promise<void>;
+      clearErrors: () => void;
+      setErrors: (errors: Record<string, string>) => void;
+      dismissError: (path: string) => void;
+      dismissFormError: () => void;
+      formContext: TFormContext | undefined;
+    }) => any;
   };
   emit: {
     (e: "submit", data: TFormData): void;

package/dist/{as-form.vue-jWfGgDC2.d.cts → as-form.vue-yGdKLYxn.d.cts}

@@ -77,11 +77,11 @@ interface Props<TF, TC> {
 }
 declare const __VLS_export: <TFormData = any, TFormContext = any>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
   props: vue.PublicProps & __VLS_PrettifyLocal<Props<TFormData, TFormContext> & {
-    onSubmit?: ((data: TFormData) => any) | undefined;
     onError?: ((errors: {
       path: string;
       message: string;
     }[]) => any) | undefined;
+    onSubmit?: ((data: TFormData) => any) | undefined;
     onAction?: ((name: string, data: TFormData) => any) | undefined;
     "onUnsupported-action"?: ((name: string, data: TFormData) => any) | undefined;
     onChange?: ((type: TAsChangeType, path: string, value: unknown, formData: TFormData) => any) | undefined;
@@ -92,52 +92,133 @@ declare const __VLS_export: <TFormData = any, TFormContext = any>(__VLS_props: N
   attrs: any;
   slots: {
     'form.header'?: (props: {
-      clearErrors: () => void;
+      title: string | undefined;
+      description: string | undefined;
+      data: TFormData;
+      errors: Record<string, string | undefined> | undefined;
+      formError: string | undefined;
+      disabled: boolean;
+      loading: boolean;
+      submitText: string;
+      submit: () => void;
       reset: () => Promise<void>;
+      clearErrors: () => void;
       setErrors: (errors: Record<string, string>) => void;
+      dismissError: (path: string) => void;
+      dismissFormError: () => void;
       formContext: TFormContext | undefined;
-      disabled: boolean;
     }) => any;
   } & {
     'form.before'?: (props: {
-      clearErrors: () => void;
+      title: string | undefined;
+      description: string | undefined;
+      data: TFormData;
+      errors: Record<string, string | undefined> | undefined;
+      formError: string | undefined;
+      disabled: boolean;
+      loading: boolean;
+      submitText: string;
+      submit: () => void;
       reset: () => Promise<void>;
+      clearErrors: () => void;
       setErrors: (errors: Record<string, string>) => void;
+      dismissError: (path: string) => void;
+      dismissFormError: () => void;
       formContext: TFormContext | undefined;
-      disabled: boolean;
     }) => any;
   } & {
     'form.after'?: (props: {
-      clearErrors: () => void;
+      title: string | undefined;
+      description: string | undefined;
+      data: TFormData;
+      errors: Record<string, string | undefined> | undefined;
+      formError: string | undefined;
+      disabled: boolean;
+      loading: boolean;
+      submitText: string;
+      submit: () => void;
       reset: () => Promise<void>;
+      clearErrors: () => void;
       setErrors: (errors: Record<string, string>) => void;
-      disabled: boolean;
+      dismissError: (path: string) => void;
+      dismissFormError: () => void;
       formContext: TFormContext | undefined;
     }) => any;
   } & {
     'form.error'?: (props: {
       message: string;
       dismiss: () => void;
+      title: string | undefined;
+      description: string | undefined;
+      data: TFormData;
+      errors: Record<string, string | undefined> | undefined;
+      formError: string | undefined;
+      disabled: boolean;
+      loading: boolean;
+      submitText: string;
+      submit: () => void;
+      reset: () => Promise<void>;
+      clearErrors: () => void;
+      setErrors: (errors: Record<string, string>) => void;
+      dismissError: (path: string) => void;
+      dismissFormError: () => void;
+      formContext: TFormContext | undefined;
     }) => any;
   } & {
     'form.submit'?: (props: {
-      disabled: boolean;
       text: string;
-      clearErrors: () => void;
+      title: string | undefined;
+      description: string | undefined;
+      data: TFormData;
+      errors: Record<string, string | undefined> | undefined;
+      formError: string | undefined;
+      disabled: boolean;
+      loading: boolean;
+      submitText: string;
+      submit: () => void;
       reset: () => Promise<void>;
+      clearErrors: () => void;
       setErrors: (errors: Record<string, string>) => void;
+      dismissError: (path: string) => void;
+      dismissFormError: () => void;
       formContext: TFormContext | undefined;
     }) => any;
   } & {
     'form.footer'?: (props: {
+      title: string | undefined;
+      description: string | undefined;
+      data: TFormData;
+      errors: Record<string, string | undefined> | undefined;
+      formError: string | undefined;
       disabled: boolean;
-      clearErrors: () => void;
+      loading: boolean;
+      submitText: string;
+      submit: () => void;
       reset: () => Promise<void>;
+      clearErrors: () => void;
       setErrors: (errors: Record<string, string>) => void;
+      dismissError: (path: string) => void;
+      dismissFormError: () => void;
       formContext: TFormContext | undefined;
     }) => any;
   } & {
-    'form.loading'?: (props: {}) => any;
+    'form.loading'?: (props: {
+      title: string | undefined;
+      description: string | undefined;
+      data: TFormData;
+      errors: Record<string, string | undefined> | undefined;
+      formError: string | undefined;
+      disabled: boolean;
+      loading: boolean;
+      submitText: string;
+      submit: () => void;
+      reset: () => Promise<void>;
+      clearErrors: () => void;
+      setErrors: (errors: Record<string, string>) => void;
+      dismissError: (path: string) => void;
+      dismissFormError: () => void;
+      formContext: TFormContext | undefined;
+    }) => any;
   };
   emit: {
     (e: "submit", data: TFormData): void;

package/dist/index.cjs

@@ -2,7 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_use_form_context = require("./use-form-context-Dwr8Ai1v.cjs");
 const require_use_as_nested_sections_store = require("./use-as-nested-sections-store-jdMRxjBE.cjs");
 const require_use_as_value_help = require("./use-as-value-help-uANI3zWa.cjs");
-const require_as_form = require("./as-form-BpcP_wIF.cjs");
+const require_as_form = require("./as-form-BRuzVUsN.cjs");
 const require_as_field = require("./as-field--sdVpUAw.cjs");
 const require_use_as_locale = require("./use-as-locale-C4z5stwD.cjs");
 const require_as_iterator = require("./as-iterator-WKkr9lwG.cjs");

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { a as TAsComponentEmits, c as TAsUnionContext, i as TAsCollapsibleSlots, n as TAsChangeType, o as TAsComponentProps, r as TAsCollapsibleProps, s as TAsTypeComponents, t as TAsBaseComponentProps } from "./types-BYfe1QEF.cjs";
 import _default$3 from "./as-collapsible.cjs";
 import _default$7 from "./as-field.cjs";
-import { a as TFormRule, i as TFormFieldRegistration, n as _default$9, o as TFormState, r as TFormFieldCallbacks } from "./as-form.vue-jWfGgDC2.cjs";
+import { a as TFormRule, i as TFormFieldRegistration, n as _default$9, o as TFormState, r as TFormFieldCallbacks } from "./as-form.vue-yGdKLYxn.cjs";
 import _default$11 from "./as-iterator.cjs";
 import { t as _default } from "./as-action.vue-BCbopk0S.cjs";
 import { t as _default$1 } from "./as-array.vue-Ci4xO292.cjs";
@@ -24,7 +24,7 @@ import * as vue from "vue";
 import { Component, ComputedRef, MaybeRef, Ref, ShallowRef, WritableComputedRef } from "vue";
 import * as _atscript_ui0 from "@atscript/ui";
 import { ClientFactory, ClientFactory as ClientFactory$1, FormArrayFieldDef, FormDef, FormFieldDef, FormTupleFieldDef, FormUnionFieldDef, FormUnionVariant, ResolvedValueHelp, ValueHelpInfo, getDefaultClientFactory, resetDefaultClientFactory, setDefaultClientFactory } from "@atscript/ui";
-//#region ../../node_modules/.pnpm/@atscript+typescript@0.1.69_@atscript+core@0.1.69_@emnapi+core@1.10.0_@emnapi+runtime@1_e3fb5ecc477d4e72e98cc920fbc7e884/node_modules/@atscript/typescript/dist/utils.d.ts
+//#region ../../node_modules/.pnpm/@atscript+typescript@0.1.70_@atscript+core@0.1.70_@emnapi+core@1.10.0_@emnapi+runtime@1_b6a579a982251a44a51d12461f43e362/node_modules/@atscript/typescript/dist/utils.d.ts
 interface TError {
   path: string;
   message: string;
@@ -373,6 +373,28 @@ interface UseAsFormReturn<TFormData = unknown, TFormContext = unknown> {
   submitText: ComputedRef<string>;
   /** Resolved submit-button disabled state (`@ui.form.fn.submitDisabled`). */
   submitDisabled: ComputedRef<boolean>;
+  /** Resolved form-level title (`@ui.form.fn.title` / `@meta.label`); may be `undefined`. */
+  title: ComputedRef<string | undefined>;
+  /** Resolved form-level description (`@ui.form.fn.description` / `@meta.description`). */
+  description: ComputedRef<string | undefined>;
+  /** Unified slot-props bag spread onto every `<AsForm>` slot. */
+  slotProps: ComputedRef<{
+    title: string | undefined;
+    description: string | undefined;
+    data: TFormData;
+    errors: Record<string, string | undefined> | undefined;
+    formError: string | undefined;
+    disabled: boolean;
+    loading: boolean;
+    submitText: string;
+    submit: () => void;
+    reset: () => Promise<void>;
+    clearErrors: () => void;
+    setErrors: (errors: Record<string, string>) => void;
+    dismissError: (path: string) => void;
+    dismissFormError: () => void;
+    formContext: TFormContext | undefined;
+  }>;
   /** Dispatch an action — invoked by `<AsAction>`. */
   invokeAction: (name: string) => void;
   /** Dismiss a single external leaf error. */

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { a as TAsComponentEmits, c as TAsUnionContext, i as TAsCollapsibleSlots, n as TAsChangeType, o as TAsComponentProps, r as TAsCollapsibleProps, s as TAsTypeComponents, t as TAsBaseComponentProps } from "./types-CV9ss4UN.mjs";
 import _default$3 from "./as-collapsible.mjs";
 import _default$7 from "./as-field.mjs";
-import { a as TFormRule, i as TFormFieldRegistration, n as _default$9, o as TFormState, r as TFormFieldCallbacks } from "./as-form.vue-DLL244uG.mjs";
+import { a as TFormRule, i as TFormFieldRegistration, n as _default$9, o as TFormState, r as TFormFieldCallbacks } from "./as-form.vue-Dop7SBeF.mjs";
 import _default$11 from "./as-iterator.mjs";
 import { t as _default } from "./as-action.vue-BtQX09n-.mjs";
 import { t as _default$1 } from "./as-array.vue-I42wuF6e.mjs";
@@ -24,7 +24,7 @@ import * as vue from "vue";
 import { Component, ComputedRef, MaybeRef, Ref, ShallowRef, WritableComputedRef } from "vue";
 import * as _atscript_ui0 from "@atscript/ui";
 import { ClientFactory, ClientFactory as ClientFactory$1, FormArrayFieldDef, FormDef, FormFieldDef, FormTupleFieldDef, FormUnionFieldDef, FormUnionVariant, ResolvedValueHelp, ValueHelpInfo, getDefaultClientFactory, resetDefaultClientFactory, setDefaultClientFactory } from "@atscript/ui";
-//#region ../../node_modules/.pnpm/@atscript+typescript@0.1.69_@atscript+core@0.1.69_@emnapi+core@1.10.0_@emnapi+runtime@1_e3fb5ecc477d4e72e98cc920fbc7e884/node_modules/@atscript/typescript/dist/utils.d.ts
+//#region ../../node_modules/.pnpm/@atscript+typescript@0.1.70_@atscript+core@0.1.70_@emnapi+core@1.10.0_@emnapi+runtime@1_b6a579a982251a44a51d12461f43e362/node_modules/@atscript/typescript/dist/utils.d.ts
 interface TError {
   path: string;
   message: string;
@@ -373,6 +373,28 @@ interface UseAsFormReturn<TFormData = unknown, TFormContext = unknown> {
   submitText: ComputedRef<string>;
   /** Resolved submit-button disabled state (`@ui.form.fn.submitDisabled`). */
   submitDisabled: ComputedRef<boolean>;
+  /** Resolved form-level title (`@ui.form.fn.title` / `@meta.label`); may be `undefined`. */
+  title: ComputedRef<string | undefined>;
+  /** Resolved form-level description (`@ui.form.fn.description` / `@meta.description`). */
+  description: ComputedRef<string | undefined>;
+  /** Unified slot-props bag spread onto every `<AsForm>` slot. */
+  slotProps: ComputedRef<{
+    title: string | undefined;
+    description: string | undefined;
+    data: TFormData;
+    errors: Record<string, string | undefined> | undefined;
+    formError: string | undefined;
+    disabled: boolean;
+    loading: boolean;
+    submitText: string;
+    submit: () => void;
+    reset: () => Promise<void>;
+    clearErrors: () => void;
+    setErrors: (errors: Record<string, string>) => void;
+    dismissError: (path: string) => void;
+    dismissFormError: () => void;
+    formContext: TFormContext | undefined;
+  }>;
   /** Dispatch an action — invoked by `<AsAction>`. */
   invokeAction: (name: string) => void;
   /** Dismiss a single external leaf error. */

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import { m as PATH_PREFIX_KEY, n as useAsUnionVariant, s as DISMISS_EXTERNAL_AT_KEY, t as formatIndexedLabelParts } from "./use-form-context-bAj7UoSe.mjs";
 import { n as provideAsNestedSectionsStore, r as useAsNestedSectionsStore } from "./use-as-nested-sections-store-lhi0z5z1.mjs";
 import { n as useAsValueHelp } from "./use-as-value-help-CBykDEjZ.mjs";
-import { i as useAsExternalErrors, n as useAsForm, r as useAsState, t as as_form_default } from "./as-form-Cb5orGFC.mjs";
+import { i as useAsExternalErrors, n as useAsForm, r as useAsState, t as as_form_default } from "./as-form-cszNv3LX.mjs";
 import { n as useAsData, r as useAsField, t as as_field_default } from "./as-field-CryuaPPU.mjs";
 import { n as useAsLocale, t as provideAsLocale } from "./use-as-locale-BrFdAgnU.mjs";
 import { t as as_iterator_default } from "./as-iterator-B0Jf2zn4.mjs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/vue-form",
-  "version": "0.1.88",
+  "version": "0.1.90",
   "description": "Type-driven form rendering for Atscript with Vue 3",
   "keywords": [
     "atscript",
@@ -157,29 +157,29 @@
     "access": "public"
   },
   "dependencies": {
-    "@atscript/ui": "^0.1.88"
+    "@atscript/ui": "^0.1.90"
   },
   "devDependencies": {
-    "@atscript/core": "^0.1.69",
-    "@atscript/db-client": "^0.1.96",
-    "@atscript/typescript": "^0.1.69",
+    "@atscript/core": "^0.1.70",
+    "@atscript/db-client": "^0.1.97",
+    "@atscript/typescript": "^0.1.70",
     "@tsdown/css": "^0.21.4",
     "@vitejs/plugin-vue": "^6",
     "@vue/test-utils": "^2",
     "happy-dom": "^18",
     "reka-ui": "^2.9.8",
-    "unplugin-atscript": "^0.1.69",
+    "unplugin-atscript": "^0.1.70",
     "vitest": "npm:@voidzero-dev/vite-plus-test@0.1.14",
     "vue": "^3",
     "vue-tsc": "~3.2.9",
     "vunor": "^0.2.1",
-    "@atscript/ui-fns": "^0.1.88"
+    "@atscript/ui-fns": "^0.1.90"
   },
   "peerDependencies": {
-    "@atscript/db-client": "^0.1.96",
+    "@atscript/db-client": "^0.1.97",
     "reka-ui": "^2.9.8",
     "vue": "^3",
-    "@atscript/ui-fns": "^0.1.88"
+    "@atscript/ui-fns": "^0.1.90"
   },
   "scripts": {
     "build": "node ../../scripts/gen-exports.mjs && vp pack",