@esfaenza/flow-builder 20.3.56 → 20.3.57

package/README.md

@@ -173,7 +173,8 @@ sono opzionali e rifiutano con `MissingService` se non sovrascritti.
 
 **Errori.** Ogni metodo, in caso di rifiuto, deve fallire con un `FlowApiError`
 categorizzato (§10). L'editor si comporta in base alla `category`, mai leggendo il
-messaggio: `NotEditable` fa comparire «Nuova versione» al posto di «Salva»,
+messaggio: `NotEditable` (la versione e' **diventata** quella attiva) rilegge l'elenco versioni,
+e da lì compare «Nuova versione» al posto di «Salva»,
 `VersionConflict` apre il banner con «ricarica» / «salva come nuova versione»,
 `ValidationFailed` apre il pannello dei problemi con il payload.
 
@@ -948,9 +949,20 @@ esegue il flow, e cambiarlo su un documento già scritto lo lascia pieno di rife
 da quel momento non esistono — senza che nessuna primitiva del backend rimedi. Un host che crea i
 flow da sé (come la demo) il tipo lo chiede lì, e lo passa a `emptyFlowDefinition`.
 
-**Versioni.** Elenco con stato, «Nuova versione» al posto di «Salva» sulle versioni chiuse,
-attivazione bloccata finche' ci sono errori, eliminazione dietro una conferma esplicita che
-spiega il rischio per le esecuzioni sospese.
+**Versioni.** Elenco con stato, «Nuova versione» al posto di «Salva» sulla versione **attiva** —
+l'unica che non si modifica (§8) — attivazione bloccata finche' ci sono errori, eliminazione dietro
+una conferma esplicita che spiega il rischio per le esecuzioni sospese.
+
+Una versione **superata** si modifica come una bozza, ma non e' la stessa cosa, e le differenze
+sono tre. Salvata **torna bozza** (lo dice lo `status` della risposta), quindi per rimetterla in
+produzione va riattivata. Si sovrascrive solo **mandandone il numero**: un salvataggio senza
+`version` non la sceglie mai — ed e' una ragione in piu' per cui l'editor il numero lo manda sempre.
+E il **primo salvataggio si conferma**: un'esecuzione sospesa nata quando quella versione era
+attiva riprende sulla definizione modificata, e se il node su cui era ferma non c'e' piu' fallisce —
+il backend non puo' saperlo al posto di chi salva. La barra della conferma offre anche «Salva come
+nuova versione», che lascia la superata com'era. `isEditable` vale per tutt'e due i casi, e non va
+letto come «e' una bozza»: per quello c'e' `status`, come `hasDraft` nell'elenco dei flow conta le
+sole bozze.
 
 **Eliminare il flow intero e' dell'ospite.** Il pannello versioni si ferma alla **versione**: il
 flow lo toglie chi integra, perche' il builder edita un flow già aperto e l'elenco da cui toglierlo