@esfaenza/flow-builder 20.3.12 → 20.3.14

package/index.d.ts

@@ -1673,6 +1673,43 @@ declare function areTypesComparable(left: FlowDataType | undefined | null, right
  */
 declare function parseInvariantNumber(raw: string): number | undefined;
 
+/**
+ * Quale campo di un `FlowElementReferenceOrValue` porta davvero il valore — FRONTEND.md §4.2.
+ *
+ * La regola del contratto e' "uno e un solo campo valorizzato", e la §2 dice che cio' che non c'e'
+ * si **omette**. Un backend che serializza tutte le proprieta' — `System.Text.Json` senza
+ * `IgnoreNullValues` lo fa di default — rispetta il contratto nella sostanza e lo viola nella forma:
+ * arriva `{"enumValue": "InIstruttoria", "formulaExpression": null, ...}`, cioe' un solo valore e
+ * sette caselle piene di niente.
+ *
+ * Il campo si sceglieva con `!== undefined`, e un `null` passava: la prima casella letta —
+ * `formulaExpression` — vinceva, l'editor apriva la formula (vuota) e il valore, pur presente nel
+ * documento, spariva dalla vista. Da qui questa funzione sola: **`null` e' assente quanto
+ * `undefined`**, e chi interpreta un valore la usa invece di confrontare con `undefined`.
+ *
+ * Sta in `core/` perche' i chiamanti sono piu' d'uno — l'editor del valore, l'editor delle
+ * condizioni — e la regola non deve divergere fra loro.
+ */
+
+/**
+ * I campi che possono portare il valore, **nell'ordine in cui si interpretano**: `formulaExpression`
+ * per primo perche' e' l'unico a due campi, poi il riferimento, poi i letterali. `formulaDataType`
+ * non c'e': accompagna l'espressione, non e' un valore da solo.
+ */
+declare const FLOW_VALUE_FIELDS: readonly (keyof FlowValue)[];
+/** I soli campi letterali: quelli che l'editor mostra sotto la modalita' «Valore». */
+declare const FLOW_VALUE_LITERAL_FIELDS: readonly (keyof FlowValue)[];
+/**
+ * `true` se il campo porta un valore. Attenzione ai falsi legittimi: `booleanValue: false`,
+ * `numberValue: 0` e `stringValue: ''` sono valori, quindi il confronto e' con `null`/`undefined`
+ * e non una verifica di verita'.
+ */
+declare function isValued(field: unknown): boolean;
+/** I campi valorizzati, nell'ordine di interpretazione: piu' di uno e' `VALUE_AMBIGUOUS` (§4.2). */
+declare function valuedFieldsOf(value: FlowValue | undefined | null): (keyof FlowValue)[];
+/** Il campo che l'editor considera **il** valore, cioe' il primo valorizzato nell'ordine sopra. */
+declare function valuedFieldOf(value: FlowValue | undefined | null): keyof FlowValue | undefined;
+
 /**
  * Gli step di uno stage di orchestrazione — FRONTEND.md §5.13.
  *
@@ -2827,22 +2864,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 +2935,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<"member" | "empty" | "unknown" | "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;
@@ -3057,7 +3087,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<"error" | "warn">;
+    readonly unknownSeverity: _angular_core.InputSignal<"warn" | "error">;
     /** Cosa dire quando l'elenco e' vuoto: e' il caso "non lo so", non un errore. */
     readonly emptyMessage: _angular_core.InputSignal<string>;
     /** Testo monospazio: i nomi tecnici si leggono meglio, ed e' come li mostra il resto del form. */
@@ -3282,6 +3312,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 +3337,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. */
@@ -3393,13 +3431,22 @@ declare class RecordFilterEditorComponent {
      * (§5.7, §13.10).
      */
     readonly emptyWarning: _angular_core.InputSignal<string | null>;
-    readonly emptyWarningSeverity: _angular_core.InputSignal<"error" | "warn">;
+    readonly emptyWarningSeverity: _angular_core.InputSignal<"warn" | "error">;
     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,
@@ -3423,13 +3470,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>;
@@ -4174,5 +4220,5 @@ declare class SelectValueDirective implements AfterViewChecked {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SelectValueDirective, "select[fbValue]", never, { "fbValue": { "alias": "fbValue"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-export { ConditionEditorComponent, ConnectorEditorComponent, DebugPanelComponent, ElementDialogComponent, ElementInspectorComponent, ElementPaletteComponent, EnumValuePickerComponent, 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 };
+export { ConditionEditorComponent, ConnectorEditorComponent, DebugPanelComponent, ElementDialogComponent, ElementInspectorComponent, ElementPaletteComponent, EnumValuePickerComponent, 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, FLOW_VALUE_FIELDS, FLOW_VALUE_LITERAL_FIELDS, 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, isValued, 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, valuedFieldOf, valuedFieldsOf, variantFieldOf, variantOf, variantPresetOf };
 export type { FieldAssignmentHolder, FilterHolder, FlowActionCall, FlowAnyNode, FlowAssignment, FlowAssignmentItem, FlowAssignmentOperator, FlowAssignmentOperatorEntry, FlowBuilderHttpConfig, FlowCanvasEdge, FlowCanvasNode, FlowCatalogEntry, FlowCatalogParameter, FlowChoice, FlowCloneRequest, FlowCollectionProcessor, FlowCollectionProcessorType, FlowComparisonOperator, FlowComparisonOperatorEntry, FlowCondition, FlowConditionHolder, FlowConditionLogic, FlowConflictState, FlowConnectionKind, FlowConnector, FlowConnectorTarget, FlowConstant, FlowCreateRequest, FlowCustomError, FlowCustomErrorMessage, FlowCustomProperty, FlowDataType, FlowDataTypeEntry, FlowDecision, FlowDecisionRule, FlowDefinition, FlowDictionaries, FlowDictionaryEntry, FlowDynamicChoiceSet, FlowEdge, FlowElementType, FlowElementTypeEntry, FlowEnumValue, FlowErrorCategory, FlowExportQuery, FlowFieldDescription, FlowFieldUsage, FlowFieldValue, FlowFormula, FlowGlobalVariableEntry, FlowInputFieldAssignment, FlowInputParameter, FlowInterviewResult, FlowInterviewStatus, FlowIssueSeverity, FlowLayoutDirection, FlowLayoutNodeInput, FlowLayoutOptions, FlowLayoutResult, FlowListQuery, FlowLoop, FlowNameCheck, FlowNameProblem, FlowNewVersionRequest, FlowNodeBase, FlowNodeCollection, FlowNodeRef, FlowObjectDescription, FlowObjectSummary, FlowOffsetUnit, FlowOrchestratedStage, FlowOutlet, FlowOutline, FlowOutlineConnection, FlowOutlineNode, FlowOutputFieldAssignment, FlowOutputParameter, FlowPalettePick, FlowPendingScreen, FlowProcessType, FlowRecordCreate, FlowRecordDelete, FlowRecordFilter, FlowRecordFilterOperator, FlowRecordLookup, FlowRecordRollback, FlowRecordTriggerType, FlowRecordUpdate, FlowRecordValue, FlowReference, FlowReferenceFilter, FlowReferenceKind, FlowResourceCollection, FlowResourceKindEntry, FlowResourceRef, FlowResumeRequest, FlowSaveRequest, FlowSaveResult, FlowSchedule, FlowScheduledPath, FlowScreen, FlowScreenNavigation, FlowScreenResponseRequest, FlowScriptPluginCall, FlowSeverityBucket, FlowSortOption, FlowSortOrder, FlowStage, FlowStageStep, FlowStageStepActionType, FlowStageStepAssignee, FlowStageStepConditionActionType, FlowStageStepRequest, FlowStageStepState, FlowStageStepStatus, FlowStageStepTypeEntry, FlowStart, FlowStartInterviewRequest, FlowStructureDescribed, FlowStructureDescription, FlowStructureInstance, FlowStructureMember, FlowSubflow, FlowSubflowInputAssignment, FlowSubflowOutputAssignment, FlowSummary, FlowTextTemplate, FlowTraceEntry, FlowTransactionModel, FlowTransform, FlowTransformType, FlowTransformValue, FlowTransformValueAction, FlowTriggerType, FlowTypedEntry, FlowTypedValue, FlowUnsupportedNode, FlowValidationIssue, FlowValidationResult, FlowValue, FlowVariable, FlowVersionStatus, FlowVersionSummary, FlowWait, FlowWaitEvent, NamePickerOption, PaletteGroup, PaletteItem, ParameterHolder, PathCatalog, PathContainer, PathContainerKind, PathEntry, PathLevel, PathLevelStatus, PathNavigation, PathNavigationRequest, PathResolution, PathStopReason, StructureMemberUsage, ValueMode };

package/package.json

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