@topconsultnpm/sdkui-react 6.22.0-dev3.9 → 6.22.0-dev4.11

package/lib/components/base/waitPanel/TMWaitPanelManager.js

@@ -0,0 +1,373 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import ReactDOM from 'react-dom/client';
+import { SDKUI_Localizator } from '../../../helper';
+import TMWaitPanelView from './TMWaitPanelView';
+const Z_INDEX_BASE = 2147483601;
+const RESOLVED = Promise.resolve();
+/** Accumula un messaggio in testa, tenendo solo quelli visibili nel popover. */
+const pushMessage = (list, message, max) => {
+    list.unshift(message);
+    if (list.length > max)
+        list.length = max;
+};
+const pad2 = (n) => (n < 10 ? '0' + n : String(n));
+/** Formatta una durata in millisecondi come "42s", "3m 07s", "1h 12m". */
+const formatDuration = (ms) => {
+    const totalSeconds = Math.max(0, Math.round(ms / 1000));
+    if (totalSeconds < 60)
+        return `${totalSeconds}s`;
+    const totalMinutes = Math.floor(totalSeconds / 60);
+    if (totalMinutes < 60)
+        return `${totalMinutes}m ${pad2(totalSeconds % 60)}s`;
+    return `${Math.floor(totalMinutes / 60)}h ${pad2(totalMinutes % 60)}m`;
+};
+class TMWaitPanelInstance {
+    constructor(options, zIndex) {
+        this.abortController = new AbortController();
+        this.nodes = null;
+        this.closed = false;
+        this.elapsedLabel = SDKUI_Localizator.Elapsed;
+        this.remainingLabel = SDKUI_Localizator.Remaining;
+        // Pausa in attesa della conferma di interruzione.
+        this._paused = false;
+        this.pauseGate = null;
+        this.resolvePauseGate = null;
+        this.pausedTotalMs = 0;
+        this.pauseStartedAt = 0;
+        this.startTime = performance.now();
+        this.rafId = 0;
+        this._value = 0;
+        this._max = 0;
+        this._ok = 0;
+        this._warning = 0;
+        this._error = 0;
+        this._secondaryValue = 0;
+        this._secondaryMax = 0;
+        this._warningMessages = [];
+        this._errorMessages = [];
+        this.warningMessageTotal = 0;
+        this.errorMessageTotal = 0;
+        this.messagesDirty = false;
+        // Ultimi valori scritti sul DOM: servono a non riscrivere testo identico.
+        this.lastPercentText = '';
+        this.lastSubtitleText = '';
+        this.lastElapsedText = '';
+        this.lastRemainingText = '';
+        this.lastOk = 0;
+        this.lastWarning = 0;
+        this.lastError = 0;
+        this.lastTitleText = '';
+        this.lastSecondaryPercentText = '';
+        this.lastSecondaryText = '';
+        this.waitWhilePaused = () => this.pauseGate ?? RESOLVED;
+        this.step = (delta = 1) => { this._value += delta; this.schedule(); return this.pauseGate ?? RESOLVED; };
+        this.setValue = (value) => { this._value = value; this.schedule(); };
+        this.setMax = (max) => { this._max = max; this.schedule(); };
+        this.setTitle = (title) => { this._title = title; this.schedule(); };
+        this.setSubtitle = (subtitle) => { this._subtitleOverride = subtitle; this.schedule(); };
+        this.ok = (delta = 1) => { this._ok += delta; this.schedule(); };
+        this.warning = (delta = 1, message) => {
+            this._warning += delta;
+            if (message) {
+                pushMessage(this._warningMessages, message, this.maxVisibleMessages);
+                this.warningMessageTotal++;
+                this.messagesDirty = true;
+            }
+            this.schedule();
+        };
+        this.error = (delta = 1, message) => {
+            this._error += delta;
+            if (message) {
+                pushMessage(this._errorMessages, message, this.maxVisibleMessages);
+                this.errorMessageTotal++;
+                this.messagesDirty = true;
+            }
+            this.schedule();
+        };
+        this.setSecondary = (patch) => {
+            if (patch.value !== undefined)
+                this._secondaryValue = patch.value;
+            if (patch.max !== undefined)
+                this._secondaryMax = patch.max;
+            if (patch.text !== undefined)
+                this._secondaryText = patch.text;
+            this.schedule();
+        };
+        this.update = (patch) => {
+            if (patch.title !== undefined)
+                this._title = patch.title;
+            if (patch.subtitle !== undefined)
+                this._subtitleOverride = patch.subtitle;
+            if (patch.value !== undefined)
+                this._value = patch.value;
+            if (patch.max !== undefined)
+                this._max = patch.max;
+            if (patch.ok !== undefined)
+                this._ok = patch.ok;
+            if (patch.warning !== undefined)
+                this._warning = patch.warning;
+            if (patch.error !== undefined)
+                this._error = patch.error;
+            this.schedule();
+        };
+        this.close = () => {
+            if (this.closed)
+                return;
+            this.closed = true;
+            // Sblocca un loop eventualmente fermo in attesa della conferma.
+            this.resume();
+            if (this.rafId) {
+                cancelAnimationFrame(this.rafId);
+                this.rafId = 0;
+            }
+            if (this.tickerId !== undefined) {
+                clearInterval(this.tickerId);
+                this.tickerId = undefined;
+            }
+            document.removeEventListener('keydown', this.handleKeyDown, true);
+            // Smonto fuori dal render corrente: close() puo' arrivare durante un render.
+            this.container.style.display = 'none';
+            const root = this.root;
+            const container = this.container;
+            setTimeout(() => { root.unmount(); container.remove(); }, 0);
+            TMWaitPanelManager._unregister(this);
+        };
+        // #endregion
+        this.handleMount = (nodes) => {
+            if (this.closed)
+                return;
+            this.nodes = nodes;
+            // Il chiamante puo' aver gia' avanzato prima del montaggio.
+            this.flush();
+        };
+        this.handleKeyDown = (e) => {
+            if (this.closed)
+                return;
+            // Con la conferma aperta la tastiera risponde a lei: Esc = No, Invio = Si.
+            if (this._paused) {
+                if (e.key === 'Escape') {
+                    e.preventDefault();
+                    e.stopPropagation();
+                    this.resume();
+                }
+                else if (e.key === 'Enter') {
+                    e.preventDefault();
+                    e.stopPropagation();
+                    this.confirmAbort();
+                }
+                return;
+            }
+            if (e.key !== 'Escape')
+                return;
+            e.preventDefault();
+            e.stopPropagation();
+            this.handleAbort();
+        };
+        /** Interrompi non annulla subito: mette in pausa il loop e chiede conferma. */
+        this.handleAbort = () => {
+            if (this.closed || this.aborted || this._paused)
+                return;
+            this.pause();
+        };
+        /** Risposta Si: interrompe davvero e lascia ripartire il loop, che uscira' subito. */
+        this.confirmAbort = () => {
+            if (this.closed || this.aborted)
+                return;
+            this.abortController.abort();
+            const abortButton = this.nodes?.abortButton;
+            if (abortButton) {
+                abortButton.disabled = true;
+                abortButton.textContent = SDKUI_Localizator.Aborting;
+            }
+            this.options.onAbort?.();
+            this.resume();
+        };
+        /** Risposta No, oppure chiusura del pannello: sblocca il loop e riprende. */
+        this.resume = () => {
+            if (!this._paused)
+                return;
+            this._paused = false;
+            this.pausedTotalMs += performance.now() - this.pauseStartedAt;
+            if (this.nodes)
+                this.nodes.confirm.style.display = 'none';
+            const resolve = this.resolvePauseGate;
+            this.pauseGate = null;
+            this.resolvePauseGate = null;
+            resolve?.();
+            this.schedule();
+        };
+        /** Programma al massimo un flush per frame. E' l'unico costo pagato da `step()`. */
+        this.schedule = () => {
+            if (this.closed || this.rafId || !this.nodes)
+                return;
+            this.rafId = requestAnimationFrame(this.flush);
+        };
+        /** Riversa sul DOM lo stato corrente (barra, percentuale, testi, contatori), saltando cio' che non e' cambiato. */
+        this.flush = () => {
+            this.rafId = 0;
+            const nodes = this.nodes;
+            if (this.closed || !nodes)
+                return;
+            const ratio = this._max > 0 ? Math.min(1, Math.max(0, this._value / this._max)) : 0;
+            // scaleX invece di width: resta sul compositor, niente layout.
+            nodes.fill.style.transform = `scaleX(${ratio})`;
+            const percentText = `${(ratio * 100).toFixed(2)}%`;
+            if (percentText !== this.lastPercentText) {
+                this.lastPercentText = percentText;
+                nodes.percent.textContent = percentText;
+            }
+            if (this._title !== this.lastTitleText) {
+                this.lastTitleText = this._title;
+                nodes.title.textContent = this._title;
+            }
+            const subtitleText = this.computeSubtitle();
+            if (subtitleText !== this.lastSubtitleText) {
+                this.lastSubtitleText = subtitleText;
+                nodes.subtitle.textContent = subtitleText;
+            }
+            if (this._ok !== this.lastOk) {
+                this.lastOk = this._ok;
+                nodes.okValue.textContent = String(this._ok);
+            }
+            if (this._warning !== this.lastWarning) {
+                this.lastWarning = this._warning;
+                nodes.warningValue.textContent = String(this._warning);
+            }
+            if (this._error !== this.lastError) {
+                this.lastError = this._error;
+                nodes.errorValue.textContent = String(this._error);
+            }
+            if (this.messagesDirty) {
+                this.messagesDirty = false;
+                this.flushMessages(nodes.warningPopover, nodes.warningList, this._warningMessages, this.warningMessageTotal);
+                this.flushMessages(nodes.errorPopover, nodes.errorList, this._errorMessages, this.errorMessageTotal);
+            }
+            if (nodes.secondaryFill)
+                this.flushSecondary(nodes);
+            if (this.options.showEta ?? true)
+                this.flushEta(nodes, ratio);
+        };
+        this.options = options;
+        this.maxVisibleMessages = Math.max(1, options.maxVisibleMessages ?? 5);
+        this._max = options.max ?? 0;
+        this._title = options.title ?? '';
+        this._secondaryText = options.secondaryText ?? '';
+        this.lastTitleText = this._title;
+        this.lastSecondaryText = this._secondaryText;
+        this.lastSubtitleText = this.computeSubtitle();
+        this.container = document.createElement('div');
+        document.body.appendChild(this.container);
+        this.root = ReactDOM.createRoot(this.container);
+        this.root.render(_jsx(TMWaitPanelView, { title: this._title, subtitle: this.lastSubtitleText, cancelable: options.cancelable ?? false, showEta: options.showEta ?? true, showCounters: options.showCounters ?? true, showSecondary: options.showSecondary ?? false, secondaryText: this._secondaryText, primaryLabel: options.primaryLabel ?? '', secondaryLabel: options.secondaryLabel ?? '', zIndex: zIndex, onAbort: this.handleAbort, onConfirmYes: this.confirmAbort, onConfirmNo: this.resume, onMount: this.handleMount }));
+        if (options.cancelable ?? false)
+            document.addEventListener('keydown', this.handleKeyDown, true);
+        if (options.showEta ?? true)
+            this.tickerId = setInterval(this.schedule, 500);
+    }
+    // #region API pubblica
+    get aborted() { return this.abortController.signal.aborted; }
+    get signal() { return this.abortController.signal; }
+    get value() { return this._value; }
+    get max() { return this._max; }
+    get counters() { return { ok: this._ok, warning: this._warning, error: this._error }; }
+    get isOpen() { return !this.closed; }
+    get paused() { return this._paused; }
+    pause() {
+        if (this._paused)
+            return;
+        this._paused = true;
+        this.pauseStartedAt = performance.now();
+        this.pauseGate = new Promise(resolve => { this.resolvePauseGate = resolve; });
+        if (this.nodes)
+            this.nodes.confirm.style.display = 'flex';
+    }
+    computeSubtitle() {
+        if (this._subtitleOverride !== undefined)
+            return this._subtitleOverride;
+        const template = this.options.subtitleTemplate;
+        if (template)
+            return template.replace('{{0}}', String(this._value)).replace('{{1}}', String(this._max));
+        return this.options.subtitle ?? '';
+    }
+    /** Riscrive la lista di un popover con gli ultimi messaggi e la riga "... e altri N". Il popover si apre solo se non e' vuoto. */
+    flushMessages(popover, list, messages, total) {
+        if (total === 0)
+            return;
+        const visible = messages.length;
+        const items = [];
+        for (let i = 0; i < visible; i++) {
+            const item = document.createElement('li');
+            item.textContent = messages[i];
+            items.push(item);
+        }
+        if (total > visible) {
+            const more = document.createElement('li');
+            more.className = 'tm-wait-panel-more';
+            more.textContent = SDKUI_Localizator.AndOthersCount.replace('{{0}}', String(total - visible));
+            items.push(more);
+        }
+        list.replaceChildren(...items);
+        popover.dataset.empty = 'false';
+    }
+    /** Riversa sul DOM la seconda barra. Invocata solo quando la view l'ha renderizzata. */
+    flushSecondary(nodes) {
+        const ratio = this._secondaryMax > 0 ? Math.min(1, Math.max(0, this._secondaryValue / this._secondaryMax)) : 0;
+        nodes.secondaryFill.style.transform = `scaleX(${ratio})`;
+        const percentText = `${(ratio * 100).toFixed(2)}%`;
+        if (percentText !== this.lastSecondaryPercentText) {
+            this.lastSecondaryPercentText = percentText;
+            nodes.secondaryPercent.textContent = percentText;
+        }
+        if (this._secondaryText !== this.lastSecondaryText) {
+            this.lastSecondaryText = this._secondaryText;
+            nodes.secondaryText.textContent = this._secondaryText;
+        }
+    }
+    /** Aggiorna la riga dei tempi: trascorso al netto delle pause e stima del rimanente. */
+    flushEta(nodes, ratio) {
+        const pausedMs = this.pausedTotalMs + (this._paused ? performance.now() - this.pauseStartedAt : 0);
+        const elapsedMs = performance.now() - this.startTime - pausedMs;
+        const elapsedText = `${formatDuration(elapsedMs)} ${this.elapsedLabel}`;
+        if (elapsedText !== this.lastElapsedText) {
+            this.lastElapsedText = elapsedText;
+            nodes.elapsed.textContent = elapsedText;
+        }
+        // Sotto 1s la stima balla troppo.
+        let remainingText = '';
+        if (ratio > 0 && ratio < 1 && elapsedMs > 1000) {
+            remainingText = `${formatDuration(elapsedMs / ratio - elapsedMs)} ${this.remainingLabel}`;
+        }
+        if (remainingText !== this.lastRemainingText) {
+            this.lastRemainingText = remainingText;
+            nodes.remaining.textContent = remainingText;
+        }
+    }
+}
+export class TMWaitPanelManager {
+    /** Apre un wait panel e restituisce l'handle con cui pilotarlo. */
+    static show(options = {}) {
+        const panel = new TMWaitPanelInstance(options, Z_INDEX_BASE + this._panels.length);
+        this._panels.push(panel);
+        return panel;
+    }
+    /** Pannello aperto piu' recente, se presente. */
+    static get current() {
+        return this._panels[this._panels.length - 1];
+    }
+    /** True finche' almeno un wait panel e' aperto: flag "operazione massiva in corso" per i refresh periodici. */
+    static get isBusy() {
+        return this._panels.length > 0;
+    }
+    /** Chiude tutti i pannelli aperti (rete di sicurezza in caso di unmount della pagina). */
+    static closeAll() {
+        [...this._panels].forEach(panel => panel.close());
+    }
+    /** @internal */
+    static _unregister(panel) {
+        const index = this._panels.indexOf(panel);
+        if (index >= 0)
+            this._panels.splice(index, 1);
+    }
+}
+TMWaitPanelManager._panels = [];
+export default TMWaitPanelManager;

