@aquera/nile-visualization 0.5.0 → 0.7.0

package/dist/src/index.d.ts

@@ -7,10 +7,10 @@ export type { TrendlineSeriesData, ForecastConfig } from './nile-trendline-chart
 export { NileAnomalyChart } from './nile-anomaly-chart/index.js';
 export type { AnomalySeriesData, AnomalyConfig } from './nile-anomaly-chart/index.js';
 export { NileChart } from './nile-chart/index.js';
-export type { NileChartConfig, NileBarChartConfig, NilePieChartConfig, NileTrendlineChartConfig, NileAnomalyChartConfig, NileLineChartConfig, NileAreaChartConfig, NileColumnChartConfig, NileDonutChartConfig, NileScatterChartConfig, NileBubbleChartConfig, NileSplineChartConfig, NileRadarChartConfig, NileGaugeChartConfig, NileWaterfallChartConfig, NileKpiChartConfig, ChartType, SwitchAggregation, NileAiConfig, } from './nile-chart/index.js';
+export type { NileChartConfig, NileBarChartConfig, NilePieChartConfig, NileTrendlineChartConfig, NileAnomalyChartConfig, NileLineChartConfig, NileAreaChartConfig, NileColumnChartConfig, NileDonutChartConfig, NileScatterChartConfig, NileBubbleChartConfig, NileSplineChartConfig, NileRadarChartConfig, NileGaugeChartConfig, NileWaterfallChartConfig, NileMapChartConfig, NileKpiChartConfig, ChartType, SwitchAggregation, NileAiConfig, } from './nile-chart/index.js';
 export { convertConfig, registerAdapter } from './nile-chart/index.js';
 export { nileChartConfig } from './nile-chart/index.js';
-export type { AiConfigType, SwitchableConfigType, AqConfigType, ChartBarConfigType, ChartPieConfigType, ChartTrendlineConfigType, ChartAnomalyConfigType, ChartLineConfigType, ChartAreaConfigType, ChartInvertedAreaConfigType, ChartColumnConfigType, ChartDonutConfigType, ChartScatterConfigType, ChartBubbleConfigType, ChartSplineConfigType, ChartRadarConfigType, ChartGaugeConfigType, ChartWaterfallConfigType, ChartClusterConfigType, ChartStackedConfigType, ChartHistogramConfigType, ChartBellcurveConfigType, ChartBoxplotConfigType, ChartTimelineConfigType, ChartDumbbellConfigType, ChartDumbbellLowerConfigType, ChartDumbbellUpperConfigType, ChartColumnPyramidConfigType, ChartLollipopConfigType, ChartAreaSplineConfigType, ChartAreaNegativeConfigType, ChartAreaRangeConfigType, ChartColumnRangeConfigType, ChartColumnDrilldownConfigType, ChartRadialBarConfigType, ChartVariablePieConfigType, ChartEulerConfigType, ChartPolygonConfigType, ChartVectorConfigType, ChartXrangeConfigType, ChartFanConfigType, ChartFunnelConfigType, ChartOrganizationConfigType, ChartLineColumnConfigType, ChartHeatmapConfigType, ChartFlameConfigType, ChartSpiderwebConfigType, ChartKpiConfigType, ChartKpiPropsType, PrimitiveChartConfigType, SeparatedChartConfigInputType, AllChartConfigType, ChartConfigType, NileChartConfigInputType, ChartAiPanelPayload, ChartAiSenderPayload, NileAiPanelConfigInputType, NileAiSenderConfigInputType, } from './nile-chart/index.js';
+export type { AiConfigType, SwitchableConfigType, AqConfigType, ChartBarConfigType, ChartPieConfigType, ChartTrendlineConfigType, ChartAnomalyConfigType, ChartLineConfigType, ChartAreaConfigType, ChartInvertedAreaConfigType, ChartColumnConfigType, ChartDonutConfigType, ChartScatterConfigType, ChartBubbleConfigType, ChartSplineConfigType, ChartRadarConfigType, ChartGaugeConfigType, ChartWaterfallConfigType, ChartClusterConfigType, ChartStackedConfigType, ChartHistogramConfigType, ChartBellcurveConfigType, ChartBoxplotConfigType, ChartTimelineConfigType, ChartDumbbellConfigType, ChartDumbbellLowerConfigType, ChartDumbbellUpperConfigType, ChartColumnPyramidConfigType, ChartLollipopConfigType, ChartAreaSplineConfigType, ChartAreaNegativeConfigType, ChartAreaRangeConfigType, ChartColumnRangeConfigType, ChartColumnDrilldownConfigType, ChartRadialBarConfigType, ChartVariablePieConfigType, ChartEulerConfigType, ChartPolygonConfigType, ChartVectorConfigType, ChartXrangeConfigType, ChartFanConfigType, ChartFunnelConfigType, ChartOrganizationConfigType, ChartLineColumnConfigType, ChartHeatmapConfigType, ChartFlameConfigType, ChartSpiderwebConfigType, ChartKpiConfigType, ChartKpiPropsType, ChartMapConfigType, PrimitiveChartConfigType, SeparatedChartConfigInputType, AllChartConfigType, ChartConfigType, NileChartConfigInputType, ChartAiPanelPayload, ChartAiSenderPayload, NileAiPanelConfigInputType, NileAiSenderConfigInputType, } from './nile-chart/index.js';
 export type { SeparatedChartDemoConfig } from './internal/separated-chart-config.js';
 export { NileLineChart } from './nile-line-chart/index.js';
 export type { LineChartSeriesData } from './nile-line-chart/index.js';
