@esfaenza/flow-builder 20.3.43 → 20.3.44

package/index.d.ts

@@ -3389,11 +3389,21 @@ declare class FlowDocumentStore {
  */
 declare const FLOW_REFERENCE_FIELDS: ReadonlySet<string>;
 /**
- * Riscrive ogni occorrenza di un nome nei campi che contengono riferimenti.
+ * Riscrive ogni occorrenza di un nome nei campi che contengono riferimenti **e nei merge field**.
  *
  * Cammina tutto cio' che gli si passa — un documento intero per la rinomina, il solo frammento
  * copiato per l'incolla — perche' i riferimenti compaiono in una ventina di posti diversi (§4)
  * e l'elenco dei posti sarebbe la cosa che si dimentica di aggiornare.
+ *
+ * I **merge field** ci sono entrati insieme al loro conteggio, e non e' un caso: mostrare «5 usi»
+ * contando i testi e poi riscriverne solo tre significa lasciare due messaggi rotti proprio a chi
+ * ha letto il numero per fidarsi della rinomina. Il testo intorno all'isola non si tocca — lì la
+ * stessa parola e' una parola — e la regola sta in `flow-merge-text.ts`.
+ *
+ * Restano fuori le **formule**: la loro sintassi e' del motore (§6.3), e sostituire un
+ * identificatore in un'espressione che non si interpreta vuol dire indovinare. Chi mostra il
+ * conteggio lo dice, invece di far scoprire dopo che una formula punta a un nome che non c'e'
+ * piu' (`describeNameUses` le tiene contate a parte proprio per questo).
  */
 declare function rewriteReferences(root: unknown, oldName: string, newName: string): void;
 /**
@@ -4817,7 +4827,7 @@ declare class NamePickerComponent {
      * **errori** che bloccano l'attivazione (`ACTION_UNKNOWN`, `FORM_UNKNOWN`), mentre un flow
      * senza versione attiva e' un avviso. Mostrarli con lo stesso colore direbbe il falso.
      */
-    readonly unknownSeverity: _angular_core.InputSignal<"warn" | "error">;
+    readonly unknownSeverity: _angular_core.InputSignal<"error" | "warn">;
     /**
      * Nomi che **esistono** ma non sono utilizzabili qui. Il caso vero e' il catalogo dei form,
      * dove una schermata intera e un componente vivono nello stesso elenco e si distinguono per
@@ -5037,7 +5047,7 @@ declare class FormulaEditorComponent {
      * dinamico — e riscriverla a ogni tasto costa. La **verifica** parte comunque durante la
      * digitazione: usa la bozza locale, non cio' che e' arrivato al documento.
      */
-    readonly commitOn: _angular_core.InputSignal<"input" | "change">;
+    readonly commitOn: _angular_core.InputSignal<"change" | "input">;
     readonly expressionChange: _angular_core.OutputEmitterRef<string>;
     private readonly area;
     /**
@@ -5386,7 +5396,7 @@ declare class RecordFilterEditorComponent {
      * (§5.8, §13.10).
      */
     readonly emptyWarning: _angular_core.InputSignal<string | null>;
-    readonly emptyWarningSeverity: _angular_core.InputSignal<"warn" | "error">;
+    readonly emptyWarningSeverity: _angular_core.InputSignal<"error" | "warn">;
     readonly changed: _angular_core.OutputEmitterRef<(holder: FilterHolder) => void>;
     /** Tutti i campi, filtrabili o no: serve solo a riconoscere le chiavi composte (§5.8). */
     private readonly allFields;
@@ -5607,7 +5617,7 @@ declare class MergeTextEditorComponent {
     readonly disabled: _angular_core.InputSignal<boolean>;
     readonly rows: _angular_core.InputSignal<number>;
     /** Come nel formula editor: `change` dove mutare il documento ridisegna mezza schermata. */
-    readonly commitOn: _angular_core.InputSignal<"input" | "change">;
+    readonly commitOn: _angular_core.InputSignal<"change" | "input">;
     readonly textChange: _angular_core.OutputEmitterRef<string>;
     private readonly area;
     /**
@@ -5817,7 +5827,22 @@ declare class ElementInspectorComponent {
      * Quanti riferimenti verrebbero riscritti dalla rinomina. Serve a rendere visibile che
      * l'operazione tocca il resto del documento, non solo questo elemento.
      */
+    /**
+     * Gli usi del nome, con la stessa funzione del pannello risorse: e' la stessa domanda, e due
+     * numeri diversi per la stessa domanda sono un difetto — questo era una regex sul JSON
+     * serializzato, che contava le stringhe uguali al nome in **qualunque** campo (anche dove non
+     * sono riferimenti) e non vedeva ne' le formule ne' i merge field, cioe' sovrastimava e
+     * sottostimava insieme.
+     */
+    private readonly nameUses;
+    /** Le occorrenze che la rinomina **riscrive**: riferimenti piu' merge field nei testi. */
     readonly referenceCount: _angular_core.Signal<number>;
+    /**
+     * Le occorrenze che restano indietro: le espressioni delle formule, che l'editor non riscrive
+     * perche' la loro sintassi e' del motore (§6.3). Dirlo qui e' l'unico modo di non farlo
+     * scoprire dopo, quando la formula punta a un nome che non esiste piu'.
+     */
+    readonly formulaUseCount: _angular_core.Signal<number>;
     readonly canRename: _angular_core.Signal<boolean>;
     startRename(): void;
     onPendingNameInput(value: string): void;
@@ -6456,6 +6481,17 @@ declare class DynamicScreenInspectorComponent extends NodeInspectorBase {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DynamicScreenInspectorComponent, "fb-dynamic-screen-inspector", never, { "initialSelection": { "alias": "initialSelection"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Gli usi di un nome, divisi per come sono scritti nel documento. */
+interface FlowNameUses {
+    /** Campi di riferimento: `targetReference`, `leftValueReference`, `choiceReferences`, … */
+    references: number;
+    /** Espressioni del motore di regole: **non** vengono riscritte dalla rinomina. */
+    formulas: number;
+    /** Isole `{!...}` nei campi di testo che il contratto dichiara con merge field (§5.12). */
+    mergeFields: number;
+    total: number;
+}
+
 /** La risorsa aperta in modifica: collection piu' indice, la sola chiave del documento. */
 interface FlowResourceEdit {
     collection: FlowResourceCollection;
@@ -6621,6 +6657,17 @@ declare class ResourcePanelComponent {
      * senza, tre formule che leggono una variabile la direbbero «non usata».
      */
     usesOf(reference: FlowResourceRef): number;
+    /**
+     * Il dettaglio degli usi: quanti riferimenti, quante formule, quanti merge field.
+     *
+     * Serve al `title` della riga, e non e' un vezzo: `{!Cliente.Nome}` in un messaggio e' un uso
+     * che non si vede da nessuna parte nel documento, quindi «13 usi» senza dire **dove** manda a
+     * cercarli nei posti sbagliati. E le tre categorie non si comportano allo stesso modo davanti a
+     * una rinomina, che e' l'altra cosa che si fa con questo numero.
+     */
+    usesDetailOf(reference: FlowResourceRef): FlowNameUses;
+    /** La riga del `title`: si scrivono le sole categorie presenti, altrimenti sono sempre tre. */
+    usesDetailLabel(reference: FlowResourceRef): string;
     /**
      * Il conteggio di **tutte** le risorse, calcolato una volta per documento.
      *
@@ -6628,10 +6675,10 @@ declare class ResourcePanelComponent {
      * chiede per ogni risorsa di ogni collection — i numeri delle schede, il chip «non usate» —
      * chiamarlo dal template significherebbe cinquanta walk per giro di change detection.
      *
-     * La chiave e' il nome **esatto** e non quello minuscolo: `countNameUses` confronta le
-     * stringhe come sono, quindi due nomi che differiscono solo per il case — che sono un
-     * `NAME_DUPLICATED`, non un caso da normalizzare qui — hanno due conteggi diversi, ed e'
-     * quello che il pannello mostrava anche prima della memoizzazione.
+     * La chiave e' il nome **esatto** e non quello minuscolo: il conteggio confronta le stringhe
+     * come sono, quindi due nomi che differiscono solo per il case — che sono un `NAME_DUPLICATED`,
+     * non un caso da normalizzare qui — hanno due conteggi diversi, ed e' quello che il pannello
+     * mostrava anche prima della memoizzazione.
      */
     private readonly useCounts;
     private keyOf;
@@ -6708,6 +6755,14 @@ declare class ResourceFormComponent {
     ignoredChoiceSetFilters(): string | null;
     /** La ripulitura e' un comando, non un effetto dell'apertura del form. */
     clearIgnoredChoiceSetFilters(): void;
+    /**
+     * Quante volte il nome di questa risorsa compare dentro un'**espressione**.
+     *
+     * E' l'unica delle tre categorie che la rinomina non tocca (§6.3: la sintassi e' del motore), e
+     * va detta dove si rinomina: il conteggio della riga lo dice già nel suo `title`, ma chi sta
+     * cambiando il nome sta guardando questo campo.
+     */
+    readonly formulaUseCount: _angular_core.Signal<number>;
     /** Su un choice set da enum il tipo e' `enumType`: il campo generico sarebbe un doppione. */
     hidesObjectType(): boolean;
     isChoiceSetSource(source: ChoiceSetSource): boolean;
@@ -6836,21 +6891,82 @@ declare class ProblemsPanelComponent {
     }>;
     readonly closed: _angular_core.OutputEmitterRef<void>;
     readonly filter: _angular_core.WritableSignal<SeverityFilter>;
+    /** Il testo del filtro: cerca in cio' che la riga mostra. */
+    readonly query: _angular_core.WritableSignal<string>;
+    /**
+     * I codici selezionati. Vuoto significa «tutti», non «nessuno»: e' l'unico modo di far
+     * coincidere lo stato iniziale con l'assenza di filtro.
+     */
+    readonly selectedCodes: _angular_core.WritableSignal<ReadonlySet<string>>;
+    readonly isCodeMenuOpen: _angular_core.WritableSignal<boolean>;
+    /** Il confine della tendina: il controllo, non il pannello. Vedi il commento nel costruttore. */
+    private readonly codesRef;
+    constructor();
     readonly isRunning: _angular_core.Signal<boolean>;
     readonly hasResult: _angular_core.Signal<boolean>;
     readonly lastError: _angular_core.Signal<string | null>;
+    /**
+     * Il testo su cui la casella confronta, **una stringa per rilievo** e allineata per indice a
+     * `validation.issues()`.
+     *
+     * Ci sta anche il percorso **tradotto per nome** (`pathLabel`), che e' quello che la riga
+     * mostra: su uno screen dinamico il path arriva a indici, e cercare il nome del campo che si
+     * legge sullo schermo non troverebbe niente. Si calcola una volta per risultato invece che a
+     * ogni battuta, perche' tradurre un path significa camminare l'albero della schermata.
+     */
+    private readonly haystacks;
+    private readonly needle;
+    /** Testo e codici: i due filtri che non sono la gravita'. */
+    private matchesText;
+    private matchesCode;
     /**
      * I conteggi dei chip vengono dai rilievi, non dal risultato: il numero sul filtro deve
-     * essere quello che il filtro apre (vedi `FlowValidationStore.issueCounts`).
+     * essere quello che il filtro apre (vedi `FlowValidationStore.issueCounts`). E' anche il
+     * motivo per cui **non** si leggono piu' da `issueCounts` quando gli altri filtri sono attivi:
+     * «Errori 47» accanto a una casella che ne lascia passare tre e' un numero che promette
+     * quarantaquattro righe che non compariranno.
      */
     private readonly counts;
     readonly errorCount: _angular_core.Signal<number>;
     readonly warningCount: _angular_core.Signal<number>;
     readonly infoCount: _angular_core.Signal<number>;
+    /** Quante righe aprirebbe «Tutti»: il totale **dopo** testo e codici. */
     readonly totalCount: _angular_core.Signal<number>;
+    /**
+     * Il totale assoluto, che non guarda nessun filtro. Serve a due cose diverse dai chip: dire
+     * che il flow **non** e' senza rilievi quando i filtri li nascondono tutti, e tenere in fondo
+     * la nota sugli errori che bloccano l'attivazione — filtrando per «Note» quella nota spariva
+     * pur essendoci quarantasette errori, cioe' proprio quando serve.
+     */
+    readonly absoluteCount: _angular_core.Signal<number>;
+    readonly hasErrors: _angular_core.Signal<boolean>;
     readonly issues: _angular_core.Signal<FlowValidationIssue[]>;
+    /**
+     * I codici della tendina: quelli **presenti** dopo gravita' e testo, col loro conteggio.
+     *
+     * Piu' quelli **selezionati** anche se non compaiono piu', a zero: una selezione che sparisce
+     * dall'elenco quando si cambia gravita' e' una selezione che continua a filtrare senza che si
+     * possa vedere ne' togliere. Ordinati per frequenza e poi per nome, perche' su sessanta righe
+     * il codice che conta e' quello che si ripete.
+     */
+    readonly codeFacets: _angular_core.Signal<{
+        code: string;
+        count: number;
+        selected: boolean;
+    }[]>;
+    readonly selectedCodeCount: _angular_core.Signal<number>;
+    /** `true` se c'e' un filtro **oltre** la gravita': decide il messaggio dell'elenco vuoto. */
+    readonly hasTextOrCodeFilter: _angular_core.Signal<boolean>;
+    readonly hasAnyFilter: _angular_core.Signal<boolean>;
+    onQuery(value: string): void;
+    toggleCodeMenu(): void;
+    /** La selezione e' un insieme nuovo a ogni gesto: un `Set` mutato non fa scattare il signal. */
+    toggleCode(code: string): void;
+    clearCodes(): void;
+    resetFilters(): void;
+    /** Nessun rilievo **nel flow**: e' un'altra cosa dal «nessuno che passi i filtri». */
     readonly isClean: _angular_core.Signal<boolean>;
-    /** Ci sono rilievi, ma il filtro attivo non ne mostra nessuno: va detto, non lasciato in bianco. */
+    /** Ci sono rilievi, ma i filtri attivi non ne mostrano nessuno: va detto, non lasciato in bianco. */
     readonly isFilteredEmpty: _angular_core.Signal<boolean>;
     readonly activeFilterLabel: _angular_core.Signal<string>;
     /** Un secondo clic sul filtro attivo torna a «Tutti»: e' l'unico modo per uscirne col mouse dov'e'. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esfaenza/flow-builder",
-  "version": "20.3.43",
+  "version": "20.3.44",
   "peerDependencies": {
     "@angular/cdk": "^20.2.14",
     "@angular/common": "^20.3.28",