@anzusystems/common-admin 1.47.0-beta.dev-1778754002 → 1.47.0-beta.dev-1778754004

package/dist/labs.d.ts

@@ -285,6 +285,10 @@ declare const __VLS_export_17: <TItem extends Record<string, any>>(__VLS_props:
         onEdit?: ((item: ListViewItem<TItem>) => any) | undefined;
         onAdd?: ((positionHint: PositionHint | undefined) => any) | undefined;
         "onUpdate:modelValue"?: ((value: TItem[]) => any) | undefined;
+        onAdded?: ((payload: {
+            item: TItem;
+            index: number;
+        }) => any) | undefined;
         "onItem-saved"?: ((item: ListViewItem<TItem>) => any) | undefined;
         "onItem-expand"?: ((item: ListViewItem<TItem>, expanded: boolean) => any) | undefined;
         "onUpdate:unsavedKeys"?: ((value: Set<ListEditorKey>) => any) | undefined;
@@ -317,7 +321,10 @@ declare const __VLS_export_17: <TItem extends Record<string, any>>(__VLS_props:
         'before-item'?: (props: RowSlotProps<TItem>) => unknown;
         'after-item'?: (props: RowSlotProps<TItem>) => unknown;
     };
-    emit: (((evt: "deleted", item: ListViewItem<TItem>) => void) & ((evt: "close", item: ListViewItem<TItem>) => void) & ((evt: "edit", item: ListViewItem<TItem>) => void) & ((evt: "add", positionHint: PositionHint | undefined) => void) & ((evt: "item-saved", item: ListViewItem<TItem>) => void) & ((evt: "item-expand", item: ListViewItem<TItem>, expanded: boolean) => void)) & (((event: "update:modelValue", value: TItem[]) => void) & ((event: "update:unsavedKeys", value: Set<ListEditorKey>) => void));
+    emit: (((evt: "deleted", item: ListViewItem<TItem>) => void) & ((evt: "close", item: ListViewItem<TItem>) => void) & ((evt: "edit", item: ListViewItem<TItem>) => void) & ((evt: "add", positionHint: PositionHint | undefined) => void) & ((evt: "added", payload: {
+        item: TItem;
+        index: number;
+    }) => void) & ((evt: "item-saved", item: ListViewItem<TItem>) => void) & ((evt: "item-expand", item: ListViewItem<TItem>, expanded: boolean) => void)) & (((event: "update:modelValue", value: TItem[]) => void) & ((event: "update:unsavedKeys", value: Set<ListEditorKey>) => void));
 }>) => VNode & {
     __ctx?: Awaited<typeof __VLS_setup>;
 };
@@ -334,6 +341,10 @@ declare const __VLS_export_18: <TItem extends Record<string, any>>(__VLS_props:
         onAdd?: ((positionHint: PositionHint | undefined) => any) | undefined;
         "onUpdate:modelValue"?: ((value: TItem[]) => any) | undefined;
         "onUpdate:mode"?: ((value: ReorderMode) => any) | undefined;
+        onAdded?: ((payload: {
+            item: TItem;
+            index: number;
+        }) => any) | undefined;
         "onItem-saved"?: ((item: ListViewItem<TItem>) => any) | undefined;
         "onItem-expand"?: ((item: ListViewItem<TItem>, expanded: boolean) => any) | undefined;
         "onReorder-start"?: (() => any) | undefined;
@@ -377,7 +388,10 @@ declare const __VLS_export_18: <TItem extends Record<string, any>>(__VLS_props:
         'before-item'?: (props: RowSlotProps_2<TItem>) => unknown;
         'after-item'?: (props: RowSlotProps_2<TItem>) => unknown;
     };
-    emit: (((evt: "deleted", item: ListViewItem<TItem>) => void) & ((evt: "close", item: ListViewItem<TItem>) => void) & ((evt: "edit", item: ListViewItem<TItem>) => void) & ((evt: "add", positionHint: PositionHint | undefined) => void) & ((evt: "item-saved", item: ListViewItem<TItem>) => void) & ((evt: "item-expand", item: ListViewItem<TItem>, expanded: boolean) => void) & ((evt: "reorder-start") => void) & ((evt: "reorder-cancel") => void) & ((evt: "reorder-applied", items: TItem[]) => void) & ((evt: "reorder-apply-error", error: unknown) => void) & ((evt: "reorder-end") => void)) & (((event: "update:modelValue", value: TItem[]) => void) & ((event: "update:mode", value: ReorderMode) => void) & ((event: "update:unsavedKeys", value: Set<ListEditorKey>) => void));
+    emit: (((evt: "deleted", item: ListViewItem<TItem>) => void) & ((evt: "close", item: ListViewItem<TItem>) => void) & ((evt: "edit", item: ListViewItem<TItem>) => void) & ((evt: "add", positionHint: PositionHint | undefined) => void) & ((evt: "added", payload: {
+        item: TItem;
+        index: number;
+    }) => void) & ((evt: "item-saved", item: ListViewItem<TItem>) => void) & ((evt: "item-expand", item: ListViewItem<TItem>, expanded: boolean) => void) & ((evt: "reorder-start") => void) & ((evt: "reorder-cancel") => void) & ((evt: "reorder-applied", items: TItem[]) => void) & ((evt: "reorder-apply-error", error: unknown) => void) & ((evt: "reorder-end") => void)) & (((event: "update:modelValue", value: TItem[]) => void) & ((event: "update:mode", value: ReorderMode) => void) & ((event: "update:unsavedKeys", value: Set<ListEditorKey>) => void));
 }>) => VNode & {
     __ctx?: Awaited<typeof __VLS_setup>;
 };
