@quicdata/analytics 0.0.3 → 0.0.4

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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"}

package/dashboard/dashboard-container.js

@@ -0,0 +1,315 @@
+import { __decorate } from "tslib";
+import { LitElement, html, css } from 'lit';
+import { customElement, property, state } from 'lit/decorators.js';
+import { GridStack } from 'gridstack';
+import '../filters/index.js';
+import 'gridstack/dist/gridstack.min.css';
+/** Normalized layout: children always array (possibly empty), slots always array. */
+function getLayoutChildren(layout) {
+    return layout.children ?? [];
+}
+function getLayoutSlots(layout) {
+    return layout.slots ?? [];
+}
+export const EVENT_DASHBOARD_FILTER_CHANGE = 'analytics-dashboard-filter-change';
+export const EVENT_DASHBOARD_REFRESH = 'analytics-dashboard-refresh';
+export 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.
+ */
+let DashboardContainer = class DashboardContainer extends LitElement {
+    constructor() {
+        super(...arguments);
+        this.layout = { slots: [] };
+        this._dashboardParams = {};
+        this._filterBarOpen = false;
+        this._refreshIntervalId = null;
+        this._gridStack = null;
+    }
+    static { this.styles = css `
+    :host {
+      display: block;
+      width: 100%;
+      height: 100%;
+    }
+    .header {
+      display: flex;
+      flex-direction: column;
+      align-items: flex-start;
+      gap: 0.75rem;
+      margin-bottom: 0.75rem;
+    }
+    .header-row {
+      display: flex;
+      align-items: center;
+      gap: 0.75rem;
+    }
+    .grid {
+      display: grid;
+      width: 100%;
+      height: 100%;
+      min-height: 200px;
+      box-sizing: border-box;
+    }
+    .grid-stack {
+      min-height: 200px;
+      width: 100%;
+    }
+    .grid-stack-item-content {
+      display: flex;
+      flex-direction: column;
+      min-height: 0;
+      overflow: hidden;
+    }
+    .slot {
+      display: flex;
+      flex-direction: column;
+      min-height: 0;
+      overflow: hidden;
+    }
+    .slot-title {
+      font-size: 0.875rem;
+      font-weight: 600;
+      padding: 0.25rem 0.5rem;
+      flex-shrink: 0;
+    }
+    .slot-chart {
+      flex: 1;
+      min-height: 0;
+    }
+  `; }
+    connectedCallback() {
+        super.connectedCallback();
+        this._startRefreshInterval();
+    }
+    disconnectedCallback() {
+        this._destroyGridStack();
+        this._stopRefreshInterval();
+        super.disconnectedCallback();
+    }
+    firstUpdated() {
+        const children = getLayoutChildren(this.layout);
+        if (children.length > 0) {
+            this._initGridStack();
+        }
+    }
+    updated(changed) {
+        if (changed.has('layout')) {
+            this._stopRefreshInterval();
+            this._startRefreshInterval();
+            const children = getLayoutChildren(this.layout);
+            if (children.length > 0 && this._gridStack) {
+                this._loadGridStackChildren();
+            }
+        }
+    }
+    _destroyGridStack() {
+        if (this._gridStack?.el) {
+            this._gridStack.destroy(false);
+            this._gridStack = null;
+        }
+    }
+    _initGridStack() {
+        const el = this.renderRoot.querySelector('.grid-stack');
+        if (!el || this._gridStack)
+            return;
+        const column = this.layout.column ?? 12;
+        this._gridStack = GridStack.init({ column, float: false }, el);
+        const saveCB = (node, w) => {
+            w.type = node.type;
+        };
+        this._gridStack.on('change', () => {
+            const saved = this._gridStack?.save(false, false, saveCB);
+            if (saved) {
+                const children = saved.map((s) => ({
+                    widgetId: String(s.id ?? ''),
+                    type: s.type,
+                    x: s.x ?? 0,
+                    y: s.y ?? 0,
+                    w: s.w ?? 1,
+                    h: s.h ?? 1,
+                }));
+                this.dispatchEvent(new CustomEvent(EVENT_DASHBOARD_LAYOUT_CHANGE, {
+                    bubbles: true,
+                    composed: true,
+                    detail: { children },
+                }));
+            }
+        });
+        this._loadGridStackChildren();
+    }
+    _loadGridStackChildren() {
+        const children = getLayoutChildren(this.layout);
+        if (!this._gridStack || children.length === 0)
+            return;
+        const apiUrl = this.layout.apiUrl ?? '';
+        const dashboard = this;
+        const widgets = children.map((c) => ({
+            id: c.widgetId,
+            x: c.x,
+            y: c.y,
+            w: c.w,
+            h: c.h,
+            type: c.type,
+            lazy: c.lazy,
+            prefetch_margin: c.prefetch_margin,
+        }));
+        const addRemove = (parent, w, add, grid) => {
+            if (!add || grid)
+                return undefined;
+            const widget = w;
+            const item = document.createElement('div');
+            item.className = 'grid-stack-item';
+            const content = document.createElement('div');
+            content.className = 'grid-stack-item-content';
+            const type = (widget.type || 'bar').toLowerCase();
+            const tag = type === 'line' ? 'analytics-line-chart' : type === 'pie' ? 'analytics-pie-chart' : type === 'table' ? 'analytics-table' : 'analytics-bar-chart';
+            const widgetEl = document.createElement(tag);
+            widgetEl.setAttribute('widget-id', String(widget.id ?? ''));
+            widgetEl.setAttribute('api-url', apiUrl);
+            if (widget.lazy) {
+                widgetEl.setAttribute('lazy', '');
+                const margin = widget.prefetch_margin;
+                if (margin)
+                    widgetEl.setAttribute('prefetch-margin', margin);
+            }
+            widgetEl.dashboard = dashboard;
+            content.appendChild(widgetEl);
+            item.appendChild(content);
+            return item;
+        };
+        this._gridStack.load(widgets, addRemove);
+    }
+    _startRefreshInterval() {
+        const rate = this.layout.refresh_rate ?? 0;
+        if (rate > 0) {
+            this._refreshIntervalId = setInterval(() => {
+                this.dispatchEvent(new CustomEvent(EVENT_DASHBOARD_REFRESH, {
+                    bubbles: true,
+                    composed: true,
+                }));
+            }, rate * 1000);
+        }
+    }
+    _stopRefreshInterval() {
+        if (this._refreshIntervalId != null) {
+            clearInterval(this._refreshIntervalId);
+            this._refreshIntervalId = null;
+        }
+    }
+    /** Current dashboard-level filter params (for widgets to merge). Returns {} when layout.hide_filter is true. */
+    getDashboardParams() {
+        if (this.layout?.hide_filter)
+            return {};
+        return { ...this._dashboardParams };
+    }
+    _onFilterChange(e) {
+        this._dashboardParams = { ...(e.detail?.params ?? {}) };
+        this.dispatchEvent(new CustomEvent(EVENT_DASHBOARD_FILTER_CHANGE, {
+            bubbles: true,
+            composed: true,
+            detail: { params: this._dashboardParams },
+        }));
+    }
+    _onFilterClose() {
+        this._filterBarOpen = false;
+    }
+    _onFilterToggle() {
+        this._filterBarOpen = !this._filterBarOpen;
+    }
+    render() {
+        const children = getLayoutChildren(this.layout);
+        const slots = getLayoutSlots(this.layout);
+        const useGridster = children.length > 0;
+        const { columns = '1fr 1fr', rows = 'auto', gap = '1rem', filters = [], hide_filter = false } = this.layout;
+        const gridStyle = `grid-template-columns: ${columns}; grid-template-rows: ${rows}; gap: ${gap};`;
+        const hasFilters = filters.length > 0 && !hide_filter;
+        const activeCount = Object.keys(this._dashboardParams).filter((k) => this._dashboardParams[k] !== '' && this._dashboardParams[k] != null).length;
+        return html `
+      ${hasFilters
+            ? html `
+            <div class="header">
+              <div class="header-row">
+                <analytics-filter-button
+                  .activeCount=${activeCount}
+                  .open=${this._filterBarOpen}
+                  @analytics-filter-toggle=${this._onFilterToggle}
+                ></analytics-filter-button>
+              </div>
+              ${this._filterBarOpen
+                ? html `
+                    <analytics-filter-bar
+                      .filters=${filters}
+                      .values=${this._dashboardParams}
+                      .showClose=${true}
+                      @analytics-filter-change=${this._onFilterChange}
+                      @analytics-filter-close=${this._onFilterClose}
+                    ></analytics-filter-bar>
+                  `
+                : ''}
+            </div>
+          `
+            : ''}
+      ${useGridster
+            ? html `<div class="grid-stack"></div>`
+            : html `
+            <div class="grid" style="${gridStyle}">
+              ${slots.map((slot) => html `
+                  <div class="slot" style="${slot.gridArea ? `grid-area: ${slot.gridArea};` : ''}">
+                    ${slot.title ? html `<div class="slot-title">${slot.title}</div>` : ''}
+                    <div class="slot-chart">
+                      ${this._renderSlot(slot)}
+                    </div>
+                  </div>
+                `)}
+            </div>
+          `}
+    `;
+    }
+    _renderSlot(slot) {
+        const dataUrl = slot.dataUrl ?? '';
+        const params = slot.dataParams ?? {};
+        const type = (slot.type || 'bar').toLowerCase();
+        const tag = type === 'line'
+            ? 'analytics-line-chart'
+            : type === 'pie'
+                ? 'analytics-pie-chart'
+                : type === 'table'
+                    ? 'analytics-table'
+                    : type === 'analytics-line-chart'
+                        ? 'analytics-line-chart'
+                        : type === 'analytics-pie-chart'
+                            ? 'analytics-pie-chart'
+                            : type === 'analytics-table'
+                                ? 'analytics-table'
+                                : 'analytics-bar-chart';
+        const lazy = slot.lazy ?? false;
+        const prefetchMargin = slot.prefetch_margin ?? '200px';
+        switch (tag) {
+            case 'analytics-line-chart':
+                return html `<analytics-line-chart data-url="${dataUrl}" .dataParams=${params} .dashboard=${this} .lazy=${lazy} prefetch-margin="${prefetchMargin}"></analytics-line-chart>`;
+            case 'analytics-pie-chart':
+                return html `<analytics-pie-chart data-url="${dataUrl}" .dataParams=${params} .dashboard=${this} .lazy=${lazy} prefetch-margin="${prefetchMargin}"></analytics-pie-chart>`;
+            case 'analytics-table':
+                return html `<analytics-table data-url="${dataUrl}" .dataParams=${params} .dashboard=${this} .lazy=${lazy} prefetch-margin="${prefetchMargin}"></analytics-table>`;
+            default:
+                return html `<analytics-bar-chart data-url="${dataUrl}" .dataParams=${params} .dashboard=${this} .lazy=${lazy} prefetch-margin="${prefetchMargin}"></analytics-bar-chart>`;
+        }
+    }
+};
+__decorate([
+    property({ type: Object })
+], DashboardContainer.prototype, "layout", void 0);
+__decorate([
+    state()
+], DashboardContainer.prototype, "_dashboardParams", void 0);
+__decorate([
+    state()
+], DashboardContainer.prototype, "_filterBarOpen", void 0);
+DashboardContainer = __decorate([
+    customElement('analytics-dashboard')
+], DashboardContainer);
+export { DashboardContainer };

package/dashboard/index.d.ts

@@ -0,0 +1,4 @@
+export { DashboardContainer, EVENT_DASHBOARD_FILTER_CHANGE, EVENT_DASHBOARD_REFRESH, EVENT_DASHBOARD_LAYOUT_CHANGE, } from './dashboard-container.js';
+export type { DashboardLayout, DashboardSlot, GridsterGridItem } from './dashboard-container.js';
+import './dashboard-container.js';
+//# sourceMappingURL=index.d.ts.map

package/dashboard/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../libs/analytics/src/dashboard/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,6BAA6B,EAC7B,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjG,OAAO,0BAA0B,CAAC"}

package/dashboard/index.js

@@ -0,0 +1,2 @@
+export { DashboardContainer, EVENT_DASHBOARD_FILTER_CHANGE, EVENT_DASHBOARD_REFRESH, EVENT_DASHBOARD_LAYOUT_CHANGE, } from './dashboard-container.js';
+import './dashboard-container.js';