@praxisui/charts 3.0.0-beta.8 → 4.0.0-beta.0

package/index.d.ts

@@ -1,7 +1,7 @@
 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, WidgetPageDefinition, SettingsValueProvider, PraxisI18nDictionary, PraxisI18nConfig, PraxisI18nMessageDescriptor, ComponentDocMeta } from '@praxisui/core';
+import { PraxisTextValue, WidgetDefinition, WidgetShellConfig, WidgetInstance, ComponentMetadataRegistry, ApiUrlConfig, PraxisAnalyticsProjection, AnalyticsSchemaContractService, AnalyticsPresentationResolver, WidgetPageDefinition, SettingsValueProvider, PraxisI18nDictionary, PraxisI18nConfig, PraxisI18nMessageDescriptor, ComponentDocMeta } from '@praxisui/core';
 import * as _praxisui_charts from '@praxisui/charts';
 import { EChartsCoreOption } from 'echarts';
 import { HttpClient } from '@angular/common/http';
@@ -735,6 +735,55 @@ declare class PraxisChartStatsApiService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<PraxisChartStatsApiService>;
 }
 
+interface AnalyticsChartConfigAdapterOptions {
+    title?: PraxisTextValue;
+    subtitle?: PraxisTextValue;
+    height?: number | string;
+}
+declare class AnalyticsChartConfigAdapterService {
+    private readonly statsBuilder;
+    toPraxisChartConfig(projection: PraxisAnalyticsProjection, options?: AnalyticsChartConfigAdapterOptions): PraxisChartConfig;
+    private buildAxes;
+    private buildSeries;
+    private buildDataSource;
+    private resolveChartType;
+    private mapAggregation;
+    private mapExecutionMetrics;
+    private getDisplayMetrics;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AnalyticsChartConfigAdapterService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AnalyticsChartConfigAdapterService>;
+}
+
+type AnalyticsChartContractSource = 'remote' | 'fallback';
+interface AnalyticsChartContractDefinition<TKey extends string = string> {
+    key: TKey;
+    projectionId: string;
+    path: string;
+    title: PraxisTextValue;
+    subtitle?: PraxisTextValue;
+    fallbackProjection: PraxisAnalyticsProjection;
+}
+interface AnalyticsChartContractLoadOptions {
+    cacheNamespace?: string;
+}
+interface AnalyticsChartContractLoadResult<TKey extends string = string> {
+    configs: Record<TKey, PraxisChartConfig>;
+    sources: Record<TKey, AnalyticsChartContractSource>;
+    errors: Partial<Record<TKey, string>>;
+}
+declare class AnalyticsChartContractService {
+    private readonly analyticsSchema;
+    private readonly resolver;
+    private readonly chartAdapter;
+    constructor(analyticsSchema: AnalyticsSchemaContractService, resolver: AnalyticsPresentationResolver, chartAdapter: AnalyticsChartConfigAdapterService);
+    buildBootstrapChartConfigs<TKey extends string>(definitions: readonly AnalyticsChartContractDefinition<TKey>[]): Record<TKey, PraxisChartConfig>;
+    loadChartConfigs<TKey extends string>(definitions: readonly AnalyticsChartContractDefinition<TKey>[], options?: AnalyticsChartContractLoadOptions): Promise<AnalyticsChartContractLoadResult<TKey>>;
+    private loadSingleChartConfig;
+    private buildChartConfig;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AnalyticsChartContractService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AnalyticsChartContractService>;
+}
+
 declare const PRAXIS_CHART_BACKEND_MOCK_BAR: PraxisChartBackendPayload;
 declare const PRAXIS_CHART_BACKEND_MOCK_TIMESERIES: PraxisChartBackendPayload;
 declare const PRAXIS_CHART_BACKEND_MOCK_DONUT: PraxisChartBackendPayload;
@@ -746,7 +795,8 @@ declare const PRAXIS_CHART_BACKEND_MOCK_COMBO: PraxisChartBackendPayload;
 
 declare const PRAXIS_CHART_DRILLDOWN_DATA_BY_MONTH: Record<string, PraxisChartDataRow[]>;
 
