@atscript/vue-form 0.1.102 → 0.1.103

package/dist/{as-form-8YNdb-49.mjs → as-form-OsyP7m-A.mjs}

@@ -1,10 +1,158 @@
-import { a as CHANGE_HANDLER_KEY, c as ERRORS_KEY, d as FORM_STATE_KEY, f as HIDE_ROOT_TITLE_KEY, g as TYPES_KEY, h as ROOT_DATA_KEY, i as ACTION_HANDLER_KEY, l as FORM_CONTEXT_KEY, m as PATH_PREFIX_KEY, o as COMPONENTS_KEY, s as DISMISS_EXTERNAL_AT_KEY, u as FORM_DATA_KEY } from "./use-form-context-bAj7UoSe.mjs";
-import { n as provideAsNestedSectionsStore, r as useAsNestedSectionsStore, t as DESCENDANT_ERROR_COUNTS_KEY } from "./use-as-nested-sections-store-lhi0z5z1.mjs";
-import { t as CLIENT_FACTORY_KEY } from "./use-as-value-help-CBykDEjZ.mjs";
-import { t as as_field_default } from "./as-field-CDB-HIfz.mjs";
-import { t as as_iterator_default } from "./as-iterator---gxkT-L.mjs";
-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_FN_DESCRIPTION, UI_FORM_FN_SUBMIT_DISABLED, UI_FORM_FN_SUBMIT_TEXT, UI_FORM_FN_TITLE, UI_FORM_SUBMIT_TEXT, buildDescendantErrorCounts, getDeclaredFormActions, getFormValidator, iteratePathAncestors, mergeErrorMaps, resolveFormProp } from "@atscript/ui";
+import { _ as TYPES_KEY, a as CHANGE_HANDLER_KEY, c as ERRORS_KEY, d as FORM_PATCH_KEY, f as FORM_STATE_KEY, g as ROOT_DATA_KEY, h as PATH_PREFIX_KEY, i as ACTION_HANDLER_KEY, l as FORM_CONTEXT_KEY, o as COMPONENTS_KEY, p as HIDE_ROOT_TITLE_KEY, s as DISMISS_EXTERNAL_AT_KEY, u as FORM_DATA_KEY } from "./use-form-context-D6J1WTyG.mjs";
+import { n as provideAsNestedSectionsStore, r as useAsNestedSectionsStore, t as DESCENDANT_ERROR_COUNTS_KEY } from "./use-as-nested-sections-store-DVRmG7V0.mjs";
+import { t as CLIENT_FACTORY_KEY } from "./use-as-value-help-DrISSxCz.mjs";
+import { t as as_field_default } from "./as-field-DLW-csEu.mjs";
+import { t as as_iterator_default } from "./as-iterator-DW7giLlz.mjs";
+import { computed, createCommentVNode, createElementBlock, createElementVNode, createVNode, defineComponent, guardReactiveProps, inject, mergeProps, nextTick, normalizeProps, openBlock, provide, reactive, ref, renderSlot, toDisplayString, toRaw, toValue, unref, watch, watchEffect, withModifiers } from "vue";
+import { META_DESCRIPTION, META_LABEL, UI_FORM_FN_DESCRIPTION, UI_FORM_FN_SUBMIT_DISABLED, UI_FORM_FN_SUBMIT_TEXT, UI_FORM_FN_TITLE, UI_FORM_SUBMIT_TEXT, buildDescendantErrorCounts, buildFormDiff, getDeclaredFormActions, getFormValidator, iteratePathAncestors, mergeErrorMaps, resolveFormProp } from "@atscript/ui";
+//#region src/composables/use-as-form-patch.ts
+/**
+* Internal factory invoked by `useAsForm` when `trackChanges` is enabled. Owns
+* the deep-clone baseline lifecycle:
+*
+* - captures a DEEP CLONE of the wrapped form-data the moment tracking becomes
+*   active (and, if data is not yet available, when it first arrives),
+* - re-baselines on `reset()` (the form's own reset path calls `rebase()`),
+* - exposes `rebase()` so a consumer can re-baseline after a successful save.
+*
+* The clone is mandatory: `buildFormDiff` keeps LIVE references into the
+* supplied baseline, so a shared reference would be mutated by subsequent
+* edits and the diff would always come back empty.
+*
+* Reactivity: a single revert-aware `diff` computed drives `isDirty` /
+* `changes`. `buildFormDiff` reads most reactive leaves of the live container
+* (via `getByPath` + the `deepEqual` walk), so the computed auto-tracks scalar
+* edits, nested-object edits, and `$update` edits to EXISTING keyed-array items.
+* But the `$insert` branch pushes a freshly-added (not-yet-saved) keyed-array
+* element BY REFERENCE without reading its leaves, so editing such a row's
+* non-key leaves (qty/description) would NOT invalidate the computed. To close
+* that blind spot we add a single deep `watch` on the live data — created ONLY
+* when tracking is active, owned by the component scope (it disposes on unmount)
+* — that bumps `dataRev`; the `diff` computed reads `dataRev` so every leaf
+* mutation, including an inserted row's, re-evaluates it. OFF stays zero-cost:
+* `createAsFormPatch` is never called when tracking is disabled, so neither the
+* baseline nor this watcher is ever created. It recomputes only when the live
+* data (`dataRev`) or the baseline (`baselineRev`) changes, and Vue caches the
+* result between reads.
+*
+* @param def      getter for the form's `FormDef`
+* @param getData  getter for the WRAPPED form-data container `{ value }`. Before
+*                 real domain data arrives `useAsForm` yields the empty internal
+*                 fallback `{}` (no `value` key); the tracker treats that as
+*                 "no data yet" and defers the baseline until a `{ value: … }`
+*                 container appears (the fetch-then-fill flow).
+*/
+function createAsFormPatch(def, getData) {
+	let baseline;
+	const baselineRev = ref(0);
+	const dataRev = ref(0);
+	/**
+	* Deep-clones the current wrapped container, or returns `undefined` when no
+	* real domain data exists yet. "No data yet" = the container has no `value`
+	* key or its `value` is `undefined` (the `{}` internal fallback, or a
+	* `:form-data` ref that has not resolved). Capturing the empty fallback as the
+	* baseline would make every field read as dirty once real data replaces it,
+	* so we wait for a genuine `{ value: … }` container.
+	*/
+	function snapshot() {
+		const cur = getData();
+		if (cur.value === void 0) return void 0;
+		return deepClone(toRaw(cur));
+	}
+	function capture() {
+		baseline = snapshot();
+		baselineRev.value++;
+	}
+	capture();
+	if (baseline === void 0) {
+		const stop = watch(() => getData().value, () => {
+			if (baseline !== void 0) return;
+			capture();
+			if (baseline !== void 0) stop();
+		});
+	}
+	watch(() => getData(), () => dataRev.value++, { deep: true });
+	const diff = computed(() => {
+		dataRev.value;
+		baselineRev.value;
+		if (baseline === void 0) return {
+			isDirty: false,
+			changes: []
+		};
+		const result = buildFormDiff(def(), baseline, getData());
+		return {
+			isDirty: result.isDirty,
+			changes: result.changes
+		};
+	});
+	const isDirty = computed(() => diff.value.isDirty);
+	const changes = computed(() => diff.value.changes);
+	function getPatch(opts) {
+		if (baseline === void 0) return {};
+		const frozen = deepClone(toRaw(getData()));
+		return buildFormDiff(def(), baseline, frozen, opts).patch;
+	}
+	function getChanges() {
+		if (baseline === void 0) return [];
+		const frozen = deepClone(toRaw(getData()));
+		return buildFormDiff(def(), baseline, frozen).changes;
+	}
+	function rebase() {
+		capture();
+	}
+	return {
+		isDirty,
+		changes,
+		getPatch,
+		getChanges,
+		rebase
+	};
+}
+/**
+* Structural deep clone of plain JSON-ish data (objects / arrays / primitives /
+* Date). Used to freeze the baseline so later edits to the live form data don't
+* mutate it. `structuredClone` would throw on Vue proxies / functions; this
+* walks own-enumerable keys and copies leaves by value.
+*/
+function deepClone(value) {
+	if (value === null || typeof value !== "object") return value;
+	if (value instanceof Date) return new Date(value.getTime());
+	if (Array.isArray(value)) {
+		const out = [];
+		for (let i = 0; i < value.length; i++) out.push(deepClone(toRaw(value[i])));
+		return out;
+	}
+	const src = value;
+	const out = {};
+	for (const k of Object.keys(src)) out[k] = deepClone(toRaw(src[k]));
+	return out;
+}
+const NOT_TRACKING_MSG = "useAsFormPatch(): change tracking is not enabled on this form. Pass `track-changes` to <AsForm> (or `trackChanges: true` to useAsForm).";
+/**
+* Reactive read-only access to the form's change-tracking handle from any
+* descendant of an `<AsForm track-changes>`. Mirrors the `useAsData` /
+* `useAsPath` injector pattern.
+*
+* THROWS when called outside a form, or inside a form that did not enable
+* `track-changes` — fail loud rather than silently report "not dirty".
+*
+* @example
+* ```vue
+* <script setup lang="ts">
+* import { useAsFormPatch } from "@atscript/vue-form";
+* const { isDirty, getPatch } = useAsFormPatch();
+* <\/script>
+* <template>
+*   <button :disabled="!isDirty" @click="save(getPatch())">Save</button>
+* </template>
+* ```
+*/
+function useAsFormPatch() {
+	const handle = inject(FORM_PATCH_KEY, void 0);
+	if (!handle) throw new Error(NOT_TRACKING_MSG);
+	return handle;
+}
+//#endregion
 //#region src/composables/use-as-external-errors.ts
 /**
 * Local dismissal state for externally-supplied errors.
@@ -144,6 +292,9 @@ function useAsState(opts) {
 }
 //#endregion
 //#region src/composables/use-as-form.ts
+const EMPTY_CHANGES = Object.freeze([]);
+const EMPTY_GET_PATCH = () => ({});
+const EMPTY_GET_CHANGES = () => [];
 /**
 * Composable backing `<AsForm>`. Owns the entire form state machine —
 * data container, internal validator, external-error dismissal, action
@@ -179,6 +330,12 @@ function useAsForm(options) {
 			context: formContext.value ?? {}
 		})
 	});
+	const patch = options.trackChanges?.() ? createAsFormPatch(() => options.def(), () => data.value) : void 0;
+	if (patch) provide(FORM_PATCH_KEY, patch);
+	const reset = patch ? async () => {
+		await resetState();
+		patch.rebase();
+	} : resetState;
 	provide(ROOT_DATA_KEY, data);
 	provide(PATH_PREFIX_KEY, computed(() => ""));
 	provide(TYPES_KEY, computed(() => options.types()));
@@ -220,12 +377,16 @@ function useAsForm(options) {
 		loading: options.loading?.() === true,
 		submitText: submitText.value,
 		submit: onSubmit,
-		reset: resetState,
+		reset,
 		clearErrors,
 		setErrors,
 		dismissError: ext.dismissAt,
 		dismissFormError: ext.dismissForm,
-		formContext: formContext.value
+		formContext: formContext.value,
+		isDirty: patch?.isDirty.value ?? false,
+		changes: patch ? patch.changes.value : EMPTY_CHANGES,
+		getPatch: patch ? patch.getPatch : EMPTY_GET_PATCH,
+		getChanges: patch ? patch.getChanges : EMPTY_GET_CHANGES
 	}));
 	function supportsAction(def, actionId) {
 		return getDeclaredFormActions(def).some((a) => a.id === actionId);
@@ -271,7 +432,7 @@ function useAsForm(options) {
 		errors: ext.effective,
 		formError: ext.formError,
 		internalErrors,
-		reset: resetState,
+		reset,
 		clearErrors,
 		setErrors,
 		onSubmit,
@@ -284,7 +445,8 @@ function useAsForm(options) {
 		dismissError: ext.dismissAt,
 		dismissFormError: ext.dismissForm,
 		formContext,
-		handleChange
+		handleChange,
+		patch
 	};
 }
 //#endregion
@@ -352,6 +514,10 @@ var as_form_default = /* @__PURE__ */ defineComponent({
 		loading: {
 			type: Boolean,
 			required: false
+		},
+		trackChanges: {
+			type: Boolean,
+			required: false
 		}
 	},
 	emits: [
@@ -361,7 +527,7 @@ var as_form_default = /* @__PURE__ */ defineComponent({
 		"unsupported-action",
 		"change"
 	],
-	setup(__props, { emit: __emit }) {
+	setup(__props, { expose: __expose, emit: __emit }) {
 		const props = __props;
 		const emit = __emit;
 		const form = useAsForm({
@@ -375,6 +541,7 @@ var as_form_default = /* @__PURE__ */ defineComponent({
 			clientFactory: () => props.clientFactory,
 			hideRootTitle: () => props.hideRootTitle,
 			loading: () => props.loading,
+			trackChanges: () => props.trackChanges,
 			emits: {
 				submit: (data) => emit("submit", data),
 				error: (errors) => emit("error", errors),
@@ -383,6 +550,19 @@ var as_form_default = /* @__PURE__ */ defineComponent({
 				change: (type, path, value, formData) => emit("change", type, path, value, formData)
 			}
 		});
+		__expose({
+			submit: form.onSubmit,
+			reset: form.reset,
+			get isDirty() {
+				return form.patch?.isDirty.value ?? false;
+			},
+			get changes() {
+				return form.patch?.changes.value ?? [];
+			},
+			getPatch: form.patch ? form.patch.getPatch : () => ({}),
+			getChanges: form.patch ? form.patch.getChanges : () => [],
+			rebase: form.patch ? form.patch.rebase : () => {}
+		});
 		return (_ctx, _cache) => {
 			return openBlock(), createElementBlock("form", {
 				class: "as-form",
@@ -420,4 +600,4 @@ var as_form_default = /* @__PURE__ */ defineComponent({
 	}
 });
 //#endregion
-export { useAsExternalErrors as i, useAsForm as n, useAsState as r, as_form_default as t };
+export { useAsFormPatch as a, useAsExternalErrors as i, useAsForm as n, useAsState as r, as_form_default as t };

package/dist/as-form.cjs

@@ -1,2 +1,2 @@
-const require_as_form = require("./as-form-DaAnsFVF.cjs");
+const require_as_form = require("./as-form-CrMA0HdQ.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-5FyX_1CQ.cjs";
+import { n as _default, t as Props } from "./as-form.vue-Dg_5GYWG.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-ZykHT4gZ.mjs";
+import { n as _default, t as Props } from "./as-form.vue-2NZSk1F9.mjs";
 export { Props, _default as default };

package/dist/as-form.mjs

@@ -1,2 +1,2 @@
-import { t as as_form_default } from "./as-form-8YNdb-49.mjs";
+import { t as as_form_default } from "./as-form-OsyP7m-A.mjs";
 export { as_form_default as default };

package/dist/{as-form.vue-ZykHT4gZ.d.mts → as-form.vue-2NZSk1F9.d.mts}

@@ -1,6 +1,7 @@
 import { n as TAsChangeType, o as TAsComponentProps, s as TAsTypeComponents } from "./types-CV9ss4UN.mjs";
 import * as vue from "vue";
 import { Component } from "vue";
+import * as _atscript_ui0 from "@atscript/ui";
 import { ClientFactory, FormDef } from "@atscript/ui";
 
 //#region src/composables/types.d.ts
@@ -74,21 +75,38 @@ interface Props<TF, TC> {
    * `inner-loading`.
    */
   loading?: boolean;
+  /**
+   * Enable change tracking. When set, the form captures a deep-clone baseline
+   * of its data and surfaces both a changed-fields list and an `@atscript/db`
+   * patch object. The tracking surface (`isDirty` / `changes` / `getPatch` /
+   * `getChanges`) is spread into every slot AND exposed on the component
+   * instance (template ref → `asForm.value.getPatch()`); descendants read it
+   * with `useAsFormPatch()`. Off by default — zero overhead when unset.
+   */
+  trackChanges?: boolean;
 }
 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;
     onAction?: ((name: string, data: TFormData) => any) | undefined;
+    onSubmit?: ((data: TFormData) => any) | undefined;
     "onUnsupported-action"?: ((name: string, data: TFormData) => any) | undefined;
     onChange?: ((type: TAsChangeType, path: string, value: unknown, formData: TFormData) => any) | undefined;
   }> & (typeof globalThis extends {
     __VLS_PROPS_FALLBACK: infer P;
   } ? P : {});
-  expose: (exposed: {}) => void;
+  expose: (exposed: vue.ShallowUnwrapRef<{
+    submit: () => void;
+    reset: () => Promise<void>; /** True when `track-changes` is on AND data differs from baseline. */
+    readonly isDirty: boolean; /** Revert-aware per-field change list (empty when tracking is off). */
+    readonly changes: _atscript_ui0.FormFieldChange[]; /** Build the `@atscript/db` patch object on demand (`{}` when off). */
+    getPatch: ((opts?: _atscript_ui0.FormDiffOptions) => Record<string, unknown>) | (() => {}); /** Build the per-field change list on demand (`[]` when off). */
+    getChanges: () => _atscript_ui0.FormFieldChange[]; /** Re-baseline to current data after a successful save (no-op when off). */
+    rebase: () => void;
+  }>) => void;
   attrs: any;
   slots: {
     'form.header'?: (props: {
@@ -107,6 +125,10 @@ declare const __VLS_export: <TFormData = any, TFormContext = any>(__VLS_props: N
       dismissError: (path: string) => void;
       dismissFormError: () => void;
       formContext: TFormContext | undefined;
+      isDirty: boolean;
+      changes: readonly _atscript_ui0.FormFieldChange[];
+      getPatch: (opts?: _atscript_ui0.FormDiffOptions) => Record<string, unknown>;
+      getChanges: () => _atscript_ui0.FormFieldChange[];
     }) => any;
   } & {
     'form.before'?: (props: {
@@ -125,6 +147,10 @@ declare const __VLS_export: <TFormData = any, TFormContext = any>(__VLS_props: N
       dismissError: (path: string) => void;
       dismissFormError: () => void;
       formContext: TFormContext | undefined;
+      isDirty: boolean;
+      changes: readonly _atscript_ui0.FormFieldChange[];
+      getPatch: (opts?: _atscript_ui0.FormDiffOptions) => Record<string, unknown>;
+      getChanges: () => _atscript_ui0.FormFieldChange[];
     }) => any;
   } & {
     'form.after'?: (props: {
@@ -143,6 +169,10 @@ declare const __VLS_export: <TFormData = any, TFormContext = any>(__VLS_props: N
       dismissError: (path: string) => void;
       dismissFormError: () => void;
       formContext: TFormContext | undefined;
+      isDirty: boolean;
+      changes: readonly _atscript_ui0.FormFieldChange[];
+      getPatch: (opts?: _atscript_ui0.FormDiffOptions) => Record<string, unknown>;
+      getChanges: () => _atscript_ui0.FormFieldChange[];
     }) => any;
   } & {
     'form.error'?: (props: {
@@ -163,6 +193,10 @@ declare const __VLS_export: <TFormData = any, TFormContext = any>(__VLS_props: N
       dismissError: (path: string) => void;
       dismissFormError: () => void;
       formContext: TFormContext | undefined;
+      isDirty: boolean;
+      changes: readonly _atscript_ui0.FormFieldChange[];
+      getPatch: (opts?: _atscript_ui0.FormDiffOptions) => Record<string, unknown>;
+      getChanges: () => _atscript_ui0.FormFieldChange[];
     }) => any;
   } & {
     'form.submit'?: (props: {
@@ -182,6 +216,10 @@ declare const __VLS_export: <TFormData = any, TFormContext = any>(__VLS_props: N
       dismissError: (path: string) => void;
       dismissFormError: () => void;
       formContext: TFormContext | undefined;
+      isDirty: boolean;
+      changes: readonly _atscript_ui0.FormFieldChange[];
+      getPatch: (opts?: _atscript_ui0.FormDiffOptions) => Record<string, unknown>;
+      getChanges: () => _atscript_ui0.FormFieldChange[];
     }) => any;
   } & {
     'form.footer'?: (props: {
@@ -200,6 +238,10 @@ declare const __VLS_export: <TFormData = any, TFormContext = any>(__VLS_props: N
       dismissError: (path: string) => void;
       dismissFormError: () => void;
       formContext: TFormContext | undefined;
+      isDirty: boolean;
+      changes: readonly _atscript_ui0.FormFieldChange[];
+      getPatch: (opts?: _atscript_ui0.FormDiffOptions) => Record<string, unknown>;
+      getChanges: () => _atscript_ui0.FormFieldChange[];
     }) => any;
   } & {
     'form.loading'?: (props: {
@@ -218,6 +260,10 @@ declare const __VLS_export: <TFormData = any, TFormContext = any>(__VLS_props: N
       dismissError: (path: string) => void;
       dismissFormError: () => void;
       formContext: TFormContext | undefined;
+      isDirty: boolean;
+      changes: readonly _atscript_ui0.FormFieldChange[];
+      getPatch: (opts?: _atscript_ui0.FormDiffOptions) => Record<string, unknown>;
+      getChanges: () => _atscript_ui0.FormFieldChange[];
     }) => any;
   };
   emit: {

package/dist/{as-form.vue-5FyX_1CQ.d.cts → as-form.vue-Dg_5GYWG.d.cts}

@@ -1,6 +1,7 @@
 import { n as TAsChangeType, o as TAsComponentProps, s as TAsTypeComponents } from "./types-BYfe1QEF.cjs";
 import * as vue from "vue";
 import { Component } from "vue";
+import * as _atscript_ui0 from "@atscript/ui";
 import { ClientFactory, FormDef } from "@atscript/ui";
 
 //#region src/composables/types.d.ts
@@ -74,21 +75,38 @@ interface Props<TF, TC> {
    * `inner-loading`.
    */
   loading?: boolean;
+  /**
+   * Enable change tracking. When set, the form captures a deep-clone baseline
+   * of its data and surfaces both a changed-fields list and an `@atscript/db`
+   * patch object. The tracking surface (`isDirty` / `changes` / `getPatch` /
+   * `getChanges`) is spread into every slot AND exposed on the component
+   * instance (template ref → `asForm.value.getPatch()`); descendants read it
+   * with `useAsFormPatch()`. Off by default — zero overhead when unset.
+   */
+  trackChanges?: boolean;
 }
 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;
     onAction?: ((name: string, data: TFormData) => any) | undefined;
+    onSubmit?: ((data: TFormData) => any) | undefined;
     "onUnsupported-action"?: ((name: string, data: TFormData) => any) | undefined;
     onChange?: ((type: TAsChangeType, path: string, value: unknown, formData: TFormData) => any) | undefined;
   }> & (typeof globalThis extends {
     __VLS_PROPS_FALLBACK: infer P;
   } ? P : {});
-  expose: (exposed: {}) => void;
+  expose: (exposed: vue.ShallowUnwrapRef<{
+    submit: () => void;
+    reset: () => Promise<void>; /** True when `track-changes` is on AND data differs from baseline. */
+    readonly isDirty: boolean; /** Revert-aware per-field change list (empty when tracking is off). */
+    readonly changes: _atscript_ui0.FormFieldChange[]; /** Build the `@atscript/db` patch object on demand (`{}` when off). */
+    getPatch: ((opts?: _atscript_ui0.FormDiffOptions) => Record<string, unknown>) | (() => {}); /** Build the per-field change list on demand (`[]` when off). */
+    getChanges: () => _atscript_ui0.FormFieldChange[]; /** Re-baseline to current data after a successful save (no-op when off). */
+    rebase: () => void;
+  }>) => void;
   attrs: any;
   slots: {
     'form.header'?: (props: {
@@ -107,6 +125,10 @@ declare const __VLS_export: <TFormData = any, TFormContext = any>(__VLS_props: N
       dismissError: (path: string) => void;
       dismissFormError: () => void;
       formContext: TFormContext | undefined;
+      isDirty: boolean;
+      changes: readonly _atscript_ui0.FormFieldChange[];
+      getPatch: (opts?: _atscript_ui0.FormDiffOptions) => Record<string, unknown>;
+      getChanges: () => _atscript_ui0.FormFieldChange[];
     }) => any;
   } & {
     'form.before'?: (props: {
@@ -125,6 +147,10 @@ declare const __VLS_export: <TFormData = any, TFormContext = any>(__VLS_props: N
       dismissError: (path: string) => void;
       dismissFormError: () => void;
       formContext: TFormContext | undefined;
+      isDirty: boolean;
+      changes: readonly _atscript_ui0.FormFieldChange[];
+      getPatch: (opts?: _atscript_ui0.FormDiffOptions) => Record<string, unknown>;
+      getChanges: () => _atscript_ui0.FormFieldChange[];
     }) => any;
   } & {
     'form.after'?: (props: {
@@ -143,6 +169,10 @@ declare const __VLS_export: <TFormData = any, TFormContext = any>(__VLS_props: N
       dismissError: (path: string) => void;
       dismissFormError: () => void;
       formContext: TFormContext | undefined;
+      isDirty: boolean;
+      changes: readonly _atscript_ui0.FormFieldChange[];
+      getPatch: (opts?: _atscript_ui0.FormDiffOptions) => Record<string, unknown>;
+      getChanges: () => _atscript_ui0.FormFieldChange[];
     }) => any;
   } & {
     'form.error'?: (props: {
@@ -163,6 +193,10 @@ declare const __VLS_export: <TFormData = any, TFormContext = any>(__VLS_props: N
       dismissError: (path: string) => void;
       dismissFormError: () => void;
       formContext: TFormContext | undefined;
+      isDirty: boolean;
+      changes: readonly _atscript_ui0.FormFieldChange[];
+      getPatch: (opts?: _atscript_ui0.FormDiffOptions) => Record<string, unknown>;
+      getChanges: () => _atscript_ui0.FormFieldChange[];
     }) => any;
   } & {
     'form.submit'?: (props: {
@@ -182,6 +216,10 @@ declare const __VLS_export: <TFormData = any, TFormContext = any>(__VLS_props: N
       dismissError: (path: string) => void;
       dismissFormError: () => void;
       formContext: TFormContext | undefined;
+      isDirty: boolean;
+      changes: readonly _atscript_ui0.FormFieldChange[];
+      getPatch: (opts?: _atscript_ui0.FormDiffOptions) => Record<string, unknown>;
+      getChanges: () => _atscript_ui0.FormFieldChange[];
     }) => any;
   } & {
     'form.footer'?: (props: {
@@ -200,6 +238,10 @@ declare const __VLS_export: <TFormData = any, TFormContext = any>(__VLS_props: N
       dismissError: (path: string) => void;
       dismissFormError: () => void;
       formContext: TFormContext | undefined;
+      isDirty: boolean;
+      changes: readonly _atscript_ui0.FormFieldChange[];
+      getPatch: (opts?: _atscript_ui0.FormDiffOptions) => Record<string, unknown>;
+      getChanges: () => _atscript_ui0.FormFieldChange[];
     }) => any;
   } & {
     'form.loading'?: (props: {
@@ -218,6 +260,10 @@ declare const __VLS_export: <TFormData = any, TFormContext = any>(__VLS_props: N
       dismissError: (path: string) => void;
       dismissFormError: () => void;
       formContext: TFormContext | undefined;
+      isDirty: boolean;
+      changes: readonly _atscript_ui0.FormFieldChange[];
+      getPatch: (opts?: _atscript_ui0.FormDiffOptions) => Record<string, unknown>;
+      getChanges: () => _atscript_ui0.FormFieldChange[];
     }) => any;
   };
   emit: {

package/dist/{as-input-CwPkK9qR.cjs → as-input-CqxNYh5q.cjs}

@@ -1,4 +1,4 @@
-const require_as_field_shell = require("./as-field-shell-zeno02I1.cjs");
+const require_as_field_shell = require("./as-field-shell-CW3DDHnq.cjs");
 const require_as_input_control = require("./as-input-control-BYo_dfQA.cjs");
 const require_as_adornment_shell = require("./as-adornment-shell-DptUMWNk.cjs");
 let vue = require("vue");

package/dist/{as-input-VOGvI31W.mjs → as-input-D7aA22Yx.mjs}

@@ -1,4 +1,4 @@
-import { t as as_field_shell_default } from "./as-field-shell-D0mNXfQZ.mjs";
+import { t as as_field_shell_default } from "./as-field-shell-BHYEjGcn.mjs";
 import { t as as_input_control_default } from "./as-input-control-Bx-isLZN.mjs";
 import { t as as_adornment_shell_default } from "./as-adornment-shell-C4A2fnDp.mjs";
 import { computed, createBlock, createVNode, defineComponent, guardReactiveProps, mergeProps, normalizeProps, openBlock, withCtx } from "vue";

package/dist/as-input.cjs

@@ -1,2 +1,2 @@
-const require_as_input = require("./as-input-CwPkK9qR.cjs");
+const require_as_input = require("./as-input-CqxNYh5q.cjs");
 module.exports = require_as_input.as_input_default;

package/dist/as-input.mjs

@@ -1,2 +1,2 @@
-import { t as as_input_default } from "./as-input-VOGvI31W.mjs";
+import { t as as_input_default } from "./as-input-D7aA22Yx.mjs";
 export { as_input_default as default };

package/dist/{as-iterator---gxkT-L.mjs → as-iterator-DW7giLlz.mjs}

@@ -1,5 +1,5 @@
-import { m as PATH_PREFIX_KEY } from "./use-form-context-bAj7UoSe.mjs";
-import { t as as_field_default } from "./as-field-CDB-HIfz.mjs";
+import { h as PATH_PREFIX_KEY } from "./use-form-context-D6J1WTyG.mjs";
+import { t as as_field_default } from "./as-field-DLW-csEu.mjs";
 import { Fragment, computed, createBlock, createElementBlock, defineComponent, inject, openBlock, provide, renderList } from "vue";
 //#endregion
 //#region src/components/as-iterator.vue

package/dist/{as-iterator-BWXIzbJF.cjs → as-iterator-DsDKfpTh.cjs}

@@ -1,5 +1,5 @@
-const require_use_form_context = require("./use-form-context-Dwr8Ai1v.cjs");
-const require_as_field = require("./as-field-DGnC4dew.cjs");
+const require_use_form_context = require("./use-form-context-DpGiGUvJ.cjs");
+const require_as_field = require("./as-field-BKa4D63r.cjs");
 let vue = require("vue");
 //#endregion
 //#region src/components/as-iterator.vue

package/dist/as-iterator.cjs

@@ -1,2 +1,2 @@
-const require_as_iterator = require("./as-iterator-BWXIzbJF.cjs");
+const require_as_iterator = require("./as-iterator-DsDKfpTh.cjs");
 module.exports = require_as_iterator.as_iterator_default;

package/dist/as-iterator.mjs

@@ -1,2 +1,2 @@
-import { t as as_iterator_default } from "./as-iterator---gxkT-L.mjs";
+import { t as as_iterator_default } from "./as-iterator-DW7giLlz.mjs";
 export { as_iterator_default as default };

package/dist/{as-multi-select-DGipqqGz.mjs → as-multi-select-Bsf4Y_mv.mjs}

@@ -1,4 +1,4 @@
-import { t as as_field_shell_default } from "./as-field-shell-D0mNXfQZ.mjs";
+import { t as as_field_shell_default } from "./as-field-shell-BHYEjGcn.mjs";
 import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, createVNode, defineComponent, mergeProps, openBlock, ref, renderList, toDisplayString, unref, withCtx, withModifiers } from "vue";
 import { optKey, optLabel } from "@atscript/ui";
 import { ComboboxAnchor, ComboboxContent, ComboboxEmpty, ComboboxInput, ComboboxItem, ComboboxPortal, ComboboxRoot, ComboboxViewport } from "reka-ui";

package/dist/{as-multi-select-D7XGZS3L.cjs → as-multi-select-DQUInqwY.cjs}

@@ -1,4 +1,4 @@
-const require_as_field_shell = require("./as-field-shell-zeno02I1.cjs");
+const require_as_field_shell = require("./as-field-shell-CW3DDHnq.cjs");
 let vue = require("vue");
 let _atscript_ui = require("@atscript/ui");
 let reka_ui = require("reka-ui");

package/dist/as-multi-select.cjs

@@ -1,2 +1,2 @@
-const require_as_multi_select = require("./as-multi-select-D7XGZS3L.cjs");
+const require_as_multi_select = require("./as-multi-select-DQUInqwY.cjs");
 module.exports = require_as_multi_select.as_multi_select_default;

package/dist/as-multi-select.mjs

@@ -1,2 +1,2 @@
-import { t as as_multi_select_default } from "./as-multi-select-DGipqqGz.mjs";
+import { t as as_multi_select_default } from "./as-multi-select-Bsf4Y_mv.mjs";
 export { as_multi_select_default as default };

package/dist/{as-number-BIhBVXih.mjs → as-number-B8MCg-ph.mjs}

@@ -1,5 +1,5 @@
 import { n as useAsLocale } from "./use-as-locale-BrFdAgnU.mjs";
-import { t as as_field_shell_default } from "./as-field-shell-D0mNXfQZ.mjs";
+import { t as as_field_shell_default } from "./as-field-shell-BHYEjGcn.mjs";
 import { t as as_input_control_default } from "./as-input-control-Bx-isLZN.mjs";
 import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createVNode, defineComponent, guardReactiveProps, mergeProps, normalizeClass, normalizeProps, openBlock, ref, toDisplayString, withCtx } from "vue";
 import { getDecimalSeparator, parseDecimalInput } from "@atscript/ui";

package/dist/{as-number-BQWwSipg.cjs → as-number-CFdK5xjM.cjs}

@@ -1,5 +1,5 @@
 const require_use_as_locale = require("./use-as-locale-C4z5stwD.cjs");
-const require_as_field_shell = require("./as-field-shell-zeno02I1.cjs");
+const require_as_field_shell = require("./as-field-shell-CW3DDHnq.cjs");
 const require_as_input_control = require("./as-input-control-BYo_dfQA.cjs");
 let vue = require("vue");
 let _atscript_ui = require("@atscript/ui");

package/dist/as-number.cjs

@@ -1,2 +1,2 @@
-const require_as_number = require("./as-number-BQWwSipg.cjs");
+const require_as_number = require("./as-number-CFdK5xjM.cjs");
 module.exports = require_as_number.as_number_default;

package/dist/as-number.mjs

@@ -1,2 +1,2 @@
-import { t as as_number_default } from "./as-number-BIhBVXih.mjs";
+import { t as as_number_default } from "./as-number-B8MCg-ph.mjs";
 export { as_number_default as default };