@praxisui/charts 8.0.0-beta.0 → 8.0.0-beta.1

package/index.d.ts

@@ -3,9 +3,9 @@ import * as _angular_core from '@angular/core';
 import { InjectionToken, Provider } from '@angular/core';
 import * as _praxisui_core from '@praxisui/core';
 import { PraxisTextValue, WidgetDefinition, WidgetShellConfig, WidgetInstance, ComponentMetadataRegistry, ApiUrlConfig, PraxisAnalyticsProjection, AnalyticsSchemaContractService, AnalyticsPresentationResolver, WidgetPageDefinition, SettingsValueProvider, PraxisI18nDictionary, PraxisI18nConfig, PraxisI18nMessageDescriptor, ComponentDocMeta } from '@praxisui/core';
+import { Observable, BehaviorSubject } from 'rxjs';
 import { EChartsCoreOption } from 'echarts';
 import { HttpClient } from '@angular/common/http';
-import { Observable, BehaviorSubject } from 'rxjs';
 
 type PraxisChartAxisType = 'category' | 'value' | 'time';
 type PraxisChartAxisPosition = 'top' | 'bottom' | 'left' | 'right';
@@ -28,14 +28,14 @@ type PraxisChartPrimitive = string | number | boolean | Date | null | undefined;
 type PraxisChartDataRow = Record<string, PraxisChartPrimitive>;
 interface PraxisChartQueryMetricConfig {
     field?: string;
-    aggregation?: 'sum' | 'count' | 'avg' | 'min' | 'max';
+    aggregation?: 'sum' | 'count' | 'distinct-count' | 'avg' | 'min' | 'max';
     alias?: string;
 }
 type PraxisChartStatsOperation = 'group-by' | 'timeseries' | 'distribution';
 type PraxisChartStatsDistributionMode = 'terms' | 'histogram';
 type PraxisChartStatsOrderBy = 'key-asc' | 'key-desc' | 'value-asc' | 'value-desc';
