@svgrid/grid 1.1.0 → 1.1.1

package/dist/build-api.coverage.test.js

@@ -0,0 +1,505 @@
+/**
+ * Coverage-focused behavioral tests for the SvGridApi assembled in
+ * `build-api.ts`. The existing `svgrid.api.test.ts` / `svgrid.api-extensions
+ * .test.ts` cover filters, row selection, pagination, navigation, and
+ * getState/setState. This file exercises the remaining surface:
+ *   - getCellValue / setCellValue
+ *   - selectCells / getSelected
+ *   - addRow(s) / removeRow(s) / applyTransaction
+ *   - addColumn(s) / removeColumn / setColumnVisible / getColumns
+ *   - setColumnWidth / setColumnPinning / setColumnOrder
+ *   - setFacetFilter
+ *   - undo / redo / canUndo / canRedo / clearHistory
+ *   - find (open/close/query/hits)
+ *   - grouping (setGroupBy / expandAllGroups / collapseAllGroups)
+ *   - autosizeColumn / refresh
+ *
+ * All tests mount the real <SvGrid /> in jsdom and drive the api handed back
+ * from onApiReady.
+ */
+import { describe, expect, it } from "vitest";
+import { mount, unmount } from "svelte";
+import SvGrid from "./SvGrid.svelte";
+import { columnFilteringFeature, columnGroupingFeature, rowExpandingFeature, rowSelectionFeature, rowSortingFeature, tableFeatures, } from "./index";
+const baseRows = [
+    { id: 1, name: "Ada Lovelace", team: "Research", salary: 142000 },
+    { id: 2, name: "Grace Hopper", team: "Compilers", salary: 158000 },
+    { id: 3, name: "Alan Turing", team: "Research", salary: 138000 },
+    { id: 4, name: "Margaret Hamilton", team: "Apollo", salary: 165000 },
+    { id: 5, name: "Linus Torvalds", team: "Kernel", salary: 175000 },
+];
+const baseColumns = [
+    { field: "name", header: "Name", width: 200 },
+    { field: "team", header: "Team", width: 160 },
+    { field: "salary", header: "Salary", width: 140 },
+];
+const flush = () => Promise.resolve();
+function mountGrid(extraProps = {}, features = tableFeatures({
+    columnFilteringFeature,
+    rowSortingFeature,
+    rowSelectionFeature,
+    columnGroupingFeature,
+    rowExpandingFeature,
+})) {
+    return new Promise((resolveApi, rejectApi) => {
+        const target = document.createElement("div");
+        document.body.appendChild(target);
+        let captured = null;
+        const app = mount(SvGrid, {
+            target,
+            props: {
+                data: baseRows.map((r) => ({ ...r })),
+                columns: baseColumns.map((c) => ({ ...c })),
+                features,
+                getRowId: (r) => String(r.id),
+                rowHeight: 36,
+                containerHeight: 480,
+                virtualization: false,
+                enableCellSelection: true,
+                onApiReady(api) {
+                    captured = api;
+                    resolveApi({
+                        api,
+                        target,
+                        destroy: () => {
+                            unmount(app);
+                            target.remove();
+                        },
+                    });
+                },
+                ...extraProps,
+            },
+        });
+        queueMicrotask(() => {
+            if (!captured)
+                rejectApi(new Error("onApiReady never fired"));
+        });
+    });
+}
+describe("SvGridApi - cell read / write", () => {
+    it("getCellValue reads through the column field", async () => {
+        const { api, destroy } = await mountGrid();
+        try {
+            expect(api.getCellValue(0, "name")).toBe("Ada Lovelace");
+            expect(api.getCellValue(3, "team")).toBe("Apollo");
+        }
+        finally {
+            destroy();
+        }
+    });
+    it("getCellValue returns undefined for out-of-range row or unknown column", async () => {
+        const { api, destroy } = await mountGrid();
+        try {
+            expect(api.getCellValue(999, "name")).toBeUndefined();
+            expect(api.getCellValue(0, "nope")).toBeUndefined();
+        }
+        finally {
+            destroy();
+        }
+    });
+    it("setCellValue writes a new immutable row and reads back", async () => {
+        const { api, destroy } = await mountGrid();
+        try {
+            api.setCellValue(0, "name", "Ada L.");
+            await flush();
+            expect(api.getCellValue(0, "name")).toBe("Ada L.");
+            // other rows untouched
+            expect(api.getCellValue(1, "name")).toBe("Grace Hopper");
+        }
+        finally {
+            destroy();
+        }
+    });
+    it("setCellValue is a no-op for an invalid target", async () => {
+        const { api, destroy } = await mountGrid();
+        try {
+            expect(() => api.setCellValue(999, "name", "x")).not.toThrow();
+            expect(() => api.setCellValue(0, "unknown", "x")).not.toThrow();
+        }
+        finally {
+            destroy();
+        }
+    });
+});
+describe("SvGridApi - cell selection", () => {
+    it("selectCells sets a rectangle; getSelected reads it back normalized", async () => {
+        const { api, destroy } = await mountGrid();
+        try {
+            api.selectCells([[2, 1, 0, 0]]); // unsorted corners
+            await flush();
+            expect(api.getSelected()).toEqual([[0, 0, 2, 1]]);
+        }
+        finally {
+            destroy();
+        }
+    });
+    it("selectCells clamps open-ended (Infinity) coordinates to grid bounds", async () => {
+        const { api, destroy } = await mountGrid();
+        try {
+            api.selectCells([[0, 0, Infinity, Infinity]]);
+            await flush();
+            // 5 rows (0..4), 3 cols (0..2)
+            expect(api.getSelected()).toEqual([[0, 0, 4, 2]]);
+        }
+        finally {
+            destroy();
+        }
+    });
+    it("empty selectCells clears the range; getSelected returns []", async () => {
+        const { api, destroy } = await mountGrid();
+        try {
+            api.selectCells([[0, 0, 1, 1]]);
+            await flush();
+            api.selectCells([]);
+            await flush();
+            expect(api.getSelected()).toEqual([]);
+        }
+        finally {
+            destroy();
+        }
+    });
+});
+describe("SvGridApi - row mutations", () => {
+    it("addRow appends to the bottom by default", async () => {
+        const { api, destroy } = await mountGrid();
+        try {
+            api.addRow({ id: 6, name: "New", team: "QA", salary: 1 });
+            await flush();
+            const data = api.getData();
+            expect(data.length).toBe(6);
+            expect(data[5].id).toBe(6);
+        }
+        finally {
+            destroy();
+        }
+    });
+    it("addRows at top / numeric index insert in place", async () => {
+        const { api, destroy } = await mountGrid();
+        try {
+            api.addRows([{ id: 7, name: "Top", team: "T", salary: 1 }], "top");
+            await flush();
+            expect(api.getData()[0].id).toBe(7);
+            api.addRows([{ id: 8, name: "Mid", team: "M", salary: 1 }], 2);
+            await flush();
+            expect(api.getData()[2].id).toBe(8);
+        }
+        finally {
+            destroy();
+        }
+    });
+    it("removeRow / removeRows drop by index", async () => {
+        const { api, destroy } = await mountGrid();
+        try {
+            api.removeRow(0);
+            await flush();
+            expect(api.getData().map((r) => r.id)).toEqual([2, 3, 4, 5]);
+            api.removeRows([0, 2]); // drops ids 2 and 4
+            await flush();
+            expect(api.getData().map((r) => r.id)).toEqual([3, 5]);
+        }
+        finally {
+            destroy();
+        }
+    });
+    it("applyTransaction adds, updates (by id), and removes; returns counts", async () => {
+        const { api, destroy } = await mountGrid();
+        try {
+            const result = api.applyTransaction({
+                add: [{ id: 9, name: "Added", team: "X", salary: 1 }],
+                update: [
+                    { id: 2, name: "Grace H.", team: "Compilers", salary: 999 },
+                ],
+                remove: ["3"], // by getRowId string
+            });
+            await flush();
+            expect(result).toEqual({ added: 1, updated: 1, removed: 1 });
+            const data = api.getData();
+            expect(data.find((r) => r.id === 3)).toBeUndefined();
+            expect(data.find((r) => r.id === 2).salary).toBe(999);
+            expect(data.find((r) => r.id === 9)).toBeTruthy();
+        }
+        finally {
+            destroy();
+        }
+    });
+    it("applyTransaction removes by object reference too", async () => {
+        const { api, destroy } = await mountGrid();
+        try {
+            const target = api.getData()[0];
+            const result = api.applyTransaction({ remove: [target] });
+            await flush();
+            expect(result.removed).toBe(1);
+            expect(api.getData().find((r) => r === target)).toBeUndefined();
+        }
+        finally {
+            destroy();
+        }
+    });
+});
+describe("SvGridApi - column mutations", () => {
+    it("addColumn left / right / numeric position, then getColumns reflects it", async () => {
+        const { api, destroy } = await mountGrid();
+        try {
+            api.addColumn({ field: "id", header: "ID" }, "left");
+            await flush();
+            expect(api.getColumns()[0].id).toBe("id");
+            api.addColumns([{ field: "extra", header: "Extra" }], "right");
+            await flush();
+            const cols = api.getColumns();
+            expect(cols[cols.length - 1].id).toBe("extra");
+        }
+        finally {
+            destroy();
+        }
+    });
+    it("removeColumn drops a column from the visible set", async () => {
+        const { api, destroy } = await mountGrid();
+        try {
+            api.removeColumn("team");
+            await flush();
+            expect(api.getColumns().find((c) => c.id === "team")).toBeUndefined();
+        }
+        finally {
+            destroy();
+        }
+    });
+    it("setColumnVisible toggles visibility; getColumns lists hidden as visible:false", async () => {
+        const { api, destroy } = await mountGrid();
+        try {
+            api.setColumnVisible("team", false);
+            await flush();
+            expect(api.isColumnVisible("team")).toBe(false);
+            const hidden = api.getColumns().find((c) => c.id === "team");
+            expect(hidden.visible).toBe(false);
+            api.setColumnVisible("team", true);
+            await flush();
+            expect(api.isColumnVisible("team")).toBe(true);
+        }
+        finally {
+            destroy();
+        }
+    });
+    it("setColumnWidth clamps + getColumnWidths round-trips", async () => {
+        const { api, destroy } = await mountGrid();
+        try {
+            api.setColumnWidth("name", 333.7);
+            await flush();
+            expect(api.getColumnWidths().name).toBe(333);
+        }
+        finally {
+            destroy();
+        }
+    });
+    it("setColumnPinning dedupes; getColumnPinning returns copies", async () => {
+        const { api, destroy } = await mountGrid();
+        try {
+            api.setColumnPinning({ left: ["name", "name"], right: ["salary"] });
+            await flush();
+            const pin = api.getColumnPinning();
+            expect(pin.left).toEqual(["name"]);
+            expect(pin.right).toEqual(["salary"]);
+            // mutating the returned copy doesn't affect internal state
+            pin.left.push("hacked");
+            expect(api.getColumnPinning().left).toEqual(["name"]);
+        }
+        finally {
+            destroy();
+        }
+    });
+    it("setColumnOrder + getColumnOrder round-trip", async () => {
+        const { api, destroy } = await mountGrid();
+        try {
+            api.setColumnOrder(["salary", "name", "team"]);
+            await flush();
+            expect(api.getColumnOrder().slice(0, 3)).toEqual([
+                "salary",
+                "name",
+                "team",
+            ]);
+        }
+        finally {
+            destroy();
+        }
+    });
+    // Note: autosizeColumn / autosizeAllColumns are intentionally not asserted
+    // here - they measure text via real DOM layout (canvas/escape), which jsdom
+    // does not provide, so they throw in this environment. They are exercised by
+    // the demo gallery / Playwright suite per the coverage config notes.
+});
+describe("SvGridApi - facet filter", () => {
+    it("setFacetFilter narrows displayed rows; null clears it", async () => {
+        const { api, destroy } = await mountGrid();
+        try {
+            api.setFacetFilter("team", ["Research"]);
+            await flush();
+            const displayed = api.getDisplayedRows();
+            expect(displayed.every((r) => r.team === "Research")).toBe(true);
+            expect(displayed.length).toBe(2);
+            api.setFacetFilter("team", null);
+            await flush();
+            expect(api.getDisplayedRows().length).toBe(5);
+        }
+        finally {
+            destroy();
+        }
+    });
+    it("setFacetFilter with an empty array also clears", async () => {
+        const { api, destroy } = await mountGrid();
+        try {
+            api.setFacetFilter("team", ["Apollo"]);
+            await flush();
+            api.setFacetFilter("team", []);
+            await flush();
+            expect(api.getDisplayedRows().length).toBe(5);
+        }
+        finally {
+            destroy();
+        }
+    });
+});
+describe("SvGridApi - find", () => {
+    it("openFind / setFindQuery / getFindHits / closeFind", async () => {
+        const { api, destroy } = await mountGrid();
+        try {
+            api.openFind();
+            api.setFindQuery("Research");
+            await flush();
+            const hits = api.getFindHits();
+            expect(Array.isArray(hits)).toBe(true);
+            // two cells contain "Research"
+            expect(hits.length).toBeGreaterThanOrEqual(2);
+            api.closeFind();
+            await flush();
+            expect(api.getFindHits()).toEqual([]);
+        }
+        finally {
+            destroy();
+        }
+    });
+});
+describe("SvGridApi - undo / redo / history", () => {
+    it("canUndo is false before any history; undo/redo are no-ops then", async () => {
+        const { api, destroy } = await mountGrid();
+        try {
+            expect(api.canUndo()).toBe(false);
+            expect(api.canRedo()).toBe(false);
+            expect(api.undo()).toBe(false);
+            expect(api.redo()).toBe(false);
+        }
+        finally {
+            destroy();
+        }
+    });
+    it("clearHistory resets the stacks without throwing", async () => {
+        const { api, destroy } = await mountGrid();
+        try {
+            expect(() => api.clearHistory()).not.toThrow();
+            expect(api.canUndo()).toBe(false);
+            expect(api.canRedo()).toBe(false);
+        }
+        finally {
+            destroy();
+        }
+    });
+});
+describe("SvGridApi - grouping / expansion", () => {
+    it("setGroupBy groups rows; the underlying data is unchanged", async () => {
+        const { api, destroy } = await mountGrid();
+        try {
+            api.setGroupBy(["team"]);
+            await flush();
+            // Grouping reshapes the display pipeline; the source data is intact.
+            expect(api.getData().length).toBe(5);
+            expect(api.getState().grouping).toContain("team");
+        }
+        finally {
+            destroy();
+        }
+    });
+    it("expandAllGroups / collapseAllGroups run without error", async () => {
+        const { api, destroy } = await mountGrid();
+        try {
+            api.setGroupBy(["team"]);
+            await flush();
+            expect(() => api.expandAllGroups()).not.toThrow();
+            await flush();
+            expect(() => api.collapseAllGroups()).not.toThrow();
+            await flush();
+            // un-group
+            api.setGroupBy([]);
+            await flush();
+            expect(api.getData().length).toBe(5);
+        }
+        finally {
+            destroy();
+        }
+    });
+    it("setRowExpanded toggles a row's expanded flag", async () => {
+        const { api, destroy } = await mountGrid();
+        try {
+            expect(() => api.setRowExpanded("1", true)).not.toThrow();
+            await flush();
+            expect(() => api.setRowExpanded("1", false)).not.toThrow();
+        }
+        finally {
+            destroy();
+        }
+    });
+});
+describe("SvGridApi - sort opt-out + refresh", () => {
+    it("setSort with a direction sets a single active clause", async () => {
+        const { api, destroy } = await mountGrid();
+        try {
+            api.setSort("salary", "asc");
+            await flush();
+            expect(api.getState().sorting).toEqual([{ id: "salary", desc: false }]);
+            api.setSort("name", "desc");
+            await flush();
+            // Setting a direction replaces the active sort clause.
+            expect(api.getState().sorting).toEqual([{ id: "name", desc: true }]);
+        }
+        finally {
+            destroy();
+        }
+    });
+    it("setSort with a falsy direction removes that column's clause", async () => {
+        const { api, destroy } = await mountGrid();
+        try {
+            api.setSort("salary", "asc");
+            await flush();
+            api.setSort("salary", null);
+            await flush();
+            expect(api.getState().sorting.find((s) => s.id === "salary")).toBeUndefined();
+        }
+        finally {
+            destroy();
+        }
+    });
+    it("setSort is ignored for a non-sortable column", async () => {
+        const { api, destroy } = await mountGrid({
+            columns: [
+                { field: "name", header: "Name", width: 200, sortable: false },
+                { field: "team", header: "Team", width: 160 },
+            ],
+        });
+        try {
+            api.setSort("name", "asc");
+            await flush();
+            expect(api.getState().sorting.find((s) => s.id === "name")).toBeUndefined();
+        }
+        finally {
+            destroy();
+        }
+    });
+    it("refresh re-runs the pipeline without throwing or losing data", async () => {
+        const { api, destroy } = await mountGrid();
+        try {
+            expect(() => api.refresh()).not.toThrow();
+            await flush();
+            expect(api.getData().length).toBe(5);
+        }
+        finally {
+            destroy();
+        }
+    });
+});

