@mmlogic/components 0.2.0 → 0.3.1

package/dist/collection/components/mrd-table/mrd-table.js

@@ -22,7 +22,10 @@ export class MrdTable {
         this.outsideClickHandler = null;
         this.keydownHandler = null;
         // ── Props ──────────────────────────────────────────────────────────────────
-        this.columns = [];
+        /** The VIEW or RELATED_VIEW layout item. Contains view config, dataClass, fromClass, actions etc. */
+        this.item = null;
+        /** Parent record id — required for RELATED_VIEW to build /{fromClass}/{parentId}/{dataClass}. */
+        this.parentId = '';
         /** Direct rows (non-paginated mode, used when totalElements === 0). */
         this.rows = [];
         this.locale = navigator.language;
@@ -34,16 +37,9 @@ export class MrdTable {
         this.rowHeight = 36;
         /** Height of the scroll container in px. */
         this.tableHeight = 500;
-        /** Initial sort applied on load, e.g. "timestamp,desc" or "name".
-         *  Parsed by init() into sortField + sortDir. */
-        this.defaultSort = '';
-        /** Toolbar action buttons rendered above the table. */
-        this.actions = [];
-        /** Display label of the current view — shown in the toolbar center as a view picker trigger. */
-        this.viewLabel = '';
-        /** Alternative views available for this table; renders a dropdown when non-empty. */
-        this.alternativeViews = [];
         // ── Internal state ─────────────────────────────────────────────────────────
+        /** Index into allViews[] for the currently displayed view. 0 = primary, 1+ = alternatives. */
+        this.activeViewIdx = 0;
         this.loadedPages = new Map();
         this.requestedPages = new Set();
         this.renderStart = 0;
@@ -69,10 +65,16 @@ export class MrdTable {
         this.jsonModal = null;
         /** Aggregation totals received from the host via setAggregations(). Null = not yet loaded. */
         this.aggregations = null;
+        /** Record count received via setAggregations().total; overrides totalElements for display. */
+        this.aggregationsTotal = null;
+        /** True when a fresh aggregations request is needed (set on init / filter change). */
+        this.aggregationsPending = false;
+        /** Lower bound on total derived from setPage() hasNext info; grows as pages load. */
+        this.minKnownTotal = 0;
         this.handleScroll = (e) => {
             const scroller = e.currentTarget;
             const scrollTop = scroller.scrollTop;
-            const total = this.totalElements;
+            const total = this.baseTotal;
             const visStart = Math.floor(scrollTop / this.rowHeight);
             const visEnd = Math.min(visStart + this.visibleCount(), total - 1);
             this.scrollTop = scrollTop;
@@ -86,13 +88,16 @@ export class MrdTable {
     totalElementsChanged(newVal) {
         this.renderEnd = Math.min(this.renderEnd, Math.max(0, newVal - 1));
     }
-    /** Apply defaultSort when the prop changes (e.g. after a view switch). */
-    defaultSortChanged(newVal) {
-        this.applyDefaultSort(newVal);
+    /** Reset to primary view when the item prop is replaced from outside. */
+    itemChanged(newVal) {
+        var _a, _b;
+        this.activeViewIdx = 0;
+        this.applyDefaultSort((_b = (_a = newVal === null || newVal === void 0 ? void 0 : newVal.view) === null || _a === void 0 ? void 0 : _a.defaultSort) !== null && _b !== void 0 ? _b : '');
     }
     // ── Lifecycle ──────────────────────────────────────────────────────────────
     componentWillLoad() {
-        this.applyDefaultSort(this.defaultSort);
+        var _a, _b, _c;
+        this.applyDefaultSort((_c = (_b = (_a = this.item) === null || _a === void 0 ? void 0 : _a.view) === null || _b === void 0 ? void 0 : _b.defaultSort) !== null && _c !== void 0 ? _c : '');
     }
     // ── Helpers ────────────────────────────────────────────────────────────────
     applyDefaultSort(defaultSort) {
@@ -124,14 +129,19 @@ export class MrdTable {
         this.colWidths = [];
         this.scrollTop = 0;
         this.renderStart = 0;
-        // No BUFFER on init — only request what fits the visible area (page 0).
-        // BUFFER is applied during scroll to pre-fetch the next page proactively.
-        this.renderEnd = Math.max(0, Math.min(this.visibleCount() - 1, this.totalElements - 1));
+        // Always fill the visible viewport on init — totalElements may be stale from a
+        // previous view. setPage() clamps renderEnd when the page is shorter than pageSize.
+        this.renderEnd = this.visibleCount() - 1;
         const scroller = this.el.querySelector('.mrd-table__scroll');
         if (scroller)
             scroller.scrollTop = 0;
         this.aggregations = null;
-        this.emitLoadAggregations();
+        this.aggregationsTotal = null;
+        this.aggregationsPending = true;
+        this.minKnownTotal = 0;
+        // Always request page 0 — totalElements may be unknown (0) on first load.
+        this.mrdLoadPage.emit({ page: 0, sort: this.sortParam(), path: this.buildDataPath(), qs: this.buildQueryParams(0) });
+        this.requestedPages = new Set([0]);
     }
     /**
      * Inject the rows for a given page (0-based).
@@ -140,20 +150,41 @@ export class MrdTable {
      * When the page contains fewer rows than pageSize it is the last page.
      * renderEnd is clamped immediately so no loading-placeholder rows appear
      * beyond the actual data — without requiring the host to update totalElements.
+     *
+     * Pass hasNext (from _links.next in the API response) for accurate last-page
+     * detection even when rows.length === pageSize (exact multiple of page size).
      */
-    async setPage(pageNumber, rows) {
-        if (rows.length < this.pageSize) {
+    async setPage(pageNumber, rows, hasNext) {
+        const isLastPage = hasNext !== undefined ? !hasNext : rows.length < this.pageSize;
+        if (isLastPage) {
             // lastRowIdx is -1 when the page is empty; clamp renderEnd to -1 so the
             // render loop does not execute and no shimmer rows appear.
             const lastRowIdx = pageNumber * this.pageSize + rows.length - 1;
             this.renderEnd = Math.min(this.renderEnd, lastRowIdx);
+            // Exact total is known: update minKnownTotal so the scroll container has the right height.
+            this.minKnownTotal = pageNumber * this.pageSize + rows.length;
+        }
+        else {
+            // There is at least one more page — ensure the scrollbar covers at least that next page.
+            this.minKnownTotal = Math.max(this.minKnownTotal, (pageNumber + 1) * this.pageSize + 1);
         }
         const next = new Map(this.loadedPages);
         next.set(pageNumber, rows);
         this.loadedPages = next;
+        if (pageNumber === 0 && this.aggregationsPending) {
+            this.aggregationsPending = false;
+            const hasAggColumns = this.columns.some(c => c.type === 'FIELD' && c.aggregate);
+            if (!isLastPage || hasAggColumns) {
+                this.emitLoadAggregations();
+            }
+        }
     }
     /** Inject aggregation totals returned by the /aggregations endpoint. */
     async setAggregations(data) {
+        var _a;
+        const total = (_a = data.total) !== null && _a !== void 0 ? _a : (typeof data.count === 'number' ? data.count : undefined);
+        if (total != null)
+            this.aggregationsTotal = total;
         this.aggregations = data;
     }
     // ── Lifecycle ──────────────────────────────────────────────────────────────
@@ -184,6 +215,147 @@ export class MrdTable {
             return '';
         return this.sortDir === 'desc' ? `${this.sortField},desc` : this.sortField;
     }
+    /** Stable ordered list: primary view first, then alternatives (from the item prop). */
+    get allViews() {
+        var _a, _b, _c, _d, _e, _f, _g;
+        if (!this.item)
+            return [];
+        const it = this.item;
+        return [
+            { label: (_e = (_d = (_c = (_a = it.label) !== null && _a !== void 0 ? _a : (_b = it.view) === null || _b === void 0 ? void 0 : _b.pluralLabel) !== null && _c !== void 0 ? _c : it.dataClass) !== null && _d !== void 0 ? _d : it.relatedClass) !== null && _e !== void 0 ? _e : '', dataClass: (_f = it.dataClass) !== null && _f !== void 0 ? _f : it.relatedClass, fromClass: it.fromClass, filterClass: it.filterClass, view: it.view },
+            ...((_g = it.alternativeViews) !== null && _g !== void 0 ? _g : []).map(av => {
+                var _a, _b, _c, _d;
+                return ({
+                    label: (_d = (_c = (_a = av.label) !== null && _a !== void 0 ? _a : (_b = av.view) === null || _b === void 0 ? void 0 : _b.pluralLabel) !== null && _c !== void 0 ? _c : av.dataClass) !== null && _d !== void 0 ? _d : '',
+                    dataClass: av.dataClass,
+                    fromClass: av.fromClass,
+                    filterClass: av.filterClass,
+                    view: av.view,
+                });
+            }),
+        ];
+    }
+    /** Relative excel export path for the current view.
+     *  VIEW:         /excel/{dataClass}
+     *  RELATED_VIEW: /excel/{fromClass}/{parentId}/{dataClass}  */
+    buildExcelPath() {
+        var _a, _b, _c, _d;
+        const v = this.allViews[this.activeViewIdx];
+        if (!v)
+            return '';
+        if (((_a = this.item) === null || _a === void 0 ? void 0 : _a.type) === 'RELATED_VIEW') {
+            return `/excel/${(_b = v.fromClass) !== null && _b !== void 0 ? _b : ''}/${this.parentId}/${(_c = v.dataClass) !== null && _c !== void 0 ? _c : ''}`;
+        }
+        return `/excel/${(_d = v.dataClass) !== null && _d !== void 0 ? _d : ''}`;
+    }
+    buildActionDetail(action) {
+        var _a, _b, _c;
+        if (action === 'export') {
+            return { action, path: this.buildExcelPath(), qs: this.buildQueryParams(0) };
+        }
+        if (action === 'create') {
+            const v = this.allViews[this.activeViewIdx];
+            const parentPath = ((_a = this.item) === null || _a === void 0 ? void 0 : _a.type) === 'RELATED_VIEW'
+                ? `/${(_b = v === null || v === void 0 ? void 0 : v.fromClass) !== null && _b !== void 0 ? _b : ''}/${this.parentId}`
+                : null;
+            return { action, dataClass: (_c = v === null || v === void 0 ? void 0 : v.dataClass) !== null && _c !== void 0 ? _c : '', parentPath };
+        }
+        return { action };
+    }
+    /** Relative data path for the current view, without query string.
+     *  VIEW:         /{dataClass}
+     *  RELATED_VIEW: /{fromClass}/{parentId}/{dataClass}  */
+    buildDataPath() {
+        var _a, _b, _c, _d;
+        const v = this.allViews[this.activeViewIdx];
+        if (!v)
+            return '';
+        if (((_a = this.item) === null || _a === void 0 ? void 0 : _a.type) === 'RELATED_VIEW') {
+            return `/${(_b = v.fromClass) !== null && _b !== void 0 ? _b : ''}/${this.parentId}/${(_c = v.dataClass) !== null && _c !== void 0 ? _c : ''}`;
+        }
+        return `/${(_d = v.dataClass) !== null && _d !== void 0 ? _d : ''}`;
+    }
+    /** Build query params for a page request from current sort, view filters, filterClass and active column filters. */
+    buildQueryParams(page) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        const v = this.allViews[this.activeViewIdx];
+        const p = new URLSearchParams();
+        if (page > 0)
+            p.set('page', String(page));
+        const sort = this.sortParam();
+        if (sort)
+            p.set('sort', sort);
+        const filterClass = v === null || v === void 0 ? void 0 : v.filterClass;
+        if (filterClass)
+            p.set('type', filterClass);
+        for (const f of ((_b = (_a = v === null || v === void 0 ? void 0 : v.view) === null || _a === void 0 ? void 0 : _a.filter) !== null && _b !== void 0 ? _b : [])) {
+            if (!f.name)
+                continue;
+            if (f.operator === 'EMPTY') {
+                p.set(f.name, '');
+                continue;
+            }
+            if (f.operator === 'NOT_EMPTY') {
+                p.set(f.name + '_notempty', 'true');
+                continue;
+            }
+            if (f.operator === 'STARTS_WITH') {
+                p.set(f.name + '_startswith', String((_c = f.value) !== null && _c !== void 0 ? _c : ''));
+                continue;
+            }
+            if (f.operator === 'FROM') {
+                p.set(f.name + '_from', String((_d = f.value) !== null && _d !== void 0 ? _d : ''));
+                continue;
+            }
+            if (f.operator === 'TO') {
+                p.set(f.name + '_to', String((_e = f.value) !== null && _e !== void 0 ? _e : ''));
+                continue;
+            }
+            if (f.value != null) {
+                p.set(f.name, String(f.value));
+            }
+        }
+        for (const f of this.activeFilters.values()) {
+            if (f.operator === 'isEmpty') {
+                p.set(f.field, '');
+                continue;
+            }
+            if (f.operator === 'isNotEmpty') {
+                p.set(f.field + '_notempty', 'true');
+                continue;
+            }
+            if (f.operator === 'startsWith') {
+                p.set(f.field + '_startswith', String((_f = f.value) !== null && _f !== void 0 ? _f : ''));
+                continue;
+            }
+            if ((_g = f.values) === null || _g === void 0 ? void 0 : _g.length) {
+                p.set(f.field, f.values.join(','));
+                continue;
+            }
+            if (f.value != null)
+                p.set(f.field, String(f.value));
+            if (f.from != null)
+                p.set(f.field + '_from', String(f.from));
+            if (f.to != null)
+                p.set(f.field + '_to', String(f.to));
+        }
+        return p.toString();
+    }
+    get columns() {
+        var _a, _b, _c;
+        return ((_c = (_b = (_a = this.allViews[this.activeViewIdx]) === null || _a === void 0 ? void 0 : _a.view) === null || _b === void 0 ? void 0 : _b.values) !== null && _c !== void 0 ? _c : []);
+    }
+    get tableActions() {
+        var _a, _b;
+        const raw = (_b = (_a = this.item) === null || _a === void 0 ? void 0 : _a.actions) !== null && _b !== void 0 ? _b : [];
+        return (raw !== null && raw !== void 0 ? raw : []).reduce((acc, a) => {
+            if (a === 'NEW')
+                acc.push({ action: 'create', label: t('table_new_record', this.locale), icon: 'assets/sprites.svg#icon-plus', variant: 'primary' });
+            if (a === 'EXPORT')
+                acc.push({ action: 'export', label: t('table_export_excel', this.locale), icon: 'assets/sprites.svg#icon-file-excel' });
+            return acc;
+        }, []);
+    }
     colName(col) {
         var _a;
         return (_a = col.name) !== null && _a !== void 0 ? _a : '';
@@ -194,6 +366,25 @@ export class MrdTable {
             return 'RELATION';
         return (_a = col.dataType) !== null && _a !== void 0 ? _a : 'TEXT';
     }
+    /** True when we have a reliable total: either from the aggregations response or because
+     *  a short page told us it was the last page (exact count from row length). */
+    isTotalKnown() {
+        if (this.aggregationsTotal != null)
+            return true;
+        for (const rows of this.loadedPages.values()) {
+            if (rows.length < this.pageSize)
+                return true;
+        }
+        return false;
+    }
+    /** Effective total: aggregations-response > totalElements prop > minKnownTotal from setPage(). */
+    get baseTotal() {
+        if (this.aggregationsTotal != null)
+            return this.aggregationsTotal;
+        if (this.totalElements > 0)
+            return this.totalElements;
+        return this.minKnownTotal;
+    }
     // ── Aggregation helpers ────────────────────────────────────────────────────
     buildAggregationParams() {
         var _a;
@@ -214,17 +405,32 @@ export class MrdTable {
             params.count = groups.count;
         return Object.keys(params).length > 0 ? params : null;
     }
+    buildAggregationQs() {
+        var _a, _b, _c;
+        const p = new URLSearchParams(this.buildQueryParams(0));
+        p.delete('page');
+        p.delete('sort');
+        const groups = this.buildAggregationParams();
+        if ((_a = groups === null || groups === void 0 ? void 0 : groups.sum) === null || _a === void 0 ? void 0 : _a.length)
+            p.set('sum', groups.sum.join(','));
+        if ((_b = groups === null || groups === void 0 ? void 0 : groups.avg) === null || _b === void 0 ? void 0 : _b.length)
+            p.set('avg', groups.avg.join(','));
+        if ((_c = groups === null || groups === void 0 ? void 0 : groups.count) === null || _c === void 0 ? void 0 : _c.length)
+            p.set('count', groups.count.join(','));
+        return p.toString();
+    }
     emitLoadAggregations() {
-        const params = this.buildAggregationParams();
-        if (params)
-            this.mrdLoadAggregations.emit(params);
+        this.mrdLoadAggregations.emit({ path: this.buildDataPath(), qs: this.buildQueryParams(0), aggQs: this.buildAggregationQs() });
     }
     renderAggregationValue(col) {
-        var _a, _b;
+        var _a;
         if (col.type !== 'FIELD' || !col.aggregate || !this.aggregations)
             return '';
         const fn = col.aggregate.toLowerCase();
-        const val = (_a = this.aggregations[fn]) === null || _a === void 0 ? void 0 : _a[(_b = col.name) !== null && _b !== void 0 ? _b : ''];
+        const aggData = this.aggregations[fn];
+        const val = typeof aggData === 'object' && aggData !== null
+            ? aggData[(_a = col.name) !== null && _a !== void 0 ? _a : '']
+            : undefined;
         if (val == null)
             return '';
         const dt = col.dataType;
@@ -249,9 +455,10 @@ export class MrdTable {
         this.colWidths = [];
         this.scrollTop = 0;
         this.renderStart = 0;
-        // No BUFFER here — totalElements may be stale after a filter change.
-        // Only request what is visible; BUFFER kicks in during scroll as usual.
-        this.renderEnd = Math.max(0, Math.min(this.visibleCount() - 1, this.totalElements - 1));
+        this.minKnownTotal = 0;
+        // Mirror init(): use visibleCount so the first page is always requested.
+        // setPage() will clamp renderEnd down when the last page is shorter.
+        this.renderEnd = this.visibleCount() - 1;
         const scroller = this.el.querySelector('.mrd-table__scroll');
         if (scroller)
             scroller.scrollTop = 0;
@@ -282,7 +489,7 @@ export class MrdTable {
         for (let p = firstPage; p <= lastPage; p++) {
             if (!this.loadedPages.has(p) && !next.has(p)) {
                 next.add(p);
-                this.mrdLoadPage.emit({ page: p, sort: this.sortParam() });
+                this.mrdLoadPage.emit({ page: p, sort: this.sortParam(), path: this.buildDataPath(), qs: this.buildQueryParams(p) });
                 changed = true;
             }
         }
@@ -324,7 +531,7 @@ export class MrdTable {
             if (pageEnd < this.renderStart || pageStart > this.renderEnd)
                 continue;
             next.add(page);
-            this.mrdLoadPage.emit({ page, sort: this.sortParam() });
+            this.mrdLoadPage.emit({ page, sort: this.sortParam(), path: this.buildDataPath(), qs: this.buildQueryParams(page) });
             changed = true;
         }
         this.pendingPages.clear();
@@ -516,9 +723,9 @@ export class MrdTable {
         }
         this.activeFilters = next;
         this.closeFilterPopup();
-        this.mrdFilter.emit({ filters: Array.from(this.activeFilters.values()) });
         this.aggregations = null;
-        this.emitLoadAggregations();
+        this.aggregationsTotal = null;
+        this.aggregationsPending = true;
         if (this.totalElements > 0) {
             this.resetPages();
             this.emitPagesForWindow(this.renderStart, this.renderEnd);
@@ -531,9 +738,9 @@ export class MrdTable {
             next.delete(name);
         this.activeFilters = next;
         this.closeFilterPopup();
-        this.mrdFilter.emit({ filters: Array.from(this.activeFilters.values()) });
         this.aggregations = null;
-        this.emitLoadAggregations();
+        this.aggregationsTotal = null;
+        this.aggregationsPending = true;
         if (this.totalElements > 0) {
             this.resetPages();
             this.emitPagesForWindow(this.renderStart, this.renderEnd);
@@ -541,37 +748,39 @@ export class MrdTable {
     }
     clearAllFilters() {
         this.activeFilters = new Map();
-        this.mrdFilter.emit({ filters: [] });
         this.aggregations = null;
-        this.emitLoadAggregations();
+        this.aggregationsTotal = null;
+        this.aggregationsPending = true;
         if (this.totalElements > 0) {
             this.resetPages();
             this.emitPagesForWindow(this.renderStart, this.renderEnd);
         }
     }
     // ── View switcher ──────────────────────────────────────────────────────────
-    handleViewSwitch(view) {
-        this.mrdSwitchView.emit({ name: view.name, class: view.class });
+    handleViewSwitch(targetIdx) {
+        var _a, _b;
+        const target = this.allViews[targetIdx];
+        if (!(target === null || target === void 0 ? void 0 : target.view))
+            return;
+        this.activeViewIdx = targetIdx;
+        this.applyDefaultSort((_b = (_a = target.view) === null || _a === void 0 ? void 0 : _a.defaultSort) !== null && _b !== void 0 ? _b : '');
+        this.activeFilters = new Map();
+        this.init();
     }
     // ── Render: toolbar ────────────────────────────────────────────────────────
     renderToolbar() {
-        var _a, _b;
         const filterCount = this.activeFilters.size;
-        const hasActions = ((_a = this.actions) === null || _a === void 0 ? void 0 : _a.length) > 0;
-        const hasViewSwitcher = !!this.viewLabel && ((_b = this.alternativeViews) === null || _b === void 0 ? void 0 : _b.length) > 0;
+        const actions = this.tableActions;
+        const allViews = this.allViews;
+        const hasActions = actions.length > 0;
+        const hasViewSwitcher = allViews.length > 1;
         return (h("div", { class: "mrd-table__toolbar" }, h("div", { class: "mrd-table__toolbar-left" }, h("button", { class: `mrd-table__action mrd-table__action--secondary mrd-table__filter-toggle${this.filterMode ? ' mrd-table__filter-toggle--active' : ''}`, onClick: () => this.handleFilterToggle() }, h("svg", { class: "mrd-table__action-icon", viewBox: "0 0 24 24", "aria-hidden": "true" }, h("path", { fill: "currentColor", d: "M10 18h4v-2h-4v2zM3 6v2h18V6H3zm3 7h12v-2H6v2z" })), filterCount > 0 && h("span", { class: "mrd-table__filter-badge" }, filterCount), h("span", { class: "mrd-table__action-tooltip" }, this.filterMode ? t('table_filter_hide', this.locale) : t('table_filter', this.locale), filterCount > 0 ? ` (${filterCount} ${t('table_filter_active', this.locale)})` : '')), filterCount > 0 && (h("button", { class: "mrd-table__action mrd-table__action--secondary", onClick: () => this.clearAllFilters() }, h("svg", { class: "mrd-table__action-icon", viewBox: "0 0 24 24", "aria-hidden": "true" }, h("path", { fill: "currentColor", d: "M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z" })), h("span", { class: "mrd-table__action-tooltip" }, t('table_filter_clear_all', this.locale))))), hasViewSwitcher && (h("div", { class: "mrd-table__toolbar-center" }, h("select", { class: "mrd-table__view-select", onChange: (e) => {
-                const sel = e.target;
-                const view = this.alternativeViews.find(v => v.name === sel.value);
-                if (view) {
-                    sel.selectedIndex = 0;
-                    this.handleViewSwitch(view);
-                }
-            } }, h("option", { value: "" }, this.viewLabel), this.alternativeViews.map(v => {
-            var _a;
-            return (h("option", { value: v.name }, (_a = v.label) !== null && _a !== void 0 ? _a : v.name));
-        })))), hasActions && (h("div", { class: "mrd-table__toolbar-right" }, this.actions.map(a => {
+                const idx = parseInt(e.target.value, 10);
+                if (!isNaN(idx) && idx !== this.activeViewIdx)
+                    this.handleViewSwitch(idx);
+            } }, allViews.map((v, i) => (h("option", { value: String(i), selected: i === this.activeViewIdx }, v.label)))))), hasActions && (h("div", { class: "mrd-table__toolbar-right" }, actions.map(a => {
             var _a;
-            return (h("button", { class: `mrd-table__action mrd-table__action--${(_a = a.variant) !== null && _a !== void 0 ? _a : 'secondary'}`, disabled: a.disabled, onClick: () => this.mrdAction.emit({ action: a.action }) }, a.icon
+            return (h("button", { class: `mrd-table__action mrd-table__action--${(_a = a.variant) !== null && _a !== void 0 ? _a : 'secondary'}`, disabled: a.disabled, onClick: () => this.mrdAction.emit(this.buildActionDetail(a.action)) }, a.icon
                 ? h("svg", { class: "mrd-table__action-icon", "aria-hidden": "true" }, h("use", { href: a.icon }))
                 : a.label, h("span", { class: "mrd-table__action-tooltip" }, a.label)));
         })))));
@@ -665,10 +874,9 @@ export class MrdTable {
         return (h("div", { class: "mrd-table__filter-popup", style: { top: `${this.popupPos.top}px`, left: `${this.popupPos.left}px` }, onClick: (e) => e.stopPropagation() }, h("div", { class: "mrd-table__filter-popup-header" }, h("span", { class: "mrd-table__filter-popup-title" }, label), h("button", { class: "mrd-table__filter-close", onClick: () => this.closeFilterPopup() }, "\u2715")), h("div", { class: "mrd-table__filter-section" }, h("div", { class: "mrd-table__filter-section-label" }, t('filter_sorting', this.locale)), h("div", { class: "mrd-table__filter-sort-buttons" }, h("button", { class: `mrd-table__filter-sort-btn${sortActive && this.sortDir === 'asc' ? ' mrd-table__filter-sort-btn--active' : ''}`, onClick: () => this.applySort(col, 'asc') }, "\u25B2 ", t('filter_ascending', this.locale)), h("button", { class: `mrd-table__filter-sort-btn${sortActive && this.sortDir === 'desc' ? ' mrd-table__filter-sort-btn--active' : ''}`, onClick: () => this.applySort(col, 'desc') }, "\u25BC ", t('filter_descending', this.locale)))), h("div", { class: "mrd-table__filter-divider" }), h("div", { class: "mrd-table__filter-section" }, h("div", { class: "mrd-table__filter-section-label" }, t('filter_section', this.locale)), this.renderFilterEditor(col)), h("div", { class: "mrd-table__filter-popup-footer" }, h("button", { class: "mrd-table__filter-btn mrd-table__filter-btn--clear", onClick: () => this.clearFilter() }, t('filter_clear', this.locale)), h("button", { class: "mrd-table__filter-btn mrd-table__filter-btn--apply", onClick: () => this.applyFilter() }, t('filter_apply', this.locale)))));
     }
     // ── Render: footer ────────────────────────────────────────────────────────
-    renderFooter(rowCount, effectiveTotal) {
-        const total = this.totalElements;
-        // Non-paginated mode: show plain row count
-        if (total === 0) {
+    renderFooter(rowCount, effectiveTotal, isTotalKnown = true) {
+        // Non-paginated mode: totalElements=0 and no paginated data loaded yet
+        if (this.totalElements === 0 && this.loadedPages.size === 0) {
             const count = rowCount !== null && rowCount !== void 0 ? rowCount : 0;
             if (count === 0)
                 return null;
@@ -677,13 +885,14 @@ export class MrdTable {
         // Paginated mode: only show once page 0 has loaded (avoids stale total during filter reset)
         if (!this.loadedPages.has(0))
             return null;
-        // Use effectiveTotal (derived from actual page lengths) so the counter
-        // is correct even when the host has not yet updated totalElements.
-        const displayTotal = effectiveTotal !== null && effectiveTotal !== void 0 ? effectiveTotal : total;
+        // effectiveTotal from render(); fall back to baseTotal when not provided.
+        const displayTotal = effectiveTotal !== null && effectiveTotal !== void 0 ? effectiveTotal : this.baseTotal;
         // Compute from/to independently so partial rows at top/bottom are included.
         const from = Math.min(Math.floor(this.scrollTop / this.rowHeight) + 1, displayTotal);
         const to = Math.min(Math.ceil((this.scrollTop + this.tableHeight) / this.rowHeight), displayTotal);
-        return (h("div", { class: "mrd-table__footer" }, from, "\u2013", to, " ", t('table_of', this.locale), " ", displayTotal));
+        // Show '…' for the total until we have a reliable count (aggregations or last page loaded).
+        const totalLabel = isTotalKnown ? String(displayTotal) : '…';
+        return (h("div", { class: "mrd-table__footer" }, from, "\u2013", to, " ", t('table_of', this.locale), " ", totalLabel));
     }
     // ── Render: cell ──────────────────────────────────────────────────────────
     renderCell(col, row) {
@@ -742,7 +951,9 @@ export class MrdTable {
         if (!((_a = this.columns) === null || _a === void 0 ? void 0 : _a.length))
             return null;
         // ── Non-paginated mode ──────────────────────────────────────────────────
-        if (this.totalElements === 0) {
+        // Only enter non-paginated mode when totalElements is 0 AND no paginated data
+        // has been loaded yet — prevents the wrong branch when the host omits totalElements.
+        if (this.totalElements === 0 && this.loadedPages.size === 0) {
             return (h(Host, null, this.renderToolbar(), h("div", { class: "mrd-table" }, h("table", { class: "mrd-table__table" }, h("thead", null, h("tr", null, this.columns.map(col => {
                 var _a;
                 const name = this.colName(col);
@@ -759,8 +970,8 @@ export class MrdTable {
         // Derive the authoritative row count from loaded pages:
         // if any loaded page is shorter than pageSize it is the last page,
         // so the true total cannot exceed (pageNum * pageSize + pageRows.length).
-        // This self-corrects without requiring the host to update totalElements.
-        let effectiveTotal = this.totalElements;
+        // aggregationsTotal (from setAggregations) takes priority over the totalElements prop.
+        let effectiveTotal = this.baseTotal;
         for (const [pageNum, pageRows] of this.loadedPages) {
             if (pageRows.length < this.pageSize) {
                 effectiveTotal = Math.min(effectiveTotal, pageNum * this.pageSize + pageRows.length);
@@ -797,7 +1008,7 @@ export class MrdTable {
                 isFiltered ? 'mrd-table__header--filtered' : '',
             ].filter(Boolean).join(' ');
             return (h("th", { class: cls, style: this.colWidths[idx] ? { width: `${this.colWidths[idx]}px` } : undefined, onClick: isInteractive ? ((e) => this.filterMode ? this.handleFilterOpen(col, e) : this.handleSortClick(col)) : undefined }, h("span", { class: "mrd-table__header-label" }, (_a = col.label) !== null && _a !== void 0 ? _a : ''), isInteractive && isActive && (h("span", { class: "mrd-table__sort-icon", "aria-hidden": "true" }, this.sortDir === 'asc' ? '▲' : '▼')), isInteractive && !isActive && !this.filterMode && (h("span", { class: "mrd-table__sort-icon", "aria-hidden": "true" }, "\u21C5")), isInteractive && isFiltered && this.renderFilterIcon()));
-        }))), h("tbody", null, topSpacerHeight > 0 && (h("tr", { class: "mrd-table__spacer", style: { height: `${topSpacerHeight}px` } }, h("td", { colSpan: colCount }))), renderedRows, bottomSpacerHeight > 0 && (h("tr", { class: "mrd-table__spacer", style: { height: `${bottomSpacerHeight}px` } }, h("td", { colSpan: colCount })))), this.renderTotalsRow())), effectiveTotal === 0 && this.loadedPages.has(0) && (h("p", { class: "mrd-table__empty" }, t('no_results', this.locale))), effectiveTotal > 0 && this.renderFooter(undefined, effectiveTotal), this.renderFilterPopup(), this.renderTextblockModal()));
+        }))), h("tbody", null, topSpacerHeight > 0 && (h("tr", { class: "mrd-table__spacer", style: { height: `${topSpacerHeight}px` } }, h("td", { colSpan: colCount }))), renderedRows, bottomSpacerHeight > 0 && (h("tr", { class: "mrd-table__spacer", style: { height: `${bottomSpacerHeight}px` } }, h("td", { colSpan: colCount })))), this.renderTotalsRow())), effectiveTotal === 0 && this.loadedPages.has(0) && (h("p", { class: "mrd-table__empty" }, t('no_results', this.locale))), effectiveTotal > 0 && this.renderFooter(undefined, effectiveTotal, this.isTotalKnown()), this.renderFilterPopup(), this.renderTextblockModal()));
     }
     renderFilterIcon() {
         return (h("span", { class: "mrd-table__filter-icon", "aria-hidden": "true" }, h("svg", { viewBox: "0 0 24 24", width: "14", height: "14", fill: "currentColor" }, h("path", { d: "M10 18h4v-2h-4v2zM3 6v2h18V6H3zm3 7h12v-2H6v2z" }))));
@@ -826,18 +1037,18 @@ export class MrdTable {
     }
     static get properties() {
         return {
-            "columns": {
+            "item": {
                 "type": "unknown",
                 "mutable": false,
                 "complexType": {
-                    "original": "TableColumn[]",
-                    "resolved": "ClientLayoutItem[]",
+                    "original": "ClientLayoutItem | null",
+                    "resolved": "ClientLayoutItem | null",
                     "references": {
-                        "TableColumn": {
+                        "ClientLayoutItem": {
                             "location": "import",
-                            "path": "../../utils/cell-renderer",
-                            "id": "src/utils/cell-renderer.ts::TableColumn",
-                            "referenceLocation": "TableColumn"
+                            "path": "../../types/client-layout",
+                            "id": "src/types/client-layout.ts::ClientLayoutItem",
+                            "referenceLocation": "ClientLayoutItem"
                         }
                     }
                 },
@@ -845,11 +1056,31 @@ export class MrdTable {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "The VIEW or RELATED_VIEW layout item. Contains view config, dataClass, fromClass, actions etc."
                 },
                 "getter": false,
                 "setter": false,
-                "defaultValue": "[]"
+                "defaultValue": "null"
+            },
+            "parentId": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Parent record id \u2014 required for RELATED_VIEW to build /{fromClass}/{parentId}/{dataClass}."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "parent-id",
+                "defaultValue": "''"
             },
             "rows": {
                 "type": "unknown",
@@ -973,101 +1204,12 @@ export class MrdTable {
                 "reflect": false,
                 "attribute": "table-height",
                 "defaultValue": "500"
-            },
-            "defaultSort": {
-                "type": "string",
-                "mutable": false,
-                "complexType": {
-                    "original": "string",
-                    "resolved": "string",
-                    "references": {}
-                },
-                "required": false,
-                "optional": false,
-                "docs": {
-                    "tags": [],
-                    "text": "Initial sort applied on load, e.g. \"timestamp,desc\" or \"name\".\nParsed by init() into sortField + sortDir."
-                },
-                "getter": false,
-                "setter": false,
-                "reflect": false,
-                "attribute": "default-sort",
-                "defaultValue": "''"
-            },
-            "actions": {
-                "type": "unknown",
-                "mutable": false,
-                "complexType": {
-                    "original": "TableAction[]",
-                    "resolved": "TableAction[]",
-                    "references": {
-                        "TableAction": {
-                            "location": "import",
-                            "path": "../../utils/cell-renderer",
-                            "id": "src/utils/cell-renderer.ts::TableAction",
-                            "referenceLocation": "TableAction"
-                        }
-                    }
-                },
-                "required": false,
-                "optional": false,
-                "docs": {
-                    "tags": [],
-                    "text": "Toolbar action buttons rendered above the table."
-                },
-                "getter": false,
-                "setter": false,
-                "defaultValue": "[]"
-            },
-            "viewLabel": {
-                "type": "string",
-                "mutable": false,
-                "complexType": {
-                    "original": "string",
-                    "resolved": "string",
-                    "references": {}
-                },
-                "required": false,
-                "optional": false,
-                "docs": {
-                    "tags": [],
-                    "text": "Display label of the current view \u2014 shown in the toolbar center as a view picker trigger."
-                },
-                "getter": false,
-                "setter": false,
-                "reflect": false,
-                "attribute": "view-label",
-                "defaultValue": "''"
-            },
-            "alternativeViews": {
-                "type": "unknown",
-                "mutable": false,
-                "complexType": {
-                    "original": "AlternativeView[]",
-                    "resolved": "AlternativeView[]",
-                    "references": {
-                        "AlternativeView": {
-                            "location": "import",
-                            "path": "../../utils/cell-renderer",
-                            "id": "src/utils/cell-renderer.ts::AlternativeView",
-                            "referenceLocation": "AlternativeView"
-                        }
-                    }
-                },
-                "required": false,
-                "optional": false,
-                "docs": {
-                    "tags": [],
-                    "text": "Alternative views available for this table; renders a dropdown when non-empty."
-                },
-                "getter": false,
-                "setter": false,
-                "defaultValue": "[]"
             }
         };
     }
     static get states() {
         return {
+            "activeViewIdx": {},
             "loadedPages": {},
             "requestedPages": {},
             "renderStart": {},
@@ -1083,7 +1225,9 @@ export class MrdTable {
             "scrollTop": {},
             "textblockModal": {},
             "jsonModal": {},
-            "aggregations": {}
+            "aggregations": {},
+            "aggregationsTotal": {},
+            "minKnownTotal": {}
         };
     }
     static get events() {
@@ -1098,8 +1242,8 @@ export class MrdTable {
                     "text": "Fired when a page needs to be fetched. Host fetches and calls setPage().\n`sort` is the raw query-param value, e.g. \"name\" or \"name,desc\"."
                 },
                 "complexType": {
-                    "original": "{ page: number; sort: string }",
-                    "resolved": "{ page: number; sort: string; }",
+                    "original": "{ page: number; sort: string; path: string; qs: string }",
+                    "resolved": "{ page: number; sort: string; path: string; qs: string; }",
                     "references": {}
                 }
             }, {
@@ -1130,35 +1274,13 @@ export class MrdTable {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": "Fired when a toolbar action button is clicked. Detail contains the action identifier."
+                    "text": "Fired when a toolbar action button is clicked.\nFor 'export': includes `path` (relative excel path) and `qs` (current sort+filter params).\nFor 'create': includes `dataClass` (target type) and `parentPath` (e.g. /buyers/123 for RELATED_VIEW)."
                 },
                 "complexType": {
-                    "original": "{ action: string }",
-                    "resolved": "{ action: string; }",
+                    "original": "{ action: string; path?: string; qs?: string; dataClass?: string; parentPath?: string | null }",
+                    "resolved": "{ action: string; path?: string | undefined; qs?: string | undefined; dataClass?: string | undefined; parentPath?: string | null | undefined; }",
                     "references": {}
                 }
-            }, {
-                "method": "mrdFilter",
-                "name": "mrdFilter",
-                "bubbles": true,
-                "cancelable": true,
-                "composed": true,
-                "docs": {
-                    "tags": [],
-                    "text": "Fired when active filters change. Host translates filters to API query params."
-                },
-                "complexType": {
-                    "original": "{ filters: ColumnFilter[] }",
-                    "resolved": "{ filters: ColumnFilter[]; }",
-                    "references": {
-                        "ColumnFilter": {
-                            "location": "import",
-                            "path": "../../utils/cell-renderer",
-                            "id": "src/utils/cell-renderer.ts::ColumnFilter",
-                            "referenceLocation": "ColumnFilter"
-                        }
-                    }
-                }
             }, {
                 "method": "mrdDownload",
                 "name": "mrdDownload",
@@ -1174,21 +1296,6 @@ export class MrdTable {
                     "resolved": "{ href: string; fileName: string; }",
                     "references": {}
                 }
-            }, {
-                "method": "mrdSwitchView",
-                "name": "mrdSwitchView",
-                "bubbles": true,
-                "cancelable": true,
-                "composed": true,
-                "docs": {
-                    "tags": [],
-                    "text": "Fired when the user selects an alternative view from the view switcher dropdown."
-                },
-                "complexType": {
-                    "original": "{ name: string; class?: string }",
-                    "resolved": "{ name: string; class?: string | undefined; }",
-                    "references": {}
-                }
             }, {
                 "method": "mrdLoadAggregations",
                 "name": "mrdLoadAggregations",
@@ -1197,11 +1304,11 @@ export class MrdTable {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": "Fired when aggregation totals need to be (re-)fetched.\nDetail contains the fields grouped by aggregate function.\nHost calls the /aggregations endpoint and passes the result to setAggregations()."
+                    "text": "Fired when aggregation totals need to be (re-)fetched.\n`aggQs` is a ready-to-use query string: active filters (no page/sort) + sum/avg/count params.\nHost calls the /aggregations endpoint and passes the result to setAggregations()."
                 },
                 "complexType": {
-                    "original": "{ sum?: string[]; avg?: string[]; count?: string[] }",
-                    "resolved": "{ sum?: string[] | undefined; avg?: string[] | undefined; count?: string[] | undefined; }",
+                    "original": "{ path: string; qs: string; aggQs: string }",
+                    "resolved": "{ path: string; qs: string; aggQs: string; }",
                     "references": {}
                 }
             }];
@@ -1231,7 +1338,7 @@ export class MrdTable {
             },
             "setPage": {
                 "complexType": {
-                    "signature": "(pageNumber: number, rows: Record<string, any>[]) => Promise<void>",
+                    "signature": "(pageNumber: number, rows: Record<string, any>[], hasNext?: boolean) => Promise<void>",
                     "parameters": [{
                             "name": "pageNumber",
                             "type": "number",
@@ -1240,6 +1347,10 @@ export class MrdTable {
                             "name": "rows",
                             "type": "Record<string, any>[]",
                             "docs": ""
+                        }, {
+                            "name": "hasNext",
+                            "type": "boolean | undefined",
+                            "docs": ""
                         }],
                     "references": {
                         "Promise": {
@@ -1254,7 +1365,7 @@ export class MrdTable {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "Inject the rows for a given page (0-based).\nCreates a new Map reference so Stencil detects the state change.\n\nWhen the page contains fewer rows than pageSize it is the last page.\nrenderEnd is clamped immediately so no loading-placeholder rows appear\nbeyond the actual data \u2014 without requiring the host to update totalElements.",
+                    "text": "Inject the rows for a given page (0-based).\nCreates a new Map reference so Stencil detects the state change.\n\nWhen the page contains fewer rows than pageSize it is the last page.\nrenderEnd is clamped immediately so no loading-placeholder rows appear\nbeyond the actual data \u2014 without requiring the host to update totalElements.\n\nPass hasNext (from _links.next in the API response) for accurate last-page\ndetection even when rows.length === pageSize (exact multiple of page size).",
                     "tags": []
                 }
             },
@@ -1293,8 +1404,8 @@ export class MrdTable {
                 "propName": "totalElements",
                 "methodName": "totalElementsChanged"
             }, {
-                "propName": "defaultSort",
-                "methodName": "defaultSortChanged"
+                "propName": "item",
+                "methodName": "itemChanged"
             }];
     }
 }