@@ -13,6 +13,7 @@ import {
1313 act ,
1414 createRef ,
1515 useLayoutEffect ,
16+ useState ,
1617 type ReactNode ,
1718 type Ref ,
1819 type ReactElement ,
@@ -87,6 +88,11 @@ beforeEach(() => {
8788 activityTestState . expandedRuns = false ;
8889} ) ;
8990
91+ const legendListTestState = vi . hoisted ( ( ) => ( {
92+ data : undefined as unknown ,
93+ onScroll : undefined as ( ( ) => void ) | undefined ,
94+ } ) ) ;
95+
9096vi . mock ( "@legendapp/list/react" , async ( ) => {
9197 const legendListTestId = "legend-list" ;
9298
@@ -122,8 +128,11 @@ vi.mock("@legendapp/list/react", async () => {
122128 } ;
123129 className ?: string ;
124130 contentInsetEndAdjustment ?: number ;
131+ onScroll ?: ( ) => void ;
125132 ref ?: Ref < LegendListRef > ;
126133 } ) => {
134+ legendListTestState . data = props . data ;
135+ legendListTestState . onScroll = props . onScroll ;
127136 if ( props . anchoredEndSpace ) {
128137 props . anchoredEndSpace . onSizeChanged ?.( 240 ) ;
129138 props . anchoredEndSpace . onReady ?.( { anchorIndex : props . anchoredEndSpace . anchorIndex } ) ;
@@ -741,6 +750,150 @@ describe("MessagesTimeline", () => {
741750 } ,
742751 ) ;
743752
753+ function stubFollowTimeline ( routeThreadKey : string ) {
754+ const frames = new Map < number , FrameRequestCallback > ( ) ;
755+ let nextFrame = 0 ;
756+ vi . stubGlobal ( "requestAnimationFrame" , ( callback : FrameRequestCallback ) => {
757+ frames . set ( ++ nextFrame , callback ) ;
758+ return nextFrame ;
759+ } ) ;
760+ vi . stubGlobal ( "cancelAnimationFrame" , ( frame : number ) => frames . delete ( frame ) ) ;
761+ vi . stubGlobal ( "IS_REACT_ACT_ENVIRONMENT" , true ) ;
762+ const props = { ...buildProps ( ) , routeThreadKey } ;
763+ const timeline = {
764+ props,
765+ scrollTop : 1400 ,
766+ flushFrame : ( ) =>
767+ act ( ( ) => {
768+ const callbacks = [ ...frames . values ( ) ] ;
769+ frames . clear ( ) ;
770+ callbacks . forEach ( ( callback ) => callback ( 0 ) ) ;
771+ } ) ,
772+ } ;
773+ const viewport = {
774+ get scrollTop ( ) {
775+ return timeline . scrollTop ;
776+ } ,
777+ getBoundingClientRect : ( ) => ( { top : 0 } ) ,
778+ } ;
779+ props . listRef . current = {
780+ getScrollableNode : ( ) => viewport ,
781+ getState : ( ) => ( {
782+ data : legendListTestState . data ,
783+ scroll : timeline . scrollTop ,
784+ scrollLength : 600 ,
785+ contentLength : 2000 ,
786+ indexByKey : ( ) => 0 ,
787+ positionAtIndex : ( ) => 0 ,
788+ sizeAtIndex : ( ) => 2000 ,
789+ elementAtIndex : ( ) => ( { getBoundingClientRect : ( ) => ( { top : - timeline . scrollTop } ) } ) ,
790+ } ) ,
791+ } as unknown as LegendListRef ;
792+ return timeline ;
793+ }
794+
795+ it ( "remembers a manual reading position when the chat closes before the next frame" , async ( ) => {
796+ const { readTimelinePosition } = await import ( "./timelineScrollAnchoring" ) ;
797+ const timeline = stubFollowTimeline ( "environment-local:manual-departure" ) ;
798+ const { props } = timeline ;
799+ let navigateManually = ( ) => { } ;
800+ function ChatProbe ( ) {
801+ const [ liveFollowEnabled , setLiveFollowEnabled ] = useState ( true ) ;
802+ navigateManually = ( ) => setLiveFollowEnabled ( false ) ;
803+ return (
804+ < MessagesTimeline
805+ { ...props }
806+ timelineEntries = { [ buildUserTimelineEntry ( "First prompt" ) ] }
807+ liveFollowEnabled = { liveFollowEnabled }
808+ onManualNavigation = { navigateManually }
809+ />
810+ ) ;
811+ }
812+ let renderer : ReactTestRenderer | undefined ;
813+ try {
814+ await act ( ( ) => {
815+ renderer = create ( < ChatProbe /> ) ;
816+ } ) ;
817+ await timeline . flushFrame ( ) ;
818+ expect ( readTimelinePosition ( props . routeThreadKey ) ?. atEnd ) . toBe ( true ) ;
819+
820+ // The scroll event lands before the follow opt-out renders.
821+ timeline . scrollTop = 1300 ;
822+ await act ( ( ) => {
823+ navigateManually ( ) ;
824+ legendListTestState . onScroll ?.( ) ;
825+ } ) ;
826+ await act ( ( ) => renderer ?. unmount ( ) ) ;
827+ renderer = undefined ;
828+
829+ expect ( readTimelinePosition ( props . routeThreadKey ) ) . toMatchObject ( {
830+ atEnd : false ,
831+ scrollOffset : 1300 ,
832+ } ) ;
833+ } finally {
834+ await act ( ( ) => renderer ?. unmount ( ) ) ;
835+ }
836+ } ) ;
837+
838+ it ( "keeps a following thread's intent while its timeline is held for the next thread" , async ( ) => {
839+ const { readTimelinePosition } = await import ( "./timelineScrollAnchoring" ) ;
840+ const timeline = stubFollowTimeline ( "environment-local:held-departure" ) ;
841+ const { props } = timeline ;
842+ // Smooth follow is still catching up with the stream.
843+ timeline . scrollTop = 1300 ;
844+ const render = ( held : boolean ) => (
845+ < MessagesTimeline
846+ { ...props }
847+ timelineEntries = { [ buildUserTimelineEntry ( "First prompt" ) ] }
848+ liveFollowEnabled = { ! held }
849+ paintOnly = { held }
850+ />
851+ ) ;
852+ let renderer : ReactTestRenderer | undefined ;
853+ try {
854+ await act ( ( ) => {
855+ renderer = create ( render ( false ) ) ;
856+ } ) ;
857+ await timeline . flushFrame ( ) ;
858+ expect ( readTimelinePosition ( props . routeThreadKey ) ?. atEnd ) . toBe ( true ) ;
859+
860+ await act ( ( ) => renderer ?. update ( render ( true ) ) ) ;
861+ await timeline . flushFrame ( ) ;
862+
863+ expect ( readTimelinePosition ( props . routeThreadKey ) ?. atEnd ) . toBe ( true ) ;
864+ } finally {
865+ await act ( ( ) => renderer ?. unmount ( ) ) ;
866+ }
867+ } ) ;
868+
869+ it ( "remembers a first send held near the top as a reading position" , async ( ) => {
870+ const { readTimelinePosition } = await import ( "./timelineScrollAnchoring" ) ;
871+ const timeline = stubFollowTimeline ( "environment-local:anchored-first-send" ) ;
872+ const { props } = timeline ;
873+ timeline . scrollTop = 1300 ;
874+ let renderer : ReactTestRenderer | undefined ;
875+ try {
876+ await act ( ( ) => {
877+ renderer = create (
878+ < MessagesTimeline
879+ { ...props }
880+ timelineEntries = { [ buildUserTimelineEntry ( "First prompt" ) ] }
881+ anchorMessageId = { MessageId . make ( "message-1" ) }
882+ liveFollowEnabled
883+ /> ,
884+ ) ;
885+ } ) ;
886+ await timeline . flushFrame ( ) ;
887+
888+ expect ( readTimelinePosition ( props . routeThreadKey ) ) . toMatchObject ( {
889+ atEnd : false ,
890+ scrollOffset : 1300 ,
891+ } ) ;
892+ } finally {
893+ await act ( ( ) => renderer ?. unmount ( ) ) ;
894+ }
895+ } ) ;
896+
744897 it ( "preserves arbitrary XML-like tags and comparisons in rendered user messages" , async ( ) => {
745898 const { MessagesTimeline } = await import ( "./MessagesTimeline" ) ;
746899 const markup = renderToStaticMarkup (
0 commit comments