@tipolox/litgrid-renderer 1.0.0

package/dist/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tipolox
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { createVirtualizer } from './virtualization/createVirtualizer.js';
+export { createVariableVirtualizer } from './virtualization/createVariableVirtualizer.js';
+export { calculateDisplayLayout, mapDisplayScrollOffset } from './viewport/scrollMapping.js';
+export type { FixedVirtualizer, FixedVirtualRange, VariableVirtualizerOptions, VariableVirtualizerState, VariableVirtualizer, VariableVirtualRange, VirtualRange, VirtualizerOptions, VirtualizerState } from './virtualization/types.js';
+export type { DisplayLayout, DisplayLayoutOptions, ScrollMappingOptions, ScrollMappingResult } from './viewport/scrollMapping.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAA;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,+CAA+C,CAAA;AACzF,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AAC5F,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,0BAA0B,EAC1B,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,2BAA2B,CAAA;AAClC,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,6BAA6B,CAAA"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { createVirtualizer } from './virtualization/createVirtualizer.js';
+export { createVariableVirtualizer } from './virtualization/createVariableVirtualizer.js';
+export { calculateDisplayLayout, mapDisplayScrollOffset } from './viewport/scrollMapping.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAA;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,+CAA+C,CAAA;AACzF,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA"}

package/dist/utils/math.d.ts

@@ -0,0 +1,3 @@
+export declare function clamp(value: number, min: number, max: number): number;
+export declare function sumSizes(sizes: number[], startIndex: number, endIndex: number): number;
+//# sourceMappingURL=math.d.ts.map

package/dist/utils/math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../src/utils/math.ts"],"names":[],"mappings":"AAAA,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,UAE5D;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAQ7E"}

package/dist/utils/math.js

@@ -0,0 +1,11 @@
+export function clamp(value, min, max) {
+    return Math.min(Math.max(value, min), max);
+}
+export function sumSizes(sizes, startIndex, endIndex) {
+    let total = 0;
+    for (let index = startIndex; index < endIndex; index += 1) {
+        total += Math.max(1, sizes[index] ?? 0);
+    }
+    return total;
+}
+//# sourceMappingURL=math.js.map

package/dist/utils/math.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.js","sourceRoot":"","sources":["../../src/utils/math.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,KAAK,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IAC3D,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAA;AAC5C,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAe,EAAE,UAAkB,EAAE,QAAgB;IAC5E,IAAI,KAAK,GAAG,CAAC,CAAA;IAEb,KAAK,IAAI,KAAK,GAAG,UAAU,EAAE,KAAK,GAAG,QAAQ,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1D,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;IACzC,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/viewport/scrollMapping.d.ts

@@ -0,0 +1,27 @@
+export type ScrollMappingOptions = {
+    displayScrollOffset: number;
+    previousDisplayScrollOffset: number;
+    displaySize: number;
+    totalSize: number;
+    viewportSize: number;
+};
+export type ScrollMappingResult = {
+    availableDisplaySize: number;
+    availableVirtualSize: number;
+    scrollOffset: number;
+};
+export declare function mapDisplayScrollOffset({ displayScrollOffset, previousDisplayScrollOffset, displaySize, totalSize, viewportSize }: ScrollMappingOptions): ScrollMappingResult;
+export type DisplayLayoutOptions = {
+    totalSize: number;
+    displaySize: number;
+    virtualOffsetTop: number;
+    visibleSize: number;
+    bottomPadding: number;
+};
+export type DisplayLayout = {
+    displayScale: number;
+    displayOffsetTop: number;
+    displayBottomPadding: number;
+};
+export declare function calculateDisplayLayout({ totalSize, displaySize, virtualOffsetTop, visibleSize, bottomPadding }: DisplayLayoutOptions): DisplayLayout;
+//# sourceMappingURL=scrollMapping.d.ts.map

