@aurum-grid/enterprise 0.0.0-stage → 0.2.0

package/dist/range.js

@@ -0,0 +1,214 @@
+/**
+ * Excel-like cell range selection: drag with the mouse, Shift+click to extend,
+ * Shift+arrow keys to extend from the focused cell, Ctrl+C copies the range.
+ * Status bar shows Sum / Average / Count / Min / Max for numeric cells.
+ */
+export const RangeSelectionModule = {
+    name: 'RangeSelectionModule',
+    install(grid) {
+        let anchor = null;
+        let end = null;
+        let dragging = false;
+        const colIndex = (colId) => grid.getAllDisplayedColumns().findIndex((c) => c.colId === colId);
+        const bounds = () => {
+            if (!anchor || !end)
+                return null;
+            return {
+                r0: Math.min(anchor.row, end.row), r1: Math.max(anchor.row, end.row),
+                c0: Math.min(anchor.col, end.col), c1: Math.max(anchor.col, end.col),
+            };
+        };
+        const isMulti = () => {
+            const b = bounds();
+            return !!b && (b.r0 !== b.r1 || b.c0 !== b.c1);
+        };
+        const changed = () => {
+            grid.renderRows(true);
+            grid.renderStatusBar();
+            grid.dispatch('rangeSelectionChanged', { ranges: api.getCellRanges() });
+        };
+        const api = {
+            getCellRanges() {
+                const b = bounds();
+                if (!b || !isMulti())
+                    return [];
+                const cols = grid.getAllDisplayedColumns().slice(b.c0, b.c1 + 1).map((c) => c.colId);
+                return [{ startRow: b.r0, endRow: b.r1, columns: cols }];
+            },
+            clearRangeSelection() {
+                if (!anchor)
+                    return;
+                anchor = end = null;
+                changed();
+            },
+            addCellRange(p) {
+                anchor = { row: p.rowStartIndex, col: colIndex(p.columnStart) };
+                end = { row: p.rowEndIndex, col: colIndex(p.columnEnd) };
+                changed();
+            },
+            getRangeData() {
+                const b = bounds();
+                if (!b || !isMulti())
+                    return null;
+                const cols = grid.getAllDisplayedColumns().slice(b.c0, b.c1 + 1);
+                const rows = [];
+                const formatted = [];
+                for (let r = b.r0; r <= b.r1; r++) {
+                    const node = grid.getDisplayedRowAtIndex(r);
+                    if (!node)
+                        continue;
+                    rows.push(cols.map((c) => grid.getCellValue(node, c.colId)));
+                    formatted.push(cols.map((c) => grid.getCellFormatted(node, c.colId)));
+                }
+                return { headers: cols.map((c) => c.headerName), rows, formatted };
+            },
+            getRangeAggregates() {
+                const data = api.getRangeData();
+                if (!data)
+                    return null;
+                const nums = [];
+                let count = 0;
+                for (const row of data.rows)
+                    for (const v of row) {
+                        if (v == null || v === '')
+                            continue;
+                        count++;
+                        if (typeof v === 'number' && Number.isFinite(v))
+                            nums.push(v);
+                    }
+                const sum = nums.reduce((a, b) => a + b, 0);
+                return {
+                    count, numericCount: nums.length, sum,
+                    avg: nums.length ? sum / nums.length : null,
+                    min: nums.length ? Math.min(...nums) : null,
+                    max: nums.length ? Math.max(...nums) : null,
+                };
+            },
+        };
+        Object.assign(grid, api);
+        const onDown = (e, pos) => {
+            const c = colIndex(pos.colId);
+            if (e.target.closest('input, button, .agr-row-drag-handle'))
+                return false;
+            if (e.shiftKey) {
+                const f = grid.getFocusedCell();
+                anchor = anchor ?? (f ? { row: f.rowIndex, col: colIndex(f.colId) } : { row: pos.rowIndex, col: c });
+                end = { row: pos.rowIndex, col: c };
+                changed();
+                return false;
+            }
+            anchor = { row: pos.rowIndex, col: c };
+            end = { row: pos.rowIndex, col: c };
+            dragging = true;
+            const up = () => {
+                dragging = false;
+                document.removeEventListener('pointerup', up);
+            };
+            document.addEventListener('pointerup', up);
+            if (isMulti())
+                changed();
+            else
+                grid.renderStatusBar();
+            return false;
+        };
+        const onOver = (_e, pos) => {
+            if (!dragging || !anchor)
+                return;
+            const next = { row: pos.rowIndex, col: colIndex(pos.colId) };
+            if (end && end.row === next.row && end.col === next.col)
+                return;
+            end = next;
+            changed();
+        };
+        const onKey = (e) => {
+            const arrows = ['ArrowUp', 'ArrowDown', 'ArrowLeft', 'ArrowRight'];
+            if (e.key === 'Escape' && isMulti()) {
+                api.clearRangeSelection();
+                return true;
+            }
+            if (!e.shiftKey || e.altKey || !arrows.includes(e.key)) {
+                if (arrows.includes(e.key) && !e.altKey && anchor) {
+                    anchor = end = null;
+                    grid.renderRows(true);
+                    grid.renderStatusBar();
+                }
+                return false;
+            }
+            // keep row-selection behaviour for Shift+Up/Down when there's no column extent
+            const f = grid.getFocusedCell();
+            if (!f || f.rowIndex < 0)
+                return false;
+            if (!anchor)
+                anchor = { row: f.rowIndex, col: colIndex(f.colId) };
+            if (!end)
+                end = { ...anchor };
+            const maxR = grid.getDisplayedRowCount() - 1;
+            const maxC = grid.getAllDisplayedColumns().length - 1;
+            if (e.key === 'ArrowUp')
+                end.row = Math.max(0, end.row - 1);
+            if (e.key === 'ArrowDown')
+                end.row = Math.min(maxR, end.row + 1);
+            if (e.key === 'ArrowLeft')
+                end.col = Math.max(0, end.col - 1);
+            if (e.key === 'ArrowRight')
+                end.col = Math.min(maxC, end.col + 1);
+            e.preventDefault();
+            grid.ensureIndexVisible(end.row);
+            changed();
+            return true;
+        };
+        const cellClass = (_node, col, rowIndex) => {
+            const b = bounds();
+            if (!b || !isMulti())
+                return null;
+            const c = colIndex(col.colId);
+            if (rowIndex < b.r0 || rowIndex > b.r1 || c < b.c0 || c > b.c1)
+                return null;
+            const edges = ['agr-cell-range'];
+            if (rowIndex === b.r0)
+                edges.push('agr-range-top');
+            if (rowIndex === b.r1)
+                edges.push('agr-range-bottom');
+            if (c === b.c0)
+                edges.push('agr-range-left');
+            if (c === b.c1)
+                edges.push('agr-range-right');
+            return edges.join(' ');
+        };
+        const fmt = (n) => (n == null ? '—' : n.toLocaleString(undefined, { maximumFractionDigits: 2 }));
+        const status = () => {
+            const a = api.getRangeAggregates();
+            if (!a)
+                return [];
+            const items = [{ label: 'Count', value: a.count.toLocaleString() }];
+            if (a.numericCount) {
+                items.push({ label: 'Sum', value: fmt(a.sum) }, { label: 'Avg', value: fmt(a.avg) }, { label: 'Min', value: fmt(a.min) }, { label: 'Max', value: fmt(a.max) });
+            }
+            return items;
+        };
+        const copy = () => {
+            const d = api.getRangeData();
+            if (!d)
+                return null;
+            return d.formatted.map((r) => r.join('\t')).join('\n');
+        };
+        grid.hooks.cellMouseDown.add(onDown);
+        grid.hooks.cellMouseOver.add(onOver);
+        grid.hooks.keyDown.add(onKey);
+        grid.hooks.cellClass.add(cellClass);
+        grid.hooks.statusBarItems.add(status);
+        grid.hooks.copyText.add(copy);
+        grid.eRoot.classList.add('agr-range-enabled');
+        return () => {
+            grid.hooks.cellMouseDown.delete(onDown);
+            grid.hooks.cellMouseOver.delete(onOver);
+            grid.hooks.keyDown.delete(onKey);
+            grid.hooks.cellClass.delete(cellClass);
+            grid.hooks.statusBarItems.delete(status);
+            grid.hooks.copyText.delete(copy);
+            for (const k of Object.keys(api))
+                delete grid[k];
+        };
+    },
+};
+//# sourceMappingURL=range.js.map

