@praxisui/charts 3.0.0-beta.9 → 5.0.0-beta.0

package/README.md

@@ -279,3 +279,17 @@ The current runtime does not yet expose as stable public surface:
 - the package is designed for the Praxis platform model, where chart semantics live in canonical contracts and not in engine-specific payloads
 - if you are integrating charts into dynamic pages or widget shells, prefer the exported Praxis contracts and mappers over direct engine customization
 - if you need raw ECharts tuning, treat it as adapter-level implementation detail unless the contract is promoted to the public surface intentionally
+
+## Reusable `x-ui.analytics` Runtime Pattern
+
+When the backend publishes `x-ui.analytics.projections[]`, the reusable platform path is now:
+
+1. `@praxisui/core` resolves the contract with `AnalyticsSchemaContractService`
+2. `AnalyticsPresentationResolver` chooses the presentation family
+3. `AnalyticsChartContractService` in `@praxisui/charts` materializes the selected projection into `PraxisChartConfig`
+
+This keeps chart hosts out of the business of:
+- calling `/schemas/filtered` manually
+- parsing `x-ui.analytics` by hand
+- selecting projections ad hoc
+- rebuilding the chart contract pipeline inside each app

package/fesm2022/praxisui-charts.mjs

@@ -2,7 +2,7 @@ import { CommonModule } from '@angular/common';
 import * as i0 from '@angular/core';
 import { Injectable, Inject, InjectionToken, input, booleanAttribute, output, viewChild, inject, ElementRef, DestroyRef, signal, computed, afterNextRender, effect, ChangeDetectionStrategy, Component, ENVIRONMENT_INITIALIZER } from '@angular/core';
 import * as i1$2 from '@praxisui/core';
-import { buildApiUrl, API_URL, PraxisI18nService, SETTINGS_PANEL_BRIDGE, ComponentMetadataRegistry, createDefaultTableConfig, DynamicWidgetPageComponent, providePraxisI18n, SETTINGS_PANEL_DATA } from '@praxisui/core';
+import { buildApiUrl, API_URL, PraxisI18nService, SETTINGS_PANEL_BRIDGE, ComponentMetadataRegistry, createDefaultTableConfig, AnalyticsStatsRequestBuilderService, DynamicWidgetPageComponent, providePraxisI18n, SETTINGS_PANEL_DATA } from '@praxisui/core';
 import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
 import * as i1$1 from '@angular/material/button';
 import { MatButtonModule } from '@angular/material/button';
@@ -2818,6 +2818,245 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
             args: [{ providedIn: 'root' }]
         }], ctorParameters: () => [{ type: PraxisChartSchemaMapperService }, { type: PraxisChartCanonicalContractMapperService }] });
 
