@esfaenza/flow-builder 20.3.12 → 20.3.13

package/index.d.ts

@@ -2827,22 +2827,15 @@ declare class ReferencePickerComponent {
     readonly query: _angular_core.WritableSignal<string>;
     constructor();
     /**
-     * Il riferimento dichiarato piu' **lungo** che sia un prefisso del valore, sui confini del punto.
+     * Il riferimento dichiarato piu' **lungo** che sia un prefisso del valore, e la tappa da cui
+     * navigare il resto. La regola sta in `core/reference-path` perche' non e' solo del picker: gli
+     * inspector ne ricavano il **tipo** dell'ultimo segmento con la stessa catena, e due copie di
+     * «prefisso piu' lungo» divergerebbero (§4.1, §4.7.1).
      *
-     * 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).
+     * Fra **tutte** le radici, non fra quelle filtrate: la radice di `Richiesta.Ragione` in un campo
+     * `String` sta solo nell'elenco non filtrato.
      */
     private readonly 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.
-     *
-     * Un output automatico e' escluso di proposito: la primitiva ne dichiara il tipo, ma la
-     * specifica tiene i percorsi che ne partono fuori dalla validazione (§7, ultimo capoverso), e
-     * l'editor non deve accusare cio' che il backend non verifica.
-     */
     private readonly navigableRoot;
     /** Il percorso dopo la radice: `Cliente.Email` di `Richiesta.Cliente.Email`. */
     private readonly navigatedPath;
@@ -2905,7 +2898,7 @@ declare class ReferencePickerComponent {
      *    percorso inesistente di uno scope che i percorsi li dichiara, perche' lì il backend
      *    risponderebbe `GLOBAL_UNKNOWN`.
      */
-    readonly valueState: _angular_core.Signal<"empty" | "member" | "unknown" | "known" | "navigated" | "host" | "containerRoot" | "memberUnknown" | "memberNotWritable" | "pathUnverified" | "globalPathUntyped" | "globalPathInvalid">;
+    readonly valueState: _angular_core.Signal<"empty" | "unknown" | "member" | "known" | "navigated" | "host" | "containerRoot" | "memberUnknown" | "memberNotWritable" | "pathUnverified" | "globalPathUntyped" | "globalPathInvalid">;
     /** Le parole cambiano con la tappa: un campo di un'entita' non e' un membro di una classe. */
     private readonly tailIsObject;
     private readonly tailContainer;
@@ -3282,6 +3275,7 @@ declare class ValueEditorComponent {
 
 declare class ConditionEditorComponent {
     private readonly dictionaries;
+    private readonly catalog;
     private readonly api;
     private readonly store;
     /** Il contenitore: porta `conditions`, `conditionLogic` e, se serve, `formula`. */
@@ -3306,15 +3300,22 @@ declare class ConditionEditorComponent {
      * fra testo e numero prima che lo dica la validazione (§4.3).
      */
     private readonly references;
+    /**
+     * Il tipo dei due lati, risorsa o **percorso**. L'elenco porta le radici e non i percorsi (§6.4):
+     * su `Richiesta.Stato` la corrispondenza esatta non trova niente, e il tipo si ricava navigando la
+     * classe (§4.7.1). È cio' che fa comparire l'elenco dei valori su un membro `Enum` (§4.6) e che
+     * rende visibile un confronto fra tipi incompatibili anche dentro un'istanza (§4.3).
+     */
+    private readonly types;
     constructor();
-    /** Il tipo di un riferimento, `undefined` se navigato o ignoto: lì non si segnala (§4.3). */
+    /** Il tipo di un riferimento, `undefined` dove non si sa: lì non si segnala (§4.3). */
     private typeOfReference;
     /** Il tipo del lato sinistro: guida il secondo operando. */
     leftDataType(condition: FlowCondition): FlowDataType | undefined;
     /**
      * Il tipo concreto del lato sinistro quando e' un `Enum`: senza di questo il valore di confronto
-     * resterebbe una casella di testo su un insieme chiuso (§4.6). Su un percorso navigato
-     * (`Cliente.Stato`) il riferimento non e' in elenco e resta `undefined`: si digita, come prima.
+     * resterebbe una casella di testo su un insieme chiuso (§4.6). Vale anche su un percorso navigato
+     * (`Richiesta.Stato`, `$Record.Stato`): il tipo del membro o del campo lo ricava {@link types}.
      */
     leftObjectType(condition: FlowCondition): string | undefined;
     /** Il tipo del lato destro, dedotto dal campo valorizzato o dal riferimento scelto. */
@@ -3325,7 +3326,7 @@ declare class ConditionEditorComponent {
      */
     hasTypeMismatch(condition: FlowCondition): boolean;
     typeMismatchMessage(condition: FlowCondition): string;
-    readonly logicMode: _angular_core.Signal<"formula" | "and" | "or" | "custom">;
+    readonly logicMode: _angular_core.Signal<"and" | "or" | "formula" | "custom">;
     readonly customLogic: _angular_core.Signal<string>;
     /** Feedback immediato sull'espressione: la verita' resta della validazione backend. */
     readonly customLogicError: _angular_core.Signal<string | null>;
@@ -3395,11 +3396,20 @@ declare class RecordFilterEditorComponent {
     readonly emptyWarning: _angular_core.InputSignal<string | null>;
     readonly emptyWarningSeverity: _angular_core.InputSignal<"error" | "warn">;
     readonly changed: _angular_core.OutputEmitterRef<(holder: FilterHolder) => void>;
-    private readonly fields;
     /** Tutti i campi, filtrabili o no: serve solo a riconoscere le chiavi composte (§5.7). */
     private readonly allFields;
     readonly filters: _angular_core.Signal<FlowRecordFilter[]>;
     readonly operators: _angular_core.Signal<_esfaenza_flow_builder.FlowDictionaryEntry[]>;
+    /**
+     * Il tipo del campo filtrato, **compresi i percorsi di relazione**: `Cliente.Citta` non e' nella
+     * lista piatta dei campi dell'entita' e il suo tipo si ricava navigando la catena (§4.4). Senza,
+     * un campo `Enum` raggiunto per relazione tornava una casella di testo su un insieme chiuso (§4.6).
+     *
+     * L'`usage` e' quello del campo — `filterable` fra i filtri — e vale per l'**ultimo** segmento: i
+     * segmenti intermedi li chiede `resolvePath` con `any`, perche' l'uso riguarda il campo confrontato
+     * e non la relazione che porta a lui.
+     */
+    private readonly types;
     constructor();
     /**
      * §5.7 — l'identificativo esiste ma **non e' filtrabile**: e' il caso di una chiave composta,
@@ -3407,7 +3417,7 @@ declare class RecordFilterEditorComponent {
      * evita la ricerca di un campo che nell'elenco non c'e' e non ci sara'.
      */
     readonly identifierNotFilterable: _angular_core.Signal<boolean>;
-    readonly logicMode: _angular_core.Signal<"formula" | "and" | "or" | "custom">;
+    readonly logicMode: _angular_core.Signal<"and" | "or" | "formula" | "custom">;
     readonly customLogic: _angular_core.Signal<string>;
     readonly showEmptyWarning: _angular_core.Signal<boolean>;
     addFilter(): void;
@@ -3423,13 +3433,12 @@ declare class RecordFilterEditorComponent {
     setFormula(formula: string): void;
     /**
      * 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.
+     * catalogo resta interrogato qui, e non solo dentro il picker.
      */
-    fieldDataType(filter: FlowRecordFilter): string | undefined;
+    fieldDataType(filter: FlowRecordFilter): FlowDataType | undefined;
     /**
      * Il tipo concreto del campo: su un campo `Enum` e' cio' che permette di proporre i valori
-     * ammessi invece di farli digitare (§4.6). Su un percorso di relazione il campo non e' in elenco
-     * e resta `undefined`, come per il tipo.
+     * ammessi invece di farli digitare (§4.6).
      */
     fieldObjectType(filter: FlowRecordFilter): string | undefined;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RecordFilterEditorComponent, never>;

package/package.json

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