@quicdata/analytics 0.0.2 → 0.0.4

package/widgets/line-chart.js

@@ -0,0 +1,71 @@
+import { __decorate } from "tslib";
+import { customElement } from 'lit/decorators.js';
+import { BaseChartWidget } from './base-chart.js';
+const LEGEND_NAME_MAX_LEN = 25;
+function legendConfig(multipleSeries) {
+    if (!multipleSeries)
+        return undefined;
+    return {
+        type: 'scroll',
+        bottom: 8,
+        left: 'center',
+        formatter: (name) => name.length > LEGEND_NAME_MAX_LEN ? name.slice(0, LEGEND_NAME_MAX_LEN) + '…' : name,
+    };
+}
+/**
+ * Line chart widget (Apache ECharts). Use data-url or inline data.
+ * When widgetData is present (from API), use its categories + series so x-axis is correct (e.g. split_by).
+ * Otherwise first column = categories, remaining = series.
+ */
+let LineChartWidget = class LineChartWidget extends BaseChartWidget {
+    buildOption(data, meta, widgetData) {
+        const wd = widgetData;
+        // Prefer widgetData whenever API sent it (categories = x-axis, series = one per split) so x-axis is never wrong.
+        if (wd && typeof wd === 'object' && Array.isArray(wd.categories)) {
+            const categories = wd.categories.map(String);
+            const seriesList = Array.isArray(wd.series) ? wd.series : [];
+            const series = seriesList.map((s) => ({
+                name: String(s?.name ?? ''),
+                type: 'line',
+                data: Array.isArray(s?.data) ? s.data.map((v) => Number(v) || 0) : [],
+                stack: wd.stack ? 'total' : undefined,
+            }));
+            const multiSeries = series.length > 1;
+            return {
+                grid: { left: 48, right: 24, top: 24, bottom: multiSeries ? 80 : 48 },
+                tooltip: { trigger: 'axis' },
+                legend: legendConfig(multiSeries),
+                xAxis: { type: 'category', data: categories },
+                yAxis: { type: 'value' },
+                series,
+            };
+        }
+        const keys = data.length ? Object.keys(data[0]) : Object.keys(meta);
+        if (keys.length === 0) {
+            return { xAxis: { type: 'category', data: [] }, yAxis: { type: 'value' }, series: [] };
+        }
+        const categoryKey = keys[0];
+        const valueKeys = keys.slice(1).filter((k) => meta[k]?.type === 'number' || typeof (data[0]?.[k]) === 'number');
+        const categories = [...new Set(data.map((r) => String(r[categoryKey] ?? '')))];
+        const series = valueKeys.length
+            ? valueKeys.map((name) => ({
+                name,
+                type: 'line',
+                data: data.map((r) => Number(r[name]) || 0),
+            }))
+            : [{ name: categoryKey, type: 'line', data: data.map((r) => Number(r[categoryKey]) || 0) }];
+        const multiSeries = series.length > 1;
+        return {
+            grid: { left: 48, right: 24, top: 24, bottom: multiSeries ? 80 : 48 },
+            tooltip: { trigger: 'axis' },
+            legend: legendConfig(multiSeries),
+            xAxis: { type: 'category', data: categories },
+            yAxis: { type: 'value' },
+            series,
+        };
+    }
+};
+LineChartWidget = __decorate([
+    customElement('analytics-line-chart')
+], LineChartWidget);
+export { LineChartWidget };

package/widgets/pie-chart.d.ts

@@ -0,0 +1,13 @@
+import type { EChartsOption } from 'echarts/types/dist/option';
+import { BaseChartWidget } from './base-chart.js';
+/**
+ * Pie/Donut chart widget (Apache ECharts). Use data-url or inline data.
+ * When widgetData is present (from API), use its items so slice labels use backend formatters (e.g. status -> Pending, Approved).
+ * Otherwise: first column = name, second = value; or single column = count per category.
+ */
+export declare class PieChartWidget extends BaseChartWidget {
+    buildOption(data: Record<string, unknown>[], meta: Record<string, {
+        type?: string;
+    }>, widgetData?: unknown): EChartsOption;
+}
+//# sourceMappingURL=pie-chart.d.ts.map

