@aurum-grid/enterprise 0.0.0-stage → 0.2.0

package/dist/extras.js

@@ -0,0 +1,251 @@
+export const ContextMenuModule = {
+    name: 'ContextMenuModule',
+    install(grid) {
+        const provider = (params) => {
+            const g = grid;
+            // Excel and PDF join the core "Export" submenu so related actions stay together.
+            const exportMenu = params.defaultItems.find((i) => i.name === 'Export' && i.subMenu);
+            if (exportMenu?.subMenu) {
+                if (typeof g.exportDataAsExcel === 'function')
+                    exportMenu.subMenu.splice(1, 0, { name: 'Excel (.xlsx)', action: () => g.exportDataAsExcel() });
+                if (typeof g.exportDataAsPdf === 'function')
+                    exportMenu.subMenu.push({ name: '', separator: true }, { name: 'Print / Save as PDF', action: () => g.exportDataAsPdf() });
+            }
+            const items = [];
+            if (grid.options.onChartRequest) {
+                const ranged = typeof g.getCellRanges === 'function' && g.getCellRanges().some((r) => r.endRow !== r.startRow || r.columns.length > 1);
+                const selected = grid.getSelectedNodes().length;
+                const source = ranged ? 'range' : selected ? 'selection' : 'rows';
+                const req = (chartType) => () => grid.options.onChartRequest({ api: grid, source, chartType });
+                const sub = (pairs) => pairs.map(([name, t]) => ({ name, action: req(t) }));
+                items.push({
+                    name: ranged ? 'Chart range' : selected ? `Chart ${selected} selected row${selected === 1 ? '' : 's'}` : 'Chart rows in view', icon: 'chart',
+                    subMenu: [
+                        { name: 'Open integrated chart…', icon: 'chart', action: req() },
+                        { name: '', separator: true },
+                        { name: 'Column', subMenu: sub([['Grouped', 'column'], ['Stacked', 'stackedColumn'], ['100% stacked', 'normalizedColumn']]) },
+                        { name: 'Bar', subMenu: sub([['Grouped', 'bar'], ['Stacked', 'stackedBar'], ['100% stacked', 'normalizedBar']]) },
+                        { name: 'Pie', subMenu: sub([['Pie', 'pie'], ['Donut', 'donut'], ['Nightingale rose', 'nightingale']]) },
+                        { name: 'Line', action: req('line') },
+                        { name: 'Area', subMenu: sub([['Area', 'area'], ['Stacked', 'stackedArea'], ['100% stacked', 'normalizedArea']]) },
+                        { name: 'X Y (scatter)', subMenu: sub([['Scatter', 'scatter'], ['Bubble', 'bubble']]) },
+                        { name: 'Polar', subMenu: sub([['Radar line', 'radar'], ['Radar area', 'radarArea'], ['Radial bar', 'radialBar']]) },
+                        { name: 'Statistical', subMenu: sub([['Histogram', 'histogram'], ['Box plot', 'boxPlot'], ['Range bar', 'rangeBar']]) },
+                        { name: 'Hierarchical', subMenu: sub([['Treemap', 'treemap'], ['Sunburst', 'sunburst']]) },
+                        { name: 'Specialized', subMenu: sub([['Heatmap', 'heatmap'], ['Waterfall', 'waterfall'], ['Gauge', 'gauge']]) },
+                        { name: 'Funnel', subMenu: sub([['Funnel', 'funnel'], ['Pyramid', 'pyramid']]) },
+                        { name: 'Combination', action: req('combo') },
+                    ],
+                });
+            }
+            const view = [];
+            if (grid.getRowGroupColumns().length || grid.options.treeData) {
+                view.push({ name: 'Expand all', icon: 'expand', action: () => grid.expandAll() }, { name: 'Collapse all', icon: 'collapse', action: () => grid.collapseAll() });
+            }
+            view.push({ name: 'Autosize all columns', action: () => grid.autoSizeAllColumns() }, { name: 'Size columns to fit', action: () => grid.sizeColumnsToFit() });
+            items.push({ name: 'View', icon: 'columns', subMenu: view });
+            if (grid.getCurrentUndoSize())
+                items.push({ name: 'Undo edit', icon: 'undo', shortcut: 'Ctrl+Z', action: () => grid.undoCellEditing() });
+            return items.length ? [{ name: '', separator: true }, ...items] : [];
+        };
+        grid.hooks.contextMenuItems.add(provider);
+        return () => grid.hooks.contextMenuItems.delete(provider);
+    },
+};
+function memoryStorage() {
+    const m = new Map();
+    return { getItem: (k) => m.get(k) ?? null, setItem: (k, v) => void m.set(k, v) };
+}
+export const SavedViewsModule = {
+    name: 'SavedViewsModule',
+    install(grid) {
+        let storage;
+        try {
+            storage = grid.options.viewStorage ?? globalThis.localStorage ?? memoryStorage();
+            storage.getItem('__probe__');
+        }
+        catch {
+            storage = memoryStorage();
+        }
+        const key = () => `aurum-grid.views.${grid.options.gridKey ?? 'default'}`;
+        const read = () => {
+            try {
+                const raw = storage.getItem(key());
+                const parsed = raw ? JSON.parse(raw) : [];
+                return Array.isArray(parsed) ? parsed.filter((v) => v && typeof v.name === 'string' && v.state) : [];
+            }
+            catch {
+                return [];
+            }
+        };
+        const write = (views) => {
+            try {
+                storage.setItem(key(), JSON.stringify(views));
+            }
+            catch (err) {
+                console.warn('Aurum Grid: could not persist saved views', err);
+            }
+        };
+        const api = {
+            saveView(name) {
+                const clean = name.trim().slice(0, 80);
+                if (!clean)
+                    throw new Error('View name is required');
+                const state = grid.getState();
+                state.selectedRowIds = [];
+                state.focusedCell = null;
+                const view = { name: clean, savedAt: new Date().toISOString(), state };
+                write([...read().filter((v) => v.name !== clean), view]);
+                grid.announce(`Saved view "${clean}"`);
+                return view;
+            },
+            listViews: () => read(),
+            applyView(name) {
+                const v = read().find((x) => x.name === name);
+                if (!v)
+                    return false;
+                grid.setState(v.state);
+                grid.announce(`Applied view "${name}"`);
+                return true;
+            },
+            deleteView(name) {
+                const views = read();
+                const next = views.filter((v) => v.name !== name);
+                write(next);
+                return next.length !== views.length;
+            },
+        };
+        Object.assign(grid, api);
+        return () => {
+            for (const k of Object.keys(api))
+                delete grid[k];
+        };
+    },
+};
+/**
+ * Batches high-frequency updates into async transactions.
+ * `push` accepts upserts; call `dispose` when done.
+ */
+export function createStreamBuffer(grid, opts) {
+    let pending = { add: [], update: [], remove: [] };
+    let disposed = false;
+    let received = 0;
+    const flush = () => {
+        if (disposed)
+            return;
+        const tx = { add: pending.add, update: pending.update, remove: pending.remove };
+        pending = { add: [], update: [], remove: [] };
+        if (tx.add.length || tx.update.length || tx.remove.length)
+            grid.applyTransactionAsync(tx);
+    };
+    return {
+        push(msg) {
+            if (disposed)
+                return;
+            received++;
+            for (const row of msg.upsert ?? []) {
+                if (grid.getRowNode(opts.getId(row)))
+                    pending.update.push(row);
+                else
+                    pending.add.push(row);
+            }
+            pending.add.push(...(msg.add ?? []));
+            pending.update.push(...(msg.update ?? []));
+            pending.remove.push(...(msg.remove ?? []));
+            if ((pending.update.length + pending.add.length) >= (opts.maxBatch ?? 500))
+                flush();
+            else
+                queueMicrotask(flush);
+        },
+        get received() {
+            return received;
+        },
+        dispose() {
+            disposed = true;
+        },
+    };
+}
+/** wss:// is required; ws:// is accepted only for localhost development. */
+export function validateStreamUrl(raw) {
+    let url;
+    try {
+        url = new URL(raw.trim());
+    }
+    catch {
+        return { ok: false, error: 'Enter a full WebSocket URL, e.g. wss://feed.example.com/trades.' };
+    }
+    const local = ['localhost', '127.0.0.1', '[::1]'].includes(url.hostname);
+    if (url.username || url.password)
+        return { ok: false, error: 'Remove credentials from the URL.' };
+    if (url.protocol === 'ws:' && !local)
+        return { ok: false, error: 'Insecure endpoint: use wss:// (ws:// is only allowed for localhost).' };
+    if (url.protocol !== 'wss:' && url.protocol !== 'ws:')
+        return { ok: false, error: 'WebSocket URLs must start with wss://.' };
+    return { ok: true, url };
+}
+/**
+ * Connect a grid to a WebSocket that sends JSON StreamMessage payloads.
+ * Only ws:// or wss:// URLs are accepted. Messages that fail to parse are counted and dropped.
+ */
+export function connectWebSocketStream(grid, url, opts) {
+    const check = validateStreamUrl(url);
+    if (!check.ok) {
+        opts.onStatus?.('error', check.error);
+        return { close: () => { }, stats: () => ({ messages: 0, errors: 0 }) };
+    }
+    const parsed = check.url;
+    const buf = createStreamBuffer(grid, { getId: opts.getId });
+    let errors = 0;
+    opts.onStatus?.('connecting');
+    const ws = new WebSocket(parsed.toString());
+    ws.onopen = () => opts.onStatus?.('live');
+    ws.onerror = () => opts.onStatus?.('error', 'Connection error');
+    ws.onclose = () => opts.onStatus?.('disconnected');
+    ws.onmessage = (ev) => {
+        if (typeof ev.data !== 'string' || ev.data.length > 5_000_000) {
+            errors++;
+            return;
+        }
+        try {
+            const msg = opts.parse ? opts.parse(String(ev.data)) : JSON.parse(String(ev.data));
+            buf.push(msg);
+        }
+        catch {
+            errors++;
+        }
+    };
+    return {
+        close: () => {
+            buf.dispose();
+            ws.close();
+        },
+        stats: () => ({ messages: buf.received, errors }),
+    };
+}
+/**
+ * Builds an infinite-row-model datasource from an async fetcher. The fetcher
+ * receives sort/filter state so the server can do the heavy lifting.
+ */
+export function createServerSideDatasource(fetcher, opts = {}) {
+    const controllers = new Set();
+    return {
+        getRows(p) {
+            const ctrl = new AbortController();
+            controllers.add(ctrl);
+            const timer = setTimeout(() => ctrl.abort(), opts.timeoutMs ?? 30_000);
+            fetcher({ startRow: p.startRow, endRow: p.endRow, sortModel: p.sortModel, filterModel: p.filterModel, quickFilterText: p.quickFilterText, signal: ctrl.signal })
+                .then((res) => p.successCallback(res.rows, res.lastRow))
+                .catch((err) => p.failCallback(ctrl.signal.aborted ? new Error('Request timed out') : err))
+                .finally(() => {
+                clearTimeout(timer);
+                controllers.delete(ctrl);
+            });
+        },
+        destroy() {
+            for (const c of controllers)
+                c.abort();
+            controllers.clear();
+        },
+    };
+}
+//# sourceMappingURL=extras.js.map