package/dist/viewport/scrollMapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrollMapping.d.ts","sourceRoot":"","sources":["../../src/viewport/scrollMapping.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,oBAAoB,GAAG;IACjC,mBAAmB,EAAE,MAAM,CAAA;IAC3B,2BAA2B,EAAE,MAAM,CAAA;IACnC,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,oBAAoB,EAAE,MAAM,CAAA;IAC5B,oBAAoB,EAAE,MAAM,CAAA;IAC5B,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,wBAAgB,sBAAsB,CAAC,EACrC,mBAAmB,EACnB,2BAA2B,EAC3B,WAAW,EACX,SAAS,EACT,YAAY,EACb,EAAE,oBAAoB,GAAG,mBAAmB,CA2B5C;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,gBAAgB,EAAE,MAAM,CAAA;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,YAAY,EAAE,MAAM,CAAA;IACpB,gBAAgB,EAAE,MAAM,CAAA;IACxB,oBAAoB,EAAE,MAAM,CAAA;CAC7B,CAAA;AAED,wBAAgB,sBAAsB,CAAC,EACrC,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,aAAa,EACd,EAAE,oBAAoB,GAAG,aAAa,CAWtC"}

package/dist/viewport/scrollMapping.js

@@ -0,0 +1,30 @@
+import { clamp } from '../utils/math.js';
+export function mapDisplayScrollOffset({ displayScrollOffset, previousDisplayScrollOffset, displaySize, totalSize, viewportSize }) {
+    const availableDisplaySize = Math.max(0, displaySize - viewportSize);
+    const availableVirtualSize = Math.max(0, totalSize - viewportSize);
+    if (totalSize > 0 && availableDisplaySize > 0 && availableVirtualSize > 0) {
+        const ratio = displayScrollOffset / availableDisplaySize;
+        const desiredScrollOffset = ratio * availableVirtualSize;
+        let scrollOffset = clamp(Number.isFinite(desiredScrollOffset) ? desiredScrollOffset : 0, 0, availableVirtualSize);
+        const bottomThreshold = 1;
+        const isScrollingDown = displayScrollOffset >= previousDisplayScrollOffset;
+        if (isScrollingDown && displayScrollOffset >= Math.max(0, availableDisplaySize - bottomThreshold)) {
+            scrollOffset = availableVirtualSize;
+        }
+        return { availableDisplaySize, availableVirtualSize, scrollOffset };
+    }
+    return {
+        availableDisplaySize,
+        availableVirtualSize,
+        scrollOffset: clamp(displayScrollOffset, 0, availableVirtualSize)
+    };
+}
+export function calculateDisplayLayout({ totalSize, displaySize, virtualOffsetTop, visibleSize, bottomPadding }) {
+    const displayScale = totalSize > 0 ? displaySize / totalSize : 1;
+    return {
+        displayScale,
+        displayOffsetTop: Math.min(virtualOffsetTop * displayScale, Math.max(0, displaySize - visibleSize)),
+        displayBottomPadding: bottomPadding * displayScale
+    };
+}
+//# sourceMappingURL=scrollMapping.js.map

