@esfaenza/flow-builder 20.3.46 → 20.3.47

package/index.d.ts

@@ -416,8 +416,39 @@ interface FlowDynamicScreen extends FlowNodeBase {
     actions?: FlowScreenAction[];
     /** Chi le invoca, e quando: due pezzi perche' piu' trigger possono chiamare la stessa action. */
     triggers?: FlowScreenTrigger[];
+    /**
+     * §5.2 — le regole della **schermata**: le verifiche che non appartengono a nessun campo. Vedi
+     * {@link FlowScreenRule}.
+     */
+    validationRules?: FlowScreenRule[];
     connector?: FlowConnector;
 }
+/**
+ * §5.2 — una regola della **schermata**, cioe' una verifica che nessun campo puo' esprimere: «almeno
+ * un punto fra le due sezioni», «la somma delle percentuali fa cento», «queste due date sono in
+ * ordine». Si valutano all'invio, dopo i campi e dopo le righe, e una regola non soddisfatta
+ * **impedisce alla schermata di avanzare** (`SCREEN_RULE` fra i rilievi del runtime).
+ *
+ * Perche' non basta la `validationRule` di un campo: quella giudica **un** valore, e su una sezione
+ * ripetibile e' addirittura inerte, perche' la sezione un valore proprio non lo raccoglie.
+ * L'alternativa storica era un node a valle dello screen, che pero' non blocca la schermata —
+ * l'interview avanza e poi torna indietro — e mette una validazione dentro il disegno del flow.
+ */
+interface FlowScreenRule extends FlowConditionHolder {
+    /**
+     * **Obbligatorio** (`SCREEN_RULE_INVALID`): senza, la schermata si rifiuterebbe di avanzare senza
+     * dire perche'. Supporta i merge field, ed e' il testo dell'autore — il runtime non ne costruisce
+     * uno, perche' non c'e' un campo da nominare.
+     */
+    errorMessage?: string;
+    /**
+     * Facoltativo: il campo a cui agganciare il rilievo. Senza, il rilievo e' **della schermata** e il
+     * frontend lo mostra dove mostra i messaggi che non hanno un controllo. Se c'e', deve nominare un
+     * campo di questo screen e **non** uno dentro una sezione ripetibile — quello esiste in una riga
+     * per elemento e non individua un controllo (`SCREEN_FIELD_IN_REPEATER`).
+     */
+    fieldName?: string;
+}
 type FlowAssignmentOperator = 'Assign' | 'Add' | 'Subtract' | 'AddAtStart' | 'AssignCount' | 'RemoveFirst' | 'RemoveAll' | 'RemovePosition' | 'RemoveAfterFirst' | 'RemoveBeforeFirst' | 'RemoveUncommon' | string;
 interface FlowAssignmentItem {
     assignToReference?: string;
@@ -696,8 +727,21 @@ interface FlowStart {
     locationY?: number;
     /** Sempre necessario: senza, `START_NO_ENTRY_POINT`. */
     connector?: FlowConnector;
+    /** §3.4 — insieme a `processType` **determina il tipo di flow**: e' l'altra meta' della coppia. */
     triggerType?: FlowTriggerType;
+    /**
+     * Obbligatorio con i trigger su record: e' l'entita' che innesca (`START_OBJECT_MISSING`).
+     * **Facoltativo** con `Scheduled`, e lì significa un'altra cosa: un'esecuzione per ogni record
+     * che soddisfa i filtri, invece di una sola (§3.4).
+     */
     object?: string;
+    /**
+     * §3.4 — obbligatorio con `triggerType: "Event"`: e' cio' a cui l'host si sottoscrive. Senza,
+     * `START_EVENT_MISSING`.
+     */
+    eventType?: string;
+    /** §3.4 — facoltativo, quando il tipo da solo non identifica l'evento. */
+    eventName?: string;
     recordTriggerType?: FlowRecordTriggerType;
     filterLogic?: FlowConditionLogic;
     filters?: FlowRecordFilter[];
@@ -922,6 +966,36 @@ interface FlowScreenFieldTypeEntry extends FlowDictionaryEntry {
     /** `dataType` obbligatorio: senza, `DATA_TYPE_MISSING`. */
     requiresDataType?: boolean;
 }
+/**
+ * §3.4 — un **tipo di flow**: la voce che tiene insieme `processType` e `start.triggerType`, e che
+ * dice cosa lo Start deve dichiarare.
+ *
+ * E' la seconda voce di dizionario che porta piu' di `value`/`label`/`description`, e i flag sono
+ * gli stessi che applica il backend: sono loro a decidere **quali pannelli mostrare** — oggetto e
+ * filtri, orario e ricorrenza, evento — e se offrire gli screen nella palette. Ricalcolarli lato
+ * editor porta prima o poi a chiedere un campo che il motore non pretende, o a non chiederne uno
+ * che pretende.
+ */
+interface FlowFlowTypeEntry extends FlowDictionaryEntry {
+    /** Il `processType` che il tipo scrive nel radice. */
+    processType?: FlowProcessType;
+    /** I `triggerType` ammessi per questo tipo: uno solo per quasi tutti, tre per i record. */
+    triggerTypes?: FlowTriggerType[];
+    /** Quello con cui nasce un flow di questo tipo, dove ce n'e' piu' d'uno. */
+    defaultTriggerType?: FlowTriggerType;
+    /** Che genere di presa in carico serve all'host: una voce di `registrationKinds`. */
+    registration?: string;
+    /** Il tipo non parte da solo: l'attivazione lo registra presso l'host, e puo' fallire (§8). */
+    requiresRegistration?: boolean;
+    /** Il flow puo' contenere screen: c'e' qualcuno a cui mostrarli. */
+    allowsScreens?: boolean;
+    /** Lo Start deve dichiarare `object`: senza, `START_OBJECT_MISSING`. */
+    requiresObject?: boolean;
+    /** Lo Start deve dichiarare `schedule`: senza, `START_SCHEDULE_MISSING`. */
+    requiresSchedule?: boolean;
+    /** Lo Start deve dichiarare `eventType`: senza, `START_EVENT_MISSING`. */
+    requiresEvent?: boolean;
+}
 interface FlowResourceKindEntry extends FlowDictionaryEntry {
     /** Solo le variabili sono scrivibili (§4.6). */
     isWritable?: boolean;
@@ -945,6 +1019,14 @@ interface FlowDictionaries {
     elementTypes?: FlowElementTypeEntry[];
     resourceKinds?: FlowResourceKindEntry[];
     globalVariables?: FlowGlobalVariableEntry[];
+    /**
+     * §3.4 — i **sei tipi di flow**, cioe' la prima scelta che l'utente fa. E' la tabella con cui si
+     * compone la creazione: `processType` e `triggerType` da scrivere, e i flag da cui dipende quali
+     * pannelli dello Start pretendere.
+     */
+    flowTypes?: FlowFlowTypeEntry[];
+    /** §3.4, §8 — i generi di presa in carico presso l'host (scheduler, bus, trigger sui record). */
+    registrationKinds?: FlowDictionaryEntry[];
     processTypes?: FlowDictionaryEntry[];
     versionStatuses?: FlowDictionaryEntry[];
     triggerTypes?: FlowDictionaryEntry[];
@@ -1153,6 +1235,13 @@ interface FlowSummary {
     label?: string | null;
     description?: string | null;
     processType?: FlowProcessType;
+    /**
+     * §3.4 — il **tipo di flow**: la lettura in una parola di `processType` + `start.triggerType`.
+     * E' **derivato** e di sola lettura — nel documento quel campo non esiste — e vale `null` per un
+     * flow che non e' uno dei sei tipi (un `Evaluation`, un'orchestrazione senza trigger): lì si
+     * mostra il `processType`.
+     */
+    flowType?: string | null;
     activeVersion?: number | null;
     latestVersion?: number;
     versionCount?: number;
@@ -1168,6 +1257,8 @@ interface FlowVersionSummary {
     label?: string | null;
     description?: string | null;
     processType?: FlowProcessType;
+    /** §3.4 — il tipo di flow, derivato: vedi {@link FlowSummary.flowType}. */
+    flowType?: string | null;
     createdAt?: string;
     /** Da conservare e rimandare come `expectedUpdatedAt` al salvataggio (§9). */
     updatedAt?: string;
@@ -1179,6 +1270,8 @@ interface FlowVersionSummary {
 interface FlowListQuery {
     search?: string;
     processType?: FlowProcessType;
+    /** §3.4, §6.1 — filtra per **tipo di flow**, che e' la coppia `processType` + `triggerType`. */
+    flowType?: string;
     onlyActive?: boolean;
 }
 type FlowIssueSeverity = 'Error' | 'Warning' | 'Info' | string;
@@ -1359,6 +1452,13 @@ interface FlowOutline {
     label?: string | null;
     processType?: FlowProcessType;
     triggerType?: string | null;
+    /**
+     * §3.4 — il **tipo di flow**: la lettura in una parola di `processType` + `start.triggerType`.
+     * E' **derivato** e di sola lettura — nel documento quel campo non esiste — e vale `null` per un
+     * flow che non e' uno dei sei tipi (un `Evaluation`, un'orchestrazione senza trigger): lì si
+     * mostra il `processType`.
+     */
+    flowType?: string | null;
     entryElementName?: string | null;
     nodes: FlowOutlineNode[];
     connections: FlowOutlineConnection[];
@@ -1598,8 +1698,19 @@ type FlowErrorCategory =
  | 'NotEditable'
 /** Qualcun altro ha salvato: proponi ricarica (§9). */
  | 'VersionConflict'
-/** Funzione non configurata su questo ambiente: disabilita il comando. */
+/**
+ * Funzione non configurata su questo ambiente: disabilita il comando. **Sull'attivazione**
+ * significa un'altra cosa e va detta con altre parole: nessuno, su questa installazione, prende
+ * in carico quel tipo di flow — la definizione e' valida, e «riprova» non ha senso (§8).
+ */
  | 'MissingService'
+/**
+ * §8, §10 — l'host ha **rifiutato la presa in carico** del flow: scheduler non raggiungibile,
+ * evento sconosciuto, intercettore delle scritture che non risponde. Riguarda i tre tipi che non
+ * partono da soli, la versione **non** e' attiva, e qui «riprova» ha senso — al contrario di
+ * `MissingService`, con cui e' facile confonderlo.
+ */
+ | 'RegistrationFailed'
 /**
  * §4.7.1 — classe non registrata (o `IStructureMgr` assente sull'host): il 404 dei membri di
  * una classe. **Non e' una lista vuota**: quella dice "membri non dichiarati" e lascia
@@ -2566,6 +2677,31 @@ declare class FlowDictionaryStore {
     readonly processTypes: _angular_core.Signal<FlowDictionaryEntry[]>;
     readonly triggerTypes: _angular_core.Signal<FlowDictionaryEntry[]>;
     readonly recordTriggerTypes: _angular_core.Signal<FlowDictionaryEntry[]>;
+    /**
+     * §3.4 — i sei tipi di flow. E' la prima scelta che l'utente fa creando un flow, e non e' un
+     * campo del documento: il tipo **e'** la coppia `processType` + `start.triggerType`.
+     */
+    readonly flowTypes: _angular_core.Signal<FlowFlowTypeEntry[]>;
+    /** §3.4, §8 — i generi di presa in carico presso l'host. Elenco vuoto = non dichiarati. */
+    readonly registrationKinds: _angular_core.Signal<FlowDictionaryEntry[]>;
+    flowType(value: string | undefined | null): FlowFlowTypeEntry | undefined;
+    /**
+     * §3.4 — **il tipo di flow di un documento**, e questo e' l'unico posto in cui quella coppia si
+     * legge: `processType` piu' `triggerType`.
+     *
+     * `undefined` non e' un difetto ed e' un caso normale: un `Evaluation`, un'orchestrazione senza
+     * trigger, o semplicemente un dizionario che non dichiara `flowTypes`. Lì il documento resta
+     * valido e si mostra il `processType` — e' cio' che il contratto chiama `flowType: null`.
+     *
+     * Il `triggerType` assente vale `None`, com'e' nel documento (§3.4): un flow appena creato non lo
+     * scrive, e senza questo default nessun tipo corrisponderebbe.
+     */
+    flowTypeOf(processType: string | undefined | null, triggerType: string | undefined | null): FlowFlowTypeEntry | undefined;
+    /**
+     * Il tipo di flow di un documento intero: la stessa domanda, posta con in mano il documento.
+     * Comoda perche' la coppia sta in due posti diversi, e ricordarsene e' meta' del difetto.
+     */
+    flowTypeOfDefinition(definition: FlowDefinition | undefined): FlowFlowTypeEntry | undefined;
     readonly startFrequencies: _angular_core.Signal<FlowDictionaryEntry[]>;
     readonly offsetUnits: _angular_core.Signal<FlowDictionaryEntry[]>;
     readonly sortOrders: _angular_core.Signal<FlowDictionaryEntry[]>;
@@ -3193,8 +3329,18 @@ interface FlowResourceRef {
     index: number;
     resource: Record<string, unknown>;
 }
-/** Documento minimo per un flow nuovo (§11, "Creare un flow"). */
-declare function emptyFlowDefinition(fullName: string, label: string, processType: string): FlowDefinition;
+/**
+ * Documento minimo per un flow nuovo (§11, "Creare un flow").
+ *
+ * §3.4 — cio' che l'utente sceglie e' il **tipo di flow**, che nel documento non esiste come campo:
+ * e' la coppia `processType` + `start.triggerType`. Il chiamante passa entrambi i pezzi presi dalla
+ * voce di `flowTypes` (`processType` e `defaultTriggerType`), e li scrive questa funzione — che e'
+ * l'unico posto in cui un documento nasce, quindi l'unico in cui la coppia si puo' dimenticare.
+ *
+ * `triggerType` assente non si scrive: nel documento vale `None` per omissione (§2, §3.4), ed e' la
+ * forma giusta per i due tipi che non hanno un trigger.
+ */
+declare function emptyFlowDefinition(fullName: string, label: string, processType: string, triggerType?: string): FlowDefinition;
 declare class FlowDocumentStore {
     private readonly _document;
     private readonly _isDirty;
@@ -3796,6 +3942,30 @@ declare class FlowLayoutService {
  * contraddicono vince lo stato, per la stessa ragione.
  */
 declare function isVersionActive(version: FlowVersionSummary | undefined): boolean;
+/**
+ * §8, §10 — l'errore riguarda la **presa in carico** del flow, non la sua definizione.
+ *
+ * Sono i due esiti dell'altra meta' dell'attivazione, quella che vale per i tre tipi che non
+ * partono da soli: `MissingService` (su questa installazione nessuno prende in carico quel tipo di
+ * flow) e `RegistrationFailed` (l'host ha rifiutato). Vanno riconosciuti insieme per una ragione
+ * sola: in **entrambi** i casi la versione non e' attiva e lo stato va ricaricato invece di
+ * assumere il successo. Le parole con cui dirli invece sono diverse, e la differenza e' se
+ * «riprova» abbia senso.
+ */
+declare function isRegistrationError(error: unknown): boolean;
+/**
+ * §8 — come si dice all'utente che l'attivazione non e' riuscita.
+ *
+ * Sono due domande diverse e vanno tenute distinte, perche' il rimedio e' diverso. Sulla
+ * **definizione** parla il pannello dei problemi, e il messaggio del backend va bene com'e'. Sulla
+ * **presa in carico** il pannello non ha niente da dire — non e' della definizione che si parla —
+ * e allora la differenza che conta per chi legge e' una sola: se «riprova» abbia senso.
+ *
+ * Sta qui e non nei due componenti che attivano (la barra in cima e il pannello versioni) perche'
+ * con due copie una delle due resta indietro, e la si scopre solo sull'ambiente in cui il servizio
+ * manca davvero.
+ */
+declare function describeActivationError(error: unknown): string;
 /** Cosa mostrare quando il salvataggio incontra una versione modificata da altri (§9). */
 interface FlowConflictState {
     message: string;
@@ -4622,11 +4792,18 @@ interface PaletteGroup {
 declare class ElementPaletteComponent {
     private readonly dictionaries;
     /**
-     * Il `processType` del flow: un flow `AutoLaunched` che contiene screen e' un errore di
-     * validazione, perche' non c'e' nessuno a cui mostrarli (§3.1). La palette lo segnala
+     * Il `processType` del flow: un flow che parte senza nessuno davanti e contiene screen e' un
+     * errore di validazione, perche' non c'e' nessuno a cui mostrarli (§3.1). La palette lo segnala
      * prima che l'utente lo scopra dal pannello dei problemi.
      */
     readonly processType: _angular_core.InputSignal<string | undefined>;
+    /**
+     * §3.4 — l'altra meta' della coppia che fa il tipo di flow. Serve a leggere `allowsScreens` dal
+     * dizionario invece di cablare «AutoLaunched»: la domanda vera non e' quale `processType` sia, ma
+     * se ci sia qualcuno a cui mostrare una schermata — e con i sei tipi le due cose non coincidono
+     * piu' (uno schedulato e un innescato da record sono entrambi `AutoLaunched`).
+     */
+    readonly triggerType: _angular_core.InputSignal<string | undefined>;
     readonly elementPicked: _angular_core.OutputEmitterRef<FlowPalettePick>;
     private readonly filter;
     /** Le voci, con i tipi a varianti già divisi: e' l'elenco che l'utente vede. */
@@ -4641,6 +4818,13 @@ declare class ElementPaletteComponent {
      * l'utente, e in un flow `AutoLaunched` non c'e' nessuno a cui mostrarli.
      */
     isIncompatible(item: PaletteItem): boolean;
+    /**
+     * §3.4 — lo dice il flag `allowsScreens` del tipo di flow. `undefined` significa «non lo so» —
+     * dizionario senza `flowTypes`, o una coppia che non e' fra i sei — e lì si ripiega sulla vecchia
+     * regola cablata, che copre il caso di gran lunga piu' comune senza vietare niente a chi ha un
+     * documento fuori dai sei tipi.
+     */
+    private screensAreAllowed;
     /**
      * Il testo del tooltip. Su una voce che nasce da una variante ci va anche il nome del tipo:
      * e' l'unico posto in cui si vede che «ordina» e «filtra» sono lo stesso elemento.
@@ -4656,7 +4840,7 @@ declare class ElementPaletteComponent {
     faultLabel(item: PaletteItem): string | null;
     categoryClass(category: string): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ElementPaletteComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ElementPaletteComponent, "fb-element-palette", never, { "processType": { "alias": "processType"; "required": false; "isSignal": true; }; }, { "elementPicked": "elementPicked"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ElementPaletteComponent, "fb-element-palette", never, { "processType": { "alias": "processType"; "required": false; "isSignal": true; }; "triggerType": { "alias": "triggerType"; "required": false; "isSignal": true; }; }, { "elementPicked": "elementPicked"; }, never, never, true, never>;
 }
 
 declare class ReferencePickerComponent {
@@ -5221,7 +5405,7 @@ declare class FormulaEditorComponent {
      * dinamico — e riscriverla a ogni tasto costa. La **verifica** parte comunque durante la
      * digitazione: usa la bozza locale, non cio' che e' arrivato al documento.
      */
-    readonly commitOn: _angular_core.InputSignal<"change" | "input">;
+    readonly commitOn: _angular_core.InputSignal<"input" | "change">;
     readonly expressionChange: _angular_core.OutputEmitterRef<string>;
     private readonly area;
     /**
@@ -5809,7 +5993,7 @@ declare class MergeTextEditorComponent {
     readonly disabled: _angular_core.InputSignal<boolean>;
     readonly rows: _angular_core.InputSignal<number>;
     /** Come nel formula editor: `change` dove mutare il documento ridisegna mezza schermata. */
-    readonly commitOn: _angular_core.InputSignal<"change" | "input">;
+    readonly commitOn: _angular_core.InputSignal<"input" | "change">;
     readonly textChange: _angular_core.OutputEmitterRef<string>;
     private readonly area;
     /**
@@ -6154,7 +6338,29 @@ declare class StartInspectorComponent {
     readonly start: _angular_core.Signal<FlowStart>;
     readonly startNode: _angular_core.Signal<FlowAnyNode>;
     readonly outlets: _angular_core.Signal<_esfaenza_flow_builder.FlowOutlet[]>;
+    /**
+     * §3.4 — i trigger proponibili sono quelli del **tipo di flow**, non tutti: un flow `Screen` non
+     * diventa schedulato cambiando una tendina, perche' il tipo lo si sceglie alla creazione. Dove il
+     * tipo non si riconosce — dizionario senza `flowTypes`, oppure una coppia che non e' fra i sei —
+     * si torna all'elenco intero: e' un ripiego, e togliere opzioni a chi ha un documento fuori dai
+     * sei tipi lo bloccherebbe sul valore che ha.
+     */
     readonly triggerTypes: _angular_core.Signal<_esfaenza_flow_builder.FlowDictionaryEntry[]>;
+    /** Il tipo di flow, cioe' `processType` + `triggerType` letti insieme (§3.4). */
+    readonly flowType: _angular_core.Signal<_esfaenza_flow_builder.FlowFlowTypeEntry | undefined>;
+    /**
+     * §3.4 — il tipo non parte da solo e l'attivazione lo **registra** presso l'host. Si dice qui,
+     * perche' e' l'unico posto in cui si vede *perche'*: e' questo trigger a richiedere qualcuno che
+     * lo prenda in carico, e l'attivazione puo' fallire per quello e non per la definizione (§8).
+     */
+    readonly requiresRegistration: _angular_core.Signal<boolean>;
+    /**
+     * **Chi** deve prenderlo in carico, con il nome che gli da' l'host: «il pianificatore», «il bus
+     * degli eventi». Viene da `registrationKinds`, non da una mappa cablata — e dove il dizionario non
+     * lo dichiara resta vuoto, e la frase parla genericamente di infrastruttura: e' meglio di un nome
+     * inventato che poi nei log dell'ambiente non compare.
+     */
+    readonly registrationLabel: _angular_core.Signal<string>;
     readonly recordTriggerTypes: _angular_core.Signal<_esfaenza_flow_builder.FlowDictionaryEntry[]>;
     readonly frequencies: _angular_core.Signal<_esfaenza_flow_builder.FlowDictionaryEntry[]>;
     readonly offsetUnits: _angular_core.Signal<_esfaenza_flow_builder.FlowDictionaryEntry[]>;
@@ -6167,6 +6373,7 @@ declare class StartInspectorComponent {
     /** I rilievi sul documento, che e' dove finiscono quelli dello Start (§7). */
     readonly issues: _angular_core.Signal<_esfaenza_flow_builder.FlowValidationIssue[]>;
     setTriggerType(value: string): void;
+    setEventField(field: 'eventType' | 'eventName', value: string): void;
     setObject(value: string): void;
     setRecordTriggerType(value: string): void;
     setRequireChanged(value: boolean): void;
@@ -6647,6 +6854,8 @@ declare class DynamicScreenInspectorComponent extends NodeInspectorBase {
     setProvidedField(value: string | undefined): void;
     readonly screenActions: _angular_core.Signal<FlowScreenAction[]>;
     readonly screenTriggers: _angular_core.Signal<FlowScreenTrigger[]>;
+    /** §5.2 — le regole della **schermata**: quelle che nessun campo puo' esprimere. */
+    readonly screenRules: _angular_core.Signal<FlowScreenRule[]>;
     /** Quale action e' aperta nel dettaglio; `null` = solo l'elenco. */
     private readonly actionSelection;
     readonly selectedActionIndex: _angular_core.Signal<number | null>;
@@ -6742,6 +6951,27 @@ declare class DynamicScreenInspectorComponent extends NodeInspectorBase {
      * l'action gira a ogni cambio del campo: un blocco vuoto si omette invece di scriverlo (§2).
      */
     onTriggerConditionsChanged(index: number, mutate: (holder: FlowConditionHolder) => void): void;
+    /**
+     * §5.2 — una regola nuova nasce **con le condizioni**, non con la formula, ed e' il consiglio che
+     * conta: `IsEmpty` su una collection e' un operatore che il **runtime** valuta, mentre la stessa
+     * domanda scritta in una formula chiede al motore una funzione che potrebbe non avere. Vale in
+     * particolare per la verifica piu' frequente — che una sezione ripetibile abbia almeno una riga.
+     */
+    addScreenRule(): void;
+    removeScreenRule(index: number): void;
+    private patchScreenRule;
+    setScreenRuleProperty(index: number, property: 'errorMessage' | 'fieldName', value: string): void;
+    /**
+     * Le condizioni di una regola sono quelle di una Decision, formula compresa: qui `Formula` e' un
+     * `conditionLogic` ammesso (§5.2), a differenza di un `filterLogic`. Il blocco vuoto **non** si
+     * cancella come per un trigger — lì assente significa «gira sempre», qui una regola senza
+     * condizioni non verifica niente ed e' un difetto da vedere, non da nascondere.
+     */
+    onScreenRuleConditionsChanged(index: number, mutate: (holder: FlowConditionHolder) => void): void;
+    /** §5.2 — `errorMessage` e' obbligatorio: senza, la schermata non avanza e non dice perche'. */
+    screenRuleHasNoMessage(rule: FlowScreenRule): boolean;
+    /** §5.2 — una regola senza condizioni (e senza formula) non verifica niente. */
+    screenRuleIsEmpty(rule: FlowScreenRule): boolean;
     setScreenText(property: string, value: string): void;
     /** I flag con default `true` si scrivono solo quando si nega, per non sporcare il diff. */
     setScreenFlag(flag: 'allowBack' | 'allowFinish' | 'allowPause' | 'showHeader' | 'showFooter', value: boolean): void;
@@ -7567,7 +7797,33 @@ declare class FlowBuilderComponent {
      * nell'interfaccia; il controllo qui e' perché la chiamata resta pubblica.
      */
     setProcessType(value: string): void;
+    /**
+     * §3.4 — cio' che l'utente sceglie alla creazione e' il **tipo di flow**, non il `processType`:
+     * quello si ricava, insieme al `triggerType`, dalla voce di `flowTypes`.
+     *
+     * I due campi si scrivono in **una** mutazione: con due, l'annulla riporterebbe indietro il
+     * trigger lasciando il `processType` nuovo, cioe' una coppia che non e' nessuno dei sei tipi.
+     * Vale la stessa regola del `setProcessType` qui sopra — si sceglie alla creazione e poi non si
+     * tocca — e per la stessa ragione: cambiarlo su un documento già scritto lo riempie di
+     * riferimenti a globali che da quel momento non esistono, e nessuna primitiva rimedia. Il
+     * contratto ammette il cambio (riscrivere la coppia), ma non obbliga a offrirlo.
+     */
+    setFlowType(value: string): void;
     readonly processTypes: _angular_core.Signal<_esfaenza_flow_builder.FlowDictionaryEntry[]>;
+    /**
+     * I sei tipi di flow (§3.4). Elenco vuoto = il dizionario non li dichiara, e allora la scelta
+     * torna a essere il solo `processType`: e' un ripiego, non un difetto — un host che non espone
+     * `flowTypes` deve poter creare flow lo stesso.
+     */
+    readonly flowTypes: _angular_core.Signal<_esfaenza_flow_builder.FlowFlowTypeEntry[]>;
+    /** Il tipo di flow del documento: la coppia `processType` + `triggerType` letta in un posto solo. */
+    readonly flowType: _angular_core.Signal<_esfaenza_flow_builder.FlowFlowTypeEntry | undefined>;
+    /**
+     * L'etichetta del tipo, per il flow salvato dove non e' piu' una scelta. Dove la coppia non e'
+     * uno dei sei — un `Evaluation`, un'orchestrazione senza trigger: e' il `flowType: null` del
+     * contratto — si mostra il `processType`, che resta l'informazione vera.
+     */
+    readonly flowTypeLabel: _angular_core.Signal<string>;
     /**
      * Il tipo scritto per esteso, per il flow salvato dove non e' più una scelta. Fuori catalogo
      * si mostra il valore grezzo: e' del backend, non nostro da correggere (vedi
@@ -7862,5 +8118,5 @@ declare class SelectValueDirective implements AfterViewChecked {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SelectValueDirective, "select[fbValue]", never, { "fbValue": { "alias": "fbValue"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-export { ConditionEditorComponent, ConnectorEditorComponent, DebugPanelComponent, DynamicScreenInspectorComponent, ENUM_CHOICE_SET_DEFAULT_DISPLAY_FIELD, ENUM_CHOICE_SET_DEFAULT_VALUE_FIELD, ENUM_CHOICE_SET_FIELDS, ElementDialogComponent, ElementInspectorComponent, ElementPaletteComponent, EnumValuePickerComponent, FALLBACK_COLLECTION_BY_TYPE, FALLBACK_TYPE_LABEL, FLOW_BUILDER_HTTP_CONFIG, FLOW_CLIPBOARD_KIND, FLOW_CLIPBOARD_VERSION, FLOW_ELEMENT_ICONS, FLOW_ELEMENT_VARIANT_FIELDS, FLOW_ELEMENT_VARIANT_ICONS, FLOW_ERROR_FALLBACK_MESSAGE, FLOW_ERROR_HTTP_STATUS, FLOW_FOLD_HEIGHT, FLOW_FOLD_WIDTH, FLOW_GROUP_COLORS, FLOW_NAME_PATTERN, FLOW_NODE_COLLECTIONS, FLOW_NODE_HEIGHT, FLOW_NODE_WIDTH, FLOW_REFERENCE_FIELDS, FLOW_RESOURCE_COLLECTIONS, FLOW_VALUE_FIELDS, FLOW_VALUE_LITERAL_FIELDS, FieldAssignmentEditorComponent, FieldPickerComponent, FieldValuePickerComponent, FlowApiError, FlowBuilderApi, FlowBuilderComponent, FlowCanvasComponent, FlowCatalogStore, FlowClipboardService, FlowDictionaryStore, FlowDocumentStore, FlowEditorSession, FlowLayoutService, FlowValidationStore, FormulaEditorComponent, FormulaValidationService, GROUP_HEADER_HEIGHT, GROUP_MIN_HEIGHT, GROUP_MIN_WIDTH, GROUP_PADDING, GroupPanelComponent, HttpFlowBuilderApi, MergeTextEditorComponent, NamePickerComponent, NodeInspectorBase, ORCHESTRATION_CONDITION_OUTPUT, ObjectPickerComponent, OrchestratedStageInspectorComponent, ParameterEditorComponent, PasteDialogComponent, ProblemsPanelComponent, RecordFilterEditorComponent, ReferencePickerComponent, ResourceDialogComponent, ResourceFormComponent, ResourcePanelComponent, RunDialogComponent, SEVERITY_BUCKETS, SEVERITY_ICON, SEVERITY_LABEL, START_NODE_NAME, SelectValueDirective, StartInspectorComponent, StructureMemberPickerComponent, StructurePickerComponent, TYPES_WITH_AUTOMATIC_OUTPUT, TYPE_BY_COLLECTION, UNSUPPORTED_TYPES, ValueEditorComponent, VersionPanelComponent, allFieldsOf, applyPaste, areTypesComparable, boundsAround, buildClipboardPayload, canvasFoldId, canvasGroupId, canvasNodeId, checkConditionLogic, checkFlowName, choiceSetSourceOf, declaredChoiceSetSources, describeFieldPath, describePathEntry, duplicateField, elementIcon, emptyFlowDefinition, enumChoiceSetFieldType, fieldAt, filterReferences, flattenFields, flowNodeWidth, flowNodeWidthClass, foldSourceConnectorId, foldTargetConnectorId, groupColorClass, groupRect, hasAutoSize, innerNamesOf, insertField, isClipboardPayload, isCustomConditionLogic, isEmptyReferenceFilter, isFieldResource, isFoldReference, isGlobalReference, isNumericType, isPathInside, isTypeCheckedOperator, isUnknownEnumChoiceSetField, isValidFlowName, isValued, isVersionActive, loadPathLevel, matchesReferenceFilter, membersInside, moveCondition, moveField, navigatePath, otherSourceFieldsOf, outletByKey, outletsOf, parseCanvasFoldId, parseCanvasGroupId, parseCanvasNodeId, parseFieldPath, parseInvariantNumber, parseSourceConnectorId, parseTargetConnectorId, pathAvailableNames, pathContainerLabel, pathKey, pathNotVerifiableMessage, planPaste, recomputeMembers, referenceRoot, referencedRootsOf, remapConditionLogic, removeCondition, removeField, repeatedFieldNames, repeatingSectionOf, resolvePath, resourceFieldsOf, rewriteReferences, sameMembers, samePath, screenActionNames, screenFieldNames, severityBucket, slugifyFlowName, sourceConnectorId, stageStepNames, stageStepOutputReferenced, stepsOf, targetConnectorId, typeOfCollection, uniqueFlowName, valuedFieldOf, valuedFieldsOf, variantFieldOf, variantOf, variantPresetOf };
-export type { ChoiceSetSource, FieldAssignmentHolder, FilterFieldOption, FilterHolder, FlowActionCall, FlowAnyNode, FlowAssignment, FlowAssignmentItem, FlowAssignmentOperator, FlowAssignmentOperatorEntry, FlowBuilderHttpConfig, FlowCanvasEdge, FlowCanvasFold, FlowCanvasGroup, FlowCanvasNode, FlowCatalogEntry, FlowCatalogParameter, FlowChoice, FlowClipboardNode, FlowClipboardPayload, FlowClipboardResource, FlowCloneRequest, FlowCollectionProcessor, FlowCollectionProcessorType, FlowComparisonOperator, FlowComparisonOperatorEntry, FlowCondition, FlowConditionHolder, FlowConditionLogic, FlowConflictState, FlowConnectionKind, FlowConnector, FlowConnectorTarget, FlowConstant, FlowCreateRequest, FlowCustomError, FlowCustomErrorMessage, FlowCustomProperty, FlowDataType, FlowDataTypeEntry, FlowDecision, FlowDecisionRule, FlowDefinition, FlowDictionaries, FlowDictionaryEntry, FlowDynamicChoiceSet, FlowDynamicScreen, FlowEdge, FlowElementType, FlowElementTypeEntry, FlowEnumValue, FlowErrorCategory, FlowExportQuery, FlowFieldDescription, FlowFieldUsage, FlowFieldValue, FlowFormKind, FlowFormula, FlowFormulaFunction, FlowFormulaFunctionParameter, FlowFormulaIssue, FlowFormulaUsage, FlowFormulaValidationRequest, FlowFormulaValidationResult, FlowGlobalVariableEntry, FlowGroup, FlowGroupRef, FlowGroupTarget, FlowInputFieldAssignment, FlowInputParameter, FlowInterviewResult, FlowInterviewStatus, FlowIssueSeverity, FlowLayoutDirection, FlowLayoutNodeInput, FlowLayoutOptions, FlowLayoutResult, FlowListQuery, FlowLoop, FlowNameCheck, FlowNameProblem, FlowNewVersionRequest, FlowNodeBase, FlowNodeCollection, FlowNodeRef, FlowObjectDescription, FlowObjectSummary, FlowOffsetUnit, FlowOrchestratedStage, FlowOutlet, FlowOutline, FlowOutlineConnection, FlowOutlineGroup, FlowOutlineNode, FlowOutputFieldAssignment, FlowOutputParameter, FlowPalettePick, FlowPastePlan, FlowPasteRename, FlowPasteResource, FlowPendingScreen, FlowProcessType, FlowRecordCreate, FlowRecordDelete, FlowRecordFilter, FlowRecordFilterOperator, FlowRecordLookup, FlowRecordRollback, FlowRecordTriggerType, FlowRecordUpdate, FlowRecordValue, FlowRect, FlowReference, FlowReferenceFilter, FlowReferenceKind, FlowRegionContainerType, FlowResourceCollection, FlowResourceEdit, FlowResourceKindEntry, FlowResourceRef, FlowResourceTarget, FlowResumeRequest, FlowRunOutcome, FlowRunRequest, FlowSaveRequest, FlowSaveResult, FlowSchedule, FlowScheduledPath, FlowScreen, FlowScreenAction, FlowScreenField, FlowScreenFieldInputsRevisited, FlowScreenFieldNode, FlowScreenFieldPath, FlowScreenFieldType, FlowScreenFieldTypeEntry, FlowScreenFieldTypeResolver, FlowScreenNavigation, FlowScreenResponseRequest, FlowScreenTrigger, FlowScreenTriggerInitBehavior, FlowScreenValidationRule, FlowScriptPluginCall, FlowSeverityBucket, FlowSortOption, FlowSortOrder, FlowStage, FlowStageStep, FlowStageStepActionType, FlowStageStepAssignee, FlowStageStepConditionActionType, FlowStageStepRequest, FlowStageStepState, FlowStageStepStatus, FlowStageStepTypeEntry, FlowStart, FlowStartInterviewRequest, FlowStructureDescribed, FlowStructureDescription, FlowStructureInstance, FlowStructureMember, FlowSubflow, FlowSubflowInputAssignment, FlowSubflowOutputAssignment, FlowSummary, FlowTextTemplate, FlowTraceEntry, FlowTransactionModel, FlowTransform, FlowTransformType, FlowTransformValue, FlowTransformValueAction, FlowTriggerType, FlowTypedEntry, FlowTypedValue, FlowUnsupportedNode, FlowValidationIssue, FlowValidationResult, FlowValue, FlowVariable, FlowVersionStatus, FlowVersionSummary, FlowWait, FlowWaitEvent, NamePickerOption, PaletteGroup, PaletteItem, ParameterHolder, PathCatalog, PathContainer, PathContainerKind, PathEntry, PathLevel, PathLevelStatus, PathNavigation, PathNavigationRequest, PathResolution, PathStopReason, PathValueSet, StructureMemberUsage, ValueMode };
+export { ConditionEditorComponent, ConnectorEditorComponent, DebugPanelComponent, DynamicScreenInspectorComponent, ENUM_CHOICE_SET_DEFAULT_DISPLAY_FIELD, ENUM_CHOICE_SET_DEFAULT_VALUE_FIELD, ENUM_CHOICE_SET_FIELDS, ElementDialogComponent, ElementInspectorComponent, ElementPaletteComponent, EnumValuePickerComponent, FALLBACK_COLLECTION_BY_TYPE, FALLBACK_TYPE_LABEL, FLOW_BUILDER_HTTP_CONFIG, FLOW_CLIPBOARD_KIND, FLOW_CLIPBOARD_VERSION, FLOW_ELEMENT_ICONS, FLOW_ELEMENT_VARIANT_FIELDS, FLOW_ELEMENT_VARIANT_ICONS, FLOW_ERROR_FALLBACK_MESSAGE, FLOW_ERROR_HTTP_STATUS, FLOW_FOLD_HEIGHT, FLOW_FOLD_WIDTH, FLOW_GROUP_COLORS, FLOW_NAME_PATTERN, FLOW_NODE_COLLECTIONS, FLOW_NODE_HEIGHT, FLOW_NODE_WIDTH, FLOW_REFERENCE_FIELDS, FLOW_RESOURCE_COLLECTIONS, FLOW_VALUE_FIELDS, FLOW_VALUE_LITERAL_FIELDS, FieldAssignmentEditorComponent, FieldPickerComponent, FieldValuePickerComponent, FlowApiError, FlowBuilderApi, FlowBuilderComponent, FlowCanvasComponent, FlowCatalogStore, FlowClipboardService, FlowDictionaryStore, FlowDocumentStore, FlowEditorSession, FlowLayoutService, FlowValidationStore, FormulaEditorComponent, FormulaValidationService, GROUP_HEADER_HEIGHT, GROUP_MIN_HEIGHT, GROUP_MIN_WIDTH, GROUP_PADDING, GroupPanelComponent, HttpFlowBuilderApi, MergeTextEditorComponent, NamePickerComponent, NodeInspectorBase, ORCHESTRATION_CONDITION_OUTPUT, ObjectPickerComponent, OrchestratedStageInspectorComponent, ParameterEditorComponent, PasteDialogComponent, ProblemsPanelComponent, RecordFilterEditorComponent, ReferencePickerComponent, ResourceDialogComponent, ResourceFormComponent, ResourcePanelComponent, RunDialogComponent, SEVERITY_BUCKETS, SEVERITY_ICON, SEVERITY_LABEL, START_NODE_NAME, SelectValueDirective, StartInspectorComponent, StructureMemberPickerComponent, StructurePickerComponent, TYPES_WITH_AUTOMATIC_OUTPUT, TYPE_BY_COLLECTION, UNSUPPORTED_TYPES, ValueEditorComponent, VersionPanelComponent, allFieldsOf, applyPaste, areTypesComparable, boundsAround, buildClipboardPayload, canvasFoldId, canvasGroupId, canvasNodeId, checkConditionLogic, checkFlowName, choiceSetSourceOf, declaredChoiceSetSources, describeActivationError, describeFieldPath, describePathEntry, duplicateField, elementIcon, emptyFlowDefinition, enumChoiceSetFieldType, fieldAt, filterReferences, flattenFields, flowNodeWidth, flowNodeWidthClass, foldSourceConnectorId, foldTargetConnectorId, groupColorClass, groupRect, hasAutoSize, innerNamesOf, insertField, isClipboardPayload, isCustomConditionLogic, isEmptyReferenceFilter, isFieldResource, isFoldReference, isGlobalReference, isNumericType, isPathInside, isRegistrationError, isTypeCheckedOperator, isUnknownEnumChoiceSetField, isValidFlowName, isValued, isVersionActive, loadPathLevel, matchesReferenceFilter, membersInside, moveCondition, moveField, navigatePath, otherSourceFieldsOf, outletByKey, outletsOf, parseCanvasFoldId, parseCanvasGroupId, parseCanvasNodeId, parseFieldPath, parseInvariantNumber, parseSourceConnectorId, parseTargetConnectorId, pathAvailableNames, pathContainerLabel, pathKey, pathNotVerifiableMessage, planPaste, recomputeMembers, referenceRoot, referencedRootsOf, remapConditionLogic, removeCondition, removeField, repeatedFieldNames, repeatingSectionOf, resolvePath, resourceFieldsOf, rewriteReferences, sameMembers, samePath, screenActionNames, screenFieldNames, severityBucket, slugifyFlowName, sourceConnectorId, stageStepNames, stageStepOutputReferenced, stepsOf, targetConnectorId, typeOfCollection, uniqueFlowName, valuedFieldOf, valuedFieldsOf, variantFieldOf, variantOf, variantPresetOf };
+export type { ChoiceSetSource, FieldAssignmentHolder, FilterFieldOption, FilterHolder, FlowActionCall, FlowAnyNode, FlowAssignment, FlowAssignmentItem, FlowAssignmentOperator, FlowAssignmentOperatorEntry, FlowBuilderHttpConfig, FlowCanvasEdge, FlowCanvasFold, FlowCanvasGroup, FlowCanvasNode, FlowCatalogEntry, FlowCatalogParameter, FlowChoice, FlowClipboardNode, FlowClipboardPayload, FlowClipboardResource, FlowCloneRequest, FlowCollectionProcessor, FlowCollectionProcessorType, FlowComparisonOperator, FlowComparisonOperatorEntry, FlowCondition, FlowConditionHolder, FlowConditionLogic, FlowConflictState, FlowConnectionKind, FlowConnector, FlowConnectorTarget, FlowConstant, FlowCreateRequest, FlowCustomError, FlowCustomErrorMessage, FlowCustomProperty, FlowDataType, FlowDataTypeEntry, FlowDecision, FlowDecisionRule, FlowDefinition, FlowDictionaries, FlowDictionaryEntry, FlowDynamicChoiceSet, FlowDynamicScreen, FlowEdge, FlowElementType, FlowElementTypeEntry, FlowEnumValue, FlowErrorCategory, FlowExportQuery, FlowFieldDescription, FlowFieldUsage, FlowFieldValue, FlowFlowTypeEntry, FlowFormKind, FlowFormula, FlowFormulaFunction, FlowFormulaFunctionParameter, FlowFormulaIssue, FlowFormulaUsage, FlowFormulaValidationRequest, FlowFormulaValidationResult, FlowGlobalVariableEntry, FlowGroup, FlowGroupRef, FlowGroupTarget, FlowInputFieldAssignment, FlowInputParameter, FlowInterviewResult, FlowInterviewStatus, FlowIssueSeverity, FlowLayoutDirection, FlowLayoutNodeInput, FlowLayoutOptions, FlowLayoutResult, FlowListQuery, FlowLoop, FlowNameCheck, FlowNameProblem, FlowNewVersionRequest, FlowNodeBase, FlowNodeCollection, FlowNodeRef, FlowObjectDescription, FlowObjectSummary, FlowOffsetUnit, FlowOrchestratedStage, FlowOutlet, FlowOutline, FlowOutlineConnection, FlowOutlineGroup, FlowOutlineNode, FlowOutputFieldAssignment, FlowOutputParameter, FlowPalettePick, FlowPastePlan, FlowPasteRename, FlowPasteResource, FlowPendingScreen, FlowProcessType, FlowRecordCreate, FlowRecordDelete, FlowRecordFilter, FlowRecordFilterOperator, FlowRecordLookup, FlowRecordRollback, FlowRecordTriggerType, FlowRecordUpdate, FlowRecordValue, FlowRect, FlowReference, FlowReferenceFilter, FlowReferenceKind, FlowRegionContainerType, FlowResourceCollection, FlowResourceEdit, FlowResourceKindEntry, FlowResourceRef, FlowResourceTarget, FlowResumeRequest, FlowRunOutcome, FlowRunRequest, FlowSaveRequest, FlowSaveResult, FlowSchedule, FlowScheduledPath, FlowScreen, FlowScreenAction, FlowScreenField, FlowScreenFieldInputsRevisited, FlowScreenFieldNode, FlowScreenFieldPath, FlowScreenFieldType, FlowScreenFieldTypeEntry, FlowScreenFieldTypeResolver, FlowScreenNavigation, FlowScreenResponseRequest, FlowScreenRule, FlowScreenTrigger, FlowScreenTriggerInitBehavior, FlowScreenValidationRule, FlowScriptPluginCall, FlowSeverityBucket, FlowSortOption, FlowSortOrder, FlowStage, FlowStageStep, FlowStageStepActionType, FlowStageStepAssignee, FlowStageStepConditionActionType, FlowStageStepRequest, FlowStageStepState, FlowStageStepStatus, FlowStageStepTypeEntry, FlowStart, FlowStartInterviewRequest, FlowStructureDescribed, FlowStructureDescription, FlowStructureInstance, FlowStructureMember, FlowSubflow, FlowSubflowInputAssignment, FlowSubflowOutputAssignment, FlowSummary, FlowTextTemplate, FlowTraceEntry, FlowTransactionModel, FlowTransform, FlowTransformType, FlowTransformValue, FlowTransformValueAction, FlowTriggerType, FlowTypedEntry, FlowTypedValue, FlowUnsupportedNode, FlowValidationIssue, FlowValidationResult, FlowValue, FlowVariable, FlowVersionStatus, FlowVersionSummary, FlowWait, FlowWaitEvent, NamePickerOption, PaletteGroup, PaletteItem, ParameterHolder, PathCatalog, PathContainer, PathContainerKind, PathEntry, PathLevel, PathLevelStatus, PathNavigation, PathNavigationRequest, PathResolution, PathStopReason, PathValueSet, StructureMemberUsage, ValueMode };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esfaenza/flow-builder",
-  "version": "20.3.46",
+  "version": "20.3.47",
   "peerDependencies": {
     "@angular/cdk": "^20.2.14",
     "@angular/common": "^20.3.28",