package/dist/extras.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extras.js","sourceRoot":"","sources":["../src/extras.ts"],"names":[],"mappings":"AA2BA,MAAM,CAAC,MAAM,iBAAiB,GAAe;IAC3C,IAAI,EAAE,mBAAmB;IACzB,OAAO,CAAC,IAAe;QACrB,MAAM,QAAQ,GAAG,CAAC,MAAuC,EAAiB,EAAE;YAC1E,MAAM,CAAC,GAAG,IAAW,CAAC;YACtB,iFAAiF;YACjF,MAAM,UAAU,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC;YACrF,IAAI,UAAU,EAAE,OAAO,EAAE,CAAC;gBACxB,IAAI,OAAO,CAAC,CAAC,iBAAiB,KAAK,UAAU;oBAAE,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;gBAC/I,IAAI,OAAO,CAAC,CAAC,eAAe,KAAK,UAAU;oBAAE,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;YAC1K,CAAC;YACD,MAAM,KAAK,GAAkB,EAAE,CAAC;YAChC,IAAI,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;gBAChC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,aAAa,KAAK,UAAU,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,CAAC,CAA0D,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBAChM,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC,MAAM,CAAC;gBAChD,MAAM,MAAM,GAAmC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC;gBAClG,MAAM,GAAG,GAAG,CAAC,SAAkB,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,cAAe,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;gBACzG,MAAM,GAAG,GAAG,CAAC,KAA8B,EAAiB,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACpH,KAAK,CAAC,IAAI,CAAC;oBACT,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,QAAQ,gBAAgB,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,oBAAoB,EAAE,IAAI,EAAE,OAAO;oBAC5I,OAAO,EAAE;wBACP,EAAE,IAAI,EAAE,wBAAwB,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;wBAChE,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;wBAC7B,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,eAAe,CAAC,EAAE,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAAE;wBAC7H,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE;wBACjH,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE;wBACxG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE;wBACrC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE;wBAClH,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE;wBACvF,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,YAAY,EAAE,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,WAAW,CAAC,EAAE,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE;wBACpH,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,WAAW,CAAC,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE;wBACvH,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE;wBAC1F,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE;wBAC/G,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE;wBAChF,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE;qBAC9C;iBACF,CAAC,CAAC;YACL,CAAC;YACD,MAAM,IAAI,GAAkB,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;gBAC9D,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAClK,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;YAC7J,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7D,IAAI,IAAI,CAAC,kBAAkB,EAAE;gBAAE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;YACzI,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,CAAC,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5D,CAAC;CACF,CAAC;AAYF,SAAS,aAAa;IACpB,MAAM,CAAC,GAAG,IAAI,GAAG,EAAkB,CAAC;IACpC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACnF,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAe;IAC1C,IAAI,EAAE,kBAAkB;IACxB,OAAO,CAAC,IAAe;QACrB,IAAI,OAA6C,CAAC;QAClD,IAAI,CAAC;YACH,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,UAAU,CAAC,YAAY,IAAI,aAAa,EAAE,CAAC;YACjF,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,aAAa,EAAE,CAAC;QAC5B,CAAC;QACD,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,oBAAoB,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,SAAS,EAAE,CAAC;QAC1E,MAAM,IAAI,GAAG,GAAgB,EAAE;YAC7B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;gBACnC,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1C,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACvG,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,CAAC,KAAkB,EAAE,EAAE;YACnC,IAAI,CAAC;gBACH,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YAChD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,2CAA2C,EAAE,GAAG,CAAC,CAAC;YACjE,CAAC;QACH,CAAC,CAAC;QACF,MAAM,GAAG,GAAG;YACV,QAAQ,CAAC,IAAY;gBACnB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACvC,IAAI,CAAC,KAAK;oBAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;gBACrD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC9B,KAAK,CAAC,cAAc,GAAG,EAAE,CAAC;gBAC1B,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;gBACzB,MAAM,IAAI,GAAc,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC;gBAClF,KAAK,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;gBACzD,IAAI,CAAC,QAAQ,CAAC,eAAe,KAAK,GAAG,CAAC,CAAC;gBACvC,OAAO,IAAI,CAAC;YACd,CAAC;YACD,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE;YACvB,SAAS,CAAC,IAAY;gBACpB,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;gBAC9C,IAAI,CAAC,CAAC;oBAAE,OAAO,KAAK,CAAC;gBACrB,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;gBACvB,IAAI,CAAC,QAAQ,CAAC,iBAAiB,IAAI,GAAG,CAAC,CAAC;gBACxC,OAAO,IAAI,CAAC;YACd,CAAC;YACD,UAAU,CAAC,IAAY;gBACrB,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC;gBACrB,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;gBAClD,KAAK,CAAC,IAAI,CAAC,CAAC;gBACZ,OAAO,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CAAC;YACtC,CAAC;SACF,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACzB,OAAO,GAAG,EAAE;YACV,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,OAAQ,IAAY,CAAC,CAAC,CAAC,CAAC;QAC5D,CAAC,CAAC;IACJ,CAAC;CACF,CAAC;AAcF;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAI,IAAa,EAAE,IAAsD;IACzG,IAAI,OAAO,GAAqB,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACpE,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,IAAI,QAAQ;YAAE,OAAO;QACrB,MAAM,EAAE,GAAsB,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QACnG,OAAO,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QAC9C,IAAI,EAAE,CAAC,GAAI,CAAC,MAAM,IAAI,EAAE,CAAC,MAAO,CAAC,MAAM,IAAI,EAAE,CAAC,MAAO,CAAC,MAAM;YAAE,IAAI,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC;IAC/F,CAAC,CAAC;IACF,OAAO;QACL,IAAI,CAAC,GAAqB;YACxB,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,EAAE,CAAC;YACX,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;gBACnC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;oBAAE,OAAO,CAAC,MAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;;oBAC3D,OAAO,CAAC,GAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC9B,CAAC;YACD,OAAO,CAAC,GAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;YACtC,OAAO,CAAC,MAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;YAC5C,OAAO,CAAC,MAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;YAC5C,IAAI,CAAC,OAAO,CAAC,MAAO,CAAC,MAAM,GAAG,OAAO,CAAC,GAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,GAAG,CAAC;gBAAE,KAAK,EAAE,CAAC;;gBACjF,cAAc,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;QACD,IAAI,QAAQ;YACV,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO;YACL,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC;AAID,4EAA4E;AAC5E,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,iEAAiE,EAAE,CAAC;IACjG,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzE,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,kCAAkC,EAAE,CAAC;IAClG,IAAI,GAAG,CAAC,QAAQ,KAAK,KAAK,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,sEAAsE,EAAE,CAAC;IAC1I,IAAI,GAAG,CAAC,QAAQ,KAAK,MAAM,IAAI,GAAG,CAAC,QAAQ,KAAK,KAAK;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,wCAAwC,EAAE,CAAC;IAC7H,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAa,EACb,GAAW,EACX,IAAqI;IAErI,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACd,IAAI,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QACtC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IACxE,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC;IACzB,MAAM,GAAG,GAAG,kBAAkB,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC5D,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,CAAC,QAAQ,EAAE,CAAC,YAAY,CAAC,CAAC;IAC9B,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5C,EAAE,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC;IAC1C,EAAE,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;IAChE,EAAE,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,cAAc,CAAC,CAAC;IACnD,EAAE,CAAC,SAAS,GAAG,CAAC,EAAE,EAAE,EAAE;QACpB,IAAI,OAAO,EAAE,CAAC,IAAI,KAAK,QAAQ,IAAI,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;YAC9D,MAAM,EAAE,CAAC;YACT,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAsB,CAAC;YACzG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,EAAE,CAAC;QACX,CAAC;IACH,CAAC,CAAC;IACF,OAAO;QACL,KAAK,EAAE,GAAG,EAAE;YACV,GAAG,CAAC,OAAO,EAAE,CAAC;YACd,EAAE,CAAC,KAAK,EAAE,CAAC;QACb,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;KAClD,CAAC;AACJ,CAAC;AAeD;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAI,OAAyE,EAAE,OAA+B,EAAE;IACxJ,MAAM,WAAW,GAAG,IAAI,GAAG,EAAmB,CAAC;IAC/C,OAAO;QACL,OAAO,CAAC,CAAC;YACP,MAAM,IAAI,GAAG,IAAI,eAAe,EAAE,CAAC;YACnC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACtB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,CAAC;YACvE,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,eAAe,EAAE,CAAC,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;iBAC7J,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;iBACvD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;iBAC1F,OAAO,CAAC,GAAG,EAAE;gBACZ,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC,CAAC,CAAC;QACP,CAAC;QACD,OAAO;YACL,KAAK,MAAM,CAAC,IAAI,WAAW;gBAAE,CAAC,CAAC,KAAK,EAAE,CAAC;YACvC,WAAW,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/import.d.ts