package/dist/viewport/scrollMapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrollMapping.js","sourceRoot":"","sources":["../../src/viewport/scrollMapping.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAgBxC,MAAM,UAAU,sBAAsB,CAAC,EACrC,mBAAmB,EACnB,2BAA2B,EAC3B,WAAW,EACX,SAAS,EACT,YAAY,EACS;IACrB,MAAM,oBAAoB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,YAAY,CAAC,CAAA;IACpE,MAAM,oBAAoB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC,CAAA;IAElE,IAAI,SAAS,GAAG,CAAC,IAAI,oBAAoB,GAAG,CAAC,IAAI,oBAAoB,GAAG,CAAC,EAAE,CAAC;QAC1E,MAAM,KAAK,GAAG,mBAAmB,GAAG,oBAAoB,CAAA;QACxD,MAAM,mBAAmB,GAAG,KAAK,GAAG,oBAAoB,CAAA;QACxD,IAAI,YAAY,GAAG,KAAK,CACtB,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,EAC9D,CAAC,EACD,oBAAoB,CACrB,CAAA;QAED,MAAM,eAAe,GAAG,CAAC,CAAA;QACzB,MAAM,eAAe,GAAG,mBAAmB,IAAI,2BAA2B,CAAA;QAC1E,IAAI,eAAe,IAAI,mBAAmB,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,oBAAoB,GAAG,eAAe,CAAC,EAAE,CAAC;YAClG,YAAY,GAAG,oBAAoB,CAAA;QACrC,CAAC;QAED,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,YAAY,EAAE,CAAA;IACrE,CAAC;IAED,OAAO;QACL,oBAAoB;QACpB,oBAAoB;QACpB,YAAY,EAAE,KAAK,CAAC,mBAAmB,EAAE,CAAC,EAAE,oBAAoB,CAAC;KAClE,CAAA;AACH,CAAC;AAgBD,MAAM,UAAU,sBAAsB,CAAC,EACrC,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,aAAa,EACQ;IACrB,MAAM,YAAY,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;IAEhE,OAAO;QACL,YAAY;QACZ,gBAAgB,EAAE,IAAI,CAAC,GAAG,CACxB,gBAAgB,GAAG,YAAY,EAC/B,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,WAAW,CAAC,CACvC;QACD,oBAAoB,EAAE,aAAa,GAAG,YAAY;KACnD,CAAA;AACH,CAAC"}

package/dist/virtualization/createVariableVirtualizer.d.ts

@@ -0,0 +1,3 @@
+import type { VariableVirtualizer, VariableVirtualizerOptions } from './types.js';
+export declare function createVariableVirtualizer({ sizes, viewportSize, overscan }: VariableVirtualizerOptions): VariableVirtualizer;
+//# sourceMappingURL=createVariableVirtualizer.d.ts.map

package/dist/virtualization/createVariableVirtualizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createVariableVirtualizer.d.ts","sourceRoot":"","sources":["../../src/virtualization/createVariableVirtualizer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,0BAA0B,EAE3B,MAAM,YAAY,CAAA;AAEnB,wBAAgB,yBAAyB,CAAC,EACxC,KAAK,EACL,YAAY,EACZ,QAAY,EACb,EAAE,0BAA0B,GAAG,mBAAmB,CAkElD"}

package/dist/virtualization/createVariableVirtualizer.js

@@ -0,0 +1,58 @@
+import { clamp, sumSizes } from '../utils/math.js';
+export function createVariableVirtualizer({ sizes, viewportSize, overscan = 2 }) {
+    let state = {
+        sizes,
+        viewportSize,
+        overscan,
+        scrollOffset: 0
+    };
+    return {
+        setOptions(next) {
+            state = {
+                ...state,
+                ...next
+            };
+        },
+        setScrollOffset(scrollOffset) {
+            state.scrollOffset = scrollOffset;
+        },
+        getState() {
+            const sizes = state.sizes.map((size) => Math.max(1, size));
+            const count = sizes.length;
+            const totalSize = sumSizes(sizes, 0, count);
+            const safeViewportSize = Math.max(0, state.viewportSize);
+            const safeOverscan = Math.max(0, state.overscan);
+            const safeScrollOffset = clamp(state.scrollOffset, 0, totalSize);
+            let baseStartIndex = 0;
+            let baseStartOffset = 0;
+            while (baseStartIndex < count &&
+                baseStartOffset + sizes[baseStartIndex] <= safeScrollOffset) {
+                baseStartOffset += sizes[baseStartIndex];
+                baseStartIndex += 1;
+            }
+            let visibleEndIndex = baseStartIndex;
+            let visibleEndOffset = baseStartOffset;
+            while (visibleEndIndex < count &&
+                visibleEndOffset < safeScrollOffset + safeViewportSize) {
+                visibleEndOffset += sizes[visibleEndIndex];
+                visibleEndIndex += 1;
+            }
+            const startIndex = clamp(baseStartIndex - safeOverscan, 0, count);
+            const endIndex = clamp(visibleEndIndex + safeOverscan, startIndex, count);
+            const leftPadding = sumSizes(sizes, 0, startIndex);
+            const visibleSize = sumSizes(sizes, startIndex, endIndex);
+            const rightPadding = Math.max(0, totalSize - leftPadding - visibleSize);
+            return {
+                startIndex,
+                endIndex,
+                leftPadding,
+                rightPadding,
+                offsetTop: leftPadding,
+                bottomPadding: rightPadding,
+                totalSize,
+                visibleSize
+            };
+        }
+    };
+}
+//# sourceMappingURL=createVariableVirtualizer.js.map