-type PraxisChartStatsGranularity = 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year';
-type PraxisChartStatsMetricOperation = 'COUNT' | 'SUM' | 'AVG' | 'MIN' | 'MAX';
+type PraxisChartStatsGranularity = 'day' | 'week' | 'month';
+type PraxisChartStatsMetricOperation = 'COUNT' | 'DISTINCT_COUNT' | 'SUM' | 'AVG' | 'MIN' | 'MAX';
 interface PraxisChartStatsMetricRequest {
     operation: PraxisChartStatsMetricOperation;
     field?: string;
@@ -114,6 +114,8 @@ interface PraxisChartInteractionConfig {
     pointClick?: boolean;
     selection?: boolean;
     drillDown?: boolean;
+    crossFilter?: boolean;
+    eventActions?: Partial<Record<'pointClick' | 'selectionChange' | 'drillDown' | 'crossFilter', PraxisChartDeclarativeEventAction>>;
 }
 interface PraxisChartPointEvent {
     chartId?: string;
@@ -123,6 +125,23 @@ interface PraxisChartPointEvent {
     value?: unknown;
     data?: unknown;
 }
+interface PraxisChartDeclarativeEventAction {
+    action: 'filter-widget' | 'open-detail' | 'navigate' | 'update-context' | 'emit';
+    target?: string;
+    mapping?: Record<string, string>;
+}
+interface PraxisChartSelectionEvent extends PraxisChartPointEvent {
+    selected: boolean;
+    filters: Record<string, unknown>;
+    action?: PraxisChartDeclarativeEventAction;
+}
+interface PraxisChartCrossFilterEvent {
+    chartId?: string;
+    filters: Record<string, unknown>;
+    target?: string;
+    action?: PraxisChartDeclarativeEventAction;
+    source: PraxisChartSelectionEvent;
+}
 interface PraxisChartQueryRequestEvent {
     chartId?: string;
     dataSource: Extract<PraxisChartDataSource, {
@@ -131,9 +150,11 @@ interface PraxisChartQueryRequestEvent {
     query?: PraxisChartQueryConfig;
     queryContext?: PraxisChartQueryContext | null;
 }
+type PraxisChartRemoteDataResolverResult = PraxisChartDataRow[] | Promise<PraxisChartDataRow[]> | Observable<PraxisChartDataRow[]> | null | undefined;
+type PraxisChartRemoteDataResolver = (event: PraxisChartQueryRequestEvent, config: PraxisChartConfig) => PraxisChartRemoteDataResolverResult;
 
 type PraxisChartType = 'bar' | 'combo' | 'horizontal-bar' | 'line' | 'pie' | 'donut' | 'area' | 'stacked-bar' | 'stacked-area' | 'scatter';
-type PraxisChartAggregation = 'sum' | 'count' | 'avg' | 'min' | 'max';
+type PraxisChartAggregation = 'sum' | 'count' | 'distinct-count' | 'avg' | 'min' | 'max';
 interface PraxisChartMetricConfig {
     field?: string;
     aggregation?: PraxisChartAggregation;
@@ -287,7 +308,7 @@ interface PraxisXUiChartAggregationConfig {
     as?: string;
 }
 interface PraxisXUiChartStatsSourceOptions {
-    granularity?: 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year';
+    granularity?: 'day' | 'week' | 'month';
     fillGaps?: boolean;
     mode?: PraxisXUiChartStatsDistributionMode;
     bucketSize?: number;
@@ -424,11 +445,14 @@ declare class PraxisChartComponent {
     readonly chartDocument: _angular_core.InputSignal<PraxisXUiChartContract | null>;
     readonly filterCriteria: _angular_core.InputSignal<Record<string, unknown> | null>;
     readonly queryContext: _angular_core.InputSignal<PraxisDataQueryContextBridge | null>;
+    readonly remoteDataResolver: _angular_core.InputSignal<PraxisChartRemoteDataResolver | null>;
     readonly enableCustomization: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly availableResources: _angular_core.InputSignal<readonly ChartEditorResourceOption[]>;
     readonly availableFields: _angular_core.InputSignal<readonly ChartEditorFieldOption[]>;
     readonly availableTargets: _angular_core.InputSignal<readonly ChartEditorTargetOption[]>;
     readonly pointClick: _angular_core.OutputEmitterRef<PraxisChartPointEvent>;
+    readonly selectionChange: _angular_core.OutputEmitterRef<PraxisChartSelectionEvent>;
+    readonly crossFilter: _angular_core.OutputEmitterRef<PraxisChartCrossFilterEvent>;
     readonly queryRequest: _angular_core.OutputEmitterRef<PraxisChartQueryRequestEvent>;
     readonly loadStateChange: _angular_core.OutputEmitterRef<PraxisChartLoadState>;
     readonly chartDocumentApplied: _angular_core.OutputEmitterRef<PraxisXUiChartContract>;
@@ -454,6 +478,7 @@ declare class PraxisChartComponent {
     private readonly fillContainerHeight;
     private resizeFrameId;
     private previousRemoteSignature;
+    private previousRemoteDataResolver;
     private previousDocumentSignature;
     private editorSessionSubscriptions;
     readonly effectiveConfig: _angular_core.Signal<PraxisChartConfig>;
@@ -479,17 +504,24 @@ declare class PraxisChartComponent {
     constructor();
     canOpenConfigEditor(): boolean;
     openConfigEditor(): Promise<void>;
+    private handlePointClick;
+    private buildSelectionEvent;
+    private buildEventFilters;
+    private extractPointSourceValues;
+    private extractPointMetricValue;
+    private executeRemoteDataRequest;
     private ensureResizeObserver;
     private toCssSize;
     private toCssAspectRatio;
     private buildRemoteSignature;
     private clearEditorSessionSubscriptions;
     private observeShellSizingContext;
+    private shouldFillShellContainer;
     private scheduleResizeAfterShellModeChange;
     private scheduleEngineResize;
     private cancelScheduledResize;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PraxisChartComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PraxisChartComponent, "praxis-chart", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; "data": { "alias": "data"; "required": false; "isSignal": true; }; "chartDocument": { "alias": "chartDocument"; "required": false; "isSignal": true; }; "filterCriteria": { "alias": "filterCriteria"; "required": false; "isSignal": true; }; "queryContext": { "alias": "queryContext"; "required": false; "isSignal": true; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; "isSignal": true; }; "availableResources": { "alias": "availableResources"; "required": false; "isSignal": true; }; "availableFields": { "alias": "availableFields"; "required": false; "isSignal": true; }; "availableTargets": { "alias": "availableTargets"; "required": false; "isSignal": true; }; }, { "pointClick": "pointClick"; "queryRequest": "queryRequest"; "loadStateChange": "loadStateChange"; "chartDocumentApplied": "chartDocumentApplied"; "chartDocumentSaved": "chartDocumentSaved"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PraxisChartComponent, "praxis-chart", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; "data": { "alias": "data"; "required": false; "isSignal": true; }; "chartDocument": { "alias": "chartDocument"; "required": false; "isSignal": true; }; "filterCriteria": { "alias": "filterCriteria"; "required": false; "isSignal": true; }; "queryContext": { "alias": "queryContext"; "required": false; "isSignal": true; }; "remoteDataResolver": { "alias": "remoteDataResolver"; "required": false; "isSignal": true; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; "isSignal": true; }; "availableResources": { "alias": "availableResources"; "required": false; "isSignal": true; }; "availableFields": { "alias": "availableFields"; "required": false; "isSignal": true; }; "availableTargets": { "alias": "availableTargets"; "required": false; "isSignal": true; }; }, { "pointClick": "pointClick"; "selectionChange": "selectionChange"; "crossFilter": "crossFilter"; "queryRequest": "queryRequest"; "loadStateChange": "loadStateChange"; "chartDocumentApplied": "chartDocumentApplied"; "chartDocumentSaved": "chartDocumentSaved"; }, never, never, true, never>;
 }
 
 declare class PraxisChartDrilldownPanelComponent {
@@ -1035,7 +1067,7 @@ interface ChartConfigEditorResetEvent {
 type ChartEditorSection = 'general' | 'data' | 'analytics' | 'appearance' | 'motion' | 'events' | 'preview';
 type ChartFeatureKey = 'legend' | 'labels' | 'tooltip';
 type ChartStateKey = 'empty' | 'loading' | 'error';
-type ChartEventKey = 'pointClick' | 'drillDown';
+type ChartEventKey = 'pointClick' | 'selectionChange' | 'drillDown' | 'crossFilter';
 declare class PraxisChartConfigEditor implements SettingsValueProvider {
     readonly documentInput: _angular_core.InputSignal<PraxisXUiChartContract | null>;
     readonly modeInput: _angular_core.InputSignal<"create" | "edit">;
@@ -1058,7 +1090,7 @@ declare class PraxisChartConfigEditor implements SettingsValueProvider {
     readonly chartKinds: PraxisXUiChartKind[];
     readonly sourceKinds: readonly ["praxis.stats", "derived"];
     readonly operations: PraxisXUiChartStatsOperation[];
-    readonly timeGranularities: readonly ["hour", "day", "week", "month", "quarter", "year"];
+    readonly timeGranularities: readonly ["day", "week", "month"];
     readonly distributionModes: PraxisXUiChartStatsDistributionMode[];
     readonly dimensionRoles: NonNullable<PraxisXUiChartDimension['role']>[];
     readonly metricAggregations: PraxisXUiChartAggregation[];
@@ -1229,4 +1261,4 @@ declare const PRAXIS_CHART_STATE_PROBE_COMPONENT_METADATA: ComponentDocMeta;
 declare function providePraxisChartStateProbeMetadata(): Provider;
 
 export { AnalyticsChartConfigAdapterService, AnalyticsChartContractService, ChartContractNormalizerService, ChartContractValidationService, ChartEditorDefaultsService, ChartEditorPreviewMapperService, PRAXIS_CHARTS_I18N, PRAXIS_CHART_BACKEND_MOCK_BAR, PRAXIS_CHART_BACKEND_MOCK_COMBO, PRAXIS_CHART_BACKEND_MOCK_DONUT, PRAXIS_CHART_BACKEND_MOCK_HORIZONTAL_BAR, PRAXIS_CHART_BACKEND_MOCK_MULTI_METRIC_BAR, PRAXIS_CHART_BACKEND_MOCK_SCATTER, PRAXIS_CHART_BACKEND_MOCK_STACKED_AREA, PRAXIS_CHART_BACKEND_MOCK_TIMESERIES, PRAXIS_CHART_COMPONENT_METADATA, PRAXIS_CHART_DRILLDOWN_DATA_BY_MONTH, PRAXIS_CHART_DRILLDOWN_PANEL_METADATA, PRAXIS_CHART_ENGINE, PRAXIS_CHART_PALETTE_TOKENS, PRAXIS_CHART_STATE_PROBE_COMPONENT_METADATA, PRAXIS_CHART_THEME_VARIANTS, PraxisChartBackendPayloadAdapterService, PraxisChartCanonicalContractMapperService, PraxisChartComponent, PraxisChartCompositionShowcaseComponent, PraxisChartConfigEditor, PraxisChartDataTransformerService, PraxisChartDrilldownPanelComponent, PraxisChartOptionBuilderService, PraxisChartSchemaMapperService, PraxisChartStateProbeComponent, PraxisChartStatsApiService, buildPraxisChartInteractiveCanvasPage, buildPraxisChartInteractiveWidgetPage, buildPraxisChartMockCanvasPage, buildPraxisChartMockWidgetPage, createPraxisChartsI18nConfig, isPraxisChartPaletteToken, providePraxisChartDrilldownPanelMetadata, providePraxisChartStateProbeMetadata, providePraxisCharts, providePraxisChartsI18n, providePraxisChartsMetadata, resolvePraxisChartPaletteToken, resolvePraxisChartsText };
-export type { AnalyticsChartConfigAdapterOptions, AnalyticsChartContractDefinition, AnalyticsChartContractLoadOptions, AnalyticsChartContractLoadResult, AnalyticsChartContractSource, ChartConfigEditorApplyEvent, ChartConfigEditorResetEvent, ChartConfigEditorSaveEvent, ChartContractIssueSeverity, ChartContractValidationIssue, ChartContractValidationResult, ChartEditorFieldOption, ChartEditorPreviewPayload, ChartEditorResourceOption, ChartEditorTargetOption, PraxisChartAggregation, PraxisChartAxisConfig, PraxisChartAxisLabelConfig, PraxisChartAxisPosition, PraxisChartAxisType, PraxisChartBackendPayload, PraxisChartBackendWidgetPayload, PraxisChartCanvasItem, PraxisChartCartesianSeries, PraxisChartConfig, PraxisChartConfigEditorData, PraxisChartDataRow, PraxisChartDataSource, PraxisChartDistributionStatsRequest, PraxisChartEmptyStateConfig, PraxisChartEngineAdapter, PraxisChartEngineRenderPayload, PraxisChartErrorStateConfig, PraxisChartGroupByStatsRequest, PraxisChartInteractionConfig, PraxisChartLegendConfig, PraxisChartLoadState, PraxisChartLocalDataSource, PraxisChartMetricConfig, PraxisChartMotionConfig, PraxisChartMotionPreset, PraxisChartPaletteToken, PraxisChartPieSlice, PraxisChartPointEvent, PraxisChartPrimitive, PraxisChartQueryConfig, PraxisChartQueryContext, PraxisChartQueryMetricConfig, PraxisChartQueryRequestEvent, PraxisChartRemoteDataSource, PraxisChartSchemaMeta, PraxisChartSeriesConfig, PraxisChartSeriesLabelConfig, PraxisChartSizingConfig, PraxisChartSizingMode, PraxisChartStateConfig, PraxisChartStatsDistributionMode, PraxisChartStatsGranularity, PraxisChartStatsMetricOperation, PraxisChartStatsMetricRequest, PraxisChartStatsOperation, PraxisChartStatsOrderBy, PraxisChartStatsRequest, PraxisChartSurfaceConfig, PraxisChartSurfaceMode, PraxisChartThemeConfig, PraxisChartThemeVariant, PraxisChartTimeSeriesStatsRequest, PraxisChartTooltipConfig, PraxisChartTransformedData, PraxisChartType, PraxisChartWidgetInstance, PraxisChartWidgetLike, PraxisChartWidgetResolution, PraxisChartWidgetSchema, PraxisChartsI18nOptions, PraxisChartsText, PraxisXUiChartAggregation, PraxisXUiChartAggregationConfig, PraxisXUiChartContract, PraxisXUiChartDimension, PraxisXUiChartEventAction, PraxisXUiChartEvents, PraxisXUiChartFilter, PraxisXUiChartKind, PraxisXUiChartMetric, PraxisXUiChartMotion, PraxisXUiChartMotionPreset, PraxisXUiChartPreset, PraxisXUiChartRefresh, PraxisXUiChartRuntimeHints, PraxisXUiChartSizing, PraxisXUiChartSizingMode, PraxisXUiChartSort, PraxisXUiChartSource, PraxisXUiChartSourceKind, PraxisXUiChartState, PraxisXUiChartStateDescriptor, PraxisXUiChartStatsDistributionMode, PraxisXUiChartStatsOperation, PraxisXUiChartStatsOrderBy, PraxisXUiChartStatsSourceOptions, PraxisXUiChartSurface, PraxisXUiChartSurfaceMode, PraxisXUiChartTextValue, PraxisXUiChartTheme, PraxisXUiChartToggleableFeature };
+export type { AnalyticsChartConfigAdapterOptions, AnalyticsChartContractDefinition, AnalyticsChartContractLoadOptions, AnalyticsChartContractLoadResult, AnalyticsChartContractSource, ChartConfigEditorApplyEvent, ChartConfigEditorResetEvent, ChartConfigEditorSaveEvent, ChartContractIssueSeverity, ChartContractValidationIssue, ChartContractValidationResult, ChartEditorFieldOption, ChartEditorPreviewPayload, ChartEditorResourceOption, ChartEditorTargetOption, PraxisChartAggregation, PraxisChartAxisConfig, PraxisChartAxisLabelConfig, PraxisChartAxisPosition, PraxisChartAxisType, PraxisChartBackendPayload, PraxisChartBackendWidgetPayload, PraxisChartCanvasItem, PraxisChartCartesianSeries, PraxisChartConfig, PraxisChartConfigEditorData, PraxisChartCrossFilterEvent, PraxisChartDataRow, PraxisChartDataSource, PraxisChartDeclarativeEventAction, PraxisChartDistributionStatsRequest, PraxisChartEmptyStateConfig, PraxisChartEngineAdapter, PraxisChartEngineRenderPayload, PraxisChartErrorStateConfig, PraxisChartGroupByStatsRequest, PraxisChartInteractionConfig, PraxisChartLegendConfig, PraxisChartLoadState, PraxisChartLocalDataSource, PraxisChartMetricConfig, PraxisChartMotionConfig, PraxisChartMotionPreset, PraxisChartPaletteToken, PraxisChartPieSlice, PraxisChartPointEvent, PraxisChartPrimitive, PraxisChartQueryConfig, PraxisChartQueryContext, PraxisChartQueryMetricConfig, PraxisChartQueryRequestEvent, PraxisChartRemoteDataResolver, PraxisChartRemoteDataResolverResult, PraxisChartRemoteDataSource, PraxisChartSchemaMeta, PraxisChartSelectionEvent, PraxisChartSeriesConfig, PraxisChartSeriesLabelConfig, PraxisChartSizingConfig, PraxisChartSizingMode, PraxisChartStateConfig, PraxisChartStatsDistributionMode, PraxisChartStatsGranularity, PraxisChartStatsMetricOperation, PraxisChartStatsMetricRequest, PraxisChartStatsOperation, PraxisChartStatsOrderBy, PraxisChartStatsRequest, PraxisChartSurfaceConfig, PraxisChartSurfaceMode, PraxisChartThemeConfig, PraxisChartThemeVariant, PraxisChartTimeSeriesStatsRequest, PraxisChartTooltipConfig, PraxisChartTransformedData, PraxisChartType, PraxisChartWidgetInstance, PraxisChartWidgetLike, PraxisChartWidgetResolution, PraxisChartWidgetSchema, PraxisChartsI18nOptions, PraxisChartsText, PraxisXUiChartAggregation, PraxisXUiChartAggregationConfig, PraxisXUiChartContract, PraxisXUiChartDimension, PraxisXUiChartEventAction, PraxisXUiChartEvents, PraxisXUiChartFilter, PraxisXUiChartKind, PraxisXUiChartMetric, PraxisXUiChartMotion, PraxisXUiChartMotionPreset, PraxisXUiChartPreset, PraxisXUiChartRefresh, PraxisXUiChartRuntimeHints, PraxisXUiChartSizing, PraxisXUiChartSizingMode, PraxisXUiChartSort, PraxisXUiChartSource, PraxisXUiChartSourceKind, PraxisXUiChartState, PraxisXUiChartStateDescriptor, PraxisXUiChartStatsDistributionMode, PraxisXUiChartStatsOperation, PraxisXUiChartStatsOrderBy, PraxisXUiChartStatsSourceOptions, PraxisXUiChartSurface, PraxisXUiChartSurfaceMode, PraxisXUiChartTextValue, PraxisXUiChartTheme, PraxisXUiChartToggleableFeature };

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@praxisui/charts",
-  "version": "8.0.0-beta.0",
+  "version": "8.0.0-beta.1",
   "description": "Metadata-driven charts library for Praxis UI Angular with engine adapters and Apache ECharts as the initial renderer.",
   "peerDependencies": {
     "@angular/common": "^20.0.0",
     "@angular/core": "^20.0.0",
-    "@praxisui/core": "^8.0.0-beta.0"
+    "@praxisui/core": "^8.0.0-beta.1"
   },
   "dependencies": {
     "echarts": "^6.0.0",
@@ -17,7 +17,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/codexrodrigues/praxis-ui-angular"
+    "url": "git+https://github.com/codexrodrigues/praxis-ui-angular.git"
   },
   "homepage": "https://praxisui.dev",
   "bugs": {