@@ -0,0 +1,86 @@
+import type { ColDef } from '@aurum-grid/core';
+import { type WorkbookSheet, type XlsxCell } from './excel.js';
+export declare const IMPORT_LIMITS: {
+    maxBytes: number;
+    maxRows: number;
+    maxColumns: number;
+};
+export type ImportedType = 'number' | 'text' | 'date' | 'boolean';
+export type ImportFileType = 'csv' | 'xlsx';
+export interface ImportedColumn {
+    field: string;
+    headerName: string;
+    sourceHeader: string;
+    type: ImportedType;
+}
+export interface GridPayload {
+    schemaVersion: 1;
+    gridName: string;
+    source: {
+        fileName: string;
+        fileType: ImportFileType;
+        sheet: string | null;
+        uploadedAt: string;
+    };
+    rowCount: number;
+    columnCount: number;
+    columns: ImportedColumn[];
+    rows: Array<Record<string, string | number | boolean | null>>;
+}
+export interface ImportedGrid {
+    payload: GridPayload;
+    columnDefs: ColDef[];
+    rowData: Array<Record<string, string | number | boolean | null>>;
+    warnings: string[];
+}
+export declare class ImportError extends Error {
+}
+/**
+ * Turn arbitrary header cells into unique, safe field names while keeping readable labels.
+ * "Unit price ($)" → unitPrice, "" → column3, "2024" → c2024, "__proto__" → proto_, duplicates → name_2.
+ */
+export declare function sanitizeHeaders(headers: unknown[]): Array<{
+    field: string;
+    headerName: string;
+    sourceHeader: string;
+}>;
+export declare function parseNumberLike(v: unknown): number | null;
+/** Infer a column type from its values (blank values are ignored). */
+export declare function inferColumnType(values: unknown[]): {
+    type: ImportedType;
+    dayFirst: boolean;
+};
+/** RFC 4180 CSV/TSV parser with delimiter detection (comma, semicolon, tab, pipe). */
+export declare function parseDelimited(text: string, delimiter?: string): string[][];
+/** Blob → ArrayBuffer/text that also works where Blob#arrayBuffer is missing (older browsers, jsdom). */
+export declare function blobToArrayBuffer(b: Blob): Promise<ArrayBuffer>;
+export declare function blobToText(b: Blob): Promise<string>;
+/** Decide the file type from its name and first bytes; rejects anything else. */
+export declare function detectFileType(file: Blob & {
+    name?: string;
+}): Promise<ImportFileType>;
+export interface InspectedFile {
+    fileName: string;
+    fileType: ImportFileType;
+    sheets: WorkbookSheet[];
+}
+/** Read a CSV or XLSX upload. CSV is returned as a single sheet named after the file. */
+export declare function inspectFile(file: Blob & {
+    name?: string;
+}, limits?: {
+    maxBytes: number;
+    maxRows: number;
+    maxColumns: number;
+}): Promise<InspectedFile>;
+export interface BuildOptions {
+    fileName: string;
+    fileType: ImportFileType;
+    sheet?: string | null;
+    gridName?: string;
+    limits?: typeof IMPORT_LIMITS;
+    now?: Date;
+}
+/** Build column definitions, typed rows and the backend payload from a header row + data rows. */
+export declare function buildImportedGrid(header: unknown[], rows: XlsxCell[][] | string[][], o: BuildOptions): ImportedGrid;
+/** Refresh the payload rows (after edits) without changing schema metadata. */
+export declare function withRows(payload: GridPayload, rows: Array<Record<string, unknown>>): GridPayload;