@kolkrabbi/kol-shell 0.16.0 → 0.16.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolkrabbi/kol-shell",
-  "version": "0.16.0",
+  "version": "0.16.1",
   "private": false,
   "description": "KOL application shell — fixed 48px NavRail + AppShell layout root, PageShell/PageHeader scaffolds, ContentFilters catalog organism, GridCard, SettingsScaffold, WalkthroughPanel, ShortcutsOverlay. App chrome (kol-framework owns site chrome). Nav items, content, shortcuts and settings are consumer-injected. Sits above @kolkrabbi/kol-{theme,component,framework}.",
   "license": "MIT",
@@ -12,7 +12,7 @@
     "./src/*": "./src/*"
   },
   "peerDependencies": {
-    "@kolkrabbi/kol-component": ">=0.125.0",
+    "@kolkrabbi/kol-component": ">=0.126.0",
     "@kolkrabbi/kol-icons": ">=0.16.0",
     "@kolkrabbi/kol-theme": ">=0.84.0",
     "gsap": "^3.13.0",
@@ -20,9 +20,9 @@
     "react-dom": "^18.3.0 || ^19.0.0"
   },
   "devDependencies": {
-    "@kolkrabbi/kol-component": "^0.125.0",
-    "@kolkrabbi/kol-framework": "^0.35.0",
+    "@kolkrabbi/kol-component": "^0.126.0",
     "@kolkrabbi/kol-icons": "^0.24.0",
+    "@kolkrabbi/kol-framework": "^0.35.0",
     "@kolkrabbi/kol-theme": "^0.88.0"
   },
   "files": [

package/src/NavRail.jsx

@@ -53,10 +53,12 @@ const openWidth = () => {
 
 /* THE GRAB EDGE — proximity, not contact: the pill wakes within `GRAB.near` of
  * the line and sleeps only past `GRAB.sleep` (hovering the line itself flapped
- * the class every frame and restarted the fade). Along the line it rests on the
- * nearest of GRAB.marks and is STICKY — it leaves a mark only within `GRAB.stick`
- * of the pitch of another (user: "following the mouse a little too much"), so the
- * middle of each gap is dead. One window listener, rAF-throttled. */
+ * the class every frame and restarted the fade). Along the line it DWELLS (user
+ * ruling 2026-08-28: "make it come to the cursor but have some sticky time where
+ * it lands, so it's not constantly jerking"): it targets the pointer's own
+ * position and re-targets only once the pointer is `GRAB.stick` px away, so it
+ * lands on you, holds while you move inside the radius, then travels to where you
+ * are now. One window listener, rAF-throttled. */
 function useGrabEdge(ref) {
   useEffect(() => {
     let raf = 0
@@ -71,11 +73,8 @@ function useGrabEdge(ref) {
         const near = dist <= GRAB.near || (h.classList.contains('is-near') && dist <= GRAB.sleep)
         h.classList.toggle('is-near', near)
         if (!near) return
-        const frac = Math.min(Math.max((clientY - r.top) / r.height, 0), 1)
-        const mark = GRAB.marks.reduce((a, b) => (Math.abs(b - frac) < Math.abs(a - frac) ? b : a))
-        if (h.dataset.grabSeeded && Math.abs(frac - mark) > GRAB.stick) return
-        const along = mark * r.height
-        if (h.dataset.grabSeeded && along === Number(h.dataset.grabTarget)) return
+        const along = Math.min(Math.max(clientY - r.top, 0), r.height)
+        if (h.dataset.grabSeeded && Math.abs(along - Number(h.dataset.grabTarget)) < GRAB.stick) return
         h.dataset.grabTarget = String(along)
         const vars = { '--kol-rail-grab-y': `${along}px` }
         /* the CSS fallback is 50%, a percentage — nothing to tween from, so the