package/dist/virtualization/createVariableVirtualizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createVariableVirtualizer.js","sourceRoot":"","sources":["../../src/virtualization/createVariableVirtualizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAOlD,MAAM,UAAU,yBAAyB,CAAC,EACxC,KAAK,EACL,YAAY,EACZ,QAAQ,GAAG,CAAC,EACe;IAC3B,IAAI,KAAK,GAA6B;QACpC,KAAK;QACL,YAAY;QACZ,QAAQ;QACR,YAAY,EAAE,CAAC;KAChB,CAAA;IAED,OAAO;QACL,UAAU,CAAC,IAAuC;YAChD,KAAK,GAAG;gBACN,GAAG,KAAK;gBACR,GAAG,IAAI;aACR,CAAA;QACH,CAAC;QACD,eAAe,CAAC,YAAoB;YAClC,KAAK,CAAC,YAAY,GAAG,YAAY,CAAA;QACnC,CAAC;QACD,QAAQ;YACN,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;YAC1D,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAA;YAC1B,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,CAAA;YAC3C,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,CAAA;YACxD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAA;YAChD,MAAM,gBAAgB,GAAG,KAAK,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,EAAE,SAAS,CAAC,CAAA;YAEhE,IAAI,cAAc,GAAG,CAAC,CAAA;YACtB,IAAI,eAAe,GAAG,CAAC,CAAA;YAEvB,OACE,cAAc,GAAG,KAAK;gBACtB,eAAe,GAAG,KAAK,CAAC,cAAc,CAAC,IAAI,gBAAgB,EAC3D,CAAC;gBACD,eAAe,IAAI,KAAK,CAAC,cAAc,CAAC,CAAA;gBACxC,cAAc,IAAI,CAAC,CAAA;YACrB,CAAC;YAED,IAAI,eAAe,GAAG,cAAc,CAAA;YACpC,IAAI,gBAAgB,GAAG,eAAe,CAAA;YAEtC,OACE,eAAe,GAAG,KAAK;gBACvB,gBAAgB,GAAG,gBAAgB,GAAG,gBAAgB,EACtD,CAAC;gBACD,gBAAgB,IAAI,KAAK,CAAC,eAAe,CAAC,CAAA;gBAC1C,eAAe,IAAI,CAAC,CAAA;YACtB,CAAC;YAED,MAAM,UAAU,GAAG,KAAK,CAAC,cAAc,GAAG,YAAY,EAAE,CAAC,EAAE,KAAK,CAAC,CAAA;YACjE,MAAM,QAAQ,GAAG,KAAK,CAAC,eAAe,GAAG,YAAY,EAAE,UAAU,EAAE,KAAK,CAAC,CAAA;YACzE,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,UAAU,CAAC,CAAA;YAClD,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAA;YACzD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC,CAAA;YAEvE,OAAO;gBACL,UAAU;gBACV,QAAQ;gBACR,WAAW;gBACX,YAAY;gBACZ,SAAS,EAAE,WAAW;gBACtB,aAAa,EAAE,YAAY;gBAC3B,SAAS;gBACT,WAAW;aACZ,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/virtualization/createVirtualizer.d.ts

@@ -0,0 +1,3 @@
+import type { FixedVirtualizer, VirtualizerOptions } from './types.js';
+export declare function createVirtualizer({ rowHeight, viewportHeight, overscan }: VirtualizerOptions): FixedVirtualizer;
+//# sourceMappingURL=createVirtualizer.d.ts.map