-type CanvasWidgetPageDefinition = WidgetPageDefinition & {
+type CanonicalChartPageDefinition = Omit<WidgetPageDefinition, 'connections'>;
+type CanvasWidgetPageDefinition = CanonicalChartPageDefinition & {
     canvas?: {
         mode: 'grid';
         columns: number;
@@ -755,9 +805,9 @@ type CanvasWidgetPageDefinition = WidgetPageDefinition & {
         items: Record<string, PraxisChartCanvasItem>;
     };
 };
-declare function buildPraxisChartMockWidgetPage(adapter: PraxisChartBackendPayloadAdapterService): WidgetPageDefinition;
+declare function buildPraxisChartMockWidgetPage(adapter: PraxisChartBackendPayloadAdapterService): CanonicalChartPageDefinition;
 declare function buildPraxisChartMockCanvasPage(adapter: PraxisChartBackendPayloadAdapterService): CanvasWidgetPageDefinition;
-declare function buildPraxisChartInteractiveWidgetPage(adapter: PraxisChartBackendPayloadAdapterService): WidgetPageDefinition;
+declare function buildPraxisChartInteractiveWidgetPage(adapter: PraxisChartBackendPayloadAdapterService): CanonicalChartPageDefinition;
 declare function buildPraxisChartInteractiveCanvasPage(adapter: PraxisChartBackendPayloadAdapterService): CanvasWidgetPageDefinition;
 
 type ShowcaseLayoutMode = 'widget' | 'canvas';
@@ -775,8 +825,34 @@ declare class PraxisChartCompositionShowcaseComponent {
         environment: string;
         enableCustomization: boolean;
     }>;
-    protected readonly widgetPage: _angular_core.Signal<_praxisui_core.WidgetPageDefinition>;
-    protected readonly canvasPage: _angular_core.Signal<(_praxisui_core.WidgetPageDefinition & {
+    protected readonly widgetPage: _angular_core.Signal<{
+        composition?: _praxisui_core.WidgetPageCompositionDefinition | undefined;
+        canvas?: _praxisui_core.WidgetPageCanvasLayout | undefined;
+        context?: Record<string, any> | undefined;
+        state?: _praxisui_core.WidgetPageStateInput | undefined;
+        widgets: _praxisui_core.WidgetInstance[];
+        layout?: _praxisui_core.WidgetPageLayout | undefined;
+        layoutPreset?: string | undefined;
+        layoutPresetOptions?: Record<string, any> | undefined;
+        grouping?: _praxisui_core.WidgetPageGroupingDefinition[] | undefined;
+        slotAssignments?: _praxisui_core.WidgetPageSlotAssignments | undefined;
+        deviceLayouts?: _praxisui_core.WidgetPageDeviceLayouts | undefined;
+        themePreset?: string | undefined;
+    }>;
+    protected readonly canvasPage: _angular_core.Signal<({
+        composition?: _praxisui_core.WidgetPageCompositionDefinition | undefined;
+        canvas?: _praxisui_core.WidgetPageCanvasLayout | undefined;
+        context?: Record<string, any> | undefined;
+        state?: _praxisui_core.WidgetPageStateInput | undefined;
+        widgets: _praxisui_core.WidgetInstance[];
+        layout?: _praxisui_core.WidgetPageLayout | undefined;
+        layoutPreset?: string | undefined;
+        layoutPresetOptions?: Record<string, any> | undefined;
+        grouping?: _praxisui_core.WidgetPageGroupingDefinition[] | undefined;
+        slotAssignments?: _praxisui_core.WidgetPageSlotAssignments | undefined;
+        deviceLayouts?: _praxisui_core.WidgetPageDeviceLayouts | undefined;
+        themePreset?: string | undefined;
+    } & {
         canvas?: {
             mode: "grid";
             columns: number;
@@ -797,18 +873,31 @@ declare class PraxisChartCompositionShowcaseComponent {
             autoRows?: "fixed" | "content";
             collisionPolicy?: _praxisui_core.WidgetPageCanvasCollisionPolicy;
         };
-        connections?: _praxisui_core.WidgetConnection[];
-        state?: _praxisui_core.WidgetPageStateInput;
-        context?: Record<string, any>;
-        layout?: _praxisui_core.WidgetPageLayout;
-        layoutPreset?: string;
-        layoutPresetOptions?: Record<string, any>;
-        grouping?: _praxisui_core.WidgetPageGroupingDefinition[];
-        slotAssignments?: _praxisui_core.WidgetPageSlotAssignments;
-        deviceLayouts?: _praxisui_core.WidgetPageDeviceLayouts;
-        themePreset?: string;
+        composition?: _praxisui_core.WidgetPageCompositionDefinition | undefined;
+        context?: Record<string, any> | undefined;
+        state?: _praxisui_core.WidgetPageStateInput | undefined;
+        layout?: _praxisui_core.WidgetPageLayout | undefined;
+        layoutPreset?: string | undefined;
+        layoutPresetOptions?: Record<string, any> | undefined;
+        grouping?: _praxisui_core.WidgetPageGroupingDefinition[] | undefined;
+        slotAssignments?: _praxisui_core.WidgetPageSlotAssignments | undefined;
+        deviceLayouts?: _praxisui_core.WidgetPageDeviceLayouts | undefined;
+        themePreset?: string | undefined;
     }>;
-    protected readonly resolvedPage: _angular_core.Signal<_praxisui_core.WidgetPageDefinition | {
+    protected readonly resolvedPage: _angular_core.Signal<{
+        composition?: _praxisui_core.WidgetPageCompositionDefinition | undefined;
+        canvas?: _praxisui_core.WidgetPageCanvasLayout | undefined;
+        context?: Record<string, any> | undefined;
+        state?: _praxisui_core.WidgetPageStateInput | undefined;
+        widgets: _praxisui_core.WidgetInstance[];
+        layout?: _praxisui_core.WidgetPageLayout | undefined;
+        layoutPreset?: string | undefined;
+        layoutPresetOptions?: Record<string, any> | undefined;
+        grouping?: _praxisui_core.WidgetPageGroupingDefinition[] | undefined;
+        slotAssignments?: _praxisui_core.WidgetPageSlotAssignments | undefined;
+        deviceLayouts?: _praxisui_core.WidgetPageDeviceLayouts | undefined;
+        themePreset?: string | undefined;
+    } | {
         widgets: _praxisui_core.WidgetInstance[];
         canvas: {
             items: {
@@ -821,16 +910,16 @@ declare class PraxisChartCompositionShowcaseComponent {
             autoRows?: "fixed" | "content";
             collisionPolicy?: _praxisui_core.WidgetPageCanvasCollisionPolicy;
         };
-        connections?: _praxisui_core.WidgetConnection[];
-        state?: _praxisui_core.WidgetPageStateInput;
-        context?: Record<string, any>;
-        layout?: _praxisui_core.WidgetPageLayout;
-        layoutPreset?: string;
-        layoutPresetOptions?: Record<string, any>;
-        grouping?: _praxisui_core.WidgetPageGroupingDefinition[];
-        slotAssignments?: _praxisui_core.WidgetPageSlotAssignments;
-        deviceLayouts?: _praxisui_core.WidgetPageDeviceLayouts;
-        themePreset?: string;
+        composition?: _praxisui_core.WidgetPageCompositionDefinition | undefined;
+        context?: Record<string, any> | undefined;
+        state?: _praxisui_core.WidgetPageStateInput | undefined;
+        layout?: _praxisui_core.WidgetPageLayout | undefined;
+        layoutPreset?: string | undefined;
+        layoutPresetOptions?: Record<string, any> | undefined;
+        grouping?: _praxisui_core.WidgetPageGroupingDefinition[] | undefined;
+        slotAssignments?: _praxisui_core.WidgetPageSlotAssignments | undefined;
+        deviceLayouts?: _praxisui_core.WidgetPageDeviceLayouts | undefined;
+        themePreset?: string | undefined;
     }>;
     protected readonly payloadTitle: _angular_core.Signal<"Envelope timeseries" | "Envelope distribution" | "Envelope horizontal-bar" | "Envelope stacked-area" | "Envelope multi-metric bar" | "Envelope scatter" | "Envelope combo" | "Envelope group-by">;
     protected readonly selectedPayloadJson: _angular_core.Signal<string>;
@@ -1039,5 +1128,5 @@ declare function providePraxisChartDrilldownPanelMetadata(): Provider;
 declare const PRAXIS_CHART_STATE_PROBE_COMPONENT_METADATA: ComponentDocMeta;
 declare function providePraxisChartStateProbeMetadata(): Provider;
 
-export { 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_STATE_PROBE_COMPONENT_METADATA, PraxisChartBackendPayloadAdapterService, PraxisChartCanonicalContractMapperService, PraxisChartComponent, PraxisChartCompositionShowcaseComponent, PraxisChartConfigEditor, PraxisChartDataTransformerService, PraxisChartDrilldownPanelComponent, PraxisChartOptionBuilderService, PraxisChartSchemaMapperService, PraxisChartStateProbeComponent, PraxisChartStatsApiService, buildPraxisChartInteractiveCanvasPage, buildPraxisChartInteractiveWidgetPage, buildPraxisChartMockCanvasPage, buildPraxisChartMockWidgetPage, createPraxisChartsI18nConfig, providePraxisChartDrilldownPanelMetadata, providePraxisChartStateProbeMetadata, providePraxisCharts, providePraxisChartsI18n, providePraxisChartsMetadata, resolvePraxisChartsText };
-export type { 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, PraxisChartPieSlice, PraxisChartPointEvent, PraxisChartPrimitive, PraxisChartQueryConfig, PraxisChartQueryContext, PraxisChartQueryMetricConfig, PraxisChartQueryRequestEvent, PraxisChartRemoteDataSource, PraxisChartSchemaMeta, PraxisChartSeriesConfig, PraxisChartSeriesLabelConfig, PraxisChartStateConfig, PraxisChartStatsDistributionMode, PraxisChartStatsGranularity, PraxisChartStatsMetricOperation, PraxisChartStatsMetricRequest, PraxisChartStatsOperation, PraxisChartStatsOrderBy, PraxisChartStatsRequest, PraxisChartThemeConfig, PraxisChartTimeSeriesStatsRequest, PraxisChartTooltipConfig, PraxisChartTransformedData, PraxisChartType, PraxisChartWidgetInstance, PraxisChartWidgetLike, PraxisChartWidgetResolution, PraxisChartWidgetSchema, PraxisChartsI18nOptions, PraxisChartsText, PraxisXUiChartAggregation, PraxisXUiChartAggregationConfig, PraxisXUiChartContract, PraxisXUiChartDimension, PraxisXUiChartEventAction, PraxisXUiChartEvents, PraxisXUiChartFilter, PraxisXUiChartKind, PraxisXUiChartMetric, PraxisXUiChartMotion, PraxisXUiChartMotionPreset, PraxisXUiChartPreset, PraxisXUiChartRefresh, PraxisXUiChartRuntimeHints, PraxisXUiChartSort, PraxisXUiChartSource, PraxisXUiChartSourceKind, PraxisXUiChartState, PraxisXUiChartStateDescriptor, PraxisXUiChartStatsDistributionMode, PraxisXUiChartStatsOperation, PraxisXUiChartStatsOrderBy, PraxisXUiChartStatsSourceOptions, PraxisXUiChartTextValue, PraxisXUiChartTheme, PraxisXUiChartToggleableFeature };
+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_STATE_PROBE_COMPONENT_METADATA, PraxisChartBackendPayloadAdapterService, PraxisChartCanonicalContractMapperService, PraxisChartComponent, PraxisChartCompositionShowcaseComponent, PraxisChartConfigEditor, PraxisChartDataTransformerService, PraxisChartDrilldownPanelComponent, PraxisChartOptionBuilderService, PraxisChartSchemaMapperService, PraxisChartStateProbeComponent, PraxisChartStatsApiService, buildPraxisChartInteractiveCanvasPage, buildPraxisChartInteractiveWidgetPage, buildPraxisChartMockCanvasPage, buildPraxisChartMockWidgetPage, createPraxisChartsI18nConfig, providePraxisChartDrilldownPanelMetadata, providePraxisChartStateProbeMetadata, providePraxisCharts, providePraxisChartsI18n, providePraxisChartsMetadata, 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, PraxisChartPieSlice, PraxisChartPointEvent, PraxisChartPrimitive, PraxisChartQueryConfig, PraxisChartQueryContext, PraxisChartQueryMetricConfig, PraxisChartQueryRequestEvent, PraxisChartRemoteDataSource, PraxisChartSchemaMeta, PraxisChartSeriesConfig, PraxisChartSeriesLabelConfig, PraxisChartStateConfig, PraxisChartStatsDistributionMode, PraxisChartStatsGranularity, PraxisChartStatsMetricOperation, PraxisChartStatsMetricRequest, PraxisChartStatsOperation, PraxisChartStatsOrderBy, PraxisChartStatsRequest, PraxisChartThemeConfig, PraxisChartTimeSeriesStatsRequest, PraxisChartTooltipConfig, PraxisChartTransformedData, PraxisChartType, PraxisChartWidgetInstance, PraxisChartWidgetLike, PraxisChartWidgetResolution, PraxisChartWidgetSchema, PraxisChartsI18nOptions, PraxisChartsText, PraxisXUiChartAggregation, PraxisXUiChartAggregationConfig, PraxisXUiChartContract, PraxisXUiChartDimension, PraxisXUiChartEventAction, PraxisXUiChartEvents, PraxisXUiChartFilter, PraxisXUiChartKind, PraxisXUiChartMetric, PraxisXUiChartMotion, PraxisXUiChartMotionPreset, PraxisXUiChartPreset, PraxisXUiChartRefresh, PraxisXUiChartRuntimeHints, PraxisXUiChartSort, PraxisXUiChartSource, PraxisXUiChartSourceKind, PraxisXUiChartState, PraxisXUiChartStateDescriptor, PraxisXUiChartStatsDistributionMode, PraxisXUiChartStatsOperation, PraxisXUiChartStatsOrderBy, PraxisXUiChartStatsSourceOptions, PraxisXUiChartTextValue, PraxisXUiChartTheme, PraxisXUiChartToggleableFeature };

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@praxisui/charts",
-  "version": "3.0.0-beta.8",
+  "version": "4.0.0-beta.0",
   "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": "^3.0.0-beta.8"
+    "@praxisui/core": "^4.0.0-beta.0"
   },
   "dependencies": {
     "echarts": "^6.0.0",