react-sticky-kit 0.1.4 → 0.1.6

package/README.md

@@ -4,15 +4,24 @@
   <a href="https://www.npmjs.com/package/react-sticky-kit" target="_blank">
     <img src="https://img.shields.io/npm/v/react-sticky-kit.svg?style=flat-square" alt="NPM Version" />
   </a>
+  <a href="https://img.shields.io/npm/dm/react-sticky-kit?style=flat-square" target="_blank">
+    <img src="https://img.shields.io/npm/dm/react-sticky-kit?style=flat-square" alt="NPM Downloads" />
+  </a>
   <a href="https://github.com/oe/react-sticky-kit" target="_blank">
     <img src="https://img.shields.io/github/stars/oe/react-sticky-kit?style=flat-square" alt="GitHub Stars" />
   </a>
   <a href="https://github.com/oe/react-sticky-kit/actions" target="_blank">
-    <img src="https://github.com/oe/react-sticky-kit/actions/workflows/ci.yml/badge.svg" alt="Build Status" />
+    <img src="https://img.shields.io/github/actions/workflow/status/oe/react-sticky-kit/ci.yml?style=flat-square" alt="Build Status" />
   </a>
   <a href="https://github.com/oe/react-sticky-kit/blob/main/LICENSE" target="_blank">
     <img src="https://img.shields.io/github/license/oe/react-sticky-kit?style=flat-square" alt="License" />
   </a>
+  <a href="https://www.typescriptlang.org/" target="_blank">
+    <img src="https://img.shields.io/badge/TypeScript-5.0%2B-blue?logo=typescript&style=flat-square" alt="TypeScript" />
+  </a>
+  <a href="#ssr-ssg-support" target="_blank">
+    <img src="https://img.shields.io/badge/SSR%2FSSG-Compatible-brightgreen?style=flat-square" alt="SSR/SSG Compatible" />
+  </a>
 </p>
 
 A lightweight, flexible React sticky container and item component library. Easily create sticky headers, sections, and advanced sticky layouts with support for multiple modes and edge cases.
@@ -22,6 +31,7 @@ A lightweight, flexible React sticky container and item component library. Easil
 - 📦 Simple API: `<StickyContainer>` and `<StickyItem>`
 - 🧩 Supports `replace`, `stack`, and `none` sticky modes
 - 🏷️ Customizable offset, z-index (baseZIndex), and sticky logic
+- 🔄 Supports SSR/SSG (Next.js, Gatsby, Astro, etc.)
 - 🧪 Handles edge cases: empty sections, dynamic heights, zero-height headers, long headers, etc.
 - ⚡️ Written in TypeScript, fully typed
 - 🧪 Includes demo pages for real-world scenarios
@@ -36,6 +46,9 @@ yarn add react-sticky-kit
 pnpm add react-sticky-kit
 ```
 
+## Demo
+- [Apple iOS Contact App](https://codesandbox.io/p/sandbox/dreamy-hofstadter-v9dzfz)
+
 ## Usage
 
 ```tsx
