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

package/index.d.ts

@@ -1,11 +1,11 @@
+import * as _praxisui_charts from '@praxisui/charts';
 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 * as _praxisui_charts from '@praxisui/charts';
+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;
@@ -164,6 +185,24 @@ interface PraxisChartTooltipConfig {
     enabled?: boolean;
     trigger?: 'item' | 'axis';
 }
+type PraxisChartThemeVariant = 'default' | 'compact' | 'executive';
+declare const PRAXIS_CHART_PALETTE_TOKENS: {
+    readonly 'brand-primary': readonly ["#1263b4", "#0f766e", "#f08c00", "#c92a2a", "#7b61ff"];
+    readonly 'brand-balanced': readonly ["#1263b4", "#15803d", "#7c3aed", "#c2410c", "#be123c"];
+    readonly status: readonly ["#15803d", "#ca8a04", "#dc2626", "#2563eb", "#7c3aed"];
+    readonly executive: readonly ["#14b8a6", "#f59e0b", "#e11d48", "#8b5cf6", "#38bdf8"];
+};
+type PraxisChartPaletteToken = keyof typeof PRAXIS_CHART_PALETTE_TOKENS;
+declare function isPraxisChartPaletteToken(value: string): value is PraxisChartPaletteToken;
+declare function resolvePraxisChartPaletteToken(value: string): string[] | undefined;
+type PraxisChartSurfaceMode = 'auto' | 'embedded' | 'contained';
+interface PraxisChartSurfaceConfig {
+    mode?: PraxisChartSurfaceMode;
+    background?: string;
+    borderColor?: string;
+    borderWidth?: number | string;
+    borderRadius?: number | string;
+}
 interface PraxisChartThemeConfig {
     palette?: string[];
     backgroundColor?: string;
@@ -171,13 +210,23 @@ interface PraxisChartThemeConfig {
     borderRadius?: number;
     legend?: PraxisChartLegendConfig;
     tooltip?: PraxisChartTooltipConfig;
+    surface?: PraxisChartSurfaceConfig;
 }
+declare const PRAXIS_CHART_THEME_VARIANTS: Record<PraxisChartThemeVariant, PraxisChartThemeConfig>;
 
 type PraxisChartMotionPreset = 'subtle' | 'standard' | 'expressive';
 interface PraxisChartMotionConfig {
     enabled?: boolean;
     preset?: PraxisChartMotionPreset;
 }
+type PraxisChartSizingMode = 'fixed' | 'fill-container' | 'auto';
+interface PraxisChartSizingConfig {
+    mode?: PraxisChartSizingMode;
+    height?: number | string;
+    minHeight?: number | string;
+    maxHeight?: number | string;
+    aspectRatio?: number | string;
+}
 interface PraxisChartEmptyStateConfig {
     title?: PraxisTextValue;
     description?: PraxisTextValue;
@@ -199,6 +248,8 @@ interface PraxisChartConfig {
     orientation?: 'vertical' | 'horizontal';
     title?: PraxisTextValue;
     subtitle?: PraxisTextValue;
+    sizing?: PraxisChartSizingConfig;
+    /** @deprecated Use sizing.height with sizing.mode="fixed". */
     height?: number | string;
     axes?: {
         x?: PraxisChartAxisConfig;
@@ -257,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;
@@ -281,15 +332,32 @@ interface PraxisXUiChartSource {
 interface PraxisXUiChartToggleableFeature {
     enabled: boolean;
 }
+type PraxisXUiChartSurfaceMode = 'auto' | 'embedded' | 'contained';
+interface PraxisXUiChartSurface {
+    mode?: PraxisXUiChartSurfaceMode;
+    background?: string;
+    borderColor?: string;
+    borderWidth?: number | string;
+    borderRadius?: number | string;
+}
 interface PraxisXUiChartTheme {
     palette?: string | string[];
     variant?: 'default' | 'compact' | 'executive';
+    surface?: PraxisXUiChartSurface;
 }
 type PraxisXUiChartMotionPreset = 'subtle' | 'standard' | 'expressive';
 interface PraxisXUiChartMotion {
     enabled?: boolean;
     preset?: PraxisXUiChartMotionPreset;
 }
+type PraxisXUiChartSizingMode = 'fixed' | 'fill-container' | 'auto';
+interface PraxisXUiChartSizing {
+    mode?: PraxisXUiChartSizingMode;
+    height?: number | string;
+    minHeight?: number | string;
+    maxHeight?: number | string;
+    aspectRatio?: number | string;
+}
 interface PraxisXUiChartStateDescriptor {
     title?: PraxisXUiChartTextValue;
     description?: PraxisXUiChartTextValue;
@@ -318,6 +386,8 @@ interface PraxisXUiChartContract {
     orientation?: 'vertical' | 'horizontal';
     title?: PraxisXUiChartTextValue;
     subtitle?: PraxisXUiChartTextValue;
+    sizing?: PraxisXUiChartSizing;
+    /** @deprecated Use sizing.height with sizing.mode="fixed". */
     height?: number | string;
     source: PraxisXUiChartSource;
     dimensions?: PraxisXUiChartDimension[];
@@ -375,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>;
@@ -405,11 +478,21 @@ declare class PraxisChartComponent {
     private readonly fillContainerHeight;
     private resizeFrameId;
     private previousRemoteSignature;
+    private previousRemoteDataResolver;
     private previousDocumentSignature;
     private editorSessionSubscriptions;
     readonly effectiveConfig: _angular_core.Signal<PraxisChartConfig>;
     readonly resolvedData: _angular_core.Signal<PraxisChartDataRow[]>;
     readonly resolvedHeight: _angular_core.Signal<string>;
+    readonly resolvedMinHeight: _angular_core.Signal<string | null>;
+    readonly resolvedMaxHeight: _angular_core.Signal<string | null>;
+    readonly resolvedAspectRatio: _angular_core.Signal<string | null>;
+    readonly isFillContainerMode: _angular_core.Signal<boolean>;
+    readonly surfaceMode: _angular_core.Signal<_praxisui_charts.PraxisChartSurfaceMode>;
+    readonly surfaceBackground: _angular_core.Signal<string | null>;
+    readonly surfaceBorderColor: _angular_core.Signal<string | null>;
+    readonly surfaceBorderWidth: _angular_core.Signal<string | null>;
+    readonly surfaceBorderRadius: _angular_core.Signal<string | null>;
     readonly renderConfig: _angular_core.Signal<PraxisChartConfig>;
     readonly loadingLabel: _angular_core.Signal<string>;
     readonly emptyTitle: _angular_core.Signal<string>;
@@ -421,15 +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 {
@@ -557,10 +649,14 @@ declare function providePraxisCharts(): Provider[];
 declare class ChartContractNormalizerService {
     normalize(input: PraxisXUiChartContract): PraxisXUiChartContract;
     private normalizeMotion;
+    private normalizeSizing;
     private normalizeKindSpecificFields;
     private normalizeOperationSpecificFields;
     private normalizeSourceSpecificFields;
     private isDistribution;
+    private normalizeCssSizeValue;
+    private normalizeAspectRatioValue;
+    private omitUndefined;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChartContractNormalizerService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<ChartContractNormalizerService>;
 }
@@ -582,10 +678,15 @@ declare class ChartContractValidationService {
     private validateSource;
     private validateTheme;
     private validateMetrics;
+    private validateSizing;
     private validateKinds;
     private validateEvents;
     private validateEventAction;
     private error;
+    private validateCssSize;
+    private isValidCssSize;
+    private numericCssSize;
+    private isValidAspectRatio;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChartContractValidationService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<ChartContractValidationService>;
 }
@@ -601,6 +702,7 @@ declare class PraxisChartCanonicalContractMapperService {
     private buildQuery;
     private buildInteractions;
     private buildTheme;
+    private resolveThemePalette;
     private buildMotion;
     private resolveOrientation;
     private resolveSeriesType;
@@ -670,6 +772,9 @@ declare class PraxisChartOptionBuilderService {
     constructor(transformer: PraxisChartDataTransformerService);
     build(config: PraxisChartConfig, rows: PraxisChartDataRow[]): EChartsCoreOption;
     private resolveText;
+    private hasText;
+    private buildTitle;
+    private buildLegend;
     private buildGrid;
     private buildCartesianYAxis;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PraxisChartOptionBuilderService, never>;
@@ -830,9 +935,9 @@ declare class PraxisChartCompositionShowcaseComponent {
     }>;
     protected readonly widgetPage: _angular_core.Signal<{
         composition?: _praxisui_core.WidgetPageCompositionDefinition | undefined;
+        state?: _praxisui_core.WidgetPageStateInput | 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;
@@ -844,9 +949,9 @@ declare class PraxisChartCompositionShowcaseComponent {
     }>;
     protected readonly canvasPage: _angular_core.Signal<({
         composition?: _praxisui_core.WidgetPageCompositionDefinition | undefined;
+        state?: _praxisui_core.WidgetPageStateInput | 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;
@@ -877,8 +982,8 @@ declare class PraxisChartCompositionShowcaseComponent {
             collisionPolicy?: _praxisui_core.WidgetPageCanvasCollisionPolicy;
         };
         composition?: _praxisui_core.WidgetPageCompositionDefinition | undefined;
-        context?: Record<string, any> | undefined;
         state?: _praxisui_core.WidgetPageStateInput | undefined;
+        context?: Record<string, any> | undefined;
         layout?: _praxisui_core.WidgetPageLayout | undefined;
         layoutPreset?: string | undefined;
         layoutPresetOptions?: Record<string, any> | undefined;
@@ -889,9 +994,9 @@ declare class PraxisChartCompositionShowcaseComponent {
     }>;
     protected readonly resolvedPage: _angular_core.Signal<{
         composition?: _praxisui_core.WidgetPageCompositionDefinition | undefined;
+        state?: _praxisui_core.WidgetPageStateInput | 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;
@@ -914,8 +1019,8 @@ declare class PraxisChartCompositionShowcaseComponent {
             collisionPolicy?: _praxisui_core.WidgetPageCanvasCollisionPolicy;
         };
         composition?: _praxisui_core.WidgetPageCompositionDefinition | undefined;
-        context?: Record<string, any> | undefined;
         state?: _praxisui_core.WidgetPageStateInput | undefined;
+        context?: Record<string, any> | undefined;
         layout?: _praxisui_core.WidgetPageLayout | undefined;
         layoutPreset?: string | undefined;
         layoutPresetOptions?: Record<string, any> | undefined;
@@ -962,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">;
@@ -985,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[];
@@ -993,6 +1098,11 @@ declare class PraxisChartConfigEditor implements SettingsValueProvider {
     readonly metricSeriesKinds: Array<NonNullable<PraxisXUiChartMetric['seriesKind']>>;
     readonly motionPresets: readonly ["subtle", "standard", "expressive"];
     readonly eventActionOptions: PraxisXUiChartEventAction['action'][];
+    readonly sizingModes: PraxisXUiChartSizingMode[];
+    readonly surfaceModes: PraxisXUiChartSurfaceMode[];
+    readonly themeVariants: PraxisChartThemeVariant[];
+    readonly paletteModes: readonly ["token", "custom"];
+    readonly paletteTokens: PraxisChartPaletteToken[];
     readonly activeSection: _angular_core.WritableSignal<ChartEditorSection>;
     private readonly injectedData;
     private readonly defaults;
@@ -1022,6 +1132,11 @@ declare class PraxisChartConfigEditor implements SettingsValueProvider {
     setTitle(value: string): void;
     setSubtitle(value: string): void;
     setHeight(value: string): void;
+    setSizingMode(mode: PraxisXUiChartSizingMode): void;
+    setSizingHeight(value: string): void;
+    setSizingMinHeight(value: string): void;
+    setSizingMaxHeight(value: string): void;
+    setSizingAspectRatio(value: string): void;
     setSourceKind(value: 'praxis.stats' | 'derived'): void;
     setResource(value: string): void;
     setOperation(value: PraxisXUiChartStatsOperation): void;
@@ -1044,7 +1159,11 @@ declare class PraxisChartConfigEditor implements SettingsValueProvider {
     setMotionEnabled(enabled: boolean): void;
     setMotionPreset(preset: 'subtle' | 'standard' | 'expressive'): void;
     setFeatureEnabled(feature: ChartFeatureKey, enabled: boolean): void;
+    setThemeVariant(variant: PraxisChartThemeVariant | ''): void;
+    setPaletteMode(mode: typeof this.paletteModes[number]): void;
+    setPaletteToken(token: PraxisChartPaletteToken): void;
     setPalette(value: string): void;
+    setSurfaceMode(mode: PraxisXUiChartSurfaceMode): void;
     setStateTitle(stateKey: ChartStateKey, value: string): void;
     setStateDescription(stateKey: ChartStateKey, value: string): void;
     setEventAction(eventKey: ChartEventKey, action: PraxisXUiChartEventAction['action'] | ''): void;
@@ -1061,8 +1180,16 @@ declare class PraxisChartConfigEditor implements SettingsValueProvider {
     bucketSizeValue(): string;
     bucketCountValue(): string;
     heightValue(): string;
+    sizingModeValue(): PraxisXUiChartSizingMode;
+    sizingMinHeightValue(): string;
+    sizingMaxHeightValue(): string;
+    sizingAspectRatioValue(): string;
     featureEnabled(feature: ChartFeatureKey): boolean;
     paletteValue(): string;
+    paletteModeValue(): typeof this.paletteModes[number];
+    paletteTokenValue(): PraxisChartPaletteToken;
+    themeVariantValue(): PraxisChartThemeVariant | '';
+    surfaceModeValue(): PraxisXUiChartSurfaceMode;
     stateTitle(stateKey: ChartStateKey): string;
     stateDescription(stateKey: ChartStateKey): string;
     eventAction(eventKey: ChartEventKey): PraxisXUiChartEventAction['action'] | '';
@@ -1085,6 +1212,8 @@ declare class PraxisChartConfigEditor implements SettingsValueProvider {
     private patchStateDescriptor;
     private patchEvent;
     private parseMappingText;
+    private normalizeSizingSizeInput;
+    private mergeTheme;
     private createApplyPayload;
     private createSavePayload;
     private patchDocument;
@@ -1131,5 +1260,5 @@ declare function providePraxisChartDrilldownPanelMetadata(): Provider;
 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_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 };
+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, 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": "7.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": "^7.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": {