react-virtual-renderer 1.0.3

package/dist/utils/helpers.js

@@ -0,0 +1,166 @@
+/**
+ * Binary search to find the item at a given scroll offset
+ */
+export function binarySearch(offsets, target, low = 0, high = offsets.length - 1) {
+    while (low <= high) {
+        const mid = Math.floor((low + high) / 2);
+        const offset = offsets[mid];
+        if (offset === target) {
+            return mid;
+        }
+        else if (offset < target) {
+            low = mid + 1;
+        }
+        else {
+            high = mid - 1;
+        }
+    }
+    return Math.max(0, high);
+}
+/**
+ * Calculate range with overscan
+ */
+export function getOverscanRange(startIndex, endIndex, overscan, itemCount) {
+    return {
+        start: Math.max(0, startIndex - overscan),
+        end: Math.min(itemCount - 1, endIndex + overscan),
+    };
+}
+/**
+ * Debounce function
+ */
+export function debounce(fn, delay) {
+    let timeoutId = null;
+    return (...args) => {
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+        }
+        timeoutId = setTimeout(() => {
+            fn(...args);
+            timeoutId = null;
+        }, delay);
+    };
+}
+/**
+ * Throttle function
+ */
+export function throttle(fn, delay) {
+    let lastCall = 0;
+    let timeoutId = null;
+    return (...args) => {
+        const now = Date.now();
+        if (now - lastCall >= delay) {
+            fn(...args);
+            lastCall = now;
+        }
+        else if (!timeoutId) {
+            timeoutId = setTimeout(() => {
+                fn(...args);
+                lastCall = Date.now();
+                timeoutId = null;
+            }, delay - (now - lastCall));
+        }
+    };
+}
+/**
+ * Request animation frame wrapper
+ */
+export function requestAnimationFrameWithFallback(callback) {
+    if (typeof window !== 'undefined' && 'requestAnimationFrame' in window) {
+        return window.requestAnimationFrame(callback);
+    }
+    // Fallback for environments without RAF
+    return setTimeout(callback, 16);
+}
+/**
+ * Cancel animation frame with fallback
+ */
+export function cancelAnimationFrameWithFallback(id) {
+    if (typeof window !== 'undefined' && 'cancelAnimationFrame' in window) {
+        window.cancelAnimationFrame(id);
+    }
+    else {
+        clearTimeout(id);
+    }
+}
+/**
+ * Check if an element is visible in viewport
+ */
+export function isElementInViewport(element, container) {
+    const elementRect = element.getBoundingClientRect();
+    const containerRect = container.getBoundingClientRect();
+    return (elementRect.top >= containerRect.top &&
+        elementRect.left >= containerRect.left &&
+        elementRect.bottom <= containerRect.bottom &&
+        elementRect.right <= containerRect.right);
+}
+/**
+ * Get scroll velocity
+ */
+export function calculateScrollVelocity(currentOffset, previousOffset, deltaTime) {
+    if (deltaTime === 0)
+        return 0;
+    return Math.abs(currentOffset - previousOffset) / deltaTime;
+}
+/**
+ * Clamp a value between min and max
+ */
+export function clamp(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}
+/**
+ * Check if ResizeObserver is supported
+ */
+export function isResizeObserverSupported() {
+    return typeof window !== 'undefined' && 'ResizeObserver' in window;
+}
+/**
+ * Check if IntersectionObserver is supported
+ */
+export function isIntersectionObserverSupported() {
+    return typeof window !== 'undefined' && 'IntersectionObserver' in window;
+}
+/**
+ * Smooth scroll to position
+ */
+export function smoothScroll(element, targetScroll, duration = 300) {
+    return new Promise((resolve) => {
+        const startScroll = element.scrollTop;
+        const distance = targetScroll - startScroll;
+        const startTime = performance.now();
+        const easeInOutQuad = (t) => {
+            return t < 0.5 ? 2 * t * t : -1 + (4 - 2 * t) * t;
+        };
+        const scroll = (currentTime) => {
+            const elapsed = currentTime - startTime;
+            const progress = Math.min(elapsed / duration, 1);
+            const easeProgress = easeInOutQuad(progress);
+            element.scrollTop = startScroll + distance * easeProgress;
+            if (progress < 1) {
+                requestAnimationFrameWithFallback(scroll);
+            }
+            else {
+                resolve();
+            }
+        };
+        requestAnimationFrameWithFallback(scroll);
+    });
+}
+/**
+ * Create a unique key from index and item
+ */
+export function createItemKey(index, item, keyGetter) {
+    if (keyGetter) {
+        return keyGetter(index, item);
+    }
+    return index;
+}
+/**
+ * Log virtualization stats (for debugging)
+ */
+export function logVirtualizationStats(stats) {
+    if (typeof process !== 'undefined' && process.env.DEBUG_VIRTUALIZE) {
+        console.log(`[Virtualize] Items: ${stats.itemCount}, Visible: ${stats.visibleCount}, Rendered: ${stats.renderedCount}, Offset: ${stats.scrollOffset}/${stats.totalSize}`);
+    }
+}
+//# sourceMappingURL=helpers.js.map

package/dist/utils/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,111 @@
+{
+  "name": "react-virtual-renderer",
+  "version": "1.0.3",
+  "description": "High-performance React virtualization library with dynamic sizing, bidirectional scrolling, and accessibility",
+  "author": "Rishabh Agarwal",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.esm.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.cjs"
+    },
+    "./performance": {
+      "types": "./dist/performance/metrics.d.ts",
+      "import": "./dist/performance/metrics.js"
+    },
+    "./accessibility": {
+      "types": "./dist/accessibility/a11y.d.ts",
+      "import": "./dist/accessibility/a11y.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc && rollup -c",
+    "clean": "rm -rf dist",
+    "lint": "eslint src --ext .ts,.tsx",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "react",
+    "react-virtual-renderer",
+    "react-virtualized",
+    "react-window",
+    "react-windowing",
+    "react-virtual-list",
+    "react-scroller",
+    "react-infinite-scroll",
+    "react-lazy-render",
+    "react-performance",
+    "virtualization",
+    "virtual-scroll",
+    "virtual-list",
+    "virtual-rendering",
+    "windowing",
+    "list-windowing",
+    "dom-windowing",
+    "infinite-scroll",
+    "lazy-loading",
+    "lazy-rendering",
+    "intersection-observer",
+    "large-list",
+    "large-dataset",
+    "big-data-ui",
+    "high-performance",
+    "dynamic-height",
+    "dynamic-sizing",
+    "variable-height",
+    "variable-size",
+    "grid",
+    "virtual-grid",
+    "masonry",
+    "masonry-layout",
+    "accessibility",
+    "a11y",
+    "wcag",
+    "aria",
+    "typescript",
+    "frontend",
+    "ui-performance"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rishabh-agarwal-business/virtualize.git"
+  },
+  "bugs": {
+    "url": "https://github.com/rishabh-agarwal-business/virtualize/issues"
+  },
+  "homepage": "https://github.com/rishabh-agarwal-business/virtualize#readme",
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^29.0.3",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^12.3.0",
+    "@testing-library/react": "^13.0.0",
+    "@types/node": "^25.9.1",
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "jest": "^29.0.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "rollup": "^4.50.0",
+    "typescript": "^5.9.2"
+  }
+}