@anzusystems/common-admin 1.47.0-beta.dev-1778753786 → 1.47.0-beta.dev-1778753787

package/dist/labs.d.ts

@@ -423,6 +423,7 @@ declare const __VLS_export_18: DefineComponent<__VLS_PublicProps_4, {}, {}, {},
     body: string;
     stayLabel: string;
     discardLabel: string;
+    dirtyLabels: string[];
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
 declare const __VLS_export_2: __VLS_WithSlots_2<typeof __VLS_base_2, __VLS_Slots_2>;
@@ -1361,6 +1362,11 @@ declare interface Props_4 {
     body?: string;
     stayLabel?: string;
     discardLabel?: string;
+    /**
+     * Names of the dirty sections (from the guard's `dirtyLabels`). When
+     * non-empty the dialog lists them instead of the generic body message.
+     */
+    dirtyLabels?: string[];
 }
 
 declare type ReorderMode = 'view' | 'reorder';
@@ -1580,6 +1586,21 @@ declare interface ToolbarSlotProps_2 {
     };
 }
 
+/**
+ * One named, savable section the unsaved-changes confirm dialog can name back
+ * to the user. `dirty` is evaluated reactively inside the section's getter.
+ */
+export declare interface UnsavedSectionDescriptor {
+    label: string;
+    dirty: boolean;
+}
+
+/**
+ * Getter returning a single descriptor, or an array of them for a component
+ * that owns several sub-sections (e.g. page positions in one PageContentsManage).
+ */
+export declare type UnsavedSectionSource = () => UnsavedSectionDescriptor | UnsavedSectionDescriptor[];
+
 declare type UnsavedSource = Ref<boolean | Set<unknown> | unknown[] | null | undefined>;
 
 declare type UrlParams = {
@@ -1859,6 +1880,13 @@ export declare function useUnsavedChangesGuard(options: UseUnsavedChangesGuardOp
 
 declare interface UseUnsavedChangesGuardApi {
     hasUnsavedChanges: ComputedRef<boolean>;
+    /**
+     * Labels of the dirty sections registered by descendants via
+     * `useUnsavedSection`. Bind to `AUnsavedConfirmDialog`'s `dirtyLabels` prop
+     * so the dialog names *which* parts are unsaved. Empty when no descendant
+     * registered a section (dialog falls back to the generic message).
+     */
+    dirtyLabels: ComputedRef<string[]>;
     /**
      * v-model-bound to the confirm dialog. When the guard wants to ask the user
      * to confirm leaving, it sets this to true. The confirm dialog reads it.
@@ -1900,8 +1928,25 @@ declare interface UseUnsavedChangesGuardOptions {
      * confirms via the confirm dialog or via `acknowledge()`.
      */
     guardDialogModel?: Ref<boolean>;
+    /**
+     * Named sections owned by the guard host component itself. Descendants use
+     * `useUnsavedSection` instead — but a component can't `inject` its own
+     * `provide`, so when the host *is* the section owner (e.g. a dialog), pass
+     * the sections here.
+     */
+    ownSections?: UnsavedSectionSource;
 }
 
+/**
+ * Registers one or more named sections so the unsaved-changes confirm dialog
+ * can tell the user *which* parts are dirty instead of a generic message.
+ *
+ * Pass a getter returning a descriptor — or an array of descriptors when the
+ * component owns several sub-sections (e.g. one PageContentsManage owns N page
+ * positions). No-op when called outside a guarded route (inject returns null).
+ */
+export declare function useUnsavedSection(source: UnsavedSectionSource): void;
+
 export declare function useUserAdminConfigApi(client: () => AxiosInstance, system: string, entity?: string, endPoint?: string): {
     useFetchUserAdminConfigList: () => UseApiFetchListReturnType<UserAdminConfig< UserAdminConfigDataFilterBookmark | UserAdminConfigDataPinnedWidgets<string>>[]>;
     fetchUserAdminConfig: (id: IntegerId) => Promise<UserAdminConfig< UserAdminConfigDataFilterBookmark | UserAdminConfigDataPinnedWidgets<string>>>;