@@ -74,7 +87,7 @@ export default function Example() {
 ### `<StickyItem />`
 | Prop    | Type                                 | Default | Description                                 |
 |---------|--------------------------------------|---------|---------------------------------------------|
-| `mode`  | `'replace' \| 'stack' \| 'none'`     |         | Sticky mode for this item (overrides group) |
+| `mode`  | `'replace' \| 'stack' \| 'none'`     |         | Sticky mode for this item (overrides StickyContainer) |
 
 ## Sticky Modes
 - **replace**: Only one sticky item is visible at a time, replacing the previous.
@@ -90,7 +103,57 @@ pnpm install
 pnpm dev
 ```
 
-Open [http://localhost:5173](http://localhost:5173) and switch between demo pages to explore all features and edge cases.
+Open [http://localhost:5173](http://localhost:5173) and switch between demo pages to explore all features and edge cases:
+* [iOS Contact](http://localhost:5173/#ios-contact) a dead simple iOS contact clone
+* [Mixed mode](http://localhost:5173/#mixed-mode) mix replace/stack/none mode
+* [Nested](http://localhost:5173/#dynamic-height) nest sticky containers
+* [Dynamic sticky items](http://localhost:5173/#nested) dynamic sticky items(add/remove)
+* [Dynamic offsetTop](http://localhost:5173/#dynamic-offset) dynamic offsetTop that adapts to header height changes
+
+## SSR/SSG Support
+
+React Sticky Kit supports Server-Side Rendering (SSR) and Static Site Generation (SSG), working seamlessly with frameworks like Next.js, Gatsby, Astro, and more.
+
+### Next.js Example
+
+```tsx
+// pages/index.tsx
+import { StickyContainer, StickyItem } from 'react-sticky-kit'
+import 'react-sticky-kit/dist/style.css'
+
+export default function Home() {
+  return (
+    <StickyContainer>
+      <StickyItem>
+        <header>Sticky Header</header>
+      </StickyItem>
+      <main>Content...</main>
+    </StickyContainer>
+  )
+}
+```
+
+### Astro Example
+
+```astro
+---
+// src/pages/index.astro
+import { StickyContainer, StickyItem } from 'react-sticky-kit'
+import 'react-sticky-kit/dist/style.css'
+---
+
+<html>
+  <head>...</head>
+  <body>
+    <StickyContainer client:load>
+      <StickyItem>
+        <header>Sticky Header</header>
+      </StickyItem>
+      <div>Content...</div>
+    </StickyContainer>
+  </body>
+</html>
+```
 
 ## License
 

package/dist/index.d.ts

@@ -30,7 +30,7 @@ export declare interface IStickyContainerProps extends default_2.HTMLAttributes<
 export declare interface IStickyItemProps extends default_2.HTMLAttributes<HTMLDivElement> {
     children: default_2.ReactNode;
     /**
-     * Sticky mode for this item. Defaults to the group's mode if not specified.
+     * Sticky mode for this item. Defaults to the StickyContainer's mode if not specified.
      */
     mode?: IStickyMode;
 }

package/dist/react-sticky.es.js

@@ -1,137 +1,142 @@
 import { jsx as R } from "react/jsx-runtime";
-import { createContext as b, useContext as Z, useRef as I, useState as N, useEffect as B, useCallback as w, useMemo as T } from "react";
-const x = 20, _ = 200, $ = b(null);
-function L() {
+import { createContext as b, useContext as Z, useRef as h, useState as L, useEffect as E, useCallback as w, useMemo as N } from "react";
+const x = 20, T = 200, $ = b(null);
+function _() {
   return Z($);
 }
-function M({ mode: s, children: o, className: y, ...h }) {
-  const e = L(), S = I(null), k = I(null), [r, n] = N(!1), t = I({
+function F({ mode: u, children: f, className: g, ...k }) {
+  const e = _(), S = h(null), I = h(null), [r, m] = L(!1), t = h({
     fixedOffsetTop: (e == null ? void 0 : e.fixedOffsetTop) || 0,
     isSticky: r,
     baseZIndex: (e == null ? void 0 : e.baseZIndex) || x
   });
-  return t.current.baseZIndex = (e == null ? void 0 : e.baseZIndex) || x, t.current.fixedOffsetTop = (e == null ? void 0 : e.fixedOffsetTop) || 0, t.current.isSticky = r, B(() => {
-    const u = k.current, f = S.current, d = s || (e == null ? void 0 : e.mode);
-    if (!e || !f || !u || d === "none" || !d || !e.register) {
-      n(!1);
+  return t.current.baseZIndex = (e == null ? void 0 : e.baseZIndex) || x, t.current.fixedOffsetTop = (e == null ? void 0 : e.fixedOffsetTop) || 0, t.current.isSticky = r, E(() => {
+    const n = I.current, a = S.current, l = u || (e == null ? void 0 : e.mode);
+    if (!e || !a || !n || l === "none" || !l || !e.register) {
+      m(!1);
       return;
     }
-    const a = {
-      el: f,
-      update: (l, i, p, C, H) => {
-        if (!l)
-          return t.current.isSticky && n(!1), 0;
-        if (i <= p) {
-          const g = u.getBoundingClientRect().height;
-          let v = p;
-          if (d === "replace" && typeof C < "u") {
-            const m = C - (p + g);
-            if (m < 0 && (v = p + m, m + g < 0))
-              return t.current.isSticky && n(!1), 0;
-          }
-          return t.current.isSticky || n(!0), u.style.top = `${v}px`, u.style.width = `${f.offsetWidth}px`, u.style.zIndex = `${t.current.baseZIndex + (d === "replace" ? -H : H)}`, f.style.height = `${g}px`, d === "replace" ? 0 : g;
-        } else
-          n(!1);
-        return 0;
+    const s = {
+      el: a,
+      update: (d, c, i, o, C) => {
+        if (!d || c > i)
+          return t.current.isSticky && m(!1), 0;
+        const p = n.getBoundingClientRect().height;
+        let H = i;
+        if (l === "replace" && typeof o < "u") {
+          const y = o - (i + p);
+          if (y < 0 && (H = i + y, y + p < 0))
+            return t.current.isSticky && m(!1), 0;
+        }
+        return a.style.height = `${p}px`, t.current.isSticky || m(!0), n.style.top = `${H}px`, n.style.width = `${a.offsetWidth}px`, n.style.zIndex = `${t.current.baseZIndex + (l === "replace" ? -C : C)}`, l === "replace" ? 0 : p;
       }
     };
-    return e.register(a);
-  }, [e == null ? void 0 : e.mode, e == null ? void 0 : e.register, s]), B(() => {
-    const u = S.current, f = k.current, d = e == null ? void 0 : e.updateStickyItemsHeight;
-    if (!r || !u || !f || !d)
+    return e.register(s);
+  }, [e == null ? void 0 : e.mode, e == null ? void 0 : e.register, u]), E(() => {
+    const n = S.current, a = I.current, l = e == null ? void 0 : e.updateStickyItemsHeight;
+    if (!r || !n || !a || !l)
       return;
-    const c = d(f.getBoundingClientRect().height);
+    const v = l(a.getBoundingClientRect().height);
     return () => {
-      O(u, ["height"]), O(f, ["top", "z-index", "width"]), c();
+      O(n, ["height"]), O(a, ["top", "z-index", "width"]), v();
     };
-  }, [r, e == null ? void 0 : e.updateStickyItemsHeight]), /* @__PURE__ */ R("div", { className: "oe-sticky-item " + (y || ""), ...h, ref: S, children: /* @__PURE__ */ R("div", { className: "oe-sticky-content " + (r ? "is-sticky" : ""), ref: k, children: o }) });
+  }, [r, e == null ? void 0 : e.updateStickyItemsHeight]), /* @__PURE__ */ R("div", { className: "oe-sticky-item " + (g || ""), ...k, ref: S, children: /* @__PURE__ */ R("div", { className: "oe-sticky-content " + (r ? "is-sticky" : ""), ref: I, children: f }) });
 }
-function O(s, o) {
-  o.forEach((y) => {
-    s.style.removeProperty(y);
+function O(u, f) {
+  f.forEach((g) => {
+    u.style.removeProperty(g);
   });
 }
-function P({
-  children: s,
-  offsetTop: o = 0,
-  baseZIndex: y,
-  onStickyItemsHeightChange: h,
+function M({
+  children: u,
+  offsetTop: f = 0,
+  baseZIndex: g,
+  onStickyItemsHeightChange: k,
   defaultMode: e = "replace",
   ...S
 }) {
-  const k = I(null), r = I([]), n = I({
-    fixedOffsetTop: o,
+  const I = h(null), r = h([]), m = h(null), t = h({
+    fixedOffsetTop: f,
     defaultMode: e,
     stickyItemsHeight: 0,
-    onStickyItemsHeightChange: h
+    onStickyItemsHeightChange: k,
+    lastCanSticky: !1
   });
-  n.current.onStickyItemsHeightChange = h;
-  const t = w(() => {
-    const c = k.current;
-    if (!c)
-      return;
-    const a = c.getBoundingClientRect(), l = n.current, i = l.fixedOffsetTop, p = l.stickyItemsHeight, C = !(a.top > i || a.bottom < i);
-    let H = i, g = a.bottom - (i + p);
-    g > 0 && (g = 0);
-    const v = r.current.map((m) => m.el.getBoundingClientRect().top);
-    r.current.forEach((m, E) => {
-      H += m.update(C, v[E], H + g, v[E + 1], E);
-    });
-  }, []), u = w((c) => {
-    const a = n.current.stickyItemsHeight + c;
-    return n.current.stickyItemsHeight = a, setTimeout(() => {
-      var l, i;
-      (i = (l = n.current).onStickyItemsHeightChange) == null || i.call(l, a);
+  t.current.onStickyItemsHeightChange = k;
+  const n = w(() => {
+    const s = I.current;
+    !s || m.current || (m.current = requestAnimationFrame(() => {
+      m.current = null;
+      const d = s.getBoundingClientRect(), { fixedOffsetTop: c, stickyItemsHeight: i } = t.current, o = !(d.top > c || d.bottom < c);
+      if (!o) {
+        t.current.lastCanSticky !== o && (s.classList.toggle("can-sticky", !1), r.current.forEach((y) => y.update(!1, 0, 0, 0, 0)), t.current.lastCanSticky = o);
+        return;
+      }
+      t.current.lastCanSticky = o, i > 0 && s.classList.toggle("can-sticky", !0);
+      let C = c, p = d.bottom - (c + i);
+      p > 0 && (p = 0);
+      const H = r.current.map((y) => y.el.getBoundingClientRect().top);
+      r.current.forEach((y, B) => {
+        C += y.update(o, H[B], C + p, H[B + 1], B);
+      });
+    }));
+  }, []), a = w((s) => {
+    const d = t.current.stickyItemsHeight + s;
+    return t.current.stickyItemsHeight = d, setTimeout(() => {
+      var c, i;
+      (i = (c = t.current).onStickyItemsHeightChange) == null || i.call(c, d);
     }, 0), () => {
-      const l = n.current.stickyItemsHeight - c;
-      n.current.stickyItemsHeight = l, setTimeout(() => {
-        var i, p;
-        (p = (i = n.current).onStickyItemsHeightChange) == null || p.call(i, l);
+      const c = t.current.stickyItemsHeight - s;
+      t.current.stickyItemsHeight = c, setTimeout(() => {
+        var i, o;
+        (o = (i = t.current).onStickyItemsHeightChange) == null || o.call(i, c);
       }, 0);
     };
   }, []);
-  B(() => {
-    n.current.fixedOffsetTop = o, n.current.defaultMode = e, t();
-  }, [o, e, t]);
-  const f = w((c) => (r.current.push(c), r.current = A(r.current), t(), () => {
-    r.current = r.current.filter((a) => a !== c), t();
-  }), [t]);
-  B(() => (window.addEventListener("scroll", t, { passive: !0 }), window.addEventListener("resize", t, { passive: !0 }), () => {
-    window.removeEventListener("scroll", t), window.removeEventListener("resize", t);
-  }), [t]);
-  const d = T(() => z(y), [y]);
+  E(() => {
+    t.current.fixedOffsetTop = f, t.current.defaultMode = e, setTimeout(() => {
+      n();
+    }, 10);
+  }, [f, e, n]);
+  const l = w((s) => (r.current.push(s), r.current = z(r.current), n(), () => {
+    r.current = r.current.filter((d) => d !== s), n();
+  }), [n]);
+  E(() => (window.addEventListener("scroll", n, { passive: !0 }), window.addEventListener("resize", n, { passive: !0 }), () => {
+    window.removeEventListener("scroll", n), window.removeEventListener("resize", n);
+  }), [n]);
+  const v = N(() => A(g), [g]);
   return /* @__PURE__ */ R(
     $.Provider,
     {
       value: {
-        register: f,
-        baseZIndex: d,
-        updateStickyItemsHeight: u,
-        fixedOffsetTop: o,
+        register: l,
+        baseZIndex: v,
+        updateStickyItemsHeight: a,
+        fixedOffsetTop: f,
         mode: e
       },
       children: /* @__PURE__ */ R(
         "div",
         {
           ...S,
-          ref: k,
+          ref: I,
           className: "oe-sticky-container",
-          children: s
+          children: u
         }
       )
     }
   );
 }
-function z(s) {
-  return typeof s > "u" ? _ : Math.max(Number(s) || 0, x);
+function A(u) {
+  return typeof u > "u" ? T : Math.max(Number(u) || 0, x);
 }
-function A(s) {
-  return s.sort((o, y) => {
-    const h = o.el.getBoundingClientRect(), e = y.el.getBoundingClientRect();
-    return h.top - e.top;
+function z(u) {
+  return u.sort((f, g) => {
+    const k = f.el.getBoundingClientRect(), e = g.el.getBoundingClientRect();
+    return k.top - e.top;
   });
 }
 export {
-  P as StickyContainer,
-  M as StickyItem
+  M as StickyContainer,
+  F as StickyItem
 };

package/dist/react-sticky.umd.js

@@ -1 +1 @@
-(function(p,g){typeof exports=="object"&&typeof module<"u"?g(exports,require("react/jsx-runtime"),require("react")):typeof define=="function"&&define.amd?define(["exports","react/jsx-runtime","react"],g):(p=typeof globalThis<"u"?globalThis:p||self,g(p.ReactSticky={},p.jsxRuntime,p.React))})(this,function(p,g,n){"use strict";const B=n.createContext(null);function N(){return n.useContext(B)}const $="";function O({mode:c,children:o,className:m,...S}){const e=N(),R=n.useRef(null),E=n.useRef(null),[s,i]=n.useState(!1),t=n.useRef({fixedOffsetTop:(e==null?void 0:e.fixedOffsetTop)||0,isSticky:s,baseZIndex:(e==null?void 0:e.baseZIndex)||20});return t.current.baseZIndex=(e==null?void 0:e.baseZIndex)||20,t.current.fixedOffsetTop=(e==null?void 0:e.fixedOffsetTop)||0,t.current.isSticky=s,n.useEffect(()=>{const f=E.current,d=R.current,l=c||(e==null?void 0:e.mode);if(!e||!d||!f||l==="none"||!l||!e.register){i(!1);return}const y={el:d,update:(a,r,h,C,H)=>{if(!a)return t.current.isSticky&&i(!1),0;if(r<=h){const I=f.getBoundingClientRect().height;let _=h;if(l==="replace"&&typeof C<"u"){const k=C-(h+I);if(k<0&&(_=h+k,k+I<0))return t.current.isSticky&&i(!1),0}return t.current.isSticky||i(!0),f.style.top=`${_}px`,f.style.width=`${d.offsetWidth}px`,f.style.zIndex=`${t.current.baseZIndex+(l==="replace"?-H:H)}`,d.style.height=`${I}px`,l==="replace"?0:I}else i(!1);return 0}};return e.register(y)},[e==null?void 0:e.mode,e==null?void 0:e.register,c]),n.useEffect(()=>{const f=R.current,d=E.current,l=e==null?void 0:e.updateStickyItemsHeight;if(!s||!f||!d||!l)return;const u=l(d.getBoundingClientRect().height);return()=>{x(f,["height"]),x(d,["top","z-index","width"]),u()}},[s,e==null?void 0:e.updateStickyItemsHeight]),g.jsx("div",{className:"oe-sticky-item "+(m||""),...S,ref:R,children:g.jsx("div",{className:"oe-sticky-content "+(s?"is-sticky":""),ref:E,children:o})})}function x(c,o){o.forEach(m=>{c.style.removeProperty(m)})}function Z({children:c,offsetTop:o=0,baseZIndex:m,onStickyItemsHeightChange:S,defaultMode:e="replace",...R}){const E=n.useRef(null),s=n.useRef([]),i=n.useRef({fixedOffsetTop:o,defaultMode:e,stickyItemsHeight:0,onStickyItemsHeightChange:S});i.current.onStickyItemsHeightChange=S;const t=n.useCallback(()=>{const u=E.current;if(!u)return;const y=u.getBoundingClientRect(),a=i.current,r=a.fixedOffsetTop,h=a.stickyItemsHeight,C=!(y.top>r||y.bottom<r);let H=r,I=y.bottom-(r+h);I>0&&(I=0);const _=s.current.map(k=>k.el.getBoundingClientRect().top);s.current.forEach((k,v)=>{H+=k.update(C,_[v],H+I,_[v+1],v)})},[]),f=n.useCallback(u=>{const y=i.current.stickyItemsHeight+u;return i.current.stickyItemsHeight=y,setTimeout(()=>{var a,r;(r=(a=i.current).onStickyItemsHeightChange)==null||r.call(a,y)},0),()=>{const a=i.current.stickyItemsHeight-u;i.current.stickyItemsHeight=a,setTimeout(()=>{var r,h;(h=(r=i.current).onStickyItemsHeightChange)==null||h.call(r,a)},0)}},[]);n.useEffect(()=>{i.current.fixedOffsetTop=o,i.current.defaultMode=e,t()},[o,e,t]);const d=n.useCallback(u=>(s.current.push(u),s.current=w(s.current),t(),()=>{s.current=s.current.filter(y=>y!==u),t()}),[t]);n.useEffect(()=>(window.addEventListener("scroll",t,{passive:!0}),window.addEventListener("resize",t,{passive:!0}),()=>{window.removeEventListener("scroll",t),window.removeEventListener("resize",t)}),[t]);const l=n.useMemo(()=>b(m),[m]);return g.jsx(B.Provider,{value:{register:d,baseZIndex:l,updateStickyItemsHeight:f,fixedOffsetTop:o,mode:e},children:g.jsx("div",{...R,ref:E,className:"oe-sticky-container",children:c})})}function b(c){return typeof c>"u"?200:Math.max(Number(c)||0,20)}function w(c){return c.sort((o,m)=>{const S=o.el.getBoundingClientRect(),e=m.el.getBoundingClientRect();return S.top-e.top})}p.StickyContainer=Z,p.StickyItem=O,Object.defineProperty(p,Symbol.toStringTag,{value:"Module"})});
+(function(p,m){typeof exports=="object"&&typeof module<"u"?m(exports,require("react/jsx-runtime"),require("react")):typeof define=="function"&&define.amd?define(["exports","react/jsx-runtime","react"],m):(p=typeof globalThis<"u"?globalThis:p||self,m(p.ReactSticky={},p.jsxRuntime,p.React))})(this,function(p,m,r){"use strict";const B=r.createContext(null);function x(){return r.useContext(B)}const $="";function Z({mode:o,children:l,className:h,...S}){const e=x(),C=r.useRef(null),E=r.useRef(null),[s,k]=r.useState(!1),t=r.useRef({fixedOffsetTop:(e==null?void 0:e.fixedOffsetTop)||0,isSticky:s,baseZIndex:(e==null?void 0:e.baseZIndex)||20});return t.current.baseZIndex=(e==null?void 0:e.baseZIndex)||20,t.current.fixedOffsetTop=(e==null?void 0:e.fixedOffsetTop)||0,t.current.isSticky=s,r.useEffect(()=>{const n=E.current,d=C.current,a=o||(e==null?void 0:e.mode);if(!e||!d||!n||a==="none"||!a||!e.register){k(!1);return}const c={el:d,update:(y,u,i,f,R)=>{if(!y||u>i)return t.current.isSticky&&k(!1),0;const I=n.getBoundingClientRect().height;let _=i;if(a==="replace"&&typeof f<"u"){const g=f-(i+I);if(g<0&&(_=i+g,g+I<0))return t.current.isSticky&&k(!1),0}return d.style.height=`${I}px`,t.current.isSticky||k(!0),n.style.top=`${_}px`,n.style.width=`${d.offsetWidth}px`,n.style.zIndex=`${t.current.baseZIndex+(a==="replace"?-R:R)}`,a==="replace"?0:I}};return e.register(c)},[e==null?void 0:e.mode,e==null?void 0:e.register,o]),r.useEffect(()=>{const n=C.current,d=E.current,a=e==null?void 0:e.updateStickyItemsHeight;if(!s||!n||!d||!a)return;const H=a(d.getBoundingClientRect().height);return()=>{N(n,["height"]),N(d,["top","z-index","width"]),H()}},[s,e==null?void 0:e.updateStickyItemsHeight]),m.jsx("div",{className:"oe-sticky-item "+(h||""),...S,ref:C,children:m.jsx("div",{className:"oe-sticky-content "+(s?"is-sticky":""),ref:E,children:l})})}function N(o,l){l.forEach(h=>{o.style.removeProperty(h)})}function b({children:o,offsetTop:l=0,baseZIndex:h,onStickyItemsHeightChange:S,defaultMode:e="replace",...C}){const E=r.useRef(null),s=r.useRef([]),k=r.useRef(null),t=r.useRef({fixedOffsetTop:l,defaultMode:e,stickyItemsHeight:0,onStickyItemsHeightChange:S,lastCanSticky:!1});t.current.onStickyItemsHeightChange=S;const n=r.useCallback(()=>{const c=E.current;!c||k.current||(k.current=requestAnimationFrame(()=>{k.current=null;const y=c.getBoundingClientRect(),{fixedOffsetTop:u,stickyItemsHeight:i}=t.current,f=!(y.top>u||y.bottom<u);if(!f){t.current.lastCanSticky!==f&&(c.classList.toggle("can-sticky",!1),s.current.forEach(g=>g.update(!1,0,0,0,0)),t.current.lastCanSticky=f);return}t.current.lastCanSticky=f,i>0&&c.classList.toggle("can-sticky",!0);let R=u,I=y.bottom-(u+i);I>0&&(I=0);const _=s.current.map(g=>g.el.getBoundingClientRect().top);s.current.forEach((g,v)=>{R+=g.update(f,_[v],R+I,_[v+1],v)})}))},[]),d=r.useCallback(c=>{const y=t.current.stickyItemsHeight+c;return t.current.stickyItemsHeight=y,setTimeout(()=>{var u,i;(i=(u=t.current).onStickyItemsHeightChange)==null||i.call(u,y)},0),()=>{const u=t.current.stickyItemsHeight-c;t.current.stickyItemsHeight=u,setTimeout(()=>{var i,f;(f=(i=t.current).onStickyItemsHeightChange)==null||f.call(i,u)},0)}},[]);r.useEffect(()=>{t.current.fixedOffsetTop=l,t.current.defaultMode=e,setTimeout(()=>{n()},10)},[l,e,n]);const a=r.useCallback(c=>(s.current.push(c),s.current=O(s.current),n(),()=>{s.current=s.current.filter(y=>y!==c),n()}),[n]);r.useEffect(()=>(window.addEventListener("scroll",n,{passive:!0}),window.addEventListener("resize",n,{passive:!0}),()=>{window.removeEventListener("scroll",n),window.removeEventListener("resize",n)}),[n]);const H=r.useMemo(()=>w(h),[h]);return m.jsx(B.Provider,{value:{register:a,baseZIndex:H,updateStickyItemsHeight:d,fixedOffsetTop:l,mode:e},children:m.jsx("div",{...C,ref:E,className:"oe-sticky-container",children:o})})}function w(o){return typeof o>"u"?200:Math.max(Number(o)||0,20)}function O(o){return o.sort((l,h)=>{const S=l.el.getBoundingClientRect(),e=h.el.getBoundingClientRect();return S.top-e.top})}p.StickyContainer=b,p.StickyItem=Z,Object.defineProperty(p,Symbol.toStringTag,{value:"Module"})});

package/dist/style.css

@@ -1 +1 @@
-.oe-sticky-container,.oe-sticky-item{position:relative}.oe-sticky-content{will-change:top,position}.oe-sticky-content.is-sticky{position:fixed}
+.oe-sticky-container{position:relative}.oe-sticky-container.can-sticky .oe-sticky-content.is-sticky{position:fixed}.oe-sticky-item{position:relative}.oe-sticky-content{will-change:top,position}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-sticky-kit",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "type": "module",
   "description": "A lightweight, flexible React sticky container and item component library supporting multiple sticky modes, advanced layouts, and edge cases.",
   "keywords": [
@@ -26,6 +26,9 @@
     "preview": "vite preview",
     "type-check": "tsc --noEmit",
     "lint": "eslint src demo --ext .ts,.tsx,.js,.jsx",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "coverage": "vitest run --coverage",
     "pub": "tsx ./scripts/publish.ts"
   },
   "files": [
@@ -36,9 +39,9 @@
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/react-sticky.es.js",
-      "require": "./dist/react-sticky.umd.js",
-      "types": "./dist/index.d.ts"
+      "require": "./dist/react-sticky.umd.js"
     },
     "./style": "./dist/style.css",
     "./dist/style.css": "./dist/style.css"
@@ -49,25 +52,33 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.25.0",
+    "@testing-library/jest-dom": "^6.1.6",
+    "@testing-library/react": "^14.1.2",
+    "@testing-library/user-event": "^14.4.3",
     "@types/node": "^22.15.18",
     "@types/react": "^19.1.2",
     "@types/react-dom": "^19.1.2",
     "@typescript-eslint/eslint-plugin": "^8.32.1",
     "@typescript-eslint/parser": "^8.32.1",
     "@vitejs/plugin-react": "^4.0.0",
+    "@vitest/coverage-v8": "^3.1.3",
     "eslint": "^9.26.0",
     "eslint-config-prettier": "^10.1.5",
     "eslint-plugin-jsx-a11y": "^6.8.0",
     "eslint-plugin-react": "^7.33.2",
     "eslint-plugin-react-hooks": "^5.2.0",
     "globals": "^16.0.0",
+    "identity-obj-proxy": "^3.0.0",
+    "jsdom": "^26.1.0",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
     "sass": "^1.88.0",
+    "ts-node": "^10.9.2",
     "tsx": "^4.19.4",
     "typescript": "^5.0.0",
     "typescript-eslint": "^8.30.1",
     "vite": "^4.0.0",
-    "vite-plugin-dts": "^4.5.4"
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^3.1.3"
   }
 }