@topconsultnpm/sdkui-react 6.22.0-dev3.8 → 6.22.0-dev4.10

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

@@ -0,0 +1,32 @@
+import type { RelationTreeItem } from './TMRelationViewer';
+/**
+ * Conserva lo stato di un albero delle correlazioni (nodi espansi e fuoco) attraverso
+ * un refresh che ricarica i dati da zero. I nodi non sono confrontabili per `key`, che
+ * contiene un GUID rigenerato ad ogni caricamento: si usa un percorso costruito sui campi.
+ */
+export interface RelationTreeState {
+    /** Documenti di input a cui lo stato si riferisce: non va applicato ad altri */
+    inputKey: string;
+    expandedPaths: string[];
+    /**
+     * Documenti espansi che avevano già i figli caricati. Quelli espansi ma vuoti
+     * (es. il root) non vanno ricaricati: mostrerebbero più di quanto c'era prima.
+     */
+    loadedPaths: string[];
+    focusedPath?: string;
+}
+/** Carica i figli di un documento durante il ripristino. */
+export type LoadChildrenFn = (node: RelationTreeItem) => Promise<RelationTreeItem[]>;
+/**
+ * Fotografa lo stato dell'albero.
+ * `previousFocusedPath` viene usato quando il fuoco è già stato azzerato dall'esterno.
+ */
+export declare const collectRelationTreeState: (nodes: RelationTreeItem[], inputKey: string, focusedKey: string | undefined, previousFocusedPath?: string) => RelationTreeState;
+/**
+ * Riapplica lo stato all'albero appena caricato. I nodi che non compaiono nello stato,
+ * o che non esistono più (es. documento cancellato), restano chiusi: il confronto per
+ * percorso è tollerante per costruzione.
+ */
+export declare const applyRelationTreeState: (nodes: RelationTreeItem[], state: RelationTreeState, loadChildren: LoadChildrenFn, isAborted: () => boolean) => Promise<RelationTreeItem[]>;
+/** Cerca un nodo per percorso, per rimettere il fuoco dov'era. */
+export declare const findRelationNodeByPath: (nodes: RelationTreeItem[], path: string) => RelationTreeItem | null;

package/lib/components/features/documents/relationTreeState.js

@@ -0,0 +1,89 @@
+/** I nodi generati (messaggi informativi, separatori) non hanno identità stabile. */
+const hasStableIdentity = (node) => !node.isInfoMessage && !node.isSeparator;
+const getNodeIdentity = (node) => node.isDcmt
+    ? `d:${node.tid ?? ''}:${node.did ?? ''}:${node.relationId ?? ''}`
+    : `c:${node.tid ?? ''}:${node.relationId ?? ''}:${node.name ?? ''}`;
+/** Il percorso include i padri: lo stesso documento può comparire sotto padri diversi. */
+const getNodePath = (node, parentPath) => {
+    const identity = getNodeIdentity(node);
+    return parentPath ? `${parentPath}>${identity}` : identity;
+};
+/**
+ * Fotografa lo stato dell'albero.
+ * `previousFocusedPath` viene usato quando il fuoco è già stato azzerato dall'esterno.
+ */
+export const collectRelationTreeState = (nodes, inputKey, focusedKey, previousFocusedPath) => {
+    const expandedPaths = [];
+    const loadedPaths = [];
+    let focusedPath;
+    const collect = (items, parentPath) => {
+        for (const node of items) {
+            if (!hasStableIdentity(node))
+                continue;
+            const path = getNodePath(node, parentPath);
+            if (node.expanded)
+                expandedPaths.push(path);
+            if (node.expanded && node.isDcmt && node.items)
+                loadedPaths.push(path);
+            // Entro la stessa istanza montata la key è univoca
+            if (focusedKey && node.key === focusedKey)
+                focusedPath = path;
+            if (node.items)
+                collect(node.items, path);
+        }
+    };
+    collect(nodes, '');
+    return { inputKey, expandedPaths, loadedPaths, focusedPath: focusedPath ?? previousFocusedPath };
+};
+/**
+ * Riapplica lo stato all'albero appena caricato. I nodi che non compaiono nello stato,
+ * o che non esistono più (es. documento cancellato), restano chiusi: il confronto per
+ * percorso è tollerante per costruzione.
+ */
+export const applyRelationTreeState = async (nodes, state, loadChildren, isAborted) => {
+    const expandedPaths = new Set(state.expandedPaths);
+    const loadedPaths = new Set(state.loadedPaths);
+    const apply = async (items, parentPath) => {
+        const result = [];
+        for (const node of items) {
+            if (!hasStableIdentity(node)) {
+                result.push(node);
+                continue;
+            }
+            const path = getNodePath(node, parentPath);
+            const wasExpanded = expandedPaths.has(path);
+            let children = node.items;
+            let isLoaded = node.isLoaded;
+            let itemsCount = node.itemsCount;
+            // I figli dei documenti sono lazy: vanno ricaricati se l'utente li aveva aperti
+            if (wasExpanded && node.isDcmt && !children && loadedPaths.has(path) && !isAborted()) {
+                children = await loadChildren(node);
+                isLoaded = true;
+                itemsCount = children.length;
+            }
+            const updatedItems = children ? await apply(children, path) : children;
+            result.push({ ...node, expanded: wasExpanded, items: updatedItems, isLoaded, itemsCount });
+        }
+        return result;
+    };
+    return await apply(nodes, '');
+};
+/** Cerca un nodo per percorso, per rimettere il fuoco dov'era. */
+export const findRelationNodeByPath = (nodes, path) => {
+    const find = (items, parentPath) => {
+        for (const node of items) {
+            if (!hasStableIdentity(node))
+                continue;
+            const currentPath = getNodePath(node, parentPath);
+            if (currentPath === path)
+                return node;
+            if (node.items) {
+                const found = find(node.items, currentPath);
+                if (found)
+                    return found;
+            }
+        }
+        return null;
+    };
+    return find(nodes, '');
+};

