@humanspeak/svelte-headless-table 6.0.1 → 6.0.2

package/dist/plugins/addExpandedRows.d.ts

@@ -8,6 +8,8 @@ export interface ExpandedRowsConfig<Item> {
 export interface ExpandedRowsState<Item> {
     expandedIds: RecordSetStore<string>;
     getRowState: (row: BodyRow<Item>) => ExpandedRowsRowState;
+    /** Cleans up internal subscriptions and clears the row state cache. Call when destroying the table. */
+    invalidate: () => void;
 }
 export interface ExpandedRowsRowState {
     isExpanded: Writable<boolean>;

package/dist/plugins/addExpandedRows.js

@@ -1,6 +1,8 @@
+import { MemoryCache } from '@humanspeak/memory-cache';
 import { keyed } from '@humanspeak/svelte-keyed';
 import { derived, readable } from 'svelte/store';
 import { recordSetStore } from '../utils/store.js';
+import { DEFAULT_ROW_STATE_CACHE_CONFIG } from './cacheConfig.js';
 const withExpandedRows = (row, expandedIds) => {
     if (row.subRows === undefined) {
         return [row];
@@ -13,7 +15,14 @@ const withExpandedRows = (row, expandedIds) => {
 };
 export const addExpandedRows = ({ initialExpandedIds = {} } = {}) => () => {
     const expandedIds = recordSetStore(initialExpandedIds);
+    // LRU cache for memoized row state with automatic eviction.
+    // Prevents unbounded memory growth when row identities change.
+    const rowStateCache = new MemoryCache(DEFAULT_ROW_STATE_CACHE_CONFIG);
     const getRowState = (row) => {
+        const cached = rowStateCache.get(row.id);
+        if (cached !== undefined) {
+            return cached;
+        }
         const isExpanded = keyed(expandedIds, row.id);
         const canExpand = readable((row.subRows?.length ?? 0) > 0);
         const subRowExpandedIds = derived(expandedIds, ($expandedIds) => {
@@ -30,13 +39,26 @@ export const addExpandedRows = ({ initialExpandedIds = {} } = {}) => () => {
             const expandableSubRows = row.subRows.filter((subRow) => subRow.subRows !== undefined);
             return $subRowExpandedIds.length === expandableSubRows.length;
         });
-        return {
+        const state = {
             isExpanded,
             canExpand,
             isAllSubRowsExpanded
         };
+        rowStateCache.set(row.id, state);
+        return state;
     };
-    const pluginState = { expandedIds, getRowState };
+    // Clear cache when expandedIds store is cleared (data reset scenario)
+    const unsubscribeExpandedIds = expandedIds.subscribe(($expandedIds) => {
+        if (Object.keys($expandedIds).length === 0) {
+            rowStateCache.clear();
+        }
+    });
+    // Cleanup function to prevent subscription leaks when table is destroyed
+    const invalidate = () => {
+        unsubscribeExpandedIds();
+        rowStateCache.clear();
+    };
+    const pluginState = { expandedIds, getRowState, invalidate };
     const deriveRows = (rows) => {
         return derived([rows, expandedIds], ([$rows, $expandedIds]) => {
             return $rows.flatMap((row) => {

package/dist/plugins/addSelectedRows.d.ts

@@ -13,6 +13,8 @@ export interface SelectedRowsState<Item> {
     allPageRowsSelected: Writable<boolean>;
     somePageRowsSelected: Readable<boolean>;
     getRowState: (row: BodyRow<Item>) => SelectedRowsRowState;
+    /** Cleans up internal subscriptions and clears the row state cache. Call when destroying the table. */
+    invalidate: () => void;
 }
 export interface SelectedRowsRowState {
     isSelected: Writable<boolean>;

package/dist/plugins/addSelectedRows.js

@@ -1,6 +1,8 @@
+import { MemoryCache } from '@humanspeak/memory-cache';
 import { derived, get } from 'svelte/store';
 import { nonNull } from '../utils/filter.js';
 import { recordSetStore } from '../utils/store.js';
+import { DEFAULT_ROW_STATE_CACHE_CONFIG } from './cacheConfig.js';
 const isAllSubRowsSelectedForRow = (row, $selectedDataIds, linkDataSubRows) => {
     if (row.isData()) {
         if (!linkDataSubRows || row.subRows === undefined) {
@@ -69,7 +71,14 @@ const getRowIsSelectedStore = (row, selectedDataIds, linkDataSubRows) => {
 };
 export const addSelectedRows = ({ initialSelectedDataIds = {}, linkDataSubRows = true } = {}) => ({ tableState }) => {
     const selectedDataIds = recordSetStore(initialSelectedDataIds);
+    // LRU cache for memoized row state with automatic eviction.
+    // Prevents unbounded memory growth when row identities change.
+    const rowStateCache = new MemoryCache(DEFAULT_ROW_STATE_CACHE_CONFIG);
     const getRowState = (row) => {
+        const cached = rowStateCache.get(row.id);
+        if (cached !== undefined) {
+            return cached;
+        }
         const isSelected = getRowIsSelectedStore(row, selectedDataIds, linkDataSubRows);
         const isSomeSubRowsSelected = derived([isSelected, selectedDataIds], ([$isSelected, $selectedDataIds]) => {
             if ($isSelected)
@@ -79,11 +88,24 @@ export const addSelectedRows = ({ initialSelectedDataIds = {}, linkDataSubRows =
         const isAllSubRowsSelected = derived(selectedDataIds, ($selectedDataIds) => {
             return isAllSubRowsSelectedForRow(row, $selectedDataIds, linkDataSubRows);
         });
-        return {
+        const state = {
             isSelected,
             isSomeSubRowsSelected,
             isAllSubRowsSelected
         };
+        rowStateCache.set(row.id, state);
+        return state;
+    };
+    // Clear cache when selectedDataIds store is cleared (data reset scenario)
+    const unsubscribeSelectedDataIds = selectedDataIds.subscribe(($selectedDataIds) => {
+        if (Object.keys($selectedDataIds).length === 0) {
+            rowStateCache.clear();
+        }
+    });
+    // Cleanup function to prevent subscription leaks when table is destroyed
+    const invalidate = () => {
+        unsubscribeSelectedDataIds();
+        rowStateCache.clear();
     };
     // all rows
     const _allRowsSelected = derived([tableState.rows, selectedDataIds], ([$rows, $selectedDataIds]) => {
@@ -165,7 +187,8 @@ export const addSelectedRows = ({ initialSelectedDataIds = {}, linkDataSubRows =
         allRowsSelected,
         someRowsSelected,
         allPageRowsSelected,
-        somePageRowsSelected
+        somePageRowsSelected,
+        invalidate
     };
     return {
         pluginState,

package/dist/plugins/cacheConfig.d.ts

@@ -0,0 +1,7 @@
+import type { CacheOptions } from '@humanspeak/memory-cache';
+/**
+ * Default configuration for row state LRU caches used by plugins.
+ * Provides automatic eviction to prevent unbounded memory growth
+ * when row identities change.
+ */
+export declare const DEFAULT_ROW_STATE_CACHE_CONFIG: CacheOptions;

package/dist/plugins/cacheConfig.js

@@ -0,0 +1,11 @@
+/**
+ * Default configuration for row state LRU caches used by plugins.
+ * Provides automatic eviction to prevent unbounded memory growth
+ * when row identities change.
+ */
+export const DEFAULT_ROW_STATE_CACHE_CONFIG = {
+    /** Maximum number of row state entries before LRU eviction */
+    maxSize: 1000,
+    /** Time-to-live in milliseconds (5 minutes) */
+    ttl: 5 * 60 * 1000
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@humanspeak/svelte-headless-table",
-  "version": "6.0.1",
+  "version": "6.0.2",
   "description": "A powerful, headless table library for Svelte that provides complete control over table UI while handling complex data operations like sorting, filtering, pagination, grouping, and row expansion. Build custom, accessible data tables with zero styling opinions.",
   "keywords": [
     "svelte",
@@ -58,54 +58,55 @@
     "!dist/**/*.spec.*"
   ],
   "dependencies": {
+    "@humanspeak/memory-cache": "^1.0.1",
     "@humanspeak/svelte-keyed": "^5.0.1",
     "@humanspeak/svelte-render": "^5.1.1",
     "@humanspeak/svelte-subscribe": "^5.0.0"
   },
   "devDependencies": {
-    "@eslint/compat": "^1.4.0",
-    "@eslint/js": "^9.37.0",
-    "@faker-js/faker": "^10.0.0",
-    "@playwright/test": "^1.56.0",
-    "@sveltejs/adapter-auto": "^6.1.1",
-    "@sveltejs/kit": "^2.46.4",
-    "@sveltejs/package": "^2.5.4",
+    "@eslint/compat": "^2.0.0",
+    "@eslint/js": "^9.39.2",
+    "@faker-js/faker": "^10.1.0",
+    "@playwright/test": "^1.57.0",
+    "@sveltejs/adapter-auto": "^7.0.0",
+    "@sveltejs/kit": "^2.49.2",
+    "@sveltejs/package": "^2.5.7",
     "@sveltejs/vite-plugin-svelte": "^6.2.1",
     "@testing-library/jest-dom": "^6.9.1",
-    "@testing-library/svelte": "^5.2.8",
+    "@testing-library/svelte": "^5.3.1",
     "@types/eslint": "9.6.1",
-    "@types/node": "^24.7.1",
-    "@typescript-eslint/eslint-plugin": "^8.46.0",
-    "@typescript-eslint/parser": "^8.46.0",
-    "@vitest/coverage-v8": "^3.2.4",
+    "@types/node": "^25.0.3",
+    "@typescript-eslint/eslint-plugin": "^8.51.0",
+    "@typescript-eslint/parser": "^8.51.0",
+    "@vitest/coverage-v8": "^4.0.16",
     "concurrently": "^9.2.1",
-    "eslint": "^9.37.0",
+    "eslint": "^9.39.2",
     "eslint-config-prettier": "10.1.8",
     "eslint-plugin-import": "2.32.0",
-    "eslint-plugin-svelte": "3.12.4",
-    "eslint-plugin-unused-imports": "4.2.0",
-    "globals": "^16.4.0",
+    "eslint-plugin-svelte": "3.13.1",
+    "eslint-plugin-unused-imports": "4.3.0",
+    "globals": "^16.5.0",
     "husky": "^9.1.7",
-    "prettier": "^3.6.2",
+    "prettier": "^3.7.4",
     "prettier-plugin-organize-imports": "^4.3.0",
     "prettier-plugin-sort-json": "^4.1.1",
-    "prettier-plugin-svelte": "^3.4.0",
-    "prettier-plugin-tailwindcss": "^0.6.14",
-    "publint": "^0.3.14",
-    "svelte": "^5.39.11",
-    "svelte-check": "^4.3.3",
+    "prettier-plugin-svelte": "^3.4.1",
+    "prettier-plugin-tailwindcss": "^0.7.2",
+    "publint": "^0.3.16",
+    "svelte": "^5.46.1",
+    "svelte-check": "^4.3.5",
     "tslib": "^2.8.1",
-    "type-fest": "^5.0.1",
+    "type-fest": "^5.3.1",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.46.0",
-    "vite": "^7.1.9",
-    "vitest": "^3.2.4"
+    "typescript-eslint": "^8.51.0",
+    "vite": "^7.3.0",
+    "vitest": "^4.0.16"
   },
   "peerDependencies": {
     "svelte": "^5.30.0"
   },
   "volta": {
-    "node": "22.18.0"
+    "node": "22.21.1"
   },
   "scripts": {
     "build": "vite build && npm run package",