@esfaenza/flow-builder 20.3.48 → 20.3.49

package/index.d.ts

@@ -286,6 +286,24 @@ interface FlowScreenField {
     autoSelectSingleChoice?: boolean;
     scale?: number;
     maxLength?: number;
+    /**
+     * §5.2 — **che cosa** il campo raccoglie, oltre al fatto di essere un testo: `Email`, `Url`,
+     * `Phone`, `MobilePhone`, `LandlinePhone`, o un nome che l'host ha registrato. Il frontend ne
+     * ricava il tipo di input, e il runtime rifiuta l'invio con `FORMAT_INVALID`.
+     *
+     * **L'elenco non e' chiuso e i pattern non stanno nel metadata**: che cosa sia un cellulare valido
+     * e' una regola del paese in cui il sistema gira, quindi i formati proposti arrivano da
+     * `dictionaries.screenFieldFormats` e un nome fuori elenco e' un'**osservazione**
+     * (`SCREEN_FIELD_FORMAT_UNKNOWN`), non un errore — bloccare l'attivazione per un nome che la
+     * libreria non conosce sarebbe un falso positivo. Su un campo che non raccoglie un singolo testo
+     * e' l'avviso `SCREEN_FIELD_FORMAT_NOT_APPLICABLE`: non ha effetto.
+     *
+     * Due cose che il formato **non** e'. Non e' un'etichetta che il flow puo' leggere: se a valle
+     * serve sapere che un numero e' un cellulare, quella distinzione sta nel dato — due campi, o due
+     * membri di una `Structure`. E non riscrive il valore: togliere spazi o aggiungere il prefisso
+     * internazionale e' una trasformazione, e il posto per farla e' una screen action.
+     */
+    format?: string;
     /** 1..12 nella griglia della schermata: il frontend puo' ignorarla. */
     width?: number;
     /**
@@ -314,10 +332,28 @@ interface FlowScreenField {
      * sola lettura: `STRUCTURE_MEMBER_UNKNOWN` e `TARGET_NOT_WRITABLE`.
      */
     memberName?: string;
-    /** §5.2 — `RepeatingSection`: righe minime. */
+    /**
+     * §5.2 — `RepeatingSection`: righe minime, ed e' un **vincolo**: sotto quel numero la sezione non
+     * scende, e con `minInstances: 1` il runtime non consente di togliere l'ultima riga. Da non
+     * confondere con {@link initialInstances}.
+     */
     minInstances?: number;
     /** §5.2 — `RepeatingSection`: righe massime. Assente e' l'avviso `REPEATING_SECTION_WITHOUT_LIMIT`. */
     maxInstances?: number;
+    /**
+     * §5.2 — `RepeatingSection`: quante righe trovare **gia' aperte** arrivando sulla schermata, ed e'
+     * la distinzione che serve piu' spesso. Non e' il minimo: il minimo e' un vincolo, queste sono una
+     * comodita' e si possono togliere tutte. Un modulo con un punto luce e un punto gas gia' aperti,
+     * dove chi ha una sola commodity toglie quello che non gli serve, e' `initialInstances: 1` con
+     * `minInstances: 0`; con il minimo a 1 sarebbe un modulo che **obbliga** a entrambe.
+     *
+     * Si applicano **una volta sola**, e la condizione e' che nessuno abbia ancora scritto la
+     * collection: righe arrivate da altrove — un ciclo su un OCR, un Assignment, una schermata
+     * precedente — **sono** le righe iniziali e non vengono diluite con righe vuote, e chi le toglie
+     * tutte non se le ritrova alla presentazione successiva, perche' l'invio della schermata e' a sua
+     * volta una scrittura. Vale anche attraverso una sospensione.
+     */
+    initialInstances?: number;
     /** §5.2 — `RepeatingSection`: default `true`. */
     allowAdd?: boolean;
     /** §5.2 — `RepeatingSection`: default `true`. */
@@ -1044,6 +1080,16 @@ interface FlowDictionaries {
     screenNavigations?: FlowDictionaryEntry[];
     /** §5.2 — i tipi di campo di uno screen dinamico, con i flag che guidano il form. */
     screenFieldTypes?: FlowScreenFieldTypeEntry[];
+    /**
+     * §5.2 — i formati di un campo di testo: `Email`, `Url`, `Phone`, `MobilePhone`, `LandlinePhone`.
+     *
+     * **E' l'unico dizionario dichiaratamente aperto**, e va trattato come tale: i pattern non stanno
+     * nel metadata — che cosa sia un cellulare valido e' una regola del paese in cui il sistema gira —
+     * e l'host ne registra dei propri (codice fiscale, partita IVA, IBAN, CAP). Quindi qui si propone,
+     * non si giudica: un nome fuori elenco e' `SCREEN_FIELD_FORMAT_UNKNOWN`, un'osservazione, e un
+     * editor che voglia proporli tutti unisce questo elenco con quello che l'host espone per conto suo.
+     */
+    screenFieldFormats?: FlowDictionaryEntry[];
     /** §5.2 — `SectionWithHeader` | `SectionWithoutHeader`. */
     regionContainerTypes?: FlowDictionaryEntry[];
     /** §5.2 — `UseStoredValues` | `ResetValues` (`inputsOnNextNavToAssocScrn`). */
@@ -2713,6 +2759,11 @@ declare class FlowDictionaryStore {
     readonly assigneeTypes: _angular_core.Signal<FlowDictionaryEntry[]>;
     readonly conditionLogicModes: _angular_core.Signal<FlowDictionaryEntry[]>;
     readonly regionContainerTypes: _angular_core.Signal<FlowDictionaryEntry[]>;
+    /**
+     * §5.2 — i formati di un campo di testo. Elenco **aperto**: vuoto significa «non lo so» e un nome
+     * fuori elenco e' un'osservazione, non un errore — i pattern li registra l'host, non la libreria.
+     */
+    readonly screenFieldFormats: _angular_core.Signal<FlowDictionaryEntry[]>;
     readonly screenFieldInputsRevisited: _angular_core.Signal<FlowDictionaryEntry[]>;
     /**
      * §5.2 — le proprieta' citabili in un choice set da enum. Elenco vuoto: il dizionario non le
@@ -5178,8 +5229,14 @@ declare class NamePickerComponent {
      * 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.
+     *
+     * `'note'` e' il terzo caso, e serve dove l'elenco **non e' autoritativo**: il `format` di un campo
+     * di screen (§5.2) lo registra l'host, quindi un nome fuori catalogo non e' ne' un errore ne' un
+     * difetto — e' un'osservazione (`SCREEN_FIELD_FORMAT_UNKNOWN`). Si scrive senza colore, come il
+     * `connector-editor` scrive il promemoria del ramo di guasto: il colore d'avviso su un nome
+     * legittimo manda a cercare un difetto che non c'e'.
      */
-    readonly unknownSeverity: _angular_core.InputSignal<"error" | "warn">;
+    readonly unknownSeverity: _angular_core.InputSignal<"error" | "warn" | "note">;
     /**
      * 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
@@ -6753,6 +6810,18 @@ declare class DynamicScreenInspectorComponent extends NodeInspectorBase {
     readonly selectedAutoSelectsSingleChoice: _angular_core.Signal<boolean>;
     /** §5.2 — `scale` su un campo non numerico e' `SCALE_NOT_APPLICABLE`. */
     readonly scaleApplies: _angular_core.Signal<boolean>;
+    /**
+     * §5.2 — il `format` vale dove il campo raccoglie **un solo testo**: altrove e'
+     * `SCREEN_FIELD_FORMAT_NOT_APPLICABLE` e non ha effetto. La condizione e' quella, non l'elenco dei
+     * tipi di campo: un `dataType` assente vale `String` perche' e' il default del contratto, e il
+     * plurale lo dice il dizionario (`isCollection`), non il codice.
+     */
+    readonly formatApplies: _angular_core.Signal<boolean>;
+    /**
+     * I formati da proporre. L'elenco e' **aperto** — i pattern li registra l'host — quindi vuoto
+     * significa «non lo so» e un nome fuori elenco non si accusa: il picker lo scrive come nota.
+     */
+    readonly formatOptions: _angular_core.Signal<NamePickerOption[]>;
     readonly requiresObjectType: _angular_core.Signal<boolean>;
     readonly objectTypeIsStructure: _angular_core.Signal<boolean>;
     /** L'oggetto di un `ObjectProvided`, cioe' la parte prima del punto (§5.2). */
@@ -6804,6 +6873,12 @@ declare class DynamicScreenInspectorComponent extends NodeInspectorBase {
     readonly repeaterIssue: _angular_core.Signal<string | null>;
     /** §5.2 — il massimo mancante e' un **avviso**: senza, l'utente puo' aggiungere righe all'infinito. */
     readonly repeaterHasNoLimit: _angular_core.Signal<boolean>;
+    /**
+     * §5.2 — righe iniziali fuori dai limiti. Il runtime le riporta comunque dentro, quindi non e' un
+     * difetto che rompe qualcosa: e' che il numero scritto **non e' quello che si vedra'**, e finche'
+     * nessuno lo dice si crede il contrario. Va detto qui, dove i tre numeri stanno insieme.
+     */
+    readonly repeaterInitialOutOfRange: _angular_core.Signal<string | null>;
     /**
      * La variabile del documento con quel nome, se e' una variabile. Non un riferimento qualunque: una
      * costante o una formula qui e' `REPEATING_SECTION_INVALID`, e distinguerle e' il punto.
@@ -6824,7 +6899,7 @@ declare class DynamicScreenInspectorComponent extends NodeInspectorBase {
      */
     setFieldType(type: string): void;
     setDefaultValue(value: FlowValue | undefined): void;
-    setNumberProperty(property: 'scale' | 'maxLength' | 'width' | 'minInstances' | 'maxInstances', raw: string): void;
+    setNumberProperty(property: 'scale' | 'maxLength' | 'width' | 'minInstances' | 'maxInstances' | 'initialInstances', raw: string): void;
     /**
      * §5.2 — `allowAdd` e `allowRemove` hanno default `true`: si scrive solo il `false`, che e' la
      * scelta significativa. È la stessa regola dei flag del node (§2), non quella di un `FlowValue`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esfaenza/flow-builder",
-  "version": "20.3.48",
+  "version": "20.3.49",
   "peerDependencies": {
     "@angular/cdk": "^20.2.14",
     "@angular/common": "^20.3.31",