@esfaenza/flow-builder 20.3.1 → 20.3.3

package/index.d.ts

@@ -1294,10 +1294,45 @@ declare const TYPES_WITH_AUTOMATIC_OUTPUT: ReadonlySet<string>;
  */
 declare const FLOW_ELEMENT_ICONS: Record<string, string>;
 /**
- * Il glifo del tipo. Per un tipo che il dizionario del backend aggiunge e questa mappa non
- * conosce, l'iniziale dell'etichetta e' un segnaposto migliore di un simbolo generico.
+ * Il glifo delle varianti (§5.5): due voci di palette dello stesso tipo con lo stesso simbolo
+ * si distinguerebbero solo dall'etichetta, e sulla palette il simbolo e' la prima cosa che si
+ * guarda. La chiave e' `tipo:variante`.
  */
-declare function elementIcon(type: string, label?: string): string;
+declare const FLOW_ELEMENT_VARIANT_ICONS: Record<string, string>;
+/**
+ * Il glifo del tipo, o della sua variante quando c'e'. Per un tipo che il dizionario del
+ * backend aggiunge e questa mappa non conosce, l'iniziale dell'etichetta e' un segnaposto
+ * migliore di un simbolo generico.
+ */
+declare function elementIcon(type: string, label?: string, variant?: string): string;
+
+/**
+ * I tipi che sulla palette valgono per **piu' di una voce** — FRONTEND.md §5.5.
+ *
+ * Il Collection Processor e' un solo tipo di node con un discriminatore
+ * (`collectionProcessorType`: `Sort` o `Filter`), e i campi rilevanti cambiano con esso: un
+ * `Sort` vuole `sortOptions`, un `Filter` vuole condizioni. Sono due gesti diversi, e una
+ * voce sola («ordina o filtra») costringe a scegliere dopo, dentro il form.
+ *
+ * Qui sta **solo** la mappa tipo → campo del discriminatore: i valori ammessi restano nel
+ * dizionario del backend (`collectionProcessorTypes`), come per ogni altro enum (§6.4). Senza
+ * quel dizionario il tipo torna a essere una voce sola, che e' il comportamento giusto quando
+ * non si sa quali varianti esistano.
+ *
+ * Se un tipo nuovo arrivasse con lo stesso schema — un node con un discriminatore che ne
+ * cambia i campi — si aggiunge una riga qui e la palette si divide da se'.
+ */
+/** Tipo di elemento → campo del node che porta la variante. */
+declare const FLOW_ELEMENT_VARIANT_FIELDS: Record<string, string>;
+/** Il campo del discriminatore, se il tipo ne ha uno. */
+declare function variantFieldOf(type: string): string | undefined;
+/** La variante di un node già scritto, letta dal suo discriminatore. */
+declare function variantOf(type: string, node: Record<string, unknown>): string | undefined;
+/**
+ * I campi da scrivere su un node appena creato dalla variante scelta. Vuoto per i tipi senza
+ * varianti: chi crea l'elemento non deve sapere quali sono.
+ */
+declare function variantPresetOf(type: string, variant: string | undefined): Record<string, unknown>;
 
 /**
  * Nomi — FRONTEND.md §3.3, §13.5.
@@ -1634,6 +1669,15 @@ declare class FlowDictionaryStore {
     /** Le categorie della palette, nell'ordine di prima apparizione nel dizionario. */
     readonly paletteCategories: _angular_core.Signal<string[]>;
     elementType(value: string): FlowElementTypeEntry | undefined;
+    /**
+     * Le varianti di un tipo, cioe' i valori del suo discriminatore (§5.5). L'unico oggi e' il
+     * Collection Processor. Elenco vuoto = tipo senza varianti, **oppure** dizionario non
+     * disponibile: in entrambi i casi la palette mostra una voce sola, che e' l'unica cosa
+     * onesta da fare quando non si sa quali varianti esistano.
+     */
+    variantsOf(type: string): FlowDictionaryEntry[];
+    /** L'etichetta di una variante, con fallback sul valore grezzo. */
+    variantLabelOf(type: string, variant: string | undefined): string;
     /** La collection in cui scrivere un node: `metadataProperty`, con fallback locale (§3.2). */
     collectionOf(type: string): FlowNodeCollection | undefined;
     /** Etichetta di un tipo, con fallback: un tipo sconosciuto mostra il proprio `value`. */