+class AnalyticsChartConfigAdapterService {
+    statsBuilder = new AnalyticsStatsRequestBuilderService();
+    toPraxisChartConfig(projection, options) {
+        const chartType = this.resolveChartType(projection);
+        const orientation = chartType === 'horizontal-bar' ? 'horizontal' : undefined;
+        const dimension = projection.bindings.primaryDimension;
+        const metrics = projection.bindings.primaryMetrics ?? [];
+        if (!dimension?.field) {
+            throw new Error(`AnalyticsChartConfigAdapterService requires primaryDimension for projection "${projection.id}".`);
+        }
+        if (!metrics.length) {
+            throw new Error(`AnalyticsChartConfigAdapterService requires at least one metric for projection "${projection.id}".`);
+        }
+        return {
+            id: projection.id,
+            type: chartType,
+            orientation,
+            title: options?.title,
+            subtitle: options?.subtitle,
+            height: options?.height,
+            axes: this.buildAxes(projection, chartType),
+            series: this.buildSeries(projection, chartType),
+            dataSource: this.buildDataSource(projection),
+            interactions: {
+                pointClick: Boolean(projection.interactions?.pointSelection || projection.interactions?.drillDown),
+                drillDown: Boolean(projection.interactions?.drillDown),
+                selection: Boolean(projection.interactions?.pointSelection),
+            },
+        };
+    }
+    buildAxes(projection, chartType) {
+        const dimension = projection.bindings.primaryDimension;
+        const metrics = this.getDisplayMetrics(projection);
+        const firstMetric = metrics[0];
+        if (chartType === 'pie' || chartType === 'donut') {
+            return {
+                x: {
+                    field: dimension.field,
+                    label: dimension.label ?? undefined,
+                },
+            };
+        }
+        return {
+            x: {
+                field: dimension.field,
+                label: dimension.label ?? undefined,
+                type: dimension.role === 'time' ? 'time' : 'category',
+            },
+            y: {
+                label: metrics.length === 1
+                    ? firstMetric?.label ?? firstMetric?.field
+                    : undefined,
+                type: 'value',
+            },
+        };
+    }
+    buildSeries(projection, chartType) {
+        const dimension = projection.bindings.primaryDimension;
+        return this.getDisplayMetrics(projection).map((metric, index) => ({
+            id: `${projection.id}.${metric.field}.${index + 1}`,
+            name: metric.label ?? metric.field,
+            type: chartType,
+            categoryField: chartType === 'pie' || chartType === 'donut' ? dimension.field : undefined,
+            metric: {
+                field: metric.field,
+                aggregation: this.mapAggregation(metric.aggregation),
+                label: metric.label ?? undefined,
+            },
+            smooth: chartType === 'line' || chartType === 'area',
+        }));
+    }
+    buildDataSource(projection) {
+        const executionPlan = this.statsBuilder.buildExecutionPlan(projection);
+        return {
+            kind: 'remote',
+            resourcePath: executionPlan.resourcePath,
+            schemaId: executionPlan.resourcePath,
+            query: {
+                sourceKind: 'praxis.stats',
+                statsOperation: executionPlan.operation,
+                statsPath: executionPlan.statsPath,
+                statsRequest: executionPlan.statsRequest,
+                dimensions: executionPlan.dimensions,
+                metrics: this.mapExecutionMetrics(executionPlan),
+                sort: executionPlan.sort,
+                limit: executionPlan.limit,
+            },
+        };
+    }
+    resolveChartType(projection) {
+        if (projection.intent === 'trend' && projection.source.operation === 'timeseries') {
+            return 'line';
+        }
+        if (projection.intent === 'ranking' && projection.source.operation === 'group-by') {
+            return 'horizontal-bar';
+        }
+        if (projection.intent === 'composition') {
+            return 'pie';
+        }
+        if (projection.intent === 'distribution') {
+            return 'bar';
+        }
+        return 'bar';
+    }
+    mapAggregation(aggregation) {
+        const normalizedAggregation = (aggregation ?? '').toLowerCase();
+        switch (normalizedAggregation) {
+            case 'avg':
+            case 'min':
+            case 'max':
+            case 'count':
+            case 'sum':
+                return normalizedAggregation;
+            case '':
+                return undefined;
+            default:
+                throw new Error(`Analytics aggregation "${aggregation}" is not supported in @praxisui/charts.`);
+        }
+    }
+    mapExecutionMetrics(executionPlan) {
+        return executionPlan.metrics.map((metric) => ({
+            field: metric.field,
+            aggregation: this.mapAggregation(metric.aggregation),
+            alias: metric.alias,
+        }));
+    }
+    getDisplayMetrics(projection) {
+        return [
+            ...(projection.bindings.primaryMetrics ?? []),
+            ...(projection.bindings.secondaryMetrics ?? []),
+        ];
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: AnalyticsChartConfigAdapterService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: AnalyticsChartConfigAdapterService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: AnalyticsChartConfigAdapterService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+class AnalyticsChartContractService {
+    analyticsSchema;
+    resolver;
+    chartAdapter;
+    constructor(analyticsSchema, resolver, chartAdapter) {
+        this.analyticsSchema = analyticsSchema;
+        this.resolver = resolver;
+        this.chartAdapter = chartAdapter;
+    }
+    buildBootstrapChartConfigs(definitions) {
+        return definitions.reduce((acc, definition) => {
+            acc[definition.key] = this.buildChartConfig({
+                projection: definition.fallbackProjection,
+                title: definition.title,
+                subtitle: definition.subtitle,
+            });
+            return acc;
+        }, {});
+    }
+    async loadChartConfigs(definitions, options) {
+        const results = await Promise.all(definitions.map((definition) => this.loadSingleChartConfig(definition, options)));
+        return {
+            configs: results.reduce((acc, result) => {
+                acc[result.key] = result.config;
+                return acc;
+            }, {}),
+            sources: results.reduce((acc, result) => {
+                acc[result.key] = result.source;
+                return acc;
+            }, {}),
+            errors: results.reduce((acc, result) => {
+                if (result.error) {
+                    acc[result.key] = result.error;
+                }
+                return acc;
+            }, {}),
+        };
+    }
+    async loadSingleChartConfig(definition, options) {
+        const fallbackConfig = this.buildChartConfig({
+            projection: definition.fallbackProjection,
+            title: definition.title,
+            subtitle: definition.subtitle,
+        });
+        try {
+            const analytics = await this.analyticsSchema.getAnalytics({
+                path: definition.path,
+                cacheNamespace: options?.cacheNamespace,
+            });
+            const projection = analytics.projections.find((candidate) => candidate.id === definition.projectionId);
+            if (!projection) {
+                throw new Error(`Projection "${definition.projectionId}" was not published for ${definition.path}.`);
+            }
+            return {
+                key: definition.key,
+                source: 'remote',
+                config: this.buildChartConfig({
+                    projection,
+                    title: definition.title,
+                    subtitle: definition.subtitle,
+                }),
+            };
+        }
+        catch (error) {
+            return {
+                key: definition.key,
+                source: 'fallback',
+                config: fallbackConfig,
+                error: normalizeError(error),
+            };
+        }
+    }
+    buildChartConfig(params) {
+        const decision = this.resolver.resolve({ projections: [params.projection] }, {
+            availableFamilies: ['chart', 'analytic-table'],
+            preferFamily: 'chart',
+        });
+        if (decision.family !== 'chart') {
+            throw new Error(`Projection "${params.projection.id}" did not resolve to the chart family.`);
+        }
+        return this.chartAdapter.toPraxisChartConfig(params.projection, {
+            title: params.title,
+            subtitle: params.subtitle,
+        });
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: AnalyticsChartContractService, deps: [{ token: i1$2.AnalyticsSchemaContractService }, { token: i1$2.AnalyticsPresentationResolver }, { token: AnalyticsChartConfigAdapterService }], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: AnalyticsChartContractService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: AnalyticsChartContractService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }], ctorParameters: () => [{ type: i1$2.AnalyticsSchemaContractService }, { type: i1$2.AnalyticsPresentationResolver }, { type: AnalyticsChartConfigAdapterService }] });
+function normalizeError(error) {
+    if (error instanceof Error && error.message.trim()) {
+        return error.message.trim();
+    }
+    return 'Unknown analytics contract error.';
+}
+
 const PRAXIS_CHART_BACKEND_MOCK_BAR = {
     schemaMeta: {
         schemaId: 'api/human-resources/vw-perfil-heroi|post|response|tenant:demo|locale:pt-BR',
@@ -3386,7 +3625,7 @@ function buildPraxisChartInteractiveWidgetPage(adapter) {
                 },
                 shell: {
                     title: 'Runtime Probe',
-                    subtitle: 'Conectado via WidgetDefinition.connections',
+                    subtitle: 'Conectado via composition.links',
                 },
             },
             withShowcaseViewToggle(adapter.toWidgetInstance(PRAXIS_CHART_BACKEND_MOCK_DONUT)),
@@ -3395,16 +3634,10 @@ function buildPraxisChartInteractiveWidgetPage(adapter) {
             withShowcaseViewToggle(adapter.toWidgetInstance(PRAXIS_CHART_BACKEND_MOCK_SCATTER)),
             withShowcaseViewToggle(adapter.toWidgetInstance(PRAXIS_CHART_BACKEND_MOCK_COMBO)),
         ],
-        connections: [
-            {
-                from: { widget: 'monthly-revenue-chart', output: 'pointClick' },
-                to: { widget: 'chart-event-probe', input: 'value' },
-            },
-            {
-                from: { widget: 'monthly-revenue-chart', output: 'pointClick' },
-                to: { widget: 'chart-drilldown-panel', input: 'selection' },
-            },
-        ],
+        composition: {
+            version: '1.0.0',
+            links: buildInteractiveCompositionLinks(),
+        },
         layout: {
             orientation: 'columns',
             columns: 2,
@@ -3454,21 +3687,19 @@ function buildPraxisChartInteractiveCanvasPage(adapter) {
             widget: withShowcaseViewToggle(adapter.toWidgetInstance(PRAXIS_CHART_BACKEND_MOCK_COMBO)),
             canvasItem: { col: 1, row: 25, colSpan: 12, rowSpan: 4 },
         },
-    ], [
-        {
-            from: { widget: 'monthly-revenue-chart', output: 'pointClick' },
-            to: { widget: 'chart-event-probe', input: 'value' },
-        },
-        {
-            from: { widget: 'monthly-revenue-chart', output: 'pointClick' },
-            to: { widget: 'chart-drilldown-panel', input: 'selection' },
-        },
-    ]);
+    ], buildInteractiveCompositionLinks());
 }
