@humanspeak/svelte-virtual-list 0.3.8 → 0.3.10

package/dist/utils/virtualList.js

@@ -1,3 +1,39 @@
+/**
+ * Validates a height value and returns it if valid, otherwise returns the fallback.
+ *
+ * A height is considered valid if it is a finite number greater than 0.
+ * This utility consolidates the repeated pattern of height validation
+ * found throughout the virtual list codebase.
+ *
+ * @param {unknown} height - The height value to validate
+ * @param {number} fallback - The fallback value to use if height is invalid
+ * @returns {number} The validated height or the fallback value
+ *
+ * @example
+ * ```typescript
+ * const height = getValidHeight(heightCache[i], calculatedItemHeight)
+ * // Returns heightCache[i] if valid, otherwise calculatedItemHeight
+ * ```
+ */
+export const getValidHeight = (height, fallback) => Number.isFinite(height) && height > 0 ? height : fallback;
+/**
+ * Clamps a numeric value to be within a specified range.
+ *
+ * This utility consolidates the repeated `Math.max(min, Math.min(max, value))`
+ * pattern used throughout scroll calculations and positioning logic.
+ *
+ * @param {number} value - The value to clamp
+ * @param {number} min - The minimum allowed value
+ * @param {number} max - The maximum allowed value
+ * @returns {number} The clamped value
+ *
+ * @example
+ * ```typescript
+ * const scrollTop = clampValue(targetScrollTop, 0, maxScrollTop)
+ * // Ensures scrollTop is between 0 and maxScrollTop
+ * ```
+ */
+export const clampValue = (value, min, max) => Math.max(min, Math.min(max, value));
 /**
  * Calculates the maximum scroll position for a virtual list.
  *
@@ -68,10 +104,7 @@ export const calculateVisibleRange = (scrollTop, viewportHeight, itemHeight, tot
             const adjustedEnd = totalItems;
             let startCore = adjustedEnd;
             let acc = 0;
-            const getH = (i) => {
-                const v = heightCache ? heightCache[i] : undefined;
-                return Number.isFinite(v) && v > 0 ? v : itemHeight;
-            };
+            const getH = (i) => getValidHeight(heightCache ? heightCache[i] : undefined, itemHeight);
             while (startCore > 0 && acc < viewportHeight) {
                 const h = getH(startCore - 1);
                 acc += h;
@@ -366,9 +399,7 @@ export const getScrollOffsetForIndex = (heightCache, calculatedItemHeight, idx,
         // Fallback: O(n) for a single query
         let offset = 0;
         for (let i = 0; i < safeIdx; i++) {
-            const raw = heightCache[i];
-            const height = Number.isFinite(raw) && raw > 0 ? raw : calculatedItemHeight;
-            offset += height;
+            offset += getValidHeight(heightCache[i], calculatedItemHeight);
         }
         return offset;
     }
@@ -381,9 +412,7 @@ export const getScrollOffsetForIndex = (heightCache, calculatedItemHeight, idx,
     let offset = offsetBase;
     const start = blockIdx * blockSize;
     for (let i = start; i < safeIdx; i++) {
-        const raw = heightCache[i];
-        const height = Number.isFinite(raw) && raw > 0 ? raw : calculatedItemHeight;
-        offset += height;
+        offset += getValidHeight(heightCache[i], calculatedItemHeight);
     }
     return offset;
 };
@@ -422,9 +451,7 @@ export const buildBlockSums = (heightCache, calculatedItemHeight, totalItems, bl
         const start = b * blockSize;
         const end = start + blockSize;
         for (let i = start; i < end; i++) {
-            const raw = heightCache[i];
-            const h = Number.isFinite(raw) && raw > 0 ? raw : calculatedItemHeight;
-            running += h;
+            running += getValidHeight(heightCache[i], calculatedItemHeight);
         }
         sums[b] = running;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@humanspeak/svelte-virtual-list",
-  "version": "0.3.8",
+  "version": "0.3.10",
   "description": "A lightweight, high-performance virtual list component for Svelte 5 that renders large datasets with minimal memory usage. Features include dynamic height support, smooth scrolling, TypeScript support, and efficient DOM recycling. Ideal for infinite scrolling lists, data tables, chat interfaces, and any application requiring the rendering of thousands of items without compromising performance. Zero dependencies and fully customizable.",
   "keywords": [
     "svelte",
@@ -59,19 +59,19 @@
     "esm-env": "^1.2.2"
   },
   "devDependencies": {
-    "@eslint/compat": "^2.0.1",
+    "@eslint/compat": "^2.0.2",
     "@eslint/js": "^9.39.2",
     "@faker-js/faker": "^10.2.0",
-    "@playwright/test": "^1.58.0",
+    "@playwright/test": "^1.58.1",
     "@sveltejs/adapter-auto": "^7.0.0",
-    "@sveltejs/kit": "^2.50.1",
+    "@sveltejs/kit": "^2.50.2",
     "@sveltejs/package": "^2.5.7",
     "@sveltejs/vite-plugin-svelte": "^6.2.4",
     "@tailwindcss/vite": "^4.1.18",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/svelte": "^5.3.1",
     "@testing-library/user-event": "^14.6.1",
-    "@types/node": "^25.1.0",
+    "@types/node": "^25.2.0",
     "@typescript-eslint/eslint-plugin": "^8.54.0",
     "@typescript-eslint/parser": "^8.54.0",
     "@vitest/coverage-v8": "^4.0.18",
@@ -81,17 +81,17 @@
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-svelte": "^3.14.0",
     "eslint-plugin-unused-imports": "^4.3.0",
-    "globals": "^17.2.0",
+    "globals": "^17.3.0",
     "husky": "^9.1.7",
-    "jsdom": "^27.4.0",
+    "jsdom": "^28.0.0",
     "prettier": "^3.8.1",
     "prettier-plugin-organize-imports": "^4.3.0",
     "prettier-plugin-sort-json": "^4.2.0",
     "prettier-plugin-svelte": "^3.4.1",
     "prettier-plugin-tailwindcss": "^0.7.2",
     "publint": "^0.3.17",
-    "svelte": "^5.48.5",
-    "svelte-check": "^4.3.5",
+    "svelte": "^5.49.1",
+    "svelte-check": "^4.3.6",
     "tailwindcss": "^4.1.18",
     "tw-animate-css": "^1.4.0",
     "typescript": "^5.9.3",