@aquera/nile-visualization 1.8.0 → 2.0.0

package/dist/src/index.d.ts

@@ -7,7 +7,7 @@ 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, NileMapChartConfig, 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, NileChartMenuConfig, NileChartMenuItem, } 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, ChartMapConfigType, PrimitiveChartConfigType, SeparatedChartConfigInputType, AllChartConfigType, ChartConfigType, NileChartConfigInputType, ChartAiPanelPayload, ChartAiSenderPayload, NileAiPanelConfigInputType, NileAiSenderConfigInputType, } from './nile-chart/index.js';

package/dist/src/internal/highcharts-provider.d.ts

@@ -11,4 +11,10 @@ type HighchartsStatic = typeof import('highcharts');
  * The initialization runs only once and is shared across all callers.
  */
 export declare function getHighcharts(): Promise<HighchartsStatic>;
+/**
+ * Loads Highcharts exporting modules (exporting, offline-exporting, export-data).
+ * Called only by nile-chart — not part of the base provider used by individual chart types.
+ * Runs once and is shared if called multiple times.
+ */
+export declare function initNileChartExporting(): Promise<void>;
 export {};

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

@@ -197,4 +197,36 @@ export function getHighcharts() {
     }
     return _initPromise;
 }
+let _exportingInitPromise = null;
+/**
+ * Loads Highcharts exporting modules (exporting, offline-exporting, export-data).
+ * Called only by nile-chart — not part of the base provider used by individual chart types.
+ * Runs once and is shared if called multiple times.
+ */
+export async function initNileChartExporting() {
+    if (_exportingInitPromise)
+        return _exportingInitPromise;
+    _exportingInitPromise = (async () => {
+        const H = await getHighcharts();
+        try {
+            const mod = await import('highcharts/modules/exporting.js');
+            if (typeof mod.default === 'function')
+                mod.default(H);
+        }
+        catch { /* consumer may have loaded it globally */ }
+        try {
+            const mod = await import('highcharts/modules/offline-exporting.js');
+            if (typeof mod.default === 'function')
+                mod.default(H);
+        }
+        catch { /* offline-exporting not available */ }
+        try {
+            const mod = await import('highcharts/modules/export-data.js');
+            if (typeof mod.default === 'function')
+                mod.default(H);
+        }
+        catch { /* export-data not available */ }
+    })();
+    return _exportingInitPromise;
+}
 //# sourceMappingURL=highcharts-provider.js.map

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

@@ -1,5 +1,6 @@
 import type { AiConfigType } from './ai-config.type.js';
 import type { SwitchableConfigType } from './switchable-config.type.js';
+import type { NileChartMenuConfig, NileChartMenuItem } from '../../nile-chart/nile-chart-config.js';
 /** General-purpose config (summary, AI, titles, switching). */
 export interface AqConfigType {
     chartTitle?: string;
@@ -10,4 +11,8 @@ export interface AqConfigType {
     ai?: AiConfigType;
     /** Chart type switching configuration. */
     switchable?: SwitchableConfigType;
+    /** Actions menu configuration. */
+    menu?: NileChartMenuConfig;
+    /** Extra items prepended before `menu.items`. Useful for injecting items from outer config layers. */
+    menuItems?: NileChartMenuItem[];
 }

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, NileMapChartConfig, 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, NileChartMenuConfig, NileChartMenuItem, } 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, ChartMapConfigType, PrimitiveChartConfigType, SeparatedChartConfigInputType, AllChartConfigType, ChartConfigType, NileChartConfigInputType, ChartAiPanelPayload, ChartAiSenderPayload, NileAiPanelConfigInputType, NileAiSenderConfigInputType, } from '../internal/types/index.js';

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

@@ -15,7 +15,7 @@ import type { SplineChartSeriesData } from '../nile-spline-chart/nile-spline-cha
 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 { KpiVariant, SparklineType, TrendDirection } from '../nile-kpi-chart/nile-kpi-chart.js';
+import type { KpiVariant, KpiValueFormat, SparklineType, TrendDirection } from '../nile-kpi-chart/nile-kpi-chart.js';
 import type { MapChartDataPoint } from '../nile-map-chart/nile-map-chart.js';
 import type { NileDataGridColumn } from '@aquera/nile-data-grid';
 import type { StackedChartSeriesData } from '../nile-stacked-chart/nile-stacked-chart.js';
@@ -47,6 +47,64 @@ import type { VectorDataPoint } from '../nile-vector-chart/nile-vector-chart.js'
 import type { XrangeDataPoint } from '../nile-xrange-chart/nile-xrange-chart.js';
 import type { LineColumnSeriesPart } from '../nile-line-column-chart/nile-line-column-chart.js';
 export type SwitchAggregation = 'by-category' | 'by-series' | 'flatten';
