@aquera/nile-visualization 0.1.0 → 0.2.0

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

@@ -3,22 +3,43 @@ import { customElement, property, query, state } from 'lit/decorators.js';
 import { html, nothing } from 'lit';
 import NileElement from '../internal/nile-element.js';
 import { styles } from './nile-chart.css.js';
+import { nileChartConfig } from './nile-chart-config-builder.js';
 import { convertConfig } from '../internal/chart-adapters.js';
 import '../nile-bar-chart/index.js';
 import '../nile-pie-chart/index.js';
 import '../nile-trendline-chart/index.js';
 import '../nile-anomaly-chart/index.js';
+import '../nile-line-chart/index.js';
+import '../nile-area-chart/index.js';
+import '../nile-column-chart/index.js';
+import '../nile-donut-chart/index.js';
+import '../nile-scatter-chart/index.js';
+import '../nile-bubble-chart/index.js';
+import '../nile-spline-chart/index.js';
+import '../nile-radar-chart/index.js';
+import '../nile-gauge-chart/index.js';
+import '../nile-waterfall-chart/index.js';
 import '../nile-ai-panel/index.js';
 const TYPE_LABELS = {
     bar: 'Bar',
     pie: 'Pie',
     trendline: 'Trendline',
     anomaly: 'Anomaly',
+    line: 'Line',
+    area: 'Area',
+    column: 'Column',
+    donut: 'Donut',
+    scatter: 'Scatter',
+    bubble: 'Bubble',
+    spline: 'Spline',
+    radar: 'Radar',
+    gauge: 'Gauge',
+    waterfall: 'Waterfall',
 };
 let NileChart = class NileChart extends NileElement {
     constructor() {
         super(...arguments);
-        /** Full chart configuration including type, data, and summary. */
+        /** Full chart configuration. Accepts flat NileChartConfig or separated { chart, aq } input. */
         this.config = null;
         /** The summary/insight text displayed in the overlay (fallback when config is not set). */
         this.summary = '';
@@ -37,28 +58,43 @@ let NileChart = class NileChart extends NileElement {
                 this.emit('nile-chart-toggle', { open: this.open });
             }
         };
+        this.resolvedConfig = null;
     }
     get effectiveSummary() {
-        return this.config?.summary ?? this.summary;
+        return this.resolvedConfig?.summary ?? this.summary;
     }
     get effectiveToggleLabel() {
-        return this.config?.toggleLabel ?? this.toggleLabel;
+        return this.resolvedConfig?.toggleLabel ?? this.toggleLabel;
     }
     get aiEnabled() {
-        return this.config?.ai?.enabled === true;
+        return this.resolvedConfig?.ai?.enabled === true;
     }
     connectedCallback() {
         super.connectedCallback();
         document.addEventListener('click', this.handleOutsideClick);
+        // Pick up config set before element upgrade (e.g. Angular ngAfterViewInit)
+        if (this.config && !this.resolvedConfig) {
+            this.resolvedConfig = this.resolveConfig(this.config);
+            this.activeType = this.resolvedConfig.type;
+            this.activeConfig = this.resolvedConfig;
+        }
     }
     disconnectedCallback() {
         super.disconnectedCallback();
         document.removeEventListener('click', this.handleOutsideClick);
     }