@@ -764,11 +778,11 @@ declare type __VLS_Slots_3 = {} & {
 };
 
 declare type __VLS_Slots_4 = {} & {
-    title?: (props: typeof __VLS_44) => any;
+    title?: (props: typeof __VLS_45) => any;
 };
 
 declare type __VLS_Slots_5 = {} & {
-    'append-item'?: (props: typeof __VLS_12) => any;
+    'append-item'?: (props: typeof __VLS_14) => any;
 };
 
 declare type __VLS_WithSlots<T, S> = T & {
@@ -1315,6 +1329,17 @@ export declare interface NestedViewItem<TItem> extends ListViewItem<TItem> {
     canOutdent: boolean;
 }
 
+/**
+ * Unique negative temp id for new (unsaved) list rows.
+ *
+ * Row keys must be unique per row — duplicate or missing keys break dirty
+ * tracking, validation rails and reorder targeting. A single module-wide
+ * negative sequence guarantees uniqueness across all factories (two domain
+ * factories can no longer both hand out `-1`), and can never collide with
+ * persisted ids, which are positive. The backend assigns real ids on save.
+ */
+export declare const nextListEditorTempId: () => number;
+
 export declare interface Pagination {
     sortBy: DatatableSortBy;
     page: number;
@@ -1374,6 +1399,25 @@ declare interface Props<TItem extends Record<string, any>> {
     onDeleteConfirm?: (item: TItem) => Promise<boolean> | boolean;
     onDelete?: (item: TItem) => Promise<void> | void;
     onItemSave?: (item: TItem) => Promise<void> | void;
+    /**
+     * Editor-managed add: the add button and "add after this item" insert
+     * `itemFactory()` into the model directly (positions renumbered when
+     * `update-position` is on) and emit `added` — the `add` event does NOT fire,
+     * so no consumer push handler is needed.
+     */
+    itemFactory?: () => TItem;
+    /**
+     * Editor-managed delete: a confirmed delete removes the row from the model
+     * itself. `deleted` still fires as a notification — consumers keep side
+     * effects but must not splice the model themselves.
+     */
+    manageDelete?: boolean;
+    /**
+     * Registers this editor as a named unsaved-changes section under the given
+     * (already translated) label — replaces the per-consumer `useUnsavedSection`
+     * call for the common one-editor case.
+     */
+    unsavedSectionLabel?: string;
 }
 
 declare interface Props_2<TItem extends Record<string, any>> {
@@ -1433,6 +1477,25 @@ declare interface Props_2<TItem extends Record<string, any>> {
     onDelete?: (item: TItem) => Promise<void> | void;
     onItemSave?: (item: TItem) => Promise<void> | void;
     onReorderApply?: (items: TItem[]) => Promise<void> | void;
+    /**
+     * Editor-managed add: the add button and "add after this item" insert
+     * `itemFactory()` into the model directly (positions renumbered when
+     * `update-position` is on) and emit `added` — the `add` event does NOT fire,
+     * so no consumer push handler is needed.
+     */
+    itemFactory?: () => TItem;
+    /**
+     * Editor-managed delete: a confirmed delete removes the row from the model
+     * itself. `deleted` still fires as a notification — consumers keep side
+     * effects but must not splice the model themselves.
+     */
+    manageDelete?: boolean;
+    /**
+     * Registers this editor as a named unsaved-changes section under the given
+     * (already translated) label — replaces the per-consumer `useUnsavedSection`
+     * call for the common one-editor case.
+     */
+    unsavedSectionLabel?: string;
 }
 
 declare interface Props_3<TItem extends Record<string, any>> {
@@ -1474,6 +1537,12 @@ declare interface Props_3<TItem extends Record<string, any>> {
     onDelete?: (item: TItem) => Promise<void> | void;
     onItemSave?: (item: TItem) => Promise<void> | void;
     onReorderApply?: (tree: NestedTree<TItem>) => Promise<void> | void;
+    /**
+     * Registers this editor as a named unsaved-changes section under the given
+     * (already translated) label — replaces the per-consumer `useUnsavedSection`
+     * call for the common one-editor case.
+     */
+    unsavedSectionLabel?: string;
 }
 
 declare interface Props_4 {
@@ -1488,6 +1557,15 @@ declare interface Props_4 {
     dirtyLabels?: string[];
 }
 
+export declare const renumberPositions: <TItem extends Record<string, any>>(items: TItem[], options?: RenumberPositionsOptions) => TItem[];
+
+export declare interface RenumberPositionsOptions {
+    /** Item field holding the position. Defaults to `'position'`. */
+    positionField?: string;
+    /** Multiplier applied to the 1-based index (e.g. 10 → 10, 20, 30…). Defaults to `1`. */
+    positionMultiplier?: number;
+}
+
 declare type ReorderMode = 'view' | 'reorder';
 
 declare type ReorderMode_2 = 'view' | 'reorder';
@@ -1664,6 +1742,17 @@ export declare interface SortableNestedItem<TData extends SortableItemWithParent
     };
 }
 
+/**
+ * Returns a copy of the list ordered by ascending `position`. Use after
+ * fetching/saving collections whose backend returns rows in storage order —
+ * a shared, non-mutating alternative to scattered
+ * `items.sort((a, b) => a.position - b.position)` calls (in-place `sort`
+ * mutates the source and can trigger unintended reactivity).
+ */
+export declare const sortByPosition: <TItem extends {
+    position: number;
+}>(items: TItem[]) => TItem[];
+
 declare const SortOrder: {
     readonly Asc: "asc";
     readonly Desc: "desc";
@@ -1861,8 +1950,26 @@ declare interface UseListEditorItemValidationOptions {
     /**
      * Reactive validation state. Common shape: a computed reading vuelidate's
      * `v$.$dirty && v$.$invalid` and returning 'invalid' or null.
+     *
+     * Prefer `invalid` (+ optional `dirty`) below: it lets the editor surface the
+     * error once the row is unsaved without relying on mount-relative `$anyDirty`.
+     * `state` is kept for callers that report 'valid'/'warning' or custom logic.
      */
-    state: Ref<ListEditorValidationState> | ComputedRef<ListEditorValidationState> | (() => ListEditorValidationState);
+    state?: Ref<ListEditorValidationState> | ComputedRef<ListEditorValidationState> | (() => ListEditorValidationState);
+    /**
+     * Whether the row's data fails validation right now (e.g. `() => v$.value.$invalid`).
+     * When provided, the row is flagged 'invalid' as soon as it is invalid AND the
+     * user has had a chance to fix it — i.e. the row is unsaved (added / modified)
+     * or `dirty` below is true. Untouched rows on initial load stay clear so a
+     * persisted-but-invalid record does not light up red before any interaction.
+     */
+    invalid?: () => boolean;
+    /**
+     * Optional extra "has been interacted with" signal OR-ed with the editor's
+     * unsaved tracking (e.g. `() => v$.value.$anyDirty`). Useful when unsaved
+     * tracking is disabled on the editor.
+     */
+    dirty?: () => boolean;
 }
 
 export declare interface UseListEditorOptions {
@@ -1872,6 +1979,25 @@ export declare interface UseListEditorOptions {
     updatePosition?: boolean;
 }
 
+/**
+ * Registers a row's vuelidate state with the surrounding list editor so the
+ * row shows the red invalid rail (invalid + unsaved/dirty) instead of amber.
+ *
+ * This is the one blessed shape for row validity sentinels — domain sentinels
+ * call their validation composable and delegate here:
+ *
+ * ```ts
+ * const item = computed(() => props.modelValue)
+ * const { v$ } = useReviewListItemValidation(item)
+ * useListEditorVuelidateSentinel(v$, () => item.value.id ?? item.value.position)
+ * ```
+ *
+ * `key` must return the same key the editor resolves for the row
+ * (its `key-field`) or the item's own id/position — the editor's validation
+ * registry accepts either.
+ */
+export declare function useListEditorVuelidateSentinel(v$: Ref<VuelidateSentinelSource>, key: () => ListEditorKey): void;
+
 /**
  * Nested list editor core. Pure data behavior shared by ANestedSortableListEditor.
  * Works on a tree of `{ data, children, meta }` nodes — shape-compatible with the
@@ -1907,6 +2033,11 @@ declare interface UseNestedListEditorOptions {
  *     @update:unsaved-keys="(s) => childSets.setForParent(parent.id, s)"
  *   />
  *   // emit `childSets.merged.value` upward
+ *
+ * IMPORTANT: when the parent editor uses `manage-delete`, clear the removed
+ * parent's entry on its `@deleted` — `setForParent(deletedKey, new Set())` —
+ * otherwise the deleted row's stale child-unsaved keys keep `merged` non-empty
+ * and the unsaved-changes guard lingers after an add-then-delete.
  */
 export declare function useNestedUnsavedKeys(): UseNestedUnsavedKeysApi;
 
@@ -2103,6 +2234,15 @@ declare interface ViewBodySlotProps<TItem extends Record<string, any>> {
     };
 }
 
+/**
+ * Minimal surface of a vuelidate instance the sentinel reads — any
+ * `useVuelidate()` return value is structurally assignable.
+ */
+export declare interface VuelidateSentinelSource {
+    $invalid: boolean;
+    $anyDirty: boolean;
+}
+
 export { }
 
 declare global {