@@ -2018,6 +2062,8 @@ declare class FlowCanvasComponent {
     /** Rilascio di un elemento dalla palette: tipo + punto nel sistema del canvas. */
     readonly elementDropped: _angular_core.OutputEmitterRef<{
         type: FlowElementType;
+        /** La variante scelta sulla palette, dove il tipo ne ha (§5.5). */
+        variant?: string;
         x: number;
         y: number;
     }>;
@@ -2068,7 +2114,11 @@ declare class FlowCanvasComponent {
     onDeleteSelected(event: {
         nodeIds: string[];
     }): void;
-    /** Rilascio di un elemento trascinato dalla palette. */
+    /**
+     * Rilascio di un elemento trascinato dalla palette. Il dato e' `{type, variant}`, ma si
+     * accetta ancora la stringa nuda: un ospite che monta il canvas con una palette propria
+     * potrebbe passare il solo tipo.
+     */
     onCreateNode(event: {
         data: unknown;
         externalItemRect: {
@@ -2094,9 +2144,27 @@ declare class FlowCanvasComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<FlowCanvasComponent, "fb-flow-canvas", never, { "selectedName": { "alias": "selectedName"; "required": false; "isSignal": true; }; "outline": { "alias": "outline"; "required": false; "isSignal": true; }; }, { "selectionChange": "selectionChange"; "nodeOpened": "nodeOpened"; "nodeRemoveRequested": "nodeRemoveRequested"; "nodeDuplicateRequested": "nodeDuplicateRequested"; "elementDropped": "elementDropped"; }, never, never, true, never>;
 }
 
+/** Il gesto scelto sulla palette: un tipo e, dove esiste, la sua variante (§5.5). */
+interface FlowPalettePick {
+    type: FlowElementType;
+    variant?: string;
+}
+/**
+ * Una voce della palette. Non coincide con una voce del dizionario: un tipo con varianti ne
+ * produce una per variante, perche' «ordina» e «filtra» sono due gesti diversi anche se il
+ * modello li scrive nello stesso node.
+ */
+interface PaletteItem {
+    /** Chiave stabile della voce: serve al `track` e all'id del trascinamento. */
+    key: string;
+    entry: FlowElementTypeEntry;
+    variant?: string;
+    label: string;
+    data: FlowPalettePick;
+}
 interface PaletteGroup {
     category: string;
-    entries: FlowElementTypeEntry[];
+    items: PaletteItem[];
 }
 declare class ElementPaletteComponent {
     private readonly dictionaries;
@@ -2106,23 +2174,29 @@ declare class ElementPaletteComponent {
      * prima che l'utente lo scopra dal pannello dei problemi.
      */
     readonly processType: _angular_core.InputSignal<string | undefined>;
-    readonly elementPicked: _angular_core.OutputEmitterRef<string>;
+    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. */
+    private readonly items;
     readonly groups: _angular_core.Signal<PaletteGroup[]>;
     readonly isEmpty: _angular_core.Signal<boolean>;
     onFilter(value: string): void;
-    pick(entry: FlowElementTypeEntry): void;
+    pick(item: PaletteItem): void;
     /** Uno screen in un flow che non mostra nulla: si segnala, non si nasconde (§3.1). */
-    isIncompatible(entry: FlowElementTypeEntry): boolean;
-    incompatibleHint(entry: FlowElementTypeEntry): string | null;
+    isIncompatible(item: PaletteItem): boolean;
+    /**
+     * 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.
+     */
+    hintOf(item: PaletteItem): string;
     /** Lo stesso glifo che l'elemento avra' sul canvas, così il trascinamento e' prevedibile. */
-    iconOf(entry: FlowElementTypeEntry): string;
+    iconOf(item: PaletteItem): string;
     /**
      * L'etichetta del ramo di fault, presa dalla mappa delle uscite invece di scrivere «ramo di
      * errore» per tutti: su uno stage di orchestrazione quel ramo **non** e' un guasto, e' lo step
      * rifiutato (§5.13). Un tipo nuovo eredita l'etichetta giusta senza toccare la palette.
      */
-    faultLabel(entry: FlowElementTypeEntry): string | null;
+    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>;
@@ -2192,6 +2266,126 @@ declare class ReferencePickerComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ReferencePickerComponent, "fb-reference-picker", never, { "value": { "alias": "value"; "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; }; "dataType": { "alias": "dataType"; "required": false; "isSignal": true; }; "isCollection": { "alias": "isCollection"; "required": false; "isSignal": true; }; "objectType": { "alias": "objectType"; "required": false; "isSignal": true; }; "writableOnly": { "alias": "writableOnly"; "required": false; "isSignal": true; }; "elementsOnly": { "alias": "elementsOnly"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
 }
 
+declare class ObjectPickerComponent {
+    private readonly catalog;
+    readonly value: _angular_core.InputSignal<string | 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 objects;
+    private readonly loadFailed;
+    readonly isOpen: _angular_core.WritableSignal<boolean>;
+    /**
+     * Il testo digitato **mentre** il pannello e' aperto: filtra l'elenco. Chiuso il pannello
+     * torna a null e la casella mostra di nuovo il valore del documento, che e' l'unica
+     * fonte di verita'.
+     */
+    private readonly query;
+    constructor();
+    /** Quel che si vede nella casella: il filtro se si sta digitando, il valore altrimenti. */
+    readonly text: _angular_core.Signal<string>;
+    readonly options: _angular_core.Signal<FlowObjectSummary[]>;
+    readonly hasCatalog: _angular_core.Signal<boolean>;
+    /**
+     * Nome fuori catalogo: si avvisa e non si blocca. Senza catalogo non si accusa nessuno —
+     * "non lo so" non e' "non esiste".
+     */
+    readonly isUnknown: _angular_core.Signal<boolean>;
+    readonly labelOfValue: _angular_core.Signal<string | null>;
+    readonly loadErrored: _angular_core.Signal<boolean>;
+    open(): void;
+    close(): void;
+    toggle(): void;
+    /** Digitare filtra **e** scrive: il nome puo' non essere in catalogo. */
+    onInput(text: string): void;
+    choose(object: FlowObjectSummary): void;
+    clear(): void;
+    describe(object: FlowObjectSummary): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ObjectPickerComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ObjectPickerComponent, "fb-object-picker", never, { "value": { "alias": "value"; "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 FieldPickerComponent {
+    private readonly catalog;
+    readonly value: _angular_core.InputSignal<string | undefined>;
+    /** L'entita' di cui elencare i campi: senza oggetto non c'e' catalogo. */
+    readonly object: _angular_core.InputSignal<string | undefined>;
+    readonly usage: _angular_core.InputSignal<FlowFieldUsage>;
+    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 fields;
+    private readonly loadFailed;
+    readonly isOpen: _angular_core.WritableSignal<boolean>;
+    /** Il testo digitato mentre il pannello e' aperto: filtra l'elenco. */
+    private readonly query;
+    constructor();
+    readonly text: _angular_core.Signal<string>;
+    readonly options: _angular_core.Signal<FlowFieldDescription[]>;
+    readonly hasCatalog: _angular_core.Signal<boolean>;
+    /** `true` se il valore e' un percorso di relazione: non enumerabile, non verificato (§4.4). */
+    readonly isRelationPath: _angular_core.Signal<boolean>;
+    readonly isUnknown: _angular_core.Signal<boolean>;
+    /** L'avviso dipende dall'uso: un campo puo' esistere e non essere filtrabile. */
+    readonly unknownMessage: _angular_core.Signal<"Questo campo non e’ fra quelli filtrabili dell’oggetto." | "Questo campo non e’ fra quelli su cui si puo’ ordinare." | "Questo campo non e’ fra quelli aggiornabili dell’oggetto." | "Questo campo non e’ fra quelli dell’oggetto.">;
+    readonly describeValue: _angular_core.Signal<string | null>;
+    readonly loadErrored: _angular_core.Signal<boolean>;
+    open(): void;
+    close(): void;
+    toggle(): void;
+    onInput(text: string): void;
+    choose(field: FlowFieldDescription): void;
+    clear(): void;
+    describe(field: FlowFieldDescription): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<FieldPickerComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FieldPickerComponent, "fb-field-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "object": { "alias": "object"; "required": false; "isSignal": true; }; "usage": { "alias": "usage"; "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>;
+}
+
+interface NamePickerOption {
+    name: string;
+    label?: string | null;
+    description?: string | null;
+}
+declare class NamePickerComponent {
+    readonly value: _angular_core.InputSignal<string | undefined>;
+    readonly options: _angular_core.InputSignal<NamePickerOption[]>;
+    readonly label: _angular_core.InputSignal<string>;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    readonly disabled: _angular_core.InputSignal<boolean>;
+    /** Il testo dell'avviso sul nome fuori elenco: dipende da cosa si sta scegliendo. */
+    readonly unknownMessage: _angular_core.InputSignal<string>;
+    /**
+     * La gravita' dell'avviso. Non e' cosmetica: un'action o un form che non esistono sono
+     * **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">;
+    /** Cosa dire quando l'elenco e' vuoto: e' il caso "non lo so", non un errore. */
+    readonly emptyMessage: _angular_core.InputSignal<string>;
+    /** Testo monospazio: i nomi tecnici si leggono meglio, ed e' come li mostra il resto del form. */
+    readonly isMono: _angular_core.InputSignal<boolean>;
+    readonly valueChange: _angular_core.OutputEmitterRef<string | undefined>;
+    readonly isOpen: _angular_core.WritableSignal<boolean>;
+    private readonly query;
+    constructor();
+    readonly text: _angular_core.Signal<string>;
+    readonly visibleOptions: _angular_core.Signal<NamePickerOption[]>;
+    readonly hasOptions: _angular_core.Signal<boolean>;
+    readonly isUnknown: _angular_core.Signal<boolean>;
+    readonly labelOfValue: _angular_core.Signal<string | null>;
+    open(): void;
+    close(): void;
+    toggle(): void;
+    onInput(text: string): void;
+    choose(option: NamePickerOption): void;
+    clear(): void;
+    describe(option: NamePickerOption): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NamePickerComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NamePickerComponent, "fb-name-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "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; }; "unknownMessage": { "alias": "unknownMessage"; "required": false; "isSignal": true; }; "unknownSeverity": { "alias": "unknownSeverity"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "isMono": { "alias": "isMono"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
+}
+
 /** Le modalita' offerte: una per campo del modello. */
 type ValueMode = 'reference' | 'literal' | 'formula' | 'globalConstant' | 'empty';
 declare class ValueEditorComponent {
@@ -2367,9 +2561,6 @@ declare class RecordFilterEditorComponent {
     readonly filters: _angular_core.Signal<FlowRecordFilter[]>;
     readonly operators: _angular_core.Signal<_esfaenza_flow_builder.FlowDictionaryEntry[]>;
     constructor();
-    readonly fieldOptions: _angular_core.Signal<FlowFieldDescription[]>;
-    /** Catalogo vuoto = "non lo so": si lascia il campo libero, non si blocca (§7). */
-    readonly hasFieldCatalog: _angular_core.Signal<boolean>;
     readonly logicMode: _angular_core.Signal<"and" | "or" | "formula" | "custom">;
     readonly customLogic: _angular_core.Signal<string>;
     readonly showEmptyWarning: _angular_core.Signal<boolean>;
@@ -2384,10 +2575,11 @@ declare class RecordFilterEditorComponent {
     setLogicMode(mode: 'and' | 'or' | 'custom' | 'formula'): void;
     setCustomLogic(logic: string): void;
     setFormula(formula: string): void;
-    /** Il tipo del campo, per proporre il controllo giusto sul valore. */
+    /**
+     * Il tipo del campo, per proporre il controllo giusto sul valore: e' il motivo per cui il
+     * catalogo resta caricato qui, e non solo dentro il picker.
+     */
     fieldDataType(filter: FlowRecordFilter): string | undefined;
-    /** `true` se il campo referenzia una relazione: la validazione non lo verifica (§4.4). */
-    isRelationPath(filter: FlowRecordFilter): boolean;
     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>;
 }
@@ -2413,11 +2605,18 @@ declare class ParameterEditorComponent {
     readonly hasCatalog: _angular_core.Signal<boolean>;
     readonly inputCatalog: _angular_core.Signal<FlowCatalogParameter[]>;
     readonly outputCatalog: _angular_core.Signal<FlowCatalogParameter[]>;
+    /**
+     * I candidati come li vuole il picker. Il tipo e l'obbligatorieta' finiscono nella
+     * descrizione: nel `<select>` erano un asterisco muto, che non diceva quale valore ci sta.
+     */
+    readonly inputOptions: _angular_core.Signal<NamePickerOption[]>;
+    readonly outputOptions: _angular_core.Signal<NamePickerOption[]>;
     /** Parametri obbligatori dichiarati dal catalogo e non ancora presenti. */
     readonly missingRequired: _angular_core.Signal<FlowCatalogParameter[]>;
-    /** Parametri presenti che il catalogo non conosce: sarebbero `PARAMETER_UNKNOWN`. */
-    unknownInput(parameter: FlowInputParameter): boolean;
-    unknownOutput(parameter: FlowOutputParameter): boolean;
+    /**
+     * Il parametro fuori catalogo (`PARAMETER_UNKNOWN`) lo segnala il picker, che ha in mano sia
+     * l'elenco sia il valore. Qui resta la descrizione, che serve all'editor di valore.
+     */
     describe(name: string | undefined): FlowCatalogParameter | undefined;
     addInput(name?: string): void;
     addOutput(name?: string): void;
@@ -2443,7 +2642,6 @@ declare class FieldAssignmentEditorComponent {
     readonly changed: _angular_core.OutputEmitterRef<(holder: FieldAssignmentHolder) => void>;
     private readonly fields;
     readonly assignments: _angular_core.Signal<FlowInputFieldAssignment[]>;
-    readonly fieldOptions: _angular_core.Signal<FlowFieldDescription[]>;
     readonly hasCatalog: _angular_core.Signal<boolean>;
     /** Campi obbligatori dell'entita' non ancora valorizzati. */
     readonly missingRequired: _angular_core.Signal<FlowFieldDescription[]>;
@@ -2452,9 +2650,11 @@ declare class FieldAssignmentEditorComponent {
     remove(index: number): void;
     setField(index: number, field: string): void;
     setValue(index: number, value: FlowValue | undefined): void;
+    /**
+     * Il tipo del campo serve all'editor di valore: e' il motivo per cui il catalogo resta
+     * caricato anche qui, oltre che dentro il picker.
+     */
     describe(name: string | undefined): FlowFieldDescription | undefined;
-    /** Il catalogo e' popolato ma non conosce questo campo: sarebbe `FIELD_UNKNOWN`. */
-    isUnknown(assignment: FlowInputFieldAssignment): boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<FieldAssignmentEditorComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<FieldAssignmentEditorComponent, "fb-field-assignment-editor", never, { "holder": { "alias": "holder"; "required": true; "isSignal": true; }; "object": { "alias": "object"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "disabledReason": { "alias": "disabledReason"; "required": false; "isSignal": true; }; }, { "changed": "changed"; }, never, never, true, never>;
 }
@@ -2597,7 +2797,6 @@ declare class ElementDialogComponent {
 declare class StartInspectorComponent {
     private readonly store;
     private readonly dictionaries;
-    private readonly catalog;
     private readonly validation;
     readonly start: _angular_core.Signal<FlowStart>;
     readonly startNode: _angular_core.Signal<FlowAnyNode>;
@@ -2606,10 +2805,6 @@ declare class StartInspectorComponent {
     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[]>;
-    private readonly objects;
-    constructor();
-    readonly objectOptions: _angular_core.Signal<FlowObjectSummary[]>;
-    readonly hasObjectCatalog: _angular_core.Signal<boolean>;
     readonly triggerType: _angular_core.Signal<string>;
     readonly isRecordTrigger: _angular_core.Signal<boolean>;
     readonly isScheduled: _angular_core.Signal<boolean>;
@@ -2663,9 +2858,8 @@ declare class OrchestratedStageInspectorComponent extends NodeInspectorBase {
      */
     private readonly flowCandidates;
     constructor();
-    readonly candidates: _angular_core.Signal<FlowSummary[]>;
-    /** L'id del `datalist`: dipende dall'elemento, per non collidere con un altro stage. */
-    readonly flowListId: _angular_core.Signal<string>;
+    /** I candidati come li vuole il picker: il nome del flow e' il suo `flowName`. */
+    readonly candidateOptions: _angular_core.Signal<NamePickerOption[]>;
     /**
      * I contenitori di condizioni, uno per step, calcolati **una volta** per documento: costruirli
      * nel template creerebbe un oggetto nuovo a ogni ciclo di change detection.
@@ -2750,14 +2944,12 @@ declare class ResourcePanelComponent {
     readonly kinds: ResourceKindDescriptor[];
     readonly dataTypes: _angular_core.Signal<_esfaenza_flow_builder.FlowDataTypeEntry[]>;
     readonly sortOrders: _angular_core.Signal<_esfaenza_flow_builder.FlowDictionaryEntry[]>;
-    private readonly objects;
     private readonly enumTypes;
     /** La collection aperta nel pannello. */
     readonly activeCollection: _angular_core.WritableSignal<"variables" | "constants" | "formulas" | "textTemplates" | "choices" | "dynamicChoiceSets" | "stages">;
     /** L'indice della risorsa in modifica, o `null`. */
     readonly editingIndex: _angular_core.WritableSignal<number | null>;
     constructor();
-    readonly objectOptions: _angular_core.Signal<FlowObjectSummary[]>;
     readonly enumOptions: _angular_core.Signal<FlowCatalogEntry[]>;
     readonly activeKind: _angular_core.Signal<ResourceKindDescriptor>;
     readonly items: _angular_core.Signal<FlowResourceRef[]>;
@@ -2948,7 +3140,7 @@ declare class FlowBuilderComponent {
      * troppo. `panel` tiene il form nel pannello laterale, che e' piu' comodo quando si
      * modificano molti elementi di fila perche' non c'e' niente da aprire e chiudere.
      */
-    readonly inspectorMode: _angular_core.InputSignal<"panel" | "dialog">;
+    readonly inspectorMode: _angular_core.InputSignal<"dialog" | "panel">;
     readonly saved: _angular_core.OutputEmitterRef<FlowSaveResult>;
     readonly activated: _angular_core.OutputEmitterRef<FlowSaveResult>;
     readonly closeRequested: _angular_core.OutputEmitterRef<void>;
@@ -3023,11 +3215,12 @@ declare class FlowBuilderComponent {
     /** Rilascio dalla palette: il punto di rilascio diventa `locationX`/`locationY` (§11). */
     onElementDropped(event: {
         type: FlowElementType;
+        variant?: string;
         x: number;
         y: number;
     }): void;
     /** Click sulla palette: l'elemento si posiziona in una zona libera. */
-    onElementPicked(type: FlowElementType): void;
+    onElementPicked(pick: FlowPalettePick): void;
     private createElement;
     onRemoveNode(name: string): void;
     onDuplicateNode(name: string): void;
@@ -3071,5 +3264,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, ElementDialogComponent, ElementInspectorComponent, ElementPaletteComponent, FALLBACK_COLLECTION_BY_TYPE, FALLBACK_TYPE_LABEL, FLOW_BUILDER_HTTP_CONFIG, FLOW_ELEMENT_ICONS, FLOW_ERROR_FALLBACK_MESSAGE, FLOW_ERROR_HTTP_STATUS, FLOW_NAME_PATTERN, FLOW_NODE_COLLECTIONS, FLOW_NODE_HEIGHT, FLOW_NODE_WIDTH, FLOW_RESOURCE_COLLECTIONS, FieldAssignmentEditorComponent, FlowApiError, FlowBuilderApi, FlowBuilderComponent, FlowCanvasComponent, FlowCatalogStore, FlowDictionaryStore, FlowDocumentStore, FlowEditorSession, FlowLayoutService, FlowValidationStore, HttpFlowBuilderApi, NodeInspectorBase, ORCHESTRATION_CONDITION_OUTPUT, OrchestratedStageInspectorComponent, ParameterEditorComponent, ProblemsPanelComponent, RecordFilterEditorComponent, ReferencePickerComponent, ResourcePanelComponent, START_NODE_NAME, SelectValueDirective, StartInspectorComponent, TYPES_WITH_AUTOMATIC_OUTPUT, TYPE_BY_COLLECTION, UNSUPPORTED_TYPES, ValueEditorComponent, VersionPanelComponent, areTypesComparable, canvasNodeId, checkConditionLogic, checkFlowName, elementIcon, emptyFlowDefinition, flowNodeWidth, flowNodeWidthClass, isCustomConditionLogic, isGlobalReference, isNumericType, isTypeCheckedOperator, isValidFlowName, moveCondition, outletByKey, outletsOf, parseCanvasNodeId, parseInvariantNumber, parseSourceConnectorId, parseTargetConnectorId, referenceRoot, remapConditionLogic, removeCondition, slugifyFlowName, sourceConnectorId, stageStepNames, stageStepOutputReferenced, stepsOf, targetConnectorId, uniqueFlowName };
-export type { FieldAssignmentHolder, FilterHolder, FlowActionCall, FlowAnyNode, FlowAssignment, FlowAssignmentItem, FlowAssignmentOperator, FlowAssignmentOperatorEntry, FlowBuilderHttpConfig, FlowCanvasEdge, FlowCanvasNode, FlowCatalogEntry, FlowCatalogParameter, FlowChoice, 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, FlowEdge, FlowElementType, FlowElementTypeEntry, FlowErrorCategory, FlowExportQuery, FlowFieldDescription, FlowFieldUsage, FlowFieldValue, FlowFormula, 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, FlowPendingScreen, FlowProcessType, FlowRecordCreate, FlowRecordDelete, FlowRecordFilter, FlowRecordFilterOperator, FlowRecordLookup, FlowRecordRollback, FlowRecordTriggerType, FlowRecordUpdate, FlowReference, FlowReferenceKind, FlowReferenceQuery, FlowResourceCollection, FlowResourceKindEntry, FlowResourceRef, FlowResumeRequest, FlowSaveRequest, FlowSaveResult, FlowSchedule, FlowScheduledPath, FlowScreen, FlowScreenNavigation, FlowScreenResponseRequest, FlowScriptPluginCall, FlowSortOption, FlowSortOrder, FlowStage, FlowStageStep, FlowStageStepActionType, FlowStageStepAssignee, FlowStageStepConditionActionType, FlowStageStepRequest, FlowStageStepState, FlowStageStepStatus, FlowStageStepTypeEntry, FlowStart, FlowStartInterviewRequest, FlowSubflow, FlowSubflowInputAssignment, FlowSubflowOutputAssignment, FlowSummary, FlowTextTemplate, FlowTraceEntry, FlowTransactionModel, FlowTransform, FlowTransformType, FlowTransformValue, FlowTransformValueAction, FlowTriggerType, FlowTypedValue, FlowUnsupportedNode, FlowValidationIssue, FlowValidationResult, FlowValue, FlowVariable, FlowVersionStatus, FlowVersionSummary, FlowWait, FlowWaitEvent, ParameterHolder, ValueMode };
+export { ConditionEditorComponent, ConnectorEditorComponent, DebugPanelComponent, ElementDialogComponent, ElementInspectorComponent, ElementPaletteComponent, FALLBACK_COLLECTION_BY_TYPE, FALLBACK_TYPE_LABEL, FLOW_BUILDER_HTTP_CONFIG, 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_RESOURCE_COLLECTIONS, FieldAssignmentEditorComponent, FieldPickerComponent, FlowApiError, FlowBuilderApi, FlowBuilderComponent, FlowCanvasComponent, FlowCatalogStore, FlowDictionaryStore, FlowDocumentStore, FlowEditorSession, FlowLayoutService, FlowValidationStore, HttpFlowBuilderApi, NamePickerComponent, NodeInspectorBase, ORCHESTRATION_CONDITION_OUTPUT, ObjectPickerComponent, OrchestratedStageInspectorComponent, ParameterEditorComponent, ProblemsPanelComponent, RecordFilterEditorComponent, ReferencePickerComponent, ResourcePanelComponent, START_NODE_NAME, SelectValueDirective, StartInspectorComponent, TYPES_WITH_AUTOMATIC_OUTPUT, TYPE_BY_COLLECTION, UNSUPPORTED_TYPES, ValueEditorComponent, VersionPanelComponent, areTypesComparable, canvasNodeId, checkConditionLogic, checkFlowName, elementIcon, emptyFlowDefinition, flowNodeWidth, flowNodeWidthClass, isCustomConditionLogic, isGlobalReference, isNumericType, isTypeCheckedOperator, isValidFlowName, moveCondition, outletByKey, outletsOf, parseCanvasNodeId, parseInvariantNumber, parseSourceConnectorId, parseTargetConnectorId, referenceRoot, remapConditionLogic, removeCondition, slugifyFlowName, sourceConnectorId, stageStepNames, stageStepOutputReferenced, stepsOf, targetConnectorId, uniqueFlowName, variantFieldOf, variantOf, variantPresetOf };
+export type { FieldAssignmentHolder, FilterHolder, FlowActionCall, FlowAnyNode, FlowAssignment, FlowAssignmentItem, FlowAssignmentOperator, FlowAssignmentOperatorEntry, FlowBuilderHttpConfig, FlowCanvasEdge, FlowCanvasNode, FlowCatalogEntry, FlowCatalogParameter, FlowChoice, 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, FlowEdge, FlowElementType, FlowElementTypeEntry, FlowErrorCategory, FlowExportQuery, FlowFieldDescription, FlowFieldUsage, FlowFieldValue, FlowFormula, 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, FlowPendingScreen, FlowProcessType, FlowRecordCreate, FlowRecordDelete, FlowRecordFilter, FlowRecordFilterOperator, FlowRecordLookup, FlowRecordRollback, FlowRecordTriggerType, FlowRecordUpdate, FlowReference, FlowReferenceKind, FlowReferenceQuery, FlowResourceCollection, FlowResourceKindEntry, FlowResourceRef, FlowResumeRequest, FlowSaveRequest, FlowSaveResult, FlowSchedule, FlowScheduledPath, FlowScreen, FlowScreenNavigation, FlowScreenResponseRequest, FlowScriptPluginCall, FlowSortOption, FlowSortOrder, FlowStage, FlowStageStep, FlowStageStepActionType, FlowStageStepAssignee, FlowStageStepConditionActionType, FlowStageStepRequest, FlowStageStepState, FlowStageStepStatus, FlowStageStepTypeEntry, FlowStart, FlowStartInterviewRequest, FlowSubflow, FlowSubflowInputAssignment, FlowSubflowOutputAssignment, FlowSummary, FlowTextTemplate, FlowTraceEntry, FlowTransactionModel, FlowTransform, FlowTransformType, FlowTransformValue, FlowTransformValueAction, FlowTriggerType, FlowTypedValue, FlowUnsupportedNode, FlowValidationIssue, FlowValidationResult, FlowValue, FlowVariable, FlowVersionStatus, FlowVersionSummary, FlowWait, FlowWaitEvent, NamePickerOption, PaletteGroup, PaletteItem, ParameterHolder, ValueMode };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esfaenza/flow-builder",
-  "version": "20.3.1",
+  "version": "20.3.3",
   "peerDependencies": {
     "@angular/common": "^20.3.25",
     "@angular/core": "^20.3.25",

package/styles/flow-builder.css

@@ -413,6 +413,19 @@ f-flow .fb-edge--goto .f-connection-path {
   margin-bottom: 6px;
 }
 
+/**
+ * I picker sono elementi custom: senza `flex` occuperebbero la larghezza del loro contenuto,
+ * e dentro l'intestazione di una voce di elenco resterebbero una casella minuscola accanto al
+ * bottone di rimozione. La regola sta qui perche' vale per ogni editor che li mette in fila.
+ */
+.fb-list__header > fb-name-picker,
+.fb-list__header > fb-field-picker,
+.fb-list__header > fb-object-picker,
+.fb-list__header > fb-reference-picker {
+  flex: 1;
+  min-width: 0;
+}
+
 .fb-list__index {
   display: grid;
   place-items: center;