@@ -92,5 +92,11 @@ export { NileSpiderwebChart } from './nile-spiderweb-chart/index.js';
 export type { SpiderwebChartSeriesData } from './nile-spiderweb-chart/index.js';
 export { NileKpiChart } from './nile-kpi-chart/index.js';
 export type { ChartKpiSeparatedPayload, KpiConfig, NileKpiConfigInputType, TrendDirection, KpiVariant, } from './nile-kpi-chart/index.js';
+export { NileMapChart } from './nile-map-chart/index.js';
+export type { MapChartDataPoint } from './nile-map-chart/index.js';
 export { NileAiSender } from './nile-ai-sender/index.js';
 export { NileAiPanel } from './nile-ai-panel/index.js';
+export { NileWidgetViewer } from './nile-widget-viewer/index.js';
+export type { NileWidgetConfig, NileWidgetChartConfig, NileWidgetKpiConfig, WidgetLayout, } from './nile-widget-viewer/index.js';
+export { NileDashboardViewer } from './nile-dashboard-viewer/index.js';
+export type { NileDashboardConfig } from './nile-dashboard-viewer/index.js';

package/dist/src/index.js

@@ -49,6 +49,9 @@ export { NileHeatmapChart } from './nile-heatmap-chart/index.js';
 export { NileFlameChart } from './nile-flame-chart/index.js';
 export { NileSpiderwebChart } from './nile-spiderweb-chart/index.js';
 export { NileKpiChart } from './nile-kpi-chart/index.js';
+export { NileMapChart } from './nile-map-chart/index.js';
 export { NileAiSender } from './nile-ai-sender/index.js';
 export { NileAiPanel } from './nile-ai-panel/index.js';
+export { NileWidgetViewer } from './nile-widget-viewer/index.js';
+export { NileDashboardViewer } from './nile-dashboard-viewer/index.js';
 //# sourceMappingURL=index.js.map

package/dist/src/internal/dashboard-adapters.d.ts

@@ -0,0 +1,13 @@
+import type { NileDashboardConfig } from './types/dashboard-config.type.js';
+/**
+ * Converts a raw API dashboard response into a `NileDashboardConfig` ready for
+ * `<nile-dashboard-viewer>`.
+ *
+ * Handles:
+ * - `widgetType` → `type` rename
+ * - API chart `series[].data[].value` → `data[].y` (pie/donut)
+ * - Multi-series format for bar/line/column/area etc.
+ * - KPI sub-object: adds the `type: 'kpi'` discriminator
+ * - Nested `{ success, data: { ... } }` API envelope
+ */
+export declare function fromApiDashboardResponse(apiResponse: unknown): NileDashboardConfig;

package/dist/src/internal/dashboard-adapters.js

