@anzusystems/common-admin 1.47.0-beta.dev-1782073999 → 1.47.0-beta.dev-1782075999

package/dist/labs.d.ts

@@ -1180,12 +1180,14 @@ export declare interface ListEditorChanges<TItem> {
 export declare interface ListEditorHandle<TItem extends Record<string, any>> {
     items: ComputedRef<TItem[]>;
     hasUnsaved: ComputedRef<boolean>;
+    /** Count of distinct unconfirmed changes (added/edited/moved rows + deferred-deletion tombstones). */
+    unsavedCount: ComputedRef<number>;
     hasErrors: ComputedRef<boolean>;
     invalidKeys: ComputedRef<Set<ListEditorKey>>;
     /** Amber: is this row added / edited / moved since the last commit? */
     isUnsaved: (key: ListEditorKey) => boolean;
     /** Red rail (gated): 'invalid' only once the row is unsaved or `validateAll()` ran. */
-    rowState: (item: TItem, key: ListEditorKey) => ListEditorValidationState;
+    rowState: (item: TItem, key: ListEditorKey, editing?: boolean) => ListEditorValidationState;
     /** Force-show all invalid rows + return whether the list is valid. The save guard. */
     validateAll: () => boolean;
     /** Normalized ordered array for a full-DTO save. */
@@ -1196,9 +1198,14 @@ export declare interface ListEditorHandle<TItem extends Record<string, any>> {
     commit: (savedItems?: TItem[]) => void;
     /** Discard unsaved edits back to the last committed baseline (or given items). */
     reset: (items?: TItem[]) => void;
-    addItem: (item?: TItem, hint?: PositionHint) => void;
+    addItem: (item?: TItem, hint?: PositionHint) => ListEditorKey | undefined;
     updateItem: (key: ListEditorKey, next: TItem | Partial<TItem> | ((current: TItem) => TItem)) => void;
-    deleteItem: (key: ListEditorKey) => void;
+    /** Remove a row. `trackDeleted: false` (immediate mode) skips the deferred-deletion tombstone. */
+    deleteItem: (key: ListEditorKey, opts?: {
+        trackDeleted?: boolean;
+    }) => void;
+    /** Clear a deferred-deletion tombstone (the caller re-inserts the row, e.g. reorder Cancel). */
+    restoreDeleted: (key: ListEditorKey) => void;
     moveItem: (fromIndex: number, toIndex: number) => void;
     /** Escape hatch: a row form (e.g. vuelidate) reports its own validity instead of `validate`. */
     registerValidity: (key: ListEditorKey, isValid: () => boolean) => () => void;
@@ -1308,12 +1315,14 @@ export declare interface NestedListEditorHandle<TItem extends Record<string, any
     /** Tree view rows (key/index/raw/depth/parent…), as consumed by the renderer. */
     viewItems: ComputedRef<NestedViewItem<TItem>[]>;
     hasUnsaved: ComputedRef<boolean>;
+    /** Count of distinct unconfirmed changes (added/edited/moved/reparented rows + deferred deletions). */
+    unsavedCount: ComputedRef<number>;
     hasErrors: ComputedRef<boolean>;
     invalidKeys: ComputedRef<Set<ListEditorKey>>;
     /** Amber: is this row added / edited / moved / reparented since the last commit? */
     isUnsaved: (key: ListEditorKey) => boolean;
     /** Red rail (gated): 'invalid' only once the row is unsaved or `validateAll()` ran. */
-    rowState: (item: TItem, key: ListEditorKey) => ListEditorValidationState;
+    rowState: (item: TItem, key: ListEditorKey, editing?: boolean) => ListEditorValidationState;
     /** Force-show all invalid rows + return whether the tree is valid. The save guard. */
     validateAll: () => boolean;
     /** Flattened ordered array (each row carrying its resolved position + parent key) for a full-DTO save. */
@@ -1328,7 +1337,10 @@ export declare interface NestedListEditorHandle<TItem extends Record<string, any
     addAfter: (afterKey: ListEditorKey, item?: TItem, childrenAllowed?: boolean) => void;
     addChild: (parentKey: ListEditorKey, item?: TItem, childrenAllowed?: boolean) => void;
     updateItem: (key: ListEditorKey, data: TItem, markDirty?: boolean) => void;
-    deleteItem: (key: ListEditorKey) => void;
+    deleteItem: (key: ListEditorKey, opts?: {
+        trackDeleted?: boolean;
+    }) => void;
+    restoreDeleted: (key: ListEditorKey) => void;
     moveUp: (key: ListEditorKey) => boolean;
     moveDown: (key: ListEditorKey) => boolean;
     moveTop: (key: ListEditorKey) => boolean;
@@ -1493,6 +1505,13 @@ declare interface Props<TItem extends Record<string, any>> {
     disableUnsaved?: boolean;
     deleteConfirmTitle?: string | null;
     deleteConfirmText?: string | null;
+    /**
+     * How a row delete persists. `deferred` (default): the row disappears but the deletion counts as an
+     * unconfirmed change (`unsavedCount`) until save, and is revertible until then. `immediate`: the
+     * consumer deletes on the backend (`:on-delete`) — the dialog states it is irreversible and the
+     * delete does NOT read as unsaved.
+     */
+    deleteMode?: 'immediate' | 'deferred';
     closeVariant?: 'auto' | 'icon' | 'labeled';
     /**
      * Render every `#item` slot expanded — no edit pencil, inline footer, or row-click
@@ -1573,6 +1592,12 @@ declare interface Props_2<TItem extends Record<string, any>> {
     disableDeleteConfirm?: boolean;
     deleteConfirmTitle?: string | null;
     deleteConfirmText?: string | null;
+    /**
+     * How a row delete persists. `deferred` (default): the row disappears but the deletion counts as an
+     * unconfirmed change until save (revertible until then, incl. via reorder Cancel). `immediate`: the
+     * consumer deletes on the backend — the dialog says it is irreversible and it does NOT read as unsaved.
+     */
+    deleteMode?: 'immediate' | 'deferred';
     closeVariant?: 'auto' | 'icon' | 'labeled';
     loadingKeys?: Set<ListEditorKey> | null;
     showReorderToggle?: boolean;
@@ -1667,6 +1692,12 @@ declare interface Props_3<TItem extends Record<string, any>> {
     disableDeleteConfirm?: boolean;
     deleteConfirmTitle?: string | null;
     deleteConfirmText?: string | null;
+    /**
+     * How a row delete persists. `deferred` (default): the row disappears but the deletion counts as an
+     * unconfirmed change until save (revertible until then, incl. via reorder Cancel). `immediate`: the
+     * consumer deletes on the backend — the dialog says it is irreversible and it does NOT read as unsaved.
+     */
+    deleteMode?: 'immediate' | 'deferred';
     closeVariant?: 'auto' | 'icon' | 'labeled';
     loadingKeys?: Set<ListEditorKey> | null;
     showReorderToggle?: boolean;
@@ -2066,6 +2097,20 @@ export declare function useFilterHelpers<F extends readonly MakeFilterOption<str
     } | null;
 };
 
+/**
+ * Wrap an entity-delete handler so it bypasses the unsaved-changes leave guard.
+ *
+ * An entity delete destroys the record together with any unsaved edits, so the "you have unsaved
+ * changes — really leave?" prompt that the delete's `router.push` would otherwise trigger is
+ * meaningless: the user already confirmed the delete, and there is nothing left to keep. Without this
+ * the delete runs, then the leave-guard fires on the post-delete navigation and choosing "stay" leaves
+ * the view on an already-deleted entity (system error). This acknowledges the guard right before the
+ * delete so the follow-up navigation proceeds without prompting. (QA 85050 batch 7 — BUG-08)
+ *
+ * Usage: `@delete-record="guardedDelete(() => onDelete(id))"` or wrap the handler once.
+ */
+export declare function useGuardedDelete<A extends unknown[], R>(guard: Pick<UseUnsavedChangesGuardApi, 'acknowledge'>, onDelete: (...args: A) => R): (...args: A) => R;
+
 export declare function useJobApi<JobType extends JobBase = JobBase>(client: () => AxiosInstance, system: string): {
     useFetchJobList: () => UseApiFetchListReturnType<JobType[]>;
     fetchJob: (id: number) => Promise<JobType>;