@webitel/ui-datalist 1.1.79 → 1.1.80

package/Readme.md

@@ -79,6 +79,8 @@ aka "page"/"entity page"/"item card"/"item form" - form card of a single item fr
 import {
     createCardStore, // pinia store factory
     useCardComponent, // all-in-one composable for card component wrapper (opened-*entity*.vue)
+    useNestedCardComponent, // popup / nested-route card with its own store
+    useCardAnyFieldEditedWatcher, // dirty flag for a local draft ref (no card store)
 } from '@webitel/ui-datalist/card';
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@webitel/ui-datalist",
-	"version": "1.1.79",
+	"version": "1.1.80",
 	"description": "Toolkit for building data lists in webitel ui system",
 	"scripts": {
 		"build:types": "vue-tsc -b tsconfig.build.json",

package/src/modules/card/composables/useCardAnyFieldEditedWatcher.ts

@@ -1,5 +1,23 @@
 import { type Ref, ref, watch } from 'vue';
 
+/**
+ * Dirty flag for a local draft `ref`.
+ *
+ * Replacing `value` with a new object resets dirty. Mutating fields
+ * in place sets `isAnyFieldEdited` to `true`.
+ *
+ * Used by `useCardComponent`. Also usable on nested popups that keep
+ * a local draft instead of a card store.
+ *
+ * @example
+ * ```ts
+ * const draft = ref({ name: '' });
+ * const { isAnyFieldEdited } = useCardAnyFieldEditedWatcher({ value: draft });
+ *
+ * draft.value = { name: 'Holiday' }; // reset
+ * draft.value.name = 'NY';           // dirty
+ * ```
+ */
 export const useCardAnyFieldEditedWatcher = ({
 	value,
 }: {

package/src/modules/card/index.ts

@@ -1,3 +1,4 @@
+export * from './composables/useCardAnyFieldEditedWatcher';
 export * from './composables/useCardComponent';
 export * from './composables/useCardListNavigation';
 export * from './composables/useCardTabs';