@@ -0,0 +1,123 @@
+// ─── Pie / donut series adapter ─────────────────────────────────────────────
+function adaptPieSeries(series) {
+    const first = series[0];
+    const data = (first?.data ?? []).map((point) => {
+        if (typeof point === 'number')
+            return { name: '', y: point };
+        return {
+            name: point.name ?? '',
+            y: point.value ?? point.y ?? 0,
+        };
+    });
+    return { data, seriesName: first?.name };
+}
+// ─── Multi-series adapter (bar, line, column, area, etc.) ───────────────────
+function adaptMultiSeries(series) {
+    return series.map((s) => ({
+        name: s.name ?? '',
+        data: (s.data ?? []).map((point) => {
+            if (typeof point === 'number')
+                return point;
+            return point.value ?? point.y ?? 0;
+        }),
+    }));
+}
+// ─── Chart widget adapter ────────────────────────────────────────────────────
+function adaptChartWidget(apiChart) {
+    const { type = 'bar', title, series = [], ...rest } = apiChart;
+    const aq = title ? { chartTitle: title } : undefined;
+    switch (type) {
+        case 'pie':
+        case 'donut': {
+            const { data, seriesName } = adaptPieSeries(series);
+            return { chart: { type: type, data, seriesName, ...rest }, aq };
+        }
+        default: {
+            // bar, line, column, area, spline, stacked, cluster, etc.
+            const data = adaptMultiSeries(series);
+            return { chart: { type: type, data, ...rest }, aq };
+        }
+    }
+}
+// ─── KPI widget adapter ──────────────────────────────────────────────────────
+function adaptKpiWidget(apiKpi) {
+    return {
+        chart: {
+            type: 'kpi',
+            variant: apiKpi.variant,
+            label: apiKpi.label,
+            value: apiKpi.value,
+            prefix: apiKpi.prefix,
+            suffix: apiKpi.suffix,
+            trendValue: apiKpi.trendValue ?? null,
+            trendDirection: apiKpi.trendDirection,
+            trendLabel: apiKpi.trendLabel,
+            description: apiKpi.description,
+            sparkline: apiKpi.sparkline,
+            gaugeValue: apiKpi.gaugeValue,
+            gaugeMin: apiKpi.gaugeMin,
+            gaugeMax: apiKpi.gaugeMax,
+        },
+    };
+}
+// ─── Widget adapter ──────────────────────────────────────────────────────────
+function adaptWidget(apiWidget) {
+    const layout = apiWidget.layout ?? { x: 0, y: 0, w: 6, h: 4 };
+    const widgetType = apiWidget.widgetType ?? apiWidget.type;
+    // Already in NileWidgetConfig shape — pass through
+    if (apiWidget.nileConfig) {
+        return {
+            id: apiWidget.id,
+            title: apiWidget.title,
+            type: widgetType,
+            layout,
+            nileConfig: apiWidget.nileConfig,
+        };
+    }
+    if (widgetType === 'chart' && apiWidget.chart) {
+        return {
+            id: apiWidget.id,
+            title: apiWidget.title,
+            type: 'chart',
+            layout,
+            nileConfig: adaptChartWidget(apiWidget.chart),
+        };
+    }
+    if (widgetType === 'kpi' && apiWidget.kpi) {
+        return {
+            id: apiWidget.id,
+            title: apiWidget.title,
+            type: 'kpi',
+            layout,
+            nileConfig: adaptKpiWidget(apiWidget.kpi),
+        };
+    }
+    return null;
+}
+// ─── Public API ──────────────────────────────────────────────────────────────
+/**
+ * Converts a raw API dashboard response into a `NileDashboardConfig` ready for
+ * `<nile-dashboard-viewer>`.
+ *
+ * Handles:
+ * - `widgetType` → `type` rename
+ * - API chart `series[].data[].value` → `data[].y` (pie/donut)
+ * - Multi-series format for bar/line/column/area etc.
+ * - KPI sub-object: adds the `type: 'kpi'` discriminator
+ * - Nested `{ success, data: { ... } }` API envelope
+ */
+export function fromApiDashboardResponse(apiResponse) {
+    const raw = apiResponse;
+    // Unwrap common `{ success, data: { ... } }` envelope
+    const payload = raw?.data ?? raw;
+    const widgets = (payload?.widgets ?? [])
+        .map(adaptWidget)
+        .filter((w) => w !== null);
+    return {
+        id: payload?.id,
+        name: payload?.name,
+        description: payload?.description,
+        widgets,
+    };
+}
+//# sourceMappingURL=dashboard-adapters.js.map

package/dist/src/internal/highcharts-provider.js

