@esfaenza/flow-builder 20.3.56 → 20.3.58

package/index.d.ts

@@ -390,6 +390,11 @@ interface FlowScreenField {
  * validazione compresi. Cambia una cosa sola, e riguarda l'editor: l'`assignToReference` di un
  * `outputParameters` accetta anche i **campi di questa schermata**, che ovunque altrove sono di sola
  * lettura.
+ *
+ * Dove le destinazioni possano stare dipende da **chi** la invoca, non dall'action: con un trigger su
+ * un campo di riga gira per ogni riga e scrive nei membri del cursore, con uno di primo livello il
+ * cursore non porta nessuna riga (`SCREEN_ACTION_ROW_TARGET_INVALID`, *Una screen action per ogni
+ * riga*). La regola e' `screenActionRowTargetIssues`.
  */
 interface FlowScreenAction {
     /**
@@ -424,7 +429,11 @@ type FlowScreenTriggerInitBehavior = 'runOnLoad' | string;
 interface FlowScreenTrigger extends FlowConditionHolder {
     /** Una delle `actions` **dello stesso screen**: altrimenti `SCREEN_ACTION_UNKNOWN`. */
     screenActionName?: string;
-    /** Un campo **di questo screen**: altrimenti `SCREEN_TRIGGER_FIELD_UNKNOWN`. */
+    /**
+     * Un campo **di questo screen**: altrimenti `SCREEN_TRIGGER_FIELD_UNKNOWN`. Anche uno dentro una
+     * sezione ripetibile — l'unico posto in cui il nome di un campo di riga si scrive — e allora l'action
+     * gira per ogni riga in cui quel campo e' cambiato (§5.2).
+     */
     triggerFieldName?: string;
     initBehavior?: FlowScreenTriggerInitBehavior;
 }
@@ -1349,6 +1358,10 @@ interface FlowSummary {
     activeVersion?: number | null;
     latestVersion?: number;
     versionCount?: number;
+    /**
+     * Esiste una **bozza** (§6.1). Conta le sole bozze: una versione superata e' modificabile ma non
+     * e' una bozza finche' nessuno la salva, quindi non e' `isEditable` di una riga qualunque.
+     */
     hasDraft?: boolean;
     updatedAt?: string;
     /** Esiste una versione attiva. Non ricalcolarlo lato client (§6.1). */
@@ -1368,7 +1381,10 @@ interface FlowVersionSummary {
     updatedAt?: string;
     updatedBy?: string | null;
     isActive?: boolean;
-    /** La versione e' una bozza. Non ricalcolarlo lato client (§6.1). */
+    /**
+     * La versione **non e' quella attiva**: una bozza o una superata (§6.1, §8). Non ricalcolarlo lato
+     * client, e non leggerlo come «e' una bozza» — per quello c'e' `status`.
+     */
     isEditable?: boolean;
 }
 interface FlowListQuery {
@@ -1886,7 +1902,9 @@ declare abstract class FlowBuilderApi {
     /** `POST /flows` — crea la versione 1. `AlreadyExists` se il nome e' già usato. */
     abstract createFlow(request: FlowCreateRequest): Promise<FlowSaveResult>;
     /**
-     * `PUT /flows/{name}` — salva sulla bozza esistente o ne crea una nuova versione.
+     * `PUT /flows/{name}` — salva sulla versione indicata, una bozza o una superata, o ne crea una
+     * nuova (§8). Sulla versione attiva rifiuta con `NotEditable`; una superata, salvata, torna bozza
+     * e lo dice lo `status` della risposta. Senza `version` sovrascrive l'ultima solo se e' una bozza.
      * Riesce **anche con errori** di validazione: l'esito sano si legge in
      * `FlowSaveResult.validation`, non nell'assenza di eccezione (§6.2).
      */
@@ -1903,7 +1921,7 @@ declare abstract class FlowBuilderApi {
     abstract activateVersion(flowName: string, version: number): Promise<FlowSaveResult>;
     /** `POST /flows/{name}/deactivate` — il flow non e' piu' eseguibile. */
     abstract deactivateFlow(flowName: string): Promise<void>;
-    /** `DELETE /flows/{name}/versions/{v}` — rifiutata sulla versione attiva. */
+    /** `DELETE /flows/{name}/versions/{v}` — rifiutata sulla versione attiva, con `NotEditable` (§10). */
     deleteVersion(flowName: string, version: number): Promise<void>;
     /** `DELETE /flows/{name}` — rifiutata se esiste una versione attiva. */
     deleteFlow(flowName: string): Promise<void>;
@@ -2701,9 +2719,11 @@ type FlowScreenFieldTypeResolver = (field: FlowScreenField) => FlowScreenFieldTy
  * esiste una volta per elemento della collection: il loro nome non individua alcun valore.
  *
  * Da qui discende tutto cio' che l'editor fa di diverso lì dentro. Non sono risorse del flow, non si
- * propongono fra i riferimenti, non innescano screen action e non sono destinazioni: nominarli e'
- * `SCREEN_FIELD_IN_REPEATER`. Dentro una riga si nomina il **cursore** (`itemReference`), che e' una
- * variabile vera — `PuntoCorrente.PodId`, mai `Luce_POD`.
+ * propongono fra i riferimenti e non sono destinazioni: nominarli e' `SCREEN_FIELD_IN_REPEATER`. Dentro
+ * una riga si nomina il **cursore** (`itemReference`), che e' una variabile vera — `PuntoCorrente.PodId`,
+ * mai `Luce_POD`. L'unico posto in cui il nome di un campo di riga si scrive e' `triggerFieldName`: un
+ * trigger nomina un **campo della schermata**, non un riferimento, e l'action gira per riga
+ * ({@link triggerRowSectionOf}).
  *
  * Cio' che invece **non** cambia: il nome resta unico, perche' e' l'indirizzo con cui il frontend rende
  * il campo, quindi un omonimo di una variabile e' `NAME_DUPLICATED` come sempre e `screenFieldNames` li
@@ -2712,8 +2732,8 @@ type FlowScreenFieldTypeResolver = (field: FlowScreenField) => FlowScreenFieldTy
 declare function repeatedFieldNames(definition: FlowDefinition | undefined, typeOf: FlowScreenFieldTypeResolver): Set<string>;
 /**
  * I campi di una schermata che sono **risorse del flow**: raccolgono un valore e non stanno dentro una
- * riga. Sono gli unici da proporre come riferimento, come innesco di una screen action e come
- * destinazione dei suoi output.
+ * riga. Sono gli unici da proporre come riferimento e come destinazione degli output di una screen
+ * action; come **innesco** no — lì valgono anche quelli di riga, e l'elenco e' {@link triggerableFieldsOf}.
  */
 declare function resourceFieldsOf(screen: FlowDynamicScreen | undefined, typeOf: FlowScreenFieldTypeResolver): FlowScreenField[];
 /**
@@ -2722,6 +2742,83 @@ declare function resourceFieldsOf(screen: FlowDynamicScreen | undefined, typeOf:
  * un campo di una riga», che sono due pannelli diversi.
  */
 declare function repeatingSectionOf(screen: FlowDynamicScreen | undefined, path: FlowScreenFieldPath | null, typeOf: FlowScreenFieldTypeResolver): FlowScreenField | undefined;
+/** Le sezioni ripetibili di una schermata, in ordine di visita. */
+declare function repeatingSectionsOf(screen: FlowDynamicScreen | undefined, typeOf: FlowScreenFieldTypeResolver): FlowScreenField[];
+/** Un campo che puo' innescare una screen action, con la sezione che lo contiene se e' un campo di riga. */
+interface FlowTriggerableField {
+    field: FlowScreenField;
+    /** C'e' = l'action che il campo innesca gira **per riga** di questa sezione. */
+    section?: FlowScreenField;
+}
+/**
+ * §5.2 — i campi che possono innescare una screen action: quelli che raccolgono un valore, **compresi**
+ * quelli dentro una riga. È l'unica domanda a cui un campo di riga risponde come uno di primo livello:
+ * `triggerFieldName` nomina un campo della schermata e non un riferimento, e il trigger non deve dire
+ * *quale* riga osserva — l'action gira una volta per ogni riga in cui il campo e' cambiato.
+ *
+ * Il criterio del valore e' lo stesso di {@link isFieldResource} sul solo campo: un contenitore non
+ * cambia, un `ComponentInstance` non ha un valore proprio.
+ */
+declare function triggerableFieldsOf(screen: FlowDynamicScreen | undefined, typeOf: FlowScreenFieldTypeResolver): FlowTriggerableField[];
+/**
+ * Dove gira l'action di un trigger. `screen` e' il caso di sempre — un campo di primo livello, o nessun
+ * campo e il solo `runOnLoad` — e l'action gira una volta; `row` e' il campo di una riga, e l'action gira
+ * per ogni riga della sezione. `unknown` e' un campo che la schermata non ha: e' gia'
+ * `SCREEN_TRIGGER_FIELD_UNKNOWN`, e dedurne altro accuserebbe due volte la stessa svista.
+ */
+type FlowScreenTriggerScope = {
+    kind: 'screen';
+} | {
+    kind: 'row';
+    section: FlowScreenField;
+} | {
+    kind: 'unknown';
+};
+declare function triggerScopeOf(screen: FlowDynamicScreen | undefined, trigger: FlowScreenTrigger, typeOf: FlowScreenFieldTypeResolver): FlowScreenTriggerScope;
+/**
+ * Le sezioni per le cui righe gira un'action, e se gira anche per la schermata. Piu' trigger possono
+ * invocare la stessa action, quindi le due cose non si escludono — ed e' proprio lì che le destinazioni
+ * giuste per l'uno diventano sbagliate per l'altro ({@link screenActionRowTargetIssues}).
+ */
+declare function screenActionScopes(screen: FlowDynamicScreen | undefined, action: FlowScreenAction, typeOf: FlowScreenFieldTypeResolver): {
+    sections: FlowScreenField[];
+    runsForScreen: boolean;
+};
+/**
+ * Perche' una destinazione e' `SCREEN_ACTION_ROW_TARGET_INVALID`. I primi quattro valgono per un'action
+ * che gira **per riga**, l'ultimo per una che gira per la schermata: e' la stessa regola vista dai due
+ * lati — la riga si scrive attraverso il cursore, e il cursore esiste solo dentro la riga.
+ */
+type FlowScreenActionRowTargetReason = 'wholeCursor' | 'collection' | 'otherSection' | 'automaticOutput' | 'cursorOutsideRow';
+interface FlowScreenActionRowTargetIssue {
+    /** L'indice in `outputParameters`; assente = e' `storeOutputAutomatically`, che non ha un output suo. */
+    outputIndex?: number;
+    /** La destinazione accusata, com'e' scritta. */
+    target?: string;
+    /** Il trigger che rende quella destinazione irraggiungibile: il contratto chiede di dire quale. */
+    triggerIndex: number;
+    reason: FlowScreenActionRowTargetReason;
+    message: string;
+}
+/**
+ * §5.2, *Una screen action per ogni riga* — le destinazioni che un'action non puo' raggiungere, dato
+ * **chi** la invoca. Il rilievo e' dell'output e non del trigger perche' e' lì che si corregge, ma nomina
+ * il trigger: la stessa destinazione e' giusta per un innesco e sbagliata per un altro.
+ *
+ * Con un trigger di **riga** non si scrive nel cursore intero (la riga si scrive un membro alla volta),
+ * nella collection delle righe, nelle righe di un'altra sezione, ne' con l'output automatico (una risorsa
+ * sola per tutte le righe — l'ultima che ha girato). Con un trigger di **primo livello** non si scrive nel
+ * cursore di una sezione: fuori dalla riga il cursore non porta alcuna riga, e il valore andrebbe perso.
+ * Riscrivere l'intera collection da lì resta lecito — e' il codice fiscale che porta con se' i punti gia'
+ * censiti.
+ *
+ * Il nome di un campo della riga come destinazione non e' qui: e' `SCREEN_FIELD_IN_REPEATER`, come
+ * ovunque, perche' il difetto e' un altro — quel nome non e' un riferimento.
+ *
+ * La usano i due capi, l'inspector mentre si scrive e il validatore della demo: due copie divergono, e
+ * la si scopre sull'ambiente in cui l'action gira davvero.
+ */
+declare function screenActionRowTargetIssues(screen: FlowDynamicScreen | undefined, action: FlowScreenAction, typeOf: FlowScreenFieldTypeResolver): FlowScreenActionRowTargetIssue[];
 /** Inserisce un campo dentro `parentPath` alla posizione indicata (in fondo se assente). */
 declare function insertField(screen: FlowDynamicScreen, parentPath: FlowScreenFieldPath, field: FlowScreenField, index?: number): FlowScreenFieldPath | undefined;
 /** Rimuove il campo a un percorso, e con esso tutto cio' che conteneva. */
@@ -4254,9 +4351,19 @@ declare class FlowEditorSession {
      * non ancora salvato, e' modificabile per definizione.
      */
     readonly isEditable: _angular_core.Signal<boolean>;
-    /** Su una versione non modificabile il comando primario diventa "Nuova versione" (§8.1). */
+    /** Sulla versione attiva il comando primario diventa "Nuova versione" (§8, regola 1). */
     readonly primaryCommand: _angular_core.Signal<"create" | "save" | "newVersion">;
     readonly isActiveVersion: _angular_core.Signal<boolean>;
+    /**
+     * §8, regola 1 — la versione aperta e' una **superata**: si modifica, ma il primo salvataggio va
+     * confermato. Un'esecuzione sospesa nata quando era attiva — una pausa, un'attesa, uno step, una
+     * schermata parcheggiata — riprende sulla definizione modificata, e se il node su cui era ferma e'
+     * stato tolto o rinominato fallisce. Il backend non puo' saperlo al posto nostro.
+     *
+     * Si legge lo `status` della riga, che e' del backend come `isEditable`: salvata, la versione torna
+     * bozza e la domanda smette di porsi da se' al primo `refreshVersions`.
+     */
+    readonly isObsoleteVersion: _angular_core.Signal<boolean>;
     /** Attivare esige zero errori (§8.3): il comando resta disabilitato finche' ce ne sono. */
     readonly canActivate: _angular_core.Signal<boolean>;
     setAuthor(author: string | undefined): void;
@@ -4347,6 +4454,11 @@ declare class FlowEditorSession {
     private normalizeResult;
     private static readonly warned;
     private static warnOnce;
+    /**
+     * Restituisce la rilettura dell'elenco versioni, che parte comunque: chi la aspetta e' chi ha
+     * appena scritto una versione **nuova**, che nell'elenco vecchio non c'e' — e finche' non c'e'
+     * `currentVersionSummary` e' vuoto, cioe' stato «Nuovo» e editor in sola lettura.
+     */
     private applySaveResult;
     /**
      * Duplica: scrive il flow **sotto un altro nome** e sposta la sessione sulla copia
@@ -4386,12 +4498,18 @@ declare class FlowEditorSession {
     deleteVersion(version: number): Promise<void>;
     /** Risoluzione del conflitto, prima opzione: ricarica e perde le modifiche locali (§9.3). */
     reloadAfterConflict(): Promise<void>;
+    /** Risoluzione del conflitto, seconda opzione: le modifiche locali in una nuova versione (§9.3). */
+    saveAsNewVersionAfterConflict(): Promise<FlowSaveResult>;
     /**
-     * Risoluzione del conflitto, seconda opzione: salva come nuova versione, conservando
-     * le modifiche locali (§9.3). Il salvataggio senza `expectedUpdatedAt` e senza `version`
-     * lascia scegliere al backend, che crea una nuova versione se l'ultima non e' toccabile.
+     * Il documento in mano, modifiche comprese, scritto in una versione **nuova**: lascia intatta
+     * quella da cui si era partiti. Serve dove sovrascrivere e' la cosa sbagliata o rischiosa — un
+     * conflitto (§9.3), o una superata su cui ci sono esecuzioni sospese (§8, regola 1).
+     *
+     * Sono due chiamate e non «salva senza `version`»: quella strada sceglie da se' e sovrascrive
+     * l'ultima se e' una bozza (§8), cioe' proprio cio' che qui si vuole evitare. `createVersion`
+     * copia una versione salvata, e il salvataggio subito dopo ci scrive sopra il documento.
      */
-    saveAsNewVersionAfterConflict(): Promise<FlowSaveResult>;
+    saveAsNewVersion(): Promise<FlowSaveResult>;
     dismissConflict(): void;
     /** L'ultima validazione conosciuta, da qualunque primitiva arrivi. */
     get validationResult(): FlowValidationResult | null;
@@ -5208,6 +5326,18 @@ declare class ReferencePickerComponent {
      * destinazione farebbe attivare un flow che poi fallisce davanti all'utente. L'eccezione sono i
      * campi del record che innesca, che si assegnano (§4.1).
      */
+    /**
+     * In un campo di destinazione, la radice del valore quando e' **nota ma non scrivibile**: sta fra
+     * le radici di `getReferences` e non fra quelle di `getWritableReferences`. E' il caso di chi
+     * scrive a mano `Leggi_Ordine.Stato` — l'output automatico si legge, ma solo le variabili si
+     * assegnano (§4.6, §5.3) — e di una costante o una formula. Senza, finivano in `navigated`, che
+     * dice «non verificato» di cio' che la validazione rifiuta.
+     *
+     * Le globali restano fuori: le giudica {@link isReadOnlyPath}, e i campi di `$Record` si
+     * assegnano. E senza l'elenco scrivibile — in volo, fallito, o un host che risponde vuoto — non
+     * si accusa nessuno: la regola e' quella del validatore, che senza nomi scrivibili tace.
+     */
+    private readonly readOnlyRoot;
     private readonly isReadOnlyPath;
     private readonly pathReferences;
     /**
@@ -5256,6 +5386,9 @@ declare class ReferencePickerComponent {
      *    classe, `FIELD_UNKNOWN` su un'entita', e a differenza di prima si sa per certo;
      *  - `memberNotWritable`: il segmento esiste, non e' scrivibile, e questo campo vuole una
      *    destinazione: `TARGET_NOT_WRITABLE`;
+     *  - `rootNotWritable`: la radice esiste ma non e' una variabile — un output automatico, una
+     *    costante, una formula — e questo campo vuole una destinazione: `TARGET_NOT_WRITABLE` sul
+     *    nome intero come sui suoi campi (§4.6, §5.3);
      *  - `pathUnverified`: la catena si interrompe (`PATH_NOT_VERIFIABLE`): avviso, non errore;
      *  - `globalPathUntyped`: percorso globale che porta un contenitore senza dichiararne il tipo:
      *    `PATH_NOT_VERIFIABLE`, e la correzione sta nel catalogo dell'host, non nel flow (§4.1);
@@ -5269,7 +5402,7 @@ declare class ReferencePickerComponent {
      *    percorso inesistente di uno scope che i percorsi li dichiara, perche' lì il backend
      *    risponderebbe `GLOBAL_UNKNOWN`.
      */
-    readonly valueState: _angular_core.Signal<"unknown" | "empty" | "member" | "known" | "navigated" | "host" | "containerRoot" | "memberUnknown" | "memberNotWritable" | "pathUnverified" | "globalPathUntyped" | "globalPathInvalid" | "priorValuesMissing">;
+    readonly valueState: _angular_core.Signal<"unknown" | "empty" | "member" | "known" | "navigated" | "host" | "containerRoot" | "memberUnknown" | "memberNotWritable" | "rootNotWritable" | "pathUnverified" | "globalPathUntyped" | "globalPathInvalid" | "priorValuesMissing">;
     /** Le parole cambiano con la tappa: un campo di un'entita' non e' un membro di una classe. */
     private readonly tailIsObject;
     private readonly tailContainer;
@@ -5675,7 +5808,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;
     /**
@@ -6298,7 +6431,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;
     /**
@@ -7246,20 +7379,71 @@ declare class DynamicScreenInspectorComponent extends NodeInspectorBase {
      */
     readonly screenFieldTargets: _angular_core.Signal<FlowReference[]>;
     /**
-     * I campi che raccolgono un valore: gli unici che un'action possa riempire, e gli unici che
-     * innescano.
+     * I campi che raccolgono un valore e che sono **risorse**: gli unici che un'action possa riempire per
+     * nome, e gli unici a cui agganciare il messaggio di una regola della schermata.
      *
-     * **Senza quelli dentro una riga**, che raccolgono un valore ma non sono risorse: un trigger nomina
-     * un campo, e il campo di una riga non ne ha uno solo — sarebbe da dichiarare *quale* riga osserva.
-     * Un `triggerFieldName` che punta lì e' `SCREEN_FIELD_IN_REPEATER`, e lo stesso vale per
-     * l'`assignToReference` di un output (§5.2).
+     * **Senza quelli dentro una riga**, che raccolgono un valore ma non sono risorse: esistono in una
+     * copia per elemento della collection, quindi come destinazione il nome non individua nessuna riga —
+     * lì si scrive nel cursore (`SCREEN_FIELD_IN_REPEATER`, §5.2). Gli **inneschi** invece li comprendono,
+     * e hanno un elenco loro ({@link triggerFieldOptions}).
      */
     private valueFieldsOfScreen;
     /**
      * I campi proponibili come innesco. Sono **i campi di questa schermata**, non i riferimenti in
      * generale: un trigger che nomina altro e' `SCREEN_TRIGGER_FIELD_UNKNOWN` (§5.2).
+     *
+     * **Compresi quelli di una riga**: `triggerFieldName` nomina un campo e non un riferimento, e l'action
+     * gira per ogni riga in cui quel campo e' cambiato (§5.2, *Una screen action per ogni riga*). La
+     * descrizione dice in quale sezione stanno, perche' da quella scelta cambia dove vanno gli output.
      */
     readonly triggerFieldOptions: _angular_core.Signal<NamePickerOption[]>;
+    /**
+     * I campi a cui agganciare il messaggio di una regola della schermata: quelli di primo livello. Un
+     * campo di riga esiste in una copia per elemento, e non individua il controllo accanto a cui mostrare
+     * il messaggio (`SCREEN_FIELD_IN_REPEATER`). Era lo stesso elenco degli inneschi finche' i campi di
+     * riga non innescavano niente; da quando lo fanno, i due elenchi sono diversi.
+     */
+    readonly ruleFieldOptions: _angular_core.Signal<NamePickerOption[]>;
+    /**
+     * §5.2 — dove gira l'action di ciascun trigger: per la schermata, o per ogni riga di una sezione. Per
+     * indice, come l'elenco: il template lo legge accanto al trigger, e ricalcolarlo per ognuno a ogni
+     * ciclo di rilevamento camminerebbe l'albero dei campi una volta per trigger.
+     */
+    readonly triggerScopes: _angular_core.Signal<FlowScreenTriggerScope[]>;
+    /** La sezione per le cui righe gira un trigger, se osserva un campo di riga. */
+    triggerRowSection(index: number): FlowScreenField | undefined;
+    /**
+     * Le radici da proporre per prime nelle condizioni di un trigger di riga: il cursore, perche' le
+     * condizioni leggono la riga per cui l'action sta girando (`PuntoLuce.ProductId`), e il nome del campo
+     * lì e' `SCREEN_FIELD_IN_REPEATER` come ovunque.
+     */
+    triggerPreferredRoots(index: number): string[];
+    /**
+     * §5.2, *Una screen action per ogni riga* — cio' che di un'action dipende da **chi** la invoca: per le
+     * righe di quali sezioni gira, e quali delle sue destinazioni diventano per questo irraggiungibili
+     * (`SCREEN_ACTION_ROW_TARGET_INVALID`). La regola e' in `core/screen-field.util.ts`, ed e' la stessa
+     * che applica il validatore della demo.
+     */
+    readonly actionRowContexts: _angular_core.Signal<{
+        sections: FlowScreenField[];
+        runsForScreen: boolean;
+        issues: FlowScreenActionRowTargetIssue[];
+        preferredRoots: string[];
+    }[]>;
+    /** Il contesto di riga dell'action a un indice; mai `undefined`, cosi' il template non lo guarda. */
+    actionRowContext(index: number): {
+        sections: FlowScreenField[];
+        runsForScreen: boolean;
+        issues: FlowScreenActionRowTargetIssue[];
+        preferredRoots: string[];
+    };
+    /**
+     * La spunta dell'output automatico non si propone su un'action che gira per riga: sarebbe una risorsa
+     * sola per tutte le righe, ed e' `SCREEN_ACTION_ROW_TARGET_INVALID` — la stessa ragione per cui sparisce
+     * su un `ComponentInstance` dentro una riga. Resta visibile se e' gia' accesa, perche' e' da lì che la
+     * si spegne.
+     */
+    actionOffersAutomaticOutput(index: number, action: FlowScreenAction): boolean;
     /** Le action **di questo screen**: un `screenActionName` fuori da qui e' `SCREEN_ACTION_UNKNOWN`. */
     readonly screenActionOptions: _angular_core.Signal<NamePickerOption[]>;
     /**
@@ -8425,7 +8609,22 @@ declare class FlowBuilderComponent {
      * indice — e' la traccia che sopravvive: dopo il passo si adotta il nome che si trova lì.
      */
     private stepHistory;
+    /**
+     * §8, regola 1 — il salvataggio su una versione **superata** aspetta una conferma. Si modifica come
+     * una bozza, ma le esecuzioni sospese nate quando era attiva riprendono sulla definizione nuova, e
+     * se il node su cui erano ferme non c'e' piu' falliscono: e' una domanda a cui il backend non puo'
+     * rispondere al posto di chi salva. La barra resta finche' non si sceglie, come quella del duplicato,
+     * e un secondo «Salva» non vale come conferma: la conferma e' un bottone che dice cosa accadra'.
+     */
+    readonly isObsoleteSaveOpen: _angular_core.WritableSignal<boolean>;
     save(): Promise<void>;
+    /** «Salva comunque»: la superata si sovrascrive e torna bozza (§8). */
+    confirmObsoleteSave(): Promise<void>;
+    /** L'alternativa che non tocca le esecuzioni sospese: la superata resta com'era. */
+    saveObsoleteAsNewVersion(): Promise<void>;
+    cancelObsoleteSave(): void;
+    /** Il salvataggio vero, con la notifica dell'esito; `undefined` se non e' riuscito. */
+    private writeCurrentVersion;
     /** Il modulo del duplicato e' aperto. */
     readonly isCopyOpen: _angular_core.WritableSignal<boolean>;
     readonly copyName: _angular_core.WritableSignal<string>;
@@ -8525,5 +8724,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, PRIOR_VALUES_OPERATOR, PRIOR_VALUES_SCOPE, ParameterEditorComponent, PasteDialogComponent, ProblemsPanelComponent, RECORD_TRIGGERS, 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, describePriorValues, duplicateField, elementIcon, emptyFlowDefinition, enumChoiceSetFieldType, fieldAt, filterReferences, flattenFields, flowNodeWidth, flowNodeWidthClass, foldSourceConnectorId, foldTargetConnectorId, groupColorClass, groupRect, hasAutoSize, innerNamesOf, insertField, isClipboardPayload, isCustomConditionLogic, isEmptyReferenceFilter, isFieldResource, isFoldReference, isGlobalReference, isNumericType, isPathInside, isRecordTrigger, 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, priorCriteriaSeverity, priorValuesAvailability, priorValuesOfDefinition, priorValuesProposable, priorValuesSeverity, readsPriorValues, 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, FlowRecordTriggerTypeEntry, 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, PriorValuesAvailability, PriorValuesSeverity, 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, PRIOR_VALUES_OPERATOR, PRIOR_VALUES_SCOPE, ParameterEditorComponent, PasteDialogComponent, ProblemsPanelComponent, RECORD_TRIGGERS, 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, describePriorValues, duplicateField, elementIcon, emptyFlowDefinition, enumChoiceSetFieldType, fieldAt, filterReferences, flattenFields, flowNodeWidth, flowNodeWidthClass, foldSourceConnectorId, foldTargetConnectorId, groupColorClass, groupRect, hasAutoSize, innerNamesOf, insertField, isClipboardPayload, isCustomConditionLogic, isEmptyReferenceFilter, isFieldResource, isFoldReference, isGlobalReference, isNumericType, isPathInside, isRecordTrigger, 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, priorCriteriaSeverity, priorValuesAvailability, priorValuesOfDefinition, priorValuesProposable, priorValuesSeverity, readsPriorValues, recomputeMembers, referenceRoot, referencedRootsOf, remapConditionLogic, removeCondition, removeField, repeatedFieldNames, repeatingSectionOf, repeatingSectionsOf, resolvePath, resourceFieldsOf, rewriteReferences, sameMembers, samePath, screenActionNames, screenActionRowTargetIssues, screenActionScopes, screenFieldNames, severityBucket, slugifyFlowName, sourceConnectorId, stageStepNames, stageStepOutputReferenced, stepsOf, targetConnectorId, triggerScopeOf, triggerableFieldsOf, 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, FlowRecordTriggerTypeEntry, FlowRecordUpdate, FlowRecordValue, FlowRect, FlowReference, FlowReferenceFilter, FlowReferenceKind, FlowRegionContainerType, FlowResourceCollection, FlowResourceEdit, FlowResourceKindEntry, FlowResourceRef, FlowResourceTarget, FlowResumeRequest, FlowRunOutcome, FlowRunRequest, FlowSaveRequest, FlowSaveResult, FlowSchedule, FlowScheduledPath, FlowScreen, FlowScreenAction, FlowScreenActionRowTargetIssue, FlowScreenActionRowTargetReason, FlowScreenField, FlowScreenFieldInputsRevisited, FlowScreenFieldNode, FlowScreenFieldPath, FlowScreenFieldType, FlowScreenFieldTypeEntry, FlowScreenFieldTypeResolver, FlowScreenNavigation, FlowScreenResponseRequest, FlowScreenRule, FlowScreenTrigger, FlowScreenTriggerInitBehavior, FlowScreenTriggerScope, 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, FlowTriggerableField, 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, PriorValuesAvailability, PriorValuesSeverity, StructureMemberUsage, ValueMode };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esfaenza/flow-builder",
-  "version": "20.3.56",
+  "version": "20.3.58",
   "peerDependencies": {
     "@angular/cdk": "^20.2.14",
     "@angular/common": "^20.3.32",