@esfaenza/flow-builder 20.3.39 → 20.3.40

package/index.d.ts

@@ -1124,8 +1124,13 @@ interface FlowValidationResult {
 /**
  * Dove comparira' l'espressione. Non e' cosmesi: e' cio' che permette al motore di dire
  * «qui serve un booleano» invece di accettare un'espressione che poi fallira' a runtime (§6.3).
+ *
+ * `Text` e' l'uso diverso dagli altri: cio' che si manda non e' un'espressione ma un **testo con
+ * merge field** — il messaggio di un Custom Error, un text template, la scritta di un campo di
+ * screen (§5.12) — e a essere verificate sono le isole `{!...}`, non la frase. Un testo che non
+ * ne contiene si tiene per se': mandarlo si farebbe accusare ogni parola.
  */
-type FlowFormulaUsage = 'Resource' | 'Condition' | 'ValidationRule' | 'Value' | string;
+type FlowFormulaUsage = 'Resource' | 'Condition' | 'ValidationRule' | 'Value' | 'Text' | string;
 /**
  * L'unica primitiva della §6.3 che **avvolge** il documento invece di prenderlo nudo: oltre al
  * flow deve portare l'espressione e cosa ci si aspetta che produca (§6.4, ultimo capoverso).
@@ -2523,7 +2528,14 @@ declare class FlowDictionaryStore {
      * significa "non lo so", non "non esiste".
      */
     isGlobalScopeVerifiable(scope: string | undefined | null): boolean;
-    /** I percorsi noti di uno scope, già prefissati: `$User.Email`. */
+    /**
+     * I percorsi noti di uno scope, già prefissati: `$User.Email`.
+     *
+     * Il percorso **vuoto** e' lo scope stesso (§4.1): un host puo' dichiarare `$Profile` senza
+     * punto — un'unica istanza invece dell'elenco dei suoi campi — e lì il riferimento e' il nome
+     * dello scope. Concatenare comunque il punto produrrebbe `$Profile.`, che non e' un
+     * riferimento di niente.
+     */
     globalPathsOf(scope: string | undefined | null): string[];
     /** §5.14 — la voce di `stageStepTypes` di un `actionType`. */
     stageStepType(value: string | undefined | null): FlowStageStepTypeEntry | undefined;
@@ -5246,7 +5258,7 @@ declare class ConditionEditorComponent {
      */
     hasTypeMismatch(condition: FlowCondition): boolean;
     typeMismatchMessage(condition: FlowCondition): string;
-    readonly logicMode: _angular_core.Signal<"formula" | "and" | "or" | "custom">;
+    readonly logicMode: _angular_core.Signal<"and" | "or" | "formula" | "custom">;
     readonly customLogic: _angular_core.Signal<string>;
     /** Feedback immediato sull'espressione: la verita' resta della validazione backend. */
     readonly customLogicError: _angular_core.Signal<string | null>;
@@ -5351,7 +5363,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<"formula" | "and" | "or" | "custom">;
+    readonly logicMode: _angular_core.Signal<"and" | "or" | "formula" | "custom">;
     readonly customLogic: _angular_core.Signal<string>;
     readonly showEmptyWarning: _angular_core.Signal<boolean>;
     addFilter(): void;
@@ -5513,6 +5525,107 @@ declare class ConnectorEditorComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ConnectorEditorComponent, "fb-connector-editor", never, { "nodeName": { "alias": "nodeName"; "required": true; "isSignal": true; }; "node": { "alias": "node"; "required": true; "isSignal": true; }; "outlets": { "alias": "outlets"; "required": true; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; }, { "connectorChanged": "connectorChanged"; }, never, never, true, never>;
 }
 
+declare class MergeTextEditorComponent {
+    private readonly store;
+    private readonly api;
+    private readonly service;
+    private readonly destroyRef;
+    readonly text: _angular_core.InputSignal<string>;
+    /**
+     * Dove comparira'. Resta un input perche' un motore puo' distinguere il messaggio di un errore
+     * dalla scritta di un campo, ma il valore giusto e' quasi sempre quello predefinito.
+     */
+    readonly usage: _angular_core.InputSignal<string>;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    readonly ariaLabel: _angular_core.InputSignal<string>;
+    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 textChange: _angular_core.OutputEmitterRef<string>;
+    private readonly area;
+    /**
+     * Il testo che si sta scrivendo. Non e' legato al DOM — la casella tiene il suo valore e la
+     * `[value]` resta quella del documento — perche' riscrivere l'attributo a ogni tasto sposta il
+     * cursore quando si corregge in mezzo alla frase.
+     */
+    private readonly draft;
+    private readonly _result;
+    private readonly _isChecking;
+    private timer?;
+    /** Cresce a ogni richiesta: scarta le risposte di verifiche già superate. */
+    private sequence;
+    readonly result: _angular_core.Signal<FlowFormulaValidationResult | null>;
+    readonly isChecking: _angular_core.Signal<boolean>;
+    private readonly references;
+    /** Il documento per cui l'elenco e' stato chiesto: evita una richiesta a ogni apertura. */
+    private loadedFor;
+    protected readonly isPickerOpen: _angular_core.WritableSignal<boolean>;
+    protected readonly filter: _angular_core.WritableSignal<string>;
+    /**
+     * Cio' che si sta scrivendo **dentro** un'isola aperta, se il cursore ci sta dentro: e' la
+     * seconda strada per inserire un nome, e la piu' rapida — chi ha scritto `{!Ord` non va a
+     * cercare un bottone.
+     */
+    private readonly token;
+    protected readonly highlighted: _angular_core.WritableSignal<number>;
+    readonly suggestions: _angular_core.Signal<FlowReference[]>;
+    /** L'elenco del bottone: tutti i nomi, filtrati dalla ricerca. */
+    readonly pickerOptions: _angular_core.Signal<FlowReference[]>;
+    /** Un testo senza segnaposto non si manda: non c'e' niente da verificare (§5.12). */
+    readonly hasMergeFields: _angular_core.Signal<boolean>;
+    readonly issues: _angular_core.Signal<FlowFormulaIssue[]>;
+    readonly hasErrors: _angular_core.Signal<boolean>;
+    readonly isConfirmed: _angular_core.Signal<boolean>;
+    /** Il motore c'e' come primitiva ma non come motore: si dice, non si tace (§6.3). */
+    readonly isUnverified: _angular_core.Signal<boolean>;
+    constructor();
+    onInput(value: string): void;
+    onCommit(value: string): void;
+    onFocus(): void;
+    onCaretMove(): void;
+    onBlur(): void;
+    /**
+     * Le frecce scorrono i suggerimenti e Invio inserisce — ma **solo** quando ce ne sono: in un
+     * testo Invio deve restare Invio, che qui e' un a capo dentro il messaggio.
+     */
+    onKeyDown(event: KeyboardEvent): void;
+    togglePicker(): void;
+    /**
+     * Il bottone: scrive un'isola **intera** al punto del cursore, graffe comprese. Inserire il
+     * solo nome lascerebbe all'utente il compito di ricordarsi la sintassi, che e' esattamente
+     * cio' che il comando esiste per evitare.
+     */
+    insertReference(name: string): void;
+    /**
+     * Il suggerimento dentro un'isola aperta: **completa** il nome e chiude la graffa.
+     *
+     * Non e' {@link insertReference}, ed e' la distinzione da non perdere: lì si scrive un'isola
+     * nuova al punto del cursore, qui si sta già scrivendo dentro una — passare per l'altra strada
+     * produce `{!IdOr{!IdOrdine}`, cioe' due aperture e un segnaposto che non si risolve.
+     */
+    complete(name: string): void;
+    /** Scrive nella casella e propaga: la casella e' la sorgente del testo mentre si digita. */
+    private write;
+    private loadReferences;
+    /**
+     * La parola sotto il cursore, **solo dentro un'isola aperta**: fuori dalle graffe si sta
+     * scrivendo una frase, e proporre nomi di variabili a ogni parola sarebbe rumore.
+     */
+    private refreshToken;
+    severityOf(issue: FlowFormulaIssue): string;
+    hasPosition(issue: FlowFormulaIssue): boolean;
+    /** Il tratto citato dal rilievo, così il messaggio dice *dove* anche senza il salto. */
+    excerptOf(issue: FlowFormulaIssue): string;
+    /** Porta il cursore sul tratto segnalato: e' il payoff di `position`. */
+    goToIssue(issue: FlowFormulaIssue): void;
+    private schedule;
+    private cancel;
+    private check;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MergeTextEditorComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MergeTextEditorComponent, "fb-merge-text-editor", never, { "text": { "alias": "text"; "required": false; "isSignal": true; }; "usage": { "alias": "usage"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "commitOn": { "alias": "commitOn"; "required": false; "isSignal": true; }; }, { "textChange": "textChange"; }, never, ["*"], true, never>;
+}
+
 /**
  * `@Directive()` senza selettore: e' il modo in cui Angular riconosce come input quelli
  * dichiarati su una classe base ereditata da piu' componenti.
@@ -7110,5 +7223,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, 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, resolvePath, 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, 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, resolvePath, 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, 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.39",
+  "version": "20.3.40",
   "peerDependencies": {
     "@angular/cdk": "^20.2.14",
     "@angular/common": "^20.3.28",