@topconsultnpm/sdkui-react 6.22.0-t1 → 6.22.0-t3

package/lib/components/features/documents/TMRelationViewer.d.ts

@@ -1,8 +1,9 @@
 import React from 'react';
 import { DcmtTypeDescriptor, SearchResultDescriptor, DataColumnDescriptor } from "@topconsultnpm/sdk-ts";
 import { DcmtMetadataMap } from '../../../helper';
-import { DcmtInfo, MetadataValueDescriptorEx } from '../../../ts';
+import { DcmtInfo } from '../../../ts';
 import { ITMTreeItem } from '../../base/TMTreeView';
+import { RelationTreeState } from './relationTreeState';
 /**
  * Tree item structure for relations
  */
@@ -26,6 +27,7 @@ export interface RelationTreeItem extends ITMTreeItem {
     fileExt?: string;
     fileCount?: number;
 }
+export type { RelationTreeState } from './relationTreeState';
 /**
  * Props for TMRelationViewer component
  */
@@ -111,11 +113,6 @@ export interface TMRelationViewerProps {
      * Use to show a context menu.
      */
     onItemContextMenu?: (item: RelationTreeItem, e: React.MouseEvent) => void;
-    /**
-     * Metadata values for the focused item
-     * (used in master-detail context)
-     */
-    focusedItemFormData?: MetadataValueDescriptorEx[];
     /**
      * If true, shows a toolbar button to expand/collapse all tree nodes.
      * Default: false
@@ -132,6 +129,28 @@ export interface TMRelationViewerProps {
      * Useful to disable interactions (like context menu) during loading.
      */
     onLoadingStateChanged?: (isLoading: boolean) => void;
+    /**
+     * Invoked on mount to hand over a function that stops the ongoing correlations
+     * calculation: no further GetMetadata calls are performed and only the
+     * correlations already calculated are kept.
+     * The function is synchronous, so it can be safely called right before
+     * unmounting the viewer (e.g. when navigating back).
+     */
+    onStopCalculationReady?: (stopCalculation: () => void) => void;
+    /**
+     * Callback invoked when the calculation has actually been stopped
+     * (loadData terminated after an abort request).
+     * Riceve quanti documenti di input sono stati completati sul totale.
+     */
+    onCalculationStopped?: (loadedCount: number, totalCount: number) => void;
+    /**
+     * Stato dell'albero da ripristinare al primo caricamento, al posto dell'espansione
+     * iniziale predefinita: permette al padre di rimontare il viewer dopo un'operazione
+     * senza che l'albero torni allo stato di partenza. Se assente vale il default.
+     */
+    initialTreeState?: RelationTreeState;
+    /** Notifica lo stato dell'albero, da restituire come `initialTreeState` dopo un refresh. */
+    onTreeStateChange?: (state: RelationTreeState) => void;
 }
 /**
  * Check if document type has detail relations
@@ -147,10 +166,11 @@ export declare const hasMasterRelations: (dTID: number | undefined) => Promise<b
 export declare const getDisplayValueByColumn: (col: DataColumnDescriptor | undefined, value: any) => any;
 /**
  * Convert SearchResultDescriptor to structured data source with metadata
- * For each document, fetches complete metadata using GetMetadataAsync to ensure
- * all metadata properties (isSpecialSearchOutput, permissions, etc.) are available
+ * I valori dei documenti sono già presenti nelle righe restituite dalla ricerca:
+ * qui vengono solo abbinati ai rispettivi MetadataDescriptor (perm,
+ * isSpecialSearchOutput, ...), risolti una sola volta per tipo documento.
  */
-export declare const searchResultToDataSource: (searchResult: SearchResultDescriptor | undefined, hideSysMetadata?: boolean) => Promise<any[]>;
+export declare const searchResultToDataSource: (searchResult: SearchResultDescriptor | undefined, hideSysMetadata?: boolean, signal?: AbortSignal) => Promise<any[]>;
 export declare const DEFAULT_RELATION_EXPAND_LEVEL = 4;
 declare const TMRelationViewer: React.FC<TMRelationViewerProps>;
 export default TMRelationViewer;