package/lib/components/features/search/TMDcmtCheckoutInfoForm.d.ts

@@ -1,9 +1,8 @@
-import React from "react";
 import { DcmtInfo } from "../../../ts";
 interface TMDcmtCheckoutInfoFormProps {
     dtdName: string;
     selectedDcmtOrFocused: DcmtInfo;
     onClose: () => void;
 }
-declare const TMDcmtCheckoutInfoForm: (props: TMDcmtCheckoutInfoFormProps) => React.JSX.Element;
+declare const TMDcmtCheckoutInfoForm: (props: TMDcmtCheckoutInfoFormProps) => import("react/jsx-runtime").JSX.Element;
 export default TMDcmtCheckoutInfoForm;

package/lib/components/features/search/TMMetadataOutputForm.d.ts

@@ -1,4 +1,3 @@
-import React from "react";
 import { MetadataDescriptor, QueryDescriptor, SelectItem } from "@topconsultnpm/sdk-ts";
 interface TMMetadataOutputFormProps {
     /** QueryDescriptor da cui estrarre i metadati disponibili */
@@ -14,5 +13,5 @@ interface TMMetadataOutputFormProps {
     /** Callback chiamata quando l'utente conferma la selezione dei SelectItem */
     onChoose?: (selectItems: SelectItem[] | undefined) => void;
 }
-declare const TMMetadataOutputForm: (props: TMMetadataOutputFormProps) => React.JSX.Element;
+declare const TMMetadataOutputForm: (props: TMMetadataOutputFormProps) => import("react/jsx-runtime").JSX.Element;
 export default TMMetadataOutputForm;

package/lib/components/features/search/TMMetadataSorterForm.d.ts

@@ -1,4 +1,3 @@
-import React from "react";
 import { MetadataDescriptor, OrderByItem, QueryDescriptor } from "@topconsultnpm/sdk-ts";
 interface TMMetadataSorterFormProps {
     /** QueryDescriptor da cui estrarre i metadati disponibili */
@@ -14,5 +13,5 @@ interface TMMetadataSorterFormProps {
     /** Callback chiamata quando l'utente conferma la selezione degli OrderByItem */
     onChoose?: (orderByItems: OrderByItem[] | undefined) => void;
 }
-declare const TMMetadataSorterForm: (props: TMMetadataSorterFormProps) => React.JSX.Element;
+declare const TMMetadataSorterForm: (props: TMMetadataSorterFormProps) => import("react/jsx-runtime").JSX.Element;
 export default TMMetadataSorterForm;

package/lib/components/features/search/TMSavedQuerySelector.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
 import { SavedQueryDescriptor } from '@topconsultnpm/sdk-ts';
-export declare const getTooltipBySqd: (sqd: SavedQueryDescriptor | undefined) => React.JSX.Element | null;
+export declare const getTooltipBySqd: (sqd: SavedQueryDescriptor | undefined) => import("react/jsx-runtime").JSX.Element | null;
 interface ITMSavedQuerySelectorProps {
     height?: string;
     items?: SavedQueryDescriptor[];
@@ -12,5 +12,5 @@ interface ITMSavedQuerySelectorProps {
     refreshFavoriteSavedQueries?: (sqd: SavedQueryDescriptor) => void;
     onRefreshData?: () => void;
 }
-declare const TMSavedQuerySelector: React.MemoExoticComponent<({ items, selectedId, allowShowSearch, height, manageDefault, onItemClick, onDeleted, refreshFavoriteSavedQueries, onRefreshData }: ITMSavedQuerySelectorProps) => React.JSX.Element>;
+declare const TMSavedQuerySelector: React.MemoExoticComponent<({ items, selectedId, allowShowSearch, height, manageDefault, onItemClick, onDeleted, refreshFavoriteSavedQueries, onRefreshData }: ITMSavedQuerySelectorProps) => import("react/jsx-runtime").JSX.Element>;
 export default TMSavedQuerySelector;

package/lib/components/features/search/TMSearch.d.ts

@@ -1,4 +1,3 @@
-import React from 'react';
 import { SavedQueryDescriptor, DcmtTypeDescriptor, TaskDescriptor, ObjectRef, HomeBlogPost } from '@topconsultnpm/sdk-ts';
 import { IntesiCertificateData } from '../../../helper';
 import { DcmtInfo, IGraphometricManagerProp, TaskContext } from '../../../ts';
@@ -46,5 +45,5 @@ interface ITMSearchProps {
     fetchRemoteCertificates?: (email: string) => Promise<IntesiCertificateData[]>;
     graphometricManager?: IGraphometricManagerProp;
 }
-declare const TMSearch: (props: ITMSearchProps) => React.JSX.Element;
+declare const TMSearch: (props: ITMSearchProps) => import("react/jsx-runtime").JSX.Element;
 export default TMSearch;

package/lib/components/features/search/TMSearch.js

@@ -369,7 +369,6 @@ const TMSearchInstance = ({ allTasks = [], getAllTasks, deleteTaskByIdsCallback,
                 : _jsx(StyledMultiViewPanel, { $isVisible: currentSearchView === TMSearchViews.Search, children: _jsx(TMPanelManagerWithPersistenceProvider, { panels: initialPanels, initialVisibility: allInitialPanelVisibility, defaultDimensions: initialPanelDimensions, initialDimensions: initialPanelDimensions, initialMobilePanelId: 'TMRecentsManager', isPersistenceEnabled: !isMobile ? hasSavedLayout() : false, persistPanelStates: !isMobile ? (state) => persistPanelStates(state) : undefined, persistedPanelStates: getPersistedPanelStates(), children: _jsx(TMPanelManagerContainer, { panels: initialPanels, direction: "horizontal", showToolbar: true, minPanelSizePx: !isMobile ? 250 : 150 }) }) }), showSearchResults && _jsx(TMSearchResult, { isVisible: isVisible && currentSearchView === TMSearchViews.Result, context: SearchResultContext.METADATA_SEARCH, searchResults: searchResult, floatingActionConfig: floatingActionConfig, onRefreshAfterAddDcmtToFavs: onRefreshAfterAddDcmtToFavs, openInOffice: openInOffice, onRefreshSearchAsyncDatagrid: onRefreshSearchAsyncDatagrid, onClose: () => { if (onlyShowSearchQueryPanel)
                     setShowSearchResults(false); setCurrentSearchView(TMSearchViews.Search); }, backCaption: onlyShowSearchQueryPanel ? SDKUI_Localizator.BackToSearch : undefined, onFileOpened: onFileOpened, onTaskCreateRequest: onTaskCreateRequest, openWGsCopyMoveForm: openWGsCopyMoveForm, editPdfForm: editPdfForm, onOpenPdfEditorRequest: onOpenPdfEditorRequest, openS4TViewer: openS4TViewer, onOpenS4TViewerRequest: onOpenS4TViewerRequest, openFileUploaderPdfEditor: openFileUploaderPdfEditor, passToArchiveCallback: passToArchiveCallback, onSelectedTIDChanged: onCurrentTIDChangedCallback, showTodoDcmtForm: showTodoDcmtForm, showToppyDraggableHelpCenter: showToppyDraggableHelpCenter, toppyHelpCenterUsePortal: toppyHelpCenterUsePortal, onReferenceClick: onReferenceClick, allTasks: allTasks, getAllTasks: getAllTasks, deleteTaskByIdsCallback: deleteTaskByIdsCallback, addTaskCallback: addTaskCallback, editTaskCallback: editTaskCallback, handleNavigateToWGs: handleNavigateToWGs, handleNavigateToDossiers: handleNavigateToDossiers, inputDID: inputDID, formAutoOpen: formAutoOpen, fetchRemoteCertificates: fetchRemoteCertificates, graphometricManager: graphometricManager })] }));
 };
