@atscript/vue-form 0.1.101 → 0.1.103

package/dist/{as-object-Dr7CttaK.mjs → as-object-CN3KZFXO.mjs}

@@ -1,8 +1,8 @@
-import { n as useAsUnionVariant } from "./use-form-context-bAj7UoSe.mjs";
-import { t as as_iterator_default } from "./as-iterator---gxkT-L.mjs";
-import { t as as_collapsible_default } from "./as-collapsible-DQOxKGGj.mjs";
+import { n as useAsUnionVariant } from "./use-form-context-D6J1WTyG.mjs";
+import { t as as_iterator_default } from "./as-iterator-DW7giLlz.mjs";
+import { t as as_collapsible_default } from "./as-collapsible-DFTzB5Ar.mjs";
 import { n as as_optional_clear_default, t as as_variant_picker_default } from "./as-variant-picker-B3GLhKyt.mjs";
-import { t as useAsOptionalAddFlow } from "./use-as-optional-add-flow-CQctXLZI.mjs";
+import { t as useAsOptionalAddFlow } from "./use-as-optional-add-flow-B_gr8sX-.mjs";
 import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, createVNode, defineComponent, normalizeClass, openBlock, toDisplayString, unref, useTemplateRef, vShow, withCtx, withDirectives, withModifiers } from "vue";
 import { isObjectField } from "@atscript/ui";
 //#region src/components/defaults/as-object.vue?vue&type=script&setup=true&lang.ts

package/dist/as-object.cjs

@@ -1,2 +1,2 @@
-const require_as_object = require("./as-object-BJxJJM13.cjs");
+const require_as_object = require("./as-object-B4sF9sIh.cjs");
 module.exports = require_as_object.as_object_default;

package/dist/as-object.mjs

@@ -1,2 +1,2 @@
-import { t as as_object_default } from "./as-object-Dr7CttaK.mjs";
+import { t as as_object_default } from "./as-object-CN3KZFXO.mjs";
 export { as_object_default as default };

