@esfaenza/flow-builder 20.3.19 → 20.3.21

package/README.md

@@ -191,6 +191,32 @@ l'attributo `style` del node a ogni spostamento e uno `[style.width]` verrebbe c
 tabella delle larghezze e' la stessa che il comando «Riordina» passa a dagre: se divergessero,
 i node larghi resterebbero sovrapposti.
 
+**Copia, incolla, duplica.** `Ctrl`+`C` copia gli elementi selezionati — la selezione del canvas
+puo' contenerne piu' d'uno (rettangolo, `Ctrl`+`A`) — `Ctrl`+`V` li incolla, `Ctrl`+`D` li duplica in
+loco; gli stessi comandi stanno nella top bar («⧉» e «⎘») e sul node selezionato («⧉»). I tasti
+ascoltano sull'host del builder e si ignorano quando il fuoco e' in un campo di testo, dove
+`Ctrl`+`C` deve copiare il testo.
+
+Cosa viaggia con il blocco: la configurazione intera dell'elemento, i **collegamenti interni** al
+blocco (quelli verso l'esterno no — sarebbero `CONNECTOR_TARGET_UNKNOWN`) e le **risorse
+referenziate**, che e' cio' che rende il gesto utile su un elemento complesso. Gli appunti stanno in
+`localStorage`, quindi valgono anche fra flow diversi e fra schede: non e' la clipboard di sistema,
+che per essere **letta** chiede un permesso che in un iframe puo' non arrivare mai.
+
+L'incolla passa da una conferma perche' non e' mai una copia identica, e le tre cose che cambiano le
+decide il contratto:
+
+- i nomi già usati vengono **rinominati**, e non solo quello dell'elemento: uno spazio di nomi unico
+  (§3.3) comprende gli step di orchestrazione, i campi di uno screen dinamico e le screen action, e
+  duplicare uno screen dinamico senza rinominare i campi produceva un `NAME_DUPLICATED` per campo;
+- i **riferimenti interni** al blocco seguono i nomi nuovi (§13.8: nessuna primitiva lo fa), condizioni,
+  `visibilityRule`, trigger e output automatici compresi;
+- le risorse che nella destinazione non esistono si creano (con una casella per non farlo), quelle
+  omonime si **riusano**, e cio' che resta irrisolvibile — un elemento rimasto nel flow di origine —
+  viene elencato invece di sparire in un `REFERENCE_UNKNOWN` da scoprire dopo.
+
+Tutto l'incolla e' **un solo passo di annulla**.
+
 **Dettaglio dell'elemento.** Con `inspectorMode="dialog"` (predefinito) il form si apre in una
 finestra sopra il canvas: doppio click sul node, bottone «✎» sul node, comando «Dettaglio»
 nella top bar, click su un rilievo nel pannello dei problemi, o creazione di un elemento dalla
@@ -507,6 +533,10 @@ src/lib/
                                   "questo ambiente la primitiva non ce l'ha"
     flow-editor-session.ts   versioni, salvataggio, concorrenza ottimistica
     flow-layout.service.ts   auto-layout con dagre
+    flow-clipboard.ts        copia/incolla: l'elenco unico dei campi-riferimento, la riscrittura
+                             dei nomi, il piano dell'incolla (che nomi cambiano, che risorse
+                             mancano, cosa resta irrisolto)
+    flow-clipboard.service.ts gli appunti condivisi fra istanze e schede (localStorage)
     flow-name.util.ts        nomi: regexp, namespace unico, slug dalla label
     condition-logic.util.ts  riscrittura di conditionLogic su cancella / riordina
     condition-types.util.ts  quali tipi si confrontano, e i numeri in cultura invariante