+    /** Resolve { chart, aq } input to flat NileChartConfig. */
+    resolveConfig(input) {
+        if ('chart' in input && input.chart) {
+            return nileChartConfig(input);
+        }
+        return input;
+    }
     updated(changedProperties) {
         if (changedProperties.has('config') && this.config) {
-            this.activeType = this.config.type;
-            this.activeConfig = this.config;
+            this.resolvedConfig = this.resolveConfig(this.config);
+            this.activeType = this.resolvedConfig.type;
+            this.activeConfig = this.resolvedConfig;
         }
     }
     toggle(e) {
@@ -93,10 +129,10 @@ let NileChart = class NileChart extends NileElement {
         });
     }
     switchType(toType) {
-        if (!this.config || toType === this.activeType)
+        if (!this.resolvedConfig || toType === this.activeType)
             return;
         const fromType = this.activeType;
-        const converted = convertConfig(this.config, toType);
+        const converted = convertConfig(this.resolvedConfig, toType);
         this.activeType = toType;
         this.activeConfig = converted;
         this.menuOpen = false;
@@ -107,13 +143,13 @@ let NileChart = class NileChart extends NileElement {
         });
     }
     get headerTitle() {
-        return this.activeConfig?.chartTitle ?? this.config?.chartTitle ?? '';
+        return this.activeConfig?.chartTitle ?? this.resolvedConfig?.chartTitle ?? '';
     }
     get headerSubtitle() {
-        return this.activeConfig?.chartSubtitle ?? this.config?.chartSubtitle ?? '';
+        return this.activeConfig?.chartSubtitle ?? this.resolvedConfig?.chartSubtitle ?? '';
     }
     renderTypeSwitcher() {
-        const types = this.config?.switchableTypes;
+        const types = this.resolvedConfig?.switchableTypes;
         if (!types || types.length === 0)
             return nothing;
         return html `
@@ -162,7 +198,7 @@ let NileChart = class NileChart extends NileElement {
     renderHeader() {
         const title = this.headerTitle;
         const subtitle = this.headerSubtitle;
-        const hasTypeSwitcher = (this.config?.switchableTypes?.length ?? 0) > 0;
+        const hasTypeSwitcher = (this.resolvedConfig?.switchableTypes?.length ?? 0) > 0;
         const hasActions = hasTypeSwitcher || this.aiEnabled;
         if (!title && !subtitle && !hasActions)
             return nothing;
@@ -182,7 +218,7 @@ let NileChart = class NileChart extends NileElement {
     renderAiPanel() {
         if (!this.aiEnabled)
             return nothing;
-        const aiConfig = this.config.ai;
+        const aiConfig = this.resolvedConfig.ai;
         return html `
       <div class="ai-panel-overlay" ?data-open=${this.chatOpen}>
         <nile-ai-panel
@@ -238,6 +274,100 @@ let NileChart = class NileChart extends NileElement {
           .options=${mergedOptions}
           .loading=${config.loading ?? false}
         ></nile-anomaly-chart>`;
+            case 'line':
+                return html `<nile-line-chart
+          .data=${config.data}
+          .categories=${config.categories ?? []}
+          .height=${config.height ?? '400px'}
+          .yAxisTitle=${config.yAxisTitle ?? ''}
+          .options=${mergedOptions}
+          .loading=${config.loading ?? false}
+        ></nile-line-chart>`;
+            case 'area':
+                return html `<nile-area-chart
+          .data=${config.data}
+          .categories=${config.categories ?? []}
+          .height=${config.height ?? '400px'}
+          .yAxisTitle=${config.yAxisTitle ?? ''}
+          .stacked=${config.stacked ?? false}
+          .options=${mergedOptions}
+          .loading=${config.loading ?? false}
+        ></nile-area-chart>`;
+            case 'column':
+                return html `<nile-column-chart
+          .data=${config.data}
+          .categories=${config.categories ?? []}
+          .height=${config.height ?? '400px'}
+          .yAxisTitle=${config.yAxisTitle ?? ''}
+          .options=${mergedOptions}
+          .loading=${config.loading ?? false}
+        ></nile-column-chart>`;
+            case 'donut':
+                return html `<nile-donut-chart
+          .data=${config.data}
+          .seriesName=${config.seriesName ?? ''}
+          .height=${config.height ?? '400px'}
+          .innerSize=${config.innerSize ?? '50%'}
+          .showDataLabels=${config.showDataLabels ?? true}
+          .showLegend=${config.showLegend ?? true}
+          .options=${mergedOptions}
+          .loading=${config.loading ?? false}
+        ></nile-donut-chart>`;
+            case 'scatter':
+                return html `<nile-scatter-chart
+          .data=${config.data}
+          .height=${config.height ?? '400px'}
+          .xAxisTitle=${config.xAxisTitle ?? ''}
+          .yAxisTitle=${config.yAxisTitle ?? ''}
+          .options=${mergedOptions}
+          .loading=${config.loading ?? false}
+        ></nile-scatter-chart>`;
+            case 'bubble':
+                return html `<nile-bubble-chart
+          .data=${config.data}
+          .height=${config.height ?? '400px'}
+          .xAxisTitle=${config.xAxisTitle ?? ''}
+          .yAxisTitle=${config.yAxisTitle ?? ''}
+          .options=${mergedOptions}
+          .loading=${config.loading ?? false}
+        ></nile-bubble-chart>`;
+            case 'spline':
+                return html `<nile-spline-chart
+          .data=${config.data}
+          .categories=${config.categories ?? []}
+          .height=${config.height ?? '400px'}
+          .yAxisTitle=${config.yAxisTitle ?? ''}
+          .options=${mergedOptions}
+          .loading=${config.loading ?? false}
+        ></nile-spline-chart>`;
+            case 'radar':
+                return html `<nile-radar-chart
+          .data=${config.data}
+          .categories=${config.categories ?? []}
+          .height=${config.height ?? '400px'}
+          .showArea=${config.showArea ?? false}
+          .options=${mergedOptions}
+          .loading=${config.loading ?? false}
+        ></nile-radar-chart>`;
+            case 'gauge':
+                return html `<nile-gauge-chart
+          .value=${config.value}
+          .min=${config.min ?? 0}
+          .max=${config.max ?? 100}
+          .suffix=${config.suffix ?? ''}
+          .bands=${config.bands ?? []}
+          .height=${config.height ?? '280px'}
+          .options=${mergedOptions}
+          .loading=${config.loading ?? false}
+        ></nile-gauge-chart>`;
+            case 'waterfall':
+                return html `<nile-waterfall-chart
+          .data=${config.data}
+          .height=${config.height ?? '400px'}
+          .yAxisTitle=${config.yAxisTitle ?? ''}
+          .options=${mergedOptions}
+          .loading=${config.loading ?? false}
+        ></nile-waterfall-chart>`;
         }
     }
     render() {
@@ -256,7 +386,7 @@ let NileChart = class NileChart extends NileElement {
             </button>
             <div class="chart-overlay" ?data-open="${this.open}">
               <div class="chart-content">
-                ${this.config
+                ${this.resolvedConfig
             ? this.effectiveSummary
             : html `<slot name="insight">${this.summary}</slot>`}
               </div>

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

@@ -0,0 +1,2 @@
+export { NileClusterChart } from './nile-cluster-chart.js';
+export type { ClusterChartSeriesData } from './nile-cluster-chart.js';

package/dist/src/nile-cluster-chart/index.js

@@ -0,0 +1,2 @@
+export { NileClusterChart } from './nile-cluster-chart.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

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

@@ -0,0 +1,28 @@
+import { css } from 'lit';
+export const styles = css `
+  :host {
+    display: block;
+    width: 100%;
+    position: relative;
+  }
+
+  :host([hidden]) {
+    display: none;
+  }
+
+  .chart-container {
+    width: 100%;
+    min-height: var(--nile-height-200px, var(--ng-height-200px));
+  }
+
+  .chart-loading {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    min-height: inherit;
+    color: var(--nile-colors-neutral-700, var(--ng-colors-text-secondary-700));
+    font-family: var(--nile-font-family-serif, var(--ng-font-family-body));
+    font-size: var(--nile-type-scale-3, var(--ng-font-size-text-sm));
+  }
+`;
+//# sourceMappingURL=nile-cluster-chart.css.js.map

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

@@ -0,0 +1,46 @@
+import type { CSSResultGroup, PropertyValues, TemplateResult } from 'lit';
+import type Highcharts from 'highcharts';
+import NileElement from '../internal/nile-element.js';
+import type { SeparatedChartConfigInputType } from '../internal/types/separated-chart-config-input.type.js';
+/** One series in a grouped (clustered) column chart — same shape as column chart data. */
+export interface ClusterChartSeriesData {
+    name: string;
+    data: number[];
+    color?: string;
+}
+export declare class NileClusterChart extends NileElement {
+    static styles: CSSResultGroup;
+    private _hc;
+    private chart;
+    private resizeObserver;
+    private chartContainer;
+    /** Full chart configuration. Accepts separated `{ chart, aq }` input. */
+    config: SeparatedChartConfigInputType | null;
+    chartTitle: string;
+    chartSubtitle: string;
+    data: ClusterChartSeriesData[];
+    categories: string[];
+    options: Highcharts.Options;
+    loading: boolean;
+    height: string;
+    yAxisTitle: string;
+    showLegend: boolean;
+    groupPadding: number;
+    pointPadding: number;
+    /** Apply `{ chart, aq }` config to individual properties. */
+    private applyConfig;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected firstUpdated(): void;
+    protected updated(changedProperties: PropertyValues): void;
+    private setupResizeObserver;
+    private buildOptions;
+    private initChart;
+    private destroyChart;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'nile-cluster-chart': NileClusterChart;
+    }
+}

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

@@ -0,0 +1,196 @@
+import { __decorate } from "tslib";
+import { customElement, property, query } from 'lit/decorators.js';
+import { html } from 'lit';
+import { getHighcharts } from '../internal/highcharts-provider.js';
+import NileElement from '../internal/nile-element.js';
+import { applySeparatedChartConfig } from '../internal/separated-chart-config.js';
+import { deepMerge } from '../internal/utils.js';
+import { styles } from './nile-cluster-chart.css.js';
+let NileClusterChart = class NileClusterChart extends NileElement {
+    constructor() {
+        super(...arguments);
+        this._hc = null;
+        this.chart = null;
+        this.resizeObserver = null;
+        /** Full chart configuration. Accepts separated `{ chart, aq }` input. */
+        this.config = null;
+        this.chartTitle = '';
+        this.chartSubtitle = '';
+        this.data = [];
+        this.categories = [];
+        this.options = {};
+        this.loading = false;
+        this.height = '400px';
+        this.yAxisTitle = '';
+        this.showLegend = true;
+        this.groupPadding = 0.14;
+        this.pointPadding = 0.08;
+    }
+    /** Apply `{ chart, aq }` config to individual properties. */
+    applyConfig(cfg) {
+        applySeparatedChartConfig(this, cfg);
+    }
+    connectedCallback() {
+        super.connectedCallback();
+        if (this.config)
+            this.applyConfig(this.config);
+    }
+    disconnectedCallback() {
+        super.disconnectedCallback();
+        this.destroyChart();
+        this.resizeObserver?.disconnect();
+        this.resizeObserver = null;
+    }
+    firstUpdated() {
+        this.initChart();
+        this.setupResizeObserver();
+    }
+    updated(changedProperties) {
+        if (changedProperties.has('config') && this.config) {
+            this.applyConfig(this.config);
+            return;
+        }
+        const props = [
+            'data',
+            'categories',
+            'chartTitle',
+            'chartSubtitle',
+            'options',
+            'height',
+            'yAxisTitle',
+            'loading',
+            'showLegend',
+            'groupPadding',
+            'pointPadding',
+        ];
+        if (!props.some(p => changedProperties.has(p)))
+            return;
+        if (this.loading) {
+            this.destroyChart();
+            return;
+        }
+        if (this.chart) {
+            this.chart.update(this.buildOptions(), true, true);
+        }
+        else {
+            this.initChart();
+        }
+    }
+    setupResizeObserver() {
+        if (!this.chartContainer)
+            return;
+        this.resizeObserver = new ResizeObserver(() => {
+            this.chart?.reflow();
+        });
+        this.resizeObserver.observe(this.chartContainer);
+    }
+    buildOptions() {
+        const self = this;
+        return deepMerge({
+            chart: { type: 'column', height: this.height },
+            title: { text: this.chartTitle || undefined },
+            subtitle: { text: this.chartSubtitle || undefined },
+            xAxis: { categories: this.categories },
+            yAxis: { min: 0, title: { text: this.yAxisTitle || undefined } },
+            legend: { enabled: this.showLegend },
+            tooltip: { shared: true },
+            plotOptions: {
+                column: {
+                    grouping: true,
+                    groupPadding: this.groupPadding,
+                    pointPadding: this.pointPadding,
+                    borderWidth: 0,
+                    borderRadius: 2,
+                    dataLabels: { enabled: false },
+                },
+                series: {
+                    cursor: 'pointer',
+                    point: {
+                        events: {
+                            click() {
+                                self.emit('nile-chart-click', {
+                                    point: this,
+                                    category: this.category,
+                                    value: this.y,
+                                    seriesName: this.series.name,
+                                });
+                            },
+                        },
+                    },
+                },
+            },
+            series: this.data.map(s => ({
+                type: 'column',
+                name: s.name,
+                data: s.data,
+                color: s.color,
+            })),
+            credits: { enabled: false },
+        }, this.options);
+    }
+    async initChart() {
+        if (this.loading || !this.chartContainer)
+            return;
+        if (!this._hc)
+            this._hc = await getHighcharts();
+        this.chart = this._hc.chart(this.chartContainer, this.buildOptions());
+        this.emit('nile-chart-ready', { chart: this.chart });
+    }
+    destroyChart() {
+        if (this.chart) {
+            this.chart.destroy();
+            this.chart = null;
+        }
+    }
+    render() {
+        if (this.loading) {
+            return html `<div class="chart-loading" style="height:${this.height}">Loading...</div>`;
+        }
+        return html `<div class="chart-container"></div>`;
+    }
+};
+NileClusterChart.styles = styles;
+__decorate([
+    query('.chart-container')
+], NileClusterChart.prototype, "chartContainer", void 0);
+__decorate([
+    property({ type: Object })
+], NileClusterChart.prototype, "config", void 0);
+__decorate([
+    property({ type: String, attribute: 'chart-title' })
+], NileClusterChart.prototype, "chartTitle", void 0);
+__decorate([
+    property({ type: String, attribute: 'chart-subtitle' })
+], NileClusterChart.prototype, "chartSubtitle", void 0);
+__decorate([
+    property({ type: Array })
+], NileClusterChart.prototype, "data", void 0);
+__decorate([
+    property({ type: Array })
+], NileClusterChart.prototype, "categories", void 0);
+__decorate([
+    property({ type: Object })
+], NileClusterChart.prototype, "options", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], NileClusterChart.prototype, "loading", void 0);
+__decorate([
+    property({ type: String })
+], NileClusterChart.prototype, "height", void 0);
+__decorate([
+    property({ type: String, attribute: 'y-axis-title' })
+], NileClusterChart.prototype, "yAxisTitle", void 0);
+__decorate([
+    property({ type: Boolean, attribute: 'show-legend' })
+], NileClusterChart.prototype, "showLegend", void 0);
+__decorate([
+    property({ type: Number, attribute: 'group-padding' })
+], NileClusterChart.prototype, "groupPadding", void 0);
+__decorate([
+    property({ type: Number, attribute: 'point-padding' })
+], NileClusterChart.prototype, "pointPadding", void 0);
+NileClusterChart = __decorate([
+    customElement('nile-cluster-chart')
+], NileClusterChart);
+export { NileClusterChart };
+//# sourceMappingURL=nile-cluster-chart.js.map

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

@@ -1,6 +1,7 @@
 import type { CSSResultGroup, PropertyValues, TemplateResult } from 'lit';
 import type Highcharts from 'highcharts';
 import NileElement from '../internal/nile-element.js';
+import type { NileChartConfigInputType } from '../internal/types/index.js';
 export interface ColumnChartSeriesData {
     name: string;
     data: number[];
@@ -12,6 +13,8 @@ export declare class NileColumnChart extends NileElement {
     private chart;
     private resizeObserver;
     private chartContainer;
+    /** Full chart configuration. Accepts separated { chart, aq } input. */
+    config: NileChartConfigInputType | null;
     chartTitle: string;
     chartSubtitle: string;
     data: ColumnChartSeriesData[];
@@ -20,6 +23,9 @@ export declare class NileColumnChart extends NileElement {
     loading: boolean;
     height: string;
     yAxisTitle: string;
+    /** Apply { chart, aq } config to individual properties. */
+    private applyConfig;
+    connectedCallback(): void;
     disconnectedCallback(): void;
     protected firstUpdated(): void;
     protected updated(changedProperties: PropertyValues): void;

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

@@ -11,6 +11,8 @@ let NileColumnChart = class NileColumnChart extends NileElement {
         this._hc = null;
         this.chart = null;
         this.resizeObserver = null;
+        /** Full chart configuration. Accepts separated { chart, aq } input. */
+        this.config = null;
         this.chartTitle = '';
         this.chartSubtitle = '';
         this.data = [];
@@ -20,6 +22,36 @@ let NileColumnChart = class NileColumnChart extends NileElement {
         this.height = '400px';
         this.yAxisTitle = '';
     }
+    /** Apply { chart, aq } config to individual properties. */
+    applyConfig(cfg) {
+        const { chart: c, aq } = cfg;
+        if (c) {
+            const col = c;
+            if (col.data)
+                this.data = col.data;
+            if (col.categories)
+                this.categories = col.categories;
+            if (col.yAxisTitle)
+                this.yAxisTitle = col.yAxisTitle;
+            if (col.height)
+                this.height = col.height;
+            if (col.loading !== undefined)
+                this.loading = col.loading;
+            if (col.options)
+                this.options = col.options;
+        }
+        if (aq) {
+            if (aq.chartTitle)
+                this.chartTitle = aq.chartTitle;
+            if (aq.chartSubtitle)
+                this.chartSubtitle = aq.chartSubtitle;
+        }
+    }
+    connectedCallback() {
+        super.connectedCallback();
+        if (this.config)
+            this.applyConfig(this.config);
+    }
     disconnectedCallback() {
         super.disconnectedCallback();
         this.destroyChart();
@@ -28,6 +60,10 @@ let NileColumnChart = class NileColumnChart extends NileElement {
     }
     firstUpdated() { this.initChart(); this.setupResizeObserver(); }
     updated(changedProperties) {
+        if (changedProperties.has('config') && this.config) {
+            this.applyConfig(this.config);
+            return;
+        }
         const props = ['data', 'categories', 'chartTitle', 'chartSubtitle', 'options', 'height', 'yAxisTitle', 'loading'];
         if (!props.some(p => changedProperties.has(p)))
             return;
@@ -87,6 +123,9 @@ NileColumnChart.styles = styles;
 __decorate([
     query('.chart-container')
 ], NileColumnChart.prototype, "chartContainer", void 0);
+__decorate([
+    property({ type: Object })
+], NileColumnChart.prototype, "config", void 0);
 __decorate([
     property({ type: String, attribute: 'chart-title' })
 ], NileColumnChart.prototype, "chartTitle", void 0);

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

@@ -1,6 +1,7 @@
 import type { CSSResultGroup, PropertyValues, TemplateResult } from 'lit';
 import type Highcharts from 'highcharts';
 import NileElement from '../internal/nile-element.js';
+import type { NileChartConfigInputType } from '../internal/types/index.js';
 export interface DonutChartSeriesData {
     name: string;
     y: number;
@@ -14,6 +15,8 @@ export declare class NileDonutChart extends NileElement {
     private chart;
     private resizeObserver;
     private chartContainer;
+    /** Full chart configuration. Accepts separated { chart, aq } input. */
+    config: NileChartConfigInputType | null;
     chartTitle: string;
     chartSubtitle: string;
     data: DonutChartSeriesData[];
@@ -24,6 +27,9 @@ export declare class NileDonutChart extends NileElement {
     height: string;
     showDataLabels: boolean;
     showLegend: boolean;
+    /** Apply { chart, aq } config to individual properties. */
+    private applyConfig;
+    connectedCallback(): void;
     disconnectedCallback(): void;
     protected firstUpdated(): void;
     protected updated(changedProperties: PropertyValues): void;