package/dist/build-api.js

@@ -24,42 +24,48 @@ export function createGridApi(ctx) {
                 next[rowIndex] = { ...row, [column.columnDef.field]: value };
                 ctx.internalData = next;
             },
+            startEditing(rowIndex, columnId) {
+                return ctx.startEditing(rowIndex, columnId);
+            },
+            stopEditing(cancel) {
+                return ctx.stopEditing(cancel ?? false);
+            },
             selectCells(ranges) {
-                // Engine supports a single anchor/focus rectangle today. Honour
-                // the first entry; ignore the rest. Empty array clears.
+                // Multiple rectangles are supported. Empty array clears everything.
                 if (!ranges || ranges.length === 0) {
                     ctx.selectionRange = { anchor: null, focus: null };
+                    ctx.selectionRanges = [];
                     return;
                 }
-                const [r1, c1, r2, c2] = ranges[0];
                 const rowCount = ctx.internalData.length;
                 const colCount = ctx.allColumns.length;
                 if (rowCount === 0 || colCount === 0)
                     return;
                 // Clamp to the visible grid bounds so callers can pass open-ended
                 // values like `[0, 0, Infinity, Infinity]` to mean "select all".
-                const aRow = Math.max(0, Math.min(rowCount - 1, Math.min(r1, r2)));
-                const fRow = Math.max(0, Math.min(rowCount - 1, Math.max(r1, r2)));
-                const aCol = Math.max(0, Math.min(colCount - 1, Math.min(c1, c2)));
-                const fCol = Math.max(0, Math.min(colCount - 1, Math.max(c1, c2)));
-                ctx.selectionRange = {
-                    anchor: { rowIndex: aRow, colIndex: aCol },
-                    focus: { rowIndex: fRow, colIndex: fCol },
-                };
-                // Move the active cell to the range's top-left so keyboard
+                const toRange = ([r1, c1, r2, c2]) => ({
+                    anchor: {
+                        rowIndex: Math.max(0, Math.min(rowCount - 1, Math.min(r1, r2))),
+                        colIndex: Math.max(0, Math.min(colCount - 1, Math.min(c1, c2))),
+                    },
+                    focus: {
+                        rowIndex: Math.max(0, Math.min(rowCount - 1, Math.max(r1, r2))),
+                        colIndex: Math.max(0, Math.min(colCount - 1, Math.max(c1, c2))),
+                    },
+                });
+                const built = ranges.map(toRange);
+                // Last range is the active one; the rest are committed extras.
+                ctx.selectionRanges = built.slice(0, -1);
+                const active = built[built.length - 1];
+                ctx.selectionRange = active;
+                // Move the active cell to the last range's top-left so keyboard
                 // navigation continues from there.
-                ctx.setActiveCell(aRow, aCol);
+                ctx.setActiveCell(active.anchor.rowIndex, active.anchor.colIndex);
             },
             getSelected() {
-                const a = ctx.selectionRange.anchor;
-                const f = ctx.selectionRange.focus;
-                if (!a || !f)
-                    return [];
-                const r1 = Math.min(a.rowIndex, f.rowIndex);
-                const r2 = Math.max(a.rowIndex, f.rowIndex);
-                const c1 = Math.min(a.colIndex, f.colIndex);
-                const c2 = Math.max(a.colIndex, f.colIndex);
-                return [[r1, c1, r2, c2]];
+                return ctx
+                    .getSelectionRects()
+                    .map((r) => [r.minRow, r.minCol, r.maxRow, r.maxCol]);
             },
             addRow(row, position = "bottom") {
                 this.addRows([row], position);
@@ -190,6 +196,17 @@ export function createGridApi(ctx) {
                         ...(filter.operator === "between"
                             ? { valueTo: filter.valueTo ?? "" }
                             : {}),
+                        // Optional second condition + join (multi-condition filtering).
+                        ...(filter.operator2
+                            ? {
+                                operator2: filter.operator2,
+                                value2: filter.value2 ?? "",
+                                join: filter.join ?? "AND",
+                                ...(filter.operator2 === "between"
+                                    ? { valueTo2: filter.valueTo2 ?? "" }
+                                    : {}),
+                            }
+                            : {}),
                     },
                 };
             },
