@ash-qw/dsh-theme-prts 2.5.5 → 2.6.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ash-qw/dsh-theme-prts",
-  "version": "2.5.5",
+  "version": "2.6.1",
   "private": false,
   "type": "module",
   "description": "Unofficial Arknights P.R.T.S.-inspired UI theme for DeepSeek Harness Web and the official desktop client",
@@ -69,13 +69,15 @@
   },
   "engines": {
     "node": ">=20.9.0",
-    "dsh": "0.2.1-rc.2 || 0.2.1-rc.3"
+    "dsh": "0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.5"
   },
   "devDependencies": {
     "@playwright/test": "1.55.1",
     "esbuild": "^0.28.2",
+    "gsap": "3.14.2",
     "jsdom": "24.1.3",
-    "markdown-it": "^14.3.3"
+    "markdown-it": "^14.3.3",
+    "mouse-follower": "1.2.1"
   },
   "dependencies": {
     "@deepseek-ai/schemastery": "~3.18.4",

package/src/client/avatar-crop.js

@@ -9,11 +9,19 @@ export function mountAvatarCrop({panel,window,load,onSave}){
     <div data-crop-tools><label>缩放 <input type="range" min="1" max="4" step=".01" value="1" aria-label="头像裁剪缩放"></label><button type="button" data-crop-center>重置裁剪</button></div>
     <p role="status" data-prts-avatar-crop-status></p>
     <footer><button type="button" data-crop-reset>恢复默认</button><span></span><button type="button" data-crop-cancel>取消</button><button type="button" data-crop-save>保存头像</button></footer>`
+  const confirmation=panel.ownerDocument.createElement('dialog')
+  confirmation.className='prts-page-confirm'
+  confirmation.setAttribute('aria-labelledby','prts-avatar-reset-title')
+  confirmation.innerHTML='<strong id="prts-avatar-reset-title">恢复默认头像？</strong><p>当前头像图片及裁剪设置将被移除。</p><footer><button type="button" data-keep>保留头像</button><button type="button" data-confirm>恢复默认</button></footer>'
+  dialog.append(confirmation)
+  confirmation.querySelector('[data-keep]').onclick=()=>confirmation.close()
+  confirmation.addEventListener('cancel',e=>{e.stopPropagation()})
+  confirmation.addEventListener('keydown',e=>{if(e.key==='Escape')e.stopPropagation()})
   panel.append(dialog)
   const canvas=dialog.querySelector('canvas'),zoom=dialog.querySelector('input[type=range]'),status=dialog.querySelector('[role=status]')
   let bitmap,original,role,crop={zoom:1,x:.5,y:.5},drag,busy=false,disposed=false,generation=0,previousFocus,revision,hasCustom=false,ready=false
   const clean=()=>{bitmap?.close();bitmap=null;original=null;drag=null}
-  const close=()=>{generation++;dialog.close?.();clean();previousFocus?.focus?.({preventScroll:true})}
+  const close=()=>{generation++;confirmation.close?.();dialog.close?.();clean();previousFocus?.focus?.({preventScroll:true})}
   const draw=()=>{
     zoom.value=String(crop.zoom)
     if(!bitmap){canvas.getContext('2d').clearRect(0,0,320,320);return}
@@ -103,8 +111,13 @@ export function mountAvatarCrop({panel,window,load,onSave}){
     catch{status.textContent='图片无法读取，请选择不超过 5 MB、2500 万像素的图片'}
     finally{busy=false;controls()}
   })
-  dialog.querySelector('[data-crop-reset]').addEventListener('click',async()=>{
-    if(busy||!hasCustom||!window.confirm('恢复默认头像将移除当前图片及裁剪设置，是否继续？'))return
+  dialog.querySelector('[data-crop-reset]').addEventListener('click',()=>{
+    if(busy||!hasCustom)return
+    confirmation.showModal();confirmation.querySelector('[data-keep]').focus()
+  })
+  confirmation.querySelector('[data-confirm]').addEventListener('click',async()=>{
+    if(busy||!hasCustom)return
+    confirmation.close()
     busy=true;controls()
     try{await onSave(role,null,undefined,revision);if(!disposed)close()}
     catch(error){status.textContent=error.message}

package/src/client/background-region-editor.js

@@ -76,7 +76,8 @@ export function mountBackgroundRegionEditor({section,window,store}) {
     event.preventDefault();const bounds=stage.getBoundingClientRect();if(!bounds.width||!bounds.height)return
     const x=clamp((event.clientX-bounds.left)/bounds.width,0,1),y=clamp((event.clientY-bounds.top)/bounds.height,0,1)
     drag={x,y,bounds,initial:{...draft},corner:event.target.dataset.prtsRegionHandle,id:event.pointerId}
-    stage.style.cursor=window.getComputedStyle(event.target).cursor
+    const cursorStyle=window.getComputedStyle(event.target)
+    stage.style.cursor=cursorStyle.getPropertyValue('--prts-source-cursor').trim() || cursorStyle.cursor
     stage.setPointerCapture?.(event.pointerId);draw()
   }
   function adjust(initial,dx,dy,corner){

package/src/client/conversation-control-adapter.js

@@ -146,7 +146,7 @@ export function createConversationControlAdapter({ document, window }) {
   }
 }
 
-// One shared frame follows body targets, including transitions between neighboring controls.
+// One shared frame for card transitions and nearby compact controls.
 function mountBodyTargetFrame(document, window, operation) {
   // Nonvisual hosts can still mount the theme without an animation clock.
   if (!window?.requestAnimationFrame || !window?.cancelAnimationFrame) return () => {}
@@ -157,9 +157,46 @@ function mountBodyTargetFrame(document, window, operation) {
   const corners=Array.from({length:4},()=>frame.appendChild(document.createElement('i')))
   document.body.append(frame)
   if(frame.showPopover)frame.setAttribute('popover','manual')
+  let ghost=null, ghostCorners=[], ghostAnimations=[]
+  const clearGhost=()=>{
+    for(const animation of ghostAnimations)animation.cancel()
+    if(ghost)ghost.style.opacity='0'
+  }
+  const retireGhost=()=>{
+    // Allocate one reusable layer and five animations per adapter lifetime.
+    // Repeated handoffs must not churn body portals or their observers.
+    if(!ghost){
+      ghost=frame.cloneNode(true)
+      ghost.removeAttribute('data-prts-body-target-frame')
+      ghost.setAttribute('data-prts-body-target-ghost','')
+      ghost.removeAttribute('data-pressed')
+      ghost.style.opacity='0'
+      ghostCorners=[...ghost.children]
+      document.body.append(ghost)
+      ghostAnimations=[...ghostCorners,ghost].map(node=>{
+        const animation=node.animate([],{duration:80,easing:'ease-out',fill:'forwards'})
+        animation.cancel()
+        return animation
+      })
+      ghostAnimations[4].onfinish=()=>{
+        if(ghostAnimations[4]?.playState==='finished')clearGhost()
+      }
+    }
+    ghost.style.color=frame.style.color
+    ghost.style.setProperty('--prts-arm-scale',frame.style.getPropertyValue('--prts-arm-scale'))
+    if(ghost.showPopover && !ghost.matches(':popover-open'))ghost.showPopover()
+    for(const [index,corner] of corners.entries()){
+      const from=corner.style.transform
+      const dx=index%2?-4:4,dy=index<2?4:-4
+      ghostAnimations[index].effect.setKeyframes([{transform:from},{transform:from+' translate('+dx+'px,'+dy+'px)'}])
+    }
+    ghostAnimations[4].effect.setKeyframes([{opacity:frame.style.opacity},{opacity:0}])
+    for(const animation of ghostAnimations){animation.currentTime=0;animation.play()}
+  }
   let layer=null, imageRetiring=false
   const hideFrame=()=>{
     if(frame.hidePopover && frame.matches(':popover-open'))frame.hidePopover()
+    if(ghost?.hidePopover && ghost.matches(':popover-open'))ghost.hidePopover()
   }
   const showFrame=()=>{
     if(!frame.showPopover)return
@@ -171,6 +208,8 @@ function mountBodyTargetFrame(document, window, operation) {
   let target=null, hovered=null, focused=null, raf=0, pressed=false, releasePending=false, disposed=false
   let pointer={x:0,y:0}, state=null, settled=false, tween=null, bounds=null, boundsDirty=false, hitDirty=false, exitGoal=null, motionDuration=240, targetArm=7, retiringBounds=null, targetRetires=false
   let moveRaf=0, pendingMove=null
+  let spring=false, springTime=null, springStart=null, velocity={}
+  let departed=null
   const resizeObserver=window.ResizeObserver?new window.ResizeObserver(entries=>{
     if(!target)return
     const entry=entries.find(item=>item.target===target),size=entry?.borderBoxSize?.[0]
@@ -182,16 +221,26 @@ function mountBodyTargetFrame(document, window, operation) {
   const reduced=window.matchMedia?.('(prefers-reduced-motion: reduce)')
   const fine=window.matchMedia?.('(hover:hover) and (pointer:fine)')
   let activeModal=null
+  const cardSelector='[data-presented-file],[data-changed-files],[data-tool="schedule_create"]'
   const find=node=>{
     if(activeModal && !activeModal.contains(node))return null
     if (!node?.closest || node.closest('[data-prts-workspace-actions],[data-prts-session-actions]')) return null
-    const schedule=node.closest('[data-tool="schedule_create"]')
-    const scheduleOpen=schedule && [...schedule.children].find(child=>child.tagName==='BUTTON' && hasClassSuffix(child,'_cardOpen') && !child.matches(':disabled,[aria-disabled="true"]'))
+    const container=node.closest(cardSelector)
     const button=node.closest('button')
-    // The transparent hit layer targets the card; nested actions keep their own frame.
-    const card=node.closest('[data-presented-file],[data-changed-files]') || (scheduleOpen && (!button || button===scheduleOpen)?schedule:null)
+    let cardTarget=null
+    if(container){
+      const action=node.closest('button,a[href],[role="button"],[role="link"],summary,input:not([type="hidden"]),select,textarea')
+      const nested=action && action!==container && container.contains(action)
+      // Disabled controls must not fall back to their enclosing card.
+      if(node.closest(':disabled,[aria-disabled="true"],[inert]'))return null
+      const hitLayer=nested && action.tagName==='BUTTON' && (
+        container.matches('[data-presented-file]') && hasClassSuffix(action,'_cardPreview') ||
+        action.parentElement===container && container.matches('[data-tool="schedule_create"]') && hasClassSuffix(action,'_cardOpen'))
+      const openable=!container.matches('[data-tool="schedule_create"]') || [...container.children].some(child=>child.tagName==='BUTTON' && hasClassSuffix(child,'_cardOpen') && !child.matches(':disabled,[aria-disabled="true"]'))
+      cardTarget=nested && !hitLayer ? action : openable ? container : null
+    }
     const pendingAction=operation.contains(button) && isPendingInteractionAction(button) ? button : null
-    const candidate=card || pendingAction || node.closest(selector)
+    const candidate=cardTarget || pendingAction || node.closest(selector)
     return candidate && !candidate.matches(':disabled,[aria-disabled="true"]') && !candidate.closest('[inert]') ? candidate : null
   }
   const measure=(box)=>{bounds=box || target.getBoundingClientRect();targetArm=7+Math.max(0,Math.min(1,(Math.min(bounds.width,bounds.height)-36)/36))*5;boundsDirty=false}
@@ -200,20 +249,55 @@ function mountBodyTargetFrame(document, window, operation) {
     const next=(hovered?.isConnected?hovered:null) || (focused?.isConnected?focused:null)
     if(next!==target){
       const nextBounds=next?.getBoundingClientRect()
+      const now=window.performance.now()
+      const previous=target || (departed && now-departed.time<=100?departed.node:null)
+      const previousBounds=target?bounds:departed?.bounds
+      const card=previous?.closest(cardSelector)
+      const sameCard=Boolean(target && card && card===next?.closest(cardSelector))
+      const compact=(node,box)=>node?.matches('button,a[href],[role="button"],[role="link"]')
+        && box?.width>0 && box.width<=160 && box.height>0 && box.height<=64
+      const nearby=Boolean(next && previous?.isConnected && !card && !next.closest(cardSelector)
+        && compact(previous,previousBounds) && compact(next,nextBounds)
+        && previous.closest('dialog,[role="dialog"]')===next.closest('dialog,[role="dialog"]'))
+      const eligible=Boolean(next && previous?.isConnected && (sameCard || nearby)
+        && state?.alpha>0 && !reduced?.matches)
+      // Maximum corner travel catches wide-card -> edge-button transitions,
+      // even when the two centers happen to be close.
+      const travel=eligible?Math.max(
+        Math.hypot(state.x-(nextBounds.left-5),state.y-(nextBounds.top-5)),
+        Math.hypot(state.x+state.w-(nextBounds.right+5),state.y-(nextBounds.top-5)),
+        Math.hypot(state.x-(nextBounds.left-5),state.y+state.h-(nextBounds.bottom+5)),
+        Math.hypot(state.x+state.w-(nextBounds.right+5),state.y+state.h-(nextBounds.bottom+5))):0
+      const scale=eligible?Math.max(state.w/(nextBounds.width+10),(nextBounds.width+10)/state.w,state.h/(nextBounds.height+10),(nextBounds.height+10)/state.h):1
+      const morph=eligible && (sameCard || travel<=96 && scale<=2)
+      const handoff=morph && (travel>96 || scale>2)
+      if(!next && target)departed={node:target,bounds,time:now}
+      else if(next)departed=null
+      clearGhost()
+      if(handoff && frame.animate)retireGhost()
+      spring=morph && !handoff;springStart=null
+      if(!spring){springTime=null;velocity={}}
       const retire=!next && target && !target.isConnected && targetRetires && releasePending && bounds && !reduced?.matches
       imageRetiring=false
       retiringBounds=retire?{left:bounds.left,top:bounds.top,width:bounds.width,height:bounds.height}:null
       target?.removeAttribute('data-prts-corner-target')
       if(retire){hovered=focused=target=null;boundsDirty=false;resizeObserver?.disconnect();wake();return}
-      pressed=false;releasePending=false;settled=false;tween=null;exitGoal=null;motionDuration=240;target=next;boundsDirty=true
+      pressed=false;releasePending=false;settled=false;tween=null;exitGoal=null;motionDuration=morph?120:240;target=next;boundsDirty=true
       resizeObserver?.disconnect()
       if(target)resizeObserver?.observe(target)
       if(target){
         targetRetires=hasClassSuffix(target,'_toBottom') || isPendingInteractionAction(target)
         target.setAttribute('data-prts-corner-target','');showFrame()
         measure(nextBounds);const box=bounds
-        state={x:(hovered?pointer.x:box.left+box.width/2)-10,y:(hovered?pointer.y:box.top+box.height/2)-10,w:20,h:20,alpha:0,arm:7}
-        frame.style.opacity='0'
+        // Preserve the last painted geometry when interrupted: no restart from
+        // the pointer, opacity flash, queued animations, or extra layout reads.
+        if(handoff){
+          state={x:box.left-12,y:box.top-12,w:box.width+24,h:box.height+24,alpha:0,arm:targetArm}
+          frame.style.opacity='0'
+        }else if(!morph){
+          state={x:(hovered?pointer.x:box.left+box.width/2)-10,y:(hovered?pointer.y:box.top+box.height/2)-10,w:20,h:20,alpha:0,arm:7}
+          frame.style.opacity='0'
+        }
         frame.style.color=target.getAttribute('data-prts-conversation-control')==='danger'?window.getComputedStyle(target).getPropertyValue('--prts-red'):'var(--prts-corner-color, var(--prts-yellow))'
       }
     }
@@ -239,15 +323,40 @@ function mountBodyTargetFrame(document, window, operation) {
     const edgeRight=pixel(goal.x+goal.w),edgeBottom=pixel(goal.y+goal.h)
     goal.x=pixel(goal.x);goal.y=pixel(goal.y);goal.w=edgeRight-goal.x;goal.h=edgeBottom-goal.y
     const keys=['x','y','w','h','alpha','arm']
-    if(!tween || keys.some(key=>tween.to[key]!==goal[key])){
-      const remaining=tween && tween.pressed===pressed?Math.max(0,tween.start+tween.duration-time):motionDuration
-      tween={from:{...state},to:{...goal},start:time,duration:remaining,pressed}
+    let moving=false
+    if(spring && target && !pressed && !reduced?.matches){
+      // Exact critically damped solution: stable at variable frame rates, with
+      // velocity retained across target changes. No physics substep loop.
+      const dt=springTime===null?0:Math.max(0,(time-springTime)/1000)
+      springTime=time;springStart ??= time
+      const omega=48, decay=Math.exp(-omega*dt)
+      for(const key of keys){
+        const offset=state[key]-goal[key],speed=velocity[key] || 0
+        const coefficient=speed+omega*offset
+        state[key]=goal[key]+(offset+coefficient*dt)*decay
+        velocity[key]=(speed-omega*coefficient*dt)*decay
+        const tolerance=key==='alpha'?.002:.08
+        if(Math.abs(state[key]-goal[key])>tolerance || Math.abs(velocity[key])>tolerance*48)moving=true
+      }
+      // Stop together, with a bounded tail even after a busy main-thread frame.
+      if(!moving || time-springStart>=400){
+        Object.assign(state,goal);velocity={};spring=false;springTime=null;moving=false
+      }
+    }else{
+      spring=false;springTime=null;springStart=null
+      if(!tween || keys.some(key=>tween.to[key]!==goal[key])){
+        const remaining=tween && tween.pressed===pressed?Math.max(0,tween.start+tween.duration-time):motionDuration
+        tween={from:{...state},to:{...goal},start:time,duration:remaining,pressed}
+      }
+      // Keep instantaneous velocity available if a card morph interrupts entry.
+      const progress=reduced?.matches || settled || !tween.duration || (!state.alpha && !goal.alpha)?1:Math.min(1,(time-tween.start)/tween.duration)
+      const ease=1-(1-progress)**3
+      for(const key of keys){
+        state[key]=tween.from[key]+(goal[key]-tween.from[key])*ease
+        velocity[key]=progress<1?(goal[key]-tween.from[key])*3*(1-progress)**2*1000/tween.duration:0
+      }
+      moving=progress<1
     }
-    // All channels share one endpoint; no separate thresholds or late position snap.
-    const progress=reduced?.matches || settled || !tween.duration || (!state.alpha && !goal.alpha)?1:Math.min(1,(time-tween.start)/tween.duration)
-    const ease=1-(1-progress)**3
-    for(const key of keys)state[key]=tween.from[key]+(goal[key]-tween.from[key])*ease
-    const moving=progress<1
     const x=state.x,y=state.y
     const right=state.x+state.w-7,bottom=state.y+state.h-7
     const positions=[[x,y],[right,y],[x,bottom],[right,bottom]]
@@ -289,7 +398,7 @@ function mountBodyTargetFrame(document, window, operation) {
   const focus=event=>{focused=event.target.matches?.(':focus-visible')?find(event.target):null;choose()}
   const blur=()=>{focused=null;choose()}
   const down=event=>{
-    flushMove()
+    flushMove();clearGhost()
     pointer={x:event.clientX,y:event.clientY}
     if(event.pointerType==='touch')hovered=find(event.target)
     choose()
@@ -303,10 +412,11 @@ function mountBodyTargetFrame(document, window, operation) {
   }
   const up=event=>{release();if(event.pointerType==='touch')hovered=null;choose()}
   const reset=()=>{
-    clearMove()
+    clearGhost();clearMove()
     target?.removeAttribute('data-prts-corner-target');hideFrame()
     hovered=focused=target=null;state=tween=bounds=exitGoal=retiringBounds=null
     imageRetiring=false
+    spring=false;springTime=springStart=null;velocity={};departed=null
     pressed=false;releasePending=false;settled=true;boundsDirty=hitDirty=false
     resizeObserver?.disconnect();window.cancelAnimationFrame(raf);raf=0
     frame.style.opacity='0';frame.removeAttribute('data-pressed')
@@ -346,11 +456,12 @@ function mountBodyTargetFrame(document, window, operation) {
   ]
   for(const [node,event,handler] of listeners)node.addEventListener(event,handler)
   return ()=>{
-    clearMove()
+    clearGhost();clearMove()
     modalObserver?.disconnect();document.removeEventListener('toggle',modalToggle,true)
     disposed=true;target?.removeAttribute('data-prts-corner-target');hideFrame();window.cancelAnimationFrame(raf);resizeObserver?.disconnect()
     document.removeEventListener('scroll',scroll,true);window.removeEventListener('resize',reset)
     for(const [node,event,handler] of listeners)node.removeEventListener(event,handler)
+    ghost?.remove();ghost=null;ghostAnimations=[];ghostCorners=[]
     frame.remove()
   }
 }

package/src/client/cursor-adapter.js

@@ -2,12 +2,15 @@
 export function createCursorAdapter({ document, window, assets }) {
   const root = document?.documentElement
   let listening = false
+  let animate = true
   let pointerId
   let timer
+  let compact = false, pressedAt = 0
   let handPhase
   let gestureAssets = assets
   let textTarget
   let moveFrame, pendingMove
+  let textRange
   let lastPoint
   const heroTextSelector = '[data-phase="hero"] [class$="_titleGroup"]'
   const contentSelector = '[data-markdown], [data-slot*="markdown" i], [class*="markdown" i], :is([data-chat-flow-kind="user"], [data-chat-flow-kind="steering"], [data-submission-echo], [data-pending-steering]) [class$="_bubble"]'
@@ -23,14 +26,19 @@ export function createCursorAdapter({ document, window, assets }) {
     textTarget = nextTarget
     textTarget?.setAttribute('data-prts-text-hit', '')
   }
-  function findTextHit(event) {
+  function prepareTextHit(target, semanticOnly = true) {
+    const content = target?.closest?.(`${contentSelector}, ${heroTextSelector}`)
+    if (!content || (!content.matches(heroTextSelector) && !content.closest('[data-chat-flow-kind], [data-message-role], [data-submission-echo], [data-pending-steering]')) || target.closest(controlSelector)) return {target}
+    const style = window.getComputedStyle(target)
+    if (style.userSelect === 'none' || (!semanticOnly && !style.cursor.includes('data:image/png'))) return {target}
+    return {target,content}
+  }
+  function findTextHit(event, semanticOnly = false, prepared) {
     if (event.pointerType !== 'mouse') return
     lastPoint = { clientX: event.clientX, clientY: event.clientY, pointerType: 'mouse' }
     const target = event.target?.nodeType === 1 ? event.target : event.target?.parentElement
-    const content = target?.closest?.(`${contentSelector}, ${heroTextSelector}`)
-    if (!content || (!content.matches(heroTextSelector) && !content.closest('[data-chat-flow-kind], [data-message-role], [data-submission-echo], [data-pending-steering]')) || target.closest(controlSelector)) return
-    const style = window.getComputedStyle(target)
-    if (style.userSelect === 'none' || !style.cursor.includes('data:image/png')) return
+    const {content} = prepared?.target===target ? prepared : prepareTextHit(target,semanticOnly)
+    if (!content) return
     // Caret APIs return the nearest insertion point even over empty space.
     // Check its adjacent character rectangles before treating it as a text hit.
     const caret = document.caretPositionFromPoint?.(event.clientX, event.clientY)
@@ -38,8 +46,8 @@ export function createCursorAdapter({ document, window, assets }) {
     const node = caret?.offsetNode ?? fallback?.startContainer
     const offset = caret?.offset ?? fallback?.startOffset
     if (node?.nodeType !== 3 || !content.contains(node) || node.parentElement?.closest(controlSelector)) return
-    if (window.getComputedStyle(node.parentElement).userSelect === 'none') return
-    const range = document.createRange()
+    if (node.parentElement !== target && window.getComputedStyle(node.parentElement).userSelect === 'none') return
+    const range = textRange ||= document.createRange()
     for (const index of [offset - 1, offset]) {
       if (index < 0 || index >= node.length) continue
       range.setStart(node, index)
@@ -111,7 +119,7 @@ export function createCursorAdapter({ document, window, assets }) {
     lastHandFrame = undefined
   }
   // Cursor is inherited. Animating a large container still restyles its subtree.
-  // Keep those background hits static, while controls retain native animation.
+  // Use one pressed pose for medium containers; keep larger backgrounds static.
   const maxAnimatedDescendants = 128
   function canAnimate(target) {
     return target && target.getElementsByTagName('*').length <= maxAnimatedDescendants
@@ -119,8 +127,9 @@ export function createCursorAdapter({ document, window, assets }) {
   function followHand(target) {
     if (stopIfHandChanged()) return
     if (target === handTarget && target !== textTarget) return
+    if(compact && handTarget && target!==handTarget){reset();return}
     restoreHandTarget()
-    if (!canAnimate(target) || !handCursor || target === textTarget) return
+    if ((!compact && !canAnimate(target)) || !handCursor || target === textTarget) return
     const cursor = window.getComputedStyle(target).cursor
     if (!cursor.includes('data:image/png') || /(?:,\s*(?:text|grab|grabbing|not-allowed|no-drop)|resize)$/.test(cursor)) return
     handTarget = target
@@ -150,6 +159,7 @@ export function createCursorAdapter({ document, window, assets }) {
     handCursor = undefined
     root?.style.removeProperty('--prts-text-frame')
     handPhase = undefined
+    compact=false
   }
   function show(url) {
     const [x, y] = gestureAssets.hotspot
@@ -187,13 +197,19 @@ export function createCursorAdapter({ document, window, assets }) {
     updateTextHit(event)
     const target = event.target?.nodeType === 1 ? event.target : event.target?.parentElement
     reset()
+    if (!animate) return
     const cursor = target ? window.getComputedStyle(target).cursor : ''
     if (!cursor.includes('data:image/png')) return
-    if (/(?:,\s*(?:text|grab|grabbing|not-allowed|no-drop)|resize)$/.test(cursor) || !canAnimate(target)) return
+    if (/(?:,\s*(?:text|grab|grabbing|not-allowed|no-drop)|resize)$/.test(cursor)) return
+    const descendants=target.getElementsByTagName('*').length
+    if(descendants>256)return
+    compact=descendants>maxAnimatedDescendants
+    pressedAt=window.performance.now()
     gestureAssets = /,\s*pointer$/.test(cursor) && assets.link ? assets.link : assets
     pointerId = event.pointerId
-    handCursor = cursor
+    handCursor = compact ? `url("${gestureAssets.hold}") ${gestureAssets.hotspot[0]} ${gestureAssets.hotspot[1]}, pointer` : cursor
     followHand(target)
+    if(compact){handPhase='hold';return}
     if (reduced()) { clearTimer(); show(gestureAssets.hold); return }
     handPhase = 'press'
     play(gestureAssets.press, () => {
@@ -212,6 +228,12 @@ export function createCursorAdapter({ document, window, assets }) {
     if (pointerId === undefined || event.pointerId !== pointerId || event.button !== 0) return
     pointerId = undefined
     if (reduced()) { reset(); return }
+    if(compact){
+      const remaining=80-(window.performance.now()-pressedAt)
+      if(remaining>0)timer=window.setTimeout(reset,remaining)
+      else reset()
+      return
+    }
     if (handPhase === 'press') return
     releaseHand()
   }
@@ -252,16 +274,26 @@ export function createCursorAdapter({ document, window, assets }) {
     if (event.target === window) resetInteraction()
   }
   function visibility() { if (document.hidden) resetInteraction() }
-  const events = [['pointerdown', down], ['pointerup', up], ['pointermove', move], ['pointercancel', resetInteraction], ['blur', blur], ['dragstart', resetInteraction], ['pointerout', leave], ['scroll', refreshTextHit], ['resize', refreshTextHit]]
+  function over(event) {
+    if (animate || event.pointerType !== 'mouse') return
+    clearPendingMove()
+    applyMove(event)
+  }
+  const events = [['pointerdown', down], ['pointerup', up], ['pointermove', move], ['pointerover', over], ['pointercancel', resetInteraction], ['blur', blur], ['dragstart', resetInteraction], ['pointerout', leave], ['scroll', refreshTextHit], ['resize', refreshTextHit]]
   function dispose() {
     resetInteraction()
+    textRange=undefined
     if (!listening) return
     for (const [name, handler] of events) window.removeEventListener(name, handler, true)
     document.removeEventListener('visibilitychange', visibility)
     listening = false
   }
   return {
+    prepareTextHit,
+    textHit: (event, prepared) => findTextHit(event, true, prepared),
     update(preferences) {
+      if (animate && preferences.cursorAnimation === false) reset()
+      animate = preferences.cursorAnimation !== false
       if (!root || !assets || !preferences.enabled || preferences.cursor !== 'prts') { dispose(); return }
       if (listening) return
       for (const [name, handler] of events) window.addEventListener(name, handler, true)