chore(release): 2.15.0 [skip ci]

## [2.15.0](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.14.3...v2.15.0) (2025-10-09)

### Features

* implement smooth hover avatar animations with react-spring ([442c6b4](442c6b4529))

CHANGELOG.md

@@ -1,3 +1,17 @@
+## [2.15.0](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.14.3...v2.15.0) (2025-10-09)
+
+
+### Features
+
+* implement smooth hover avatar animations with react-spring ([442c6b4](https://github.com/antialias/soroban-abacus-flashcards/commit/442c6b4529ba5c820b1fe8a64805a3d85489a8ea))
+
+## [2.14.3](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.14.2...v2.14.3) (2025-10-09)
+
+
+### Bug Fixes
+
+* enable smooth spring animations between card hovers ([8d53b58](https://github.com/antialias/soroban-abacus-flashcards/commit/8d53b589aa17ebc6d0a9251b3006fd8a90f90a61))
+
 ## [2.14.2](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.14.1...v2.14.2) (2025-10-09)
 
 

apps/web/.claude/settings.local.json

@@ -9,7 +9,8 @@
       "Bash(git push:*)",
       "Bash(git pull:*)",
       "Bash(git stash:*)",
-      "Bash(npm run format:*)"
+      "Bash(npm run format:*)",
+      "Bash(npm run pre-commit:*)"
     ],
     "deny": [],
     "ask": []

apps/web/src/app/arcade/matching/components/MemoryGrid.tsx

@@ -87,22 +87,23 @@ function HoverAvatar({
   playerId,
   playerInfo,
   cardElement,
+  isPlayersTurn,
 }: {
   playerId: string
   playerInfo: { emoji: string; name: string; color?: string }
   cardElement: HTMLElement | null
+  isPlayersTurn: boolean
 }) {
   const [position, setPosition] = useState<{ x: number; y: number } | null>(null)
+  const isFirstRender = useRef(true)
 
   // Update position when card element changes
   useEffect(() => {
     if (cardElement) {
       const rect = cardElement.getBoundingClientRect()
-      // Calculate the actual position we want the avatar centered at (top-right of card)
-      // Since we're using translate(-50%, -50%), we need the center point
-      const avatarSize = 48
-      const avatarCenterX = rect.right - 12 // 12px from right edge
-      const avatarCenterY = rect.top - 12 // 12px from top edge
+      // Calculate the center of the card for avatar positioning
+      const avatarCenterX = rect.left + rect.width / 2
+      const avatarCenterY = rect.top + rect.height / 2
 
       setPosition({
         x: avatarCenterX,
@@ -112,23 +113,25 @@ function HoverAvatar({
   }, [cardElement])
 
   // Smooth spring animation for position changes
-  // Use 'from' to set initial position when avatar first appears
   const springProps = useSpring({
-    from: position
-      ? { x: position.x, y: position.y, opacity: 0 }
-      : { x: 0, y: 0, opacity: 0 },
-    to: {
-      x: position?.x ?? 0,
-      y: position?.y ?? 0,
-      opacity: position ? 1 : 0,
-    },
+    x: position?.x ?? 0,
+    y: position?.y ?? 0,
+    opacity: position && isPlayersTurn ? 1 : 0,
     config: {
       tension: 280,
       friction: 60,
       mass: 1,
     },
+    immediate: isFirstRender.current, // Skip animation on first render only
   })
 
+  // Clear first render flag after initial render
+  useEffect(() => {
+    if (position && isFirstRender.current) {
+      isFirstRender.current = false
+    }
+  }, [position])
+
   // Don't render until we have a position
   if (!position) return null
 
@@ -140,23 +143,23 @@ function HoverAvatar({
         left: springProps.x.to((x) => `${x}px`),
         top: springProps.y.to((y) => `${y}px`),
         opacity: springProps.opacity,
-        width: '48px',
-        height: '48px',
-        marginLeft: '-24px', // Center horizontally (half of width)
-        marginTop: '-24px', // Center vertically (half of height)
+        width: '80px',
+        height: '80px',
+        marginLeft: '-40px', // Center horizontally (half of width)
+        marginTop: '-40px', // Center vertically (half of height)
         borderRadius: '50%',
         background: playerInfo.color || 'linear-gradient(135deg, #667eea, #764ba2)',
         display: 'flex',
         alignItems: 'center',
         justifyContent: 'center',
-        fontSize: '28px',
+        fontSize: '48px',
         // 3D elevation effect
         boxShadow:
-          '0 8px 20px rgba(0,0,0,0.4), 0 4px 8px rgba(0,0,0,0.3), 0 0 30px rgba(102, 126, 234, 0.7)',
-        border: '3px solid white',
+          '0 12px 30px rgba(0,0,0,0.5), 0 6px 12px rgba(0,0,0,0.4), 0 0 40px rgba(102, 126, 234, 0.8)',
+        border: '4px solid white',
         zIndex: 1000,
         pointerEvents: 'none',
-        filter: 'drop-shadow(0 0 8px rgba(102, 126, 234, 0.8))',
+        filter: 'drop-shadow(0 0 12px rgba(102, 126, 234, 0.9))',
       }}
       className={css({
         animation: 'hoverFloat 2s ease-in-out infinite',
@@ -379,9 +382,9 @@ export function MemoryGrid() {
       )}
 
       {/* Animated Hover Avatars - Rendered as fixed positioned elements that smoothly transition */}
+      {/* Render one avatar per remote player - key by playerId to keep component alive */}
       {state.playerHovers &&
         Object.entries(state.playerHovers)
-          .filter(([_, cardId]) => cardId !== null) // Only show if hovering a card
           .filter(([playerId]) => {
             // Don't show your own hover avatar (only show remote players)
             const player = playerMap.get(playerId)
@@ -389,16 +392,21 @@ export function MemoryGrid() {
           })
           .map(([playerId, cardId]) => {
             const playerInfo = getPlayerHoverInfo(playerId)
+            // Get card element if player is hovering (cardId might be null)
             const cardElement = cardId ? cardRefs.current.get(cardId) : null
+            // Check if it's this player's turn
+            const isPlayersTurn = state.currentPlayer === playerId
 
-            if (!playerInfo || !cardElement) return null
+            if (!playerInfo) return null
 
+            // Render avatar even if no cardElement (it will handle hiding itself)
             return (
               <HoverAvatar
-                key={playerId}
+                key={playerId} // Key by playerId keeps component alive across card changes!
                 playerId={playerId}
                 playerInfo={playerInfo}
                 cardElement={cardElement}
+                isPlayersTurn={isPlayersTurn}
               />
             )
           })}
@@ -416,10 +424,10 @@ const gridAnimations = `
 
 @keyframes hoverFloat {
   0%, 100% {
-    transform: translate(-50%, -50%) translateY(0px);
+    transform: translateY(0px);
   }
   50% {
-    transform: translate(-50%, -50%) translateY(-6px);
+    transform: translateY(-6px);
   }
 }
 `

package.json

@@ -1,6 +1,6 @@
 {
   "name": "soroban-monorepo",
-  "version": "2.14.2",
+  "version": "2.15.0",
   "private": true,
   "description": "Beautiful Soroban Flashcard Generator - Monorepo",
   "workspaces": [