@ceriousdevtech/react-cerious-scroll 1.0.2 → 1.0.3

package/CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to react-cerious-scroll will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.3] - 2026-06-03
+
+### Dependencies
+- Bumped peer dependency `@ceriousdevtech/cerious-scroll` to `^1.0.4`. Consumers get smooth wheel scrolling (eased over ~150ms, configurable via `wheel: { smooth }`) and the engine now reads viewport height from `[data-cerious-scroll-content]` so wrappers that put a horizontal scrollbar on the inner element get the last row clearance for free.
+
+### Changed
+- The inner content element is now styled `overflow-y: clip; overflow-x: auto` so consumers can opt into a horizontal scrollbar on the rows axis without a stray vertical bar appearing.
+
 ## [1.0.2] - 2026-06-03
 
 ### Added

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const J=require("react/jsx-runtime"),r=require("react"),H=require("react-dom"),K=require("react-dom/server"),_=require("@ceriousdevtech/cerious-scroll"),V="data-cerious-scroll-content",Q="data-cerious-scroll-row";function U(e){const l=e.querySelector(`[${V}]`);if(l)return l;const n=document.createElement("div");return n.setAttribute(V,""),n.style.position="relative",n.style.width="100%",n.style.height="100%",n.style.overflow="hidden",e.appendChild(n),n}function X(e,l){const n=u=>{const o=u.detail;o&&l({percentage:o.percentage,currentElement:o.currentElement,scrollOffset:o.scrollOffset,result:{element:o.result.element,offset:o.result.offset}})},a=u=>{const o=u.detail;o&&l({percentage:o.percentage,currentElement:o.element,scrollOffset:o.scrollOffset,result:{element:o.element,offset:o.scrollOffset}})};return e.addEventListener("cerious-viewport-change",n),e.addEventListener("viewport-change",a),()=>{e.removeEventListener("cerious-viewport-change",n),e.removeEventListener("viewport-change",a)}}function Y(e,l){const n=typeof e=="number"?e:typeof l=="number"?l:void 0;if(n===void 0||Number.isNaN(n))throw new Error("useCeriousScroll: provide `totalElements` or `items`.");return Math.max(1,Math.floor(n))}function D(e){var N;const l=r.useRef(null),n=r.useRef(null),a=r.useRef(new Map),u=r.useRef(null),[,o]=r.useReducer(t=>t+1,0),[q,O]=r.useState(null),S=r.useRef(e.renderItem),d=r.useRef(e.items??null),v=r.useRef(e.getItem),p=r.useRef(e.options),h=r.useRef(e.autoRender??!0),b=r.useRef(e.totalElements??null),g=r.useRef(e.onViewportChange),T=r.useRef(e.onMeasuredViewport),I=r.useRef(e.onReady);S.current=e.renderItem,d.current=e.items??null,v.current=e.getItem,p.current=e.options,h.current=e.autoRender??!0,b.current=e.totalElements??null,g.current=e.onViewportChange,T.current=e.onMeasuredViewport,I.current=e.onReady;const k=r.useCallback(t=>{const c=v.current;if(c)return c(t);const R=d.current;return R?R[t]:void 0},[]),s=r.useCallback(()=>{var y;const t=n.current;if(!t)return null;const{scroller:c,contentEl:R,container:C}=t,j=C.clientHeight||C.offsetHeight||0,w=[],i=(f,E)=>{const m=document.createElement("div");m.setAttribute(Q,String(f)),m.innerHTML=K.renderToStaticMarkup(r.createElement(r.Fragment,null,S.current(k(f),f))),E.appendChild(m),a.current.set(f,{el:E,mount:m}),w.push(m)},A=c.renderViewport(j,R,i),M=new Set(c.getRenderedIndices());return a.current.forEach((f,E)=>{M.has(E)||a.current.delete(E)}),w.forEach(f=>{f.textContent=""}),H.flushSync(o),(y=T.current)==null||y.call(T,A),A},[]),B=e.totalElements??((N=e.items)==null?void 0:N.length)??null;r.useEffect(()=>{var y,f;const t=l.current;if(!t)return;const c=U(t),R=p.current??{},C=R.onScroll,j={...R,onScroll:()=>{C==null||C(),h.current&&s()}},w=Y(b.current,((y=d.current)==null?void 0:y.length)??null),i=new _.CeriousScroll(t,w,j);u.current&&(i.currentElement=Math.min(u.current.currentElement,w-1),i.scrollOffset=u.current.scrollOffset,u.current=null),n.current={scroller:i,contentEl:c,container:t},O(i);const A=X(t,E=>{var m;(m=g.current)==null||m.call(g,E)});(f=I.current)==null||f.call(I,i);let M=0;return h.current&&(M=requestAnimationFrame(()=>s())),()=>{cancelAnimationFrame(M),A(),u.current={currentElement:i.currentElement,scrollOffset:i.scrollOffset},a.current.clear(),c.textContent="",i.detachScrollbar(t),i.dispose(),n.current=null,O(null)}},[B,s]),r.useEffect(()=>{if(!n.current||!h.current)return;const t=requestAnimationFrame(()=>s());return()=>cancelAnimationFrame(t)},[e.items,e.getItem]);const W=r.useCallback(t=>{const c=n.current;return c?(c.scroller.jumpToElement(t),s()):null},[s]),$=r.useCallback(t=>{const c=n.current;return c?(c.scroller.handleScrollPercentage(t),s()):null},[s]),z=r.useCallback(()=>{const t=n.current;return t?(t.scroller.reset(),s()):null},[s]),G=r.useCallback(()=>{const t=n.current;return t?(t.scroller.clearAllCaches(),s()):null},[s]),P=d.current,F=!v.current&&P!=null?P.length:null,L=[];return a.current.forEach((t,c)=>{F!==null&&c>=F||L.push(H.createPortal(S.current(k(c),c),t.mount,String(c)))}),{containerRef:l,portals:L,scroller:q,render:s,jumpToElement:W,scrollToPercentage:$,reset:z,recalculate:G}}function Z(e,l){const{className:n,style:a,"data-testid":u,children:o,...q}=e,{containerRef:O,portals:S,scroller:d,render:v,jumpToElement:p,scrollToPercentage:h,reset:b,recalculate:g}=D(q);return r.useImperativeHandle(l,()=>({scroller:d,render:v,jumpToElement:p,scrollToPercentage:h,reset:b,recalculate:g}),[d,v,p,h,b,g]),J.jsxs("div",{ref:O,className:n,"data-testid":u,style:{position:"relative",overflow:"hidden",...a},children:[o,S]})}const x=r.forwardRef(Z);Object.defineProperty(exports,"CeriousScrollEngine",{enumerable:!0,get:()=>_.CeriousScroll});exports.CeriousScroll=x;exports.useCeriousScroll=D;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const z=require("react/jsx-runtime"),r=require("react"),H=require("react-dom"),G=require("react-dom/server"),_=require("@ceriousdevtech/cerious-scroll"),V="data-cerious-scroll-content",J="data-cerious-scroll-row";function K(e){const l=e.querySelector(`[${V}]`);if(l)return l;const n=document.createElement("div");return n.setAttribute(V,""),n.style.position="relative",n.style.width="100%",n.style.height="100%",n.style.overflowY="clip",n.style.overflowX="auto",e.appendChild(n),n}function Q(e,l){const n=u=>{const o=u.detail;o&&l({percentage:o.percentage,currentElement:o.currentElement,scrollOffset:o.scrollOffset,result:{element:o.result.element,offset:o.result.offset}})},a=u=>{const o=u.detail;o&&l({percentage:o.percentage,currentElement:o.element,scrollOffset:o.scrollOffset,result:{element:o.element,offset:o.scrollOffset}})};return e.addEventListener("cerious-viewport-change",n),e.addEventListener("viewport-change",a),()=>{e.removeEventListener("cerious-viewport-change",n),e.removeEventListener("viewport-change",a)}}function U(e,l){const n=typeof e=="number"?e:typeof l=="number"?l:void 0;if(n===void 0||Number.isNaN(n))throw new Error("useCeriousScroll: provide `totalElements` or `items`.");return Math.max(1,Math.floor(n))}function D(e){var N;const l=r.useRef(null),n=r.useRef(null),a=r.useRef(new Map),u=r.useRef(null),[,o]=r.useReducer(t=>t+1,0),[q,O]=r.useState(null),S=r.useRef(e.renderItem),d=r.useRef(e.items??null),v=r.useRef(e.getItem),p=r.useRef(e.options),h=r.useRef(e.autoRender??!0),b=r.useRef(e.totalElements??null),g=r.useRef(e.onViewportChange),T=r.useRef(e.onMeasuredViewport),I=r.useRef(e.onReady);S.current=e.renderItem,d.current=e.items??null,v.current=e.getItem,p.current=e.options,h.current=e.autoRender??!0,b.current=e.totalElements??null,g.current=e.onViewportChange,T.current=e.onMeasuredViewport,I.current=e.onReady;const k=r.useCallback(t=>{const c=v.current;if(c)return c(t);const R=d.current;return R?R[t]:void 0},[]),s=r.useCallback(()=>{var y;const t=n.current;if(!t)return null;const{scroller:c,contentEl:R,container:C}=t,j=C.clientHeight||C.offsetHeight||0,w=[],i=(f,E)=>{const m=document.createElement("div");m.setAttribute(J,String(f)),m.innerHTML=G.renderToStaticMarkup(r.createElement(r.Fragment,null,S.current(k(f),f))),E.appendChild(m),a.current.set(f,{el:E,mount:m}),w.push(m)},A=c.renderViewport(j,R,i),M=new Set(c.getRenderedIndices());return a.current.forEach((f,E)=>{M.has(E)||a.current.delete(E)}),w.forEach(f=>{f.textContent=""}),H.flushSync(o),(y=T.current)==null||y.call(T,A),A},[]),B=e.totalElements??((N=e.items)==null?void 0:N.length)??null;r.useEffect(()=>{var y,f;const t=l.current;if(!t)return;const c=K(t),R=p.current??{},C=R.onScroll,j={...R,onScroll:()=>{C==null||C(),h.current&&s()}},w=U(b.current,((y=d.current)==null?void 0:y.length)??null),i=new _.CeriousScroll(t,w,j);u.current&&(i.currentElement=Math.min(u.current.currentElement,w-1),i.scrollOffset=u.current.scrollOffset,u.current=null),n.current={scroller:i,contentEl:c,container:t},O(i);const A=Q(t,E=>{var m;(m=g.current)==null||m.call(g,E)});(f=I.current)==null||f.call(I,i);let M=0;return h.current&&(M=requestAnimationFrame(()=>s())),()=>{cancelAnimationFrame(M),A(),u.current={currentElement:i.currentElement,scrollOffset:i.scrollOffset},a.current.clear(),c.textContent="",i.detachScrollbar(t),i.dispose(),n.current=null,O(null)}},[B,s]),r.useEffect(()=>{if(!n.current||!h.current)return;const t=requestAnimationFrame(()=>s());return()=>cancelAnimationFrame(t)},[e.items,e.getItem]);const W=r.useCallback(t=>{const c=n.current;return c?(c.scroller.jumpToElement(t),s()):null},[s]),X=r.useCallback(t=>{const c=n.current;return c?(c.scroller.handleScrollPercentage(t),s()):null},[s]),Y=r.useCallback(()=>{const t=n.current;return t?(t.scroller.reset(),s()):null},[s]),$=r.useCallback(()=>{const t=n.current;return t?(t.scroller.clearAllCaches(),s()):null},[s]),P=d.current,F=!v.current&&P!=null?P.length:null,L=[];return a.current.forEach((t,c)=>{F!==null&&c>=F||L.push(H.createPortal(S.current(k(c),c),t.mount,String(c)))}),{containerRef:l,portals:L,scroller:q,render:s,jumpToElement:W,scrollToPercentage:X,reset:Y,recalculate:$}}function Z(e,l){const{className:n,style:a,"data-testid":u,children:o,...q}=e,{containerRef:O,portals:S,scroller:d,render:v,jumpToElement:p,scrollToPercentage:h,reset:b,recalculate:g}=D(q);return r.useImperativeHandle(l,()=>({scroller:d,render:v,jumpToElement:p,scrollToPercentage:h,reset:b,recalculate:g}),[d,v,p,h,b,g]),z.jsxs("div",{ref:O,className:n,"data-testid":u,style:{position:"relative",overflow:"hidden",...a},children:[o,S]})}const x=r.forwardRef(Z);Object.defineProperty(exports,"CeriousScrollEngine",{enumerable:!0,get:()=>_.CeriousScroll});exports.CeriousScroll=x;exports.useCeriousScroll=D;

