@esfaenza/flow-builder 20.3.23 → 20.3.25

package/index.d.ts

@@ -152,17 +152,34 @@ interface FlowChoice {
     choiceText?: string;
     value?: FlowValue;
 }
+/**
+ * §5.2 — le opzioni generate. Le sorgenti sono **tre e si escludono a vicenda**: una collection
+ * già nel flow, una query su un'entita', i valori di un tipo di enumerazione. Dichiararne due
+ * insieme non blocca l'attivazione ma e' `CHOICE_SET_SOURCE_AMBIGUOUS`, e quale il runtime usi
+ * non e' una cosa da lasciare decidere al caso: `core/enum-choice-set.util.ts` le riconosce.
+ */
 interface FlowDynamicChoiceSet {
     name?: string;
     description?: string;
     dataType?: FlowDataType;
+    /** Sorgente: una collection del flow, tipicamente il risultato di un Get Records. */
+    collectionReference?: string;
+    /** Sorgente: l'entita' da interrogare. */
     object?: string;
+    /**
+     * Sorgente: il tipo di enumerazione, lo stesso nome che una risorsa `Enum` scrive in
+     * `objectType`. I campi citabili non sono campi di un'entita' ma le tre proprieta' di un
+     * valore di enum — `Name`, `Label`, `NumericValue` — e le porta `enumChoiceSetFields` (§7.1).
+     */
+    enumType?: string;
+    /** Assente: l'etichetta e' `Label` su un enum, e va dichiarato altrove. */
     displayField?: string;
+    /** Assente: il valore memorizzato e' `Name` su un enum, e va dichiarato altrove. */
     valueField?: string;
     sortField?: string;
     sortOrder?: FlowSortOrder;
     limit?: number;
-    /** Sempre in AND: nessun `filterLogic` qui (§4.4). */
+    /** Sempre in AND: nessun `filterLogic` qui (§4.4). Su un enum sono valutati in memoria. */
     filters?: FlowRecordFilter[];
 }
 interface FlowStage {
@@ -837,6 +854,12 @@ interface FlowDictionaries {
     regionContainerTypes?: FlowDictionaryEntry[];
     /** §5.2 — `UseStoredValues` | `ResetValues` (`inputsOnNextNavToAssocScrn`). */
     screenFieldInputsRevisited?: FlowDictionaryEntry[];
+    /**
+     * §5.2 — le proprieta' citabili di un valore di enum in un dynamic choice set con `enumType`:
+     * `Name`, `Label`, `NumericValue`. Non sono campi di un'entita', quindi l'elenco arriva da qui
+     * e non da `GET /catalog/objects/{name}/fields`.
+     */
+    enumChoiceSetFields?: FlowDictionaryEntry[];
 }
 interface FlowObjectSummary {
     name: string;
@@ -2171,6 +2194,48 @@ declare function moveField(screen: FlowDynamicScreen, from: FlowScreenFieldPath,
 /** Duplica un campo accanto all'originale, rinominandolo: i nomi restano unici (§3.3). */
 declare function duplicateField(screen: FlowDynamicScreen, path: FlowScreenFieldPath, newName: string): FlowScreenFieldPath | undefined;
 
+/**
+ * I dynamic choice set — FRONTEND.md §5.2.
+ *
+ * Due cose che il resto del codice non deve indovinare.
+ *
+ * La prima: le sorgenti sono **tre e si escludono a vicenda** (`collectionReference`, `object`,
+ * `enumType`). Dichiararne due insieme non blocca l'attivazione ma e' `CHOICE_SET_SOURCE_AMBIGUOUS`:
+ * l'editor deve saperlo dire, e per dirlo serve un solo posto che sappia quali campi sono una
+ * sorgente — aggiungerne una quarta domani e' una riga qui, non una condizione in tre template.
+ *
+ * La seconda: su un choice set da enum i **campi citabili non sono campi di un'entita'**. Non c'e'
+ * nessuna entita' da interrogare: sono le tre proprieta' di un valore di enum, e valgono per
+ * `displayField`, `valueField`, `sortField` e per il campo di un filtro. Le etichette da mostrare
+ * arrivano dal dizionario (`enumChoiceSetFields`, §7.1); il **tipo** di ciascuna no, e senza il tipo
+ * l'editor del valore di un filtro proporrebbe una casella di testo dove il contratto scrive un
+ * numero (`NumericValue`, §5.2). Per questo la mappa sta qui e non nel dizionario.
+ */
+
+/** La sorgente delle opzioni, o `null` se non ne e' dichiarata nessuna. */
+type ChoiceSetSource = 'collection' | 'object' | 'enum';
+/** Le sorgenti **dichiarate**: piu' di una e' `CHOICE_SET_SOURCE_AMBIGUOUS`. */
+declare function declaredChoiceSetSources(set: FlowDynamicChoiceSet): ChoiceSetSource[];
+/** La prima sorgente dichiarata, che e' anche quella su cui il form si apre. */
+declare function choiceSetSourceOf(set: FlowDynamicChoiceSet): ChoiceSetSource | null;
+/** I campi da cancellare passando a `source`: due sorgenti insieme sono un avviso. */
+declare function otherSourceFieldsOf(source: ChoiceSetSource): (keyof FlowDynamicChoiceSet)[];
+/**
+ * §5.2 — le proprieta' di un valore di enum, col tipo con cui si confrontano in un filtro.
+ * Qualunque altro nome e' `FIELD_UNKNOWN`.
+ */
+declare const ENUM_CHOICE_SET_FIELDS: {
+    readonly name: string;
+    readonly label: string;
+    readonly dataType: FlowDataType;
+}[];
+/** Senza `displayField` l'etichetta e' `Label`, senza `valueField` il valore memorizzato e' `Name`. */
+declare const ENUM_CHOICE_SET_DEFAULT_DISPLAY_FIELD = "Label";
+declare const ENUM_CHOICE_SET_DEFAULT_VALUE_FIELD = "Name";
+declare function enumChoiceSetFieldType(name: string | undefined | null): FlowDataType | undefined;
+/** Il nome non e' una delle tre proprieta': vuoto non si accusa, e' semplicemente il default. */
+declare function isUnknownEnumChoiceSetField(name: string | undefined | null): boolean;
+
 /**
  * La gravita' di un rilievo, ridotta a tre secchi — FRONTEND.md §7.
  *
@@ -2247,6 +2312,12 @@ declare class FlowDictionaryStore {
     readonly conditionLogicModes: _angular_core.Signal<FlowDictionaryEntry[]>;
     readonly regionContainerTypes: _angular_core.Signal<FlowDictionaryEntry[]>;
     readonly screenFieldInputsRevisited: _angular_core.Signal<FlowDictionaryEntry[]>;
+    /**
+     * §5.2 — le proprieta' citabili in un choice set da enum. Elenco vuoto: il dizionario non le
+     * dichiara, e il form ripiega sui tre nomi del contratto invece di lasciare la tendina vuota —
+     * qui il contratto li nomina uno per uno, quindi non e' cablare un dizionario aperto.
+     */
+    readonly enumChoiceSetFields: _angular_core.Signal<FlowDictionaryEntry[]>;
     /** §5.2 — i tipi di campo di uno screen dinamico, con i flag che guidano il form. */
     readonly screenFieldTypes: _angular_core.Signal<FlowScreenFieldTypeEntry[]>;
     /**
@@ -2465,6 +2536,18 @@ interface PathContainer {
     /** Nome dell'entita' o della classe. */
     name: string;
 }
+/**
+ * Dove chiedere i valori ammessi di un campo a scelta chiusa (§6.4):
+ * `GET /schema/{object}/fields/{field}/values`.
+ *
+ * Sono i valori del **campo**, non di un tipo: `Ordine.Stato` e `Attivita.Stato` sono due insiemi
+ * diversi anche a parita' di `dataType`, e per questo serve la coppia e non il solo nome. È
+ * l'altra meta' della §4.6 — lì l'insieme e' del tipo di enumerazione, qui della colonna.
+ */
+interface PathValueSet {
+    object: string;
+    field: string;
+}
 /**
  * Un segmento proponibile in una tappa — campo o membro ridotti al minimo comune, perche' chi
  * naviga non deve sapere quale dei due sta guardando.
@@ -2480,6 +2563,12 @@ interface PathEntry {
     isWritable: boolean;
     /** Dove il percorso continua dopo questo segmento; assente = qui finisce cio' che si sa. */
     next?: PathContainer;
+    /**
+     * Presente solo sui campi che dichiarano `hasClosedValueSet`: dice dove chiedere i valori
+     * ammessi, così un insieme chiuso non finisce in una casella di testo libero. Un membro di
+     * classe non lo ha — lì l'insieme chiuso e' un `Enum` col suo tipo (§4.6, §4.7.1).
+     */
+    valueSet?: PathValueSet;
 }
 /**
  * Esito della descrizione di una tappa. Sono quattro come per le classi (§4.7.1) e vanno tenuti
@@ -3920,7 +4009,7 @@ declare class NamePickerComponent {
      * **errori** che bloccano l'attivazione (`ACTION_UNKNOWN`, `FORM_UNKNOWN`), mentre un flow
      * senza versione attiva e' un avviso. Mostrarli con lo stesso colore direbbe il falso.
      */
-    readonly unknownSeverity: _angular_core.InputSignal<"error" | "warn">;
+    readonly unknownSeverity: _angular_core.InputSignal<"warn" | "error">;
     /**
      * Nomi che **esistono** ma non sono utilizzabili qui. Il caso vero e' il catalogo dei form,
      * dove una schermata intera e un componente vivono nello stesso elenco e si distinguono per
@@ -4081,6 +4170,27 @@ declare class EnumValuePickerComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<EnumValuePickerComponent, "fb-enum-value-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "enumType": { "alias": "enumType"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
 }
 
+declare class FieldValuePickerComponent {
+    private readonly catalog;
+    readonly value: _angular_core.InputSignal<string | undefined>;
+    /** Entita' e campo di cui chiedere i valori: la coppia, non il solo nome del campo. */
+    readonly valueSet: _angular_core.InputSignal<PathValueSet | undefined>;
+    readonly label: _angular_core.InputSignal<string>;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    readonly disabled: _angular_core.InputSignal<boolean>;
+    readonly valueChange: _angular_core.OutputEmitterRef<string | undefined>;
+    private readonly values;
+    /** Cresce a ogni caricamento: scarta la risposta di un campo che non e' piu' quello scelto. */
+    private sequence;
+    constructor();
+    readonly options: _angular_core.Signal<NamePickerOption[]>;
+    private readonly fieldLabel;
+    readonly emptyMessage: _angular_core.Signal<string>;
+    readonly unknownMessage: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<FieldValuePickerComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FieldValuePickerComponent, "fb-field-value-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "valueSet": { "alias": "valueSet"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
+}
+
 declare class FormulaEditorComponent {
     private readonly store;
     private readonly api;
@@ -4199,6 +4309,12 @@ declare class ValueEditorComponent {
     readonly dataType: _angular_core.InputSignal<string | undefined>;
     readonly objectType: _angular_core.InputSignal<string | undefined>;
     readonly isCollection: _angular_core.InputSignal<boolean | undefined>;
+    /**
+     * L'insieme chiuso della destinazione, quando e' un campo dello schema che lo dichiara: senza,
+     * un valore fra quattro possibili si digita a memoria (§4.4, §6.4). Lo passa chi conosce entita'
+     * e campo — i filtri, le assegnazioni di campo — perche' qui il tipo non basta a dedurlo.
+     */
+    readonly valueSet: _angular_core.InputSignal<PathValueSet | undefined>;
     readonly disabled: _angular_core.InputSignal<boolean>;
     /** Nasconde la modalita' formula dove il modello non la prevede. */
     readonly allowFormula: _angular_core.InputSignal<boolean>;
@@ -4223,6 +4339,11 @@ declare class ValueEditorComponent {
      * non lo avra': un'istanza nasce dal runtime e nel metadata si cita per riferimento (§4.7).
      */
     readonly literalAllowed: _angular_core.Signal<boolean>;
+    /**
+     * L'insieme chiuso c'e' e si puo' chiedere. `Enum` resta fuori di proposito: lì i valori sono del
+     * **tipo** e li propone `fb-enum-value-picker` (§4.6), e `Boolean` ha già la sua casella.
+     */
+    readonly hasValueSet: _angular_core.Signal<boolean>;
     /** §4.7 — la destinazione e' un'istanza di classe: si passa per riferimento e basta. */
     readonly isStructureTarget: _angular_core.Signal<boolean>;
     readonly literalInputType: _angular_core.Signal<string>;
@@ -4238,6 +4359,12 @@ declare class ValueEditorComponent {
     setMode(mode: ValueMode): void;
     onReferenceChange(reference: string | undefined): void;
     onLiteralChange(raw: string): void;
+    /**
+     * Un valore scelto da un insieme chiuso non e' un tipo a parte: finisce nello stesso campo del
+     * letterale, quindi passa dalla stessa conversione (interi in cultura invariante compresi).
+     * Svuotare il picker toglie il valore invece di scrivere una stringa vuota.
+     */
+    onClosedValueChange(raw: string | undefined): void;
     /**
      * §4.2 — l'`enumValue` e' il **nome** del valore. Svuotare il picker toglie il valore invece di
      * scrivere una stringa vuota: un `enumValue: ''` sarebbe un campo valorizzato con niente.
@@ -4259,7 +4386,7 @@ declare class ValueEditorComponent {
     private emit;
     readonly dataTypeOptions: _angular_core.Signal<_esfaenza_flow_builder.FlowDataTypeEntry[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ValueEditorComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ValueEditorComponent, "fb-value-editor", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "dataType": { "alias": "dataType"; "required": false; "isSignal": true; }; "objectType": { "alias": "objectType"; "required": false; "isSignal": true; }; "isCollection": { "alias": "isCollection"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "allowFormula": { "alias": "allowFormula"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ValueEditorComponent, "fb-value-editor", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "dataType": { "alias": "dataType"; "required": false; "isSignal": true; }; "objectType": { "alias": "objectType"; "required": false; "isSignal": true; }; "isCollection": { "alias": "isCollection"; "required": false; "isSignal": true; }; "valueSet": { "alias": "valueSet"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "allowFormula": { "alias": "allowFormula"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
 }
 
 declare class ConditionEditorComponent {
@@ -4315,7 +4442,7 @@ declare class ConditionEditorComponent {
      */
     hasTypeMismatch(condition: FlowCondition): boolean;
     typeMismatchMessage(condition: FlowCondition): string;
-    readonly logicMode: _angular_core.Signal<"and" | "or" | "formula" | "custom">;
+    readonly logicMode: _angular_core.Signal<"formula" | "and" | "or" | "custom">;
     readonly customLogic: _angular_core.Signal<string>;
     /** Feedback immediato sull'espressione: la verita' resta della validazione backend. */
     readonly customLogicError: _angular_core.Signal<string | null>;
@@ -4359,6 +4486,15 @@ declare class ConditionEditorComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ConditionEditorComponent, "fb-condition-editor", never, { "holder": { "alias": "holder"; "required": true; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "allowFormula": { "alias": "allowFormula"; "required": false; "isSignal": true; }; "allowLogic": { "alias": "allowLogic"; "required": false; "isSignal": true; }; "issuePath": { "alias": "issuePath"; "required": false; "isSignal": true; }; }, { "changed": "changed"; }, never, never, true, never>;
 }
 
+/**
+ * Un campo filtrabile che **non** viene da un catalogo di campi: nome, etichetta e tipo con cui
+ * confrontarlo. Oggi lo usano i choice set da enum (§5.2).
+ */
+interface FilterFieldOption {
+    value: string;
+    label: string;
+    dataType?: FlowDataType;
+}
 /** Il contenitore dei filtri, qualunque elemento sia. */
 interface FilterHolder {
     filters?: FlowRecordFilter[];
@@ -4373,6 +4509,11 @@ declare class RecordFilterEditorComponent {
     readonly title: _angular_core.InputSignal<string>;
     /** L'uso con cui chiedere i campi: `filterable` per i filtri, `updateable` altrove. */
     readonly usage: _angular_core.InputSignal<FlowFieldUsage>;
+    /**
+     * Elenco chiuso di campi, al posto del catalogo dell'entita'. Valorizzato, `object` non serve:
+     * non c'e' nessuna entita' da interrogare (§5.2, choice set da `enumType`).
+     */
+    readonly fieldOptions: _angular_core.InputSignal<FilterFieldOption[]>;
     /** `false` dove il modello non ha `filterLogic`: i filtri sono sempre in AND (§4.4). */
     readonly supportsLogic: _angular_core.InputSignal<boolean>;
     /** `true` dove esiste `filterFormula` come alternativa ai filtri. */
@@ -4383,7 +4524,7 @@ declare class RecordFilterEditorComponent {
      * (§5.8, §13.10).
      */
     readonly emptyWarning: _angular_core.InputSignal<string | null>;
-    readonly emptyWarningSeverity: _angular_core.InputSignal<"error" | "warn">;
+    readonly emptyWarningSeverity: _angular_core.InputSignal<"warn" | "error">;
     readonly changed: _angular_core.OutputEmitterRef<(holder: FilterHolder) => void>;
     /** Tutti i campi, filtrabili o no: serve solo a riconoscere le chiavi composte (§5.8). */
     private readonly allFields;
@@ -4406,7 +4547,7 @@ declare class RecordFilterEditorComponent {
      * evita la ricerca di un campo che nell'elenco non c'e' e non ci sara'.
      */
     readonly identifierNotFilterable: _angular_core.Signal<boolean>;
-    readonly logicMode: _angular_core.Signal<"and" | "or" | "formula" | "custom">;
+    readonly logicMode: _angular_core.Signal<"formula" | "and" | "or" | "custom">;
     readonly customLogic: _angular_core.Signal<string>;
     readonly showEmptyWarning: _angular_core.Signal<boolean>;
     addFilter(): void;
@@ -4425,13 +4566,24 @@ declare class RecordFilterEditorComponent {
      * catalogo resta interrogato qui, e non solo dentro il picker.
      */
     fieldDataType(filter: FlowRecordFilter): FlowDataType | undefined;
+    /**
+     * Fuori dall'elenco chiuso: e' `FIELD_UNKNOWN`, e va detto qui perche' il `<select>` mostrerebbe
+     * solo una casella vuota — cioe' un documento scritto altrove sembrerebbe senza campo.
+     */
+    unknownFixedField(filter: FlowRecordFilter): boolean;
     /**
      * Il tipo concreto del campo: su un campo `Enum` e' cio' che permette di proporre i valori
      * ammessi invece di farli digitare (§4.6).
      */
     fieldObjectType(filter: FlowRecordFilter): string | undefined;
+    /**
+     * L'insieme chiuso del campo, dove lo schema lo dichiara (`hasClosedValueSet`, §6.4): e' cio' che
+     * fa comparire i valori ammessi al posto della casella di testo. Vale anche in fondo a un percorso
+     * di relazione, e lì l'entita' non e' quella di partenza — la porta con se' il segmento risolto.
+     */
+    fieldValueSet(filter: FlowRecordFilter): PathValueSet | undefined;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RecordFilterEditorComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<RecordFilterEditorComponent, "fb-record-filter-editor", never, { "holder": { "alias": "holder"; "required": true; "isSignal": true; }; "object": { "alias": "object"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "usage": { "alias": "usage"; "required": false; "isSignal": true; }; "supportsLogic": { "alias": "supportsLogic"; "required": false; "isSignal": true; }; "supportsFormula": { "alias": "supportsFormula"; "required": false; "isSignal": true; }; "emptyWarning": { "alias": "emptyWarning"; "required": false; "isSignal": true; }; "emptyWarningSeverity": { "alias": "emptyWarningSeverity"; "required": false; "isSignal": true; }; }, { "changed": "changed"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<RecordFilterEditorComponent, "fb-record-filter-editor", never, { "holder": { "alias": "holder"; "required": true; "isSignal": true; }; "object": { "alias": "object"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "usage": { "alias": "usage"; "required": false; "isSignal": true; }; "fieldOptions": { "alias": "fieldOptions"; "required": false; "isSignal": true; }; "supportsLogic": { "alias": "supportsLogic"; "required": false; "isSignal": true; }; "supportsFormula": { "alias": "supportsFormula"; "required": false; "isSignal": true; }; "emptyWarning": { "alias": "emptyWarning"; "required": false; "isSignal": true; }; "emptyWarningSeverity": { "alias": "emptyWarningSeverity"; "required": false; "isSignal": true; }; }, { "changed": "changed"; }, never, never, true, never>;
 }
 
 /** Contenitore generico: gli input hanno `value`, gli output `assignToReference`. */
@@ -5230,6 +5382,39 @@ declare class ResourcePanelComponent {
      * e la mutazione va dentro `updateResource` perche' e' lì che il documento viene rimpiazzato.
      */
     onFiltersChanged(reference: FlowResourceRef, mutate: (holder: FilterHolder) => void): void;
+    /** La sorgente scelta per un set che ancora non ne dichiara nessuna. */
+    private readonly pendingSource;
+    /**
+     * La sorgente dichiarata vince sempre: e' cio' che c'e' nel documento. Finche' non c'e' niente
+     * conta la scelta fatta nel pannello, e in mancanza si apre sulla query — la sorgente storica.
+     */
+    choiceSetSource(reference: FlowResourceRef): ChoiceSetSource;
+    /**
+     * Cambiare sorgente cancella le altre — dichiararne due e' `CHOICE_SET_SOURCE_AMBIGUOUS` — e
+     * anche i **campi citati**: `Label` non e' un campo di un'entita' e `Ragione_Sociale` non e' una
+     * proprieta' di un valore di enum, quindi lasciarli lì trasformerebbe un cambio di sorgente in
+     * tre `FIELD_UNKNOWN` che l'utente non ha scritto.
+     */
+    setChoiceSetSource(reference: FlowResourceRef, source: ChoiceSetSource): void;
+    /** Su un choice set da enum il tipo e' `enumType`: il campo generico sarebbe un doppione. */
+    hidesObjectType(reference: FlowResourceRef): boolean;
+    isChoiceSetSource(reference: FlowResourceRef, source: ChoiceSetSource): boolean;
+    /** Piu' di una sorgente nel documento: il runtime ne usa una sola (§5.2). */
+    ambiguousChoiceSetSource(reference: FlowResourceRef): boolean;
+    /**
+     * §5.2 — i campi citabili di un choice set da enum. Le etichette le dice il dizionario; il
+     * **tipo** no, e senza tipo il valore di un filtro su `NumericValue` sarebbe una casella di testo.
+     */
+    readonly enumChoiceSetFields: _angular_core.Signal<FilterFieldOption[]>;
+    /** Fuori dalle tre proprieta' di un valore di enum: `FIELD_UNKNOWN`. */
+    unknownEnumChoiceSetField(reference: FlowResourceRef, field: string): boolean;
+    /**
+     * §5.2 — qui l'elenco dei tipi e' **autorevole** quando non e' vuoto: un `enumType` che il
+     * catalogo non conosce e' un errore, non l'avviso che si darebbe su un catalogo di campi.
+     */
+    unknownEnumType(reference: FlowResourceRef): boolean;
+    readonly defaultDisplayField = "Label";
+    readonly defaultValueField = "Name";
     setValue(reference: FlowResourceRef, value: FlowValue | undefined): void;
     setDataType(reference: FlowResourceRef, dataType: string): void;
     requiresObjectType(reference: FlowResourceRef): boolean;
@@ -5688,5 +5873,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, 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_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, FlowApiError, FlowBuilderApi, FlowBuilderComponent, FlowCanvasComponent, FlowCatalogStore, FlowClipboardService, FlowDictionaryStore, FlowDocumentStore, FlowEditorSession, FlowLayoutService, FlowValidationStore, FormulaEditorComponent, FormulaValidationService, HttpFlowBuilderApi, NamePickerComponent, NodeInspectorBase, ORCHESTRATION_CONDITION_OUTPUT, ObjectPickerComponent, OrchestratedStageInspectorComponent, ParameterEditorComponent, PasteDialogComponent, ProblemsPanelComponent, RecordFilterEditorComponent, ReferencePickerComponent, 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, buildClipboardPayload, canvasNodeId, checkConditionLogic, checkFlowName, describePathEntry, duplicateField, elementIcon, emptyFlowDefinition, fieldAt, filterReferences, flattenFields, flowNodeWidth, flowNodeWidthClass, innerNamesOf, insertField, isClipboardPayload, isCustomConditionLogic, isEmptyReferenceFilter, isFieldResource, isGlobalReference, isNumericType, isPathInside, isTypeCheckedOperator, isValidFlowName, isValued, loadPathLevel, matchesReferenceFilter, moveCondition, moveField, navigatePath, outletByKey, outletsOf, parseCanvasNodeId, parseInvariantNumber, parseSourceConnectorId, parseTargetConnectorId, pathAvailableNames, pathContainerLabel, pathKey, pathNotVerifiableMessage, planPaste, referenceRoot, referencedRootsOf, remapConditionLogic, removeCondition, removeField, resolvePath, rewriteReferences, samePath, screenActionNames, screenFieldNames, severityBucket, slugifyFlowName, sourceConnectorId, stageStepNames, stageStepOutputReferenced, stepsOf, targetConnectorId, typeOfCollection, uniqueFlowName, valuedFieldOf, valuedFieldsOf, variantFieldOf, variantOf, variantPresetOf };
-export type { FieldAssignmentHolder, FilterHolder, FlowActionCall, FlowAnyNode, FlowAssignment, FlowAssignmentItem, FlowAssignmentOperator, FlowAssignmentOperatorEntry, FlowBuilderHttpConfig, FlowCanvasEdge, 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, FlowFormulaIssue, FlowFormulaUsage, FlowFormulaValidationRequest, FlowFormulaValidationResult, FlowGlobalVariableEntry, FlowInputFieldAssignment, FlowInputParameter, FlowInterviewResult, FlowInterviewStatus, FlowIssueSeverity, FlowLayoutDirection, FlowLayoutNodeInput, FlowLayoutOptions, FlowLayoutResult, FlowListQuery, FlowLoop, FlowNameCheck, FlowNameProblem, FlowNewVersionRequest, FlowNodeBase, FlowNodeCollection, FlowNodeRef, FlowObjectDescription, FlowObjectSummary, FlowOffsetUnit, FlowOrchestratedStage, FlowOutlet, FlowOutline, FlowOutlineConnection, FlowOutlineNode, FlowOutputFieldAssignment, FlowOutputParameter, FlowPalettePick, FlowPastePlan, FlowPasteRename, FlowPasteResource, FlowPendingScreen, FlowProcessType, FlowRecordCreate, FlowRecordDelete, FlowRecordFilter, FlowRecordFilterOperator, FlowRecordLookup, FlowRecordRollback, FlowRecordTriggerType, FlowRecordUpdate, FlowRecordValue, FlowReference, FlowReferenceFilter, FlowReferenceKind, FlowRegionContainerType, FlowResourceCollection, FlowResourceKindEntry, FlowResourceRef, FlowResumeRequest, FlowRunOutcome, FlowRunRequest, FlowSaveRequest, FlowSaveResult, FlowSchedule, FlowScheduledPath, FlowScreen, FlowScreenAction, FlowScreenField, FlowScreenFieldInputsRevisited, FlowScreenFieldNode, FlowScreenFieldPath, FlowScreenFieldType, FlowScreenFieldTypeEntry, 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, 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_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, HttpFlowBuilderApi, NamePickerComponent, NodeInspectorBase, ORCHESTRATION_CONDITION_OUTPUT, ObjectPickerComponent, OrchestratedStageInspectorComponent, ParameterEditorComponent, PasteDialogComponent, ProblemsPanelComponent, RecordFilterEditorComponent, ReferencePickerComponent, 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, buildClipboardPayload, canvasNodeId, checkConditionLogic, checkFlowName, choiceSetSourceOf, declaredChoiceSetSources, describePathEntry, duplicateField, elementIcon, emptyFlowDefinition, enumChoiceSetFieldType, fieldAt, filterReferences, flattenFields, flowNodeWidth, flowNodeWidthClass, innerNamesOf, insertField, isClipboardPayload, isCustomConditionLogic, isEmptyReferenceFilter, isFieldResource, isGlobalReference, isNumericType, isPathInside, isTypeCheckedOperator, isUnknownEnumChoiceSetField, isValidFlowName, isValued, loadPathLevel, matchesReferenceFilter, moveCondition, moveField, navigatePath, otherSourceFieldsOf, outletByKey, outletsOf, parseCanvasNodeId, parseInvariantNumber, parseSourceConnectorId, parseTargetConnectorId, pathAvailableNames, pathContainerLabel, pathKey, pathNotVerifiableMessage, planPaste, referenceRoot, referencedRootsOf, remapConditionLogic, removeCondition, removeField, resolvePath, rewriteReferences, 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, 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, FlowFormulaIssue, FlowFormulaUsage, FlowFormulaValidationRequest, FlowFormulaValidationResult, FlowGlobalVariableEntry, FlowInputFieldAssignment, FlowInputParameter, FlowInterviewResult, FlowInterviewStatus, FlowIssueSeverity, FlowLayoutDirection, FlowLayoutNodeInput, FlowLayoutOptions, FlowLayoutResult, FlowListQuery, FlowLoop, FlowNameCheck, FlowNameProblem, FlowNewVersionRequest, FlowNodeBase, FlowNodeCollection, FlowNodeRef, FlowObjectDescription, FlowObjectSummary, FlowOffsetUnit, FlowOrchestratedStage, FlowOutlet, FlowOutline, FlowOutlineConnection, FlowOutlineNode, FlowOutputFieldAssignment, FlowOutputParameter, FlowPalettePick, FlowPastePlan, FlowPasteRename, FlowPasteResource, FlowPendingScreen, FlowProcessType, FlowRecordCreate, FlowRecordDelete, FlowRecordFilter, FlowRecordFilterOperator, FlowRecordLookup, FlowRecordRollback, FlowRecordTriggerType, FlowRecordUpdate, FlowRecordValue, FlowReference, FlowReferenceFilter, FlowReferenceKind, FlowRegionContainerType, FlowResourceCollection, FlowResourceKindEntry, FlowResourceRef, FlowResumeRequest, FlowRunOutcome, FlowRunRequest, FlowSaveRequest, FlowSaveResult, FlowSchedule, FlowScheduledPath, FlowScreen, FlowScreenAction, FlowScreenField, FlowScreenFieldInputsRevisited, FlowScreenFieldNode, FlowScreenFieldPath, FlowScreenFieldType, FlowScreenFieldTypeEntry, 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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esfaenza/flow-builder",
-  "version": "20.3.23",
+  "version": "20.3.25",
   "peerDependencies": {
     "@angular/cdk": "^20.2.14",
     "@angular/common": "^20.3.24",

package/styles/flow-builder.css

@@ -402,6 +402,102 @@ f-flow .fb-edge--goto .f-connection-path {
   line-height: 1;
 }
 
+/**
+ * Il controllo segmentato: una scelta **esclusiva** fra poche voci, mostrata come un gruppo con una
+ * cornice sola invece che come bottoni sciolti. Lo usano le modalita' di un valore (§4.2: un solo
+ * campo valorizzato), la logica di condizioni e filtri e l'esito atteso di un operatore unario —
+ * cioe' controlli che nello stesso pannello si guardano, e che quindi devono essere uguali.
+ *
+ * Sta qui e non nei tre componenti perche' era già duplicato tre volte e i tre stili avevano
+ * cominciato a divergere. Vale l'avvertenza dei CSS con scope: queste regole sono globali, quindi
+ * un componente non deve ridefinirle — le variabili `--fb-*` sono la leva per ritemizzarle.
+ *
+ * `width: fit-content` con `max-width: 100%`: la cornice si stringe sul contenuto — nella dialog,
+ * larga il doppio, una barra da bordo a bordo sarebbe mezza vuota — ma nella colonna
+ * dell'inspector, dove le quattro voci di un valore non ci stanno in riga, va a capo invece di
+ * sfondare. `inline-flex` non servirebbe: dentro una colonna `flex` viene comunque blockificato.
+ */
+.fb-value__modes,
+.fb-filter__modes,
+.fb-cond__modes,
+.fb-cond__unary {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 2px;
+  width: fit-content;
+  max-width: 100%;
+  padding: 2px;
+  border: 1px solid var(--fb-border-subtle, #eef0f4);
+  border-radius: var(--fb-radius-sm, 8px);
+  background: var(--fb-surface-sunken, #eef0f4);
+}
+
+.fb-value__mode,
+.fb-filter__mode,
+.fb-cond__mode {
+  padding: 3px 10px;
+  border: 0;
+  border-radius: var(--fb-radius-xs, 6px);
+  background: transparent;
+  color: var(--fb-text-muted, #6b7086);
+  font: inherit;
+  font-size: 11px;
+  font-weight: 500;
+  line-height: 1.5;
+  white-space: nowrap;
+  cursor: pointer;
+  transition: background 0.12s ease, color 0.12s ease, box-shadow 0.12s ease;
+}
+
+.fb-value__mode:hover:not(:disabled),
+.fb-filter__mode:hover:not(:disabled),
+.fb-cond__mode:hover:not(:disabled) {
+  /* Sulla superficie affossata del gruppo un grigio piu' scuro non si vedrebbe: si schiarisce. */
+  background: color-mix(in srgb, var(--fb-surface, #fff) 65%, transparent);
+  color: var(--fb-text, #1a1c23);
+}
+
+.fb-value__mode:focus-visible,
+.fb-filter__mode:focus-visible,
+.fb-cond__mode:focus-visible {
+  outline: 2px solid var(--fb-accent, #4f6ef7);
+  outline-offset: 1px;
+}
+
+/* La voce scelta sale sulla superficie: e' la differenza che si legge anche senza il colore. */
+.fb-value__mode--active,
+.fb-filter__mode--active,
+.fb-cond__mode--active {
+  background: var(--fb-surface, #fff);
+  color: var(--fb-accent, #4f6ef7);
+  font-weight: 600;
+  box-shadow: var(--fb-shadow-sm, 0 1px 2px rgb(16 24 40 / 6%));
+}
+
+.fb-value__mode:disabled,
+.fb-filter__mode:disabled,
+.fb-cond__mode:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+
+/**
+ * «Nessun valore» non e' una modalita' alla pari delle altre: e' l'uscita, e non prende mai lo
+ * stato attivo — quando lo sarebbe, il bottone non c'e'.
+ */
+.fb-value__mode--clear {
+  margin-left: 4px;
+  padding: 3px 7px;
+  color: var(--fb-text-subtle, #98a2b3);
+  font-size: 12px;
+  line-height: 1.25;
+}
+
+.fb-value__mode--clear:hover:not(:disabled) {
+  background: color-mix(in srgb, var(--fb-error, #dc2626) 12%, transparent);
+  color: var(--fb-error, #dc2626);
+}
+
 .fb-section {
   margin: 0 0 14px;
   padding: 0;