@esfaenza/flow-builder 20.3.10 → 20.3.11

package/index.d.ts

@@ -880,13 +880,12 @@ interface FlowReference {
     isWritable?: boolean;
     description?: string | null;
 }
-/** Filtro opzionale per non trasferire riferimenti che il campo non accetta. */
-interface FlowReferenceQuery {
-    definition: FlowDefinition;
-    dataType?: FlowDataType;
-    isCollection?: boolean;
-    objectType?: string;
-}
+/**
+ * Non esiste un `FlowReferenceQuery`: il body di `POST /flows/references` e
+ * `POST /flows/references/writable` e' il **documento nudo**, senza involucro e senza campi di
+ * filtro (§6.4, §13.17). La risposta porta tutti i riferimenti col proprio tipo, e la
+ * compatibilita' col campo la decide l'editor con `filterReferences` (`core/reference-filter.util`).
+ */
 interface FlowConnectorTarget {
     name: string;
     label?: string | null;
@@ -1188,8 +1187,12 @@ declare abstract class FlowBuilderApi {
      * `POST /flows/references` — i valori proponibili in un campo che accetta una risorsa.
      * Include gli **output automatici** degli elementi, che non sono dichiarati in nessuna
      * collection: e' il motivo per cui non va ricostruita lato client (§4.5, §13.3).
+     *
+     * Prende il **documento nudo** e restituisce **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). Cosi' la
+     * stessa risposta serve tutte le tendine di una schermata.
      */
-    abstract getReferences(query: FlowReferenceQuery): Promise<FlowReference[]>;
+    abstract getReferences(definition: FlowDefinition): Promise<FlowReference[]>;
     /**
      * `POST /flows/references/writable` — le variabili **piu' le globali assegnabili**, per i
      * campi di destinazione. Le globali assegnabili sono **due**, `$Flow.CurrentStage` e
@@ -1197,8 +1200,11 @@ declare abstract class FlowBuilderApi {
      * flag per dichiararne una scrivibile (§5.2). La primitiva le comprende già, l'editor non le
      * aggiunge. Restano fuori i campi di `$Record`, che dipendono dallo schema: quelli arrivano da
      * `listFields(object, 'updateable')` (§6.4).
+     *
+     * Come `getReferences`: documento nudo nel body, nessun filtro di tipo, elenco completo in
+     * risposta (§13.17).
      */
-    abstract getWritableReferences(query: FlowReferenceQuery): Promise<FlowReference[]>;
+    abstract getWritableReferences(definition: FlowDefinition): Promise<FlowReference[]>;
     /** `POST /flows/connector-targets?excluding=` — i node a cui un arco puo' puntare. */
     abstract getConnectorTargets(definition: FlowDefinition, excluding?: string): Promise<FlowConnectorTarget[]>;
     /**
@@ -1339,11 +1345,23 @@ declare class HttpFlowBuilderApi extends FlowBuilderApi {
     deactivateFlow(flowName: string): Promise<void>;
     deleteVersion(flowName: string, version: number): Promise<void>;
     deleteFlow(flowName: string): Promise<void>;
+    /**
+     * 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: FlowDefinition): Promise<FlowValidationResult>;
     validateVersion(flowName: string, version: number): Promise<FlowValidationResult>;
     getDictionaries(processType?: string): Promise<FlowDictionaries>;
-    getReferences(query: FlowReferenceQuery): Promise<FlowReference[]>;
-    getWritableReferences(query: FlowReferenceQuery): Promise<FlowReference[]>;
+    /**
+     * 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: FlowDefinition): Promise<FlowReference[]>;
+    getWritableReferences(definition: FlowDefinition): Promise<FlowReference[]>;
     getConnectorTargets(definition: FlowDefinition, excluding?: string): Promise<FlowConnectorTarget[]>;
     getOutline(definition: FlowDefinition): Promise<FlowOutline>;
     listObjects(): Promise<FlowObjectSummary[]>;
@@ -2035,6 +2053,40 @@ interface PathNavigation {
  */
 declare function navigatePath(catalog: PathCatalog, request: () => PathNavigationRequest | null): PathNavigation;
 
+/**
+ * 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`).
+ */
+
+/** I vincoli del campo che si sta compilando. Un campo assente e' "nessun vincolo". */
+interface FlowReferenceFilter {
+    dataType?: FlowDataType;
+    isCollection?: boolean;
+    objectType?: string;
+}
+/**
+ * La forma minima su cui il filtro lavora: la regola vale sia per un riferimento sia per un
+ * segmento di percorso, che riferimento non e'.
+ */
+interface FlowTypedEntry {
+    dataType?: FlowDataType | null;
+    isCollection?: boolean | null;
+    objectType?: string | null;
+}
+/** `true` se il campo non pone nessun vincolo: lì filtrare e' inutile. */
+declare function isEmptyReferenceFilter(filter: FlowReferenceFilter | undefined): boolean;
+declare function matchesReferenceFilter(entry: FlowTypedEntry, filter: FlowReferenceFilter): boolean;
+declare function filterReferences(references: readonly FlowReference[], filter: FlowReferenceFilter | undefined): FlowReference[];
+
 /** Un node come lo vede l'editor: il node piu' da dove viene. */
 interface FlowNodeRef {
     name: string;
@@ -2686,19 +2738,29 @@ declare class ReferencePickerComponent {
      */
     readonly elementsOnly: _angular_core.InputSignal<boolean>;
     readonly valueChange: _angular_core.OutputEmitterRef<string | undefined>;
-    private readonly references;
     /**
-     * L'elenco **senza** il filtro di tipo, che serve solo a riconoscere le radici dei percorsi.
+     * L'elenco come arriva dalla primitiva, **senza** il filtro di tipo.
      *
-     * 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).
-     *
-     * Vuoto dove il filtro non c'e': lì {@link references} e' già l'elenco completo.
+     * 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).
      */
     private readonly 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.
+     */
+    private readonly 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.
+     */
+    private readonly references;
     /** Tutto cio' che puo' essere la radice di un percorso, filtrato o no. */
     private readonly roots;
     private readonly isLoading;
@@ -2744,10 +2806,9 @@ declare class ReferencePickerComponent {
     private readonly isReadOnlyPath;
     private readonly pathReferences;
     /**
-     * Lo stesso filtro che il backend applica alle 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.
+     * 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.
      */
     private matchesTarget;
     /**
@@ -3170,7 +3231,7 @@ declare class ConditionEditorComponent {
      */
     hasTypeMismatch(condition: FlowCondition): boolean;
     typeMismatchMessage(condition: FlowCondition): string;
-    readonly logicMode: _angular_core.Signal<"and" | "or" | "formula" | "custom">;
+    readonly logicMode: _angular_core.Signal<"and" | "or" | "custom" | "formula">;
     readonly customLogic: _angular_core.Signal<string>;
     /** Feedback immediato sull'espressione: la verita' resta della validazione backend. */
     readonly customLogicError: _angular_core.Signal<string | null>;
@@ -3252,7 +3313,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<"and" | "or" | "formula" | "custom">;
+    readonly logicMode: _angular_core.Signal<"and" | "or" | "custom" | "formula">;
     readonly customLogic: _angular_core.Signal<string>;
     readonly showEmptyWarning: _angular_core.Signal<boolean>;
     addFilter(): void;
@@ -4006,5 +4067,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, 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 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, 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, FlowReferenceKind, FlowReferenceQuery, 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, 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 };
+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 };
+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, 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.10",
+  "version": "20.3.11",
   "peerDependencies": {
     "@angular/common": "^20.3.25",
     "@angular/core": "^20.3.25",