-function buildCanvasPage(entries, connections) {
+function buildCanvasPage(entries, compositionLinks) {
     return {
         widgets: entries.map((entry) => entry.widget),
-        connections,
+        ...(compositionLinks?.length
+            ? {
+                composition: {
+                    version: '1.0.0',
+                    links: compositionLinks,
+                },
+            }
+            : {}),
         canvas: {
             mode: 'grid',
             columns: 12,
@@ -3506,10 +3737,60 @@ function buildProbeWidget() {
         },
         shell: {
             title: 'Runtime Probe',
-            subtitle: 'Conectado via WidgetDefinition.connections',
+            subtitle: 'Conectado via composition.links',
         },
     };
 }
+function buildInteractiveCompositionLinks() {
+    return [
+        {
+            id: 'persisted:monthly-revenue-chart.pointClick->chart-event-probe.value',
+            from: {
+                kind: 'component-port',
+                ref: {
+                    widget: 'monthly-revenue-chart',
+                    port: 'pointClick',
+                    direction: 'output',
+                },
+            },
+            to: {
+                kind: 'component-port',
+                ref: {
+                    widget: 'chart-event-probe',
+                    port: 'value',
+                    direction: 'input',
+                },
+            },
+            intent: 'event-propagation',
+            metadata: {
+                source: 'persisted-composition-link',
+            },
+        },
+        {
+            id: 'persisted:monthly-revenue-chart.pointClick->chart-drilldown-panel.selection',
+            from: {
+                kind: 'component-port',
+                ref: {
+                    widget: 'monthly-revenue-chart',
+                    port: 'pointClick',
+                    direction: 'output',
+                },
+            },
+            to: {
+                kind: 'component-port',
+                ref: {
+                    widget: 'chart-drilldown-panel',
+                    port: 'selection',
+                    direction: 'input',
+                },
+            },
+            intent: 'event-propagation',
+            metadata: {
+                source: 'persisted-composition-link',
+            },
+        },
+    ];
+}
 function withShowcaseViewToggle(widget, initialViewMode = 'chart') {
     return {
         ...widget,
@@ -4072,123 +4353,123 @@ const PRAXIS_CHARTS_EN_US = {
 };
 
 const PRAXIS_CHARTS_PT_BR = {
-    'praxis.charts.runtime.editChart': 'Editar configuracoes do chart',
-    'praxis.charts.runtime.invalidDocumentTitle': 'Configuracao canonica invalida',
-    'praxis.charts.runtime.invalidDocumentDescription': 'O documento canonico do chart nao pode ser mapeado para o runtime atual do Praxis Charts. Revise o contrato do chart antes de continuar.',
+    'praxis.charts.runtime.editChart': 'Editar configurações do gráfico',
+    'praxis.charts.runtime.invalidDocumentTitle': 'Configuração canônica inválida',
+    'praxis.charts.runtime.invalidDocumentDescription': 'O documento canônico do gráfico não pode ser mapeado para o runtime atual do Praxis Charts. Revise o contrato do gráfico antes de continuar.',
     'praxis.charts.editor.section.general': 'Geral',
     'praxis.charts.editor.section.data': 'Dados',
     'praxis.charts.editor.section.analytics': 'Estrutura',
-    'praxis.charts.editor.section.appearance': 'Aparencia',
-    'praxis.charts.editor.section.motion': 'Motion',
+    'praxis.charts.editor.section.appearance': 'Aparência',
+    'praxis.charts.editor.section.motion': 'Movimento',
     'praxis.charts.editor.section.events': 'Eventos',
-    'praxis.charts.editor.section.preview': 'Preview',
-    'praxis.charts.editor.field.chartId': 'Chart ID',
+    'praxis.charts.editor.section.preview': 'Visualização',
+    'praxis.charts.editor.field.chartId': 'ID do Gráfico',
     'praxis.charts.editor.field.kind': 'Tipo',
-    'praxis.charts.editor.field.title': 'Titulo',
-    'praxis.charts.editor.field.subtitle': 'Subtitulo',
+    'praxis.charts.editor.field.title': 'Título',
+    'praxis.charts.editor.field.subtitle': 'Subtítulo',
     'praxis.charts.editor.field.height': 'Altura',
     'praxis.charts.editor.field.sourceKind': 'Fonte',
     'praxis.charts.editor.field.resource': 'Recurso',
-    'praxis.charts.editor.field.operation': 'Operacao',
+    'praxis.charts.editor.field.operation': 'Operação',
     'praxis.charts.editor.field.granularity': 'Granularidade',
     'praxis.charts.editor.field.fillGaps': 'Preencher intervalos sem dados',
-    'praxis.charts.editor.field.distributionMode': 'Modo da distribuicao',
+    'praxis.charts.editor.field.distributionMode': 'Modo de distribuição',
     'praxis.charts.editor.field.bucketSize': 'Tamanho do bucket',
     'praxis.charts.editor.field.bucketCount': 'Quantidade de buckets',
-    'praxis.charts.editor.field.dimension': 'Dimensao',
-    'praxis.charts.editor.field.dimensionRole': 'Papel da dimensao',
-    'praxis.charts.editor.field.metric': 'Metrica',
-    'praxis.charts.editor.field.metricLabel': 'Label da metrica',
-    'praxis.charts.editor.field.metricAggregation': 'Agregacao',
+    'praxis.charts.editor.field.dimension': 'Dimensão',
+    'praxis.charts.editor.field.dimensionRole': 'Papel da dimensão',
+    'praxis.charts.editor.field.metric': 'Métrica',
+    'praxis.charts.editor.field.metricLabel': 'Rótulo da métrica',
+    'praxis.charts.editor.field.metricAggregation': 'Agregação',
     'praxis.charts.editor.field.metricAxis': 'Eixo',
-    'praxis.charts.editor.field.metricSeriesKind': 'Tipo da serie',
+    'praxis.charts.editor.field.metricSeriesKind': 'Tipo da série',
     'praxis.charts.editor.field.legendEnabled': 'Exibir legenda',
-    'praxis.charts.editor.field.labelsEnabled': 'Exibir labels',
-    'praxis.charts.editor.field.tooltipEnabled': 'Exibir tooltip',
+    'praxis.charts.editor.field.labelsEnabled': 'Exibir rótulos',
+    'praxis.charts.editor.field.tooltipEnabled': 'Exibir dica de ferramenta (tooltip)',
     'praxis.charts.editor.field.palette': 'Cores da paleta',
-    'praxis.charts.editor.field.emptyTitle': 'Titulo do estado vazio',
-    'praxis.charts.editor.field.emptyDescription': 'Descricao do estado vazio',
-    'praxis.charts.editor.field.loadingTitle': 'Titulo do loading',
-    'praxis.charts.editor.field.loadingDescription': 'Descricao do loading',
-    'praxis.charts.editor.field.errorTitle': 'Titulo do erro',
-    'praxis.charts.editor.field.errorDescription': 'Descricao do erro',
-    'praxis.charts.editor.field.motionEnabled': 'Ativar animacoes',
-    'praxis.charts.editor.field.motionPreset': 'Preset de motion',
-    'praxis.charts.editor.field.eventAction': 'Acao',
+    'praxis.charts.editor.field.emptyTitle': 'Título do estado vazio',
+    'praxis.charts.editor.field.emptyDescription': 'Descrição do estado vazio',
+    'praxis.charts.editor.field.loadingTitle': 'Título de carregamento',
+    'praxis.charts.editor.field.loadingDescription': 'Descrição de carregamento',
+    'praxis.charts.editor.field.errorTitle': 'Título do erro',
+    'praxis.charts.editor.field.errorDescription': 'Descrição do erro',
+    'praxis.charts.editor.field.motionEnabled': 'Ativar animações',
+    'praxis.charts.editor.field.motionPreset': 'Predefinição de movimento',
+    'praxis.charts.editor.field.eventAction': 'Ação',
     'praxis.charts.editor.field.eventTarget': 'Destino',
     'praxis.charts.editor.field.eventMapping': 'Mapeamento',
-    'praxis.charts.editor.preview.title': 'Preview do chart',
-    'praxis.charts.editor.preview.caption': 'Preview local derivado do contrato canonico, sem chamadas remotas.',
-    'praxis.charts.editor.preview.invalid': 'O preview fica indisponivel enquanto houver erro bloqueante no contrato.',
-    'praxis.charts.editor.issues.title': 'Issues de validacao',
-    'praxis.charts.editor.issues.empty': 'Nenhum issue identificado.',
+    'praxis.charts.editor.preview.title': 'Visualização do gráfico',
+    'praxis.charts.editor.preview.caption': 'Visualização local derivada do contrato canônico, sem chamadas remotas.',
+    'praxis.charts.editor.preview.invalid': 'A visualização fica indisponível enquanto houver erro bloqueante no contrato.',
+    'praxis.charts.editor.issues.title': 'Problemas de validação',
+    'praxis.charts.editor.issues.empty': 'Nenhum problema identificado.',
     'praxis.charts.editor.appearance.featuresTitle': 'Recursos visuais',
     'praxis.charts.editor.appearance.paletteTitle': 'Paleta',
-    'praxis.charts.editor.appearance.paletteHint': 'Use cores separadas por virgula ou linha para persistir `theme.palette` como array canonico.',
+    'praxis.charts.editor.appearance.paletteHint': 'Use cores separadas por vírgula ou linha para persistir `theme.palette` como array canônico.',
     'praxis.charts.editor.appearance.statesTitle': 'Mensagens de estado',
-    'praxis.charts.editor.analytics.dimensionsTitle': 'Dimensoes',
-    'praxis.charts.editor.analytics.metricsTitle': 'Metricas',
-    'praxis.charts.editor.analytics.addDimension': 'Adicionar dimensao',
-    'praxis.charts.editor.analytics.addMetric': 'Adicionar metrica',
-    'praxis.charts.editor.analytics.removeDimension': 'Remover dimensao',
-    'praxis.charts.editor.analytics.removeMetric': 'Remover metrica',
-    'praxis.charts.editor.specialization.timeseriesTitle': 'Opcoes de series temporais',
-    'praxis.charts.editor.specialization.distributionTitle': 'Opcoes de distribuicao',
+    'praxis.charts.editor.analytics.dimensionsTitle': 'Dimensões',
+    'praxis.charts.editor.analytics.metricsTitle': 'Métricas',
+    'praxis.charts.editor.analytics.addDimension': 'Adicionar dimensão',
+    'praxis.charts.editor.analytics.addMetric': 'Adicionar métrica',
+    'praxis.charts.editor.analytics.removeDimension': 'Remover dimensão',
+    'praxis.charts.editor.analytics.removeMetric': 'Remover métrica',
+    'praxis.charts.editor.specialization.timeseriesTitle': 'Opções de séries temporais',
+    'praxis.charts.editor.specialization.distributionTitle': 'Opções de distribuição',
     'praxis.charts.editor.specialization.comboTitle': 'Guia de combo',
-    'praxis.charts.editor.specialization.comboHint': 'Charts combo exigem pelo menos duas metricas e permitem configurar eixo e tipo de serie por metrica.',
-    'praxis.charts.editor.specialization.pieDonutTitle': 'Guia de composicao',
-    'praxis.charts.editor.specialization.pieDonutHint': 'Charts pie e donut mantem apenas a primeira metrica e usam a primeira dimensao como segmento categorico.',
-    'praxis.charts.editor.specialization.scatterTitle': 'Guia de scatter',
-    'praxis.charts.editor.specialization.scatterHint': 'Charts scatter usam a primeira dimensao como eixo X e a primeira metrica como eixo Y.',
+    'praxis.charts.editor.specialization.comboHint': 'Gráficos combo exigem pelo menos duas métricas e permitem configurar eixo e tipo de série por métrica.',
+    'praxis.charts.editor.specialization.pieDonutTitle': 'Guia de composição',
+    'praxis.charts.editor.specialization.pieDonutHint': 'Gráficos de pizza (pie) e rosca (donut) mantêm apenas a primeira métrica e usam a primeira dimensão como segmento categórico.',
+    'praxis.charts.editor.specialization.scatterTitle': 'Guia de dispersão (scatter)',
+    'praxis.charts.editor.specialization.scatterHint': 'Gráficos de dispersão usam a primeira dimensão como eixo X e a primeira métrica como eixo Y.',
     'praxis.charts.editor.events.pointClickTitle': 'Clique no ponto',
     'praxis.charts.editor.events.drillDownTitle': 'Drill down',
     'praxis.charts.editor.events.none': 'Nenhuma',
     'praxis.charts.editor.sourceKind.praxisStats': 'praxis.stats',
-    'praxis.charts.editor.sourceKind.derived': 'derived',
-    'praxis.charts.editor.operation.groupBy': 'group-by',
-    'praxis.charts.editor.operation.timeseries': 'timeseries',
-    'praxis.charts.editor.operation.distribution': 'distribution',
-    'praxis.charts.editor.granularity.hour': 'hour',
-    'praxis.charts.editor.granularity.day': 'day',
-    'praxis.charts.editor.granularity.week': 'week',
-    'praxis.charts.editor.granularity.month': 'month',
-    'praxis.charts.editor.granularity.quarter': 'quarter',
-    'praxis.charts.editor.granularity.year': 'year',
-    'praxis.charts.editor.distributionMode.terms': 'terms',
-    'praxis.charts.editor.distributionMode.histogram': 'histogram',
+    'praxis.charts.editor.sourceKind.derived': 'derivado',
+    'praxis.charts.editor.operation.groupBy': 'agrupar por',
+    'praxis.charts.editor.operation.timeseries': 'série temporal',
+    'praxis.charts.editor.operation.distribution': 'distribuição',
+    'praxis.charts.editor.granularity.hour': 'hora',
+    'praxis.charts.editor.granularity.day': 'dia',
+    'praxis.charts.editor.granularity.week': 'semana',
+    'praxis.charts.editor.granularity.month': 'mês',
+    'praxis.charts.editor.granularity.quarter': 'trimestre',
+    'praxis.charts.editor.granularity.year': 'ano',
+    'praxis.charts.editor.distributionMode.terms': 'termos',
+    'praxis.charts.editor.distributionMode.histogram': 'histograma',
     'praxis.charts.editor.motionPreset.subtle': 'sutil',
-    'praxis.charts.editor.motionPreset.standard': 'padrao',
+    'praxis.charts.editor.motionPreset.standard': 'padrão',
     'praxis.charts.editor.motionPreset.expressive': 'expressivo',
-    'praxis.charts.editor.dimensionRole.category': 'category',
-    'praxis.charts.editor.dimensionRole.series': 'series',
-    'praxis.charts.editor.dimensionRole.segment': 'segment',
-    'praxis.charts.editor.dimensionRole.time': 'time',
-    'praxis.charts.editor.dimensionRole.value': 'value',
-    'praxis.charts.editor.metricAggregation.sum': 'sum',
-    'praxis.charts.editor.metricAggregation.count': 'count',
-    'praxis.charts.editor.metricAggregation.avg': 'avg',
-    'praxis.charts.editor.metricAggregation.min': 'min',
-    'praxis.charts.editor.metricAggregation.max': 'max',
-    'praxis.charts.editor.metricAxis.primary': 'primary',
-    'praxis.charts.editor.metricAxis.secondary': 'secondary',
-    'praxis.charts.editor.metricSeriesKind.bar': 'bar',
-    'praxis.charts.editor.metricSeriesKind.line': 'line',
-    'praxis.charts.editor.metricSeriesKind.area': 'area',
-    'praxis.charts.editor.eventAction.filter-widget': 'filter-widget',
-    'praxis.charts.editor.eventAction.open-detail': 'open-detail',
-    'praxis.charts.editor.eventAction.navigate': 'navigate',
-    'praxis.charts.editor.eventAction.update-context': 'update-context',
-    'praxis.charts.editor.eventAction.emit': 'emit',
-    'praxis.charts.editor.kind.bar': 'Bar',
-    'praxis.charts.editor.kind.horizontal-bar': 'Horizontal Bar',
-    'praxis.charts.editor.kind.line': 'Line',
-    'praxis.charts.editor.kind.area': 'Area',
-    'praxis.charts.editor.kind.stacked-bar': 'Stacked Bar',
-    'praxis.charts.editor.kind.stacked-area': 'Stacked Area',
-    'praxis.charts.editor.kind.combo': 'Combo',
-    'praxis.charts.editor.kind.pie': 'Pie',
-    'praxis.charts.editor.kind.donut': 'Donut',
-    'praxis.charts.editor.kind.scatter': 'Scatter',
+    'praxis.charts.editor.dimensionRole.category': 'categoria',
+    'praxis.charts.editor.dimensionRole.series': 'série',
+    'praxis.charts.editor.dimensionRole.segment': 'segmento',
+    'praxis.charts.editor.dimensionRole.time': 'tempo',
+    'praxis.charts.editor.dimensionRole.value': 'valor',
+    'praxis.charts.editor.metricAggregation.sum': 'soma',
+    'praxis.charts.editor.metricAggregation.count': 'contagem',
+    'praxis.charts.editor.metricAggregation.avg': 'média',
+    'praxis.charts.editor.metricAggregation.min': 'mínimo',
+    'praxis.charts.editor.metricAggregation.max': 'máximo',
+    'praxis.charts.editor.metricAxis.primary': 'primário',
+    'praxis.charts.editor.metricAxis.secondary': 'secundário',
+    'praxis.charts.editor.metricSeriesKind.bar': 'barra',
+    'praxis.charts.editor.metricSeriesKind.line': 'linha',
+    'praxis.charts.editor.metricSeriesKind.area': 'área',
+    'praxis.charts.editor.eventAction.filter-widget': 'filtrar widget',
+    'praxis.charts.editor.eventAction.open-detail': 'abrir detalhes',
+    'praxis.charts.editor.eventAction.navigate': 'navegar',
+    'praxis.charts.editor.eventAction.update-context': 'atualizar contexto',
+    'praxis.charts.editor.eventAction.emit': 'emitir',
+    'praxis.charts.editor.kind.bar': 'Barra',
+    'praxis.charts.editor.kind.horizontal-bar': 'Barra Horizontal',
+    'praxis.charts.editor.kind.line': 'Linha',
+    'praxis.charts.editor.kind.area': 'Área',
+    'praxis.charts.editor.kind.stacked-bar': 'Barra Empilhada',
+    'praxis.charts.editor.kind.stacked-area': 'Área Empilhada',
+    'praxis.charts.editor.kind.combo': 'Combinado (Combo)',
+    'praxis.charts.editor.kind.pie': 'Pizza (Pie)',
+    'praxis.charts.editor.kind.donut': 'Rosca (Donut)',
+    'praxis.charts.editor.kind.scatter': 'Dispersão (Scatter)',
 };
 
 const PRAXIS_CHARTS_I18N = new InjectionToken('PRAXIS_CHARTS_I18N', {
@@ -4999,4 +5280,4 @@ var praxisChartConfigEditor = /*#__PURE__*/Object.freeze({
  * Generated bundle index. Do not edit.
  */
 
-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 { 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 };

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.9",
+  "version": "5.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.9"
+    "@praxisui/core": "^5.0.0-beta.0"
   },
   "dependencies": {
     "echarts": "^6.0.0",