package/widgets/pie-chart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pie-chart.d.ts","sourceRoot":"","sources":["../../../../libs/analytics/src/widgets/pie-chart.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAQlD;;;;GAIG;AACH,qBACa,cAAe,SAAQ,eAAe;IACxC,WAAW,CAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EACvC,UAAU,CAAC,EAAE,OAAO,GACnB,aAAa;CA2CjB"}

package/widgets/pie-chart.js

@@ -0,0 +1,55 @@
+import { __decorate } from "tslib";
+import { customElement } from 'lit/decorators.js';
+import { BaseChartWidget } from './base-chart.js';
+/**
+ * Pie/Donut chart widget (Apache ECharts). Use data-url or inline data.
+ * When widgetData is present (from API), use its items so slice labels use backend formatters (e.g. status -> Pending, Approved).
+ * Otherwise: first column = name, second = value; or single column = count per category.
+ */
+let PieChartWidget = class PieChartWidget extends BaseChartWidget {
+    buildOption(data, meta, widgetData) {
+        const wd = widgetData;
+        if (wd && typeof wd === 'object' && Array.isArray(wd.items) && wd.items.length > 0) {
+            const pieData = wd.items.map((item) => ({
+                name: String(item?.name ?? ''),
+                value: Number(item?.value) || 0,
+            }));
+            return {
+                tooltip: { trigger: 'item' },
+                series: [
+                    {
+                        type: 'pie',
+                        radius: wd.chartType === 'Donut' ? ['40%', '70%'] : '60%',
+                        data: pieData,
+                        label: { show: true },
+                    },
+                ],
+            };
+        }
+        const keys = data.length ? Object.keys(data[0]) : Object.keys(meta);
+        if (keys.length === 0) {
+            return { series: [{ type: 'pie', data: [] }] };
+        }
+        const nameKey = keys[0];
+        const valueKey = keys.length > 1 ? keys[1] : nameKey;
+        const pieData = data.map((r) => ({
+            name: String(r[nameKey] ?? ''),
+            value: Number(r[valueKey]) || 0,
+        }));
+        return {
+            tooltip: { trigger: 'item' },
+            series: [
+                {
+                    type: 'pie',
+                    radius: '60%',
+                    data: pieData,
+                    label: { show: true },
+                },
+            ],
+        };
+    }
+};
+PieChartWidget = __decorate([
+    customElement('analytics-pie-chart')
+], PieChartWidget);
+export { PieChartWidget };

package/widgets/table.d.ts

