@memberjunction/ng-dashboards 5.22.0 → 5.24.0

package/dist/KnowledgeHub/components/clusters/cluster-visualization-resource.component.d.ts

@@ -0,0 +1,140 @@
+/**
+ * @fileoverview Knowledge Hub Clusters Dashboard Tab
+ *
+ * Full-page cluster visualization with:
+ * - Left sidebar: saved cluster visualizations (persisted via UserInfoEngine)
+ * - Main area: SVG scatter plot (mj-cluster-scatter)
+ * - Floating config panel (mj-cluster-config-panel)
+ * - Top metrics bar
+ *
+ * Registered as BaseResourceComponent for the Knowledge Hub application.
+ */
+import { OnDestroy, AfterViewInit } from '@angular/core';
+import { ResourceData } from '@memberjunction/core-entities';
+import { BaseResourceComponent } from '@memberjunction/ng-shared';
+import { ClusterConfig, ClusterConfigPanelEntityOption, ClusterConfigPanelEntityDocOption, ClusterVisualizationResult, ClusterMetrics, ClusterPoint, ClusterLabel, SavedClusterVisualization } from '@memberjunction/ng-clustering';
+import { ClusterScatterComponent } from '@memberjunction/ng-clustering';
+import * as i0 from "@angular/core";
+export declare class ClusterVisualizationResourceComponent extends BaseResourceComponent implements AfterViewInit, OnDestroy {
+    scatterPlot?: ClusterScatterComponent;
+    private cdr;
+    private clusteringService;
+    private navigationService;
+    private destroy$;
+    /** LLM-generated cluster labels for the current result */
+    ClusterLabels: ClusterLabel[];
+    GetResourceDisplayName(_data: ResourceData): Promise<string>;
+    GetResourceIconClass(_data: ResourceData): Promise<string>;
+    /** Current visualization result */
+    Result: ClusterVisualizationResult | null;
+    /** Whether a clustering run is in progress */
+    IsRunning: boolean;
+    /** The active cluster config */
+    ActiveConfig: ClusterConfig;
+    /** Title for the top bar */
+    VisualizationTitle: string;
+    /** Entity options for the config panel dropdown */
+    EntityOptions: ClusterConfigPanelEntityOption[];
+    /** Entity document options for the selected entity (shown when 2+) */
+    EntityDocOptions: ClusterConfigPanelEntityDocOption[];
+    /** Ordered field keys for prioritized display in scatter tooltip/detail */
+    FieldPriority: string[];
+    /** Map of field names to human-readable display names */
+    FieldDisplayNames: Record<string, string>;
+    SavedVisualizations: SavedClusterVisualization[];
+    ActiveSavedId: string | null;
+    private userSettingEntity;
+    ngAfterViewInit(): Promise<void>;
+    ngOnDestroy(): void;
+    get Metrics(): ClusterMetrics | null;
+    get HasResult(): boolean;
+    get SilhouetteScoreFormatted(): string;
+    get IsSilhouetteGood(): boolean;
+    get ComputationTimeFormatted(): string;
+    /** Handle "Run Clustering" from the config panel */
+    OnRunClustering(config: ClusterConfig): Promise<void>;
+    /** Handle point click — log for now */
+    OnPointClicked(_point: ClusterPoint): void;
+    /** Handle point hover */
+    OnPointHovered(_point: ClusterPoint | null): void;
+    /** Navigate to the entity record when "Open Record" is clicked in the detail panel */
+    OnOpenRecord(point: ClusterPoint): void;
+    /** Save the current visualization */
+    OnSaveVisualization(): Promise<void>;
+    /** Select a saved visualization — restore from cache if available, otherwise re-run */
+    OnSelectSaved(saved: SavedClusterVisualization): Promise<void>;
+    /** Delete a saved visualization */
+    OnDeleteSaved(saved: SavedClusterVisualization, event: MouseEvent): Promise<void>;
+    /** Start a new analysis (clear current) */
+    OnNewAnalysis(): void;
+    IsActiveSaved(saved: SavedClusterVisualization): boolean;
+    TrackSavedBy(_index: number, saved: SavedClusterVisualization): string;
+    FormatDate(iso: string): string;
+    /** Populate the entity options for the config panel dropdown */
+    private loadEntityOptions;
+    /** Update entity document options when the selected entity changes */
+    private updateEntityDocOptions;
+    /**
+     * Fetch vectors from Entity Document Runs via RunView.
+     * Entity Documents store vectorized entity data; we query for runs
+     * that match the requested entity.
+     */
+    private fetchVectorsForEntity;
+    /** Parse the JSON metadata string from the vector DB into a record */
+    private parseVectorMetadata;
+    /**
+     * Build a human-readable label from vector metadata using entity field metadata.
+     * Combines all IsNameField fields in Sequence order (e.g., "Sarah Chen" from FirstName + LastName).
+     * Falls back to heuristic field detection when entity metadata isn't available.
+     */
+    private buildLabel;
+    /**
+     * After clustering completes, send sample records per cluster to an LLM for naming.
+     * Updates ClusterLabels and refreshes the view.
+     */
+    private requestClusterLabelsFromLLM;
+    /** Build a text block describing sample records per cluster for the LLM prompt */
+    private buildClusterDataForPrompt;
+    /**
+     * Handle inline label edits from the scatter component legend.
+     * Updates the ClusterLabels cache and marks the label as user-edited.
+     */
+    OnLabelEdited(event: {
+        ClusterId: number;
+        OldLabel: string;
+        NewLabel: string;
+    }): void;
+    /**
+     * Compute the prioritized field order and display names from entity metadata.
+     * Sets both FieldPriority and FieldDisplayNames.
+     * Returns field names sorted: IsNameField first, then DefaultInView by Sequence,
+     * then remaining fields by Sequence.
+     */
+    private ComputeFieldPriority;
+    /** Apply cluster labels to the result's Clusters array (sets the Label property) */
+    private applyLabelsToResult;
+    /**
+     * Strip full vector arrays from the result before saving (they're large and not needed for display).
+     * Keeps points with 2D coordinates and metadata but removes the original high-dimensional vectors.
+     */
+    private stripVectorsFromResult;
+    /** Load saved visualizations from UserInfoEngine settings */
+    private loadSavedVisualizations;
+    /**
+     * Auto-save the current session to localStorage so it can be restored
+     * when the user navigates away and comes back.
+     */
+    private saveLastSession;
+    /**
+     * Restore the last session from localStorage if no saved visualization is active.
+     * This handles the "navigate away and come back" case.
+     */
+    private restoreLastSession;
+    /** Persist saved visualizations to UserInfoEngine settings */
+    private persistSavedVisualizations;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ClusterVisualizationResourceComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ClusterVisualizationResourceComponent, "app-cluster-visualization-resource", never, {}, {}, never, never, false, never>;
+}
+/** Tree-shaking prevention */
+export declare function LoadClusterVisualizationResource(): void;
+//# sourceMappingURL=cluster-visualization-resource.component.d.ts.map

package/dist/KnowledgeHub/components/clusters/cluster-visualization-resource.component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster-visualization-resource.component.d.ts","sourceRoot":"","sources":["../../../../src/KnowledgeHub/components/clusters/cluster-visualization-resource.component.ts"],"names":[],"mappings":"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"}