@esfaenza/flow-builder 20.3.9 → 20.3.11

package/README.md

@@ -133,7 +133,7 @@ sono opzionali e rifiutano con `MissingService` se non sovrascritti.
 | §6.4 Dizionari e cataloghi | |
 |---|---|
 | `getDictionaries(processType?)` | astratto — `processType` filtra le globali (§4.1) |
-| `getReferences(query)` / `getWritableReferences(query)` | astratti |
+| `getReferences(definition)` / `getWritableReferences(definition)` | astratti — prendono il **documento nudo** e restituiscono **tutti** i riferimenti: nel body non c'e' nessun filtro di tipo, e la compatibilita' col campo la decide l'editor (§6.4, §13.17) |
 | `getConnectorTargets(definition, excluding?)` | astratto |
 | `getOutline(definition)` | astratto |
 | `listObjects()`, `listFields(object, usage?)` | astratti |
@@ -254,6 +254,32 @@ Restano fuori i percorsi radicati sul risultato **automatico** di un elemento
 (`Leggi_Contatti.Owner.Name`): la validazione non li verifica, e l'editor non accusa cio' che il
 backend non verifica.
 
+Il filtro di tipo di un campo (§6.4) lo applica **l'editor**: la primitiva prende il documento nudo
+e restituisce tutti i riferimenti, così la stessa risposta serve tutte le tendine di una schermata
+(§13.17). La regola sta in `core/reference-filter.util.ts`, ed e' la stessa per le radici e per i
+segmenti di un percorso. Il filtro guarda il tipo della **radice**, e quindi non basta: in un
+parametro `String` una variabile `Structure` non e' compatibile, ma `Richiesta.Ragione` sì. Per
+questo `<fb-reference-picker>` tiene l'elenco **completo** accanto a quello filtrato, e ne ricava
+due cose: i contenitori compaiono come righe in cui si **entra** — cliccarle apre il percorso
+invece di scegliere un valore del tipo sbagliato — e le radici si riconoscono tutte, così un
+`Leggi_Ordine.Numero` già scritto in un campo `String` non viene accusato di non esistere. Nelle
+proposte non entra comunque nessun valore del tipo sbagliato: i segmenti li filtra la stessa
+regola, tenendo solo quelli da cui si scende. In un campo di **destinazione** le due liste sono due
+richieste — `getWritableReferences` per le proposte, `getReferences` per le radici — perche' la
+scrivibilita' e' del **percorso** e non della radice: un `$User.Anagrafica.Citta` scritto a mano e'
+`TARGET_NOT_WRITABLE`, non un nome che non esiste.
+
+**Le globali si navigano come le risorse.** Un percorso dichiarato dall'host puo' portare un
+contenitore, e allora `objectType` dice di che tipo: `$User.Anagrafica.Citta` si propone e si
+verifica come `Richiesta.Ragione`. La regola da non sbagliare e' che vince il **prefisso dichiarato
+piu' lungo** — non tutto cio' che segue lo scope — perche' altrimenti un percorso giusto viene
+segnalato come rotto (§4.1). Dove il catalogo dichiara il contenitore ma non il tipo il rilievo e'
+`PATH_NOT_VERIFIABLE`, e la correzione sta nel catalogo dell'host; navigare uno scalare
+(`$User.Email.Dominio`) e' invece `GLOBAL_UNKNOWN`. Sulle **destinazioni** non cambia niente da
+sapere: le globali sono di sola lettura, membri compresi — le assegnabili sono `$Flow.CurrentStage`,
+`$Flow.ActiveStages` e i campi di `$Record` — e il picker lo dice con `TARGET_NOT_WRITABLE` invece
+di far sembrare il nome inesistente (§5.2).
+
 Su una destinazione la colonna che decide non e' la stessa nei due mondi: un membro porta il proprio
 `isWritable`, un campo no. Fuori da un Create o da un Update il contesto non c'e' — un Assignment su
 `Cliente.Codice` non sa se quel record verra' creato o aggiornato — quindi lì basta `isCreateable`
@@ -430,6 +456,8 @@ distribuire e nessuna dipendenza da un font di icone dell'applicazione ospite.
 | 14 | **`None` non e' un operatore, e' un "da completare"** | Condizione evidenziata come incompleta, con il conteggio in testa alla sezione e la frase «la bozza si salva, l'attivazione no»; il validatore della demo lo emette come **errore** |
 | 15 | **Un valore data senza `Z` significa ora locale** | `ValueEditorComponent` ha un selettore «Ora locale / UTC (Z)», dice che cambiare fuso riscrive l'orario e non lo converte, e toglie il suffisso solo per il controllo `datetime-local`, che con il fuso resterebbe vuoto |
 | 16 | **`Structure` e `Object` non sono intercambiabili** | `StructurePickerComponent` per la classe (fuori catalogo = **errore**, `STRUCTURE_TYPE_UNKNOWN`) e `StructureMemberPickerComponent` per i membri, filtrati su `isWritable` dove serve una destinazione. Il pannello risorse mostra la classe come obbligatoria con severita' di errore e **non** mostra il valore iniziale, perche' un `structureValue` non esiste; `ReferencePickerComponent` propone `Variabile.Membro` e verifica il percorso **fino in fondo** con `core/path-navigation.ts`, con `PATH_NOT_VERIFIABLE` dove la catena si interrompe; il Transform con target classe chiede un membro invece di un campo. `FlowDictionaryStore.isStructure` legge il flag dal dizionario, non dal nome del tipo. La risposta dei membri e' la **descrizione della classe** (`{className, label, members}`), e i suoi tre esiti restano distinti fino alla UI: `FlowCatalogStore.describeStructure` li traduce in `declared` / `undeclared` / `unknown-class` / `unknown-catalog`, e solo `declared` autorizza a dire che un membro non esiste (§4.7.1) |
+| 17 | **Due body diversi per due famiglie di primitive** | `HttpFlowBuilderApi`: le primitive che **analizzano** il documento — `validate`, `parse`, `references`, `references/writable`, `connector-targets`, `outline` — lo mandano **nudo alla radice**; l'involucro `{definition, flowName, …}` resta alle sole primitive di scrittura della §6.2. Sbagliare involucro non da' nessun errore: il backend legge un flow vuoto e risponde `200`. Per lo stesso motivo `getReferences`/`getWritableReferences` prendono la `FlowDefinition` e non un oggetto query: non c'e' nessun campo di filtro nel body, e il filtro di tipo lo applica l'editor con `core/reference-filter.util.ts` |
+| 18 | **Gli enum si scrivono come stringhe** | Il modello e' fatto di unioni di stringhe letterali (`FlowDataType`, `FlowVersionStatus`, …) e non di enum numerici: `JSON.stringify` non ha modo di produrre un ordinale. Conta perche' `"status": 3` non e' `Draft` ma `InvalidDraft` e `"dataType": 0` e' `String`, non "non specificato" — nessun errore lo segnalerebbe. Chi scrive un'altra implementazione di `FlowBuilderApi` non traduca i valori in numeri |
 
 Altre regole del contratto rispettate: liste vuote omesse invece di scritte come `[]` (§2),
 `filterLogic` mostrato **solo** dove il modello lo prevede (§4.4), `fullName` / `status` mai

package/fesm2022/esfaenza-flow-builder.mjs

@@ -410,6 +410,12 @@ class HttpFlowBuilderApi extends FlowBuilderApi {
         return this.del(`/flows/editor/${HttpFlowBuilderApi.segment(flowName)}`);
     }
     // ---------------------------------------------------------------- §6.3
+    /**
+     * Documento nudo alla radice: le primitive che **analizzano** il documento non usano
+     * l'involucro `{definition, flowName, …}` della §6.2, che serve solo a chi deve sapere dove
+     * riporlo (§6.4, §13.17). Sbagliare involucro qui non produce nessun errore: si otterrebbe la
+     * validazione di un flow vuoto, cioe' «manca lo Start».
+     */
     validateDefinition(definition) {
         return this.post(`/flows/editor/validate`, definition);
     }
@@ -421,11 +427,17 @@ class HttpFlowBuilderApi extends FlowBuilderApi {
         // `processType` filtra le globali: `$Record` non esiste in uno screen flow (§4.1).
         return this.get('/flows/editor/dictionaries', HttpFlowBuilderApi.params({ processType }));
     }