package/dist/virtualization/createVirtualizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createVirtualizer.d.ts","sourceRoot":"","sources":["../../src/virtualization/createVirtualizer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAoB,MAAM,YAAY,CAAA;AAExF,wBAAgB,iBAAiB,CAAC,EAChC,SAAS,EACT,cAAc,EACd,QAAY,EACb,EAAE,kBAAkB,GAAG,gBAAgB,CAyDvC"}

package/dist/virtualization/createVirtualizer.js

@@ -0,0 +1,48 @@
+import { clamp } from '../utils/math.js';
+export function createVirtualizer({ rowHeight, viewportHeight, overscan = 4 }) {
+    let state = {
+        rowHeight,
+        viewportHeight,
+        overscan,
+        scrollTop: 0
+    };
+    return {
+        setOptions(next) {
+            state = {
+                ...state,
+                ...next
+            };
+        },
+        setScrollTop(scrollTop) {
+            state.scrollTop = scrollTop;
+        },
+        setScrollOffset(scrollTop) {
+            state.scrollTop = scrollTop;
+        },
+        getState(count) {
+            const safeCount = Math.max(0, count);
+            const safeRowHeight = Math.max(1, state.rowHeight);
+            const safeViewportHeight = Math.max(0, state.viewportHeight);
+            const safeOverscan = Math.max(0, state.overscan);
+            const visibleCount = Math.max(1, Math.ceil(safeViewportHeight / safeRowHeight));
+            const maxStartIndex = Math.max(0, safeCount - visibleCount);
+            const baseStartIndex = clamp(Math.floor(state.scrollTop / safeRowHeight), 0, maxStartIndex);
+            const startIndex = clamp(baseStartIndex - safeOverscan, 0, safeCount);
+            const endIndex = clamp(baseStartIndex + visibleCount + safeOverscan, startIndex, safeCount);
+            const offsetTop = startIndex * safeRowHeight;
+            const totalHeight = safeCount * safeRowHeight;
+            const visibleSize = (endIndex - startIndex) * safeRowHeight;
+            return {
+                startIndex,
+                endIndex,
+                offsetTop,
+                bottomPadding: Math.max(0, totalHeight - endIndex * safeRowHeight),
+                totalHeight,
+                totalSize: totalHeight,
+                visibleCount,
+                visibleSize
+            };
+        }
+    };
+}
+//# sourceMappingURL=createVirtualizer.js.map

package/dist/virtualization/createVirtualizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createVirtualizer.js","sourceRoot":"","sources":["../../src/virtualization/createVirtualizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAGxC,MAAM,UAAU,iBAAiB,CAAC,EAChC,SAAS,EACT,cAAc,EACd,QAAQ,GAAG,CAAC,EACO;IACnB,IAAI,KAAK,GAAqB;QAC5B,SAAS;QACT,cAAc;QACd,QAAQ;QACR,SAAS,EAAE,CAAC;KACb,CAAA;IAED,OAAO;QACL,UAAU,CAAC,IAA+B;YACxC,KAAK,GAAG;gBACN,GAAG,KAAK;gBACR,GAAG,IAAI;aACR,CAAA;QACH,CAAC;QACD,YAAY,CAAC,SAAiB;YAC5B,KAAK,CAAC,SAAS,GAAG,SAAS,CAAA;QAC7B,CAAC;QACD,eAAe,CAAC,SAAiB;YAC/B,KAAK,CAAC,SAAS,GAAG,SAAS,CAAA;QAC7B,CAAC;QACD,QAAQ,CAAC,KAAa;YACpB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;YACpC,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,CAAA;YAClD,MAAM,kBAAkB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,CAAA;YAC5D,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAA;YAChD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,kBAAkB,GAAG,aAAa,CAAC,CAAC,CAAA;YAC/E,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC,CAAA;YAE3D,MAAM,cAAc,GAAG,KAAK,CAC1B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,aAAa,CAAC,EAC3C,CAAC,EACD,aAAa,CACd,CAAA;YAED,MAAM,UAAU,GAAG,KAAK,CAAC,cAAc,GAAG,YAAY,EAAE,CAAC,EAAE,SAAS,CAAC,CAAA;YACrE,MAAM,QAAQ,GAAG,KAAK,CACpB,cAAc,GAAG,YAAY,GAAG,YAAY,EAC5C,UAAU,EACV,SAAS,CACV,CAAA;YACD,MAAM,SAAS,GAAG,UAAU,GAAG,aAAa,CAAA;YAC5C,MAAM,WAAW,GAAG,SAAS,GAAG,aAAa,CAAA;YAC7C,MAAM,WAAW,GAAG,CAAC,QAAQ,GAAG,UAAU,CAAC,GAAG,aAAa,CAAA;YAE3D,OAAO;gBACL,UAAU;gBACV,QAAQ;gBACR,SAAS;gBACT,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,QAAQ,GAAG,aAAa,CAAC;gBAClE,WAAW;gBACX,SAAS,EAAE,WAAW;gBACtB,YAAY;gBACZ,WAAW;aACZ,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/virtualization/types.d.ts