-const ENABLE_SEARCH_TABS = false;
 // Ogni tab e' un TMSearch completo e indipendente: TMTabControl li tiene tutti montati, cosi piu ricerche
 // restano vive insieme, ognuna con i suoi tipi documento, i suoi filtri e i suoi risultati.
 const TMSearch = (props) => {
@@ -394,9 +393,9 @@ const TMSearch = (props) => {
     // quel momento: gli altri restano sulla ricerca che stanno svolgendo.
     const [inputsTabId, setInputsTabId] = useState(tabs.activeId);
     useEffect(() => { setInputsTabId(activeIdRef.current); }, [inputTID, inputSqdID, inputDID]);
-    // Nella modalita a solo pannello di ricerca (es. abbinamento molti a molti) i tab non servono,
-    // cosi come non servono finche' i tab non vengono rilasciati
-    if (!ENABLE_SEARCH_TABS || onlyShowSearchQueryPanel)
+    // Con onlyShowSearchQueryPanel (es. abbinamento molti a molti) si mostra solo il pannello di ricerca
+    // di una singola istanza, senza tab: la multi ricerca non serve in quel contesto
+    if (onlyShowSearchQueryPanel)
         return _jsx(TMSearchInstance, { ...props });
     return (_jsx(TMTabControl, { ...tabs.controlProps, contentAnimation: 'none', onTabRename: undefined, variant: 'module', style: { height: '100%', width: '100%' }, contentStyle: { display: 'flex', flex: 1, minHeight: 0, position: 'relative' }, children: tabs.items.map(t => {
             const isActiveTab = t.id === tabs.activeId;

package/lib/components/features/search/TMSearchQueryPanel.d.ts

@@ -29,12 +29,6 @@ interface ITMSearchQueryPanelProps {
 declare const TMSearchQueryPanel: React.FunctionComponent<ITMSearchQueryPanelProps>;
 export default TMSearchQueryPanel;
 export declare const refreshLastSearch: (qd: QueryDescriptor | undefined) => Promise<SearchResultDescriptor[] | undefined>;
-export declare const StyledToppyTextContainer: import("styled-components/dist/types").IStyledComponentBase<"web", Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "style"> & {
-    style?: React.CSSProperties | import("styled-components/dist/types").CSSPropertiesWithVars | undefined;
-}> & string;
-export declare const StyledToppyText: import("styled-components/dist/types").IStyledComponentBase<"web", Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLParagraphElement>, HTMLParagraphElement>, "style"> & {
-    style?: React.CSSProperties | import("styled-components/dist/types").CSSPropertiesWithVars | undefined;
-}> & string;
-export declare const StyledToppyImage: import("styled-components/dist/types").IStyledComponentBase<"web", Omit<React.DetailedHTMLProps<React.ImgHTMLAttributes<HTMLImageElement>, HTMLImageElement>, "style"> & {
-    style?: React.CSSProperties | import("styled-components/dist/types").CSSPropertiesWithVars | undefined;
-}> & string;
+export declare const StyledToppyTextContainer: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never> & Partial<Pick<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>>> & string;
+export declare const StyledToppyText: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLParagraphElement>, HTMLParagraphElement>, never> & Partial<Pick<React.DetailedHTMLProps<React.HTMLAttributes<HTMLParagraphElement>, HTMLParagraphElement>, never>>> & string;
+export declare const StyledToppyImage: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<React.DetailedHTMLProps<React.ImgHTMLAttributes<HTMLImageElement>, HTMLImageElement>, never> & Partial<Pick<React.DetailedHTMLProps<React.ImgHTMLAttributes<HTMLImageElement>, HTMLImageElement>, never>>> & string;

package/lib/components/features/search/TMSearchQueryPanel.js

@@ -515,7 +515,6 @@ export const refreshLastSearch = async (qd) => {
         return;
     let searchResults = [];
     try {
-        TMSpinner.show({ description: `${SDKUI_Localizator.Search} ...`, backgroundColor: 'transparent' });
         let result = await SDK_Globals.tmSession?.NewSearchEngine().SearchByIDAsync(qd);
         let dcmtsFound = result?.dcmtsFound ?? 0;
         if (dcmtsFound <= 0)
@@ -526,9 +525,6 @@ export const refreshLastSearch = async (qd) => {
     catch (ex) {
         TMExceptionBoxManager.show({ title: SDKUI_Localizator.Search, exception: ex });
     }
-    finally {
-        TMSpinner.hide();
-    }
     return searchResults;
 };
 // =============================================================================

package/lib/components/features/search/TMSearchResult.d.ts

@@ -23,6 +23,11 @@ interface ITMSearchResultProps {
     openDcmtFormAsModal?: boolean;
     showSearchResultSidebar?: boolean;
     showDcmtFormSidebar?: boolean;
+    /** Mostra accanto alla griglia il selettore dei tipi documento trovati:
+     * su desktop sono affiancati (30/70),
+     * su mobile si naviga a step tra selettore e risultati.
+     * Se il risultato ha un solo tipo documento il selettore resta chiuso
+     * e lo spazio va tutto alla griglia, riapribile dal menu "Altro" */
     showSelector?: boolean;
     showToolbarHeader?: boolean;
     showBackButton?: boolean;