-    getReferences(query) {
-        return this.post('/flows/editor/references', query);
+    /**
+     * Il body e' il documento **nudo**, come per validate/parse/outline/connector-targets (§6.4,
+     * §13.17): avvolgerlo (`{definition: …}`) o aggiungergli campi di filtro non da' nessun errore
+     * — il backend deserializza un `Flow` in cui non riconosce nessuna proprieta', risponde `200` e
+     * l'elenco contiene le sole globali. Se le tendine sembrano vuote, si guarda qui prima di tutto.
+     */
+    getReferences(definition) {
+        return this.post('/flows/editor/references', definition);
     }
-    getWritableReferences(query) {
-        return this.post('/flows/editor/writable-references', query);
+    getWritableReferences(definition) {
+        return this.post('/flows/editor/writable-references', definition);
     }
     getConnectorTargets(definition, excluding) {
         return this.post('/flows/editor/connector-targets', definition, HttpFlowBuilderApi.params({ excluding }));
@@ -1601,6 +1613,45 @@ function navigatePath(catalog, request) {
     return { resolution: resolution.asReadonly(), isPending: isPending.asReadonly() };
 }
 
+/**
+ * Filtro di compatibilita' dei riferimenti — FRONTEND.md §6.4.
+ *
+ * `POST /flows/references` e `POST /flows/references/writable` prendono il **documento nudo** e
+ * restituiscono **tutti** i riferimenti, ognuno col proprio `dataType`, `isCollection` e
+ * `isWritable`: nel body non c'e' nessun campo di filtro. Chi sceglie cosa e' compatibile col
+ * campo che l'utente sta compilando e' quindi l'editor, ed e' deliberato — la stessa risposta
+ * serve tutte le tendine di una schermata, quindi si chiede una volta e si filtra n volte.
+ *
+ * Il filtro guarda **la radice**, non il percorso: una radice scartata si porta via anche cio'
+ * che sta sotto, e chi propone i segmenti navigati applica la stessa regola separatamente
+ * (`reference-picker`).
+ */
+/** `true` se il campo non pone nessun vincolo: lì filtrare e' inutile. */
+function isEmptyReferenceFilter(filter) {
+    return !filter || (!filter.dataType && filter.isCollection == null && !filter.objectType);
+}
+function matchesReferenceFilter(entry, filter) {
+    // Un riferimento di tipo ignoto non si scarta: sarebbe peggio nasconderlo.
+    if (filter.dataType && entry.dataType && entry.dataType !== filter.dataType) {
+        return false;
+    }
+    // `!= null`, non `!== undefined`: nei template il safe navigation di Angular produce **null**,
+    // e trattarlo come "voglio i valori singoli" svuoterebbe l'elenco.
+    if (filter.isCollection != null && entry.isCollection != null && !!entry.isCollection !== filter.isCollection) {
+        return false;
+    }
+    if (filter.objectType && entry.objectType && entry.objectType !== filter.objectType) {
+        return false;
+    }
+    return true;
+}
+function filterReferences(references, filter) {
+    if (isEmptyReferenceFilter(filter)) {
+        return [...references];
+    }
+    return references.filter((entry) => matchesReferenceFilter(entry, filter));
+}
+
 /**
  * Lo store del documento in lavorazione.
  *
@@ -3702,6 +3753,12 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.27", ngImpo
  * pur non essendo dichiarati in nessuna collection di risorse: la primitiva li restituisce
  * già, ed e' il motivo per cui non si ricostruisce l'elenco lato client.
  *
+ * La primitiva prende il **documento nudo** e restituisce **tutti** i riferimenti: il filtro di
+ * tipo del campo lo applica l'editor, con `core/reference-filter.util` (§6.4, §13.17). L'elenco
+ * completo resta comunque a portata di mano, e serve — il filtro guarda la **radice**, e una radice
+ * scartata si porta via cio' che sta sotto: in un parametro `String` una variabile `Structure` non
+ * e' compatibile, ma `Richiesta.Ragione` sì.
+ *
  * I **percorsi navigati** non sono piu' tutti uguali. Quando la radice e' una risorsa dichiarata
  * di cui si conosce la forma — una `Structure` con la sua classe, un record con la sua entita' — il
  * percorso si naviga **fino in fondo** (§4.4, §4.7.1): i segmenti si propongono un livello alla
@@ -3738,7 +3795,41 @@ class ReferencePickerComponent {
      */
     elementsOnly = input(false, ...(ngDevMode ? [{ debugName: "elementsOnly" }] : []));
     valueChange = output();
-    references = signal([], ...(ngDevMode ? [{ debugName: "references" }] : []));
+    /**
+     * L'elenco come arriva dalla primitiva, **senza** il filtro di tipo.
+     *
+     * Serve a due cose oltre che a produrre le proposte: riconoscere le radici dei percorsi e
+     * mostrare i contenitori come righe in cui si entra. Il filtro (§6.4) guarda il tipo della
+     * **radice**, e una radice scartata si porta via anche cio' che sta sotto: in un parametro
+     * `String` una variabile `Structure` non e' compatibile, ma `Richiesta.Ragione` lo e', e
+     * `Leggi_Ordine` non e' un `String` mentre `Leggi_Ordine.Numero` lo e'. Senza questo elenco il
+     * primo membro non si puo' proporre e il secondo viene accusato di non esistere pur essendo un
+     * riferimento valido (§4.5).
+     */
+    unfiltered = signal([], ...(ngDevMode ? [{ debugName: "unfiltered" }] : []));
+    /**
+     * L'insieme da cui si pesca prima del filtro di tipo: in un campo di destinazione e' la
+     * risposta di `getWritableReferences`, altrove {@link unfiltered} stesso.
+     */
+    available = signal([], ...(ngDevMode ? [{ debugName: "available" }] : []));
+    /**
+     * Le proposte compatibili col campo. Il filtro e' **locale**: la primitiva prende il documento
+     * nudo e restituisce tutto (§6.4, §13.17), cosi' la stessa risposta serve tutte le tendine di
+     * una schermata.
+     */
+    references = computed(() => filterReferences(this.available(), {
+        /**
+         * `?? undefined` non e' cosmetico: nei template il safe navigation di Angular
+         * (`describe(x)?.isCollection`) produce **null**, non `undefined`. Un `isCollection: null`
+         * letto come "filtra per valore singolo" svuoterebbe l'elenco: un campo senza filtro non
+         * deve porre nessun vincolo.
+         */
+        dataType: this.dataType() ?? undefined,
+        isCollection: this.isCollection() ?? undefined,
+        objectType: this.objectType() ?? undefined,
+    }), ...(ngDevMode ? [{ debugName: "references" }] : []));
+    /** Tutto cio' che puo' essere la radice di un percorso, filtrato o no. */
+    roots = computed(() => this.unfiltered(), ...(ngDevMode ? [{ debugName: "roots" }] : []));
     isLoading = signal(false, ...(ngDevMode ? [{ debugName: "isLoading" }] : []));
     loadError = signal(null, ...(ngDevMode ? [{ debugName: "loadError" }] : []));
     isOpen = signal(false, ...(ngDevMode ? [{ debugName: "isOpen" }] : []));
@@ -3749,45 +3840,90 @@ class ReferencePickerComponent {
         effect(() => {
             const definition = this.store.document();
             const writable = this.writableOnly();
-            const dataType = this.dataType();
-            const isCollection = this.isCollection();
-            const objectType = this.objectType();
             if (this.elementsOnly()) {
                 // I node li conosce già il documento: nessuna richiesta necessaria.
-                this.references.set(this.store.nodes().map((reference) => ({
+                const nodes = this.store.nodes().map((reference) => ({
                     name: reference.name,
                     label: reference.node.label ?? null,
                     kind: 'ElementOutput',
                     description: this.dictionaries.labelOf(reference.type),
                     isWritable: false,
-                })));
+                }));
+                this.unfiltered.set(nodes);
+                this.available.set(nodes);
                 return;
             }
-            /**
-             * `?? undefined` non e' cosmetico: nei template il safe navigation di Angular
-             * (`describe(x)?.isCollection`) produce **null**, non `undefined`. Un `isCollection: null`
-             * che arriva alla primitiva viene letto come "filtra per valore singolo" e svuota
-             * l'elenco: un campo senza filtro deve mandare il campo **assente**.
-             */
-            const query = {
-                definition,
-                dataType: dataType ?? undefined,
-                isCollection: isCollection ?? undefined,
-                objectType: objectType ?? undefined,
-            };
             this.isLoading.set(true);
             this.loadError.set(null);
-            const request = writable ? this.api.getWritableReferences(query) : this.api.getReferences(query);
-            void request
-                .then((list) => this.references.set(list ?? []))
+            /**
+             * Una sola richiesta dove non c'e' vincolo di scrittura: il body e' il documento nudo e la
+             * risposta e' completa, quindi l'elenco delle radici e quello da cui si pesca sono lo stesso
+             * (§6.4, §13.17). Il filtro di tipo lo applica {@link references}.
+             */
+            void this.api
+                .getReferences(definition)
+                .then((list) => {
+                this.unfiltered.set(list ?? []);
+                if (!writable) {
+                    this.available.set(list ?? []);
+                }
+            })
                 .catch((error) => {
                 // Senza l'elenco il campo resta scrivibile a mano: e' meglio di un campo bloccato.
                 this.loadError.set(error instanceof Error ? error.message : String(error));
-                this.references.set([]);
+                this.unfiltered.set([]);
+                if (!writable) {
+                    this.available.set([]);
+                }
+            })
+                .finally(() => {
+                if (!writable) {
+                    this.isLoading.set(false);
+                }
+            });
+            if (!writable) {
+                return;
+            }
+            /**
+             * In un campo di destinazione le proposte sono un elenco a parte, ma le **radici** restano
+             * quelle di `getReferences`: la scrivibilita' e' del **percorso**, non della radice, e le
+             * radici escluse sono quelle che servono per dire la cosa giusta — un `$User.Anagrafica.Citta`
+             * scritto a mano e' `TARGET_NOT_WRITABLE`, non un nome che non esiste.
+             */
+            void this.api
+                .getWritableReferences(definition)
+                .then((list) => this.available.set(list ?? []))
+                .catch((error) => {
+                this.loadError.set(error instanceof Error ? error.message : String(error));
+                this.available.set([]);
             })
                 .finally(() => this.isLoading.set(false));
         });
     }
+    /**
+     * Il riferimento dichiarato piu' **lungo** che sia un prefisso del valore, sui confini del punto.
+     *
+     * Non basta il primo segmento: un nome dichiarato puo' contenere il punto. Le globali sono il caso
+     * per cui la regola esiste — di `$User.Anagrafica.Citta` il dizionario dichiara `$User.Anagrafica`,
+     * e cercare la corrispondenza esatta di tutto cio' che segue lo scope segnalerebbe come rotto un
+     * percorso giusto (§4.1: vince il prefisso dichiarato piu' lungo).
+     */
+    declaredPrefix = computed(() => {
+        const value = (this.value() ?? '')?.trim();
+        if (!value) {
+            return undefined;
+        }
+        let best;
+        for (const candidate of this.roots()) {
+            if (value !== candidate.name && !value.startsWith(`${candidate.name}.`)) {
+                continue;
+            }
+            if (!best || candidate.name.length > best.name.length) {
+                best = candidate;
+            }
+        }
+        return best;
+    }, ...(ngDevMode ? [{ debugName: "declaredPrefix" }] : []));
     /**
      * La risorsa da cui il valore corrente sta navigando, quando la sua forma e' **dichiarata**: una
      * `Structure` con la classe, un record con l'entita'. È cio' che rende il percorso verificabile.
@@ -3797,11 +3933,9 @@ class ReferencePickerComponent {
      * l'editor non deve accusare cio' che il backend non verifica.
      */
     navigableRoot = computed(() => {
-        const root = referenceRoot((this.value() ?? '')?.trim());
-        if (!root) {
-            return undefined;
-        }
-        const reference = this.references().find((candidate) => candidate.name === root);
+        // Fra tutte le radici: quella di `Richiesta.Ragione` in un campo `String` sta solo nell'elenco
+        // non filtrato.
+        const reference = this.declaredPrefix();
         if (!reference || reference.kind === 'ElementOutput' || !reference.objectType || reference.isCollection) {
             return undefined;
         }
@@ -3830,6 +3964,16 @@ class ReferencePickerComponent {
      * segmento di sola lettura non si propone in un campo di destinazione, a meno che da lì il
      * percorso continui: `Richiesta.Cliente` non si assegna, ma `Richiesta.Cliente.Email` sì (§5.7).
      */
+    /**
+     * §5.2 — dentro una globale dell'host **niente** e' scrivibile, per quanto il membro si dichiari
+     * tale: le globali le risolve un componente che non ha modo di scriverle, e proporle come
+     * 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).
+     */
+    isReadOnlyPath = computed(() => {
+        const name = this.navigableRoot()?.reference.name;
+        return !!name && isGlobalReference(name) && referenceRoot(name) !== '$Record';
+    }, ...(ngDevMode ? [{ debugName: "isReadOnlyPath" }] : []));
     pathReferences = computed(() => {
         const root = this.navigableRoot();
         const tail = this.tail();
@@ -3839,7 +3983,9 @@ class ReferencePickerComponent {
         const prefix = tail.prefix ? `${root.reference.name}.${tail.prefix}` : root.reference.name;
         const kind = tail.level.container.kind === 'object' ? 'RecordField' : 'StructureMember';
         return tail.level.entries
+            .map((entry) => (this.isReadOnlyPath() ? { ...entry, isWritable: false } : entry))
             .filter((entry) => !this.writableOnly() || entry.isWritable || !!entry.next)
+            .filter((entry) => this.matchesTarget(entry))
             .map((entry) => ({
             name: `${prefix}.${entry.name}`,
             label: entry.label ?? null,
@@ -3851,12 +3997,47 @@ class ReferencePickerComponent {
             description: entry.isWritable ? (entry.description ?? null) : 'sola lettura',
         }));
     }, ...(ngDevMode ? [{ debugName: "pathReferences" }] : []));
+    /**
+     * Lo stesso filtro delle radici (§6.4), applicato ai segmenti di un percorso: in un parametro
+     * `String` non si propone un membro `Date`. Un segmento da cui si scende resta comunque proposto
+     * anche se il suo tipo non combacia — e' la strada per arrivare al membro che combacia.
+     */
+    matchesTarget(entry) {
+        if (entry.next) {
+            return true;
+        }
+        return matchesReferenceFilter(entry, {
+            dataType: this.dataType() ?? undefined,
+            isCollection: this.isCollection() ?? undefined,
+            objectType: this.objectType() ?? undefined,
+        });
+    }
+    /**
+     * I contenitori che il filtro di tipo ha scartato: si mostrano per **entrarci**, non per
+     * scegliersi. Quelli che il filtro ha tenuto stanno già fra le proposte normali.
+     */
+    containerOptions = computed(() => {
+        const proposed = new Set(this.references().map((reference) => reference.name));
+        return this.unfiltered().filter((candidate) => {
+            if (proposed.has(candidate.name) || !this.canDescend(candidate)) {
+                return false;
+            }
+            // In un campo di destinazione una globale dell'host non porta a niente di assegnabile (§5.2):
+            // proporre di entrarci sarebbe un vicolo cieco. Resta nelle radici, per il messaggio giusto.
+            return !(this.writableOnly() &&
+                isGlobalReference(candidate.name) &&
+                referenceRoot(candidate.name) !== '$Record');
+        });
+    }, ...(ngDevMode ? [{ debugName: "containerOptions" }] : []));
+    /** `true` → questa riga apre il percorso e non e' un valore valido per il campo. */
+    isContainerOnly(reference) {
+        return this.containerOptions().some((candidate) => candidate.name === reference.name);
+    }
     options = computed(() => {
         const needle = this.query()?.trim().toLowerCase();
-        // Le globali assegnabili — `$Flow.CurrentStage`, `$Flow.ActiveStages` e quelle che l'host
-        // dichiara scrivibili — le comprende già `POST /flows/references/writable`: aggiungerle
-        // qui le duplicherebbe (§5.2, §6.4).
-        const all = [...this.references(), ...this.pathReferences()];
+        // Le due globali assegnabili — `$Flow.CurrentStage` e `$Flow.ActiveStages` — le comprende già
+        // `POST /flows/references/writable`: aggiungerle qui le duplicherebbe (§5.2, §6.4).
+        const all = [...this.references(), ...this.containerOptions(), ...this.pathReferences()];
         if (!needle) {
             return all;
         }
@@ -3913,11 +4094,16 @@ class ReferencePickerComponent {
      *    elemento): il percorso resta fuori dalla validazione, quindi si accetta senza segnalare;
      *  - `host`: scope del sistema ospite che **non dichiara percorsi**: non verificabile (§4.1);
      *  - `member`: percorso dentro una forma dichiarata, verificato fino in fondo (§4.4, §4.7.1);
+     *  - `containerRoot`: il contenitore da solo in un campo che vuole un altro tipo: il valore e' un
+     *    suo membro, non lui;
      *  - `memberUnknown`: un segmento non esiste nella sua tappa: `STRUCTURE_MEMBER_UNKNOWN` su una
      *    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`;
      *  - `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);
+     *  - `globalPathInvalid`: si naviga un percorso globale scalare o una collection: `GLOBAL_UNKNOWN`;
      *  - `unknown`: nessuna corrispondenza: si avvisa, senza bloccare. Ci finisce anche il
      *    percorso inesistente di uno scope che i percorsi li dichiara, perche' lì il backend
      *    risponderebbe `GLOBAL_UNKNOWN`.
@@ -3937,6 +4123,11 @@ class ReferencePickerComponent {
         }
         // Dentro una forma dichiarata il percorso e' verificabile: dirlo "non verificato" sarebbe falso.
         if (this.navigableRoot()) {
+            // Il contenitore da solo: non e' fra le proposte (lo avrebbe intercettato `known`), quindi il
+            // filtro del campo lo ha scartato — e il valore giusto e' un suo membro, non lui.
+            if (!this.navigatedPath()) {
+                return 'containerRoot';
+            }
             const resolution = this.resolution();
             switch (resolution?.status) {
                 case 'unknown':
@@ -3944,13 +4135,30 @@ class ReferencePickerComponent {
                 case 'unverifiable':
                     return 'pathUnverified';
                 case 'resolved':
-                    return this.writableOnly() && !resolution.last?.isWritable ? 'memberNotWritable' : 'member';
+                    return this.writableOnly() && (this.isReadOnlyPath() || !resolution.last?.isWritable)
+                        ? 'memberNotWritable'
+                        : 'member';
                 default:
                     // Percorso ancora aperto (`Richiesta.`) o risposta non arrivata: non si accusa nessuno.
                     return 'empty';
             }
         }
-        if (all.some((reference) => reference.name === root)) {
+        /**
+         * §4.1 — un percorso globale dichiarato che non porta a un contenitore. I due esiti sono
+         * diversi e vanno detti diversi: senza `objectType` si sa che c'e' un contenitore ma non di che
+         * tipo (`PATH_NOT_VERIFIABLE`, avviso), mentre su uno scalare o una collection non c'e'
+         * proprio niente da navigare (`GLOBAL_UNKNOWN`, errore).
+         */
+        const prefix = this.declaredPrefix();
+        if (prefix && prefix.name !== value && isGlobalReference(prefix.name)) {
+            const isContainer = this.dictionaries.isStructure(prefix.dataType) || prefix.dataType === 'Object';
+            return isContainer && !prefix.objectType && !prefix.isCollection
+                ? 'globalPathUntyped'
+                : 'globalPathInvalid';
+        }
+        // Fra **tutte** le radici: `Leggi_Ordine` non e' un `String`, ma `Leggi_Ordine.Numero` sì, e
+        // accusarlo di non esistere sarebbe falso (§4.5).
+        if (this.roots().some((reference) => reference.name === root)) {
             return 'navigated';
         }
         // Se l'elenco non e' arrivato, non si accusa nessuno.
@@ -3976,6 +4184,10 @@ class ReferencePickerComponent {
                 const what = this.tailIsObject() ? 'Campo' : 'Membro';
                 return `${what} di ${this.tailContainer()}: il percorso e’ verificato fino in fondo.`;
             }
+            case 'containerRoot':
+                return this.tailIsObject()
+                    ? 'Questo e’ il record intero, e il campo vuole un altro tipo: scegli un suo campo.'
+                    : 'Questa e’ l’istanza di classe, e il campo vuole un altro tipo: scegli un suo membro.';
             case 'memberUnknown': {
                 if (!resolution) {
                     return null;
@@ -3988,19 +4200,29 @@ class ReferencePickerComponent {
                 return names ? `${head} Disponibili: ${names}.` : head;
             }
             case 'memberNotWritable':
+                // Il motivo cambia la correzione: dentro una globale non c'e' niente da rendere scrivibile.
+                if (this.isReadOnlyPath()) {
+                    return 'Le variabili globali sono di sola lettura, membri compresi: assegnarlo e’ TARGET_NOT_WRITABLE.';
+                }
                 return this.tailIsObject()
                     ? 'Questo campo non si scrive ne’ creando ne’ aggiornando un record: assegnarlo e’ TARGET_NOT_WRITABLE.'
                     : 'Questo membro e’ calcolato: si legge, ma assegnarlo e’ TARGET_NOT_WRITABLE.';
             case 'pathUnverified':
                 return resolution ? pathNotVerifiableMessage(resolution) : null;
+            case 'globalPathUntyped':
+                return `«${this.declaredPrefix()?.name}» porta un contenitore, ma il catalogo non ne dichiara il tipo: il percorso non e’ verificabile (PATH_NOT_VERIFIABLE).`;
+            case 'globalPathInvalid':
+                return `«${this.declaredPrefix()?.name}» e’ un valore, non un contenitore: dopo il punto non c’e’ niente da navigare (GLOBAL_UNKNOWN).`;
             case 'unknown':
                 return 'Questo nome non e’ fra i riferimenti disponibili: la validazione lo segnalerebbe.';
             default:
                 return null;
         }
     }, ...(ngDevMode ? [{ debugName: "hint" }] : []));
-    /** I due stati che sono errori e non avvisi: il colore deve dirlo. */
-    isHintError = computed(() => this.valueState() === 'memberUnknown' || this.valueState() === 'memberNotWritable', ...(ngDevMode ? [{ debugName: "isHintError" }] : []));
+    /** Gli stati che sono avvisi: «non lo so», o un valore da correggere che non blocca. */
+    isHintWarning = computed(() => ['unknown', 'containerRoot', 'globalPathUntyped'].includes(this.valueState()), ...(ngDevMode ? [{ debugName: "isHintWarning" }] : []));
+    /** Gli stati che sono errori e non avvisi: il colore deve dirlo. */
+    isHintError = computed(() => ['memberUnknown', 'memberNotWritable', 'globalPathInvalid'].includes(this.valueState()), ...(ngDevMode ? [{ debugName: "isHintError" }] : []));
     errorMessage = computed(() => this.loadError(), ...(ngDevMode ? [{ debugName: "errorMessage" }] : []));
     open() {
         if (this.disabled()) {
@@ -4019,6 +4241,11 @@ class ReferencePickerComponent {
         this.query.set(value);
     }
     choose(reference) {
+        // Un contenitore fuori tipo non e' un valore: cliccarlo vuol dire entrarci.
+        if (this.isContainerOnly(reference)) {
+            this.descend(reference);
+            return;
+        }
         this.valueChange.emit(reference.name);
         this.close();
     }
@@ -4056,14 +4283,18 @@ class ReferencePickerComponent {
         if (reference.description) {
             parts.push(reference.description);
         }
+        if (this.isContainerOnly(reference)) {
+            // Dirlo: la riga c'e' ma il valore non e' quello, e senza spiegazione sembra un errore.
+            parts.push(reference.dataType === 'Object' ? 'entra e scegli un campo' : 'entra e scegli un membro');
+        }
         return parts.join(' · ');
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.27", ngImport: i0, type: ReferencePickerComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "20.3.27", type: ReferencePickerComponent, isStandalone: true, selector: "fb-reference-picker", inputs: { value: { classPropertyName: "value", publicName: "value", isSignal: true, isRequired: false, transformFunction: null }, label: { classPropertyName: "label", publicName: "label", isSignal: true, isRequired: false, transformFunction: null }, placeholder: { classPropertyName: "placeholder", publicName: "placeholder", isSignal: true, isRequired: false, transformFunction: null }, disabled: { classPropertyName: "disabled", publicName: "disabled", isSignal: true, isRequired: false, transformFunction: null }, dataType: { classPropertyName: "dataType", publicName: "dataType", isSignal: true, isRequired: false, transformFunction: null }, isCollection: { classPropertyName: "isCollection", publicName: "isCollection", isSignal: true, isRequired: false, transformFunction: null }, objectType: { classPropertyName: "objectType", publicName: "objectType", isSignal: true, isRequired: false, transformFunction: null }, writableOnly: { classPropertyName: "writableOnly", publicName: "writableOnly", isSignal: true, isRequired: false, transformFunction: null }, elementsOnly: { classPropertyName: "elementsOnly", publicName: "elementsOnly", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { valueChange: "valueChange" }, ngImport: i0, template: "<div class=\"fb-ref\" [class.fb-ref--open]=\"isOpen()\">\r\n  <div class=\"fb-ref__control\">\r\n    <input\r\n      class=\"fb-ref__input\"\r\n      type=\"text\"\r\n      [value]=\"value() || ''\"\r\n      [placeholder]=\"placeholder()\"\r\n      [disabled]=\"disabled()\"\r\n      [attr.aria-label]=\"label()\"\r\n      (input)=\"onManualInput($any($event.target).value)\"\r\n      (focus)=\"open()\"\r\n    />\r\n    <button\r\n      type=\"button\"\r\n      class=\"fb-ref__toggle\"\r\n      [disabled]=\"disabled()\"\r\n      [attr.aria-expanded]=\"isOpen()\"\r\n      aria-label=\"Mostra i riferimenti disponibili\"\r\n      (click)=\"toggle()\"\r\n    >\r\n      \u25BE\r\n    </button>\r\n    @if (value()) {\r\n      <button type=\"button\" class=\"fb-ref__clear\" aria-label=\"Svuota\" (click)=\"clear()\">\u00D7</button>\r\n    }\r\n  </div>\r\n\r\n  @if (hint()) {\r\n    <!-- Un membro inesistente o non scrivibile e' un **errore**: mostrarlo come avviso direbbe il falso. -->\r\n    <p\r\n      class=\"fb-ref__hint\"\r\n      [class.fb-ref__hint--warn]=\"valueState() === 'unknown'\"\r\n      [class.fb-ref__hint--error]=\"isHintError()\"\r\n    >\r\n      {{ hint() }}\r\n    </p>\r\n  }\r\n  @if (errorMessage()) {\r\n    <p class=\"fb-ref__hint fb-ref__hint--warn\">\r\n      Elenco dei riferimenti non disponibile: puoi scrivere il nome a mano.\r\n    </p>\r\n  }\r\n\r\n  @if (isOpen()) {\r\n    <div class=\"fb-ref__panel\" role=\"listbox\">\r\n      <input\r\n        class=\"fb-ref__search\"\r\n        type=\"search\"\r\n        placeholder=\"Filtra\"\r\n        aria-label=\"Filtra i riferimenti\"\r\n        (input)=\"onQuery($any($event.target).value)\"\r\n      />\r\n      @if (groups().length === 0) {\r\n        <p class=\"fb-ref__empty\">Nessun riferimento compatibile.</p>\r\n      }\r\n      @for (group of groups(); track group.kind) {\r\n        <div class=\"fb-ref__group\">\r\n          <span class=\"fb-ref__group-label\">{{ group.label }}</span>\r\n          @for (item of group.items; track item.name) {\r\n            <!-- Due bottoni dove il percorso continua: scegliere il riferimento e scendere di un\r\n                 livello sono cose diverse, e su una Structure o un record servono entrambe. -->\r\n            <div class=\"fb-ref__row\">\r\n              <button\r\n                type=\"button\"\r\n                class=\"fb-ref__option\"\r\n                role=\"option\"\r\n                [attr.aria-selected]=\"item.name === value()\"\r\n                (click)=\"choose(item)\"\r\n              >\r\n                <span class=\"fb-ref__name\">{{ item.name }}</span>\r\n                <span class=\"fb-ref__meta\">{{ describe(item) }}</span>\r\n              </button>\r\n              @if (canDescend(item)) {\r\n                <button\r\n                  type=\"button\"\r\n                  class=\"fb-ref__into\"\r\n                  [attr.aria-label]=\"'Entra in ' + item.name\"\r\n                  title=\"Entra e proponi i segmenti\"\r\n                  (click)=\"descend(item)\"\r\n                >\r\n                  \u203A\r\n                </button>\r\n              }\r\n            </div>\r\n          }\r\n        </div>\r\n      }\r\n      <button type=\"button\" class=\"fb-ref__close\" (click)=\"close()\">Chiudi</button>\r\n    </div>\r\n  }\r\n</div>\r\n", styles: [":host{display:block}.fb-ref{position:relative}.fb-ref__control{display:flex;align-items:stretch;gap:0;border:1px solid var(--fb-border, #d6dae1);border-radius:6px;background:var(--fb-surface, #fff);overflow:hidden}.fb-ref--open .fb-ref__control{border-color:var(--fb-accent, #2f6feb)}.fb-ref__input{flex:1;min-width:0;padding:5px 7px;border:0;background:transparent;color:var(--fb-text, #1d2939);font:inherit;font-size:12px;font-family:ui-monospace,SFMono-Regular,Menlo,monospace}.fb-ref__input:focus-visible{outline:none}.fb-ref__toggle,.fb-ref__clear{flex:0 0 auto;padding:0 7px;border:0;border-left:1px solid var(--fb-border-subtle, #e6e9ee);background:transparent;color:var(--fb-text-muted, #667085);font:inherit;font-size:12px;cursor:pointer}.fb-ref__toggle:hover,.fb-ref__clear:hover{background:var(--fb-surface-alt, #f8f9fb)}.fb-ref__hint{margin:3px 0 0;font-size:10px;line-height:1.35;color:var(--fb-text-subtle, #98a2b3)}.fb-ref__hint--warn{color:var(--fb-warning, #b7791f)}.fb-ref__hint--error{color:var(--fb-error, #c9372c)}.fb-ref__panel{position:absolute;z-index:30;top:calc(100% + 3px);left:0;right:0;max-height:260px;overflow-y:auto;padding:6px;border:1px solid var(--fb-border, #d6dae1);border-radius:6px;background:var(--fb-surface, #fff);box-shadow:0 6px 18px #10182829}.fb-ref__search{box-sizing:border-box;width:100%;margin-bottom:6px;padding:4px 6px;border:1px solid var(--fb-border, #d6dae1);border-radius:5px;font:inherit;font-size:12px}.fb-ref__group{margin-bottom:6px}.fb-ref__group-label{display:block;padding:2px 4px;font-size:9px;font-weight:700;letter-spacing:.05em;text-transform:uppercase;color:var(--fb-text-subtle, #98a2b3)}.fb-ref__row{display:flex;align-items:stretch;gap:2px}.fb-ref__into{flex:0 0 auto;padding:0 7px;border:0;border-radius:4px;background:transparent;color:var(--fb-text-muted, #667085);font:inherit;font-size:13px;cursor:pointer}.fb-ref__into:hover{background:var(--fb-surface-alt, #f8f9fb);color:var(--fb-accent, #2f6feb)}.fb-ref__option{display:flex;flex:1;flex-direction:column;min-width:0;width:100%;padding:4px 6px;border:0;border-radius:4px;background:transparent;color:var(--fb-text, #1d2939);font:inherit;text-align:left;cursor:pointer}.fb-ref__option:hover,.fb-ref__option[aria-selected=true]{background:var(--fb-surface-alt, #f8f9fb)}.fb-ref__name{font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:12px}.fb-ref__meta{font-size:10px;color:var(--fb-text-muted, #667085)}.fb-ref__empty{margin:4px;font-size:11px;color:var(--fb-text-muted, #667085)}.fb-ref__close{width:100%;margin-top:4px;padding:4px;border:0;border-top:1px solid var(--fb-border-subtle, #e6e9ee);background:transparent;color:var(--fb-text-muted, #667085);font:inherit;font-size:11px;cursor:pointer}\n"], changeDetection: i0.ChangeDetectionStrategy.OnPush });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "20.3.27", type: ReferencePickerComponent, isStandalone: true, selector: "fb-reference-picker", inputs: { value: { classPropertyName: "value", publicName: "value", isSignal: true, isRequired: false, transformFunction: null }, label: { classPropertyName: "label", publicName: "label", isSignal: true, isRequired: false, transformFunction: null }, placeholder: { classPropertyName: "placeholder", publicName: "placeholder", isSignal: true, isRequired: false, transformFunction: null }, disabled: { classPropertyName: "disabled", publicName: "disabled", isSignal: true, isRequired: false, transformFunction: null }, dataType: { classPropertyName: "dataType", publicName: "dataType", isSignal: true, isRequired: false, transformFunction: null }, isCollection: { classPropertyName: "isCollection", publicName: "isCollection", isSignal: true, isRequired: false, transformFunction: null }, objectType: { classPropertyName: "objectType", publicName: "objectType", isSignal: true, isRequired: false, transformFunction: null }, writableOnly: { classPropertyName: "writableOnly", publicName: "writableOnly", isSignal: true, isRequired: false, transformFunction: null }, elementsOnly: { classPropertyName: "elementsOnly", publicName: "elementsOnly", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { valueChange: "valueChange" }, ngImport: i0, template: "<div class=\"fb-ref\" [class.fb-ref--open]=\"isOpen()\">\r\n  <div class=\"fb-ref__control\">\r\n    <input\r\n      class=\"fb-ref__input\"\r\n      type=\"text\"\r\n      [value]=\"value() || ''\"\r\n      [placeholder]=\"placeholder()\"\r\n      [disabled]=\"disabled()\"\r\n      [attr.aria-label]=\"label()\"\r\n      (input)=\"onManualInput($any($event.target).value)\"\r\n      (focus)=\"open()\"\r\n    />\r\n    <button\r\n      type=\"button\"\r\n      class=\"fb-ref__toggle\"\r\n      [disabled]=\"disabled()\"\r\n      [attr.aria-expanded]=\"isOpen()\"\r\n      aria-label=\"Mostra i riferimenti disponibili\"\r\n      (click)=\"toggle()\"\r\n    >\r\n      \u25BE\r\n    </button>\r\n    @if (value()) {\r\n      <button type=\"button\" class=\"fb-ref__clear\" aria-label=\"Svuota\" (click)=\"clear()\">\u00D7</button>\r\n    }\r\n  </div>\r\n\r\n  @if (hint()) {\r\n    <!-- Un membro inesistente o non scrivibile e' un **errore**: mostrarlo come avviso direbbe il falso. -->\r\n    <p\r\n      class=\"fb-ref__hint\"\r\n      [class.fb-ref__hint--warn]=\"isHintWarning()\"\r\n      [class.fb-ref__hint--error]=\"isHintError()\"\r\n    >\r\n      {{ hint() }}\r\n    </p>\r\n  }\r\n  @if (errorMessage()) {\r\n    <p class=\"fb-ref__hint fb-ref__hint--warn\">\r\n      Elenco dei riferimenti non disponibile: puoi scrivere il nome a mano.\r\n    </p>\r\n  }\r\n\r\n  @if (isOpen()) {\r\n    <div class=\"fb-ref__panel\" role=\"listbox\">\r\n      <input\r\n        class=\"fb-ref__search\"\r\n        type=\"search\"\r\n        placeholder=\"Filtra\"\r\n        aria-label=\"Filtra i riferimenti\"\r\n        (input)=\"onQuery($any($event.target).value)\"\r\n      />\r\n      @if (groups().length === 0) {\r\n        <p class=\"fb-ref__empty\">Nessun riferimento compatibile.</p>\r\n      }\r\n      @for (group of groups(); track group.kind) {\r\n        <div class=\"fb-ref__group\">\r\n          <span class=\"fb-ref__group-label\">{{ group.label }}</span>\r\n          @for (item of group.items; track item.name) {\r\n            <!-- Due bottoni dove il percorso continua: scegliere il riferimento e scendere di un\r\n                 livello sono cose diverse, e su una Structure o un record servono entrambe. -->\r\n            <div class=\"fb-ref__row\">\r\n              <button\r\n                type=\"button\"\r\n                class=\"fb-ref__option\"\r\n                role=\"option\"\r\n                [attr.aria-selected]=\"item.name === value()\"\r\n                [title]=\"isContainerOnly(item) ? 'Il tipo non e\u2019 quello del campo: entra e scegli dentro' : ''\"\r\n                (click)=\"choose(item)\"\r\n              >\r\n                <span class=\"fb-ref__name\">{{ item.name }}</span>\r\n                <span class=\"fb-ref__meta\">{{ describe(item) }}</span>\r\n              </button>\r\n              @if (canDescend(item)) {\r\n                <button\r\n                  type=\"button\"\r\n                  class=\"fb-ref__into\"\r\n                  [attr.aria-label]=\"'Entra in ' + item.name\"\r\n                  title=\"Entra e proponi i segmenti\"\r\n                  (click)=\"descend(item)\"\r\n                >\r\n                  \u203A\r\n                </button>\r\n              }\r\n            </div>\r\n          }\r\n        </div>\r\n      }\r\n      <button type=\"button\" class=\"fb-ref__close\" (click)=\"close()\">Chiudi</button>\r\n    </div>\r\n  }\r\n</div>\r\n", styles: [":host{display:block}.fb-ref{position:relative}.fb-ref__control{display:flex;align-items:stretch;gap:0;border:1px solid var(--fb-border, #d6dae1);border-radius:6px;background:var(--fb-surface, #fff);overflow:hidden}.fb-ref--open .fb-ref__control{border-color:var(--fb-accent, #2f6feb)}.fb-ref__input{flex:1;min-width:0;padding:5px 7px;border:0;background:transparent;color:var(--fb-text, #1d2939);font:inherit;font-size:12px;font-family:ui-monospace,SFMono-Regular,Menlo,monospace}.fb-ref__input:focus-visible{outline:none}.fb-ref__toggle,.fb-ref__clear{flex:0 0 auto;padding:0 7px;border:0;border-left:1px solid var(--fb-border-subtle, #e6e9ee);background:transparent;color:var(--fb-text-muted, #667085);font:inherit;font-size:12px;cursor:pointer}.fb-ref__toggle:hover,.fb-ref__clear:hover{background:var(--fb-surface-alt, #f8f9fb)}.fb-ref__hint{margin:3px 0 0;font-size:10px;line-height:1.35;color:var(--fb-text-subtle, #98a2b3)}.fb-ref__hint--warn{color:var(--fb-warning, #b7791f)}.fb-ref__hint--error{color:var(--fb-error, #c9372c)}.fb-ref__panel{position:absolute;z-index:30;top:calc(100% + 3px);left:0;right:0;max-height:260px;overflow-y:auto;padding:6px;border:1px solid var(--fb-border, #d6dae1);border-radius:6px;background:var(--fb-surface, #fff);box-shadow:0 6px 18px #10182829}.fb-ref__search{box-sizing:border-box;width:100%;margin-bottom:6px;padding:4px 6px;border:1px solid var(--fb-border, #d6dae1);border-radius:5px;font:inherit;font-size:12px}.fb-ref__group{margin-bottom:6px}.fb-ref__group-label{display:block;padding:2px 4px;font-size:9px;font-weight:700;letter-spacing:.05em;text-transform:uppercase;color:var(--fb-text-subtle, #98a2b3)}.fb-ref__row{display:flex;align-items:stretch;gap:2px}.fb-ref__into{flex:0 0 auto;padding:0 7px;border:0;border-radius:4px;background:transparent;color:var(--fb-text-muted, #667085);font:inherit;font-size:13px;cursor:pointer}.fb-ref__into:hover{background:var(--fb-surface-alt, #f8f9fb);color:var(--fb-accent, #2f6feb)}.fb-ref__option{display:flex;flex:1;flex-direction:column;min-width:0;width:100%;padding:4px 6px;border:0;border-radius:4px;background:transparent;color:var(--fb-text, #1d2939);font:inherit;text-align:left;cursor:pointer}.fb-ref__option:hover,.fb-ref__option[aria-selected=true]{background:var(--fb-surface-alt, #f8f9fb)}.fb-ref__name{font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:12px}.fb-ref__meta{font-size:10px;color:var(--fb-text-muted, #667085)}.fb-ref__empty{margin:4px;font-size:11px;color:var(--fb-text-muted, #667085)}.fb-ref__close{width:100%;margin-top:4px;padding:4px;border:0;border-top:1px solid var(--fb-border-subtle, #e6e9ee);background:transparent;color:var(--fb-text-muted, #667085);font:inherit;font-size:11px;cursor:pointer}\n"], changeDetection: i0.ChangeDetectionStrategy.OnPush });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.27", ngImport: i0, type: ReferencePickerComponent, decorators: [{
             type: Component,
-            args: [{ selector: 'fb-reference-picker', standalone: true, changeDetection: ChangeDetectionStrategy.OnPush, template: "<div class=\"fb-ref\" [class.fb-ref--open]=\"isOpen()\">\r\n  <div class=\"fb-ref__control\">\r\n    <input\r\n      class=\"fb-ref__input\"\r\n      type=\"text\"\r\n      [value]=\"value() || ''\"\r\n      [placeholder]=\"placeholder()\"\r\n      [disabled]=\"disabled()\"\r\n      [attr.aria-label]=\"label()\"\r\n      (input)=\"onManualInput($any($event.target).value)\"\r\n      (focus)=\"open()\"\r\n    />\r\n    <button\r\n      type=\"button\"\r\n      class=\"fb-ref__toggle\"\r\n      [disabled]=\"disabled()\"\r\n      [attr.aria-expanded]=\"isOpen()\"\r\n      aria-label=\"Mostra i riferimenti disponibili\"\r\n      (click)=\"toggle()\"\r\n    >\r\n      \u25BE\r\n    </button>\r\n    @if (value()) {\r\n      <button type=\"button\" class=\"fb-ref__clear\" aria-label=\"Svuota\" (click)=\"clear()\">\u00D7</button>\r\n    }\r\n  </div>\r\n\r\n  @if (hint()) {\r\n    <!-- Un membro inesistente o non scrivibile e' un **errore**: mostrarlo come avviso direbbe il falso. -->\r\n    <p\r\n      class=\"fb-ref__hint\"\r\n      [class.fb-ref__hint--warn]=\"valueState() === 'unknown'\"\r\n      [class.fb-ref__hint--error]=\"isHintError()\"\r\n    >\r\n      {{ hint() }}\r\n    </p>\r\n  }\r\n  @if (errorMessage()) {\r\n    <p class=\"fb-ref__hint fb-ref__hint--warn\">\r\n      Elenco dei riferimenti non disponibile: puoi scrivere il nome a mano.\r\n    </p>\r\n  }\r\n\r\n  @if (isOpen()) {\r\n    <div class=\"fb-ref__panel\" role=\"listbox\">\r\n      <input\r\n        class=\"fb-ref__search\"\r\n        type=\"search\"\r\n        placeholder=\"Filtra\"\r\n        aria-label=\"Filtra i riferimenti\"\r\n        (input)=\"onQuery($any($event.target).value)\"\r\n      />\r\n      @if (groups().length === 0) {\r\n        <p class=\"fb-ref__empty\">Nessun riferimento compatibile.</p>\r\n      }\r\n      @for (group of groups(); track group.kind) {\r\n        <div class=\"fb-ref__group\">\r\n          <span class=\"fb-ref__group-label\">{{ group.label }}</span>\r\n          @for (item of group.items; track item.name) {\r\n            <!-- Due bottoni dove il percorso continua: scegliere il riferimento e scendere di un\r\n                 livello sono cose diverse, e su una Structure o un record servono entrambe. -->\r\n            <div class=\"fb-ref__row\">\r\n              <button\r\n                type=\"button\"\r\n                class=\"fb-ref__option\"\r\n                role=\"option\"\r\n                [attr.aria-selected]=\"item.name === value()\"\r\n                (click)=\"choose(item)\"\r\n              >\r\n                <span class=\"fb-ref__name\">{{ item.name }}</span>\r\n                <span class=\"fb-ref__meta\">{{ describe(item) }}</span>\r\n              </button>\r\n              @if (canDescend(item)) {\r\n                <button\r\n                  type=\"button\"\r\n                  class=\"fb-ref__into\"\r\n                  [attr.aria-label]=\"'Entra in ' + item.name\"\r\n                  title=\"Entra e proponi i segmenti\"\r\n                  (click)=\"descend(item)\"\r\n                >\r\n                  \u203A\r\n                </button>\r\n              }\r\n            </div>\r\n          }\r\n        </div>\r\n      }\r\n      <button type=\"button\" class=\"fb-ref__close\" (click)=\"close()\">Chiudi</button>\r\n    </div>\r\n  }\r\n</div>\r\n", styles: [":host{display:block}.fb-ref{position:relative}.fb-ref__control{display:flex;align-items:stretch;gap:0;border:1px solid var(--fb-border, #d6dae1);border-radius:6px;background:var(--fb-surface, #fff);overflow:hidden}.fb-ref--open .fb-ref__control{border-color:var(--fb-accent, #2f6feb)}.fb-ref__input{flex:1;min-width:0;padding:5px 7px;border:0;background:transparent;color:var(--fb-text, #1d2939);font:inherit;font-size:12px;font-family:ui-monospace,SFMono-Regular,Menlo,monospace}.fb-ref__input:focus-visible{outline:none}.fb-ref__toggle,.fb-ref__clear{flex:0 0 auto;padding:0 7px;border:0;border-left:1px solid var(--fb-border-subtle, #e6e9ee);background:transparent;color:var(--fb-text-muted, #667085);font:inherit;font-size:12px;cursor:pointer}.fb-ref__toggle:hover,.fb-ref__clear:hover{background:var(--fb-surface-alt, #f8f9fb)}.fb-ref__hint{margin:3px 0 0;font-size:10px;line-height:1.35;color:var(--fb-text-subtle, #98a2b3)}.fb-ref__hint--warn{color:var(--fb-warning, #b7791f)}.fb-ref__hint--error{color:var(--fb-error, #c9372c)}.fb-ref__panel{position:absolute;z-index:30;top:calc(100% + 3px);left:0;right:0;max-height:260px;overflow-y:auto;padding:6px;border:1px solid var(--fb-border, #d6dae1);border-radius:6px;background:var(--fb-surface, #fff);box-shadow:0 6px 18px #10182829}.fb-ref__search{box-sizing:border-box;width:100%;margin-bottom:6px;padding:4px 6px;border:1px solid var(--fb-border, #d6dae1);border-radius:5px;font:inherit;font-size:12px}.fb-ref__group{margin-bottom:6px}.fb-ref__group-label{display:block;padding:2px 4px;font-size:9px;font-weight:700;letter-spacing:.05em;text-transform:uppercase;color:var(--fb-text-subtle, #98a2b3)}.fb-ref__row{display:flex;align-items:stretch;gap:2px}.fb-ref__into{flex:0 0 auto;padding:0 7px;border:0;border-radius:4px;background:transparent;color:var(--fb-text-muted, #667085);font:inherit;font-size:13px;cursor:pointer}.fb-ref__into:hover{background:var(--fb-surface-alt, #f8f9fb);color:var(--fb-accent, #2f6feb)}.fb-ref__option{display:flex;flex:1;flex-direction:column;min-width:0;width:100%;padding:4px 6px;border:0;border-radius:4px;background:transparent;color:var(--fb-text, #1d2939);font:inherit;text-align:left;cursor:pointer}.fb-ref__option:hover,.fb-ref__option[aria-selected=true]{background:var(--fb-surface-alt, #f8f9fb)}.fb-ref__name{font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:12px}.fb-ref__meta{font-size:10px;color:var(--fb-text-muted, #667085)}.fb-ref__empty{margin:4px;font-size:11px;color:var(--fb-text-muted, #667085)}.fb-ref__close{width:100%;margin-top:4px;padding:4px;border:0;border-top:1px solid var(--fb-border-subtle, #e6e9ee);background:transparent;color:var(--fb-text-muted, #667085);font:inherit;font-size:11px;cursor:pointer}\n"] }]
+            args: [{ selector: 'fb-reference-picker', standalone: true, changeDetection: ChangeDetectionStrategy.OnPush, template: "<div class=\"fb-ref\" [class.fb-ref--open]=\"isOpen()\">\r\n  <div class=\"fb-ref__control\">\r\n    <input\r\n      class=\"fb-ref__input\"\r\n      type=\"text\"\r\n      [value]=\"value() || ''\"\r\n      [placeholder]=\"placeholder()\"\r\n      [disabled]=\"disabled()\"\r\n      [attr.aria-label]=\"label()\"\r\n      (input)=\"onManualInput($any($event.target).value)\"\r\n      (focus)=\"open()\"\r\n    />\r\n    <button\r\n      type=\"button\"\r\n      class=\"fb-ref__toggle\"\r\n      [disabled]=\"disabled()\"\r\n      [attr.aria-expanded]=\"isOpen()\"\r\n      aria-label=\"Mostra i riferimenti disponibili\"\r\n      (click)=\"toggle()\"\r\n    >\r\n      \u25BE\r\n    </button>\r\n    @if (value()) {\r\n      <button type=\"button\" class=\"fb-ref__clear\" aria-label=\"Svuota\" (click)=\"clear()\">\u00D7</button>\r\n    }\r\n  </div>\r\n\r\n  @if (hint()) {\r\n    <!-- Un membro inesistente o non scrivibile e' un **errore**: mostrarlo come avviso direbbe il falso. -->\r\n    <p\r\n      class=\"fb-ref__hint\"\r\n      [class.fb-ref__hint--warn]=\"isHintWarning()\"\r\n      [class.fb-ref__hint--error]=\"isHintError()\"\r\n    >\r\n      {{ hint() }}\r\n    </p>\r\n  }\r\n  @if (errorMessage()) {\r\n    <p class=\"fb-ref__hint fb-ref__hint--warn\">\r\n      Elenco dei riferimenti non disponibile: puoi scrivere il nome a mano.\r\n    </p>\r\n  }\r\n\r\n  @if (isOpen()) {\r\n    <div class=\"fb-ref__panel\" role=\"listbox\">\r\n      <input\r\n        class=\"fb-ref__search\"\r\n        type=\"search\"\r\n        placeholder=\"Filtra\"\r\n        aria-label=\"Filtra i riferimenti\"\r\n        (input)=\"onQuery($any($event.target).value)\"\r\n      />\r\n      @if (groups().length === 0) {\r\n        <p class=\"fb-ref__empty\">Nessun riferimento compatibile.</p>\r\n      }\r\n      @for (group of groups(); track group.kind) {\r\n        <div class=\"fb-ref__group\">\r\n          <span class=\"fb-ref__group-label\">{{ group.label }}</span>\r\n          @for (item of group.items; track item.name) {\r\n            <!-- Due bottoni dove il percorso continua: scegliere il riferimento e scendere di un\r\n                 livello sono cose diverse, e su una Structure o un record servono entrambe. -->\r\n            <div class=\"fb-ref__row\">\r\n              <button\r\n                type=\"button\"\r\n                class=\"fb-ref__option\"\r\n                role=\"option\"\r\n                [attr.aria-selected]=\"item.name === value()\"\r\n                [title]=\"isContainerOnly(item) ? 'Il tipo non e\u2019 quello del campo: entra e scegli dentro' : ''\"\r\n                (click)=\"choose(item)\"\r\n              >\r\n                <span class=\"fb-ref__name\">{{ item.name }}</span>\r\n                <span class=\"fb-ref__meta\">{{ describe(item) }}</span>\r\n              </button>\r\n              @if (canDescend(item)) {\r\n                <button\r\n                  type=\"button\"\r\n                  class=\"fb-ref__into\"\r\n                  [attr.aria-label]=\"'Entra in ' + item.name\"\r\n                  title=\"Entra e proponi i segmenti\"\r\n                  (click)=\"descend(item)\"\r\n                >\r\n                  \u203A\r\n                </button>\r\n              }\r\n            </div>\r\n          }\r\n        </div>\r\n      }\r\n      <button type=\"button\" class=\"fb-ref__close\" (click)=\"close()\">Chiudi</button>\r\n    </div>\r\n  }\r\n</div>\r\n", styles: [":host{display:block}.fb-ref{position:relative}.fb-ref__control{display:flex;align-items:stretch;gap:0;border:1px solid var(--fb-border, #d6dae1);border-radius:6px;background:var(--fb-surface, #fff);overflow:hidden}.fb-ref--open .fb-ref__control{border-color:var(--fb-accent, #2f6feb)}.fb-ref__input{flex:1;min-width:0;padding:5px 7px;border:0;background:transparent;color:var(--fb-text, #1d2939);font:inherit;font-size:12px;font-family:ui-monospace,SFMono-Regular,Menlo,monospace}.fb-ref__input:focus-visible{outline:none}.fb-ref__toggle,.fb-ref__clear{flex:0 0 auto;padding:0 7px;border:0;border-left:1px solid var(--fb-border-subtle, #e6e9ee);background:transparent;color:var(--fb-text-muted, #667085);font:inherit;font-size:12px;cursor:pointer}.fb-ref__toggle:hover,.fb-ref__clear:hover{background:var(--fb-surface-alt, #f8f9fb)}.fb-ref__hint{margin:3px 0 0;font-size:10px;line-height:1.35;color:var(--fb-text-subtle, #98a2b3)}.fb-ref__hint--warn{color:var(--fb-warning, #b7791f)}.fb-ref__hint--error{color:var(--fb-error, #c9372c)}.fb-ref__panel{position:absolute;z-index:30;top:calc(100% + 3px);left:0;right:0;max-height:260px;overflow-y:auto;padding:6px;border:1px solid var(--fb-border, #d6dae1);border-radius:6px;background:var(--fb-surface, #fff);box-shadow:0 6px 18px #10182829}.fb-ref__search{box-sizing:border-box;width:100%;margin-bottom:6px;padding:4px 6px;border:1px solid var(--fb-border, #d6dae1);border-radius:5px;font:inherit;font-size:12px}.fb-ref__group{margin-bottom:6px}.fb-ref__group-label{display:block;padding:2px 4px;font-size:9px;font-weight:700;letter-spacing:.05em;text-transform:uppercase;color:var(--fb-text-subtle, #98a2b3)}.fb-ref__row{display:flex;align-items:stretch;gap:2px}.fb-ref__into{flex:0 0 auto;padding:0 7px;border:0;border-radius:4px;background:transparent;color:var(--fb-text-muted, #667085);font:inherit;font-size:13px;cursor:pointer}.fb-ref__into:hover{background:var(--fb-surface-alt, #f8f9fb);color:var(--fb-accent, #2f6feb)}.fb-ref__option{display:flex;flex:1;flex-direction:column;min-width:0;width:100%;padding:4px 6px;border:0;border-radius:4px;background:transparent;color:var(--fb-text, #1d2939);font:inherit;text-align:left;cursor:pointer}.fb-ref__option:hover,.fb-ref__option[aria-selected=true]{background:var(--fb-surface-alt, #f8f9fb)}.fb-ref__name{font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:12px}.fb-ref__meta{font-size:10px;color:var(--fb-text-muted, #667085)}.fb-ref__empty{margin:4px;font-size:11px;color:var(--fb-text-muted, #667085)}.fb-ref__close{width:100%;margin-top:4px;padding:4px;border:0;border-top:1px solid var(--fb-border-subtle, #e6e9ee);background:transparent;color:var(--fb-text-muted, #667085);font:inherit;font-size:11px;cursor:pointer}\n"] }]
         }], ctorParameters: () => [], propDecorators: { value: [{ type: i0.Input, args: [{ isSignal: true, alias: "value", required: false }] }], label: [{ type: i0.Input, args: [{ isSignal: true, alias: "label", required: false }] }], placeholder: [{ type: i0.Input, args: [{ isSignal: true, alias: "placeholder", required: false }] }], disabled: [{ type: i0.Input, args: [{ isSignal: true, alias: "disabled", required: false }] }], dataType: [{ type: i0.Input, args: [{ isSignal: true, alias: "dataType", required: false }] }], isCollection: [{ type: i0.Input, args: [{ isSignal: true, alias: "isCollection", required: false }] }], objectType: [{ type: i0.Input, args: [{ isSignal: true, alias: "objectType", required: false }] }], writableOnly: [{ type: i0.Input, args: [{ isSignal: true, alias: "writableOnly", required: false }] }], elementsOnly: [{ type: i0.Input, args: [{ isSignal: true, alias: "elementsOnly", required: false }] }], valueChange: [{ type: i0.Output, args: ["valueChange"] }] } });
 
 /**
@@ -5140,7 +5371,7 @@ class ConditionEditorComponent {
                 return;
             }
             void this.api
-                .getReferences({ definition })
+                .getReferences(definition)
                 .then((list) => this.references.set(list ?? []))
                 // Senza l'elenco non si segnala nulla: non sapere non e' sapere che e' sbagliato.
                 .catch(() => this.references.set([]));
@@ -6118,9 +6349,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.27", ngImpo
  *  1. **Le operazioni sono eseguite nell'ordine dichiarato**, quindi devono essere
  *     riordinabili: un'interfaccia che le presenta come un insieme nasconde la semantica.
  *  2. **Cosa puo' stare in `assignToReference`**: una variabile, un campo di una variabile
- *     record, un campo di `$Record` e, fra le globali, `$Flow.CurrentStage`,
- *     `$Flow.ActiveStages` e quelle che il sistema ospite dichiara scrivibili — le propone
- *     già `POST /flows/references/writable`. Tutto il resto e' di sola lettura.
+ *     record, un campo di `$Record` e, fra le globali, soltanto `$Flow.CurrentStage` e
+ *     `$Flow.ActiveStages` — le propone già `POST /flows/references/writable`. Tutto il resto e'
+ *     di sola lettura, comprese le globali dell'host e i loro membri (§5.2).
  *  3. Gli operatori marcati `expectsCollection` hanno senso **solo** su destinazioni
  *     collection: su una variabile singola non falliscono, non fanno nulla.
  */
@@ -9836,5 +10067,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.27", ngImpo
  * Generated bundle index. Do not edit.
  */
 
-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, SEVERITY_BUCKETS, SEVERITY_ICON, SEVERITY_LABEL, START_NODE_NAME, SelectValueDirective, StartInspectorComponent, StructureMemberPickerComponent, StructurePickerComponent, TYPES_WITH_AUTOMATIC_OUTPUT, TYPE_BY_COLLECTION, UNSUPPORTED_TYPES, ValueEditorComponent, VersionPanelComponent, areTypesComparable, canvasNodeId, checkConditionLogic, checkFlowName, describePathEntry, elementIcon, emptyFlowDefinition, flowNodeWidth, flowNodeWidthClass, isCustomConditionLogic, isGlobalReference, isNumericType, isTypeCheckedOperator, isValidFlowName, loadPathLevel, moveCondition, navigatePath, outletByKey, outletsOf, parseCanvasNodeId, parseInvariantNumber, parseSourceConnectorId, parseTargetConnectorId, pathAvailableNames, pathContainerLabel, pathNotVerifiableMessage, referenceRoot, remapConditionLogic, removeCondition, resolvePath, severityBucket, slugifyFlowName, sourceConnectorId, stageStepNames, stageStepOutputReferenced, stepsOf, targetConnectorId, uniqueFlowName, variantFieldOf, variantOf, variantPresetOf };
+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, SEVERITY_BUCKETS, SEVERITY_ICON, SEVERITY_LABEL, START_NODE_NAME, SelectValueDirective, StartInspectorComponent, StructureMemberPickerComponent, StructurePickerComponent, TYPES_WITH_AUTOMATIC_OUTPUT, TYPE_BY_COLLECTION, UNSUPPORTED_TYPES, ValueEditorComponent, VersionPanelComponent, areTypesComparable, canvasNodeId, checkConditionLogic, checkFlowName, describePathEntry, elementIcon, emptyFlowDefinition, filterReferences, flowNodeWidth, flowNodeWidthClass, isCustomConditionLogic, isEmptyReferenceFilter, isGlobalReference, isNumericType, isTypeCheckedOperator, isValidFlowName, loadPathLevel, matchesReferenceFilter, moveCondition, navigatePath, outletByKey, outletsOf, parseCanvasNodeId, parseInvariantNumber, parseSourceConnectorId, parseTargetConnectorId, pathAvailableNames, pathContainerLabel, pathNotVerifiableMessage, referenceRoot, remapConditionLogic, removeCondition, resolvePath, severityBucket, slugifyFlowName, sourceConnectorId, stageStepNames, stageStepOutputReferenced, stepsOf, targetConnectorId, uniqueFlowName, variantFieldOf, variantOf, variantPresetOf };
 //# sourceMappingURL=esfaenza-flow-builder.mjs.map