@topconsultnpm/sdkui-react 6.21.0-dev2.29 → 6.21.0-dev2.30

package/lib/components/base/TMDataGrid.js

@@ -22,7 +22,7 @@ const TMDataGrid = React.forwardRef((props, ref) => {
     // events and callbacks
     onSelectionChanged, onFocusedRowChanged, onRowDblClick, onRowClick, onCellClick, onCellDblClick, onOptionChanged, onContentReady, onContextMenuPreparing, onInitialized, onEditorPreparing, onCellPrepared, onRowPrepared, onRowUpdating, onRowExpanded, onRowCollapsed, onRowUpdated, onSaved, onEditCanceled, onEditingStart, onEditingChange, customizeColumns, onKeyDown, scrolling = { mode: 'standard', useNative: SDKUI_Globals.userSettings?.themeSettings.gridSettings.useNativeScrollbar === 1 }, paging = { enabled: true, pageSize: pageSize }, pager = { visible: true, showInfo: true, showNavigationButtons: true }, selection = { mode: 'multiple', showCheckBoxesMode: "always", selectAllMode: "allPages" }, sorting, summary, stateStoring, grouping, groupPanel, filterRow, headerFilter, editing, rowDragging, masterDetail, 
     // other properties
-    disabled = false, autoNavigateToFocusedRow = true, columnResizingMode = 'widget', columnHidingEnabled = true, columnAutoWidth = true, allowColumnResizing = true, allowColumnReordering = true, showBorders = true, showRowLines = SDKUI_Globals.userSettings?.themeSettings.gridSettings.showRowLines === 1, showColumnLines = SDKUI_Globals.userSettings?.themeSettings.gridSettings.showColumnLines === 1, showColumnHeaders = true, rowAlternationEnabled = false, wordWrapEnabled = false, noDataText, 
+    disabled = false, autoNavigateToFocusedRow = true, columnResizingMode = 'widget', columnHidingEnabled = true, columnAutoWidth = true, allowColumnResizing = true, allowColumnReordering = true, showBorders = true, showRowLines = SDKUI_Globals.userSettings?.themeSettings.gridSettings.showRowLines === 1, showColumnLines = SDKUI_Globals.userSettings?.themeSettings.gridSettings.showColumnLines === 1, showColumnHeaders = true, rowAlternationEnabled = false, wordWrapEnabled = false, noDataText, columnMinWidth, 
     // styles
     id, width = '100%', height = '100%', } = props;
     const internalRef = React.useRef(null);
@@ -354,7 +354,7 @@ const TMDataGrid = React.forwardRef((props, ref) => {
                     // events and callbacks
                     onSelectionChanged: onSelectionChangedCallback, onRowDblClick: onRowDblClickCallback, onRowPrepared: onRowPrepared, onContextMenuPreparing: onContextMenuPreparingCallback, onToolbarPreparing: onToolbarPreparingCallback, onFocusedRowChanged: onFocusedRowChanged, onRowClick: onRowClick, onCellClick: onCellClick, onCellDblClick: onCellDblClick, onOptionChanged: onOptionChangedCallback, onContentReady: onContentReadyCallback, onInitialized: onInitialized, customizeColumns: customizeColumns, onEditorPreparing: onEditorPreparing, onCellPrepared: onCellPrepared, onRowUpdating: onRowUpdating, onRowExpanded: onRowExpanded, onRowCollapsed: onRowCollapsed, onRowUpdated: onRowUpdated, onSaved: onSaved, onEditCanceled: onEditCanceled, onEditingStart: onEditingStart, onEditingChange: onEditingChange, onKeyDown: onKeyDown, 
                     // other properties
-                    disabled: disabled, autoNavigateToFocusedRow: autoNavigateToFocusedRow, focusedRowKey: focusedRowKey, columnHidingEnabled: columnHidingEnabled, columnResizingMode: columnResizingMode, columnAutoWidth: columnAutoWidth, allowColumnResizing: allowColumnResizing, allowColumnReordering: allowColumnReordering, showBorders: showBorders, showRowLines: showRowLines, showColumnLines: showColumnLines, showColumnHeaders: showColumnHeaders, rowAlternationEnabled: rowAlternationEnabled, wordWrapEnabled: wordWrapEnabled, noDataText: noDataText, 
+                    disabled: disabled, autoNavigateToFocusedRow: autoNavigateToFocusedRow, focusedRowKey: focusedRowKey, columnHidingEnabled: columnHidingEnabled, columnResizingMode: columnResizingMode, columnAutoWidth: columnAutoWidth, allowColumnResizing: allowColumnResizing, allowColumnReordering: allowColumnReordering, showBorders: showBorders, showRowLines: showRowLines, showColumnLines: showColumnLines, showColumnHeaders: showColumnHeaders, rowAlternationEnabled: rowAlternationEnabled, wordWrapEnabled: wordWrapEnabled, columnMinWidth: columnMinWidth, noDataText: noDataText, 
                     // styles
                     width: width, height: height, style: {
                         userSelect: 'none',

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

@@ -0,0 +1,70 @@
+export declare const DEFAULT_SIGNATURE_TID = -1;
+export type SignatureMethodCode = 'T' | 'D' | 'U';
+export interface SignatureEntry {
+    /** TID del tipo documento associato alla firma (-1 = firma di default globale) */
+    tid: number;
+    /** Immagine della firma in formato base64 (data URL) */
+    imgSign: string;
+    /** Metodo utilizzato: 'T' = Testo, 'D' = Disegno, 'U' = Upload */
+    method: SignatureMethodCode;
+    /** Testo utilizzato per generare la firma (solo per method='T') */
+    signText?: string;
+}
+export interface SignatureResult {
+    /** Immagine della firma in formato base64 (data URL) */
+    imgSign: string;
+    /** true se è stata usata la firma di default (tid = -1) */
+    isDefault: boolean;
+    /** TID effettivo della firma trovata */
+    sourceTid: number;
+    /** Metodo utilizzato: 'T' = Testo, 'D' = Disegno, 'U' = Upload */
+    method: SignatureMethodCode;
+    /** Testo utilizzato per generare la firma (solo per method='T') */
+    signText?: string;
+}
+/**
+ * Classe helper per gestire le firme predefinite salvate come JSON array.
+ * Centralizza tutte le operazioni di lettura/scrittura/eliminazione.
+ */
+export declare class SignatureParamsManager {
+    private static cache;
+    /**
+     * Svuota la cache locale. Utile per forzare un refresh dei dati.
+     */
+    static clearCache(): void;
+    /**
+     * Recupera tutte le firme salvate (usa cache locale se disponibile)
+     */
+    static getAll(): Promise<SignatureEntry[]>;
+    /**
+     * Recupera la firma per un TID specifico (senza fallback).
+     * Restituisce solo la firma associata al TID richiesto, o undefined se non esiste.
+     */
+    static getByTid(tid: number): Promise<SignatureResult | undefined>;
+    /**
+     * Recupera la firma per un TID specifico con fallback alla firma di default.
+     * Se non trova la firma per il TID specifico, prova con la firma di default (tid = -1).
+     * Se non esiste neanche quella, restituisce undefined.
+     * Restituisce anche l'informazione se è stata usata la firma di default.
+     */
+    static getByTidWithFallback(tid: number): Promise<SignatureResult | undefined>;
+    /**
+     * Salva la firma di default valida per tutti i tipi documento (tid = 0)
+     * @param imgSign Immagine firma in base64
+     * @param method Metodo utilizzato per creare la firma
+     * @param signText Testo utilizzato per generare la firma (solo per method='T')
+     */
+    static saveDefault(imgSign: string, method: SignatureMethodCode, signText?: string): Promise<void>;
+    /**
+     * Salva o aggiorna la firma per un TID specifico
+     * @param tid ID del tipo documento
+     * @param imgSign Immagine firma in base64
+     * @param method Metodo utilizzato per creare la firma
+     * @param signText Testo utilizzato per generare la firma (solo per method='T')
+     */
+    static save(tid: number, imgSign: string, method: SignatureMethodCode, signText?: string): Promise<void>;
+    /**
+     * Elimina la firma per un TID specifico
+     */
+    static delete(tid: number): Promise<void>;
+}

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

@@ -0,0 +1,145 @@
+import { SDK_Globals } from "@topconsultnpm/sdk-ts";
+const SIGNATURE_PARAM_KEY = 'signParams'; // Chiave unica parametro per tutte le firme predefinite (JSON array)
+export const DEFAULT_SIGNATURE_TID = -1; // TID speciale per firma di default valida per tutti i tipi documento
+/**
+ * Classe helper per gestire le firme predefinite salvate come JSON array.
+ * Centralizza tutte le operazioni di lettura/scrittura/eliminazione.
+ */
+export class SignatureParamsManager {
+    /**
+     * Svuota la cache locale. Utile per forzare un refresh dei dati.
+     */
+    static clearCache() {
+        this.cache = null;
+    }
+    /**
+     * Recupera tutte le firme salvate (usa cache locale se disponibile)
+     */
+    static async getAll() {
+        // Se la cache è valorizzata, restituisci direttamente
+        if (this.cache !== null) {
+            return this.cache;
+        }
+        const jsonValue = await SDK_Globals.tmSession?.NewUserEngine().ParamGetAsync(SIGNATURE_PARAM_KEY);
+        if (!jsonValue || jsonValue === '') {
+            this.cache = [];
+            return this.cache;
+        }
+        try {
+            this.cache = JSON.parse(jsonValue);
+            return this.cache;
+        }
+        catch {
+            console.warn('Errore parsing JSON firme, formato non valido');
+            this.cache = [];
+            return this.cache;
+        }
+    }
+    /**
+     * Recupera la firma per un TID specifico (senza fallback).
+     * Restituisce solo la firma associata al TID richiesto, o undefined se non esiste.
+     */
+    static async getByTid(tid) {
+        const signatures = await this.getAll();
+        const entry = signatures.find(s => s.tid.toString() === tid.toString());
+        if (entry?.imgSign) {
+            return {
+                imgSign: entry.imgSign,
+                isDefault: tid.toString() === DEFAULT_SIGNATURE_TID.toString(),
+                sourceTid: tid,
+                method: entry.method,
+                signText: entry.signText
+            };
+        }
+        return undefined;
+    }
+    /**
+     * Recupera la firma per un TID specifico con fallback alla firma di default.
+     * Se non trova la firma per il TID specifico, prova con la firma di default (tid = -1).
+     * Se non esiste neanche quella, restituisce undefined.
+     * Restituisce anche l'informazione se è stata usata la firma di default.
+     */
+    static async getByTidWithFallback(tid) {
+        // Prima cerca la firma per il TID specifico
+        const specificResult = await this.getByTid(tid);
+        if (specificResult) {
+            return specificResult;
+        }
+        // Se non trova e il tid richiesto non è già il default, cerca la firma di default (tid = -1)
+        if (tid.toString() !== DEFAULT_SIGNATURE_TID.toString()) {
+            const defaultResult = await this.getByTid(DEFAULT_SIGNATURE_TID);
+            if (defaultResult) {
+                return {
+                    ...defaultResult,
+                    isDefault: true
+                };
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Salva la firma di default valida per tutti i tipi documento (tid = 0)
+     * @param imgSign Immagine firma in base64
+     * @param method Metodo utilizzato per creare la firma
+     * @param signText Testo utilizzato per generare la firma (solo per method='T')
+     */
+    static async saveDefault(imgSign, method, signText) {
+        await this.save(DEFAULT_SIGNATURE_TID, imgSign, method, signText);
+    }
+    /**
+     * Salva o aggiorna la firma per un TID specifico
+     * @param tid ID del tipo documento
+     * @param imgSign Immagine firma in base64
+     * @param method Metodo utilizzato per creare la firma
+     * @param signText Testo utilizzato per generare la firma (solo per method='T')
+     */
+    static async save(tid, imgSign, method, signText) {
+        const signatures = await this.getAll();
+        const existingIndex = signatures.findIndex(s => s.tid.toString() === tid.toString());
+        // Il testo della firma (signText) viene salvato SOLO quando:
+        // 1. Il metodo di creazione è 'T' (TextEditor) 
+        // 2. Il testo esiste ed è valorizzato
+        // Per i metodi 'D' (Disegno) e 'U' (Upload) il campo signText non viene mai salvato
+        const shouldSaveText = method === 'T' && signText;
+        // Pattern UPSERT: aggiorna se esiste, altrimenti crea nuova entry
+        if (existingIndex >= 0) {
+            // Aggiorna una firma esistente
+            signatures[existingIndex].imgSign = imgSign;
+            signatures[existingIndex].method = method;
+            if (shouldSaveText) {
+                // Salva il testo solo per metodo 'T' con testo valorizzato
+                signatures[existingIndex].signText = signText;
+            }
+            else {
+                // Rimuove signText se presente (es. cambio da 'T' a 'D' o 'U')
+                delete signatures[existingIndex].signText;
+            }
+        }
+        else {
+            // Crea una nuova entry senza includere signText di default
+            const entry = { tid, imgSign, method };
+            if (shouldSaveText) {
+                // Aggiunge signText solo se necessario
+                entry.signText = signText;
+            }
+            signatures.push(entry);
+        }
+        await SDK_Globals.tmSession?.NewUserEngine().ParamSetAsync(SIGNATURE_PARAM_KEY, JSON.stringify(signatures));
+        // Aggiorna la cache dopo il salvataggio
+        this.clearCache();
+        await this.getAll();
+    }
+    /**
+     * Elimina la firma per un TID specifico
+     */
+    static async delete(tid) {
+        const signatures = await this.getAll();
+        const filtered = signatures.filter(s => s.tid.toString() !== tid.toString());
+        await SDK_Globals.tmSession?.NewUserEngine().ParamSetAsync(SIGNATURE_PARAM_KEY, JSON.stringify(filtered));
+        // Aggiorna la cache dopo l'eliminazione
+        this.clearCache();
+        await this.getAll();
+    }
+}
+// Cache locale per evitare chiamate ripetute
+SignatureParamsManager.cache = null;

package/lib/components/index.d.ts

@@ -71,6 +71,7 @@ export * from './features/documents/TMRelationViewer';
 export * from './features/archive/TMArchive';
 export * from './features/search/TMSearch';
 export * from './features/search/TMSearchResult';
+export * from './features/search/SignatureParamsManager';
 export { default as TMTaskForm } from './features/tasks/TMTaskForm';
 export { default as TMTasksAgenda } from './features/tasks/TMTasksAgenda';
 export { default as TMTasksCalendar } from './features/tasks/TMTasksCalendar';

package/lib/components/index.js

@@ -81,6 +81,7 @@ export * from './features/archive/TMArchive';
 //search
 export * from './features/search/TMSearch';
 export * from './features/search/TMSearchResult';
+export * from './features/search/SignatureParamsManager';
 // tasks
 export { default as TMTaskForm } from './features/tasks/TMTaskForm';
 export { default as TMTasksAgenda } from './features/tasks/TMTasksAgenda';

package/lib/helper/SDKUI_Localizator.d.ts

@@ -85,6 +85,7 @@ export declare class SDKUI_Localizator {
     static get Calendar(): "Kalender" | "Calendar" | "Calendario" | "Calendrier" | "Calendário";
     static get CancelCheckOut(): string;
     static get Cancel(): "Abbrechen" | "Cancel" | "Anular" | "Annuler" | "Cancelar" | "Annulla";
+    static get CancelAndClose(): string;
     static get ChangePassword(): "Kennwort ändern" | "Change password" | "Cambiar la contraseña" | "Changer le mot de passe" | "Alterar a senha" | "Cambia password";
     static get ChangeStatusTo(): string;
     static get CharactersRemaining(): "verbleibende Zeichen" | "characters remaining" | "caracteres restantes" | "caractères restants" | "caratteri rimanenti";

package/lib/helper/SDKUI_Localizator.js

@@ -805,6 +805,16 @@ export class SDKUI_Localizator {
             default: return "Annulla";
         }
     }
+    static get CancelAndClose() {
+        switch (this._cultureID) {
+            case CultureIDs.De_DE: return "Abbrechen und schließen";
+            case CultureIDs.En_US: return "Cancel and close";
+            case CultureIDs.Es_ES: return "Cancelar y cerrar";
+            case CultureIDs.Fr_FR: return "Annuler et fermer";
+            case CultureIDs.Pt_PT: return "Cancelar e fechar";
+            default: return "Annulla e chiudi";
+        }
+    }
     static get ChangePassword() {
         switch (this._cultureID) {
             case CultureIDs.De_DE: return "Kennwort ändern";

package/lib/hooks/useResizeObserver.d.ts

@@ -1,4 +1,4 @@
 export declare const useResizeObserver: () => {
-    ref: import("react").RefObject<HTMLDivElement>;
+    ref: (node: HTMLDivElement | null) => void;
     width: number;
 };

package/lib/hooks/useResizeObserver.js

@@ -1,22 +1,23 @@
-import { useEffect, useRef, useState } from 'react';
+import { useCallback, useEffect, useState } from 'react';
 export const useResizeObserver = () => {
     const [width, setWidth] = useState(0);
-    const ref = useRef(null);
+    const [element, setElement] = useState(null);
+    // Callback ref: viene invocato quando l'elemento viene montato/smontato
+    const ref = useCallback((node) => {
+        setElement(node);
+    }, []);
     useEffect(() => {
-        const handleResize = (entries) => {
-            if (entries[0].contentRect) {
+        if (!element)
+            return;
+        // Imposta la larghezza iniziale
+        setWidth(element.getBoundingClientRect().width);
+        const observer = new ResizeObserver((entries) => {
+            if (entries[0]?.contentRect) {
                 setWidth(entries[0].contentRect.width);
             }
-        };
-        const observer = new ResizeObserver(handleResize);
-        if (ref.current) {
-            observer.observe(ref.current);
-        }
-        return () => {
-            if (ref.current) {
-                observer.unobserve(ref.current);
-            }
-        };
-    }, []);
+        });
+        observer.observe(element);
+        return () => observer.disconnect();
+    }, [element]);
     return { ref, width };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@topconsultnpm/sdkui-react",
-    "version": "6.21.0-dev2.29",
+    "version": "6.21.0-dev2.30",
     "description": "",
     "scripts": {
         "test": "echo \"Error: no test specified\" && exit 1",