+/**
+ * A built-in menu action (fullscreen, print, or a download).
+ * Set the matching flag to `true`; optionally override the displayed `label`.
+ *
+ * @example
+ * { type: 'default', downloadPng: true }
+ * { type: 'default', downloadCsv: true, label: 'Export CSV', divider: true }
+ */
+export interface NileChartMenuItemDefault {
+    type: 'default';
+    /** Override the default label (e.g. "Download PNG"). */
+    label?: string;
+    /** Show a divider line above this item. */
+    divider?: boolean;
+    fullscreen?: true;
+    print?: true;
+    downloadPng?: true;
+    downloadSvg?: true;
+    downloadCsv?: true;
+}
+/**
+ * A custom menu item. Clicking it fires a `nile-menu-change` event with `{ id }`.
+ *
+ * @example
+ * { type: 'custom', label: 'Send to Slack', id: 'send-slack' }
+ */
+export interface NileChartMenuItemCustom {
+    type: 'custom';
+    /** Label shown in the menu. */
+    label: string;
+    /** Identifier emitted in the `nile-menu-change` event when clicked. */
+    id: string;
+    /** Show a divider line above this item. */
+    divider?: boolean;
+}
+export type NileChartMenuItem = NileChartMenuItemDefault | NileChartMenuItemCustom;
+/**
+ * Controls the chart's actions menu.
+ *
+ * @example
+ * menu: {
+ *   enabled: true,
+ *   items: [
+ *     { type: 'default', downloadPng: true },
+ *     { type: 'default', downloadCsv: true },
+ *     { type: 'custom', label: 'Share report', id: 'share-report', divider: true },
+ *   ]
+ * }
+ */
+export interface NileChartMenuConfig {
+    /** Show the menu trigger button. Must be `true` to enable the menu. */
+    enabled?: boolean;
+    /**
+     * Ordered list of menu items. Each item is either a built-in action
+     * (`type: 'default'`) or a custom event-driven item (`type: 'custom'`).
+     */
+    items?: NileChartMenuItem[];
+}
 export interface NileAiConfig {
     /** Show the AI chat icon on the chart. Default: false. */
     enabled?: boolean;
@@ -70,6 +128,10 @@ export interface NileChartConfigBase {
     switchAggregation?: SwitchAggregation;
     /** AI chat configuration. When ai.enabled is true, shows the allsearch icon. */
     ai?: NileAiConfig;
+    /** Controls the built-in actions menu in the chart header. */
+    menu?: NileChartMenuConfig;
+    /** Custom items appended at the bottom of the chart actions menu. */
+    menuItems?: NileChartMenuItem[];
     /** Show the chart legend. Each chart's default varies; set explicitly to override. */
     showLegend?: boolean;
     chartBg?: string;
@@ -462,6 +524,12 @@ export interface NileKpiChartConfig extends NileChartConfigBase {
     cardPaddingVertical?: string | number;
     cardPaddingHorizontal?: string | number;
     contentGap?: string | number;
+    /** Abbreviation scale. Default 'auto'. */
+    valueFormat?: KpiValueFormat;
+    /** Decimal places on the abbreviated value. */
+    precision?: number | null;
+    /** Base unit (e.g. 'L', 'g', 'm') combined with the magnitude prefix: "1.5KL", "2.5Kg". */
+    unit?: string;
     tooltipEnabled?: boolean;
 }
 /** Discriminated union of every named chart config — use for typed `<nile-chart>` configs. */

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

@@ -1 +1,2 @@
+export declare const tooltipCss = "\n  .nile-chart-header-tooltip {\n    position: fixed;\n    display: none;\n    transform: translate(-50%, calc(-100% - 10px));\n    background: var(--nile-colors-white-base, var(--ng-colors-bg-primary));\n    color: var(--nile-colors-dark-900, var(--ng-colors-text-primary-900));\n    font-family: var(--nile-font-family-serif, var(--ng-font-family-body));\n    font-size: var(--nile-type-scale-2, var(--ng-font-size-text-xs));\n    font-weight: var(--nile-font-weight-medium, var(--ng-font-weight-medium));\n    line-height: 1.4;\n    padding: 4px 10px;\n    border-radius: 6px;\n    border: 1px solid var(--nile-colors-neutral-400, var(--ng-colors-border-secondary));\n    pointer-events: none;\n    white-space: nowrap;\n    z-index: 2147483647;\n    box-shadow: var(--nile-box-shadow-3, var(--ng-shadow-sm));\n  }\n  .nile-chart-header-tooltip::after {\n    content: '';\n    position: absolute;\n    top: 100%;\n    left: 50%;\n    transform: translateX(-50%);\n    border: 5px solid transparent;\n    border-top-color: var(--nile-colors-neutral-400, var(--ng-colors-border-secondary));\n  }\n";
 export declare const styles: import("lit").CSSResult;