package/dist/{as-radio-CdK8gCkN.cjs → as-radio-BeOQdoeq.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");
 //#region src/components/defaults/as-radio.vue?vue&type=script&setup=true&lang.ts

package/dist/{as-radio-DBW6XzlW.mjs → as-radio-CFaDbRPe.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, createBlock, createElementBlock, createElementVNode, createTextVNode, defineComponent, mergeProps, openBlock, renderList, toDisplayString, unref, vModelRadio, withCtx, withDirectives } from "vue";
 import { optKey, optLabel } from "@atscript/ui";
 //#region src/components/defaults/as-radio.vue?vue&type=script&setup=true&lang.ts

package/dist/as-radio.cjs

@@ -1,2 +1,2 @@
-const require_as_radio = require("./as-radio-CdK8gCkN.cjs");
+const require_as_radio = require("./as-radio-BeOQdoeq.cjs");
 module.exports = require_as_radio.as_radio_default;

package/dist/as-radio.mjs

@@ -1,2 +1,2 @@
-import { t as as_radio_default } from "./as-radio-DBW6XzlW.mjs";
+import { t as as_radio_default } from "./as-radio-CFaDbRPe.mjs";
 export { as_radio_default as default };

package/dist/{as-ref-D6zp_PIG.mjs → as-ref-CNQgr6zE.mjs}

@@ -1,5 +1,5 @@
-import { n as useAsValueHelp } from "./use-as-value-help-CBykDEjZ.mjs";
-import { t as as_field_shell_default } from "./as-field-shell-D0mNXfQZ.mjs";
+import { n as useAsValueHelp } from "./use-as-value-help-DrISSxCz.mjs";
+import { t as as_field_shell_default } from "./as-field-shell-BHYEjGcn.mjs";
 import { Fragment, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, createVNode, defineComponent, guardReactiveProps, normalizeProps, openBlock, ref, renderList, toDisplayString, unref, vModelText, withCtx, withDirectives } from "vue";
 import { ComboboxAnchor, ComboboxCancel, ComboboxContent, ComboboxEmpty, ComboboxInput, ComboboxItem, ComboboxRoot, ComboboxViewport } from "reka-ui";
 //#region src/components/defaults/as-ref.vue?vue&type=script&setup=true&lang.ts

package/dist/{as-ref-BOAHVeR-.cjs → as-ref-RawBvR6v.cjs}

@@ -1,5 +1,5 @@
-const require_use_as_value_help = require("./use-as-value-help-uANI3zWa.cjs");
-const require_as_field_shell = require("./as-field-shell-zeno02I1.cjs");
+const require_use_as_value_help = require("./use-as-value-help-BsAriqCI.cjs");
+const require_as_field_shell = require("./as-field-shell-CW3DDHnq.cjs");
 let vue = require("vue");
 let reka_ui = require("reka-ui");
 //#region src/components/defaults/as-ref.vue?vue&type=script&setup=true&lang.ts

package/dist/as-ref.cjs

@@ -1,2 +1,2 @@
-const require_as_ref = require("./as-ref-BOAHVeR-.cjs");
+const require_as_ref = require("./as-ref-RawBvR6v.cjs");
 module.exports = require_as_ref.as_ref_default;

package/dist/as-ref.mjs

@@ -1,2 +1,2 @@
-import { t as as_ref_default } from "./as-ref-D6zp_PIG.mjs";
+import { t as as_ref_default } from "./as-ref-CNQgr6zE.mjs";
 export { as_ref_default as default };

package/dist/{as-select-BiS6USZW.mjs → as-select-Cr00CPKf.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, createBlock, createCommentVNode, createElementBlock, createElementVNode, defineComponent, guardReactiveProps, normalizeProps, openBlock, renderList, toDisplayString, unref, vModelSelect, withCtx, withDirectives } from "vue";
 import { optKey, optLabel } from "@atscript/ui";
 //#region src/components/defaults/as-select.vue?vue&type=script&setup=true&lang.ts

package/dist/{as-select-B2jqgF38.cjs → as-select-LJIvBPiv.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");
 //#region src/components/defaults/as-select.vue?vue&type=script&setup=true&lang.ts

package/dist/as-select.cjs

@@ -1,2 +1,2 @@
-const require_as_select = require("./as-select-B2jqgF38.cjs");
+const require_as_select = require("./as-select-LJIvBPiv.cjs");
 module.exports = require_as_select.as_select_default;

package/dist/as-select.mjs

@@ -1,2 +1,2 @@
-import { t as as_select_default } from "./as-select-BiS6USZW.mjs";
+import { t as as_select_default } from "./as-select-Cr00CPKf.mjs";
 export { as_select_default as default };

package/dist/{as-time-BN-Vc-iw.mjs → as-time-CE2FaqZ3.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_adornment_shell_default } from "./as-adornment-shell-C4A2fnDp.mjs";
 import { n as as_date_control_default, t as useAsDate } from "./use-as-date-XLE8HBbo.mjs";
 import { computed, createBlock, createVNode, defineComponent, guardReactiveProps, mergeProps, normalizeProps, openBlock, unref, withCtx } from "vue";

package/dist/{as-time-DdQnNIQX.cjs → as-time-CqCF0pKQ.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_adornment_shell = require("./as-adornment-shell-DptUMWNk.cjs");
 const require_use_as_date = require("./use-as-date-DY8b1_V4.cjs");
 let vue = require("vue");

package/dist/as-time.cjs

@@ -1,2 +1,2 @@
-const require_as_time = require("./as-time-DdQnNIQX.cjs");
+const require_as_time = require("./as-time-CqCF0pKQ.cjs");
 module.exports = require_as_time.as_time_default;

package/dist/as-time.mjs

@@ -1,2 +1,2 @@
-import { t as as_time_default } from "./as-time-BN-Vc-iw.mjs";
+import { t as as_time_default } from "./as-time-CE2FaqZ3.mjs";
 export { as_time_default as default };

package/dist/{as-tuple-DaY_Mw-y.cjs → as-tuple-B3ysbvxB.cjs}

@@ -1,8 +1,8 @@
-const require_use_form_context = require("./use-form-context-Dwr8Ai1v.cjs");
-const require_as_field = require("./as-field-DGnC4dew.cjs");
-const require_as_collapsible = require("./as-collapsible-B0rlXU0x.cjs");
+const require_use_form_context = require("./use-form-context-DpGiGUvJ.cjs");
+const require_as_field = require("./as-field-BKa4D63r.cjs");
+const require_as_collapsible = require("./as-collapsible-BQ-eYR0v.cjs");
 const require_as_variant_picker = require("./as-variant-picker-JlEhh7YO.cjs");
-const require_use_as_optional_add_flow = require("./use-as-optional-add-flow-C85F2VoU.cjs");
+const require_use_as_optional_add_flow = require("./use-as-optional-add-flow-BXKiK1Kb.cjs");
 const require_as_array_clear_btn = require("./as-array-clear-btn-COfRUzeb.cjs");
 let vue = require("vue");
 let _atscript_ui = require("@atscript/ui");

package/dist/{as-tuple-BUzs7nm6.mjs → as-tuple-CeJWgP6l.mjs}

@@ -1,8 +1,8 @@
-import { a as CHANGE_HANDLER_KEY, n as useAsUnionVariant, r as useFormContext } from "./use-form-context-bAj7UoSe.mjs";
-import { t as as_field_default } from "./as-field-CDB-HIfz.mjs";
-import { t as as_collapsible_default } from "./as-collapsible-DQOxKGGj.mjs";
+import { a as CHANGE_HANDLER_KEY, n as useAsUnionVariant, r as useFormContext } from "./use-form-context-D6J1WTyG.mjs";
+import { t as as_field_default } from "./as-field-DLW-csEu.mjs";
+import { t as as_collapsible_default } from "./as-collapsible-DFTzB5Ar.mjs";
 import { t as as_variant_picker_default } from "./as-variant-picker-B3GLhKyt.mjs";
-import { t as useAsOptionalAddFlow } from "./use-as-optional-add-flow-CQctXLZI.mjs";
+import { t as useAsOptionalAddFlow } from "./use-as-optional-add-flow-B_gr8sX-.mjs";
 import { t as as_array_clear_btn_default } from "./as-array-clear-btn-BY1IBwBP.mjs";
 import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createSlots, createTextVNode, createVNode, defineComponent, inject, normalizeClass, onMounted, openBlock, renderList, toDisplayString, unref, useTemplateRef, vShow, withCtx, withDirectives } from "vue";
 import { META_LABEL, createFormData, createFormValueResolver, getFieldMeta } from "@atscript/ui";

package/dist/as-tuple.cjs

@@ -1,2 +1,2 @@
-const require_as_tuple = require("./as-tuple-DaY_Mw-y.cjs");
+const require_as_tuple = require("./as-tuple-B3ysbvxB.cjs");
 module.exports = require_as_tuple.as_tuple_default;

package/dist/as-tuple.mjs

@@ -1,2 +1,2 @@
-import { t as as_tuple_default } from "./as-tuple-BUzs7nm6.mjs";
+import { t as as_tuple_default } from "./as-tuple-CeJWgP6l.mjs";
 export { as_tuple_default as default };

package/dist/{as-union-B5OFQLJX.mjs → as-union-BPlYyGVk.mjs}

@@ -1,6 +1,6 @@
-import { _ as UNION_CONTEXT_KEY, a as CHANGE_HANDLER_KEY, g as TYPES_KEY, m as PATH_PREFIX_KEY, r as useFormContext } from "./use-form-context-bAj7UoSe.mjs";
+import { _ as TYPES_KEY, a as CHANGE_HANDLER_KEY, h as PATH_PREFIX_KEY, r as useFormContext, v as UNION_CONTEXT_KEY } from "./use-form-context-D6J1WTyG.mjs";
 import { t as useAsDropdown } from "./use-as-dropdown-B2Shb7wn.mjs";
-import { t as useAsOptionalAddFlow } from "./use-as-optional-add-flow-CQctXLZI.mjs";
+import { t as useAsOptionalAddFlow } from "./use-as-optional-add-flow-B_gr8sX-.mjs";
 import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, defineComponent, inject, mergeProps, normalizeClass, openBlock, provide, ref, renderList, resolveDynamicComponent, toDisplayString, unref, vShow, withDirectives } from "vue";
 import { createFormData, createFormValueResolver, detectUnionVariant, isUnionField } from "@atscript/ui";
 //#region src/composables/use-as-union.ts

package/dist/{as-union-Cz5cm7BP.cjs → as-union-Djhjo69H.cjs}

@@ -1,6 +1,6 @@
-const require_use_form_context = require("./use-form-context-Dwr8Ai1v.cjs");
+const require_use_form_context = require("./use-form-context-DpGiGUvJ.cjs");
 const require_use_as_dropdown = require("./use-as-dropdown-Bj9toVdw.cjs");
-const require_use_as_optional_add_flow = require("./use-as-optional-add-flow-C85F2VoU.cjs");
+const require_use_as_optional_add_flow = require("./use-as-optional-add-flow-BXKiK1Kb.cjs");
 let vue = require("vue");
 let _atscript_ui = require("@atscript/ui");
 //#region src/composables/use-as-union.ts

package/dist/as-union.cjs

@@ -1,2 +1,2 @@
-const require_as_union = require("./as-union-Cz5cm7BP.cjs");
+const require_as_union = require("./as-union-Djhjo69H.cjs");
 module.exports = require_as_union.as_union_default;

package/dist/as-union.mjs

@@ -1,2 +1,2 @@
-import { t as as_union_default } from "./as-union-B5OFQLJX.mjs";
+import { t as as_union_default } from "./as-union-BPlYyGVk.mjs";
 export { as_union_default as default };

package/dist/index.cjs

@@ -1,34 +1,34 @@
 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-DaAnsFVF.cjs");
-const require_as_field = require("./as-field-DGnC4dew.cjs");
+const require_use_form_context = require("./use-form-context-DpGiGUvJ.cjs");
+const require_as_form = require("./as-form-CrMA0HdQ.cjs");
+const require_use_as_nested_sections_store = require("./use-as-nested-sections-store--E0Ijpt5.cjs");
+const require_use_as_value_help = require("./use-as-value-help-BsAriqCI.cjs");
+const require_as_field = require("./as-field-BKa4D63r.cjs");
 const require_use_as_locale = require("./use-as-locale-C4z5stwD.cjs");
-const require_as_iterator = require("./as-iterator-BWXIzbJF.cjs");
+const require_as_iterator = require("./as-iterator-DsDKfpTh.cjs");
 const require_focus_after_toggle = require("./focus-after-toggle-CWxiPZWi.cjs");
-const require_as_collapsible = require("./as-collapsible-B0rlXU0x.cjs");
-const require_as_field_shell = require("./as-field-shell-zeno02I1.cjs");
+const require_as_collapsible = require("./as-collapsible-BQ-eYR0v.cjs");
+const require_as_field_shell = require("./as-field-shell-CW3DDHnq.cjs");
 const require_use_as_dropdown = require("./use-as-dropdown-Bj9toVdw.cjs");
-const require_as_input = require("./as-input-CwPkK9qR.cjs");
-const require_as_select = require("./as-select-B2jqgF38.cjs");
-const require_as_multi_select = require("./as-multi-select-D7XGZS3L.cjs");
-const require_as_radio = require("./as-radio-CdK8gCkN.cjs");
-const require_as_checkbox = require("./as-checkbox-Cva4XHFW.cjs");
+const require_as_input = require("./as-input-CqxNYh5q.cjs");
+const require_as_select = require("./as-select-LJIvBPiv.cjs");
+const require_as_multi_select = require("./as-multi-select-DQUInqwY.cjs");
+const require_as_radio = require("./as-radio-BeOQdoeq.cjs");
+const require_as_checkbox = require("./as-checkbox-oxG8_Isu.cjs");
 const require_as_paragraph = require("./as-paragraph-BA-c863H.cjs");
 const require_as_action = require("./as-action-lLooKipk.cjs");
-const require_use_as_optional_add_flow = require("./use-as-optional-add-flow-C85F2VoU.cjs");
-const require_as_object = require("./as-object-BJxJJM13.cjs");
-const require_as_array = require("./as-array-DAeDxzYV.cjs");
-const require_as_union = require("./as-union-Cz5cm7BP.cjs");
-const require_as_tuple = require("./as-tuple-DaY_Mw-y.cjs");
-const require_as_ref = require("./as-ref-BOAHVeR-.cjs");
-const require_as_decimal = require("./as-decimal-DhrdOvUQ.cjs");
-const require_as_number = require("./as-number-BQWwSipg.cjs");
+const require_use_as_optional_add_flow = require("./use-as-optional-add-flow-BXKiK1Kb.cjs");
+const require_as_object = require("./as-object-B4sF9sIh.cjs");
+const require_as_array = require("./as-array-C6tCzZir.cjs");
+const require_as_union = require("./as-union-Djhjo69H.cjs");
+const require_as_tuple = require("./as-tuple-B3ysbvxB.cjs");
+const require_as_ref = require("./as-ref-RawBvR6v.cjs");
+const require_as_decimal = require("./as-decimal-CJAHWYjW.cjs");
+const require_as_number = require("./as-number-CFdK5xjM.cjs");
 const require_use_as_date = require("./use-as-date-DY8b1_V4.cjs");
-const require_as_date = require("./as-date-Cizo8gZx.cjs");
-const require_as_datetime = require("./as-datetime-Cjbprmxg.cjs");
-const require_as_time = require("./as-time-DdQnNIQX.cjs");
+const require_as_date = require("./as-date-C7pJIpe-.cjs");
+const require_as_datetime = require("./as-datetime-DFTI8Wcr.cjs");
+const require_as_time = require("./as-time-CqCF0pKQ.cjs");
 let vue = require("vue");
 let _atscript_ui = require("@atscript/ui");
 //#region src/composables/create-as-form-def.ts
@@ -160,6 +160,7 @@ exports.useAsExternalErrors = require_as_form.useAsExternalErrors;
 exports.useAsField = require_as_field.useAsField;
 exports.useAsFocusFirstAfter = require_focus_after_toggle.useAsFocusFirstAfter;
 exports.useAsForm = require_as_form.useAsForm;
+exports.useAsFormPatch = require_as_form.useAsFormPatch;
 exports.useAsLocale = require_use_as_locale.useAsLocale;
 exports.useAsNestedSectionsStore = require_use_as_nested_sections_store.useAsNestedSectionsStore;
 exports.useAsNumber = require_as_number.useAsNumber;

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-BQx8-pxt.cjs";
+import { a as TFormRule, i as TFormFieldRegistration, n as _default$9, o as TFormState, r as TFormFieldCallbacks } from "./as-form.vue-Dg_5GYWG.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,8 +24,8 @@ import { t as _default$21 } from "./as-union.vue-AqH35ozq.cjs";
 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.76_@atscript+core@0.1.76_@emnapi+core@1.10.0_@emnapi+runtime@1_c74b63ecfec61eb3b1f4104ec2b0fae5/node_modules/@atscript/typescript/dist/utils.d.ts
+import { ClientFactory, ClientFactory as ClientFactory$1, FormArrayFieldDef, FormDef, FormDiffOptions, FormDiffOptions as FormDiffOptions$1, FormFieldChange, FormFieldChange as FormFieldChange$1, FormFieldDef, FormTupleFieldDef, FormUnionFieldDef, FormUnionVariant, ResolvedValueHelp, ValueHelpInfo, getDefaultClientFactory, resetDefaultClientFactory, setDefaultClientFactory } from "@atscript/ui";
+//#region ../../node_modules/.pnpm/@atscript+typescript@0.1.77_@atscript+core@0.1.77_@emnapi+core@1.10.0_@emnapi+runtime@1_66e726d698923960847d05359685c8c9/node_modules/@atscript/typescript/dist/utils.d.ts
 interface TError {
   path: string;
   message: string;
@@ -290,6 +290,69 @@ declare function useAsState<TFormData, TContext>(opts: {
   submitValidator?: TFormSubmitValidator;
 }): UseAsStateReturn;
 //#endregion
+//#region src/composables/use-as-form-patch.d.ts
+/**
+ * Change-tracking handle for a single `<AsForm>`. Exposed three ways:
+ *
+ * 1. injected via {@link useAsFormPatch} inside any descendant component,
+ * 2. spread into every `<AsForm>` slot (`isDirty` / `changes` / `getPatch` /
+ *    `getChanges` — so a footer slot can gate a Save button), and
+ * 3. `defineExpose`d on `<AsForm>` (so a parent template ref can call
+ *    `asForm.value.getPatch()`).
+ *
+ * Built on `@atscript/ui`'s `buildFormDiff`, which diffs the form's CURRENT
+ * data against a BASELINE snapshot and produces both a per-field change list
+ * and an `@atscript/db` patch object (keyed-array `$update`/`$insert`/`$remove`,
+ * `$cas` optimistic-concurrency sibling, revert-aware).
+ */
+interface AsFormPatchHandle {
+  /**
+   * Reactive dirtiness — `true` when current data differs from the baseline.
+   * Revert-aware: a value edited back to its baseline flips this back to
+   * `false`. Memoised by Vue; recomputes only when the form data changes.
+   */
+  isDirty: ComputedRef<boolean>;
+  /**
+   * Reactive per-field change list (revert-aware — reverted fields drop out).
+   * `before` / `after` hold live references into the baseline / current data.
+   */
+  changes: ComputedRef<FormFieldChange$1[]>;
+  /**
+   * Builds the `@atscript/db` patch object on demand against the baseline
+   * snapshot. Safe to call at submit time (a fresh re-snapshot point). Returns
+   * `{}` when nothing changed. Carries a top-level `$cas` sibling when the form
+   * has a `@db.column.version` column and `opts.cas` is on (default).
+   */
+  getPatch: (opts?: FormDiffOptions$1) => Record<string, unknown>;
+  /** Builds the per-field change list on demand (same data as `changes`). */
+  getChanges: () => FormFieldChange$1[];
+  /**
+   * Re-baseline to the current data. Call after a successful save so the form
+   * becomes clean again WITHOUT a remount. No-op when tracking is inactive.
+   */
+  rebase: () => void;
+}
+/**
+ * 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>
+ * ```
+ */
+declare function useAsFormPatch(): AsFormPatchHandle;
+//#endregion
 //#region src/composables/use-as-form.d.ts
 /**
  * Options for {@link useAsForm}. Each reactive prop is supplied as a
@@ -338,6 +401,15 @@ interface UseAsFormOptions<TFormData = unknown, TFormContext = unknown> {
    * server round-trip so consumers can drop their own submit overrides.
    */
   loading?: () => boolean | undefined;
+  /**
+   * Enable change tracking. When `true`, the composable captures a deep-clone
+   * baseline of the form data (the moment it becomes available) and exposes a
+   * {@link AsFormPatchHandle} via `slotProps`, the return value (`patch`), and
+   * `provide(FORM_PATCH_KEY)` (read with `useAsFormPatch()`). When falsy
+   * (default), there is ZERO overhead — no baseline, no deep watch, and
+   * `useAsFormPatch()` throws. Reactive.
+   */
+  trackChanges?: () => boolean | undefined;
   /**
    * Outbound callbacks. Customer form roots typically wire these to
    * `defineEmits`; advanced uses can pass plain functions.
@@ -362,7 +434,11 @@ interface UseAsFormReturn<TFormData = unknown, TFormContext = unknown> {
   formError: ComputedRef<string | undefined>;
   /** Errors discovered by the local validator on the most-recent submit. */
   internalErrors: Ref<Record<string, string>>;
-  /** Reset internal validator + dismissal state and re-run field defaults. */
+  /**
+   * Reset internal validator + dismissal state and re-run field defaults. When
+   * `trackChanges` is enabled, also re-baselines the change tracker to the
+   * post-reset state (the form becomes clean again).
+   */
   reset: () => Promise<void>;
   /** Imperatively clear errors (matches `useAsState().clearErrors`). */
   clearErrors: () => void;
@@ -394,8 +470,17 @@ interface UseAsFormReturn<TFormData = unknown, TFormContext = unknown> {
     setErrors: (errors: Record<string, string>) => void;
     dismissError: (path: string) => void;
     dismissFormError: () => void;
-    formContext: TFormContext | undefined;
+    formContext: TFormContext | undefined; /** True when `track-changes` is on AND data differs from baseline. */
+    isDirty: boolean; /** Revert-aware per-field change list (empty when tracking is off). */
+    changes: readonly FormFieldChange$1[]; /** Build the `@atscript/db` patch on demand (`{}` when tracking is off). */
+    getPatch: (opts?: FormDiffOptions$1) => Record<string, unknown>; /** Build the per-field change list on demand (`[]` when tracking is off). */
+    getChanges: () => FormFieldChange$1[];
   }>;
+  /**
+   * Change-tracking handle — present ONLY when `trackChanges` is enabled.
+   * `undefined` otherwise. Read it from descendants with `useAsFormPatch()`.
+   */
+  patch: AsFormPatchHandle | undefined;
   /** Dispatch an action — invoked by `<AsAction>`. */
   invokeAction: (name: string) => void;
   /** Dismiss a single external leaf error. */
@@ -993,4 +1078,4 @@ type AsErrorDismiss = (path: string) => void;
  */
 declare function useAsErrorDismiss(): AsErrorDismiss;
 //#endregion
-export { _default as AsAction, _default$1 as AsArray, _default$2 as AsCheckbox, _default$3 as AsCollapsible, _default$4 as AsDate, _default$5 as AsDatetime, _default$6 as AsDecimal, type AsErrorDismiss, _default$7 as AsField, _default$8 as AsFieldShell, _default$9 as AsForm, _default$10 as AsInput, _default$11 as AsIterator, _default$12 as AsMultiSelect, type AsNestedSectionsStore, _default$13 as AsNumber, _default$14 as AsObject, _default$15 as AsParagraph, _default$16 as AsRadio, _default$17 as AsRef, _default$18 as AsSelect, _default$19 as AsTime, _default$20 as AsTuple, _default$21 as AsUnion, type ClientFactory, type TAsBaseComponentProps, type TAsChangeType, type TAsCollapsibleProps, type TAsCollapsibleSlots, type TAsComponentEmits, type TAsComponentProps, type TAsTypeComponents, type TAsUnionContext, type TFormFieldCallbacks, type TFormFieldRegistration, type TFormRule, type TFormState, type TFormSubmitValidator, type UseAsArrayReturn, type UseAsDataReturn, type UseAsDateOptions, type UseAsDateReturn, type UseAsDecimalOptions, type UseAsDecimalReturn, type UseAsDualInputOptions, type UseAsDualInputReturn, type UseAsExternalErrorsOptions, type UseAsExternalErrorsReturn, type UseAsFieldOptions, type UseAsFieldReturn, type UseAsFormOptions, type UseAsFormReturn, type UseAsLocaleReturn, type UseAsNumberOptions, type UseAsNumberReturn, type UseAsOptionalAddFlowOptions, type UseAsOptionalAddFlowReturn, type UseAsPathReturn, type UseAsStateReturn, type UseAsTriStateCheckboxOptions, type UseAsTriStateCheckboxReturn, type UseAsTupleReturn, type UseAsTypeMapReturn, type UseAsUnionReturn, type UseAsValueHelpOptions, type UseAsValueHelpReturn, createAsFormDef, createDefaultTypes, focusFirstAfter, focusNewFocusableAfter, formatIndexedLabelParts, getDefaultClientFactory, provideAsLocale, provideAsNestedSectionsStore, resetDefaultClientFactory, setDefaultClientFactory, useAsArray, useAsData, useAsDate, useAsDecimal, useAsDropdown, useAsDualInput, useAsErrorDismiss, useAsExternalErrors, useAsField, useAsFocusFirstAfter, useAsForm, useAsLocale, useAsNestedSectionsStore, useAsNumber, useAsOptionalAddFlow, useAsPath, useAsState, useAsTriStateCheckbox, useAsTuple, useAsTypeMap, useAsUnion, useAsUnionVariant, useAsValueHelp };
+export { _default as AsAction, _default$1 as AsArray, _default$2 as AsCheckbox, _default$3 as AsCollapsible, _default$4 as AsDate, _default$5 as AsDatetime, _default$6 as AsDecimal, type AsErrorDismiss, _default$7 as AsField, _default$8 as AsFieldShell, _default$9 as AsForm, type AsFormPatchHandle, _default$10 as AsInput, _default$11 as AsIterator, _default$12 as AsMultiSelect, type AsNestedSectionsStore, _default$13 as AsNumber, _default$14 as AsObject, _default$15 as AsParagraph, _default$16 as AsRadio, _default$17 as AsRef, _default$18 as AsSelect, _default$19 as AsTime, _default$20 as AsTuple, _default$21 as AsUnion, type ClientFactory, type FormDiffOptions, type FormFieldChange, type TAsBaseComponentProps, type TAsChangeType, type TAsCollapsibleProps, type TAsCollapsibleSlots, type TAsComponentEmits, type TAsComponentProps, type TAsTypeComponents, type TAsUnionContext, type TFormFieldCallbacks, type TFormFieldRegistration, type TFormRule, type TFormState, type TFormSubmitValidator, type UseAsArrayReturn, type UseAsDataReturn, type UseAsDateOptions, type UseAsDateReturn, type UseAsDecimalOptions, type UseAsDecimalReturn, type UseAsDualInputOptions, type UseAsDualInputReturn, type UseAsExternalErrorsOptions, type UseAsExternalErrorsReturn, type UseAsFieldOptions, type UseAsFieldReturn, type UseAsFormOptions, type UseAsFormReturn, type UseAsLocaleReturn, type UseAsNumberOptions, type UseAsNumberReturn, type UseAsOptionalAddFlowOptions, type UseAsOptionalAddFlowReturn, type UseAsPathReturn, type UseAsStateReturn, type UseAsTriStateCheckboxOptions, type UseAsTriStateCheckboxReturn, type UseAsTupleReturn, type UseAsTypeMapReturn, type UseAsUnionReturn, type UseAsValueHelpOptions, type UseAsValueHelpReturn, createAsFormDef, createDefaultTypes, focusFirstAfter, focusNewFocusableAfter, formatIndexedLabelParts, getDefaultClientFactory, provideAsLocale, provideAsNestedSectionsStore, resetDefaultClientFactory, setDefaultClientFactory, useAsArray, useAsData, useAsDate, useAsDecimal, useAsDropdown, useAsDualInput, useAsErrorDismiss, useAsExternalErrors, useAsField, useAsFocusFirstAfter, useAsForm, useAsFormPatch, useAsLocale, useAsNestedSectionsStore, useAsNumber, useAsOptionalAddFlow, useAsPath, useAsState, useAsTriStateCheckbox, useAsTuple, useAsTypeMap, useAsUnion, useAsUnionVariant, useAsValueHelp };

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-CD0bUADp.mjs";
+import { a as TFormRule, i as TFormFieldRegistration, n as _default$9, o as TFormState, r as TFormFieldCallbacks } from "./as-form.vue-2NZSk1F9.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,8 +24,8 @@ import { t as _default$21 } from "./as-union.vue-Ew3Bany8.mjs";
 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.76_@atscript+core@0.1.76_@emnapi+core@1.10.0_@emnapi+runtime@1_c74b63ecfec61eb3b1f4104ec2b0fae5/node_modules/@atscript/typescript/dist/utils.d.ts
+import { ClientFactory, ClientFactory as ClientFactory$1, FormArrayFieldDef, FormDef, FormDiffOptions, FormDiffOptions as FormDiffOptions$1, FormFieldChange, FormFieldChange as FormFieldChange$1, FormFieldDef, FormTupleFieldDef, FormUnionFieldDef, FormUnionVariant, ResolvedValueHelp, ValueHelpInfo, getDefaultClientFactory, resetDefaultClientFactory, setDefaultClientFactory } from "@atscript/ui";
+//#region ../../node_modules/.pnpm/@atscript+typescript@0.1.77_@atscript+core@0.1.77_@emnapi+core@1.10.0_@emnapi+runtime@1_66e726d698923960847d05359685c8c9/node_modules/@atscript/typescript/dist/utils.d.ts
 interface TError {
   path: string;
   message: string;
@@ -290,6 +290,69 @@ declare function useAsState<TFormData, TContext>(opts: {
   submitValidator?: TFormSubmitValidator;
 }): UseAsStateReturn;
 //#endregion
+//#region src/composables/use-as-form-patch.d.ts
+/**
+ * Change-tracking handle for a single `<AsForm>`. Exposed three ways:
+ *
+ * 1. injected via {@link useAsFormPatch} inside any descendant component,
+ * 2. spread into every `<AsForm>` slot (`isDirty` / `changes` / `getPatch` /
+ *    `getChanges` — so a footer slot can gate a Save button), and
+ * 3. `defineExpose`d on `<AsForm>` (so a parent template ref can call
+ *    `asForm.value.getPatch()`).
+ *
+ * Built on `@atscript/ui`'s `buildFormDiff`, which diffs the form's CURRENT
+ * data against a BASELINE snapshot and produces both a per-field change list
+ * and an `@atscript/db` patch object (keyed-array `$update`/`$insert`/`$remove`,
+ * `$cas` optimistic-concurrency sibling, revert-aware).
+ */
+interface AsFormPatchHandle {
+  /**
+   * Reactive dirtiness — `true` when current data differs from the baseline.
+   * Revert-aware: a value edited back to its baseline flips this back to
+   * `false`. Memoised by Vue; recomputes only when the form data changes.
+   */
+  isDirty: ComputedRef<boolean>;
+  /**
+   * Reactive per-field change list (revert-aware — reverted fields drop out).
+   * `before` / `after` hold live references into the baseline / current data.
+   */
+  changes: ComputedRef<FormFieldChange$1[]>;
+  /**
+   * Builds the `@atscript/db` patch object on demand against the baseline
+   * snapshot. Safe to call at submit time (a fresh re-snapshot point). Returns
+   * `{}` when nothing changed. Carries a top-level `$cas` sibling when the form
+   * has a `@db.column.version` column and `opts.cas` is on (default).
+   */
+  getPatch: (opts?: FormDiffOptions$1) => Record<string, unknown>;
+  /** Builds the per-field change list on demand (same data as `changes`). */
+  getChanges: () => FormFieldChange$1[];
+  /**
+   * Re-baseline to the current data. Call after a successful save so the form
+   * becomes clean again WITHOUT a remount. No-op when tracking is inactive.
+   */
+  rebase: () => void;
+}
+/**
+ * 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>
+ * ```
+ */
+declare function useAsFormPatch(): AsFormPatchHandle;
+//#endregion
 //#region src/composables/use-as-form.d.ts
 /**
  * Options for {@link useAsForm}. Each reactive prop is supplied as a
@@ -338,6 +401,15 @@ interface UseAsFormOptions<TFormData = unknown, TFormContext = unknown> {
    * server round-trip so consumers can drop their own submit overrides.
    */
   loading?: () => boolean | undefined;
+  /**
+   * Enable change tracking. When `true`, the composable captures a deep-clone
+   * baseline of the form data (the moment it becomes available) and exposes a
+   * {@link AsFormPatchHandle} via `slotProps`, the return value (`patch`), and
+   * `provide(FORM_PATCH_KEY)` (read with `useAsFormPatch()`). When falsy
+   * (default), there is ZERO overhead — no baseline, no deep watch, and
+   * `useAsFormPatch()` throws. Reactive.
+   */
+  trackChanges?: () => boolean | undefined;
   /**
    * Outbound callbacks. Customer form roots typically wire these to
    * `defineEmits`; advanced uses can pass plain functions.
@@ -362,7 +434,11 @@ interface UseAsFormReturn<TFormData = unknown, TFormContext = unknown> {
   formError: ComputedRef<string | undefined>;
   /** Errors discovered by the local validator on the most-recent submit. */
   internalErrors: Ref<Record<string, string>>;
-  /** Reset internal validator + dismissal state and re-run field defaults. */
+  /**
+   * Reset internal validator + dismissal state and re-run field defaults. When
+   * `trackChanges` is enabled, also re-baselines the change tracker to the
+   * post-reset state (the form becomes clean again).
+   */
   reset: () => Promise<void>;
   /** Imperatively clear errors (matches `useAsState().clearErrors`). */
   clearErrors: () => void;
@@ -394,8 +470,17 @@ interface UseAsFormReturn<TFormData = unknown, TFormContext = unknown> {
     setErrors: (errors: Record<string, string>) => void;
     dismissError: (path: string) => void;
     dismissFormError: () => void;
-    formContext: TFormContext | undefined;
+    formContext: TFormContext | undefined; /** True when `track-changes` is on AND data differs from baseline. */
+    isDirty: boolean; /** Revert-aware per-field change list (empty when tracking is off). */
+    changes: readonly FormFieldChange$1[]; /** Build the `@atscript/db` patch on demand (`{}` when tracking is off). */
+    getPatch: (opts?: FormDiffOptions$1) => Record<string, unknown>; /** Build the per-field change list on demand (`[]` when tracking is off). */
+    getChanges: () => FormFieldChange$1[];
   }>;
+  /**
+   * Change-tracking handle — present ONLY when `trackChanges` is enabled.
+   * `undefined` otherwise. Read it from descendants with `useAsFormPatch()`.
+   */
+  patch: AsFormPatchHandle | undefined;
   /** Dispatch an action — invoked by `<AsAction>`. */
   invokeAction: (name: string) => void;
   /** Dismiss a single external leaf error. */
@@ -993,4 +1078,4 @@ type AsErrorDismiss = (path: string) => void;
  */
 declare function useAsErrorDismiss(): AsErrorDismiss;
 //#endregion
-export { _default as AsAction, _default$1 as AsArray, _default$2 as AsCheckbox, _default$3 as AsCollapsible, _default$4 as AsDate, _default$5 as AsDatetime, _default$6 as AsDecimal, type AsErrorDismiss, _default$7 as AsField, _default$8 as AsFieldShell, _default$9 as AsForm, _default$10 as AsInput, _default$11 as AsIterator, _default$12 as AsMultiSelect, type AsNestedSectionsStore, _default$13 as AsNumber, _default$14 as AsObject, _default$15 as AsParagraph, _default$16 as AsRadio, _default$17 as AsRef, _default$18 as AsSelect, _default$19 as AsTime, _default$20 as AsTuple, _default$21 as AsUnion, type ClientFactory, type TAsBaseComponentProps, type TAsChangeType, type TAsCollapsibleProps, type TAsCollapsibleSlots, type TAsComponentEmits, type TAsComponentProps, type TAsTypeComponents, type TAsUnionContext, type TFormFieldCallbacks, type TFormFieldRegistration, type TFormRule, type TFormState, type TFormSubmitValidator, type UseAsArrayReturn, type UseAsDataReturn, type UseAsDateOptions, type UseAsDateReturn, type UseAsDecimalOptions, type UseAsDecimalReturn, type UseAsDualInputOptions, type UseAsDualInputReturn, type UseAsExternalErrorsOptions, type UseAsExternalErrorsReturn, type UseAsFieldOptions, type UseAsFieldReturn, type UseAsFormOptions, type UseAsFormReturn, type UseAsLocaleReturn, type UseAsNumberOptions, type UseAsNumberReturn, type UseAsOptionalAddFlowOptions, type UseAsOptionalAddFlowReturn, type UseAsPathReturn, type UseAsStateReturn, type UseAsTriStateCheckboxOptions, type UseAsTriStateCheckboxReturn, type UseAsTupleReturn, type UseAsTypeMapReturn, type UseAsUnionReturn, type UseAsValueHelpOptions, type UseAsValueHelpReturn, createAsFormDef, createDefaultTypes, focusFirstAfter, focusNewFocusableAfter, formatIndexedLabelParts, getDefaultClientFactory, provideAsLocale, provideAsNestedSectionsStore, resetDefaultClientFactory, setDefaultClientFactory, useAsArray, useAsData, useAsDate, useAsDecimal, useAsDropdown, useAsDualInput, useAsErrorDismiss, useAsExternalErrors, useAsField, useAsFocusFirstAfter, useAsForm, useAsLocale, useAsNestedSectionsStore, useAsNumber, useAsOptionalAddFlow, useAsPath, useAsState, useAsTriStateCheckbox, useAsTuple, useAsTypeMap, useAsUnion, useAsUnionVariant, useAsValueHelp };
+export { _default as AsAction, _default$1 as AsArray, _default$2 as AsCheckbox, _default$3 as AsCollapsible, _default$4 as AsDate, _default$5 as AsDatetime, _default$6 as AsDecimal, type AsErrorDismiss, _default$7 as AsField, _default$8 as AsFieldShell, _default$9 as AsForm, type AsFormPatchHandle, _default$10 as AsInput, _default$11 as AsIterator, _default$12 as AsMultiSelect, type AsNestedSectionsStore, _default$13 as AsNumber, _default$14 as AsObject, _default$15 as AsParagraph, _default$16 as AsRadio, _default$17 as AsRef, _default$18 as AsSelect, _default$19 as AsTime, _default$20 as AsTuple, _default$21 as AsUnion, type ClientFactory, type FormDiffOptions, type FormFieldChange, type TAsBaseComponentProps, type TAsChangeType, type TAsCollapsibleProps, type TAsCollapsibleSlots, type TAsComponentEmits, type TAsComponentProps, type TAsTypeComponents, type TAsUnionContext, type TFormFieldCallbacks, type TFormFieldRegistration, type TFormRule, type TFormState, type TFormSubmitValidator, type UseAsArrayReturn, type UseAsDataReturn, type UseAsDateOptions, type UseAsDateReturn, type UseAsDecimalOptions, type UseAsDecimalReturn, type UseAsDualInputOptions, type UseAsDualInputReturn, type UseAsExternalErrorsOptions, type UseAsExternalErrorsReturn, type UseAsFieldOptions, type UseAsFieldReturn, type UseAsFormOptions, type UseAsFormReturn, type UseAsLocaleReturn, type UseAsNumberOptions, type UseAsNumberReturn, type UseAsOptionalAddFlowOptions, type UseAsOptionalAddFlowReturn, type UseAsPathReturn, type UseAsStateReturn, type UseAsTriStateCheckboxOptions, type UseAsTriStateCheckboxReturn, type UseAsTupleReturn, type UseAsTypeMapReturn, type UseAsUnionReturn, type UseAsValueHelpOptions, type UseAsValueHelpReturn, createAsFormDef, createDefaultTypes, focusFirstAfter, focusNewFocusableAfter, formatIndexedLabelParts, getDefaultClientFactory, provideAsLocale, provideAsNestedSectionsStore, resetDefaultClientFactory, setDefaultClientFactory, useAsArray, useAsData, useAsDate, useAsDecimal, useAsDropdown, useAsDualInput, useAsErrorDismiss, useAsExternalErrors, useAsField, useAsFocusFirstAfter, useAsForm, useAsFormPatch, useAsLocale, useAsNestedSectionsStore, useAsNumber, useAsOptionalAddFlow, useAsPath, useAsState, useAsTriStateCheckbox, useAsTuple, useAsTypeMap, useAsUnion, useAsUnionVariant, useAsValueHelp };