export const MENU_HIGHLIGHT_DURATION_MS = 240; export type MenuHighlightAnimation = { dx: number; dy: number; startedAt: number; token: number; durationMs: number }; let nextToken = 1; /** A fresh display-list timeline token, shared by all menu animations. */ export function nextAnimationToken(): number { return nextToken++; } /** Eligibility is decided by menu navigation, before the display-list bridge. */ export class MenuHighlightMotion { private previous?: { index: number; scroll: number; x: number; y: number; width: number; height: number }; private fromIndex: number | null = null; private animation?: MenuHighlightAnimation; navigate(from: number, wrapped: boolean): void { this.fromIndex = wrapped ? null : from; } /** `scrolling`: the scroll change since the last paint is itself animated, so the highlight may slide across it. */ paint(index: number, scroll: number, x: number, y: number, width: number, height: number, now: number, scrolling = false): MenuHighlightAnimation | undefined { const previous = this.previous; if (!previous || previous.index !== index || previous.scroll !== scroll || previous.x !== x || previous.y !== y || previous.width !== width || previous.height !== height) { let fromX = previous?.x ?? x, fromY = previous?.y ?? y; if (previous && this.animation) { const t = Math.max(0, Math.min(1, (now - this.animation.startedAt) / this.animation.durationMs)); const remaining = 1 - t * t * (3 - 2 * t); fromX += this.animation.dx * remaining; fromY += this.animation.dy * remaining; } const eligible = previous && previous.index !== index && this.fromIndex === previous.index && (previous.scroll === scroll || scrolling) && previous.width === width && previous.height === height; this.animation = eligible ? { dx: Math.round(fromX - x), dy: Math.round(fromY - y), startedAt: now, token: nextAnimationToken(), durationMs: MENU_HIGHLIGHT_DURATION_MS } : undefined; this.fromIndex = null; this.previous = { index, scroll, x, y, width, height }; } return this.animation && now - this.animation.startedAt < this.animation.durationMs ? this.animation : undefined; } /** Cancel an animation in flight, e.g. when it cannot be drawn; the next change snaps from where it rests. */ cancel(): void { this.animation = undefined; } }