@esfaenza/dpe-builder 20.3.7 → 20.3.8

package/index.d.ts

@@ -1470,7 +1470,20 @@ declare function dpeWriteNodePosition<TNode extends DpeAnyNode>(node: TNode, pos
 /** Vero quando **tutti** i nodi hanno una posizione: se no, il canvas rifa' il layout. */
 declare function dpeHasCompleteLayout(nodes: readonly DpeAnyNode[]): boolean;
 
-/** Una definizione vuota ma **leggibile**: `formatVersion` e `dialect` non sono opzionali. */
+/**
+ * Una definizione vuota ma **leggibile**: `formatVersion` e `dialect` non sono opzionali.
+ *
+ * **Serve a `createDefinition`, non a montare l'editor.** E' il documento minimo che si manda al
+ * backend per far nascere una definizione nel catalogo (ADR 0019), e da li' in poi quella che si
+ * edita e' la definizione **caricata con `load(nome)`**.
+ *
+ * Montare l'editor su un documento costruito qui, o su uno costruito a mano senza nome, produce due
+ * sintomi che sembrano scollegati e sono la stessa cosa: la validazione risponde
+ * `DPE_MODEL_REQUIRED_MISSING` su `name` e `label` — per il backend una stringa vuota e un campo
+ * assente sono lo stesso caso — e il salvataggio non ha una chiave per la rotta
+ * `PUT /definitions/{name}`. L'editor lo dichiara in cima con un banner e disabilita «Salva», ma la
+ * correzione e' a monte: creare dal catalogo e caricare.
+ */
 declare function dpeEmptyDefinition(name: string, label: string, dialect: SqlDialectKind): DpeDefinition;
 declare class DpeDocumentStore {
     private readonly _definition;
@@ -1483,6 +1496,16 @@ declare class DpeDocumentStore {
      * sulla selezione.
      */
     private readonly _selectedNodeNames;
+    /**
+     * La dialog di modifica del nodo e' aperta. **Un booleano**, non un secondo nome di nodo: il
+     * nodo su cui si sta agendo resta `selectedNodeName()`, e due registrazioni dello stesso fatto
+     * sono esattamente cio' che questo store dichiara di non voler avere (ci ha gia' rimesso una
+     * volta con la doppia selezione di @foblex/flow).
+     *
+     * Non entra nella cronologia: aprire una finestra non e' una modifica del documento, e un undo
+     * che aprisse o chiudesse finestre sarebbe un comando che fa due cose.
+     */
+    private readonly _isNodeEditorOpen;
     private readonly _past;
     private readonly _future;
     /**
@@ -1493,8 +1516,18 @@ declare class DpeDocumentStore {
      * — e tornare a "no" quando si annulla fino allo stato di partenza.
      */
     private readonly _savedSnapshot;
+    /**
+     * Vero da quando un documento e' stato **caricato**. Distingue il segnaposto del costruttore da
+     * una definizione vera, e serve a chi non deve lavorare sul segnaposto: la validazione non lo
+     * manda al backend (`DpeValidationService`), perche' la risposta sarebbero i quattro rilievi di
+     * una definizione vuota — `name`, `label`, `dataSources` e nessun writeback — che descrivono il
+     * segnaposto e non il lavoro dell'utente, e che dall'editor nessuno puo' correggere.
+     */
+    private readonly _hasDocument;
     /** La definizione corrente: unica fonte di verita' per canvas, ispettori e pannelli. */
     readonly definition: _angular_core.Signal<DpeDefinition>;
+    /** Vero da quando `load` ha portato un documento: prima c'e' solo il segnaposto. */
+    readonly hasDocument: _angular_core.Signal<boolean>;
     /** Nodi e archi derivati dalla definizione. Ricalcolati solo quando la definizione cambia. */
     readonly graph: _angular_core.Signal<DpeGraph>;
     readonly selectedNodeNames: _angular_core.Signal<readonly string[]>;
@@ -1506,6 +1539,11 @@ declare class DpeDocumentStore {
      */
     readonly selectedNodeName: _angular_core.Signal<string | undefined>;
     readonly selectedNode: _angular_core.Signal<DpeAnyNode | undefined>;
+    /**
+     * La dialog di modifica del nodo e' aperta. Non e' una seconda identita': il nodo e'
+     * `selectedNodeName()`.
+     */
+    readonly isNodeEditorOpen: _angular_core.Signal<boolean>;
     readonly validateResult: _angular_core.Signal<DpeValidateResult | undefined>;
     readonly compileResult: _angular_core.Signal<DpeCompileResult | undefined>;
     readonly diagnostics: _angular_core.Signal<readonly Diagnostic[]>;
@@ -1564,6 +1602,19 @@ declare class DpeDocumentStore {
     select(nodeName: string | undefined): void;
     /** Selezione multipla (riquadro, `Ctrl+A`): la lista che arriva dal gesto, senza duplicati. */
     selectMany(nodeNames: readonly string[]): void;
+    /**
+     * Seleziona **solo** quel nodo e apre la dialog di modifica.
+     *
+     * La selezione **collassa a un nodo solo**: il gesto «apri questo» dichiara su chi si sta
+     * agendo, e la regola gia' in vigore e' che con piu' di un nodo selezionato non si mostrano i
+     * campi di uno.
+     *
+     * Le due scritture sono **esplicite** e non conseguenza di un `effect`: un effect che scrive
+     * signal renderebbe l'ordine di questi due fatti dipendente dalla schedulazione, cioe' non
+     * testabile.
+     */
+    openNodeEditor(nodeName: string): void;
+    closeNodeEditor(): void;
     /**
      * Proprieta' della radice: etichetta, descrizione, dialetto, parametri.
      *
@@ -1963,6 +2014,8 @@ declare class DpeBuilderComponent {
     protected readonly documentProblem: Signal<string | undefined>;
     protected readonly canSave: Signal<boolean>;
     protected readonly nodeCount: Signal<number>;
+    /** I nomi selezionati: la striscia contestuale compare da due in su. */
+    protected readonly selectedNames: Signal<readonly string[]>;
     constructor();
     /** Comando «Riordina»: e' un'azione dell'utente, quindi annullabile e "modifica". */
     protected runAutoLayout(): void;
@@ -1977,6 +2030,21 @@ declare class DpeBuilderComponent {
         x: number;
         y: number;
     }): void;
+    /**
+     * Doppio clic sul nodo, o bottone `✎` sulla card: i due gesti che il canvas emetteva su
+     * `nodeOpened` e che **nessuno ascoltava** — il bottone non produceva nemmeno la selezione.
+     *
+     * Due cose, in quest'ordine. Si apre la dialog (che collassa la selezione a quel nodo) e si
+     * **inquadra** il nodo: sotto il velo non si vede, ma alla chiusura si torna guardando il nodo su
+     * cui si e' lavorato invece del punto dov'era il grafo prima.
+     */
+    protected onNodeOpened(name: string): void;
+    /**
+     * Elimina i nodi selezionati (striscia della selezione multipla). Si itera su una **copia** dei
+     * nomi: `removeNode` pota la selezione a ogni giro, e scorrere il signal mentre lo si svuota
+     * salterebbe la meta' dei nodi.
+     */
+    protected removeSelectedNodes(): void;
     /** Clic sulla palette (via tastiera compresa): il nodo nasce in un punto libero e prevedibile. */
     protected onNodeRequested(collection: DpeNodeCollectionName): void;
     /**
@@ -2295,29 +2363,70 @@ declare class DpeNodePaletteComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DpeNodePaletteComponent, "dpe-node-palette", never, {}, { "nodeRequested": "nodeRequested"; }, never, never, true, never>;
 }
 
-declare class DpeNodeInspectorComponent {
-    private readonly store;
+declare class DpeNodeDialogComponent {
+    protected readonly store: DpeDocumentStore;
+    private readonly dialogRef;
+    protected readonly labelId: string;
+    /**
+     * Il nodo corrente, **riderivato** dallo store come fa il dispatcher degli ispettori. Non si
+     * conserva il nome: se il nodo viene rinominato, `selectedNodeName()` porta gia' il nome nuovo.
+     */
+    protected readonly located: _angular_core.Signal<_esfaenza_dpe_builder.DpeLocatedNode<keyof _esfaenza_dpe_builder.DpeNodeCollectionMap> | undefined>;
+    protected readonly categoryLabel: _angular_core.Signal<string>;
+    protected readonly familyClass: _angular_core.Signal<string>;
     /**
-     * Il riordino richiede le misure delle card, che le conosce il canvas: l'ispettore **chiede**,
-     * non calcola. Componente stupido, orchestrazione fuori.
+     * Vero quando il fondo ha ricevuto il `pointerdown` di questo clic. Vedi `onDialogClick`: la
+     * verifica di coppia non e' prudenza, e' la correzione di un difetto reale.
      */
-    readonly layoutRequested: _angular_core.OutputEmitterRef<void>;
-    readonly selectedNames: _angular_core.Signal<readonly string[]>;
+    private pointerDownWasOnBackdrop;
+    constructor();
+    /**
+     * **Esc.** Il browser chiede di chiudere e la finestra e' ancora aperta: la richiesta riguarda
+     * per definizione la sessione corrente, quindi si chiude e non serve nessuna verifica.
+     *
+     * Perche' `cancel` e' legato, contro cio' che sembra sufficiente: in Chrome 151 l'evento `close`
+     * **arriva molto in ritardo** (vedi `onClose`), quindi con il solo `close` lo store restava
+     * «aperta» dopo Esc — e il sintomo era che **riaprire lo stesso nodo non faceva niente**: il
+     * signal non cambiava, l'effect non rieseguiva, `showModal()` non veniva mai chiamato. Sul
+     * bottone del piede non si vedeva, perche' quella via passa dallo store.
+     *
+     * `cancel` sarebbe annullabile: non si annulla. La chiusura dell'elemento arriva comunque dal
+     * browser, e la guardia su `el.open` nell'effect regge in entrambi gli ordini.
+     */
+    protected onCancel(): void;
+    /**
+     * **L'elemento si e' chiuso.** La guardia non e' prudenza: Chrome accoda `close` come task
+     * dell'elemento e lo consegna anche **dopo** una riapertura — misurato nella demo, la traccia
+     * degli eventi mostra `close` con `open: true` subito dopo un `showModal()`. Senza la guardia
+     * quel `close` in ritardo chiudeva la finestra appena aperta, e il sintomo era una dialog che
+     * «non si apre a volte»: sparisce da sola dopo essere comparsa, e con la finestra aperta si
+     * riapriva solo alla prima modifica del documento (l'unica cosa che faceva rieseguire l'effect).
+     *
+     * Se l'elemento risulta **aperto**, questo `close` riguarda una sessione precedente e si ignora.
+     * Se risulta chiuso, la notifica e' di questa sessione — e allineare qui lo store e' anche cio'
+     * che ripara una divergenza, se il browser chiudesse la finestra per vie sue.
+     */
+    protected onClose(): void;
+    protected onPointerDown(event: Event): void;
+    /**
+     * Chiusura al clic sul fondo, con la **verifica di coppia** e non con il solo controllo sul
+     * click. I clic sul velo sono recapitati all'elemento `<dialog>` stesso — ma anche un
+     * trascinamento di selezione del testo che **inizia** dentro una casella e **finisce** fuori
+     * produce un `click` con `target` uguale alla dialog. Con la sola verifica sul click, selezionare
+     * del testo chiuderebbe la finestra.
+     */
+    protected onDialogClick(event: Event): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DpeNodeDialogComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DpeNodeDialogComponent, "dpe-node-dialog", never, {}, {}, never, never, true, never>;
+}
+
+declare class DpeNodeInspectorComponent {
+    private readonly store;
     readonly located: _angular_core.Signal<_esfaenza_dpe_builder.DpeLocatedNode<keyof _esfaenza_dpe_builder.DpeNodeCollectionMap> | undefined>;
     readonly nameDraft: _angular_core.WritableSignal<string>;
-    readonly categoryLabel: _angular_core.Signal<string>;
-    /** La classe di famiglia dell'icona: la stessa funzione che usano palette e canvas. */
-    readonly familyClass: _angular_core.Signal<string>;
-    readonly columns: _angular_core.Signal<_esfaenza_dpe_builder.DpeColumnInfo[]>;
-    readonly diagnostics: _angular_core.Signal<_esfaenza_dpe_builder.Diagnostic[]>;
     readonly referenceCount: _angular_core.Signal<number>;
     readonly canRename: _angular_core.Signal<boolean>;
     constructor();
-    /**
-     * Elimina i nodi selezionati. Si itera su una **copia** dei nomi: `removeNode` pota la selezione
-     * a ogni giro, e scorrere il signal mentre lo si svuota salterebbe la meta' dei nodi.
-     */
-    protected removeSelected(): void;
     protected rename(currentName: string): void;
     protected setCommon(field: 'label' | 'description', value: string): void;
     protected valueOf(event: Event): string;
@@ -2333,7 +2442,31 @@ declare class DpeNodeInspectorComponent {
     protected asWriteback(node: unknown): WritebackNode;
     protected asAtomic(node: unknown): AtomicWritebackNode;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DpeNodeInspectorComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DpeNodeInspectorComponent, "dpe-node-inspector", never, {}, { "layoutRequested": "layoutRequested"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DpeNodeInspectorComponent, "dpe-node-inspector", never, {}, {}, never, never, true, never>;
+}
+
+declare class DpeNodeFactsComponent {
+    private readonly store;
+    /**
+     * Il nodo di cui si mostrano i fatti. Arriva per input e non dalla selezione: chi monta questo
+     * componente sa quale nodo sta guardando, e leggere qui la selezione lo farebbe cambiare
+     * bersaglio sotto la dialog che lo contiene.
+     */
+    readonly nodeName: _angular_core.InputSignal<string>;
+    /**
+     * Il nodo e' valido ma **non compilabile** (**I10**). Due rami, ed e' la **stessa espressione**
+     * che `DpeNodeInspectorBase.isNotCompilable` usa gia': il codice diagnostico
+     * `DPE_NODE_NOT_COMPILABLE` raggruppato per nodo, **oppure** lo schema che dichiara
+     * `isCompilable: false`. Servono entrambi perche' il backend puo' dirlo per due vie — un rilievo
+     * sul nodo, o la riga di schema — e riconoscerne una sola vorrebbe dire tacere nell'altro caso.
+     *
+     * Qui non si giudica niente: la decisione e' del compilatore, questa e' la sua risposta.
+     */
+    readonly isNotCompilable: _angular_core.Signal<boolean>;
+    readonly columns: _angular_core.Signal<_esfaenza_dpe_builder.DpeColumnInfo[]>;
+    readonly diagnostics: _angular_core.Signal<_esfaenza_dpe_builder.Diagnostic[]>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DpeNodeFactsComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DpeNodeFactsComponent, "dpe-node-facts", never, { "nodeName": { "alias": "nodeName"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare abstract class DpeNodeInspectorBase<TNode extends DpeAnyNode = DpeAnyNode> {
@@ -2503,5 +2636,5 @@ declare class DpeNodeIconComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DpeNodeIconComponent, "dpe-node-icon", never, { "collection": { "alias": "collection"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-export { DPE_API_ERROR_FALLBACK_MESSAGE, DPE_BUILDER_HTTP_CONFIG, DPE_DIALECT_LABELS, DPE_LAYOUT_KEY, DPE_NODE_CATEGORIES, DPE_NODE_COLLECTIONS, DPE_NODE_HEIGHT, DPE_NODE_ICON_PATHS, DPE_NODE_NOT_COMPILABLE, DPE_SOURCE_SLOTS, DpeApiError, DpeBuilderApi, DpeBuilderComponent, DpeCanvasComponent, DpeCatalogComponent, DpeCatalogStore, DpeColumnTypeEditorComponent, DpeDiagnosticsPanelComponent, DpeDocumentStore, DpeExpressionEditorComponent, DpeLayoutService, DpeMetadataStore, DpeNodeIconComponent, DpeNodeInspectorBase, DpeNodeInspectorComponent, DpeNodePaletteComponent, DpeSchemaPanelComponent, DpeSelectValueDirective, DpeSqlPreviewComponent, DpeValidationService, HttpDpeBuilderApi, diagnosticPathToString, dpeAllNodes, dpeBuildGraph, dpeCountReferences, dpeCreateCommandAvailability, dpeCreateNode, dpeDefinitionLevelDiagnostics, dpeDiagnosticField, dpeDiagnosticLocationLabel, dpeDiagnosticNodeName, dpeEdgeId, dpeEmptyDefinition, dpeFindNode, dpeGroupDiagnosticsByNode, dpeHasCompleteLayout, dpeInputPortId, dpeInputPorts, dpeIsDialectDiagnostic, dpeIsNotCompilable, dpeIsPrimitiveAvailable, dpeIsRectFullyVisible, dpeKnownNodeNames, dpeNodeCategory, dpeNodeIconFamily, dpeNodeIconFamilyClass, dpeNodeIconPaths, dpeNodeId, dpeNodeSourceReferences, dpeNodeSubtitle, dpeNodeWidth, dpeNodeWidthClass, dpeOutputPortId, dpeParseInputPortId, dpeParseNodeId, dpeParseOutputPortId, dpeProposeNodeName, dpeProposeWritebackSequence, dpeReadCapabilities, dpeReadNodePosition, dpeRenameNode, dpeWorstSeverity, dpeWriteNodePosition, dpeWriteSourceReference, provideDpeBuilderHttpApi };
+export { DPE_API_ERROR_FALLBACK_MESSAGE, DPE_BUILDER_HTTP_CONFIG, DPE_DIALECT_LABELS, DPE_LAYOUT_KEY, DPE_NODE_CATEGORIES, DPE_NODE_COLLECTIONS, DPE_NODE_HEIGHT, DPE_NODE_ICON_PATHS, DPE_NODE_NOT_COMPILABLE, DPE_SOURCE_SLOTS, DpeApiError, DpeBuilderApi, DpeBuilderComponent, DpeCanvasComponent, DpeCatalogComponent, DpeCatalogStore, DpeColumnTypeEditorComponent, DpeDiagnosticsPanelComponent, DpeDocumentStore, DpeExpressionEditorComponent, DpeLayoutService, DpeMetadataStore, DpeNodeDialogComponent, DpeNodeFactsComponent, DpeNodeIconComponent, DpeNodeInspectorBase, DpeNodeInspectorComponent, DpeNodePaletteComponent, DpeSchemaPanelComponent, DpeSelectValueDirective, DpeSqlPreviewComponent, DpeValidationService, HttpDpeBuilderApi, diagnosticPathToString, dpeAllNodes, dpeBuildGraph, dpeCountReferences, dpeCreateCommandAvailability, dpeCreateNode, dpeDefinitionLevelDiagnostics, dpeDiagnosticField, dpeDiagnosticLocationLabel, dpeDiagnosticNodeName, dpeEdgeId, dpeEmptyDefinition, dpeFindNode, dpeGroupDiagnosticsByNode, dpeHasCompleteLayout, dpeInputPortId, dpeInputPorts, dpeIsDialectDiagnostic, dpeIsNotCompilable, dpeIsPrimitiveAvailable, dpeIsRectFullyVisible, dpeKnownNodeNames, dpeNodeCategory, dpeNodeIconFamily, dpeNodeIconFamilyClass, dpeNodeIconPaths, dpeNodeId, dpeNodeSourceReferences, dpeNodeSubtitle, dpeNodeWidth, dpeNodeWidthClass, dpeOutputPortId, dpeParseInputPortId, dpeParseNodeId, dpeParseOutputPortId, dpeProposeNodeName, dpeProposeWritebackSequence, dpeReadCapabilities, dpeReadNodePosition, dpeRenameNode, dpeWorstSeverity, dpeWriteNodePosition, dpeWriteSourceReference, provideDpeBuilderHttpApi };
 export type { AggregateField, AggregateFunction, AggregateNode, AppendNode, AtomicWritebackNode, AtomicWritebackRelationship, ColumnType, CsvArtifactOptions, CsvDelimiter, CsvSourceOptions, CustomNode, CustomNodeParameter, DataSourceField, DataSourceKind, DataSourceNode, DatePart, DeclaredField, DefinitionRunMode, DefinitionStatus, Diagnostic, DiagnosticPath, DiagnosticPathSegment, DiagnosticSeverity, DpeAnyNode, DpeApiErrorCategory, DpeBuilderHttpConfig, DpeCanvasEdge, DpeCanvasNode, DpeCanvasPort, DpeCapabilities, DpeColumnInfo, DpeCommandAvailability, DpeCompileResult, DpeCompiledWriteback, DpeDefinition, DpeDefinitionSummary, DpeEnvironment, DpeExtensible, DpeExtensionData, DpeFieldMappingInfo, DpeGraph, DpeGraphEdge, DpeGraphNode, DpeInputPort, DpeLayoutDirection, DpeLayoutEdgeInput, DpeLayoutNodeInput, DpeLayoutOptions, DpeLayoutPosition, DpeLocatedNode, DpeNode, DpeNodeCategory, DpeNodeCollectionMap, DpeNodeCollectionName, DpeNodeDiagnostics, DpeNodeIconFamily, DpeNodePaletteGroup, DpeNodePosition, DpeNodeSchemaInfo, DpeOptionalPrimitive, DpeParameter, DpeParameterValue, DpeRect, DpeSourceReference, DpeSourceSlot, DpeTableState, DpeValidateResult, DpeWritebackStep, ExpressionField, FieldDescriptor, FieldRelationship, FilterCriterion, FilterNode, FilterOperator, ForecastAccuracy, ForecastAggregationField, ForecastGroupField, ForecastModelType, ForecastNode, ForecastPeriodType, HierarchyPathNode, JoinKey, JoinKind, JoinNode, JoinResultField, JsonArtifactOptions, LogicalType, OrderByField, ParameterRole, SortDirection, SqlDialectKind, SqlParameterValue, SqlStatement, TableDescriptor, TableLookupOutcome, TableLookupResult, TableSummary, TransformKind, TransformNode, WritebackFieldMapping, WritebackFieldRole, WritebackNode, WritebackOperation, WritebackTargetKind };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esfaenza/dpe-builder",
-  "version": "20.3.7",
+  "version": "20.3.8",
   "peerDependencies": {
     "@angular/cdk": "^20.2.14",
     "@angular/common": "^20.3.25",