@esfaenza/flow-builder 20.3.45 → 20.3.46

package/index.d.ts

@@ -3783,6 +3783,19 @@ declare class FlowLayoutService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<FlowLayoutService>;
 }
 
+/**
+ * §8 — la versione **attiva**, decisa in un posto solo.
+ *
+ * `isActive` e' una comodita' della riga, ma il campo su cui il contratto scrive il ciclo di vita e'
+ * `status`: la tabella della §8 e' fatta di stati, non di flag. Un host che serializza l'uno e non
+ * l'altro — il caso piu' comune e' `IsActive` in PascalCase, che diventa `undefined` senza dire
+ * niente — farebbe credere all'editor che nessuna versione sia attiva, e da lì l'editor sceglierebbe
+ * la piu' recente come «aperta» mentre il backend gli ha consegnato l'attiva.
+ *
+ * Il ripiego va in un verso solo: se il flag manca, decide lo stato. Se ci sono entrambi e si
+ * contraddicono vince lo stato, per la stessa ragione.
+ */
+declare function isVersionActive(version: FlowVersionSummary | undefined): boolean;
 /** Cosa mostrare quando il salvataggio incontra una versione modificata da altri (§9). */
 interface FlowConflictState {
     message: string;
@@ -3834,11 +3847,50 @@ declare class FlowEditorSession {
     startNew(fullName: string, label: string, processType: string): void;
     /**
      * Carica una versione e conserva il suo `updatedAt` (§11, "Modificare", passo 1).
-     * `version` assente → la versione attiva se c'e', altrimenti l'ultima.
+     *
+     * **La versione si chiede sempre esplicita**, anche quando il chiamante non la indica: la si
+     * risolve prima dall'elenco, con la regola della §6.1 (la attiva, altrimenti l'ultima). Chiedere
+     * la definizione «senza versione» e' comodo — decide il backend — ma lascia poi un numero da
+     * indovinare, perche' il documento porta `status` e **non** il numero (§2): un host che sceglie
+     * diversamente da come si e' dedotto fa evidenziare come «aperta» una riga diversa da quella che
+     * si sta guardando e, molto peggio, conservare l'`updatedAt` di quella riga e mandarlo come
+     * `expectedUpdatedAt` al salvataggio (§9).
+     *
+     * Costa un round trip solo quando serve: la richiesta dell'elenco parte comunque per prima, e la
+     * si aspetta **solo** se il numero non ce l'abbiamo già. Se l'elenco non arriva — host che non
+     * espone la primitiva, o elenco vuoto — si torna a chiedere senza versione e a dedurre
+     * ({@link pickVersion}): degradare e' meglio che non aprire.
      */
     open(flowName: string, version?: number): Promise<void>;
-    /** Senza `version` il backend restituisce la versione attiva, altrimenti l'ultima (§6.1). */
+    /**
+     * Quale versione il backend ci ha consegnato, quando non gliel'abbiamo chiesta.
+     *
+     * Il documento non porta il numero (§2), quindi si deduce — ma **non si tira a indovinare**: lo
+     * `status` del documento dice quale delle due strade della §6.1 ha preso il backend («la versione
+     * attiva, altrimenti l'ultima»), e se una sola riga porta quello status la deduzione diventa una
+     * constatazione. È il caso che conta: un flow con la **v1 attiva e la v2 in bozza** e' la forma
+     * piu' comune che esista, ed e' quella in cui sbagliare significa evidenziare come «aperta» una
+     * versione diversa da quella che si sta guardando — e, molto peggio, conservare l'`updatedAt`
+     * della riga sbagliata e mandarlo come `expectedUpdatedAt` al salvataggio (§9).
+     *
+     * Il ripiego e' la regola del contratto, con due difese: «attiva» la decide
+     * {@link isVersionActive} e non il solo flag, e «l'ultima» e' il **numero piu' alto** e non la
+     * prima riga — l'elenco arriva dalla piu' recente (§6.1), ma e' una promessa dell'host, e un host
+     * che ordina al contrario farebbe aprire la piu' vecchia senza che niente lo dica.
+     *
+     * Resta un caso che nessuna delle due strade risolve: piu' righe con lo stesso status del
+     * documento e un host che non segue la §6.1. Lì si torna alla regola del contratto, che e' quanto
+     * di meglio si possa dire di un backend che non la rispetta.
+     */
     private static pickVersion;
+    /**
+     * La regola della §6.1 — «la versione attiva, altrimenti l'ultima» — applicata dal client, con due
+     * difese: «attiva» la decide {@link isVersionActive} e non il solo flag, e «l'ultima» e' il
+     * **numero piu' alto** e non la prima riga. L'elenco arriva dalla piu' recente (§6.1), ma e' una
+     * promessa dell'host: un host che ordina al contrario farebbe aprire la piu' vecchia senza che
+     * niente lo dica.
+     */
+    private static contractVersion;
     /**
      * Ricarica l'elenco versioni: dopo un'attivazione la precedente e' `Obsolete` (§8.4).
      *
@@ -4781,7 +4833,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" | "known" | "navigated" | "host" | "member" | "containerRoot" | "memberUnknown" | "memberNotWritable" | "pathUnverified" | "globalPathUntyped" | "globalPathInvalid" | "unknown">;
+    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;
@@ -5169,7 +5221,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;
     /**
@@ -5757,7 +5809,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;
     /**
@@ -7225,6 +7277,12 @@ declare class VersionPanelComponent {
     /** La versione per cui e' stata chiesta l'eliminazione: conferma in due passi. */
     readonly pendingDelete: _angular_core.WritableSignal<number | null>;
     isCurrent(version: FlowVersionSummary): boolean;
+    /**
+     * §8 — attiva secondo lo **stato**, non il solo flag: e' la stessa regola con cui la sessione
+     * decide quale versione ha in mano, e tenerne due farebbe una riga marcata attiva e un comando
+     * «Attiva» offerto sopra di essa.
+     */
+    isActive(version: FlowVersionSummary): boolean;
     statusLabel(version: FlowVersionSummary): string;
     open(version: FlowVersionSummary): void;
     activate(version: FlowVersionSummary): Promise<void>;
@@ -7402,7 +7460,7 @@ declare class FlowBuilderComponent {
      * troppo. `panel` tiene il form nel pannello laterale, che e' piu' comodo quando si
      * modificano molti elementi di fila perche' non c'e' niente da aprire e chiudere.
      */
-    readonly inspectorMode: _angular_core.InputSignal<"panel" | "dialog">;
+    readonly inspectorMode: _angular_core.InputSignal<"dialog" | "panel">;
     /**
      * L'esito dell'ultima esecuzione, se l'ospite ne ha uno da mostrare.
      *
@@ -7804,5 +7862,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, DynamicScreenInspectorComponent, ENUM_CHOICE_SET_DEFAULT_DISPLAY_FIELD, ENUM_CHOICE_SET_DEFAULT_VALUE_FIELD, ENUM_CHOICE_SET_FIELDS, ElementDialogComponent, ElementInspectorComponent, ElementPaletteComponent, EnumValuePickerComponent, FALLBACK_COLLECTION_BY_TYPE, FALLBACK_TYPE_LABEL, FLOW_BUILDER_HTTP_CONFIG, FLOW_CLIPBOARD_KIND, FLOW_CLIPBOARD_VERSION, FLOW_ELEMENT_ICONS, FLOW_ELEMENT_VARIANT_FIELDS, FLOW_ELEMENT_VARIANT_ICONS, FLOW_ERROR_FALLBACK_MESSAGE, FLOW_ERROR_HTTP_STATUS, FLOW_FOLD_HEIGHT, FLOW_FOLD_WIDTH, FLOW_GROUP_COLORS, FLOW_NAME_PATTERN, FLOW_NODE_COLLECTIONS, FLOW_NODE_HEIGHT, FLOW_NODE_WIDTH, FLOW_REFERENCE_FIELDS, FLOW_RESOURCE_COLLECTIONS, FLOW_VALUE_FIELDS, FLOW_VALUE_LITERAL_FIELDS, FieldAssignmentEditorComponent, FieldPickerComponent, FieldValuePickerComponent, FlowApiError, FlowBuilderApi, FlowBuilderComponent, FlowCanvasComponent, FlowCatalogStore, FlowClipboardService, FlowDictionaryStore, FlowDocumentStore, FlowEditorSession, FlowLayoutService, FlowValidationStore, FormulaEditorComponent, FormulaValidationService, GROUP_HEADER_HEIGHT, GROUP_MIN_HEIGHT, GROUP_MIN_WIDTH, GROUP_PADDING, GroupPanelComponent, HttpFlowBuilderApi, MergeTextEditorComponent, NamePickerComponent, NodeInspectorBase, ORCHESTRATION_CONDITION_OUTPUT, ObjectPickerComponent, OrchestratedStageInspectorComponent, ParameterEditorComponent, PasteDialogComponent, ProblemsPanelComponent, RecordFilterEditorComponent, ReferencePickerComponent, ResourceDialogComponent, ResourceFormComponent, ResourcePanelComponent, RunDialogComponent, SEVERITY_BUCKETS, SEVERITY_ICON, SEVERITY_LABEL, START_NODE_NAME, SelectValueDirective, StartInspectorComponent, StructureMemberPickerComponent, StructurePickerComponent, TYPES_WITH_AUTOMATIC_OUTPUT, TYPE_BY_COLLECTION, UNSUPPORTED_TYPES, ValueEditorComponent, VersionPanelComponent, allFieldsOf, applyPaste, areTypesComparable, boundsAround, buildClipboardPayload, canvasFoldId, canvasGroupId, canvasNodeId, checkConditionLogic, checkFlowName, choiceSetSourceOf, declaredChoiceSetSources, describeFieldPath, describePathEntry, duplicateField, elementIcon, emptyFlowDefinition, enumChoiceSetFieldType, fieldAt, filterReferences, flattenFields, flowNodeWidth, flowNodeWidthClass, foldSourceConnectorId, foldTargetConnectorId, groupColorClass, groupRect, hasAutoSize, innerNamesOf, insertField, isClipboardPayload, isCustomConditionLogic, isEmptyReferenceFilter, isFieldResource, isFoldReference, isGlobalReference, isNumericType, isPathInside, isTypeCheckedOperator, isUnknownEnumChoiceSetField, isValidFlowName, isValued, loadPathLevel, matchesReferenceFilter, membersInside, moveCondition, moveField, navigatePath, otherSourceFieldsOf, outletByKey, outletsOf, parseCanvasFoldId, parseCanvasGroupId, parseCanvasNodeId, parseFieldPath, parseInvariantNumber, parseSourceConnectorId, parseTargetConnectorId, pathAvailableNames, pathContainerLabel, pathKey, pathNotVerifiableMessage, planPaste, recomputeMembers, referenceRoot, referencedRootsOf, remapConditionLogic, removeCondition, removeField, repeatedFieldNames, repeatingSectionOf, resolvePath, resourceFieldsOf, rewriteReferences, sameMembers, samePath, screenActionNames, screenFieldNames, severityBucket, slugifyFlowName, sourceConnectorId, stageStepNames, stageStepOutputReferenced, stepsOf, targetConnectorId, typeOfCollection, uniqueFlowName, valuedFieldOf, valuedFieldsOf, variantFieldOf, variantOf, variantPresetOf };
+export { ConditionEditorComponent, ConnectorEditorComponent, DebugPanelComponent, DynamicScreenInspectorComponent, ENUM_CHOICE_SET_DEFAULT_DISPLAY_FIELD, ENUM_CHOICE_SET_DEFAULT_VALUE_FIELD, ENUM_CHOICE_SET_FIELDS, ElementDialogComponent, ElementInspectorComponent, ElementPaletteComponent, EnumValuePickerComponent, FALLBACK_COLLECTION_BY_TYPE, FALLBACK_TYPE_LABEL, FLOW_BUILDER_HTTP_CONFIG, FLOW_CLIPBOARD_KIND, FLOW_CLIPBOARD_VERSION, FLOW_ELEMENT_ICONS, FLOW_ELEMENT_VARIANT_FIELDS, FLOW_ELEMENT_VARIANT_ICONS, FLOW_ERROR_FALLBACK_MESSAGE, FLOW_ERROR_HTTP_STATUS, FLOW_FOLD_HEIGHT, FLOW_FOLD_WIDTH, FLOW_GROUP_COLORS, FLOW_NAME_PATTERN, FLOW_NODE_COLLECTIONS, FLOW_NODE_HEIGHT, FLOW_NODE_WIDTH, FLOW_REFERENCE_FIELDS, FLOW_RESOURCE_COLLECTIONS, FLOW_VALUE_FIELDS, FLOW_VALUE_LITERAL_FIELDS, FieldAssignmentEditorComponent, FieldPickerComponent, FieldValuePickerComponent, FlowApiError, FlowBuilderApi, FlowBuilderComponent, FlowCanvasComponent, FlowCatalogStore, FlowClipboardService, FlowDictionaryStore, FlowDocumentStore, FlowEditorSession, FlowLayoutService, FlowValidationStore, FormulaEditorComponent, FormulaValidationService, GROUP_HEADER_HEIGHT, GROUP_MIN_HEIGHT, GROUP_MIN_WIDTH, GROUP_PADDING, GroupPanelComponent, HttpFlowBuilderApi, MergeTextEditorComponent, NamePickerComponent, NodeInspectorBase, ORCHESTRATION_CONDITION_OUTPUT, ObjectPickerComponent, OrchestratedStageInspectorComponent, ParameterEditorComponent, PasteDialogComponent, ProblemsPanelComponent, RecordFilterEditorComponent, ReferencePickerComponent, ResourceDialogComponent, ResourceFormComponent, ResourcePanelComponent, RunDialogComponent, SEVERITY_BUCKETS, SEVERITY_ICON, SEVERITY_LABEL, START_NODE_NAME, SelectValueDirective, StartInspectorComponent, StructureMemberPickerComponent, StructurePickerComponent, TYPES_WITH_AUTOMATIC_OUTPUT, TYPE_BY_COLLECTION, UNSUPPORTED_TYPES, ValueEditorComponent, VersionPanelComponent, allFieldsOf, applyPaste, areTypesComparable, boundsAround, buildClipboardPayload, canvasFoldId, canvasGroupId, canvasNodeId, checkConditionLogic, checkFlowName, choiceSetSourceOf, declaredChoiceSetSources, describeFieldPath, describePathEntry, duplicateField, elementIcon, emptyFlowDefinition, enumChoiceSetFieldType, fieldAt, filterReferences, flattenFields, flowNodeWidth, flowNodeWidthClass, foldSourceConnectorId, foldTargetConnectorId, groupColorClass, groupRect, hasAutoSize, innerNamesOf, insertField, isClipboardPayload, isCustomConditionLogic, isEmptyReferenceFilter, isFieldResource, isFoldReference, isGlobalReference, isNumericType, isPathInside, isTypeCheckedOperator, isUnknownEnumChoiceSetField, isValidFlowName, isValued, isVersionActive, loadPathLevel, matchesReferenceFilter, membersInside, moveCondition, moveField, navigatePath, otherSourceFieldsOf, outletByKey, outletsOf, parseCanvasFoldId, parseCanvasGroupId, parseCanvasNodeId, parseFieldPath, parseInvariantNumber, parseSourceConnectorId, parseTargetConnectorId, pathAvailableNames, pathContainerLabel, pathKey, pathNotVerifiableMessage, planPaste, recomputeMembers, referenceRoot, referencedRootsOf, remapConditionLogic, removeCondition, removeField, repeatedFieldNames, repeatingSectionOf, resolvePath, resourceFieldsOf, rewriteReferences, sameMembers, samePath, screenActionNames, screenFieldNames, severityBucket, slugifyFlowName, sourceConnectorId, stageStepNames, stageStepOutputReferenced, stepsOf, targetConnectorId, typeOfCollection, uniqueFlowName, valuedFieldOf, valuedFieldsOf, variantFieldOf, variantOf, variantPresetOf };
 export type { ChoiceSetSource, FieldAssignmentHolder, FilterFieldOption, FilterHolder, FlowActionCall, FlowAnyNode, FlowAssignment, FlowAssignmentItem, FlowAssignmentOperator, FlowAssignmentOperatorEntry, FlowBuilderHttpConfig, FlowCanvasEdge, FlowCanvasFold, FlowCanvasGroup, FlowCanvasNode, FlowCatalogEntry, FlowCatalogParameter, FlowChoice, FlowClipboardNode, FlowClipboardPayload, FlowClipboardResource, 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, FlowDynamicScreen, FlowEdge, FlowElementType, FlowElementTypeEntry, FlowEnumValue, FlowErrorCategory, FlowExportQuery, FlowFieldDescription, FlowFieldUsage, FlowFieldValue, FlowFormKind, FlowFormula, FlowFormulaFunction, FlowFormulaFunctionParameter, FlowFormulaIssue, FlowFormulaUsage, FlowFormulaValidationRequest, FlowFormulaValidationResult, FlowGlobalVariableEntry, FlowGroup, FlowGroupRef, FlowGroupTarget, FlowInputFieldAssignment, FlowInputParameter, FlowInterviewResult, FlowInterviewStatus, FlowIssueSeverity, FlowLayoutDirection, FlowLayoutNodeInput, FlowLayoutOptions, FlowLayoutResult, FlowListQuery, FlowLoop, FlowNameCheck, FlowNameProblem, FlowNewVersionRequest, FlowNodeBase, FlowNodeCollection, FlowNodeRef, FlowObjectDescription, FlowObjectSummary, FlowOffsetUnit, FlowOrchestratedStage, FlowOutlet, FlowOutline, FlowOutlineConnection, FlowOutlineGroup, FlowOutlineNode, FlowOutputFieldAssignment, FlowOutputParameter, FlowPalettePick, FlowPastePlan, FlowPasteRename, FlowPasteResource, FlowPendingScreen, FlowProcessType, FlowRecordCreate, FlowRecordDelete, FlowRecordFilter, FlowRecordFilterOperator, FlowRecordLookup, FlowRecordRollback, FlowRecordTriggerType, FlowRecordUpdate, FlowRecordValue, FlowRect, FlowReference, FlowReferenceFilter, FlowReferenceKind, FlowRegionContainerType, FlowResourceCollection, FlowResourceEdit, FlowResourceKindEntry, FlowResourceRef, FlowResourceTarget, FlowResumeRequest, FlowRunOutcome, FlowRunRequest, FlowSaveRequest, FlowSaveResult, FlowSchedule, FlowScheduledPath, FlowScreen, FlowScreenAction, FlowScreenField, FlowScreenFieldInputsRevisited, FlowScreenFieldNode, FlowScreenFieldPath, FlowScreenFieldType, FlowScreenFieldTypeEntry, FlowScreenFieldTypeResolver, FlowScreenNavigation, FlowScreenResponseRequest, FlowScreenTrigger, FlowScreenTriggerInitBehavior, FlowScreenValidationRule, 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, PathValueSet, StructureMemberUsage, ValueMode };

package/package.json

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