@aquera/nile-visualization 0.1.0

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

@@ -0,0 +1,36 @@
+import type { CSSResultGroup, PropertyValues, TemplateResult } from 'lit';
+import type Highcharts from 'highcharts';
+import NileElement from '../internal/nile-element.js';
+export interface ScatterChartSeriesData {
+    name: string;
+    data: [number, number][];
+    color?: string;
+}
+export declare class NileScatterChart extends NileElement {
+    static styles: CSSResultGroup;
+    private _hc;
+    private chart;
+    private resizeObserver;
+    private chartContainer;
+    chartTitle: string;
+    chartSubtitle: string;
+    data: ScatterChartSeriesData[];
+    options: Highcharts.Options;
+    loading: boolean;
+    height: string;
+    xAxisTitle: string;
+    yAxisTitle: string;
+    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-scatter-chart': NileScatterChart;
+    }
+}

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

@@ -0,0 +1,124 @@
+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 { deepMerge } from '../internal/utils.js';
+import { styles } from './nile-scatter-chart.css.js';
+let NileScatterChart = class NileScatterChart extends NileElement {
+    constructor() {
+        super(...arguments);
+        this._hc = null;
+        this.chart = null;
+        this.resizeObserver = null;
+        this.chartTitle = '';
+        this.chartSubtitle = '';
+        this.data = [];
+        this.options = {};
+        this.loading = false;
+        this.height = '400px';
+        this.xAxisTitle = '';
+        this.yAxisTitle = '';
+    }
+    disconnectedCallback() {
+        super.disconnectedCallback();
+        this.destroyChart();
+        this.resizeObserver?.disconnect();
+        this.resizeObserver = null;
+    }
+    firstUpdated() { this.initChart(); this.setupResizeObserver(); }
+    updated(changedProperties) {
+        const props = ['data', 'chartTitle', 'chartSubtitle', 'options', 'height', 'xAxisTitle', 'yAxisTitle', 'loading'];
+        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: 'scatter', height: this.height, zoomType: 'xy' },
+            title: { text: this.chartTitle || undefined },
+            subtitle: { text: this.chartSubtitle || undefined },
+            xAxis: { title: { text: this.xAxisTitle || undefined } },
+            yAxis: { title: { text: this.yAxisTitle || undefined } },
+            tooltip: {
+                headerFormat: '<b>{series.name}</b><br>',
+                pointFormat: '{point.x}, {point.y}',
+            },
+            plotOptions: {
+                scatter: {
+                    marker: { radius: 5, states: { hover: { enabled: true, lineColor: 'rgb(100,100,100)' } } },
+                    states: { hover: { marker: { enabled: false } } },
+                },
+                series: { cursor: 'pointer', point: { events: { click() { self.emit('nile-chart-click', { point: this, x: this.x, y: this.y, seriesName: this.series.name }); } } } },
+            },
+            series: this.data.map(s => ({ type: 'scatter', 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>`;
+    }
+};
+NileScatterChart.styles = styles;
+__decorate([
+    query('.chart-container')
+], NileScatterChart.prototype, "chartContainer", void 0);
+__decorate([
+    property({ type: String, attribute: 'chart-title' })
+], NileScatterChart.prototype, "chartTitle", void 0);
+__decorate([
+    property({ type: String, attribute: 'chart-subtitle' })
+], NileScatterChart.prototype, "chartSubtitle", void 0);
+__decorate([
+    property({ type: Array })
+], NileScatterChart.prototype, "data", void 0);
+__decorate([
+    property({ type: Object })
+], NileScatterChart.prototype, "options", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], NileScatterChart.prototype, "loading", void 0);
+__decorate([
+    property({ type: String })
+], NileScatterChart.prototype, "height", void 0);
+__decorate([
+    property({ type: String, attribute: 'x-axis-title' })
+], NileScatterChart.prototype, "xAxisTitle", void 0);
+__decorate([
+    property({ type: String, attribute: 'y-axis-title' })
+], NileScatterChart.prototype, "yAxisTitle", void 0);
+NileScatterChart = __decorate([
+    customElement('nile-scatter-chart')
+], NileScatterChart);
+export { NileScatterChart };
+//# sourceMappingURL=nile-scatter-chart.js.map

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

@@ -0,0 +1,2 @@
+export { NileSplineChart } from './nile-spline-chart.js';
+export type { SplineChartSeriesData } from './nile-spline-chart.js';

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

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

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

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

package/dist/src/nile-spline-chart/nile-spline-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-spline-chart.css.js.map

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

@@ -0,0 +1,36 @@
+import type { CSSResultGroup, PropertyValues, TemplateResult } from 'lit';
+import type Highcharts from 'highcharts';
+import NileElement from '../internal/nile-element.js';
+export interface SplineChartSeriesData {
+    name: string;
+    data: number[];
+    color?: string;
+}
+export declare class NileSplineChart extends NileElement {
+    static styles: CSSResultGroup;
+    private _hc;
+    private chart;
+    private resizeObserver;
+    private chartContainer;
+    chartTitle: string;
+    chartSubtitle: string;
+    data: SplineChartSeriesData[];
+    categories: string[];
+    options: Highcharts.Options;
+    loading: boolean;
+    height: string;
+    yAxisTitle: string;
+    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-spline-chart': NileSplineChart;
+    }
+}

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

@@ -0,0 +1,118 @@
+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 { deepMerge } from '../internal/utils.js';
+import { styles } from './nile-spline-chart.css.js';
+let NileSplineChart = class NileSplineChart extends NileElement {
+    constructor() {
+        super(...arguments);
+        this._hc = null;
+        this.chart = null;
+        this.resizeObserver = null;
+        this.chartTitle = '';
+        this.chartSubtitle = '';
+        this.data = [];
+        this.categories = [];
+        this.options = {};
+        this.loading = false;
+        this.height = '400px';
+        this.yAxisTitle = '';
+    }
+    disconnectedCallback() {
+        super.disconnectedCallback();
+        this.destroyChart();
+        this.resizeObserver?.disconnect();
+        this.resizeObserver = null;
+    }
+    firstUpdated() { this.initChart(); this.setupResizeObserver(); }
+    updated(changedProperties) {
+        const props = ['data', 'categories', 'chartTitle', 'chartSubtitle', 'options', 'height', 'yAxisTitle', 'loading'];
+        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: 'spline', height: this.height },
+            title: { text: this.chartTitle || undefined },
+            subtitle: { text: this.chartSubtitle || undefined },
+            xAxis: { categories: this.categories },
+            yAxis: { title: { text: this.yAxisTitle || undefined } },
+            tooltip: { shared: true },
+            plotOptions: {
+                spline: { marker: { enabled: true, radius: 4 } },
+                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: 'spline', 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>`;
+    }
+};
+NileSplineChart.styles = styles;
+__decorate([
+    query('.chart-container')
+], NileSplineChart.prototype, "chartContainer", void 0);
+__decorate([
+    property({ type: String, attribute: 'chart-title' })
+], NileSplineChart.prototype, "chartTitle", void 0);
+__decorate([
+    property({ type: String, attribute: 'chart-subtitle' })
+], NileSplineChart.prototype, "chartSubtitle", void 0);
+__decorate([
+    property({ type: Array })
+], NileSplineChart.prototype, "data", void 0);
+__decorate([
+    property({ type: Array })
+], NileSplineChart.prototype, "categories", void 0);
+__decorate([
+    property({ type: Object })
+], NileSplineChart.prototype, "options", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], NileSplineChart.prototype, "loading", void 0);
+__decorate([
+    property({ type: String })
+], NileSplineChart.prototype, "height", void 0);
+__decorate([
+    property({ type: String, attribute: 'y-axis-title' })
+], NileSplineChart.prototype, "yAxisTitle", void 0);
+NileSplineChart = __decorate([
+    customElement('nile-spline-chart')
+], NileSplineChart);
+export { NileSplineChart };
+//# sourceMappingURL=nile-spline-chart.js.map

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

@@ -0,0 +1,2 @@
+export { NileTrendlineChart } from './nile-trendline-chart.js';
+export type { TrendlineSeriesData, ForecastConfig } from './nile-trendline-chart.js';

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

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

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

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

package/dist/src/nile-trendline-chart/nile-trendline-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-trendline-chart.css.js.map

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

@@ -0,0 +1,59 @@
+import type { CSSResultGroup, PropertyValues, TemplateResult } from 'lit';
+import type Highcharts from 'highcharts';
+import NileElement from '../internal/nile-element.js';
+export interface TrendlineSeriesData {
+    name: string;
+    data: number[];
+    color?: string;
+}
+export interface ForecastConfig {
+    /** Number of periods to forecast beyond the actual data. */
+    periods: number;
+    /** Color for the forecast dashed line. */
+    color?: string;
+    /** Dash style for the forecast line. Default: 'Dash'. */
+    dashStyle?: string;
+}
+export declare class NileTrendlineChart extends NileElement {
+    static styles: CSSResultGroup;
+    private _hc;
+    private chart;
+    private resizeObserver;
+    private chartContainer;
+    /** The chart title displayed above the chart. */
+    chartTitle: string;
+    /** The subtitle displayed below the title. */
+    chartSubtitle: string;
+    /** Array of series data. Each series is a line on the chart. */
+    data: TrendlineSeriesData[];
+    /** X-axis category labels (e.g., months, dates). */
+    categories: string[];
+    /** Forecast configuration. When set, extends each series with a forecast line. */
+    forecast: ForecastConfig | null;
+    /** Deep-merge override object for full Highcharts options. */
+    options: Highcharts.Options;
+    /** Whether to show a loading indicator instead of the chart. */
+    loading: boolean;
+    /** CSS height for the chart container. */
+    height: string;
+    /** Y-axis title text. */
+    yAxisTitle: string;
+    disconnectedCallback(): void;
+    protected firstUpdated(): void;
+    protected updated(changedProperties: PropertyValues): void;
+    private setupResizeObserver;
+    /**
+     * Simple linear regression forecast.
+     * Extends the data array by `periods` using least-squares fit.
+     */
+    private computeForecast;
+    private buildOptions;
+    private initChart;
+    private destroyChart;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'nile-trendline-chart': NileTrendlineChart;
+    }
+}