@@ -0,0 +1,101 @@
+import { LitElement } from 'lit';
+import type { WidgetDefinitionSubset } from '../core/fetch-data.js';
+import type { DashboardContainer } from '../dashboard/dashboard-container.js';
+import '../filters/index.js';
+/**
+ * Table widget. Fetches data from data-url (Laravel analytics API)
+ * or uses inline data, then renders an HTML table.
+ * When dashboard is set, merges dashboard params with dataParams and listens for
+ * analytics-dashboard-filter-change and analytics-dashboard-refresh.
+ */
+export declare class TableWidget extends LitElement {
+    static styles: import("lit").CSSResult;
+    /** Optional title override. When unset, the widget uses the title from the API definition. */
+    title: string;
+    /** API URL to fetch data (e.g. /api/analytics/widgets/1/data). When widgetId + apiUrl are set, overridden by buildWidgetDataUrl(apiUrl, widgetId). */
+    dataUrl: string;
+    /** Widget id (used with apiUrl to build data URL: /widgets/{id}/data). */
+    widgetId: string;
+    /** API base URL (host + prefix, e.g. /api/analytics). Used with widgetId to build data URL. */
+    apiUrl: string;
+    /** Query params for data-url (e.g. date_from, date_to). Widget params override dashboard params for same key. */
+    dataParams: Record<string, string | number | boolean>;
+    /** When set, widget receives dashboard filter/refresh events and merges dashboard params into requests. */
+    dashboard: DashboardContainer | null;
+    /** Inline data instead of fetching (for designer preview). */
+    data: Record<string, unknown>[] | null;
+    /** Inline meta (columns) when using inline data. */
+    meta: {
+        columns: Record<string, {
+            type?: string;
+        }>;
+    };
+    /** Transformed table data from API (columns, columnDefs, header_rows, rows, rowSpanRuns). When set, used for structure and headers instead of deriving from data. */
+    private _widgetData;
+    /** When true, only fetch/render when widget enters viewport; pause refresh when out of viewport. */
+    lazy: boolean;
+    /** CSS margin around viewport to trigger visibility earlier (e.g. '200px'). Used when lazy is true. */
+    prefetchMargin: string;
+    /** When set (e.g. by analytics-widget), definition is not fetched again; used to avoid duplicate definition requests. */
+    initialDefinition: WidgetDefinitionSubset | undefined;
+    private _loading;
+    private _error;
+    private _loadGeneration;
+    private _loadDataDebounceId;
+    private _loadDataInFlight;
+    private _ignoreNextFilterChange;
+    private _dashboardParams;
+    private _widgetFilters;
+    private _widgetFilterParams;
+    private _hideFilter;
+    private _dashboardEl;
+    private _viewportVisible;
+    /** Title from widget definition (API). Optional `title` attribute overrides this. */
+    private _definitionTitle;
+    private _hasLoadedOnce;
+    private _viewportUnobserve;
+    private _resizeObserver;
+    private _resizeDelayId;
+    private _resizeDebounceId;
+    /** Initial delay (ms) before entering debounce; each new resize signal cancels and restarts. */
+    private static readonly _RESIZE_DELAY_MS;
+    /** Debounce (ms) after delay; resize runs only when no signal for this long. */
+    private static readonly _RESIZE_DEBOUNCE_MS;
+    constructor();
+    private _boundOnDashboardFilterChange;
+    private _boundOnDashboardRefresh;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    updated(changed: Map<string, unknown>): void;
+    private _attachDashboard;
+    private _detachDashboard;
+    firstUpdated(): void;
+    /** Debounce (ms) so multiple updated() calls (e.g. dataUrl then dataParams in separate ticks) result in one fetch. */
+    private static readonly _LOAD_DATA_DEBOUNCE_MS;
+    /** Debounce data load so multiple updated() calls (e.g. dataUrl then dataParams) result in one fetch. */
+    private _scheduleLoadData;
+    private _getEffectiveDataUrl;
+    private _getEffectiveParams;
+    /** Display title: optional host `title` overrides definition title from API. */
+    private get _effectiveTitle();
+    /** Run a callback after the current update cycle to avoid Lit "change-in-update" warning. */
+    private _defer;
+    private _loadData;
+    private _onWidgetFilterChange;
+    /** Column keys in display order. From widgetData when present, else derived from data/meta. */
+    private _getColumns;
+    /** Body rows. From widgetData.rows when present, else from data. */
+    private _getRows;
+    /** Header label for column key. From widgetData.columnDefs or header_rows when present. */
+    private _getColumnLabel;
+    /** Text-align for column. From widgetData.columnDefs when present. */
+    private _getColumnAlign;
+    /** Rowspan for this cell (column, rowIndex). 0 = merged (skip rendering cell). */
+    private _getCellRowSpan;
+    private _isTotalsRow;
+    render(): import("lit-html").TemplateResult<1>;
+    private _renderThead;
+    private _renderBodyRow;
+    private _formatCell;
+}
+//# sourceMappingURL=table.d.ts.map

package/widgets/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../../libs/analytics/src/widgets/table.ts"],"names":[],"mappings":"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"}