@@ -122,6 +122,33 @@ async function init() {
         catch {
             // xrange not available — consumer may have loaded it globally
         }
+        try {
+            const map = await import('highcharts/modules/map.js');
+            if (typeof map.default === 'function') {
+                map.default(_Highcharts);
+            }
+        }
+        catch {
+            // highcharts/modules/map not available — consumer may have loaded it globally
+        }
+        try {
+            const patternFill = await import('highcharts/modules/pattern-fill.js');
+            if (typeof patternFill.default === 'function') {
+                patternFill.default(_Highcharts);
+            }
+        }
+        catch {
+            // pattern-fill not available — consumer may have loaded it globally
+        }
+        try {
+            const tiledwebmap = await import('highcharts/modules/tiledwebmap.js');
+            if (typeof tiledwebmap.default === 'function') {
+                tiledwebmap.default(_Highcharts);
+            }
+        }
+        catch {
+            // tiledwebmap not available — consumer may have loaded it globally
+        }
         try {
             const sankey = await import('highcharts/modules/sankey.js');
             if (typeof sankey.default === 'function') {

package/dist/src/internal/types/chart-config.type.d.ts

@@ -12,6 +12,7 @@ import type { ChartSplineConfigType } from './chart-spline-config.type.js';
 import type { ChartRadarConfigType } from './chart-radar-config.type.js';
 import type { ChartGaugeConfigType } from './chart-gauge-config.type.js';
 import type { ChartWaterfallConfigType } from './chart-waterfall-config.type.js';
+import type { ChartMapConfigType } from './chart-map-config.type.js';
 import type { PrimitiveChartConfigType } from './primitive-chart-config.type.js';
 /** Core chart configs (bar, pie, …) plus all primitive series types — use with `<nile-chart>` via `chart.type`. */
-export type ChartConfigType = ChartBarConfigType | ChartPieConfigType | ChartTrendlineConfigType | ChartAnomalyConfigType | ChartLineConfigType | ChartAreaConfigType | ChartColumnConfigType | ChartDonutConfigType | ChartScatterConfigType | ChartBubbleConfigType | ChartSplineConfigType | ChartRadarConfigType | ChartGaugeConfigType | ChartWaterfallConfigType | PrimitiveChartConfigType;
+export type ChartConfigType = ChartBarConfigType | ChartPieConfigType | ChartTrendlineConfigType | ChartAnomalyConfigType | ChartLineConfigType | ChartAreaConfigType | ChartColumnConfigType | ChartDonutConfigType | ChartScatterConfigType | ChartBubbleConfigType | ChartSplineConfigType | ChartRadarConfigType | ChartGaugeConfigType | ChartWaterfallConfigType | ChartMapConfigType | PrimitiveChartConfigType;

package/dist/src/internal/types/chart-map-config.type.d.ts

@@ -0,0 +1,29 @@
+import type { Options } from 'highcharts';
+import type { MapChartDataPoint } from '../../nile-map-chart/nile-map-chart.js';
+/** Highcharts Maps chart config. */
+export interface ChartMapConfigType {
+    type: 'map';
+    /** Array of data points joined against the map topology. */
+    data: MapChartDataPoint[];
+    /**
+     * GeoJSON or Highcharts topology object for the map shapes.
+     * Obtain from https://code.highcharts.com/mapdata/ or supply your own.
+     */
+    mapData?: object;
+    /**
+     * How to join data against mapData. Defaults to `['hc-key', 'hc-key']`.
+     * Pass a string to use the same key on both sides,
+     * or a two-element array `[mapKey, dataKey]` for different key names.
+     */
+    joinBy?: string | string[];
+    /**
+     * Type of the primary series. Default: `'map'`.
+     * For multi-series or `tiledwebmap`, pass `options.series` directly.
+     */
+    seriesType?: 'map' | 'mapline' | 'mappoint' | 'mapbubble' | 'tiledwebmap';
+    /** Enable mouse-wheel zoom, double-click zoom, and +/− buttons. Default: true. */
+    zoom?: boolean;
+    height?: string;
+    loading?: boolean;
+    options?: Options;
+}

package/dist/src/internal/types/chart-map-config.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=chart-map-config.type.js.map

package/dist/src/internal/types/dashboard-config.type.d.ts

@@ -0,0 +1,8 @@
+import type { NileWidgetConfig } from './widget-config.type.js';
+/** Full dashboard configuration passed to `<nile-dashboard-viewer>`. */
+export interface NileDashboardConfig {
+    id?: string;
+    name?: string;
+    description?: string;
+    widgets: NileWidgetConfig[];
+}

package/dist/src/internal/types/dashboard-config.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dashboard-config.type.js.map

package/dist/src/internal/types/index.d.ts

@@ -45,6 +45,7 @@ export type { ChartHeatmapConfigType } from './chart-heatmap-config.type.js';
 export type { ChartFlameConfigType } from './chart-flame-config.type.js';
 export type { ChartSpiderwebConfigType } from './chart-spiderweb-config.type.js';
 export type { ChartKpiConfigType, ChartKpiPropsType } from './chart-kpi-config.type.js';
+export type { ChartMapConfigType } from './chart-map-config.type.js';
 export type { PrimitiveChartConfigType } from './primitive-chart-config.type.js';
 export type { SeparatedChartConfigInputType } from './separated-chart-config-input.type.js';
 export type { AllChartConfigType } from './all-chart-config.type.js';

package/dist/src/internal/types/nile-chart-config-input.type.d.ts

@@ -1,7 +1,11 @@
 import type { ChartConfigType } from './chart-config.type.js';
 import type { AqConfigType } from './aq-config.type.js';
-/** Input to nileChartConfig(). Discriminated on chart.type. */
-export interface NileChartConfigInputType {
+import type { NileChartConfigBase } from '../../nile-chart/nile-chart-config.js';
+/**
+ * Input to nileChartConfig(). Discriminated on chart.type.
+ * Card-level fields may sit on chart, in aq, or on the root (merged: root, then chart, then aq).
+ */
+export interface NileChartConfigInputType extends Partial<NileChartConfigBase> {
     chart: ChartConfigType;
     aq?: AqConfigType;
 }

package/dist/src/internal/types/widget-config.type.d.ts

@@ -0,0 +1,23 @@
+import type { NileChartConfigInputType } from './nile-chart-config-input.type.js';
+import type { NileKpiConfigInputType } from '../../nile-kpi-chart/nile-kpi-chart.js';
+import type { WidgetLayout } from './widget-layout.type.js';
+/** Widget containing a chart (any ChartConfigType — bar, pie, line, etc.). */
+export interface NileWidgetChartConfig {
+    id?: string;
+    title?: string;
+    type: 'chart';
+    layout: WidgetLayout;
+    /** Full nile chart config: `{ chart: ChartConfigType, aq?: AqConfigType }`. */
+    nileConfig: NileChartConfigInputType;
+}
+/** Widget containing a KPI tile. */
+export interface NileWidgetKpiConfig {
+    id?: string;
+    title?: string;
+    type: 'kpi';
+    layout: WidgetLayout;
+    /** Full nile KPI config: `{ chart: ChartKpiSeparatedPayload, aq?: AqConfigType }`. */
+    nileConfig: NileKpiConfigInputType;
+}
+/** Discriminated union for all widget types. Discriminator: `type`. */
+export type NileWidgetConfig = NileWidgetChartConfig | NileWidgetKpiConfig;

package/dist/src/internal/types/widget-config.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=widget-config.type.js.map

package/dist/src/internal/types/widget-layout.type.d.ts

@@ -0,0 +1,11 @@
+/** Grid position and size for a dashboard widget. */
+export interface WidgetLayout {
+    /** Column start (0-based). */
+    x: number;
+    /** Row start (0-based). */
+    y: number;
+    /** Number of columns the widget spans. */
+    w: number;
+    /** Number of rows the widget spans. */
+    h: number;
+}

package/dist/src/internal/types/widget-layout.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=widget-layout.type.js.map

package/dist/src/nile-chart/index.d.ts

@@ -1,5 +1,5 @@
 export { NileChart } from './nile-chart.js';
-export type { NileChartConfig, NileBarChartConfig, NilePieChartConfig, NileTrendlineChartConfig, NileAnomalyChartConfig, NileLineChartConfig, NileAreaChartConfig, NileColumnChartConfig, NileDonutChartConfig, NileScatterChartConfig, NileBubbleChartConfig, NileSplineChartConfig, NileRadarChartConfig, NileGaugeChartConfig, NileWaterfallChartConfig, NileKpiChartConfig, ChartType, SwitchAggregation, NileAiConfig, } from './nile-chart-config.js';
+export type { NileChartConfig, NileBarChartConfig, NilePieChartConfig, NileTrendlineChartConfig, NileAnomalyChartConfig, NileLineChartConfig, NileAreaChartConfig, NileColumnChartConfig, NileDonutChartConfig, NileScatterChartConfig, NileBubbleChartConfig, NileSplineChartConfig, NileRadarChartConfig, NileGaugeChartConfig, NileWaterfallChartConfig, NileKpiChartConfig, NileMapChartConfig, ChartType, SwitchAggregation, NileAiConfig, } from './nile-chart-config.js';
 export { convertConfig, registerAdapter } from '../internal/chart-adapters.js';
 export { nileChartConfig } from './nile-chart-config-builder.js';
-export type { AiConfigType, SwitchableConfigType, AqConfigType, ChartBarConfigType, ChartPieConfigType, ChartTrendlineConfigType, ChartAnomalyConfigType, ChartLineConfigType, ChartAreaConfigType, ChartInvertedAreaConfigType, ChartColumnConfigType, ChartDonutConfigType, ChartScatterConfigType, ChartBubbleConfigType, ChartSplineConfigType, ChartRadarConfigType, ChartGaugeConfigType, ChartWaterfallConfigType, ChartClusterConfigType, ChartStackedConfigType, ChartHistogramConfigType, ChartBellcurveConfigType, ChartBoxplotConfigType, ChartTimelineConfigType, ChartDumbbellConfigType, ChartDumbbellLowerConfigType, ChartDumbbellUpperConfigType, ChartColumnPyramidConfigType, ChartLollipopConfigType, ChartAreaSplineConfigType, ChartAreaNegativeConfigType, ChartAreaRangeConfigType, ChartColumnRangeConfigType, ChartColumnDrilldownConfigType, ChartRadialBarConfigType, ChartVariablePieConfigType, ChartEulerConfigType, ChartPolygonConfigType, ChartVectorConfigType, ChartXrangeConfigType, ChartFanConfigType, ChartFunnelConfigType, ChartOrganizationConfigType, ChartLineColumnConfigType, ChartHeatmapConfigType, ChartFlameConfigType, ChartSpiderwebConfigType, ChartKpiConfigType, ChartKpiPropsType, PrimitiveChartConfigType, SeparatedChartConfigInputType, AllChartConfigType, ChartConfigType, NileChartConfigInputType, ChartAiPanelPayload, ChartAiSenderPayload, NileAiPanelConfigInputType, NileAiSenderConfigInputType, } from '../internal/types/index.js';
+export type { AiConfigType, SwitchableConfigType, AqConfigType, ChartBarConfigType, ChartPieConfigType, ChartTrendlineConfigType, ChartAnomalyConfigType, ChartLineConfigType, ChartAreaConfigType, ChartInvertedAreaConfigType, ChartColumnConfigType, ChartDonutConfigType, ChartScatterConfigType, ChartBubbleConfigType, ChartSplineConfigType, ChartRadarConfigType, ChartGaugeConfigType, ChartWaterfallConfigType, ChartClusterConfigType, ChartStackedConfigType, ChartHistogramConfigType, ChartBellcurveConfigType, ChartBoxplotConfigType, ChartTimelineConfigType, ChartDumbbellConfigType, ChartDumbbellLowerConfigType, ChartDumbbellUpperConfigType, ChartColumnPyramidConfigType, ChartLollipopConfigType, ChartAreaSplineConfigType, ChartAreaNegativeConfigType, ChartAreaRangeConfigType, ChartColumnRangeConfigType, ChartColumnDrilldownConfigType, ChartRadialBarConfigType, ChartVariablePieConfigType, ChartEulerConfigType, ChartPolygonConfigType, ChartVectorConfigType, ChartXrangeConfigType, ChartFanConfigType, ChartFunnelConfigType, ChartOrganizationConfigType, ChartLineColumnConfigType, ChartHeatmapConfigType, ChartFlameConfigType, ChartSpiderwebConfigType, ChartKpiConfigType, ChartKpiPropsType, ChartMapConfigType, PrimitiveChartConfigType, SeparatedChartConfigInputType, AllChartConfigType, ChartConfigType, NileChartConfigInputType, ChartAiPanelPayload, ChartAiSenderPayload, NileAiPanelConfigInputType, NileAiSenderConfigInputType, } from '../internal/types/index.js';

package/dist/src/nile-chart/nile-chart-config-builder.js

@@ -1,8 +1,9 @@
 /** Merges separated chart + aq config into a flat NileChartConfig. */
 export function nileChartConfig(input) {
-    const { chart, aq } = input;
+    const { chart, aq, ...fromRoot } = input;
     const { ai, switchable, ...rest } = aq ?? {};
     return {
+        ...fromRoot,
         ...chart,
         ...rest,
         ...(ai && { ai }),

package/dist/src/nile-chart/nile-chart-config.d.ts

@@ -1,6 +1,21 @@
 import type { ChartConfigType } from '../internal/types/chart-config.type.js';
 /** Every supported `chart.type` value for `<nile-chart>`. */
 export type ChartType = ChartConfigType['type'];
+import type { BarChartSeriesData } from '../nile-bar-chart/nile-bar-chart.js';
+import type { PieChartSeriesData } from '../nile-pie-chart/nile-pie-chart.js';
+import type { TrendlineSeriesData, ForecastConfig } from '../nile-trendline-chart/nile-trendline-chart.js';
+import type { AnomalySeriesData, AnomalyConfig } from '../nile-anomaly-chart/nile-anomaly-chart.js';
+import type { LineChartSeriesData } from '../nile-line-chart/nile-line-chart.js';
+import type { AreaChartSeriesData } from '../nile-area-chart/nile-area-chart.js';
+import type { ColumnChartSeriesData } from '../nile-column-chart/nile-column-chart.js';
+import type { DonutChartSeriesData } from '../nile-donut-chart/nile-donut-chart.js';
+import type { ScatterChartSeriesData } from '../nile-scatter-chart/nile-scatter-chart.js';
+import type { BubbleChartSeriesData } from '../nile-bubble-chart/nile-bubble-chart.js';
+import type { SplineChartSeriesData } from '../nile-spline-chart/nile-spline-chart.js';
+import type { RadarChartSeriesData } from '../nile-radar-chart/nile-radar-chart.js';
+import type { GaugeBand } from '../nile-gauge-chart/nile-gauge-chart.js';
+import type { WaterfallDataPoint } from '../nile-waterfall-chart/nile-waterfall-chart.js';
+import type { MapChartDataPoint } from '../nile-map-chart/nile-map-chart.js';
 export type SwitchAggregation = 'by-category' | 'by-series' | 'flatten';
 export interface NileAiConfig {
     /** Show the AI chat icon on the chart. Default: false. */
@@ -11,6 +26,7 @@ export interface NileAiConfig {
     welcomeMessage?: string;
 }
 /** Fields merged from `aq` (and shared card chrome) onto `chart` for `<nile-chart>`. */
+/** Fields merged from `aq` (and shared card chrome) onto `chart` for `<nile-chart>`. */
 export interface NileChartConfigBase {
     chartTitle?: string;
     chartSubtitle?: string;
@@ -22,54 +38,127 @@ export interface NileChartConfigBase {
     /** Chart types the user can switch to. Shows type-switch UI when set. */
     switchableTypes?: ChartType[];
     /** How to aggregate bar-like data when converting to pie. Default: 'by-category'. */
+    /** How to aggregate bar-like data when converting to pie. Default: 'by-category'. */
     switchAggregation?: SwitchAggregation;
     /** AI chat configuration. When ai.enabled is true, shows the allsearch icon. */
     ai?: NileAiConfig;
 }
-/** Flat config for `<nile-chart>` after merging `chart` + `aq`. */
-export type NileChartConfig = ChartConfigType & NileChartConfigBase;
-export type NileBarChartConfig = Extract<NileChartConfig, {
+export interface NileBarChartConfig extends NileChartConfigBase {
     type: 'bar';
-}>;
-export type NilePieChartConfig = Extract<NileChartConfig, {
+    data: BarChartSeriesData[];
+    categories?: string[];
+    yAxisTitle?: string;
+}
+export interface NilePieChartConfig extends NileChartConfigBase {
     type: 'pie';
-}>;
-export type NileTrendlineChartConfig = Extract<NileChartConfig, {
+    data: PieChartSeriesData[];
+    seriesName?: string;
+    showDataLabels?: boolean;
+    showLegend?: boolean;
+}
+export interface NileTrendlineChartConfig extends NileChartConfigBase {
     type: 'trendline';
-}>;
-export type NileAnomalyChartConfig = Extract<NileChartConfig, {
+    data: TrendlineSeriesData[];
+    categories?: string[];
+    yAxisTitle?: string;
+    forecast?: ForecastConfig;
+}
+export interface NileAnomalyChartConfig extends NileChartConfigBase {
     type: 'anomaly';
-}>;
-export type NileLineChartConfig = Extract<NileChartConfig, {
+    data: AnomalySeriesData[];
+    categories?: string[];
+    yAxisTitle?: string;
+    anomaly?: AnomalyConfig;
+}
+export interface NileLineChartConfig extends NileChartConfigBase {
     type: 'line';
-}>;
-export type NileAreaChartConfig = Extract<NileChartConfig, {
+    data: LineChartSeriesData[];
+    categories?: string[];
+    yAxisTitle?: string;
+}
+export interface NileAreaChartConfig extends NileChartConfigBase {
     type: 'area';
-}>;
-export type NileColumnChartConfig = Extract<NileChartConfig, {
+    data: AreaChartSeriesData[];
+    categories?: string[];
+    yAxisTitle?: string;
+    stacked?: boolean;
+}
+export interface NileColumnChartConfig extends NileChartConfigBase {
     type: 'column';
-}>;
-export type NileDonutChartConfig = Extract<NileChartConfig, {
+    data: ColumnChartSeriesData[];
+    categories?: string[];
+    yAxisTitle?: string;
+}
+export interface NileDonutChartConfig extends NileChartConfigBase {
     type: 'donut';
-}>;
-export type NileScatterChartConfig = Extract<NileChartConfig, {
+    data: DonutChartSeriesData[];
+    seriesName?: string;
+    innerSize?: string;
+    showDataLabels?: boolean;
+    showLegend?: boolean;
+}
+export interface NileScatterChartConfig extends NileChartConfigBase {
     type: 'scatter';
-}>;
-export type NileBubbleChartConfig = Extract<NileChartConfig, {
+    data: ScatterChartSeriesData[];
+    xAxisTitle?: string;
+    yAxisTitle?: string;
+}
+export interface NileBubbleChartConfig extends NileChartConfigBase {
     type: 'bubble';
-}>;
-export type NileSplineChartConfig = Extract<NileChartConfig, {
+    data: BubbleChartSeriesData[];
+    xAxisTitle?: string;
+    yAxisTitle?: string;
+}
+export interface NileSplineChartConfig extends NileChartConfigBase {
     type: 'spline';
-}>;
-export type NileRadarChartConfig = Extract<NileChartConfig, {
+    data: SplineChartSeriesData[];
+    categories?: string[];
+    yAxisTitle?: string;
+}
+export interface NileRadarChartConfig extends NileChartConfigBase {
     type: 'radar';
-}>;
-export type NileGaugeChartConfig = Extract<NileChartConfig, {
+    data: RadarChartSeriesData[];
+    categories?: string[];
+    showArea?: boolean;
+}
+export interface NileGaugeChartConfig extends NileChartConfigBase {
     type: 'gauge';
-}>;
-export type NileWaterfallChartConfig = Extract<NileChartConfig, {
+    value: number;
+    min?: number;
+    max?: number;
+    suffix?: string;
+    bands?: GaugeBand[];
+}
+export interface NileWaterfallChartConfig extends NileChartConfigBase {
     type: 'waterfall';
-}>;
+    data: WaterfallDataPoint[];
+    yAxisTitle?: string;
+}
+export interface NileMapChartConfig extends NileChartConfigBase {
+    type: 'map';
+    /** Array of data points joined against the map topology. */
+    data: MapChartDataPoint[];
+    /**
+     * GeoJSON or Highcharts topology object for the map shapes.
+     * Obtain from https://code.highcharts.com/mapdata/ or supply your own.
+     */
+    mapData?: object;
+    /**
+     * How to join data against mapData. Defaults to `['hc-key', 'hc-key']`.
+     * Pass a string to use the same key on both sides,
+     * or a two-element array `[mapKey, dataKey]` for different key names.
+     */
+    joinBy?: string | string[];
+    /**
+     * Type of the primary series. Default: `'map'`.
+     * For multi-series or `tiledwebmap`, pass `options.series` directly.
+     */
+    seriesType?: 'map' | 'mapline' | 'mappoint' | 'mapbubble' | 'tiledwebmap';
+    /** Enable mouse-wheel zoom, double-click zoom, and +/− buttons. Default: true. */
+    zoom?: boolean;
+}
+/** Flat config for `<nile-chart>`: discriminated `chart` fields plus merged `aq` / card chrome. */
+export type NileChartConfig = ChartConfigType & NileChartConfigBase;
 export type NileKpiChartConfig = Extract<NileChartConfig, {
     type: 'kpi';
 }>;

package/dist/src/nile-chart/nile-chart.css.js

@@ -19,7 +19,6 @@ export const styles = css `
     box-shadow: var(--nile-box-shadow-3, var(--ng-shadow-sm));
     transition: box-shadow var(--nile-transition-duration-default, var(--ng-transition-duration-default)) ease;
   }
-
   .chart-card:hover {
     box-shadow: var(--nile-box-shadow-7, var(--ng-shadow-md));
   }
@@ -28,8 +27,10 @@ export const styles = css `
 
   .chart-header {
     display: flex;
+    flex-direction: row;
     align-items: center;
     justify-content: space-between;
+    gap: var(--nile-spacing-lg, var(--ng-spacing-lg));
     position: relative;
     z-index: 10;
     padding: var(--nile-spacing-2xl, var(--ng-spacing-2xl)) var(--nile-spacing-3xl, var(--ng-spacing-3xl)) var(--nile-spacing-xl, var(--ng-spacing-xl));
@@ -38,16 +39,24 @@ export const styles = css `
     border-radius: var(--nile-radius-radius-3xl, var(--ng-radius-xl)) var(--nile-radius-radius-3xl, var(--ng-radius-xl)) 0 0;
   }
 
+  .chart-header.chart-header--compact {
+    padding: var(--nile-spacing-xl, var(--ng-spacing-xl)) var(--nile-spacing-3xl, var(--ng-spacing-3xl)) var(--nile-spacing-lg, var(--ng-spacing-lg));
+  }
+
   .chart-header-titles {
+    display: flex;
+    flex-direction: column;
+    align-items: flex-start;
+    justify-content: center;
     min-width: 0;
-    flex: 1;
+    flex: 1 1 auto;
   }
 
   .chart-header-title {
     margin: 0;
     font-family: var(--nile-font-family-serif-colfax-medium, var(--ng-font-family-display));
-    font-size: var(--nile-type-scale-6, var(--ng-font-size-text-xl));
-    font-weight: var(--nile-font-weight-semi-bold, var(--ng-font-weight-semibold));
+    font-size: var(--nile-type-scale-6, var(--ng-font-size-text-l));
+     font-weight: var(--nile-font-weight-semi-bold, var(--ng-font-weight-semibold));
     color: var(--nile-colors-dark-900, var(--ng-colors-text-primary-900));
     line-height: 1.3;
   }
@@ -66,7 +75,7 @@ export const styles = css `
     align-items: center;
     gap: var(--nile-spacing-xs, var(--ng-spacing-xs));
     flex-shrink: 0;
-    margin-left: var(--nile-spacing-lg, var(--ng-spacing-lg));
+    align-self: center;
   }
 
   /* ── Card Body ── */
@@ -287,7 +296,12 @@ export const styles = css `
     background: transparent;
     color: var(--nile-colors-primary-600, var(--ng-colors-fg-brand-primary-600));
   }
-
+  .chart-inner--kpi {
+    overflow-x: hidden;
+    overflow-y: auto;
+    -webkit-overflow-scrolling: touch;
+    contain: none;
+  }
   .ai-trigger.active {
     background: var(--nile-colors-primary-100, var(--ng-colors-bg-brand-primary));
     color: var(--nile-colors-primary-700, var(--ng-colors-bg-brand-solid-hover));