package/dist/index.js

@@ -1,5 +1,5 @@
-import { jsxs as G } from "react/jsx-runtime";
-import { useRef as s, useReducer as J, useState as K, useCallback as S, useEffect as _, createElement as Q, Fragment as U, forwardRef as X, useImperativeHandle as Y } from "react";
+import { jsxs as Y } from "react/jsx-runtime";
+import { useRef as s, useReducer as z, useState as G, useCallback as R, useEffect as _, createElement as J, Fragment as K, forwardRef as Q, useImperativeHandle as U } from "react";
 import { flushSync as Z, createPortal as x } from "react-dom";
 import { renderToStaticMarkup as ee } from "react-dom/server";
 import { CeriousScroll as te } from "@ceriousdevtech/cerious-scroll";
@@ -9,7 +9,7 @@ function ne(e) {
   const c = e.querySelector(`[${k}]`);
   if (c) return c;
   const r = document.createElement("div");
-  return r.setAttribute(k, ""), r.style.position = "relative", r.style.width = "100%", r.style.height = "100%", r.style.overflow = "hidden", e.appendChild(r), r;
+  return r.setAttribute(k, ""), r.style.position = "relative", r.style.width = "100%", r.style.height = "100%", r.style.overflowY = "clip", r.style.overflowX = "auto", e.appendChild(r), r;
 }
 function oe(e, c) {
   const r = (u) => {
@@ -41,40 +41,40 @@ function ce(e, c) {
 }
 function le(e) {
   var q;
-  const c = s(null), r = s(null), a = s(/* @__PURE__ */ new Map()), u = s(null), [, o] = J((t) => t + 1, 0), [L, b] = K(null), w = s(e.renderItem), d = s(e.items ?? null), v = s(e.getItem), C = s(e.options), h = s(e.autoRender ?? !0), T = s(e.totalElements ?? null), g = s(e.onViewportChange), y = s(e.onMeasuredViewport), A = s(e.onReady);
-  w.current = e.renderItem, d.current = e.items ?? null, v.current = e.getItem, C.current = e.options, h.current = e.autoRender ?? !0, T.current = e.totalElements ?? null, g.current = e.onViewportChange, y.current = e.onMeasuredViewport, A.current = e.onReady;
-  const P = S((t) => {
+  const c = s(null), r = s(null), a = s(/* @__PURE__ */ new Map()), u = s(null), [, o] = z((t) => t + 1, 0), [L, O] = G(null), S = s(e.renderItem), d = s(e.items ?? null), v = s(e.getItem), C = s(e.options), h = s(e.autoRender ?? !0), T = s(e.totalElements ?? null), g = s(e.onViewportChange), b = s(e.onMeasuredViewport), A = s(e.onReady);
+  S.current = e.renderItem, d.current = e.items ?? null, v.current = e.getItem, C.current = e.options, h.current = e.autoRender ?? !0, T.current = e.totalElements ?? null, g.current = e.onViewportChange, b.current = e.onMeasuredViewport, A.current = e.onReady;
+  const P = R((t) => {
     const n = v.current;
     if (n) return n(t);
     const E = d.current;
     return E ? E[t] : void 0;
-  }, []), l = S(() => {
-    var O;
+  }, []), l = R(() => {
+    var I;
     const t = r.current;
     if (!t) return null;
-    const { scroller: n, contentEl: E, container: R } = t, N = R.clientHeight || R.offsetHeight || 0, I = [], i = (f, p) => {
+    const { scroller: n, contentEl: E, container: w } = t, N = w.clientHeight || w.offsetHeight || 0, y = [], i = (f, p) => {
       const m = document.createElement("div");
       m.setAttribute(re, String(f)), m.innerHTML = ee(
-        Q(U, null, w.current(P(f), f))
-      ), p.appendChild(m), a.current.set(f, { el: p, mount: m }), I.push(m);
+        J(K, null, S.current(P(f), f))
+      ), p.appendChild(m), a.current.set(f, { el: p, mount: m }), y.push(m);
     }, M = n.renderViewport(N, E, i), F = new Set(n.getRenderedIndices());
     return a.current.forEach((f, p) => {
       F.has(p) || a.current.delete(p);
-    }), I.forEach((f) => {
+    }), y.forEach((f) => {
       f.textContent = "";
-    }), Z(o), (O = y.current) == null || O.call(y, M), M;
+    }), Z(o), (I = b.current) == null || I.call(b, M), M;
   }, []), $ = e.totalElements ?? ((q = e.items) == null ? void 0 : q.length) ?? null;
   _(() => {
-    var O, f;
+    var I, f;
     const t = c.current;
     if (!t) return;
-    const n = ne(t), E = C.current ?? {}, R = E.onScroll, N = {
+    const n = ne(t), E = C.current ?? {}, w = E.onScroll, N = {
       ...E,
       onScroll: () => {
-        R == null || R(), h.current && l();
+        w == null || w(), h.current && l();
       }
-    }, I = ce(T.current, ((O = d.current) == null ? void 0 : O.length) ?? null), i = new te(t, I, N);
-    u.current && (i.currentElement = Math.min(u.current.currentElement, I - 1), i.scrollOffset = u.current.scrollOffset, u.current = null), r.current = { scroller: i, contentEl: n, container: t }, b(i);
+    }, y = ce(T.current, ((I = d.current) == null ? void 0 : I.length) ?? null), i = new te(t, y, N);
+    u.current && (i.currentElement = Math.min(u.current.currentElement, y - 1), i.scrollOffset = u.current.scrollOffset, u.current = null), r.current = { scroller: i, contentEl: n, container: t }, O(i);
     const M = oe(t, (p) => {
       var m;
       (m = g.current) == null || m.call(g, p);
@@ -85,35 +85,35 @@ function le(e) {
       cancelAnimationFrame(F), M(), u.current = {
         currentElement: i.currentElement,
         scrollOffset: i.scrollOffset
-      }, a.current.clear(), n.textContent = "", i.detachScrollbar(t), i.dispose(), r.current = null, b(null);
+      }, a.current.clear(), n.textContent = "", i.detachScrollbar(t), i.dispose(), r.current = null, O(null);
     };
   }, [$, l]), _(() => {
     if (!r.current || !h.current) return;
     const t = requestAnimationFrame(() => l());
     return () => cancelAnimationFrame(t);
   }, [e.items, e.getItem]);
-  const B = S(
+  const B = R(
     (t) => {
       const n = r.current;
       return n ? (n.scroller.jumpToElement(t), l()) : null;
     },
     [l]
-  ), D = S(
+  ), D = R(
     (t) => {
       const n = r.current;
       return n ? (n.scroller.handleScrollPercentage(t), l()) : null;
     },
     [l]
-  ), W = S(() => {
+  ), W = R(() => {
     const t = r.current;
     return t ? (t.scroller.reset(), l()) : null;
-  }, [l]), z = S(() => {
+  }, [l]), X = R(() => {
     const t = r.current;
     return t ? (t.scroller.clearAllCaches(), l()) : null;
   }, [l]), j = d.current, H = !v.current && j != null ? j.length : null, V = [];
   return a.current.forEach((t, n) => {
     H !== null && n >= H || V.push(
-      x(w.current(P(n), n), t.mount, String(n))
+      x(S.current(P(n), n), t.mount, String(n))
     );
   }), {
     containerRef: c,
@@ -123,13 +123,13 @@ function le(e) {
     jumpToElement: B,
     scrollToPercentage: D,
     reset: W,
-    recalculate: z
+    recalculate: X
   };
 }
 function se(e, c) {
   const { className: r, style: a, "data-testid": u, children: o, ...L } = e, {
-    containerRef: b,
-    portals: w,
+    containerRef: O,
+    portals: S,
     scroller: d,
     render: v,
     jumpToElement: C,
@@ -137,25 +137,25 @@ function se(e, c) {
     reset: T,
     recalculate: g
   } = le(L);
-  return Y(
+  return U(
     c,
     () => ({ scroller: d, render: v, jumpToElement: C, scrollToPercentage: h, reset: T, recalculate: g }),
     [d, v, C, h, T, g]
-  ), /* @__PURE__ */ G(
+  ), /* @__PURE__ */ Y(
     "div",
     {
-      ref: b,
+      ref: O,
       className: r,
       "data-testid": u,
       style: { position: "relative", overflow: "hidden", ...a },
       children: [
         o,
-        w
+        S
       ]
     }
   );
 }
-const de = X(se);
+const de = Q(se);
 export {
   de as CeriousScroll,
   Ee as CeriousScrollEngine,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ceriousdevtech/react-cerious-scroll",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "React bindings for CeriousScroll — high-performance virtual scrolling with O(1) memory and no height estimation",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -55,8 +55,10 @@
     "demo": "vite --config demo/vite.config.ts",
     "demo:build": "vite build --config demo/vite.config.ts"
   },
+  "dependencies": {
+    "@ceriousdevtech/cerious-scroll": "^1.0.4"
+  },
   "peerDependencies": {
-    "@ceriousdevtech/cerious-scroll": "^1.0.3",
     "react": ">=18 <20",
     "react-dom": ">=18 <20"
   },
@@ -66,11 +68,13 @@
     "@types/node": "^22.10.2",
     "@types/react": "^18.3.12",
     "@types/react-dom": "^18.3.1",
+    "@types/react-window": "^1.8.8",
     "@vitejs/plugin-react": "^4.3.4",
     "jsdom": "^25.0.1",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "react-router-dom": "^6.30.4",
+    "react-window": "^1.8.10",
     "typescript": "^5.6.3",
     "vite": "^5.4.11",
     "vite-plugin-dts": "^4.3.0",