package/dist/range.js.map

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

package/dist/sidebar.d.ts

@@ -0,0 +1,20 @@
+import { type GridModule } from '@aurum-grid/core';
+export type ToolPanelId = 'columns' | 'filters';
+export interface SideBarDef {
+    toolPanels?: ToolPanelId[];
+    defaultToolPanel?: ToolPanelId | null;
+    position?: 'right' | 'left';
+}
+declare module '@aurum-grid/core' {
+    interface GridOptions<T> {
+        sideBar?: boolean | SideBarDef;
+    }
+    interface Grid<T> {
+        openToolPanel(id: ToolPanelId): void;
+        closeToolPanel(): void;
+        getOpenedToolPanel(): ToolPanelId | null;
+        setSideBarVisible(visible: boolean): void;
+    }
+}
+/** Tool panels for columns (visibility, grouping, values, pivot) and filters. */
+export declare const SideBarModule: GridModule;

package/dist/sidebar.js

@@ -0,0 +1,154 @@
+import { h, icon, buildFilterPanel, filterKindFor } from '@aurum-grid/core';
+const LABELS = { columns: 'Columns', filters: 'Filters' };
+const AGGS = ['sum', 'avg', 'min', 'max', 'count'];
+/** Tool panels for columns (visibility, grouping, values, pivot) and filters. */
+export const SideBarModule = {
+    name: 'SideBarModule',
+    install(grid) {
+        const opt = grid.options.sideBar;
+        const def = opt === true ? {} : opt || {};
+        const panels = def.toolPanels ?? ['columns', 'filters'];
+        let open = def.defaultToolPanel ?? null;
+        let visible = !!opt;
+        const strip = h('div', { class: 'agr-side-tabs', role: 'tablist', 'aria-orientation': 'vertical', 'aria-label': 'Tool panels' });
+        const body = h('div', { class: 'agr-side-panel', role: 'tabpanel' });
+        const root = h('div', { class: `agr-side-bar ${def.position === 'left' ? 'agr-side-left' : ''}` }, [body, strip]);
+        let search = '';
+        const columnsPanel = () => {
+            const wrap = h('div', { class: 'agr-tool-columns' });
+            const pivotAvailable = typeof grid.setPivotMode === 'function';
+            if (pivotAvailable) {
+                const on = grid.isPivotMode();
+                const sw = h('input', { type: 'checkbox', role: 'switch', checked: on, 'aria-label': 'Pivot mode' });
+                sw.addEventListener('change', () => {
+                    if (sw.checked) {
+                        const text = grid.getColumns().filter((c) => filterKindFor(c) !== 'number' && c.visible);
+                        const groups = grid.getRowGroupColumns().map((c) => c.colId);
+                        const rows = groups.length ? groups : text.slice(0, 1).map((c) => c.colId);
+                        const pivotCol = text.find((c) => !rows.includes(c.colId));
+                        const values = grid.getColumns().filter((c) => filterKindFor(c) === 'number' && c.visible).slice(0, 2)
+                            .map((c) => ({ colId: c.colId, aggFunc: (typeof c.aggFunc === 'string' ? c.aggFunc : 'sum') }));
+                        grid.setPivotMode(true, { rows, columns: pivotCol ? [pivotCol.colId] : [], values });
+                    }
+                    else
+                        grid.setPivotMode(false);
+                    render();
+                });
+                wrap.append(h('label', { class: 'agr-switch-row' }, [sw, h('span', { text: 'Pivot mode' })]));
+                if (on) {
+                    const cfg = grid.getPivotConfig();
+                    wrap.append(h('p', { class: 'agr-muted agr-tool-note', text: `Rows: ${cfg.rows.join(', ') || '—'} · Columns: ${cfg.columns.join(', ') || '—'} · Values: ${cfg.values.map((v) => `${v.aggFunc}(${v.colId})`).join(', ')}` }));
+                    return wrap;
+                }
+            }
+            const q = h('input', { class: 'agr-input', type: 'search', placeholder: 'Search columns…', 'aria-label': 'Search columns' });
+            q.value = search;
+            q.addEventListener('input', () => {
+                search = q.value;
+                renderList();
+            });
+            const list = h('div', { class: 'agr-tool-list', role: 'list' });
+            const renderList = () => {
+                list.replaceChildren();
+                const cols = grid.getColumns().filter((c) => c.headerName.toLowerCase().includes(search.toLowerCase()));
+                for (const c of cols) {
+                    const cb = h('input', { type: 'checkbox', checked: c.visible, 'aria-label': `Show ${c.headerName}` });
+                    cb.addEventListener('change', () => grid.setColumnsVisible([c.colId], cb.checked));
+                    const grouped = c.rowGroupActive;
+                    const groupBtn = h('button', {
+                        type: 'button', class: `agr-icon-btn ${grouped ? 'agr-active' : ''}`, 'aria-pressed': String(grouped),
+                        'aria-label': `${grouped ? 'Ungroup' : 'Group'} by ${c.headerName}`, title: grouped ? 'Remove row group' : 'Group rows by this column',
+                        disabled: c.colDef.enableRowGroup === false || !!grid.options.treeData,
+                    }, [icon('group', 14)]);
+                    groupBtn.addEventListener('click', () => (grouped ? grid.removeRowGroupColumn(c.colId) : grid.addRowGroupColumn(c.colId)));
+                    const items = [cb, h('span', { class: 'agr-tool-name', text: c.headerName }), groupBtn];
+                    if (filterKindFor(c) === 'number') {
+                        const sel = h('select', { class: 'agr-input agr-tool-agg', 'aria-label': `Aggregation for ${c.headerName}` });
+                        sel.append(h('option', { value: '', text: 'No agg' }));
+                        for (const a of AGGS)
+                            sel.append(h('option', { value: a, text: a, selected: c.aggFunc === a }));
+                        sel.addEventListener('change', () => grid.applyColumnState({ state: [{ colId: c.colId, aggFunc: (sel.value || null) }] }));
+                        items.push(sel);
+                    }
+                    list.append(h('div', { class: 'agr-tool-item', role: 'listitem' }, items));
+                }
+                if (!cols.length)
+                    list.append(h('p', { class: 'agr-muted', text: 'No columns match' }));
+            };
+            renderList();
+            const groupCols = grid.getRowGroupColumns();
+            wrap.append(q, list, h('div', { class: 'agr-tool-section', text: 'Row groups' }), groupCols.length ? h('div', { class: 'agr-tool-chips' }, groupCols.map((c) => {
+                const x = h('button', { type: 'button', class: 'agr-chip-remove', 'aria-label': `Remove ${c.headerName} grouping` }, [icon('close', 11)]);
+                x.addEventListener('click', () => grid.removeRowGroupColumn(c.colId));
+                return h('span', { class: 'agr-chip' }, [h('span', { text: c.headerName }), x]);
+            })) : h('p', { class: 'agr-muted agr-tool-note', text: 'Use the group button next to a column.' }));
+            return wrap;
+        };
+        const filtersPanel = () => {
+            const wrap = h('div', { class: 'agr-tool-filters' });
+            for (const c of grid.getColumns().filter((c) => filterKindFor(c) && c.visible)) {
+                const active = !!grid.getFilterModel()[c.colId];
+                const det = h('details', { class: 'agr-tool-filter' });
+                const sum = h('summary', {}, [h('span', { text: c.headerName }), active ? h('span', { class: 'agr-filter-ind', 'aria-label': 'Filtered' }, [icon('filter', 12)]) : '']);
+                det.append(sum);
+                det.addEventListener('toggle', () => {
+                    if (det.open && det.childElementCount === 1)
+                        det.append(buildFilterPanel(grid, c));
+                });
+                wrap.append(det);
+            }
+            return wrap;
+        };
+        const render = () => {
+            root.hidden = !visible;
+            grid.eRoot.classList.toggle('agr-has-side-bar', visible);
+            strip.replaceChildren(...panels.map((id) => {
+                const b = h('button', {
+                    type: 'button', role: 'tab', class: 'agr-side-tab', 'aria-selected': String(open === id), 'aria-controls': `${grid.gridId}-panel`,
+                    title: LABELS[id],
+                }, [icon(id === 'columns' ? 'columns' : 'filter', 15), h('span', { class: 'agr-side-tab-label', text: LABELS[id] })]);
+                b.addEventListener('click', () => {
+                    open = open === id ? null : id;
+                    render();
+                });
+                return b;
+            }));
+            body.id = `${grid.gridId}-panel`;
+            body.hidden = !open;
+            if (open) {
+                body.replaceChildren(h('div', { class: 'agr-side-title', text: LABELS[open] }), open === 'columns' ? columnsPanel() : filtersPanel());
+            }
+        };
+        const api = {
+            openToolPanel(id) {
+                open = id;
+                visible = true;
+                render();
+            },
+            closeToolPanel() {
+                open = null;
+                render();
+            },
+            getOpenedToolPanel: () => open,
+            setSideBarVisible(v) {
+                visible = v;
+                render();
+            },
+        };
+        Object.assign(grid, api);
+        grid.eSideHost.append(root);
+        render();
+        const offs = ['displayedColumnsChanged', 'columnRowGroupChanged', 'columnVisible'].map((t) => grid.addEventListener(t, () => open === 'columns' && render()));
+        offs.push(grid.addEventListener('filterChanged', () => {
+            if (open === 'filters' && !body.contains(document.activeElement))
+                render();
+        }));
+        return () => {
+            offs.forEach((f) => f());
+            root.remove();
+            for (const k of Object.keys(api))
+                delete grid[k];
+        };
+    },
+};
+//# sourceMappingURL=sidebar.js.map

