feat: make auto-save behaviour optional in form helpers

src/form.ts

@@ -6,7 +6,7 @@ import {
   RetrieveOperation,
 } from '@rokoli/bnb'
 import { ID, PartialUpdateOperation, useServerErrorFields, useServerErrors } from '@rokoli/bnb/drf'
-import { watchDebounced } from '@vueuse/core'
+import { extendRef, watchDebounced } from '@vueuse/core'
 import { sort } from 'fast-sort'
 import { cloneDeep, isEqual } from 'lodash'
 import {
@@ -277,6 +277,7 @@ type UseCopyOptions<T> = {
   clone?: (v: T) => T
   isEqual?: (v1: T, v2: T) => boolean
   save?: (value: T) => unknown
+  noAutoSave?: boolean
   shallow?: boolean
   debounce?: number
 }
@@ -292,17 +293,18 @@ export function useCopy<T>(state: MaybeRefOrGetter<T>, options: UseCopyOptions<T
     value.value = _clone(toValue(state))
   })
 
-  watchDebounced(
-    value,
-    (newValue) => {
-      if (_save && !_isEqual(newValue, toValue(state))) {
-        _save(newValue)
-      }
-    },
-    { deep: true, debounce },
-  )
+  function triggerSave() {
+    const _value = value.value
+    if (_save && !_isEqual(_value, toValue(state))) {
+      _save(_value)
+    }
+  }
 
-  return value
+  if (!options.noAutoSave) {
+    watchDebounced(value, triggerSave, { deep: true, debounce })
+  }
+
+  return extendRef(value, { triggerSave }, { enumerable: true })
 }
 
 export function useAPIObjectFieldCopy<T extends APIObject, K extends keyof T = keyof T, V = T[K]>(
@@ -325,5 +327,9 @@ export function useAPIObjectFieldCopy<T extends APIObject, K extends keyof T = k
 
   const state = computed<V>(() => _object.value[key] as V)
   const value = useCopy<V>(state, { ...options, save })
-  return reactive({ value, isSaving, errors })
+  function triggerSave() {
+    value.triggerSave()
+  }
+
+  return reactive({ value, save: triggerSave, isSaving, errors })
 }