@@ -251,18 +268,31 @@ export function createGridApi(ctx) {
                 return ctx.internalData;
             },
             getColumns() {
-                // Snapshot every column in visual order with its human-readable
-                // label and visibility flag. Used by external code (exporters,
-                // column pickers) so they don't have to re-walk the columnDef
-                // tree themselves.
-                return ctx.allColumns.map((c) => ({
+                // Snapshot every column with its human-readable label and
+                // visibility flag. Used by external code (exporters, column
+                // pickers) so they don't have to re-walk the columnDef tree.
+                // Hidden columns ARE included (with `visible: false`) so a column
+                // picker can re-enable them - callers that only want what's
+                // rendered filter by `.visible` (e.g. the exporter does).
+                const describe = (c, visible) => ({
                     id: c.id,
                     field: c.columnDef.field,
                     header: typeof c.columnDef.header === "string"
                         ? c.columnDef.header
                         : c.id,
-                    visible: !ctx.hiddenColumns[c.id],
-                }));
+                    visible,
+                });
+                // Visible columns first, in their current visual order...
+                const out = ctx.allColumns.map((c) => describe(c, true));
+                // ...then any column hidden via `visible: false` / setColumnVisible.
+                // Those aren't in `allColumns` (that list is visible-only), so pull
+                // them straight from the engine's leaf set.
+                const visibleIds = new Set(out.map((c) => c.id));
+                for (const c of ctx.grid.getAllColumns()) {
+                    if (!visibleIds.has(c.id))
+                        out.push(describe(c, false));
+                }
+                return out;
             },
             clearRowSelection() {
                 // Wipe the internal selection map AND emit the change so any

package/dist/cell-render.test.d.ts

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