package/dist/sidebar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar.js","sourceRoot":"","sources":["../src/sidebar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,aAAa,EAAgD,MAAM,kBAAkB,CAAC;AAsB1H,MAAM,MAAM,GAAgC,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AACvF,MAAM,IAAI,GAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAElE,iFAAiF;AACjF,MAAM,CAAC,MAAM,aAAa,GAAe;IACvC,IAAI,EAAE,eAAe;IACrB,OAAO,CAAC,IAAe;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;QACjC,MAAM,GAAG,GAAe,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC;QACtD,MAAM,MAAM,GAAG,GAAG,CAAC,UAAU,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACxD,IAAI,IAAI,GAAuB,GAAG,CAAC,gBAAgB,IAAI,IAAI,CAAC;QAC5D,IAAI,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC;QACpB,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,SAAS,EAAE,kBAAkB,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC,CAAC;QACjI,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QACrE,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,gBAAgB,GAAG,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QAClH,IAAI,MAAM,GAAG,EAAE,CAAC;QAEhB,MAAM,YAAY,GAAG,GAAG,EAAE;YACxB,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAAC;YACrD,MAAM,cAAc,GAAG,OAAQ,IAAY,CAAC,YAAY,KAAK,UAAU,CAAC;YACxE,IAAI,cAAc,EAAE,CAAC;gBACnB,MAAM,EAAE,GAAI,IAAY,CAAC,WAAW,EAAa,CAAC;gBAClD,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC,CAAC;gBACrG,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE;oBACjC,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;wBACf,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC;wBACzF,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;wBAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;wBAC3E,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;wBAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;6BACnG,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAgB,EAAE,CAAC,CAAC,CAAC;wBAChH,IAAY,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;oBAChG,CAAC;;wBAAO,IAAY,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;oBACzC,MAAM,EAAE,CAAC;gBACX,CAAC,CAAC,CAAC;gBACH,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC9F,IAAI,EAAE,EAAE,CAAC;oBACP,MAAM,GAAG,GAAI,IAAY,CAAC,cAAc,EAAE,CAAC;oBAC3C,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,IAAI,EAAE,SAAS,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,eAAe,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,cAAc,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAqC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;oBACjQ,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE,YAAY,EAAE,gBAAgB,EAAE,CAAC,CAAC;YAC7H,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC;YACjB,CAAC,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;gBAC/B,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC;gBACjB,UAAU,EAAE,CAAC;YACf,CAAC,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YAChE,MAAM,UAAU,GAAG,GAAG,EAAE;gBACtB,IAAI,CAAC,eAAe,EAAE,CAAC;gBACvB,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;gBACxG,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;oBACrB,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;oBACtG,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;oBACnF,MAAM,OAAO,GAAG,CAAC,CAAC,cAAc,CAAC;oBACjC,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,EAAE;wBAC3B,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,gBAAgB,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,cAAc,EAAE,MAAM,CAAC,OAAO,CAAC;wBACrG,YAAY,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,2BAA2B;wBACtI,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,cAAc,KAAK,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ;qBACvE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;oBACxB,QAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBAC3H,MAAM,KAAK,GAAW,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;oBAChG,IAAI,aAAa,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;wBAClC,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,wBAAwB,EAAE,YAAY,EAAE,mBAAmB,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;wBAC9G,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;wBACvD,KAAK,MAAM,CAAC,IAAI,IAAI;4BAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;wBAChG,GAAG,CAAC,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,CAAuB,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;wBACjJ,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBAClB,CAAC;oBACD,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;gBAC7E,CAAC;gBACD,IAAI,CAAC,IAAI,CAAC,MAAM;oBAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC;YAC1F,CAAC,CAAC;YACF,UAAU,EAAE,CAAC;YACb,MAAM,SAAS,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5C,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,EAC9E,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC3E,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC,UAAU,WAAW,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;gBAC1I,CAAC,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;gBACtE,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAClF,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,IAAI,EAAE,wCAAwC,EAAE,CAAC,CAAC,CAAC;YACtG,OAAO,IAAI,CAAC;QACd,CAAC,CAAC;QAEF,MAAM,YAAY,GAAG,GAAG,EAAE;YACxB,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAAC;YACrD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/E,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;gBAChD,MAAM,GAAG,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,CAAC;gBACvD,MAAM,GAAG,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,UAAU,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACxK,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAChB,GAAG,CAAC,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE;oBAClC,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,iBAAiB,KAAK,CAAC;wBAAE,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;gBACrF,CAAC,CAAC,CAAC;gBACH,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACnB,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC;QAEF,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,IAAI,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;YACzD,KAAK,CAAC,eAAe,CACnB,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;gBACnB,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;oBACpB,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC,MAAM,QAAQ;oBACjI,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;iBAClB,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;gBACtH,CAAC,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;oBAC/B,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC/B,MAAM,EAAE,CAAC;gBACX,CAAC,CAAC,CAAC;gBACH,OAAO,CAAC,CAAC;YACX,CAAC,CAAC,CACH,CAAC;YACF,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,MAAM,QAAQ,CAAC;YACjC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC;YACpB,IAAI,IAAI,EAAE,CAAC;gBACT,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;YACxI,CAAC;QACH,CAAC,CAAC;QACF,MAAM,GAAG,GAAG;YACV,aAAa,CAAC,EAAe;gBAC3B,IAAI,GAAG,EAAE,CAAC;gBACV,OAAO,GAAG,IAAI,CAAC;gBACf,MAAM,EAAE,CAAC;YACX,CAAC;YACD,cAAc;gBACZ,IAAI,GAAG,IAAI,CAAC;gBACZ,MAAM,EAAE,CAAC;YACX,CAAC;YACD,kBAAkB,EAAE,GAAG,EAAE,CAAC,IAAI;YAC9B,iBAAiB,CAAC,CAAU;gBAC1B,OAAO,GAAG,CAAC,CAAC;gBACZ,MAAM,EAAE,CAAC;YACX,CAAC;SACF,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5B,MAAM,EAAE,CAAC;QACT,MAAM,IAAI,GAAG,CAAC,yBAAyB,EAAE,uBAAuB,EAAE,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3F,IAAI,CAAC,gBAAgB,CAAC,CAAU,EAAE,GAAG,EAAE,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,EAAE,CAAC,CACxE,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,eAAe,EAAE,GAAG,EAAE;YACpD,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC;gBAAE,MAAM,EAAE,CAAC;QAC7E,CAAC,CAAC,CAAC,CAAC;QACJ,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACzB,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,OAAQ,IAAY,CAAC,CAAC,CAAC,CAAC;QAC5D,CAAC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/styles.css

