@quicdata/analytics 0.0.3 → 0.0.5

package/core/types.d.ts

@@ -0,0 +1,250 @@
+/**
+ * API response shape from Laravel analytics dataset/widget data endpoints.
+ * KoolReport returns { data: rows, meta: { columns: Record<string, { type: string }> } }.
+ */
+export interface AnalyticsDataMeta {
+    columns: Record<string, {
+        type?: string;
+    }>;
+}
+export interface AnalyticsDataResponse {
+    data: Record<string, unknown>[];
+    meta: AnalyticsDataMeta;
+}
+/** Full widget/data API response: widgetData, data, meta, filters, refresh_rate. */
+export interface WidgetDataResponse extends AnalyticsDataResponse {
+    widgetData?: unknown;
+    filters?: FilterDefinition[];
+    refresh_rate?: number;
+}
+export interface WidgetDataOptions {
+    /** Base URL for API (e.g. /api/analytics). */
+    baseUrl?: string;
+    /** Query params to append (e.g. date_from, date_to). */
+    params?: Record<string, string | number | boolean>;
+}
+/**
+ * Insights-inspired widget config types.
+ * Emphasis on granularity for datetime dimensions (year, month, quarter, day, week).
+ */
+/** Supported granularity for datetime columns. */
+export type DatetimeGranularity = 'year' | 'quarter' | 'month' | 'week' | 'day' | 'hour';
+export interface DimensionRef {
+    column_name: string;
+    data_type: string;
+    dimension_name?: string;
+    label?: string;
+    value?: string;
+    /** Only for datetime columns. */
+    granularity?: DatetimeGranularity;
+}
+export interface MeasureRef {
+    aggregation: 'count' | 'sum' | 'avg' | 'min' | 'max';
+    column_name: string;
+    data_type: string;
+    measure_name?: string;
+}
+export interface FilterItem {
+    column?: string;
+    operator?: string;
+    value?: unknown;
+}
+export interface CommonChartConfig {
+    filters?: {
+        filters: FilterItem[];
+        logical_operator: 'And' | 'Or';
+    };
+    limit?: string;
+    order_by?: Array<{
+        column: {
+            column_name: string;
+            type: string;
+        };
+        direction: 'asc' | 'desc';
+    }>;
+}
+export interface BarChartConfig extends CommonChartConfig {
+    x_axis: {
+        dimension: DimensionRef;
+    };
+    y_axis: {
+        series: Array<{
+            measure: MeasureRef;
+        }>;
+        stack?: boolean;
+        overlap?: boolean;
+        normalize?: boolean;
+        show_axis_label?: boolean;
+        show_data_labels?: boolean;
+        show_scrollbar?: boolean;
+    };
+    split_by?: {
+        dimension: DimensionRef;
+        max_split_values?: string;
+    };
+}
+export interface LineChartConfig extends CommonChartConfig {
+    x_axis: {
+        dimension: DimensionRef;
+    };
+    y_axis: {
+        series: Array<{
+            measure: MeasureRef;
+        }>;
+        stack?: boolean;
+        show_axis_label?: boolean;
+        show_data_labels?: boolean;
+    };
+    split_by?: {
+        dimension: DimensionRef;
+        max_split_values?: string;
+    };
+}
+export interface DonutPieChartConfig extends CommonChartConfig {
+    label_column: {
+        dimension: DimensionRef;
+    };
+    value_column: {
+        measure: MeasureRef;
+    };
+    label_position?: 'left' | 'right' | 'top' | 'bottom';
+    legend_position?: 'left' | 'right' | 'top' | 'bottom';
+    max_slices?: string;
+    show_inline_labels?: boolean;
+}
+export interface NumberKpiChartConfig extends CommonChartConfig {
+    number_columns: Array<{
+        measure: MeasureRef;
+    }>;
+    number_column_options?: Array<{
+        decimal?: string;
+        prefix?: string;
+        suffix?: string;
+    }>;
+    date_column?: {
+        dimension: DimensionRef;
+    };
+    comparison?: boolean;
+    shorten_numbers?: boolean;
+    sparkline?: boolean;
+}
+export interface TableChartConfig extends CommonChartConfig {
+    columns?: Array<{
+        column_name: string;
+        label?: string;
+        format?: string;
+        type?: string;
+    }>;
+    page_size?: number;
+}
+export type ChartType = 'Bar' | 'BarHorizontal' | 'Line' | 'Donut' | 'Pie' | 'Number' | 'Table';
+export interface WidgetDefinitionConfig {
+    chart_type: ChartType;
+    config: BarChartConfig | LineChartConfig | DonutPieChartConfig | NumberKpiChartConfig | TableChartConfig;
+}
+/**
+ * Transformed widget data shapes for easier rendering by chart type.
+ * Produced by WidgetDataTransformer from originalData + widget definition.
+ */
+export interface BarWidgetData {
+    chartType: 'Bar' | 'BarHorizontal';
+    categories: string[];
+    series: Array<{
+        name: string;
+        data: number[];
+    }>;
+    stack?: boolean;
+}
+export interface LineWidgetData {
+    chartType: 'Line';
+    categories: string[];
+    series: Array<{
+        name: string;
+        data: number[];
+    }>;
+    stack?: boolean;
+}
+export interface PieWidgetData {
+    chartType: 'Pie' | 'Donut';
+    items: Array<{
+        name: string;
+        value: number;
+    }>;
+}
+export interface NumberKpiWidgetData {
+    chartType: 'Number';
+    values: number[];
+    labels: string[];
+    options?: Array<{
+        decimal?: string;
+        prefix?: string;
+        suffix?: string;
+    }>;
+}
+/** Single header cell: key maps to data column; missing key = presentational only. */
+export interface TableHeaderCell {
+    key?: string;
+    label: string;
+    colspan?: number;
+    rowspan?: number;
+    hide?: boolean;
+}
+/** Column definition from backend (order, visibility, label, align, format, rowspan). */
+export interface TableColumnDef {
+    key: string;
+    label: string;
+    hide?: boolean;
+    align?: string | null;
+    format?: string | null;
+    rowspan?: boolean;
+}
+export interface TableWidgetData {
+    chartType: 'Table';
+    /** Column keys in display order (body cells). */
+    columns: string[];
+    /** Full column definitions (labels, align, format, rowspan, hide). When present, use for headers and styling. */
+    columnDefs?: TableColumnDef[];
+    /** Multi-row header: array of rows, each row array of cells. When present, use instead of single row from columns. */
+    header_rows?: TableHeaderCell[][];
+    /** Body rows. Prefer over raw API `data` when widgetData is from backend. */
+    rows: Record<string, unknown>[];
+    /** Per-column rowspan runs: key -> array of length rows; 0 = merged with above, N = rowspan count. */
+    rowSpanRuns?: Record<string, number[]>;
+    /** Optional font size for table (e.g. '0.75rem', '12px') to adjust for table complexity. */
+    font_size?: string;
+    /** When true, the summary/totals row is sticky (stays visible when scrolling). */
+    totals_sticky?: boolean;
+    /** When totals_sticky is true, 'top' or 'bottom' – where the totals row sticks. */
+    totals_position?: 'top' | 'bottom';
+}
+export type WidgetData = BarWidgetData | LineWidgetData | PieWidgetData | NumberKpiWidgetData | TableWidgetData;
+/** Filter option from API (preset or static options). */
+export interface FilterOption {
+    value: string | number;
+    label?: string;
+}
+/** Filter definition from dashboard or widget API (param_name, type, label, options, default_value). */
+export interface FilterDefinition {
+    param_name: string;
+    type: string;
+    /** UI label (e.g. "Year", "Month"); falls back to param_name if omitted. */
+    label?: string;
+    options?: FilterOption[];
+    /** Default value when none selected; sent as param value if user has not chosen a value. */
+    default_value?: string | number | boolean;
+}
+/** Options for lazy viewport-based rendering of widgets. */
+export interface LazyWidgetOptions {
+    /** 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 as IntersectionObserver rootMargin. */
+    prefetch_margin?: string;
+}
+/** Options for offloading heavy transforms to a Web Worker. */
+export interface WorkerWidgetOptions {
+    /** When true, attempt to run dataset transform (pivot/aggregation) in a worker. Fallback to main thread if unsupported or data small. */
+    use_worker?: boolean;
+    /** Minimum row count to use worker (below this, main thread is used). Default 500. */
+    worker_min_rows?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/core/types.d.ts.map

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

package/core/types.js

@@ -0,0 +1 @@
+export {};

package/core/viewport-observer.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Viewport observer for lazy rendering: only fetch/render when widget enters viewport.
+ * Uses IntersectionObserver with configurable rootMargin (prefetch_margin).
+ */
+export interface ViewportObserverOptions {
+    /** CSS margin around root to trigger "in view" earlier (e.g. '200px' for prefetch). */
+    rootMargin?: string;
+    /** Intersection ratio threshold (0–1). Default 0. */
+    threshold?: number;
+}
+export interface ViewportObserverCallbacks {
+    /** Called when element enters viewport (or is already visible). */
+    onEnter: () => void;
+    /** Called when element leaves viewport. */
+    onLeave?: () => void;
+}
+/**
+ * Observes an element for viewport visibility. When the element intersects the viewport
+ * (with optional rootMargin), onEnter is called; when it leaves, onLeave is called.
+ * @param element - DOM element to observe (e.g. widget container).
+ * @param options - rootMargin (e.g. '200px'), threshold.
+ * @param callbacks - onEnter (required), onLeave (optional).
+ * @returns Cleanup function (disconnect observer).
+ */
+export declare function observeViewport(element: Element, options: ViewportObserverOptions, callbacks: ViewportObserverCallbacks): () => void;
+//# sourceMappingURL=viewport-observer.d.ts.map

package/core/viewport-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport-observer.d.ts","sourceRoot":"","sources":["../../../../libs/analytics/src/core/viewport-observer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,uBAAuB;IACtC,uFAAuF;IACvF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,mEAAmE;IACnE,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,uBAAuB,EAChC,SAAS,EAAE,yBAAyB,GACnC,MAAM,IAAI,CA6BZ"}

package/core/viewport-observer.js

@@ -0,0 +1,38 @@
+/**
+ * Viewport observer for lazy rendering: only fetch/render when widget enters viewport.
+ * Uses IntersectionObserver with configurable rootMargin (prefetch_margin).
+ */
+/**
+ * Observes an element for viewport visibility. When the element intersects the viewport
+ * (with optional rootMargin), onEnter is called; when it leaves, onLeave is called.
+ * @param element - DOM element to observe (e.g. widget container).
+ * @param options - rootMargin (e.g. '200px'), threshold.
+ * @param callbacks - onEnter (required), onLeave (optional).
+ * @returns Cleanup function (disconnect observer).
+ */
+export function observeViewport(element, options, callbacks) {
+    if (typeof IntersectionObserver === 'undefined') {
+        callbacks.onEnter();
+        return () => { };
+    }
+    const { rootMargin = '0px', threshold = 0 } = options;
+    let connected = true;
+    const observer = new IntersectionObserver((entries) => {
+        if (!connected)
+            return;
+        const entry = entries[0];
+        if (!entry)
+            return;
+        if (entry.isIntersecting) {
+            callbacks.onEnter();
+        }
+        else {
+            callbacks.onLeave?.();
+        }
+    }, { root: null, rootMargin, threshold });
+    observer.observe(element);
+    return () => {
+        connected = false;
+        observer.disconnect();
+    };
+}

package/core/widget-transform-runner.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Runs widget data transform in a Web Worker (optional) with fallback to main thread.
+ * Use for large datasets to avoid blocking the UI. Worker is lazy-loaded on first use.
+ */
+import type { WorkerWidgetOptions } from './types.js';
+export interface WidgetTransformInput {
+    widgetDefinition: Record<string, unknown>;
+    data: Record<string, unknown>[];
+}
+export interface WidgetTransformOptions extends WorkerWidgetOptions {
+    /** Override worker script URL (for environments where import.meta.url is not available). */
+    workerUrl?: string;
+}
+/**
+ * Run widget data transform. Uses Web Worker when use_worker is true and data length >= worker_min_rows;
+ * otherwise runs on main thread.
+ * @param input - widgetDefinition and data
+ * @param options - use_worker, worker_min_rows, workerUrl
+ * @returns Promise resolving to widgetData (e.g. TableWidgetData)
+ */
+export declare function runWidgetTransform(input: WidgetTransformInput, options?: WidgetTransformOptions): Promise<unknown>;
+//# sourceMappingURL=widget-transform-runner.d.ts.map

package/core/widget-transform-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-transform-runner.d.ts","sourceRoot":"","sources":["../../../../libs/analytics/src/core/widget-transform-runner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IACjE,4FAA4F;IAC5F,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAyED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,oBAAoB,EAC3B,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,OAAO,CAAC,CA2BlB"}

package/core/widget-transform-runner.js

@@ -0,0 +1,102 @@
+/**
+ * Runs widget data transform in a Web Worker (optional) with fallback to main thread.
+ * Use for large datasets to avoid blocking the UI. Worker is lazy-loaded on first use.
+ */
+let _worker = null;
+let _workerLoadPromise = null;
+let _nextId = 0;
+const _pending = new Map();
+const DEFAULT_WORKER_MIN_ROWS = 500;
+function mainThreadTransform(widgetDefinition, data) {
+    if (!Array.isArray(data) || data.length === 0) {
+        return { chartType: 'Table', columns: [], rows: [] };
+    }
+    const columns = Object.keys(data[0]);
+    return { chartType: 'Table', columns, rows: data };
+}
+function getWorkerUrl() {
+    try {
+        return new URL('../workers/widget-transform.worker.js', import.meta.url).href;
+    }
+    catch {
+        return null;
+    }
+}
+function loadWorker(workerUrl) {
+    if (_worker)
+        return Promise.resolve(_worker);
+    if (_workerLoadPromise)
+        return _workerLoadPromise;
+    const url = workerUrl ?? getWorkerUrl();
+    if (!url || typeof Worker === 'undefined') {
+        return Promise.reject(new Error('Worker not supported or URL not available'));
+    }
+    _workerLoadPromise = new Promise((resolve, reject) => {
+        try {
+            const w = new Worker(url, { type: 'module' });
+            w.onmessage = (e) => {
+                const d = e.data;
+                if (d?.type === 'result' && typeof d.id === 'number') {
+                    const pending = _pending.get(d.id);
+                    if (pending) {
+                        clearTimeout(pending.timeoutId);
+                        _pending.delete(d.id);
+                        pending.resolve(d.widgetData);
+                    }
+                }
+                else if (d?.type === 'error' && typeof d.id === 'number') {
+                    const pending = _pending.get(d.id);
+                    if (pending) {
+                        clearTimeout(pending.timeoutId);
+                        _pending.delete(d.id);
+                        pending.reject(new Error(d.error ?? 'Worker error'));
+                    }
+                }
+            };
+            w.onerror = () => {
+                _workerLoadPromise = null;
+                reject(new Error('Worker failed to load'));
+            };
+            _worker = w;
+            resolve(w);
+        }
+        catch (err) {
+            _workerLoadPromise = null;
+            reject(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    return _workerLoadPromise;
+}
+/**
+ * Run widget data transform. Uses Web Worker when use_worker is true and data length >= worker_min_rows;
+ * otherwise runs on main thread.
+ * @param input - widgetDefinition and data
+ * @param options - use_worker, worker_min_rows, workerUrl
+ * @returns Promise resolving to widgetData (e.g. TableWidgetData)
+ */
+export function runWidgetTransform(input, options = {}) {
+    const { use_worker = false, worker_min_rows = DEFAULT_WORKER_MIN_ROWS, workerUrl } = options;
+    const { widgetDefinition, data } = input;
+    const rows = Array.isArray(data) ? data.length : 0;
+    const useWorker = use_worker && rows >= worker_min_rows;
+    if (!useWorker) {
+        return Promise.resolve(mainThreadTransform(widgetDefinition, data ?? []));
+    }
+    const id = ++_nextId;
+    return loadWorker(workerUrl)
+        .then((worker) => {
+        return new Promise((resolve, reject) => {
+            const timeoutId = setTimeout(() => {
+                if (_pending.has(id)) {
+                    _pending.delete(id);
+                    reject(new Error('Worker transform timeout'));
+                }
+            }, 60000);
+            _pending.set(id, { resolve, reject, timeoutId });
+            worker.postMessage({ type: 'transform', id, widgetDefinition, data: data ?? [] });
+        });
+    })
+        .catch(() => {
+        return mainThreadTransform(widgetDefinition, data ?? []);
+    });
+}

package/dashboard/dashboard-container.d.ts

@@ -0,0 +1,100 @@
+import { LitElement } from 'lit';
+import type { FilterDefinition } from '../core/types.js';
+import '../filters/index.js';
+import 'gridstack/dist/gridstack.min.css';
+export interface DashboardSlot {
+    /** Widget type: analytics-bar-chart, analytics-line-chart, analytics-pie-chart, analytics-table, etc. */
+    type: string;
+    /** Data URL (e.g. /api/analytics/widgets/1/data). */
+    dataUrl?: string;
+    /** Query params for data-url. */
+    dataParams?: Record<string, string | number | boolean>;
+    /** Grid area: row start, col start, row span, col span. */
+    gridArea?: string;
+    /** Optional title. */
+    title?: string;
+    /** When true, only fetch/render when widget enters viewport. */
+    lazy?: boolean;
+    /** CSS margin for viewport prefetch (e.g. '200px'). Used when lazy is true. */
+    prefetch_margin?: string;
+}
+/** Gridster/GridStack item: widget id + position/size. Stored in dashboard layout. */
+export interface GridsterGridItem {
+    /** Widget id (used to build /widgets/{id}/data URL). */
+    widgetId: string;
+    /** Widget type: bar, line, pie, table (for rendering the right component). */
+    type?: string;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    /** GridStack node id (optional; can use widgetId). */
+    id?: string;
+    /** Optional title. */
+    title?: string;
+    /** When true, only fetch/render when widget enters viewport. */
+    lazy?: boolean;
+    /** CSS margin for viewport prefetch (e.g. '200px'). Used when lazy is true. */
+    prefetch_margin?: string;
+}
+export interface DashboardLayout {
+    /** API base URL (host + prefix, e.g. https://api.example.com/api/analytics). Used with widgetId to build data URL. */
+    apiUrl?: string;
+    /** Gridster/GridStack: number of columns (default 12). */
+    column?: number;
+    /** Gridster/GridStack: layout children (widgetId, type, x, y, w, h). When set, dashboard uses GridStack. */
+    children?: GridsterGridItem[];
+    /** Legacy: grid columns (e.g. "1fr 1fr"). */
+    columns?: string;
+    /** Legacy: grid rows (e.g. "auto 1fr"). */
+    rows?: string;
+    /** Legacy: gap between items. */
+    gap?: string;
+    /** Legacy: slots to render (when children is not set). */
+    slots?: DashboardSlot[];
+    /** Dashboard-level filter definitions (from API). */
+    filters?: FilterDefinition[];
+    /** When true, dashboard filter bar is hidden and dashboard params are not sent to widgets. */
+    hide_filter?: boolean;
+    /** Refresh interval in seconds (0 = no auto refresh). */
+    refresh_rate?: number;
+}
+export declare const EVENT_DASHBOARD_FILTER_CHANGE = "analytics-dashboard-filter-change";
+export declare const EVENT_DASHBOARD_REFRESH = "analytics-dashboard-refresh";
+export declare const EVENT_DASHBOARD_LAYOUT_CHANGE = "analytics-dashboard-layout-change";
+/**
+ * Dashboard container: renders a grid of analytics widgets (Lit web components).
+ * Shows filter button and filter bar when layout.filters is set; dispatches filter-change and refresh
+ * When layout.children is set, uses GridStack (gridster); otherwise legacy slots + CSS grid.
+ * Passes apiUrl + widgetId to widgets; dispatches layout-change when grid layout changes.
+ */
+export declare class DashboardContainer extends LitElement {
+    static styles: import("lit").CSSResult;
+    layout: DashboardLayout;
+    private _dashboardParams;
+    private _filterBarOpen;
+    private _refreshIntervalId;
+    private _gridStack;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    firstUpdated(): void;
+    updated(changed: Map<string, unknown>): void;
+    private _destroyGridStack;
+    private _initGridStack;
+    private _loadGridStackChildren;
+    private _startRefreshInterval;
+    private _stopRefreshInterval;
+    /** Current dashboard-level filter params (for widgets to merge). Returns {} when layout.hide_filter is true. */
+    getDashboardParams(): Record<string, string | number | boolean>;
+    private _onFilterChange;
+    private _onFilterClose;
+    private _onFilterToggle;
+    render(): import("lit-html").TemplateResult<1>;
+    private _renderSlot;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'analytics-dashboard': DashboardContainer;
+    }
+}
+//# sourceMappingURL=dashboard-container.d.ts.map

package/dashboard/dashboard-container.d.ts.map

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