@@ -0,0 +1,50 @@
+export type VirtualizerOptions = {
+    rowHeight: number;
+    viewportHeight: number;
+    overscan?: number;
+};
+export type VirtualizerState = {
+    rowHeight: number;
+    viewportHeight: number;
+    overscan: number;
+    scrollTop: number;
+};
+export type VirtualRange = {
+    startIndex: number;
+    endIndex: number;
+    offsetTop: number;
+    bottomPadding: number;
+    totalSize: number;
+    visibleSize: number;
+};
+export type FixedVirtualRange = VirtualRange & {
+    totalHeight: number;
+    visibleCount: number;
+};
+export type FixedVirtualizer = {
+    setOptions: (next: Partial<VirtualizerState>) => void;
+    setScrollTop: (scrollTop: number) => void;
+    setScrollOffset: (scrollTop: number) => void;
+    getState: (count: number) => FixedVirtualRange;
+};
+export type VariableVirtualizerOptions = {
+    sizes: number[];
+    viewportSize: number;
+    overscan?: number;
+};
+export type VariableVirtualizerState = {
+    sizes: number[];
+    viewportSize: number;
+    overscan: number;
+    scrollOffset: number;
+};
+export type VariableVirtualRange = VirtualRange & {
+    leftPadding: number;
+    rightPadding: number;
+};
+export type VariableVirtualizer = {
+    setOptions: (next: Partial<VariableVirtualizerState>) => void;
+    setScrollOffset: (scrollOffset: number) => void;
+    getState: () => VariableVirtualRange;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/virtualization/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/virtualization/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG;IAC7C,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAA;IACrD,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IACzC,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5C,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,iBAAiB,CAAA;CAC/C,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG;IAChD,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,wBAAwB,CAAC,KAAK,IAAI,CAAA;IAC7D,eAAe,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/C,QAAQ,EAAE,MAAM,oBAAoB,CAAA;CACrC,CAAA"}

package/dist/virtualization/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/virtualization/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/virtualization/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@tipolox/litgrid-renderer",
+  "version": "1.0.0",
+  "description": "Virtualization and scroll-mapping utilities for LitGrid.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "data-grid",
+    "grid",
+    "virtualization",
+    "scrolling"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tipolox/litgrid.git",
+    "directory": "packages/grid-renderer"
+  },
+  "homepage": "https://github.com/tipolox/litgrid#readme",
+  "bugs": {
+    "url": "https://github.com/tipolox/litgrid/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "prebuild": "node -e \"const fs=require('node:fs'); fs.rmSync('dist',{recursive:true,force:true}); fs.mkdirSync('dist',{recursive:true}); fs.copyFileSync('../../LICENSE','dist/LICENSE')\"",
+    "build": "tsc -p tsconfig.build.json",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  }
+}