@@ -0,0 +1,55 @@
+/* Aurum Grid Enterprise styles — opt-in. Uses the same --agr-* theme tokens as core. */
+
+/* range selection */
+.agr-cell-range { background-image: linear-gradient(var(--agr-range-bg), var(--agr-range-bg)); }
+.agr-range-top { box-shadow: inset 0 2px 0 var(--agr-accent); }
+.agr-range-bottom { box-shadow: inset 0 -2px 0 var(--agr-accent); }
+.agr-range-left { border-left: 2px solid var(--agr-accent); }
+.agr-range-right { border-right: 2px solid var(--agr-accent); }
+.agr-range-top.agr-range-bottom { box-shadow: inset 0 2px 0 var(--agr-accent), inset 0 -2px 0 var(--agr-accent); }
+.agr-range-enabled .agr-body { user-select: none; }
+
+/* side bar */
+.agr-side-bar { display: flex; height: 100%; border-left: 1px solid var(--agr-border); background: var(--agr-bg); }
+.agr-side-bar[hidden] { display: none; }
+.agr-side-left { order: -1; flex-direction: row-reverse; border-left: 0; border-right: 1px solid var(--agr-border); }
+.agr-side-host { display: flex; }
+.agr-side-tabs { display: flex; flex-direction: column; gap: 2px; padding: 6px 3px; background: var(--agr-header-bg); }
+.agr-side-tab {
+  display: flex; flex-direction: column; align-items: center; gap: 6px; padding: 10px 6px; border: 0; border-radius: 4px;
+  background: transparent; color: var(--agr-header-fg); cursor: pointer; font: inherit; font-size: 12px;
+}
+.agr-side-tab-label { writing-mode: vertical-rl; transform: rotate(180deg); letter-spacing: 0.04em; }
+.agr-side-tab[aria-selected='true'] { background: var(--agr-accent); color: var(--agr-accent-fg); }
+.agr-side-tab:hover:not([aria-selected='true']) { background: color-mix(in srgb, var(--agr-header-fg) 10%, transparent); }
+.agr-side-tab:focus-visible { outline: 2px solid var(--agr-focus); outline-offset: 1px; }
+.agr-side-panel { width: 260px; overflow: auto; padding: 10px; display: flex; flex-direction: column; gap: 8px; }
+.agr-side-panel[hidden] { display: none; }
+.agr-side-title { font-weight: 700; }
+.agr-tool-columns, .agr-tool-filters { display: flex; flex-direction: column; gap: 8px; }
+.agr-tool-list { display: flex; flex-direction: column; }
+.agr-tool-item { display: flex; align-items: center; gap: 6px; min-height: 32px; padding: 0 2px; border-radius: 4px; }
+.agr-tool-item:hover { background: var(--agr-row-hover-bg); }
+.agr-tool-item input[type='checkbox'] { accent-color: var(--agr-accent); }
+.agr-tool-name { flex: 1 1 auto; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.agr-tool-agg { height: 26px; width: 76px; font-size: 12px; }
+.agr-tool-section { margin-top: 6px; font-size: 11px; text-transform: uppercase; letter-spacing: 0.06em; color: var(--agr-muted); }
+.agr-tool-chips { display: flex; flex-wrap: wrap; gap: 6px; }
+.agr-tool-note { margin: 0; font-size: 12px; }
+.agr-icon-btn.agr-active { background: var(--agr-accent); color: var(--agr-accent-fg); }
+.agr-switch-row { display: flex; align-items: center; gap: 8px; font-weight: 600; }
+.agr-switch-row input { accent-color: var(--agr-accent); width: 16px; height: 16px; }
+.agr-tool-filter { border: 1px solid var(--agr-border); border-radius: 4px; }
+.agr-tool-filter > summary { display: flex; align-items: center; gap: 6px; padding: 6px 8px; cursor: pointer; font-weight: 600; }
+.agr-tool-filter[open] > summary { border-bottom: 1px solid var(--agr-border); }
+
+/* advanced filter builder */
+.agr-adv-builder { display: flex; flex-direction: column; gap: 8px; padding: 4px 6px 8px; min-width: 300px; }
+.agr-adv-row { display: grid; grid-template-columns: 1fr 1fr 1fr auto; gap: 6px; align-items: center; }
+.agr-adv-label { font-size: 11px; text-transform: uppercase; letter-spacing: 0.06em; color: var(--agr-muted); }
+.agr-adv-preview { display: block; padding: 6px 8px; border-radius: 4px; background: var(--agr-input-bg); border: 1px solid var(--agr-border); white-space: pre-wrap; font-size: 12px; }
+.agr-adv-actions { display: flex; justify-content: flex-end; gap: 6px; }
+.agr-popup:has(.agr-adv-builder) { max-width: 560px; }
+
+/* pivot */
+.agr-pivot-total { font-weight: 700; }

package/dist/sync.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Persist a grid configuration to a REST collection:
+ *   POST {endpoint}            → 201 + Location: /grids/42   (or JSON { id })
+ *   PUT  {resource}            ← debounced edits, strictly one at a time, latest wins
+ * Without an endpoint the client stays in "local-only" mode and says so.
+ */
+export type SyncStatus = 'local-only' | 'idle' | 'creating' | 'saving' | 'saved' | 'error';
+export interface SyncState {
+    status: SyncStatus;
+    message: string;
+    resourceUrl: string | null;
+    /** Number of edits made locally. */
+    revision: number;
+    /** Highest revision the server has confirmed. */
+    savedRevision: number;
+    lastSavedAt: string | null;
+    requests: number;
+}
+type FetchLike = (input: string, init?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+    signal?: AbortSignal;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    headers: {
+        get(name: string): string | null;
+    };
+    json(): Promise<unknown>;
+}>;
+export interface GridSyncOptions {
+    endpoint?: string | null;
+    fetch?: FetchLike;
+    debounceMs?: number;
+    headers?: Record<string, string>;
+    timeoutMs?: number;
+    onState?: (s: SyncState) => void;
+}
+export declare function validateCollectionUrl(raw: string): {
+    ok: true;
+    url: string;
+} | {
+    ok: false;
+    error: string;
+};
+export declare class GridSync<P extends object = object> {
+    private o;
+    private state;
+    private chain;
+    private pending;
+    private timer;
+    private disposed;
+    private endpoint;
+    private fetcher;
+    constructor(o?: GridSyncOptions);
+    getState(): SyncState;
+    private set;
+    private request;
+    /** POST the full configuration. Resolves once the server has created the resource (or failed). */
+    create(payload: P): Promise<void>;
+    /** Record an edit; the latest payload is PUT after the debounce interval. */
+    update(payload: P): void;
+    /** Send any pending edit now (still serialised behind in-flight requests). */
+    flush(): Promise<void>;
+    retry(): Promise<void>;
+    dispose(): void;
+}
+export declare function createGridSync<P extends object>(o?: GridSyncOptions): GridSync<P>;
+export interface MockServerLogEntry {
+    at: string;
+    method: string;
+    url: string;
+    status: number;
+    bytes: number;
+}
+export declare function createMockCollectionServer(o?: {
+    baseUrl?: string;
+    latencyMs?: number | (() => number);
+    failNext?: number;
+}): {
+    baseUrl: string;
+    fetch: FetchLike;
+    log: MockServerLogEntry[];
+    get: (id: string) => unknown;
+    failNextRequests: (n: number) => void;
+};
+export {};