package/lib/components/base/waitPanel/TMWaitPanelView.d.ts

@@ -0,0 +1,58 @@
+import React from 'react';
+/** Guscio statico del wait panel: montato una sola volta e mai ri-renderizzato, il manager lo aggiorna via DOM. Le props sono valori iniziali. */
+/** Nodi DOM mutabili di cui il manager ha bisogno per aggiornare il pannello senza React. */
+export interface ITMWaitPanelNodes {
+    /** Layer di conferma dell'interruzione: il manager lo accende via style.display. */
+    confirm: HTMLElement;
+    title: HTMLElement;
+    subtitle: HTMLElement;
+    percent: HTMLElement;
+    fill: HTMLElement;
+    elapsed: HTMLElement;
+    remaining: HTMLElement;
+    okValue: HTMLElement;
+    warningValue: HTMLElement;
+    errorValue: HTMLElement;
+    /** Popover delle pill: il manager riempie la lista e toglie `data-empty` al primo messaggio. */
+    warningPopover: HTMLElement;
+    warningList: HTMLElement;
+    errorPopover: HTMLElement;
+    errorList: HTMLElement;
+    abortButton: HTMLButtonElement | null;
+    /** Presenti solo con `showSecondary`: riga di avanzamento dell'operazione di dettaglio. */
+    secondaryText: HTMLElement | null;
+    secondaryPercent: HTMLElement | null;
+    secondaryFill: HTMLElement | null;
+}
+export interface ITMWaitPanelViewProps {
+    /** Valore iniziale del titolo. */
+    title?: string;
+    /** Valore iniziale del sottotitolo. */
+    subtitle?: string;
+    /** Mostra il bottone di interruzione. */
+    cancelable?: boolean;
+    /** Mostra la riga "trascorsi / rimanenti". */
+    showEta?: boolean;
+    /** Mostra le tre pill numeriche ok / warning / error, sempre visibili anche a 0. */
+    showCounters?: boolean;
+    /** Riserva la seconda barra, quella dell'operazione di dettaglio (es. i byte del file in corso). */
+    showSecondary?: boolean;
+    /** Valore iniziale del testo della barra secondaria. */
+    secondaryText?: string;
+    /** Didascalia fissa sopra la barra principale, es. "Documenti". Vuota: non viene resa. */
+    primaryLabel?: string;
+    /** Didascalia fissa sopra la barra secondaria, es. "File corrente". Vuota: non viene resa. */
+    secondaryLabel?: string;
+    /** z-index dell'overlay: il manager lo incrementa per i pannelli annidati. */
+    zIndex?: number;
+    /** L'utente ha premuto Interrompi: il manager chiede conferma. */
+    onAbort?: () => void;
+    /** Conferma data: interrompere davvero. */
+    onConfirmYes?: () => void;
+    /** Conferma negata: riprendere. */
+    onConfirmNo?: () => void;
+    /** Invocato dopo il commit con i nodi DOM da aggiornare imperativamente. */
+    onMount?: (nodes: ITMWaitPanelNodes) => void;
+}
+declare const TMWaitPanelView: ({ title, subtitle, cancelable, showEta, showCounters, showSecondary, secondaryText, primaryLabel, secondaryLabel, zIndex, onAbort, onConfirmYes, onConfirmNo, onMount }: ITMWaitPanelViewProps) => React.JSX.Element;
+export default TMWaitPanelView;