@gridstorm/svelte 0.1.2

package/README.md

@@ -0,0 +1,34 @@
+# @gridstorm/svelte
+
+Svelte 5 wrapper component for GridStorm.
+
+## Install
+
+```bash
+npm install @gridstorm/svelte
+```
+
+## Usage
+
+```typescript
+<script>
+  import { GridStorm } from '@gridstorm/svelte';
+</script>
+
+<GridStorm columnDefs={columns} rowData={data} plugins={plugins} />
+```
+
+## Features
+
+- **Svelte 5 runes compatible**
+- **Reactive props**
+- **Auto-cleanup on destroy**
+- **Full TypeScript support**
+
+## Documentation
+
+[Full Documentation](https://grid-data-analytics-explorer.vercel.app/) | [GitHub](https://github.com/007krcs/grid-data)
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,247 @@
+'use strict';
+
+var core = require('@gridstorm/core');
+var domRenderer = require('@gridstorm/dom-renderer');
+
+// src/gridstorm-action.ts
+function gridstormAction(container, params) {
+  let engine = null;
+  let renderer = null;
+  const unsubs = [];
+  function init() {
+    const { props, events, onReady } = params;
+    const config = {
+      columns: props.columns,
+      rowData: props.rowData,
+      plugins: props.plugins || [],
+      getRowId: props.getRowId ? (p) => props.getRowId(p.data) : void 0,
+      rowHeight: props.rowHeight,
+      headerHeight: props.headerHeight,
+      theme: props.theme
+    };
+    engine = core.createGrid(config);
+    renderer = new domRenderer.DomRenderer({
+      container,
+      engine,
+      enableCellEditing: props.enableCellEditing,
+      enableGrouping: props.enableGrouping,
+      floatingFilter: props.floatingFilter,
+      enablePagination: props.enablePagination,
+      pageSizeOptions: props.paginationPageSize ? [props.paginationPageSize] : void 0
+    });
+    renderer.mount();
+    if (props.density) {
+      container.setAttribute("data-density", props.density);
+    }
+    if (events?.onSelectionChanged) {
+      unsubs.push(
+        engine.eventBus.on("selection:changed", () => {
+          events.onSelectionChanged(engine.api.getSelectedNodes());
+        })
+      );
+    }
+    if (events?.onSortChanged) {
+      unsubs.push(
+        engine.eventBus.on("column:sort:changed", (e) => {
+          events.onSortChanged(e.sortModel || []);
+        })
+      );
+    }
+    if (events?.onFilterChanged) {
+      unsubs.push(
+        engine.eventBus.on("filter:changed", (e) => {
+          events.onFilterChanged(e.filterModel || {});
+        })
+      );
+    }
+    if (events?.onCellValueChanged) {
+      unsubs.push(
+        engine.eventBus.on("cell:valueChanged", (e) => {
+          events.onCellValueChanged(e);
+        })
+      );
+    }
+    if (events?.onRowClicked) {
+      unsubs.push(
+        engine.eventBus.on("row:clicked", (e) => {
+          events.onRowClicked(e.node);
+        })
+      );
+    }
+    if (events?.onPaginationChanged) {
+      unsubs.push(
+        engine.eventBus.on("pagination:changed", (e) => {
+          events.onPaginationChanged(e);
+        })
+      );
+    }
+    if (events?.onColumnResized) {
+      unsubs.push(
+        engine.eventBus.on("column:resized", (e) => {
+          events.onColumnResized(e);
+        })
+      );
+    }
+    requestAnimationFrame(() => {
+      if (engine) {
+        engine.eventBus.emit("grid:ready", { api: engine.api });
+        events?.onGridReady?.(engine.api);
+        onReady?.(engine.api, engine);
+      }
+    });
+  }
+  function destroy() {
+    unsubs.forEach((fn) => fn());
+    unsubs.length = 0;
+    renderer?.destroy();
+    engine?.destroy();
+    renderer = null;
+    engine = null;
+  }
+  init();
+  return {
+    /**
+     * Called by Svelte when the action parameters change.
+     * Performs incremental updates for rowData and columns changes.
+     */
+    update(newParams) {
+      if (engine && newParams.props.rowData !== params.props.rowData) {
+        engine.api.setRowData(newParams.props.rowData);
+      }
+      if (engine && newParams.props.columns !== params.props.columns) {
+        engine.api.setColumnDefs(newParams.props.columns);
+      }
+      params = newParams;
+    },
+    /**
+     * Called by Svelte when the element is removed from the DOM.
+     * Cleans up the engine, renderer, and all event subscriptions.
+     */
+    destroy
+  };
+}
+
+// src/composables/useGridApi.ts
+var currentApi = null;
+var listeners = /* @__PURE__ */ new Set();
+function setGridApi(api) {
+  currentApi = api;
+  listeners.forEach((fn) => fn(api));
+}
+function getGridApi() {
+  return currentApi;
+}
+function onGridApiChange(listener) {
+  listeners.add(listener);
+  return () => listeners.delete(listener);
+}
+
+// src/composables/useGridState.ts
+function getGridState(selector) {
+  const api = getGridApi();
+  if (!api) return void 0;
+  const state = api.getState();
+  if (!state) return void 0;
+  return selector(state);
+}
+
+// src/composables/useGridEvent.ts
+function subscribeToGridEvent(event, callback) {
+  const api = getGridApi();
+  if (!api) return () => {
+  };
+  api.addEventListener(event, callback);
+  return () => {
+    api.removeEventListener(event, callback);
+  };
+}
+
+// src/composables/useGridSelection.ts
+function getSelectedRows() {
+  const api = getGridApi();
+  if (!api) return [];
+  return api.getSelectedNodes();
+}
+function selectAll() {
+  const api = getGridApi();
+  if (!api) return;
+  api.selectAll();
+}
+function deselectAll() {
+  const api = getGridApi();
+  if (!api) return;
+  api.deselectAll();
+}
+
+// src/composables/useGridSort.ts
+function getSortModel() {
+  const api = getGridApi();
+  if (!api) return [];
+  return api.getSortModel();
+}
+function setSortModel(model) {
+  const api = getGridApi();
+  if (!api) return;
+  api.setSortModel(model);
+}
+
+// src/composables/useGridFilter.ts
+function getFilterModel() {
+  const api = getGridApi();
+  if (!api) return {};
+  return api.getFilterModel();
+}
+function setFilterModel(model) {
+  const api = getGridApi();
+  if (!api) return;
+  api.setFilterModel(model);
+}
+function setQuickFilter(text) {
+  const api = getGridApi();
+  if (!api) return;
+  api.setQuickFilter(text);
+}
+
+// src/composables/useGridPagination.ts
+function getPaginationState() {
+  const api = getGridApi();
+  if (!api) {
+    return { currentPage: 0, pageSize: 10, totalPages: 0, totalRows: 0 };
+  }
+  const state = api.getState();
+  const pagination = state.pagination;
+  const totalPages = Math.max(
+    1,
+    Math.ceil(pagination.totalRows / pagination.pageSize)
+  );
+  return {
+    currentPage: pagination.currentPage,
+    pageSize: pagination.pageSize,
+    totalPages,
+    totalRows: pagination.totalRows
+  };
+}
+function goToPage(page) {
+  const api = getGridApi();
+  if (!api) return;
+  api.paginationGoToPage(page);
+}
+
+exports.deselectAll = deselectAll;
+exports.getFilterModel = getFilterModel;
+exports.getGridApi = getGridApi;
+exports.getGridState = getGridState;
+exports.getPaginationState = getPaginationState;
+exports.getSelectedRows = getSelectedRows;
+exports.getSortModel = getSortModel;
+exports.goToPage = goToPage;
+exports.gridstormAction = gridstormAction;
+exports.onGridApiChange = onGridApiChange;
+exports.selectAll = selectAll;
+exports.setFilterModel = setFilterModel;
+exports.setGridApi = setGridApi;
+exports.setQuickFilter = setQuickFilter;
+exports.setSortModel = setSortModel;
+exports.subscribeToGridEvent = subscribeToGridEvent;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/gridstorm-action.ts","../src/composables/useGridApi.ts","../src/composables/useGridState.ts","../src/composables/useGridEvent.ts","../src/composables/useGridSelection.ts","../src/composables/useGridSort.ts","../src/composables/useGridFilter.ts","../src/composables/useGridPagination.ts"],"names":["createGrid","DomRenderer"],"mappings":";;;;;;AAuEO,SAAS,eAAA,CACd,WACA,MAAA,EACA;AACA,EAAA,IAAI,MAAA,GAAmC,IAAA;AACvC,EAAA,IAAI,QAAA,GAA+B,IAAA;AACnC,EAAA,MAAM,SAA4B,EAAC;AAEnC,EAAA,SAAS,IAAA,GAAO;AACd,IAAA,MAAM,EAAE,KAAA,EAAO,MAAA,EAAQ,OAAA,EAAQ,GAAI,MAAA;AAGnC,IAAA,MAAM,MAAA,GAA4B;AAAA,MAChC,SAAS,KAAA,CAAM,OAAA;AAAA,MACf,SAAS,KAAA,CAAM,OAAA;AAAA,MACf,OAAA,EAAS,KAAA,CAAM,OAAA,IAAW,EAAC;AAAA,MAC3B,QAAA,EAAU,MAAM,QAAA,GACZ,CAAC,MAAM,KAAA,CAAM,QAAA,CAAU,CAAA,CAAE,IAAI,CAAA,GAC7B,MAAA;AAAA,MACJ,WAAW,KAAA,CAAM,SAAA;AAAA,MACjB,cAAc,KAAA,CAAM,YAAA;AAAA,MACpB,OAAO,KAAA,CAAM;AAAA,KACf;AAGA,IAAA,MAAA,GAASA,gBAAW,MAAM,CAAA;AAG1B,IAAA,QAAA,GAAW,IAAIC,uBAAA,CAAY;AAAA,MACzB,SAAA;AAAA,MACA,MAAA;AAAA,MACA,mBAAmB,KAAA,CAAM,iBAAA;AAAA,MACzB,gBAAgB,KAAA,CAAM,cAAA;AAAA,MACtB,gBAAgB,KAAA,CAAM,cAAA;AAAA,MACtB,kBAAkB,KAAA,CAAM,gBAAA;AAAA,MACxB,iBAAiB,KAAA,CAAM,kBAAA,GACnB,CAAC,KAAA,CAAM,kBAAkB,CAAA,GACzB;AAAA,KACL,CAAA;AACD,IAAA,QAAA,CAAS,KAAA,EAAM;AAGf,IAAA,IAAI,MAAM,OAAA,EAAS;AACjB,MAAA,SAAA,CAAU,YAAA,CAAa,cAAA,EAAgB,KAAA,CAAM,OAAO,CAAA;AAAA,IACtD;AAIA,IAAA,IAAI,QAAQ,kBAAA,EAAoB;AAC9B,MAAA,MAAA,CAAO,IAAA;AAAA,QACL,MAAA,CAAO,QAAA,CAAS,EAAA,CAAG,mBAAA,EAAqB,MAAM;AAC5C,UAAA,MAAA,CAAO,kBAAA,CAAoB,MAAA,CAAQ,GAAA,CAAI,gBAAA,EAAkB,CAAA;AAAA,QAC3D,CAAC;AAAA,OACH;AAAA,IACF;AAEA,IAAA,IAAI,QAAQ,aAAA,EAAe;AACzB,MAAA,MAAA,CAAO,IAAA;AAAA,QACL,MAAA,CAAO,QAAA,CAAS,EAAA,CAAG,qBAAA,EAAuB,CAAC,CAAA,KAAW;AACpD,UAAA,MAAA,CAAO,aAAA,CAAe,CAAA,CAAE,SAAA,IAAa,EAAE,CAAA;AAAA,QACzC,CAAC;AAAA,OACH;AAAA,IACF;AAEA,IAAA,IAAI,QAAQ,eAAA,EAAiB;AAC3B,MAAA,MAAA,CAAO,IAAA;AAAA,QACL,MAAA,CAAO,QAAA,CAAS,EAAA,CAAG,gBAAA,EAAkB,CAAC,CAAA,KAAW;AAC/C,UAAA,MAAA,CAAO,eAAA,CAAiB,CAAA,CAAE,WAAA,IAAe,EAAE,CAAA;AAAA,QAC7C,CAAC;AAAA,OACH;AAAA,IACF;AAEA,IAAA,IAAI,QAAQ,kBAAA,EAAoB;AAC9B,MAAA,MAAA,CAAO,IAAA;AAAA,QACL,MAAA,CAAO,QAAA,CAAS,EAAA,CAAG,mBAAA,EAAqB,CAAC,CAAA,KAAW;AAClD,UAAA,MAAA,CAAO,mBAAoB,CAAC,CAAA;AAAA,QAC9B,CAAC;AAAA,OACH;AAAA,IACF;AAEA,IAAA,IAAI,QAAQ,YAAA,EAAc;AACxB,MAAA,MAAA,CAAO,IAAA;AAAA,QACL,MAAA,CAAO,QAAA,CAAS,EAAA,CAAG,aAAA,EAAe,CAAC,CAAA,KAAW;AAC5C,UAAA,MAAA,CAAO,YAAA,CAAc,EAAE,IAAI,CAAA;AAAA,QAC7B,CAAC;AAAA,OACH;AAAA,IACF;AAEA,IAAA,IAAI,QAAQ,mBAAA,EAAqB;AAC/B,MAAA,MAAA,CAAO,IAAA;AAAA,QACL,MAAA,CAAO,QAAA,CAAS,EAAA,CAAG,oBAAA,EAAsB,CAAC,CAAA,KAAW;AACnD,UAAA,MAAA,CAAO,oBAAqB,CAAC,CAAA;AAAA,QAC/B,CAAC;AAAA,OACH;AAAA,IACF;AAEA,IAAA,IAAI,QAAQ,eAAA,EAAiB;AAC3B,MAAA,MAAA,CAAO,IAAA;AAAA,QACL,MAAA,CAAO,QAAA,CAAS,EAAA,CAAG,gBAAA,EAAkB,CAAC,CAAA,KAAW;AAC/C,UAAA,MAAA,CAAO,gBAAiB,CAAC,CAAA;AAAA,QAC3B,CAAC;AAAA,OACH;AAAA,IACF;AAKA,IAAA,qBAAA,CAAsB,MAAM;AAC1B,MAAA,IAAI,MAAA,EAAQ;AACV,QAAA,MAAA,CAAO,SAAS,IAAA,CAAK,YAAA,EAAc,EAAE,GAAA,EAAK,MAAA,CAAO,KAAK,CAAA;AACtD,QAAA,MAAA,EAAQ,WAAA,GAAc,OAAO,GAAG,CAAA;AAChC,QAAA,OAAA,GAAU,MAAA,CAAO,KAAK,MAAM,CAAA;AAAA,MAC9B;AAAA,IACF,CAAC,CAAA;AAAA,EACH;AAEA,EAAA,SAAS,OAAA,GAAU;AACjB,IAAA,MAAA,CAAO,OAAA,CAAQ,CAAC,EAAA,KAAO,EAAA,EAAI,CAAA;AAC3B,IAAA,MAAA,CAAO,MAAA,GAAS,CAAA;AAChB,IAAA,QAAA,EAAU,OAAA,EAAQ;AAClB,IAAA,MAAA,EAAQ,OAAA,EAAQ;AAChB,IAAA,QAAA,GAAW,IAAA;AACX,IAAA,MAAA,GAAS,IAAA;AAAA,EACX;AAGA,EAAA,IAAA,EAAK;AAGL,EAAA,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA,IAKL,OAAO,SAAA,EAAyC;AAC9C,MAAA,IAAI,UAAU,SAAA,CAAU,KAAA,CAAM,OAAA,KAAY,MAAA,CAAO,MAAM,OAAA,EAAS;AAC9D,QAAA,MAAA,CAAO,GAAA,CAAI,UAAA,CAAW,SAAA,CAAU,KAAA,CAAM,OAAO,CAAA;AAAA,MAC/C;AACA,MAAA,IAAI,UAAU,SAAA,CAAU,KAAA,CAAM,OAAA,KAAY,MAAA,CAAO,MAAM,OAAA,EAAS;AAC9D,QAAA,MAAA,CAAO,GAAA,CAAI,aAAA,CAAc,SAAA,CAAU,KAAA,CAAM,OAAO,CAAA;AAAA,MAClD;AACA,MAAA,MAAA,GAAS,SAAA;AAAA,IACX,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMA;AAAA,GACF;AACF;;;ACnNA,IAAI,UAAA,GAA6B,IAAA;AAGjC,IAAM,SAAA,uBAAgB,GAAA,EAAmC;AAUlD,SAAS,WAAW,GAAA,EAA2B;AACpD,EAAA,UAAA,GAAa,GAAA;AACb,EAAA,SAAA,CAAU,OAAA,CAAQ,CAAC,EAAA,KAAO,EAAA,CAAG,GAAG,CAAC,CAAA;AACnC;AAUO,SAAS,UAAA,GAAiD;AAC/D,EAAA,OAAO,UAAA;AACT;AAQO,SAAS,gBACd,QAAA,EACY;AACZ,EAAA,SAAA,CAAU,IAAI,QAAQ,CAAA;AACtB,EAAA,OAAO,MAAM,SAAA,CAAU,MAAA,CAAO,QAAQ,CAAA;AACxC;;;AC1BO,SAAS,aAAgB,QAAA,EAAkD;AAChF,EAAA,MAAM,MAAM,UAAA,EAAW;AACvB,EAAA,IAAI,CAAC,KAAK,OAAO,MAAA;AACjB,EAAA,MAAM,KAAA,GAAQ,IAAI,QAAA,EAAS;AAC3B,EAAA,IAAI,CAAC,OAAO,OAAO,MAAA;AACnB,EAAA,OAAO,SAAS,KAAK,CAAA;AACvB;;;ACKO,SAAS,oBAAA,CACd,OACA,QAAA,EACY;AACZ,EAAA,MAAM,MAAM,UAAA,EAAW;AACvB,EAAA,IAAI,CAAC,GAAA,EAAK,OAAO,MAAM;AAAA,EAAC,CAAA;AAGxB,EAAA,GAAA,CAAI,gBAAA,CAAiB,OAAc,QAAe,CAAA;AAElD,EAAA,OAAO,MAAM;AACX,IAAA,GAAA,CAAI,mBAAA,CAAoB,OAAc,QAAe,CAAA;AAAA,EACvD,CAAA;AACF;;;ACnCO,SAAS,eAAA,GAAiD;AAC/D,EAAA,MAAM,MAAM,UAAA,EAAkB;AAC9B,EAAA,IAAI,CAAC,GAAA,EAAK,OAAO,EAAC;AAClB,EAAA,OAAO,IAAI,gBAAA,EAAiB;AAC9B;AAKO,SAAS,SAAA,GAAkB;AAChC,EAAA,MAAM,MAAM,UAAA,EAAW;AACvB,EAAA,IAAI,CAAC,GAAA,EAAK;AACV,EAAA,GAAA,CAAI,SAAA,EAAU;AAChB;AAKO,SAAS,WAAA,GAAoB;AAClC,EAAA,MAAM,MAAM,UAAA,EAAW;AACvB,EAAA,IAAI,CAAC,GAAA,EAAK;AACV,EAAA,GAAA,CAAI,WAAA,EAAY;AAClB;;;ACzBO,SAAS,YAAA,GAAgC;AAC9C,EAAA,MAAM,MAAM,UAAA,EAAW;AACvB,EAAA,IAAI,CAAC,GAAA,EAAK,OAAO,EAAC;AAClB,EAAA,OAAO,IAAI,YAAA,EAAa;AAC1B;AAOO,SAAS,aAAa,KAAA,EAA8B;AACzD,EAAA,MAAM,MAAM,UAAA,EAAW;AACvB,EAAA,IAAI,CAAC,GAAA,EAAK;AACV,EAAA,GAAA,CAAI,aAAa,KAAK,CAAA;AACxB;;;ACdO,SAAS,cAAA,GAA8C;AAC5D,EAAA,MAAM,MAAM,UAAA,EAAW;AACvB,EAAA,IAAI,CAAC,GAAA,EAAK,OAAO,EAAC;AAClB,EAAA,OAAO,IAAI,cAAA,EAAe;AAC5B;AAOO,SAAS,eAAe,KAAA,EAA0C;AACvE,EAAA,MAAM,MAAM,UAAA,EAAW;AACvB,EAAA,IAAI,CAAC,GAAA,EAAK;AACV,EAAA,GAAA,CAAI,eAAe,KAAK,CAAA;AAC1B;AAOO,SAAS,eAAe,IAAA,EAAoB;AACjD,EAAA,MAAM,MAAM,UAAA,EAAW;AACvB,EAAA,IAAI,CAAC,GAAA,EAAK;AACV,EAAA,GAAA,CAAI,eAAe,IAAI,CAAA;AACzB;;;ACdO,SAAS,kBAAA,GAAsC;AACpD,EAAA,MAAM,MAAM,UAAA,EAAW;AACvB,EAAA,IAAI,CAAC,GAAA,EAAK;AACR,IAAA,OAAO,EAAE,aAAa,CAAA,EAAG,QAAA,EAAU,IAAI,UAAA,EAAY,CAAA,EAAG,WAAW,CAAA,EAAE;AAAA,EACrE;AAEA,EAAA,MAAM,KAAA,GAAQ,IAAI,QAAA,EAAS;AAC3B,EAAA,MAAM,aAAa,KAAA,CAAM,UAAA;AACzB,EAAA,MAAM,aAAa,IAAA,CAAK,GAAA;AAAA,IACtB,CAAA;AAAA,IACA,IAAA,CAAK,IAAA,CAAK,UAAA,CAAW,SAAA,GAAY,WAAW,QAAQ;AAAA,GACtD;AAEA,EAAA,OAAO;AAAA,IACL,aAAa,UAAA,CAAW,WAAA;AAAA,IACxB,UAAU,UAAA,CAAW,QAAA;AAAA,IACrB,UAAA;AAAA,IACA,WAAW,UAAA,CAAW;AAAA,GACxB;AACF;AAOO,SAAS,SAAS,IAAA,EAAoB;AAC3C,EAAA,MAAM,MAAM,UAAA,EAAW;AACvB,EAAA,IAAI,CAAC,GAAA,EAAK;AACV,EAAA,GAAA,CAAI,mBAAmB,IAAI,CAAA;AAC7B","file":"index.cjs","sourcesContent":["// ─── GridStorm Svelte Action ───\n// The core of the Svelte 5 adapter. Implements a Svelte \"action\" — a function\n// that takes a DOM element and manages the GridStorm lifecycle (create, update, destroy).\n//\n// Usage in a Svelte 5 component:\n//\n//   <script lang=\"ts\">\n//     import { gridstormAction } from '@gridstorm/svelte';\n//\n//     const columns = [{ field: 'name' }, { field: 'age' }];\n//     const rowData = [{ name: 'Alice', age: 30 }];\n//   </script>\n//\n//   <div use:gridstormAction={{ props: { columns, rowData } }} style=\"height: 400px\" />\n\nimport { createGrid } from '@gridstorm/core';\nimport type { GridEngine, GridApi, GridConfig } from '@gridstorm/core';\nimport { DomRenderer } from '@gridstorm/dom-renderer';\nimport type { GridStormProps, GridStormEventHandlers } from './types';\n\n/**\n * Parameters for the gridstormAction Svelte action.\n *\n * @typeParam TData - The type of each row data object.\n */\nexport interface GridStormActionParams<TData = any> {\n  /** Grid configuration props. */\n  props: GridStormProps<TData>;\n  /** Event handler callbacks. */\n  events?: GridStormEventHandlers<TData>;\n  /** Callback fired when the engine and API are ready. */\n  onReady?: (api: GridApi<TData>, engine: GridEngine<TData>) => void;\n}\n\n/**\n * Svelte action that creates and manages a GridStorm instance on a DOM element.\n *\n * This is the primary integration point for using GridStorm in Svelte 5.\n * It handles engine creation, DOM renderer mounting, event bridging,\n * reactive updates (rowData, columns), and cleanup on destroy.\n *\n * @param container - The DOM element to mount the grid into.\n * @param params - Configuration including props, event handlers, and ready callback.\n * @returns A Svelte action interface with `update` and `destroy` methods.\n *\n * @example\n * ```svelte\n * <script lang=\"ts\">\n *   import { gridstormAction } from '@gridstorm/svelte';\n *   import { sortingPlugin } from '@gridstorm/plugin-sorting';\n *\n *   let api = $state(null);\n *   const columns = [\n *     { field: 'name', headerName: 'Name', sortable: true },\n *     { field: 'age', headerName: 'Age', width: 100 },\n *   ];\n *   const rowData = [\n *     { name: 'Alice', age: 30 },\n *     { name: 'Bob', age: 25 },\n *   ];\n * </script>\n *\n * <div\n *   use:gridstormAction={{\n *     props: { columns, rowData, plugins: [sortingPlugin()] },\n *     onReady: (gridApi) => { api = gridApi; },\n *   }}\n *   style=\"height: 400px\"\n * />\n * ```\n */\nexport function gridstormAction<TData = any>(\n  container: HTMLElement,\n  params: GridStormActionParams<TData>,\n) {\n  let engine: GridEngine<TData> | null = null;\n  let renderer: DomRenderer | null = null;\n  const unsubs: Array<() => void> = [];\n\n  function init() {\n    const { props, events, onReady } = params;\n\n    // Build grid config from props\n    const config: GridConfig<TData> = {\n      columns: props.columns,\n      rowData: props.rowData,\n      plugins: props.plugins || [],\n      getRowId: props.getRowId\n        ? (p) => props.getRowId!(p.data)\n        : undefined,\n      rowHeight: props.rowHeight,\n      headerHeight: props.headerHeight,\n      theme: props.theme,\n    };\n\n    // Create the headless grid engine\n    engine = createGrid(config);\n\n    // Create and mount the DOM renderer\n    renderer = new DomRenderer({\n      container,\n      engine,\n      enableCellEditing: props.enableCellEditing,\n      enableGrouping: props.enableGrouping,\n      floatingFilter: props.floatingFilter,\n      enablePagination: props.enablePagination,\n      pageSizeOptions: props.paginationPageSize\n        ? [props.paginationPageSize]\n        : undefined,\n    });\n    renderer.mount();\n\n    // Apply density as a data attribute on the container\n    if (props.density) {\n      container.setAttribute('data-density', props.density);\n    }\n\n    // ── Event bridge: core events -> Svelte callbacks ──\n\n    if (events?.onSelectionChanged) {\n      unsubs.push(\n        engine.eventBus.on('selection:changed', () => {\n          events.onSelectionChanged!(engine!.api.getSelectedNodes());\n        }),\n      );\n    }\n\n    if (events?.onSortChanged) {\n      unsubs.push(\n        engine.eventBus.on('column:sort:changed', (e: any) => {\n          events.onSortChanged!(e.sortModel || []);\n        }),\n      );\n    }\n\n    if (events?.onFilterChanged) {\n      unsubs.push(\n        engine.eventBus.on('filter:changed', (e: any) => {\n          events.onFilterChanged!(e.filterModel || {});\n        }),\n      );\n    }\n\n    if (events?.onCellValueChanged) {\n      unsubs.push(\n        engine.eventBus.on('cell:valueChanged', (e: any) => {\n          events.onCellValueChanged!(e);\n        }),\n      );\n    }\n\n    if (events?.onRowClicked) {\n      unsubs.push(\n        engine.eventBus.on('row:clicked', (e: any) => {\n          events.onRowClicked!(e.node);\n        }),\n      );\n    }\n\n    if (events?.onPaginationChanged) {\n      unsubs.push(\n        engine.eventBus.on('pagination:changed', (e: any) => {\n          events.onPaginationChanged!(e);\n        }),\n      );\n    }\n\n    if (events?.onColumnResized) {\n      unsubs.push(\n        engine.eventBus.on('column:resized', (e: any) => {\n          events.onColumnResized!(e);\n        }),\n      );\n    }\n\n    // Fire grid:ready after the renderer has mounted and DOM is populated.\n    // Plugins like column-resize and context-menu use rAF on grid:ready to\n    // inject DOM elements, so we re-emit after the renderer is in the DOM.\n    requestAnimationFrame(() => {\n      if (engine) {\n        engine.eventBus.emit('grid:ready', { api: engine.api });\n        events?.onGridReady?.(engine.api);\n        onReady?.(engine.api, engine);\n      }\n    });\n  }\n\n  function destroy() {\n    unsubs.forEach((fn) => fn());\n    unsubs.length = 0;\n    renderer?.destroy();\n    engine?.destroy();\n    renderer = null;\n    engine = null;\n  }\n\n  // Initialize the grid\n  init();\n\n  // Return the Svelte action interface\n  return {\n    /**\n     * Called by Svelte when the action parameters change.\n     * Performs incremental updates for rowData and columns changes.\n     */\n    update(newParams: GridStormActionParams<TData>) {\n      if (engine && newParams.props.rowData !== params.props.rowData) {\n        engine.api.setRowData(newParams.props.rowData);\n      }\n      if (engine && newParams.props.columns !== params.props.columns) {\n        engine.api.setColumnDefs(newParams.props.columns);\n      }\n      params = newParams;\n    },\n\n    /**\n     * Called by Svelte when the element is removed from the DOM.\n     * Cleans up the engine, renderer, and all event subscriptions.\n     */\n    destroy,\n  };\n}\n","// ─── Grid API Store ───\n// Lightweight store for the current GridApi reference.\n// In Svelte 5, there is no provide/inject like Vue or React context.\n// Instead, this module-level store allows any component to access the\n// grid API after initialization. Call setGridApi from the onReady callback\n// and getGridApi from anywhere in your component tree.\n\nimport type { GridApi } from '@gridstorm/core';\n\n/** Module-level reference to the current grid API. */\nlet currentApi: GridApi | null = null;\n\n/** Set of listeners notified when the API changes. */\nconst listeners = new Set<(api: GridApi | null) => void>();\n\n/**\n * Set the current grid API reference.\n *\n * Call this from the `onReady` callback of `gridstormAction` to make\n * the API available to composable helper functions.\n *\n * @param api - The grid API instance, or `null` to clear it.\n */\nexport function setGridApi(api: GridApi | null): void {\n  currentApi = api;\n  listeners.forEach((fn) => fn(api));\n}\n\n/**\n * Get the current grid API reference.\n *\n * Returns `null` if the grid has not been initialized yet or has been destroyed.\n *\n * @typeParam TData - The type of each row data object.\n * @returns The current GridApi instance, or `null`.\n */\nexport function getGridApi<TData = any>(): GridApi<TData> | null {\n  return currentApi as GridApi<TData> | null;\n}\n\n/**\n * Register a listener that is called whenever the grid API changes.\n *\n * @param listener - Callback invoked with the new API (or `null` on destroy).\n * @returns An unsubscribe function.\n */\nexport function onGridApiChange(\n  listener: (api: GridApi | null) => void,\n): () => void {\n  listeners.add(listener);\n  return () => listeners.delete(listener);\n}\n","// ─── Grid State Accessor ───\n// Provides direct access to the grid store state via a selector function.\n\nimport type { GridState } from '@gridstorm/core';\nimport { getGridApi } from './useGridApi';\n\n/**\n * Read a slice of the grid store state using a selector function.\n *\n * Returns `undefined` if the grid has not been initialized yet.\n * This function reads state synchronously (snapshot) and does not\n * set up a reactive subscription. For reactive state in Svelte 5,\n * subscribe to grid events or use `$effect` with periodic polling.\n *\n * @typeParam T - The type of the selected state slice.\n * @param selector - A function that extracts a value from the grid state.\n * @returns The selected state value, or `undefined` if not available.\n *\n * @example\n * ```ts\n * import { getGridState } from '@gridstorm/svelte';\n *\n * const sortModel = getGridState((state) => state.sortModel);\n * ```\n */\nexport function getGridState<T>(selector: (state: GridState) => T): T | undefined {\n  const api = getGridApi();\n  if (!api) return undefined;\n  const state = api.getState();\n  if (!state) return undefined;\n  return selector(state);\n}\n","// ─── Grid Event Subscription ───\n// Provides a helper to subscribe to grid events from Svelte components.\n\nimport type { GridEventMap } from '@gridstorm/core';\nimport { getGridApi } from './useGridApi';\n\n/**\n * Subscribe to a grid event by name.\n *\n * Returns an unsubscribe function. If the grid has not been initialized yet,\n * returns a no-op unsubscribe function.\n *\n * In Svelte 5, call this inside `$effect` or `onMount` and clean up\n * the subscription in the effect's cleanup or `onDestroy`.\n *\n * @typeParam K - The event key from GridEventMap.\n * @param event - The event name to listen for.\n * @param callback - Callback invoked when the event fires.\n * @returns An unsubscribe function.\n *\n * @example\n * ```svelte\n * <script lang=\"ts\">\n *   import { onMount, onDestroy } from 'svelte';\n *   import { subscribeToGridEvent } from '@gridstorm/svelte';\n *\n *   let unsub: () => void;\n *   onMount(() => {\n *     unsub = subscribeToGridEvent('selection:changed', (e) => {\n *       console.log('Selection changed:', e);\n *     });\n *   });\n *   onDestroy(() => unsub?.());\n * </script>\n * ```\n */\nexport function subscribeToGridEvent<K extends string & keyof GridEventMap>(\n  event: K,\n  callback: (payload: GridEventMap[K]) => void,\n): () => void {\n  const api = getGridApi();\n  if (!api) return () => {};\n\n  // Access the engine's event bus through the API's addEventListener\n  api.addEventListener(event as any, callback as any);\n\n  return () => {\n    api.removeEventListener(event as any, callback as any);\n  };\n}\n","// ─── Grid Selection Helpers ───\n// Convenience functions for managing row selection in Svelte components.\n\nimport type { RowNode } from '@gridstorm/core';\nimport { getGridApi } from './useGridApi';\n\n/**\n * Get the currently selected row nodes.\n *\n * Returns an empty array if the grid has not been initialized yet.\n *\n * @typeParam TData - The type of each row data object.\n * @returns Array of selected RowNode objects.\n */\nexport function getSelectedRows<TData = any>(): RowNode<TData>[] {\n  const api = getGridApi<TData>();\n  if (!api) return [];\n  return api.getSelectedNodes();\n}\n\n/**\n * Select all rows that pass the current filter.\n */\nexport function selectAll(): void {\n  const api = getGridApi();\n  if (!api) return;\n  api.selectAll();\n}\n\n/**\n * Deselect all currently selected rows.\n */\nexport function deselectAll(): void {\n  const api = getGridApi();\n  if (!api) return;\n  api.deselectAll();\n}\n","// ─── Grid Sort Helpers ───\n// Convenience functions for managing sort state in Svelte components.\n\nimport type { SortModelItem } from '@gridstorm/core';\nimport { getGridApi } from './useGridApi';\n\n/**\n * Get the current sort model.\n *\n * @returns Array of active sort items, or an empty array if not available.\n */\nexport function getSortModel(): SortModelItem[] {\n  const api = getGridApi();\n  if (!api) return [];\n  return api.getSortModel();\n}\n\n/**\n * Set the sort model, replacing any existing sort configuration.\n *\n * @param model - Array of sort items specifying column and direction.\n */\nexport function setSortModel(model: SortModelItem[]): void {\n  const api = getGridApi();\n  if (!api) return;\n  api.setSortModel(model);\n}\n","// ─── Grid Filter Helpers ───\n// Convenience functions for managing filter state in Svelte components.\n\nimport type { FilterModel } from '@gridstorm/core';\nimport { getGridApi } from './useGridApi';\n\n/**\n * Get the current filter model for all columns.\n *\n * @returns Object keyed by column ID with active filter models,\n *          or an empty object if not available.\n */\nexport function getFilterModel(): Record<string, FilterModel> {\n  const api = getGridApi();\n  if (!api) return {};\n  return api.getFilterModel();\n}\n\n/**\n * Set the filter model, replacing all active filters.\n *\n * @param model - Object keyed by column ID with filter models.\n */\nexport function setFilterModel(model: Record<string, FilterModel>): void {\n  const api = getGridApi();\n  if (!api) return;\n  api.setFilterModel(model);\n}\n\n/**\n * Apply a quick filter across all columns.\n *\n * @param text - The filter text. Pass an empty string to clear.\n */\nexport function setQuickFilter(text: string): void {\n  const api = getGridApi();\n  if (!api) return;\n  api.setQuickFilter(text);\n}\n","// ─── Grid Pagination Helpers ───\n// Convenience functions for managing pagination in Svelte components.\n\nimport { getGridApi } from './useGridApi';\n\n/**\n * Pagination state snapshot.\n */\nexport interface PaginationState {\n  /** Current page (zero-based). */\n  currentPage: number;\n  /** Rows per page. */\n  pageSize: number;\n  /** Total number of pages. */\n  totalPages: number;\n  /** Total row count. */\n  totalRows: number;\n}\n\n/**\n * Get the current pagination state.\n *\n * @returns A snapshot of pagination state, or defaults if not available.\n */\nexport function getPaginationState(): PaginationState {\n  const api = getGridApi();\n  if (!api) {\n    return { currentPage: 0, pageSize: 10, totalPages: 0, totalRows: 0 };\n  }\n\n  const state = api.getState();\n  const pagination = state.pagination;\n  const totalPages = Math.max(\n    1,\n    Math.ceil(pagination.totalRows / pagination.pageSize),\n  );\n\n  return {\n    currentPage: pagination.currentPage,\n    pageSize: pagination.pageSize,\n    totalPages,\n    totalRows: pagination.totalRows,\n  };\n}\n\n/**\n * Navigate to a specific page (zero-based index).\n *\n * @param page - The zero-based page number to navigate to.\n */\nexport function goToPage(page: number): void {\n  const api = getGridApi();\n  if (!api) return;\n  api.paginationGoToPage(page);\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,312 @@
+import { ColumnDef, GridPlugin, GridApi, RowNode, GridEngine, GridState, GridEventMap, SortModelItem, FilterModel } from '@gridstorm/core';
+export { CellEditorDef, CellPosition, ColumnDef, ColumnState, EditingState, FilterModel, GridApi, GridConfig, GridEventMap, GridPlugin, GridState, PinnedPosition, RowNode, SelectionState, SortDirection, SortModelItem } from '@gridstorm/core';
+
+/**
+ * Props for the GridStorm Svelte action.
+ *
+ * Defines column structure, row data, plugins, and behavioral options
+ * for configuring a GridStorm instance within a Svelte component.
+ *
+ * @typeParam TData - The type of each row data object.
+ */
+interface GridStormProps<TData = any> {
+    /** Column definitions. */
+    columns: ColumnDef<TData>[];
+    /** Row data array. */
+    rowData: TData[];
+    /** Plugins to install. */
+    plugins?: GridPlugin<TData>[];
+    /** Row ID getter function. */
+    getRowId?: (data: TData) => string;
+    /** Row height in pixels. */
+    rowHeight?: number;
+    /** Header height in pixels. */
+    headerHeight?: number;
+    /** Theme identifier (e.g., 'light', 'dark'). */
+    theme?: string;
+    /** Density mode. */
+    density?: 'compact' | 'normal' | 'comfortable';
+    /** Container height. */
+    height?: string | number;
+    /** Container width. */
+    width?: string | number;
+    /** Additional CSS class for the container. */
+    containerClass?: string;
+    /** Enable inline cell editing overlay. */
+    enableCellEditing?: boolean;
+    /** Enable row grouping visual (chevron, indent, group label). */
+    enableGrouping?: boolean;
+    /** Show floating filter inputs below the header. */
+    floatingFilter?: boolean;
+    /** Show pagination bar below the grid. */
+    enablePagination?: boolean;
+    /** Number of rows per page when pagination is enabled. */
+    paginationPageSize?: number;
+}
+/**
+ * Context value exposing the grid engine and API.
+ *
+ * @typeParam TData - The type of each row data object.
+ */
+interface GridStormContext<TData = any> {
+    /** Get the GridApi instance, or null if not yet initialized. */
+    getApi(): GridApi<TData> | null;
+    /** Get the GridEngine instance, or null if not yet initialized. */
+    getEngine(): GridEngine<TData> | null;
+}
+/**
+ * Event handler callbacks for the GridStorm Svelte action.
+ *
+ * @typeParam TData - The type of each row data object.
+ */
+interface GridStormEventHandlers<TData = any> {
+    /** Fired when the grid engine is ready and the API is available. */
+    onGridReady?: (api: GridApi<TData>) => void;
+    /** Fired when the selection changes. */
+    onSelectionChanged?: (selectedNodes: RowNode<TData>[]) => void;
+    /** Fired when the sort model changes. */
+    onSortChanged?: (sortModel: any[]) => void;
+    /** Fired when the filter model changes. */
+    onFilterChanged?: (filterModel: Record<string, any>) => void;
+    /** Fired when a cell value is changed via editing. */
+    onCellValueChanged?: (params: {
+        rowId: string;
+        field: string;
+        oldValue: any;
+        newValue: any;
+    }) => void;
+    /** Fired when a row is clicked. */
+    onRowClicked?: (node: RowNode<TData>) => void;
+    /** Fired when pagination state changes. */
+    onPaginationChanged?: (params: {
+        currentPage: number;
+        pageSize: number;
+        totalRows: number;
+    }) => void;
+    /** Fired when a column is resized. */
+    onColumnResized?: (params: {
+        colId: string;
+        width: number;
+    }) => void;
+}
+
+/**
+ * Parameters for the gridstormAction Svelte action.
+ *
+ * @typeParam TData - The type of each row data object.
+ */
+interface GridStormActionParams<TData = any> {
+    /** Grid configuration props. */
+    props: GridStormProps<TData>;
+    /** Event handler callbacks. */
+    events?: GridStormEventHandlers<TData>;
+    /** Callback fired when the engine and API are ready. */
+    onReady?: (api: GridApi<TData>, engine: GridEngine<TData>) => void;
+}
+/**
+ * Svelte action that creates and manages a GridStorm instance on a DOM element.
+ *
+ * This is the primary integration point for using GridStorm in Svelte 5.
+ * It handles engine creation, DOM renderer mounting, event bridging,
+ * reactive updates (rowData, columns), and cleanup on destroy.
+ *
+ * @param container - The DOM element to mount the grid into.
+ * @param params - Configuration including props, event handlers, and ready callback.
+ * @returns A Svelte action interface with `update` and `destroy` methods.
+ *
+ * @example
+ * ```svelte
+ * <script lang="ts">
+ *   import { gridstormAction } from '@gridstorm/svelte';
+ *   import { sortingPlugin } from '@gridstorm/plugin-sorting';
+ *
+ *   let api = $state(null);
+ *   const columns = [
+ *     { field: 'name', headerName: 'Name', sortable: true },
+ *     { field: 'age', headerName: 'Age', width: 100 },
+ *   ];
+ *   const rowData = [
+ *     { name: 'Alice', age: 30 },
+ *     { name: 'Bob', age: 25 },
+ *   ];
+ * </script>
+ *
+ * <div
+ *   use:gridstormAction={{
+ *     props: { columns, rowData, plugins: [sortingPlugin()] },
+ *     onReady: (gridApi) => { api = gridApi; },
+ *   }}
+ *   style="height: 400px"
+ * />
+ * ```
+ */
+declare function gridstormAction<TData = any>(container: HTMLElement, params: GridStormActionParams<TData>): {
+    /**
+     * Called by Svelte when the action parameters change.
+     * Performs incremental updates for rowData and columns changes.
+     */
+    update(newParams: GridStormActionParams<TData>): void;
+    /**
+     * Called by Svelte when the element is removed from the DOM.
+     * Cleans up the engine, renderer, and all event subscriptions.
+     */
+    destroy: () => void;
+};
+
+/**
+ * Set the current grid API reference.
+ *
+ * Call this from the `onReady` callback of `gridstormAction` to make
+ * the API available to composable helper functions.
+ *
+ * @param api - The grid API instance, or `null` to clear it.
+ */
+declare function setGridApi(api: GridApi | null): void;
+/**
+ * Get the current grid API reference.
+ *
+ * Returns `null` if the grid has not been initialized yet or has been destroyed.
+ *
+ * @typeParam TData - The type of each row data object.
+ * @returns The current GridApi instance, or `null`.
+ */
+declare function getGridApi<TData = any>(): GridApi<TData> | null;
+/**
+ * Register a listener that is called whenever the grid API changes.
+ *
+ * @param listener - Callback invoked with the new API (or `null` on destroy).
+ * @returns An unsubscribe function.
+ */
+declare function onGridApiChange(listener: (api: GridApi | null) => void): () => void;
+
+/**
+ * Read a slice of the grid store state using a selector function.
+ *
+ * Returns `undefined` if the grid has not been initialized yet.
+ * This function reads state synchronously (snapshot) and does not
+ * set up a reactive subscription. For reactive state in Svelte 5,
+ * subscribe to grid events or use `$effect` with periodic polling.
+ *
+ * @typeParam T - The type of the selected state slice.
+ * @param selector - A function that extracts a value from the grid state.
+ * @returns The selected state value, or `undefined` if not available.
+ *
+ * @example
+ * ```ts
+ * import { getGridState } from '@gridstorm/svelte';
+ *
+ * const sortModel = getGridState((state) => state.sortModel);
+ * ```
+ */
+declare function getGridState<T>(selector: (state: GridState) => T): T | undefined;
+
+/**
+ * Subscribe to a grid event by name.
+ *
+ * Returns an unsubscribe function. If the grid has not been initialized yet,
+ * returns a no-op unsubscribe function.
+ *
+ * In Svelte 5, call this inside `$effect` or `onMount` and clean up
+ * the subscription in the effect's cleanup or `onDestroy`.
+ *
+ * @typeParam K - The event key from GridEventMap.
+ * @param event - The event name to listen for.
+ * @param callback - Callback invoked when the event fires.
+ * @returns An unsubscribe function.
+ *
+ * @example
+ * ```svelte
+ * <script lang="ts">
+ *   import { onMount, onDestroy } from 'svelte';
+ *   import { subscribeToGridEvent } from '@gridstorm/svelte';
+ *
+ *   let unsub: () => void;
+ *   onMount(() => {
+ *     unsub = subscribeToGridEvent('selection:changed', (e) => {
+ *       console.log('Selection changed:', e);
+ *     });
+ *   });
+ *   onDestroy(() => unsub?.());
+ * </script>
+ * ```
+ */
+declare function subscribeToGridEvent<K extends string & keyof GridEventMap>(event: K, callback: (payload: GridEventMap[K]) => void): () => void;
+
+/**
+ * Get the currently selected row nodes.
+ *
+ * Returns an empty array if the grid has not been initialized yet.
+ *
+ * @typeParam TData - The type of each row data object.
+ * @returns Array of selected RowNode objects.
+ */
+declare function getSelectedRows<TData = any>(): RowNode<TData>[];
+/**
+ * Select all rows that pass the current filter.
+ */
+declare function selectAll(): void;
+/**
+ * Deselect all currently selected rows.
+ */
+declare function deselectAll(): void;
+
+/**
+ * Get the current sort model.
+ *
+ * @returns Array of active sort items, or an empty array if not available.
+ */
+declare function getSortModel(): SortModelItem[];
+/**
+ * Set the sort model, replacing any existing sort configuration.
+ *
+ * @param model - Array of sort items specifying column and direction.
+ */
+declare function setSortModel(model: SortModelItem[]): void;
+
+/**
+ * Get the current filter model for all columns.
+ *
+ * @returns Object keyed by column ID with active filter models,
+ *          or an empty object if not available.
+ */
+declare function getFilterModel(): Record<string, FilterModel>;
+/**
+ * Set the filter model, replacing all active filters.
+ *
+ * @param model - Object keyed by column ID with filter models.
+ */
+declare function setFilterModel(model: Record<string, FilterModel>): void;
+/**
+ * Apply a quick filter across all columns.
+ *
+ * @param text - The filter text. Pass an empty string to clear.
+ */
+declare function setQuickFilter(text: string): void;
+
+/**
+ * Pagination state snapshot.
+ */
+interface PaginationState {
+    /** Current page (zero-based). */
+    currentPage: number;
+    /** Rows per page. */
+    pageSize: number;
+    /** Total number of pages. */
+    totalPages: number;
+    /** Total row count. */
+    totalRows: number;
+}
+/**
+ * Get the current pagination state.
+ *
+ * @returns A snapshot of pagination state, or defaults if not available.
+ */
+declare function getPaginationState(): PaginationState;
+/**
+ * Navigate to a specific page (zero-based index).
+ *
+ * @param page - The zero-based page number to navigate to.
+ */
+declare function goToPage(page: number): void;
+
+export { type GridStormActionParams, type GridStormContext, type GridStormEventHandlers, type GridStormProps, type PaginationState, deselectAll, getFilterModel, getGridApi, getGridState, getPaginationState, getSelectedRows, getSortModel, goToPage, gridstormAction, onGridApiChange, selectAll, setFilterModel, setGridApi, setQuickFilter, setSortModel, subscribeToGridEvent };

package/dist/index.d.ts

@@ -0,0 +1,312 @@
+import { ColumnDef, GridPlugin, GridApi, RowNode, GridEngine, GridState, GridEventMap, SortModelItem, FilterModel } from '@gridstorm/core';
+export { CellEditorDef, CellPosition, ColumnDef, ColumnState, EditingState, FilterModel, GridApi, GridConfig, GridEventMap, GridPlugin, GridState, PinnedPosition, RowNode, SelectionState, SortDirection, SortModelItem } from '@gridstorm/core';
+
+/**
+ * Props for the GridStorm Svelte action.
+ *
+ * Defines column structure, row data, plugins, and behavioral options
+ * for configuring a GridStorm instance within a Svelte component.
+ *
+ * @typeParam TData - The type of each row data object.
+ */
+interface GridStormProps<TData = any> {
+    /** Column definitions. */
+    columns: ColumnDef<TData>[];
+    /** Row data array. */
+    rowData: TData[];
+    /** Plugins to install. */
+    plugins?: GridPlugin<TData>[];
+    /** Row ID getter function. */
+    getRowId?: (data: TData) => string;
+    /** Row height in pixels. */
+    rowHeight?: number;
+    /** Header height in pixels. */
+    headerHeight?: number;
+    /** Theme identifier (e.g., 'light', 'dark'). */
+    theme?: string;
+    /** Density mode. */
+    density?: 'compact' | 'normal' | 'comfortable';
+    /** Container height. */
+    height?: string | number;
+    /** Container width. */
+    width?: string | number;
+    /** Additional CSS class for the container. */
+    containerClass?: string;
+    /** Enable inline cell editing overlay. */
+    enableCellEditing?: boolean;
+    /** Enable row grouping visual (chevron, indent, group label). */
+    enableGrouping?: boolean;
+    /** Show floating filter inputs below the header. */
+    floatingFilter?: boolean;
+    /** Show pagination bar below the grid. */
+    enablePagination?: boolean;
+    /** Number of rows per page when pagination is enabled. */
+    paginationPageSize?: number;
+}
+/**
+ * Context value exposing the grid engine and API.
+ *
+ * @typeParam TData - The type of each row data object.
+ */
+interface GridStormContext<TData = any> {
+    /** Get the GridApi instance, or null if not yet initialized. */
+    getApi(): GridApi<TData> | null;
+    /** Get the GridEngine instance, or null if not yet initialized. */
+    getEngine(): GridEngine<TData> | null;
+}
+/**
+ * Event handler callbacks for the GridStorm Svelte action.
+ *
+ * @typeParam TData - The type of each row data object.
+ */
+interface GridStormEventHandlers<TData = any> {
+    /** Fired when the grid engine is ready and the API is available. */
+    onGridReady?: (api: GridApi<TData>) => void;
+    /** Fired when the selection changes. */
+    onSelectionChanged?: (selectedNodes: RowNode<TData>[]) => void;
+    /** Fired when the sort model changes. */
+    onSortChanged?: (sortModel: any[]) => void;
+    /** Fired when the filter model changes. */
+    onFilterChanged?: (filterModel: Record<string, any>) => void;
+    /** Fired when a cell value is changed via editing. */
+    onCellValueChanged?: (params: {
+        rowId: string;
+        field: string;
+        oldValue: any;
+        newValue: any;
+    }) => void;
+    /** Fired when a row is clicked. */
+    onRowClicked?: (node: RowNode<TData>) => void;
+    /** Fired when pagination state changes. */
+    onPaginationChanged?: (params: {
+        currentPage: number;
+        pageSize: number;
+        totalRows: number;
+    }) => void;
+    /** Fired when a column is resized. */
+    onColumnResized?: (params: {
+        colId: string;
+        width: number;
+    }) => void;
+}
+
+/**
+ * Parameters for the gridstormAction Svelte action.
+ *
+ * @typeParam TData - The type of each row data object.
+ */
+interface GridStormActionParams<TData = any> {
+    /** Grid configuration props. */
+    props: GridStormProps<TData>;
+    /** Event handler callbacks. */
+    events?: GridStormEventHandlers<TData>;
+    /** Callback fired when the engine and API are ready. */
+    onReady?: (api: GridApi<TData>, engine: GridEngine<TData>) => void;
+}
+/**
+ * Svelte action that creates and manages a GridStorm instance on a DOM element.
+ *
+ * This is the primary integration point for using GridStorm in Svelte 5.
+ * It handles engine creation, DOM renderer mounting, event bridging,
+ * reactive updates (rowData, columns), and cleanup on destroy.
+ *
+ * @param container - The DOM element to mount the grid into.
+ * @param params - Configuration including props, event handlers, and ready callback.
+ * @returns A Svelte action interface with `update` and `destroy` methods.
+ *
+ * @example
+ * ```svelte
+ * <script lang="ts">
+ *   import { gridstormAction } from '@gridstorm/svelte';
+ *   import { sortingPlugin } from '@gridstorm/plugin-sorting';
+ *
+ *   let api = $state(null);
+ *   const columns = [
+ *     { field: 'name', headerName: 'Name', sortable: true },
+ *     { field: 'age', headerName: 'Age', width: 100 },
+ *   ];
+ *   const rowData = [
+ *     { name: 'Alice', age: 30 },
+ *     { name: 'Bob', age: 25 },
+ *   ];
+ * </script>
+ *
+ * <div
+ *   use:gridstormAction={{
+ *     props: { columns, rowData, plugins: [sortingPlugin()] },
+ *     onReady: (gridApi) => { api = gridApi; },
+ *   }}
+ *   style="height: 400px"
+ * />
+ * ```
+ */
+declare function gridstormAction<TData = any>(container: HTMLElement, params: GridStormActionParams<TData>): {
+    /**
+     * Called by Svelte when the action parameters change.
+     * Performs incremental updates for rowData and columns changes.
+     */
+    update(newParams: GridStormActionParams<TData>): void;
+    /**
+     * Called by Svelte when the element is removed from the DOM.
+     * Cleans up the engine, renderer, and all event subscriptions.
+     */
+    destroy: () => void;
+};
+
+/**
+ * Set the current grid API reference.
+ *
+ * Call this from the `onReady` callback of `gridstormAction` to make
+ * the API available to composable helper functions.
+ *
+ * @param api - The grid API instance, or `null` to clear it.
+ */
+declare function setGridApi(api: GridApi | null): void;
+/**
+ * Get the current grid API reference.
+ *
+ * Returns `null` if the grid has not been initialized yet or has been destroyed.
+ *
+ * @typeParam TData - The type of each row data object.
+ * @returns The current GridApi instance, or `null`.
+ */
+declare function getGridApi<TData = any>(): GridApi<TData> | null;
+/**
+ * Register a listener that is called whenever the grid API changes.
+ *
+ * @param listener - Callback invoked with the new API (or `null` on destroy).
+ * @returns An unsubscribe function.
+ */
+declare function onGridApiChange(listener: (api: GridApi | null) => void): () => void;
+
+/**
+ * Read a slice of the grid store state using a selector function.
+ *
+ * Returns `undefined` if the grid has not been initialized yet.
+ * This function reads state synchronously (snapshot) and does not
+ * set up a reactive subscription. For reactive state in Svelte 5,
+ * subscribe to grid events or use `$effect` with periodic polling.
+ *
+ * @typeParam T - The type of the selected state slice.
+ * @param selector - A function that extracts a value from the grid state.
+ * @returns The selected state value, or `undefined` if not available.
+ *
+ * @example
+ * ```ts
+ * import { getGridState } from '@gridstorm/svelte';
+ *
+ * const sortModel = getGridState((state) => state.sortModel);
+ * ```
+ */
+declare function getGridState<T>(selector: (state: GridState) => T): T | undefined;
+
+/**
+ * Subscribe to a grid event by name.
+ *
+ * Returns an unsubscribe function. If the grid has not been initialized yet,
+ * returns a no-op unsubscribe function.
+ *
+ * In Svelte 5, call this inside `$effect` or `onMount` and clean up
+ * the subscription in the effect's cleanup or `onDestroy`.
+ *
+ * @typeParam K - The event key from GridEventMap.
+ * @param event - The event name to listen for.
+ * @param callback - Callback invoked when the event fires.
+ * @returns An unsubscribe function.
+ *
+ * @example
+ * ```svelte
+ * <script lang="ts">
+ *   import { onMount, onDestroy } from 'svelte';
+ *   import { subscribeToGridEvent } from '@gridstorm/svelte';
+ *
+ *   let unsub: () => void;
+ *   onMount(() => {
+ *     unsub = subscribeToGridEvent('selection:changed', (e) => {
+ *       console.log('Selection changed:', e);
+ *     });
+ *   });
+ *   onDestroy(() => unsub?.());
+ * </script>
+ * ```
+ */
+declare function subscribeToGridEvent<K extends string & keyof GridEventMap>(event: K, callback: (payload: GridEventMap[K]) => void): () => void;
+
+/**
+ * Get the currently selected row nodes.
+ *
+ * Returns an empty array if the grid has not been initialized yet.
+ *
+ * @typeParam TData - The type of each row data object.
+ * @returns Array of selected RowNode objects.
+ */
+declare function getSelectedRows<TData = any>(): RowNode<TData>[];
+/**
+ * Select all rows that pass the current filter.
+ */
+declare function selectAll(): void;
+/**
+ * Deselect all currently selected rows.
+ */
+declare function deselectAll(): void;
+
+/**
+ * Get the current sort model.
+ *
+ * @returns Array of active sort items, or an empty array if not available.
+ */
+declare function getSortModel(): SortModelItem[];
+/**
+ * Set the sort model, replacing any existing sort configuration.
+ *
+ * @param model - Array of sort items specifying column and direction.
+ */
+declare function setSortModel(model: SortModelItem[]): void;
+
+/**
+ * Get the current filter model for all columns.
+ *
+ * @returns Object keyed by column ID with active filter models,
+ *          or an empty object if not available.
+ */
+declare function getFilterModel(): Record<string, FilterModel>;
+/**
+ * Set the filter model, replacing all active filters.
+ *
+ * @param model - Object keyed by column ID with filter models.
+ */
+declare function setFilterModel(model: Record<string, FilterModel>): void;
+/**
+ * Apply a quick filter across all columns.
+ *
+ * @param text - The filter text. Pass an empty string to clear.
+ */
+declare function setQuickFilter(text: string): void;
+
+/**
+ * Pagination state snapshot.
+ */
+interface PaginationState {
+    /** Current page (zero-based). */
+    currentPage: number;
+    /** Rows per page. */
+    pageSize: number;
+    /** Total number of pages. */
+    totalPages: number;
+    /** Total row count. */
+    totalRows: number;
+}
+/**
+ * Get the current pagination state.
+ *
+ * @returns A snapshot of pagination state, or defaults if not available.
+ */
+declare function getPaginationState(): PaginationState;
+/**
+ * Navigate to a specific page (zero-based index).
+ *
+ * @param page - The zero-based page number to navigate to.
+ */
+declare function goToPage(page: number): void;
+
+export { type GridStormActionParams, type GridStormContext, type GridStormEventHandlers, type GridStormProps, type PaginationState, deselectAll, getFilterModel, getGridApi, getGridState, getPaginationState, getSelectedRows, getSortModel, goToPage, gridstormAction, onGridApiChange, selectAll, setFilterModel, setGridApi, setQuickFilter, setSortModel, subscribeToGridEvent };

package/dist/index.js

@@ -0,0 +1,230 @@
+import { createGrid } from '@gridstorm/core';
+import { DomRenderer } from '@gridstorm/dom-renderer';
+
+// src/gridstorm-action.ts
+function gridstormAction(container, params) {
+  let engine = null;
+  let renderer = null;
+  const unsubs = [];
+  function init() {
+    const { props, events, onReady } = params;
+    const config = {
+      columns: props.columns,
+      rowData: props.rowData,
+      plugins: props.plugins || [],
+      getRowId: props.getRowId ? (p) => props.getRowId(p.data) : void 0,
+      rowHeight: props.rowHeight,
+      headerHeight: props.headerHeight,
+      theme: props.theme
+    };
+    engine = createGrid(config);
+    renderer = new DomRenderer({
+      container,
+      engine,
+      enableCellEditing: props.enableCellEditing,
+      enableGrouping: props.enableGrouping,
+      floatingFilter: props.floatingFilter,
+      enablePagination: props.enablePagination,
+      pageSizeOptions: props.paginationPageSize ? [props.paginationPageSize] : void 0
+    });
+    renderer.mount();
+    if (props.density) {
+      container.setAttribute("data-density", props.density);
+    }
+    if (events?.onSelectionChanged) {
+      unsubs.push(
+        engine.eventBus.on("selection:changed", () => {
+          events.onSelectionChanged(engine.api.getSelectedNodes());
+        })
+      );
+    }
+    if (events?.onSortChanged) {
+      unsubs.push(
+        engine.eventBus.on("column:sort:changed", (e) => {
+          events.onSortChanged(e.sortModel || []);
+        })
+      );
+    }
+    if (events?.onFilterChanged) {
+      unsubs.push(
+        engine.eventBus.on("filter:changed", (e) => {
+          events.onFilterChanged(e.filterModel || {});
+        })
+      );
+    }
+    if (events?.onCellValueChanged) {
+      unsubs.push(
+        engine.eventBus.on("cell:valueChanged", (e) => {
+          events.onCellValueChanged(e);
+        })
+      );
+    }
+    if (events?.onRowClicked) {
+      unsubs.push(
+        engine.eventBus.on("row:clicked", (e) => {
+          events.onRowClicked(e.node);
+        })
+      );
+    }
+    if (events?.onPaginationChanged) {
+      unsubs.push(
+        engine.eventBus.on("pagination:changed", (e) => {
+          events.onPaginationChanged(e);
+        })
+      );
+    }
+    if (events?.onColumnResized) {
+      unsubs.push(
+        engine.eventBus.on("column:resized", (e) => {
+          events.onColumnResized(e);
+        })
+      );
+    }
+    requestAnimationFrame(() => {
+      if (engine) {
+        engine.eventBus.emit("grid:ready", { api: engine.api });
+        events?.onGridReady?.(engine.api);
+        onReady?.(engine.api, engine);
+      }
+    });
+  }
+  function destroy() {
+    unsubs.forEach((fn) => fn());
+    unsubs.length = 0;
+    renderer?.destroy();
+    engine?.destroy();
+    renderer = null;
+    engine = null;
+  }
+  init();
+  return {
+    /**
+     * Called by Svelte when the action parameters change.
+     * Performs incremental updates for rowData and columns changes.
+     */
+    update(newParams) {
+      if (engine && newParams.props.rowData !== params.props.rowData) {
+        engine.api.setRowData(newParams.props.rowData);
+      }
+      if (engine && newParams.props.columns !== params.props.columns) {
+        engine.api.setColumnDefs(newParams.props.columns);
+      }
+      params = newParams;
+    },
+    /**
+     * Called by Svelte when the element is removed from the DOM.
+     * Cleans up the engine, renderer, and all event subscriptions.
+     */
+    destroy
+  };
+}
+
+// src/composables/useGridApi.ts
+var currentApi = null;
+var listeners = /* @__PURE__ */ new Set();
+function setGridApi(api) {
+  currentApi = api;
+  listeners.forEach((fn) => fn(api));
+}
+function getGridApi() {
+  return currentApi;
+}
+function onGridApiChange(listener) {
+  listeners.add(listener);
+  return () => listeners.delete(listener);
+}
+
+// src/composables/useGridState.ts
+function getGridState(selector) {
+  const api = getGridApi();
+  if (!api) return void 0;
+  const state = api.getState();
+  if (!state) return void 0;
+  return selector(state);
+}
+
+// src/composables/useGridEvent.ts
+function subscribeToGridEvent(event, callback) {
+  const api = getGridApi();
+  if (!api) return () => {
+  };
+  api.addEventListener(event, callback);
+  return () => {
+    api.removeEventListener(event, callback);
+  };
+}
+
+// src/composables/useGridSelection.ts
+function getSelectedRows() {
+  const api = getGridApi();
+  if (!api) return [];
+  return api.getSelectedNodes();
+}
+function selectAll() {
+  const api = getGridApi();
+  if (!api) return;
+  api.selectAll();
+}
+function deselectAll() {
+  const api = getGridApi();
+  if (!api) return;
+  api.deselectAll();
+}
+
+// src/composables/useGridSort.ts
+function getSortModel() {
+  const api = getGridApi();
+  if (!api) return [];
+  return api.getSortModel();
+}
+function setSortModel(model) {
+  const api = getGridApi();
+  if (!api) return;
+  api.setSortModel(model);
+}
+
+// src/composables/useGridFilter.ts
+function getFilterModel() {
+  const api = getGridApi();
+  if (!api) return {};
+  return api.getFilterModel();
+}
+function setFilterModel(model) {
+  const api = getGridApi();
+  if (!api) return;
+  api.setFilterModel(model);
+}
+function setQuickFilter(text) {
+  const api = getGridApi();
+  if (!api) return;
+  api.setQuickFilter(text);
+}
+
+// src/composables/useGridPagination.ts
+function getPaginationState() {
+  const api = getGridApi();
+  if (!api) {
+    return { currentPage: 0, pageSize: 10, totalPages: 0, totalRows: 0 };
+  }
+  const state = api.getState();
+  const pagination = state.pagination;
+  const totalPages = Math.max(
+    1,
+    Math.ceil(pagination.totalRows / pagination.pageSize)
+  );
+  return {
+    currentPage: pagination.currentPage,
+    pageSize: pagination.pageSize,
+    totalPages,
+    totalRows: pagination.totalRows
+  };
+}
+function goToPage(page) {
+  const api = getGridApi();
+  if (!api) return;
+  api.paginationGoToPage(page);
+}
+
+export { deselectAll, getFilterModel, getGridApi, getGridState, getPaginationState, getSelectedRows, getSortModel, goToPage, gridstormAction, onGridApiChange, selectAll, setFilterModel, setGridApi, setQuickFilter, setSortModel, subscribeToGridEvent };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/gridstorm-action.ts","../src/composables/useGridApi.ts","../src/composables/useGridState.ts","../src/composables/useGridEvent.ts","../src/composables/useGridSelection.ts","../src/composables/useGridSort.ts","../src/composables/useGridFilter.ts","../src/composables/useGridPagination.ts"],"names":[],"mappings":";;;;AAuEO,SAAS,eAAA,CACd,WACA,MAAA,EACA;AACA,EAAA,IAAI,MAAA,GAAmC,IAAA;AACvC,EAAA,IAAI,QAAA,GAA+B,IAAA;AACnC,EAAA,MAAM,SAA4B,EAAC;AAEnC,EAAA,SAAS,IAAA,GAAO;AACd,IAAA,MAAM,EAAE,KAAA,EAAO,MAAA,EAAQ,OAAA,EAAQ,GAAI,MAAA;AAGnC,IAAA,MAAM,MAAA,GAA4B;AAAA,MAChC,SAAS,KAAA,CAAM,OAAA;AAAA,MACf,SAAS,KAAA,CAAM,OAAA;AAAA,MACf,OAAA,EAAS,KAAA,CAAM,OAAA,IAAW,EAAC;AAAA,MAC3B,QAAA,EAAU,MAAM,QAAA,GACZ,CAAC,MAAM,KAAA,CAAM,QAAA,CAAU,CAAA,CAAE,IAAI,CAAA,GAC7B,MAAA;AAAA,MACJ,WAAW,KAAA,CAAM,SAAA;AAAA,MACjB,cAAc,KAAA,CAAM,YAAA;AAAA,MACpB,OAAO,KAAA,CAAM;AAAA,KACf;AAGA,IAAA,MAAA,GAAS,WAAW,MAAM,CAAA;AAG1B,IAAA,QAAA,GAAW,IAAI,WAAA,CAAY;AAAA,MACzB,SAAA;AAAA,MACA,MAAA;AAAA,MACA,mBAAmB,KAAA,CAAM,iBAAA;AAAA,MACzB,gBAAgB,KAAA,CAAM,cAAA;AAAA,MACtB,gBAAgB,KAAA,CAAM,cAAA;AAAA,MACtB,kBAAkB,KAAA,CAAM,gBAAA;AAAA,MACxB,iBAAiB,KAAA,CAAM,kBAAA,GACnB,CAAC,KAAA,CAAM,kBAAkB,CAAA,GACzB;AAAA,KACL,CAAA;AACD,IAAA,QAAA,CAAS,KAAA,EAAM;AAGf,IAAA,IAAI,MAAM,OAAA,EAAS;AACjB,MAAA,SAAA,CAAU,YAAA,CAAa,cAAA,EAAgB,KAAA,CAAM,OAAO,CAAA;AAAA,IACtD;AAIA,IAAA,IAAI,QAAQ,kBAAA,EAAoB;AAC9B,MAAA,MAAA,CAAO,IAAA;AAAA,QACL,MAAA,CAAO,QAAA,CAAS,EAAA,CAAG,mBAAA,EAAqB,MAAM;AAC5C,UAAA,MAAA,CAAO,kBAAA,CAAoB,MAAA,CAAQ,GAAA,CAAI,gBAAA,EAAkB,CAAA;AAAA,QAC3D,CAAC;AAAA,OACH;AAAA,IACF;AAEA,IAAA,IAAI,QAAQ,aAAA,EAAe;AACzB,MAAA,MAAA,CAAO,IAAA;AAAA,QACL,MAAA,CAAO,QAAA,CAAS,EAAA,CAAG,qBAAA,EAAuB,CAAC,CAAA,KAAW;AACpD,UAAA,MAAA,CAAO,aAAA,CAAe,CAAA,CAAE,SAAA,IAAa,EAAE,CAAA;AAAA,QACzC,CAAC;AAAA,OACH;AAAA,IACF;AAEA,IAAA,IAAI,QAAQ,eAAA,EAAiB;AAC3B,MAAA,MAAA,CAAO,IAAA;AAAA,QACL,MAAA,CAAO,QAAA,CAAS,EAAA,CAAG,gBAAA,EAAkB,CAAC,CAAA,KAAW;AAC/C,UAAA,MAAA,CAAO,eAAA,CAAiB,CAAA,CAAE,WAAA,IAAe,EAAE,CAAA;AAAA,QAC7C,CAAC;AAAA,OACH;AAAA,IACF;AAEA,IAAA,IAAI,QAAQ,kBAAA,EAAoB;AAC9B,MAAA,MAAA,CAAO,IAAA;AAAA,QACL,MAAA,CAAO,QAAA,CAAS,EAAA,CAAG,mBAAA,EAAqB,CAAC,CAAA,KAAW;AAClD,UAAA,MAAA,CAAO,mBAAoB,CAAC,CAAA;AAAA,QAC9B,CAAC;AAAA,OACH;AAAA,IACF;AAEA,IAAA,IAAI,QAAQ,YAAA,EAAc;AACxB,MAAA,MAAA,CAAO,IAAA;AAAA,QACL,MAAA,CAAO,QAAA,CAAS,EAAA,CAAG,aAAA,EAAe,CAAC,CAAA,KAAW;AAC5C,UAAA,MAAA,CAAO,YAAA,CAAc,EAAE,IAAI,CAAA;AAAA,QAC7B,CAAC;AAAA,OACH;AAAA,IACF;AAEA,IAAA,IAAI,QAAQ,mBAAA,EAAqB;AAC/B,MAAA,MAAA,CAAO,IAAA;AAAA,QACL,MAAA,CAAO,QAAA,CAAS,EAAA,CAAG,oBAAA,EAAsB,CAAC,CAAA,KAAW;AACnD,UAAA,MAAA,CAAO,oBAAqB,CAAC,CAAA;AAAA,QAC/B,CAAC;AAAA,OACH;AAAA,IACF;AAEA,IAAA,IAAI,QAAQ,eAAA,EAAiB;AAC3B,MAAA,MAAA,CAAO,IAAA;AAAA,QACL,MAAA,CAAO,QAAA,CAAS,EAAA,CAAG,gBAAA,EAAkB,CAAC,CAAA,KAAW;AAC/C,UAAA,MAAA,CAAO,gBAAiB,CAAC,CAAA;AAAA,QAC3B,CAAC;AAAA,OACH;AAAA,IACF;AAKA,IAAA,qBAAA,CAAsB,MAAM;AAC1B,MAAA,IAAI,MAAA,EAAQ;AACV,QAAA,MAAA,CAAO,SAAS,IAAA,CAAK,YAAA,EAAc,EAAE,GAAA,EAAK,MAAA,CAAO,KAAK,CAAA;AACtD,QAAA,MAAA,EAAQ,WAAA,GAAc,OAAO,GAAG,CAAA;AAChC,QAAA,OAAA,GAAU,MAAA,CAAO,KAAK,MAAM,CAAA;AAAA,MAC9B;AAAA,IACF,CAAC,CAAA;AAAA,EACH;AAEA,EAAA,SAAS,OAAA,GAAU;AACjB,IAAA,MAAA,CAAO,OAAA,CAAQ,CAAC,EAAA,KAAO,EAAA,EAAI,CAAA;AAC3B,IAAA,MAAA,CAAO,MAAA,GAAS,CAAA;AAChB,IAAA,QAAA,EAAU,OAAA,EAAQ;AAClB,IAAA,MAAA,EAAQ,OAAA,EAAQ;AAChB,IAAA,QAAA,GAAW,IAAA;AACX,IAAA,MAAA,GAAS,IAAA;AAAA,EACX;AAGA,EAAA,IAAA,EAAK;AAGL,EAAA,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA,IAKL,OAAO,SAAA,EAAyC;AAC9C,MAAA,IAAI,UAAU,SAAA,CAAU,KAAA,CAAM,OAAA,KAAY,MAAA,CAAO,MAAM,OAAA,EAAS;AAC9D,QAAA,MAAA,CAAO,GAAA,CAAI,UAAA,CAAW,SAAA,CAAU,KAAA,CAAM,OAAO,CAAA;AAAA,MAC/C;AACA,MAAA,IAAI,UAAU,SAAA,CAAU,KAAA,CAAM,OAAA,KAAY,MAAA,CAAO,MAAM,OAAA,EAAS;AAC9D,QAAA,MAAA,CAAO,GAAA,CAAI,aAAA,CAAc,SAAA,CAAU,KAAA,CAAM,OAAO,CAAA;AAAA,MAClD;AACA,MAAA,MAAA,GAAS,SAAA;AAAA,IACX,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMA;AAAA,GACF;AACF;;;ACnNA,IAAI,UAAA,GAA6B,IAAA;AAGjC,IAAM,SAAA,uBAAgB,GAAA,EAAmC;AAUlD,SAAS,WAAW,GAAA,EAA2B;AACpD,EAAA,UAAA,GAAa,GAAA;AACb,EAAA,SAAA,CAAU,OAAA,CAAQ,CAAC,EAAA,KAAO,EAAA,CAAG,GAAG,CAAC,CAAA;AACnC;AAUO,SAAS,UAAA,GAAiD;AAC/D,EAAA,OAAO,UAAA;AACT;AAQO,SAAS,gBACd,QAAA,EACY;AACZ,EAAA,SAAA,CAAU,IAAI,QAAQ,CAAA;AACtB,EAAA,OAAO,MAAM,SAAA,CAAU,MAAA,CAAO,QAAQ,CAAA;AACxC;;;AC1BO,SAAS,aAAgB,QAAA,EAAkD;AAChF,EAAA,MAAM,MAAM,UAAA,EAAW;AACvB,EAAA,IAAI,CAAC,KAAK,OAAO,MAAA;AACjB,EAAA,MAAM,KAAA,GAAQ,IAAI,QAAA,EAAS;AAC3B,EAAA,IAAI,CAAC,OAAO,OAAO,MAAA;AACnB,EAAA,OAAO,SAAS,KAAK,CAAA;AACvB;;;ACKO,SAAS,oBAAA,CACd,OACA,QAAA,EACY;AACZ,EAAA,MAAM,MAAM,UAAA,EAAW;AACvB,EAAA,IAAI,CAAC,GAAA,EAAK,OAAO,MAAM;AAAA,EAAC,CAAA;AAGxB,EAAA,GAAA,CAAI,gBAAA,CAAiB,OAAc,QAAe,CAAA;AAElD,EAAA,OAAO,MAAM;AACX,IAAA,GAAA,CAAI,mBAAA,CAAoB,OAAc,QAAe,CAAA;AAAA,EACvD,CAAA;AACF;;;ACnCO,SAAS,eAAA,GAAiD;AAC/D,EAAA,MAAM,MAAM,UAAA,EAAkB;AAC9B,EAAA,IAAI,CAAC,GAAA,EAAK,OAAO,EAAC;AAClB,EAAA,OAAO,IAAI,gBAAA,EAAiB;AAC9B;AAKO,SAAS,SAAA,GAAkB;AAChC,EAAA,MAAM,MAAM,UAAA,EAAW;AACvB,EAAA,IAAI,CAAC,GAAA,EAAK;AACV,EAAA,GAAA,CAAI,SAAA,EAAU;AAChB;AAKO,SAAS,WAAA,GAAoB;AAClC,EAAA,MAAM,MAAM,UAAA,EAAW;AACvB,EAAA,IAAI,CAAC,GAAA,EAAK;AACV,EAAA,GAAA,CAAI,WAAA,EAAY;AAClB;;;ACzBO,SAAS,YAAA,GAAgC;AAC9C,EAAA,MAAM,MAAM,UAAA,EAAW;AACvB,EAAA,IAAI,CAAC,GAAA,EAAK,OAAO,EAAC;AAClB,EAAA,OAAO,IAAI,YAAA,EAAa;AAC1B;AAOO,SAAS,aAAa,KAAA,EAA8B;AACzD,EAAA,MAAM,MAAM,UAAA,EAAW;AACvB,EAAA,IAAI,CAAC,GAAA,EAAK;AACV,EAAA,GAAA,CAAI,aAAa,KAAK,CAAA;AACxB;;;ACdO,SAAS,cAAA,GAA8C;AAC5D,EAAA,MAAM,MAAM,UAAA,EAAW;AACvB,EAAA,IAAI,CAAC,GAAA,EAAK,OAAO,EAAC;AAClB,EAAA,OAAO,IAAI,cAAA,EAAe;AAC5B;AAOO,SAAS,eAAe,KAAA,EAA0C;AACvE,EAAA,MAAM,MAAM,UAAA,EAAW;AACvB,EAAA,IAAI,CAAC,GAAA,EAAK;AACV,EAAA,GAAA,CAAI,eAAe,KAAK,CAAA;AAC1B;AAOO,SAAS,eAAe,IAAA,EAAoB;AACjD,EAAA,MAAM,MAAM,UAAA,EAAW;AACvB,EAAA,IAAI,CAAC,GAAA,EAAK;AACV,EAAA,GAAA,CAAI,eAAe,IAAI,CAAA;AACzB;;;ACdO,SAAS,kBAAA,GAAsC;AACpD,EAAA,MAAM,MAAM,UAAA,EAAW;AACvB,EAAA,IAAI,CAAC,GAAA,EAAK;AACR,IAAA,OAAO,EAAE,aAAa,CAAA,EAAG,QAAA,EAAU,IAAI,UAAA,EAAY,CAAA,EAAG,WAAW,CAAA,EAAE;AAAA,EACrE;AAEA,EAAA,MAAM,KAAA,GAAQ,IAAI,QAAA,EAAS;AAC3B,EAAA,MAAM,aAAa,KAAA,CAAM,UAAA;AACzB,EAAA,MAAM,aAAa,IAAA,CAAK,GAAA;AAAA,IACtB,CAAA;AAAA,IACA,IAAA,CAAK,IAAA,CAAK,UAAA,CAAW,SAAA,GAAY,WAAW,QAAQ;AAAA,GACtD;AAEA,EAAA,OAAO;AAAA,IACL,aAAa,UAAA,CAAW,WAAA;AAAA,IACxB,UAAU,UAAA,CAAW,QAAA;AAAA,IACrB,UAAA;AAAA,IACA,WAAW,UAAA,CAAW;AAAA,GACxB;AACF;AAOO,SAAS,SAAS,IAAA,EAAoB;AAC3C,EAAA,MAAM,MAAM,UAAA,EAAW;AACvB,EAAA,IAAI,CAAC,GAAA,EAAK;AACV,EAAA,GAAA,CAAI,mBAAmB,IAAI,CAAA;AAC7B","file":"index.js","sourcesContent":["// ─── GridStorm Svelte Action ───\n// The core of the Svelte 5 adapter. Implements a Svelte \"action\" — a function\n// that takes a DOM element and manages the GridStorm lifecycle (create, update, destroy).\n//\n// Usage in a Svelte 5 component:\n//\n//   <script lang=\"ts\">\n//     import { gridstormAction } from '@gridstorm/svelte';\n//\n//     const columns = [{ field: 'name' }, { field: 'age' }];\n//     const rowData = [{ name: 'Alice', age: 30 }];\n//   </script>\n//\n//   <div use:gridstormAction={{ props: { columns, rowData } }} style=\"height: 400px\" />\n\nimport { createGrid } from '@gridstorm/core';\nimport type { GridEngine, GridApi, GridConfig } from '@gridstorm/core';\nimport { DomRenderer } from '@gridstorm/dom-renderer';\nimport type { GridStormProps, GridStormEventHandlers } from './types';\n\n/**\n * Parameters for the gridstormAction Svelte action.\n *\n * @typeParam TData - The type of each row data object.\n */\nexport interface GridStormActionParams<TData = any> {\n  /** Grid configuration props. */\n  props: GridStormProps<TData>;\n  /** Event handler callbacks. */\n  events?: GridStormEventHandlers<TData>;\n  /** Callback fired when the engine and API are ready. */\n  onReady?: (api: GridApi<TData>, engine: GridEngine<TData>) => void;\n}\n\n/**\n * Svelte action that creates and manages a GridStorm instance on a DOM element.\n *\n * This is the primary integration point for using GridStorm in Svelte 5.\n * It handles engine creation, DOM renderer mounting, event bridging,\n * reactive updates (rowData, columns), and cleanup on destroy.\n *\n * @param container - The DOM element to mount the grid into.\n * @param params - Configuration including props, event handlers, and ready callback.\n * @returns A Svelte action interface with `update` and `destroy` methods.\n *\n * @example\n * ```svelte\n * <script lang=\"ts\">\n *   import { gridstormAction } from '@gridstorm/svelte';\n *   import { sortingPlugin } from '@gridstorm/plugin-sorting';\n *\n *   let api = $state(null);\n *   const columns = [\n *     { field: 'name', headerName: 'Name', sortable: true },\n *     { field: 'age', headerName: 'Age', width: 100 },\n *   ];\n *   const rowData = [\n *     { name: 'Alice', age: 30 },\n *     { name: 'Bob', age: 25 },\n *   ];\n * </script>\n *\n * <div\n *   use:gridstormAction={{\n *     props: { columns, rowData, plugins: [sortingPlugin()] },\n *     onReady: (gridApi) => { api = gridApi; },\n *   }}\n *   style=\"height: 400px\"\n * />\n * ```\n */\nexport function gridstormAction<TData = any>(\n  container: HTMLElement,\n  params: GridStormActionParams<TData>,\n) {\n  let engine: GridEngine<TData> | null = null;\n  let renderer: DomRenderer | null = null;\n  const unsubs: Array<() => void> = [];\n\n  function init() {\n    const { props, events, onReady } = params;\n\n    // Build grid config from props\n    const config: GridConfig<TData> = {\n      columns: props.columns,\n      rowData: props.rowData,\n      plugins: props.plugins || [],\n      getRowId: props.getRowId\n        ? (p) => props.getRowId!(p.data)\n        : undefined,\n      rowHeight: props.rowHeight,\n      headerHeight: props.headerHeight,\n      theme: props.theme,\n    };\n\n    // Create the headless grid engine\n    engine = createGrid(config);\n\n    // Create and mount the DOM renderer\n    renderer = new DomRenderer({\n      container,\n      engine,\n      enableCellEditing: props.enableCellEditing,\n      enableGrouping: props.enableGrouping,\n      floatingFilter: props.floatingFilter,\n      enablePagination: props.enablePagination,\n      pageSizeOptions: props.paginationPageSize\n        ? [props.paginationPageSize]\n        : undefined,\n    });\n    renderer.mount();\n\n    // Apply density as a data attribute on the container\n    if (props.density) {\n      container.setAttribute('data-density', props.density);\n    }\n\n    // ── Event bridge: core events -> Svelte callbacks ──\n\n    if (events?.onSelectionChanged) {\n      unsubs.push(\n        engine.eventBus.on('selection:changed', () => {\n          events.onSelectionChanged!(engine!.api.getSelectedNodes());\n        }),\n      );\n    }\n\n    if (events?.onSortChanged) {\n      unsubs.push(\n        engine.eventBus.on('column:sort:changed', (e: any) => {\n          events.onSortChanged!(e.sortModel || []);\n        }),\n      );\n    }\n\n    if (events?.onFilterChanged) {\n      unsubs.push(\n        engine.eventBus.on('filter:changed', (e: any) => {\n          events.onFilterChanged!(e.filterModel || {});\n        }),\n      );\n    }\n\n    if (events?.onCellValueChanged) {\n      unsubs.push(\n        engine.eventBus.on('cell:valueChanged', (e: any) => {\n          events.onCellValueChanged!(e);\n        }),\n      );\n    }\n\n    if (events?.onRowClicked) {\n      unsubs.push(\n        engine.eventBus.on('row:clicked', (e: any) => {\n          events.onRowClicked!(e.node);\n        }),\n      );\n    }\n\n    if (events?.onPaginationChanged) {\n      unsubs.push(\n        engine.eventBus.on('pagination:changed', (e: any) => {\n          events.onPaginationChanged!(e);\n        }),\n      );\n    }\n\n    if (events?.onColumnResized) {\n      unsubs.push(\n        engine.eventBus.on('column:resized', (e: any) => {\n          events.onColumnResized!(e);\n        }),\n      );\n    }\n\n    // Fire grid:ready after the renderer has mounted and DOM is populated.\n    // Plugins like column-resize and context-menu use rAF on grid:ready to\n    // inject DOM elements, so we re-emit after the renderer is in the DOM.\n    requestAnimationFrame(() => {\n      if (engine) {\n        engine.eventBus.emit('grid:ready', { api: engine.api });\n        events?.onGridReady?.(engine.api);\n        onReady?.(engine.api, engine);\n      }\n    });\n  }\n\n  function destroy() {\n    unsubs.forEach((fn) => fn());\n    unsubs.length = 0;\n    renderer?.destroy();\n    engine?.destroy();\n    renderer = null;\n    engine = null;\n  }\n\n  // Initialize the grid\n  init();\n\n  // Return the Svelte action interface\n  return {\n    /**\n     * Called by Svelte when the action parameters change.\n     * Performs incremental updates for rowData and columns changes.\n     */\n    update(newParams: GridStormActionParams<TData>) {\n      if (engine && newParams.props.rowData !== params.props.rowData) {\n        engine.api.setRowData(newParams.props.rowData);\n      }\n      if (engine && newParams.props.columns !== params.props.columns) {\n        engine.api.setColumnDefs(newParams.props.columns);\n      }\n      params = newParams;\n    },\n\n    /**\n     * Called by Svelte when the element is removed from the DOM.\n     * Cleans up the engine, renderer, and all event subscriptions.\n     */\n    destroy,\n  };\n}\n","// ─── Grid API Store ───\n// Lightweight store for the current GridApi reference.\n// In Svelte 5, there is no provide/inject like Vue or React context.\n// Instead, this module-level store allows any component to access the\n// grid API after initialization. Call setGridApi from the onReady callback\n// and getGridApi from anywhere in your component tree.\n\nimport type { GridApi } from '@gridstorm/core';\n\n/** Module-level reference to the current grid API. */\nlet currentApi: GridApi | null = null;\n\n/** Set of listeners notified when the API changes. */\nconst listeners = new Set<(api: GridApi | null) => void>();\n\n/**\n * Set the current grid API reference.\n *\n * Call this from the `onReady` callback of `gridstormAction` to make\n * the API available to composable helper functions.\n *\n * @param api - The grid API instance, or `null` to clear it.\n */\nexport function setGridApi(api: GridApi | null): void {\n  currentApi = api;\n  listeners.forEach((fn) => fn(api));\n}\n\n/**\n * Get the current grid API reference.\n *\n * Returns `null` if the grid has not been initialized yet or has been destroyed.\n *\n * @typeParam TData - The type of each row data object.\n * @returns The current GridApi instance, or `null`.\n */\nexport function getGridApi<TData = any>(): GridApi<TData> | null {\n  return currentApi as GridApi<TData> | null;\n}\n\n/**\n * Register a listener that is called whenever the grid API changes.\n *\n * @param listener - Callback invoked with the new API (or `null` on destroy).\n * @returns An unsubscribe function.\n */\nexport function onGridApiChange(\n  listener: (api: GridApi | null) => void,\n): () => void {\n  listeners.add(listener);\n  return () => listeners.delete(listener);\n}\n","// ─── Grid State Accessor ───\n// Provides direct access to the grid store state via a selector function.\n\nimport type { GridState } from '@gridstorm/core';\nimport { getGridApi } from './useGridApi';\n\n/**\n * Read a slice of the grid store state using a selector function.\n *\n * Returns `undefined` if the grid has not been initialized yet.\n * This function reads state synchronously (snapshot) and does not\n * set up a reactive subscription. For reactive state in Svelte 5,\n * subscribe to grid events or use `$effect` with periodic polling.\n *\n * @typeParam T - The type of the selected state slice.\n * @param selector - A function that extracts a value from the grid state.\n * @returns The selected state value, or `undefined` if not available.\n *\n * @example\n * ```ts\n * import { getGridState } from '@gridstorm/svelte';\n *\n * const sortModel = getGridState((state) => state.sortModel);\n * ```\n */\nexport function getGridState<T>(selector: (state: GridState) => T): T | undefined {\n  const api = getGridApi();\n  if (!api) return undefined;\n  const state = api.getState();\n  if (!state) return undefined;\n  return selector(state);\n}\n","// ─── Grid Event Subscription ───\n// Provides a helper to subscribe to grid events from Svelte components.\n\nimport type { GridEventMap } from '@gridstorm/core';\nimport { getGridApi } from './useGridApi';\n\n/**\n * Subscribe to a grid event by name.\n *\n * Returns an unsubscribe function. If the grid has not been initialized yet,\n * returns a no-op unsubscribe function.\n *\n * In Svelte 5, call this inside `$effect` or `onMount` and clean up\n * the subscription in the effect's cleanup or `onDestroy`.\n *\n * @typeParam K - The event key from GridEventMap.\n * @param event - The event name to listen for.\n * @param callback - Callback invoked when the event fires.\n * @returns An unsubscribe function.\n *\n * @example\n * ```svelte\n * <script lang=\"ts\">\n *   import { onMount, onDestroy } from 'svelte';\n *   import { subscribeToGridEvent } from '@gridstorm/svelte';\n *\n *   let unsub: () => void;\n *   onMount(() => {\n *     unsub = subscribeToGridEvent('selection:changed', (e) => {\n *       console.log('Selection changed:', e);\n *     });\n *   });\n *   onDestroy(() => unsub?.());\n * </script>\n * ```\n */\nexport function subscribeToGridEvent<K extends string & keyof GridEventMap>(\n  event: K,\n  callback: (payload: GridEventMap[K]) => void,\n): () => void {\n  const api = getGridApi();\n  if (!api) return () => {};\n\n  // Access the engine's event bus through the API's addEventListener\n  api.addEventListener(event as any, callback as any);\n\n  return () => {\n    api.removeEventListener(event as any, callback as any);\n  };\n}\n","// ─── Grid Selection Helpers ───\n// Convenience functions for managing row selection in Svelte components.\n\nimport type { RowNode } from '@gridstorm/core';\nimport { getGridApi } from './useGridApi';\n\n/**\n * Get the currently selected row nodes.\n *\n * Returns an empty array if the grid has not been initialized yet.\n *\n * @typeParam TData - The type of each row data object.\n * @returns Array of selected RowNode objects.\n */\nexport function getSelectedRows<TData = any>(): RowNode<TData>[] {\n  const api = getGridApi<TData>();\n  if (!api) return [];\n  return api.getSelectedNodes();\n}\n\n/**\n * Select all rows that pass the current filter.\n */\nexport function selectAll(): void {\n  const api = getGridApi();\n  if (!api) return;\n  api.selectAll();\n}\n\n/**\n * Deselect all currently selected rows.\n */\nexport function deselectAll(): void {\n  const api = getGridApi();\n  if (!api) return;\n  api.deselectAll();\n}\n","// ─── Grid Sort Helpers ───\n// Convenience functions for managing sort state in Svelte components.\n\nimport type { SortModelItem } from '@gridstorm/core';\nimport { getGridApi } from './useGridApi';\n\n/**\n * Get the current sort model.\n *\n * @returns Array of active sort items, or an empty array if not available.\n */\nexport function getSortModel(): SortModelItem[] {\n  const api = getGridApi();\n  if (!api) return [];\n  return api.getSortModel();\n}\n\n/**\n * Set the sort model, replacing any existing sort configuration.\n *\n * @param model - Array of sort items specifying column and direction.\n */\nexport function setSortModel(model: SortModelItem[]): void {\n  const api = getGridApi();\n  if (!api) return;\n  api.setSortModel(model);\n}\n","// ─── Grid Filter Helpers ───\n// Convenience functions for managing filter state in Svelte components.\n\nimport type { FilterModel } from '@gridstorm/core';\nimport { getGridApi } from './useGridApi';\n\n/**\n * Get the current filter model for all columns.\n *\n * @returns Object keyed by column ID with active filter models,\n *          or an empty object if not available.\n */\nexport function getFilterModel(): Record<string, FilterModel> {\n  const api = getGridApi();\n  if (!api) return {};\n  return api.getFilterModel();\n}\n\n/**\n * Set the filter model, replacing all active filters.\n *\n * @param model - Object keyed by column ID with filter models.\n */\nexport function setFilterModel(model: Record<string, FilterModel>): void {\n  const api = getGridApi();\n  if (!api) return;\n  api.setFilterModel(model);\n}\n\n/**\n * Apply a quick filter across all columns.\n *\n * @param text - The filter text. Pass an empty string to clear.\n */\nexport function setQuickFilter(text: string): void {\n  const api = getGridApi();\n  if (!api) return;\n  api.setQuickFilter(text);\n}\n","// ─── Grid Pagination Helpers ───\n// Convenience functions for managing pagination in Svelte components.\n\nimport { getGridApi } from './useGridApi';\n\n/**\n * Pagination state snapshot.\n */\nexport interface PaginationState {\n  /** Current page (zero-based). */\n  currentPage: number;\n  /** Rows per page. */\n  pageSize: number;\n  /** Total number of pages. */\n  totalPages: number;\n  /** Total row count. */\n  totalRows: number;\n}\n\n/**\n * Get the current pagination state.\n *\n * @returns A snapshot of pagination state, or defaults if not available.\n */\nexport function getPaginationState(): PaginationState {\n  const api = getGridApi();\n  if (!api) {\n    return { currentPage: 0, pageSize: 10, totalPages: 0, totalRows: 0 };\n  }\n\n  const state = api.getState();\n  const pagination = state.pagination;\n  const totalPages = Math.max(\n    1,\n    Math.ceil(pagination.totalRows / pagination.pageSize),\n  );\n\n  return {\n    currentPage: pagination.currentPage,\n    pageSize: pagination.pageSize,\n    totalPages,\n    totalRows: pagination.totalRows,\n  };\n}\n\n/**\n * Navigate to a specific page (zero-based index).\n *\n * @param page - The zero-based page number to navigate to.\n */\nexport function goToPage(page: number): void {\n  const api = getGridApi();\n  if (!api) return;\n  api.paginationGoToPage(page);\n}\n"]}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@gridstorm/svelte",
+  "version": "0.1.2",
+  "description": "GridStorm Svelte 5 adapter — reactive data grid component for Svelte",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "source": "./src/index.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@gridstorm/core": "workspace:*",
+    "@gridstorm/dom-renderer": "workspace:*"
+  },
+  "peerDependencies": {
+    "svelte": "^5.0.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.2.0",
+    "typescript": "^5.5.0"
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "keywords": [
+    "datagrid",
+    "svelte",
+    "svelte5",
+    "svelte-grid",
+    "svelte-table",
+    "gridstorm",
+    "action"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/007krcs/grid-data.git",
+    "directory": "packages/svelte-adapter"
+  },
+  "bugs": {
+    "url": "https://github.com/007krcs/grid-data/issues"
+  },
+  "homepage": "https://grid-data-analytics-explorer.vercel.app/",
+  "author": {
+    "name": "GridStorm",
+    "url": "https://grid-data-analytics-explorer.vercel.app/"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/gridstorm"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}