@assistant-ui/react-native 0.1.30 → 0.1.31

package/dist/primitives/thread/ThreadMessages.js.map

@@ -1 +1 @@
-{"version":3,"file":"ThreadMessages.js","names":["ComponentType","FC","ReactNode","forwardRef","memo","useCallback","FlatList","FlatListProps","MessageState","ThreadMessage","RenderChildrenWithAccessor","useAuiState","MessageByIndexProvider","MessageComponents","Message","EditComposer","UserEditComposer","AssistantEditComposer","SystemEditComposer","UserMessage","AssistantMessage","SystemMessage","MessagesContent","components","children","value","message","ThreadMessagesProps","Omit","DEFAULT_SYSTEM_MESSAGE","getComponent","role","isEditing","_exhaustiveCheck","Error","ThreadMessageComponent","t0","$","_c","_temp","_temp2","t1","Component","t2","ThreadMessageByIndex","index","prev","next","displayName","ThreadMessageByChildren","aui","thread","getState","getItem","ThreadMessages","ref","flatListProps","messages","_temp3","renderItem","keyExtractor","_temp4","t3","s","s_0","composer","item","id"],"sources":["../../../src/primitives/thread/ThreadMessages.tsx"],"sourcesContent":["import {\n  type ComponentType,\n  type FC,\n  type ReactNode,\n  forwardRef,\n  memo,\n  useCallback,\n} from \"react\";\nimport { FlatList, type FlatListProps } from \"react-native\";\nimport type { MessageState, ThreadMessage } from \"@assistant-ui/core\";\nimport { RenderChildrenWithAccessor, useAuiState } from \"@assistant-ui/store\";\nimport { MessageByIndexProvider } from \"@assistant-ui/core/react\";\n\ntype MessageComponents =\n  | {\n      Message: ComponentType;\n      EditComposer?: ComponentType | undefined;\n      UserEditComposer?: ComponentType | undefined;\n      AssistantEditComposer?: ComponentType | undefined;\n      SystemEditComposer?: ComponentType | undefined;\n      UserMessage?: ComponentType | undefined;\n      AssistantMessage?: ComponentType | undefined;\n      SystemMessage?: ComponentType | undefined;\n    }\n  | {\n      Message?: ComponentType | undefined;\n      EditComposer?: ComponentType | undefined;\n      UserEditComposer?: ComponentType | undefined;\n      AssistantEditComposer?: ComponentType | undefined;\n      SystemEditComposer?: ComponentType | undefined;\n      UserMessage: ComponentType;\n      AssistantMessage: ComponentType;\n      SystemMessage?: ComponentType | undefined;\n    };\n\ntype MessagesContent =\n  | {\n      /** @deprecated Use the children render function instead. */\n      components: MessageComponents;\n      children?: never;\n    }\n  | {\n      children: (value: { message: MessageState }) => ReactNode;\n      components?: never;\n    };\n\nexport type ThreadMessagesProps = Omit<\n  FlatListProps<ThreadMessage>,\n  \"data\" | \"renderItem\" | \"children\"\n> &\n  MessagesContent;\n\nconst DEFAULT_SYSTEM_MESSAGE = () => null;\n\nconst getComponent = (\n  components: MessageComponents,\n  role: ThreadMessage[\"role\"],\n  isEditing: boolean,\n) => {\n  switch (role) {\n    case \"user\":\n      if (isEditing) {\n        return (\n          components.UserEditComposer ??\n          components.EditComposer ??\n          components.UserMessage ??\n          (components.Message as ComponentType)\n        );\n      } else {\n        return components.UserMessage ?? (components.Message as ComponentType);\n      }\n    case \"assistant\":\n      if (isEditing) {\n        return (\n          components.AssistantEditComposer ??\n          components.EditComposer ??\n          components.AssistantMessage ??\n          (components.Message as ComponentType)\n        );\n      } else {\n        return (\n          components.AssistantMessage ?? (components.Message as ComponentType)\n        );\n      }\n    case \"system\":\n      if (isEditing) {\n        return (\n          components.SystemEditComposer ??\n          components.EditComposer ??\n          components.SystemMessage ??\n          (components.Message as ComponentType)\n        );\n      } else {\n        return (\n          components.SystemMessage ??\n          (components.Message as ComponentType) ??\n          DEFAULT_SYSTEM_MESSAGE\n        );\n      }\n    default: {\n      const _exhaustiveCheck: never = role;\n      throw new Error(`Unknown message role: ${_exhaustiveCheck}`);\n    }\n  }\n};\n\nconst ThreadMessageComponent: FC<{ components: MessageComponents }> = ({\n  components,\n}) => {\n  const role = useAuiState((s) => s.message.role);\n  const isEditing = useAuiState((s) => s.message.composer.isEditing);\n  const Component = getComponent(components, role, isEditing);\n\n  return <Component />;\n};\n\nconst ThreadMessageByIndex = memo(\n  ({ index, components }: { index: number; components: MessageComponents }) => {\n    return (\n      <MessageByIndexProvider index={index}>\n        <ThreadMessageComponent components={components} />\n      </MessageByIndexProvider>\n    );\n  },\n  (prev, next) =>\n    prev.index === next.index && prev.components === next.components,\n);\nThreadMessageByIndex.displayName = \"ThreadPrimitive.MessageByIndex\";\n\nconst ThreadMessageByChildren = memo(\n  ({\n    index,\n    children,\n  }: {\n    index: number;\n    children: (value: { message: MessageState }) => ReactNode;\n  }) => {\n    return (\n      <MessageByIndexProvider index={index}>\n        <RenderChildrenWithAccessor\n          getItemState={(aui) => aui.thread().message({ index }).getState()}\n        >\n          {(getItem) =>\n            children({\n              get message() {\n                return getItem();\n              },\n            })\n          }\n        </RenderChildrenWithAccessor>\n      </MessageByIndexProvider>\n    );\n  },\n  (prev, next) => prev.index === next.index && prev.children === next.children,\n);\nThreadMessageByChildren.displayName = \"ThreadPrimitive.MessageByChildren\";\n\nexport const ThreadMessages = forwardRef<\n  FlatList<ThreadMessage>,\n  ThreadMessagesProps\n>(({ components, children, ...flatListProps }, ref) => {\n  const messages = useAuiState((s) => s.thread.messages);\n\n  const renderItem = useCallback(\n    ({ index }: { item: ThreadMessage; index: number }) => {\n      if (children) {\n        return (\n          <ThreadMessageByChildren index={index}>\n            {children}\n          </ThreadMessageByChildren>\n        );\n      }\n      return <ThreadMessageByIndex index={index} components={components!} />;\n    },\n    [components, children],\n  );\n\n  const keyExtractor = useCallback((item: ThreadMessage) => item.id, []);\n\n  return (\n    <FlatList\n      ref={ref}\n      data={messages as unknown as ThreadMessage[]}\n      renderItem={renderItem}\n      keyExtractor={keyExtractor}\n      {...flatListProps}\n    />\n  );\n});\nThreadMessages.displayName = \"ThreadPrimitive.Messages\";\n"],"mappings":"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"}
+{"version":3,"file":"ThreadMessages.js","names":["ComponentType","FC","ForwardedRef","ReactNode","RefObject","forwardRef","memo","useCallback","useEffect","useRef","FlatList","FlatListProps","LayoutChangeEvent","NativeScrollEvent","NativeSyntheticEvent","MessageState","ThreadMessage","RenderChildrenWithAccessor","useAuiEvent","useAuiState","MessageByIndexProvider","MessageComponents","Message","EditComposer","UserEditComposer","AssistantEditComposer","SystemEditComposer","UserMessage","AssistantMessage","SystemMessage","MessagesContent","components","children","value","message","ThreadMessagesFlatListProps","Omit","autoScroll","scrollToBottomOnRunStart","scrollToBottomOnInitialize","scrollToBottomOnThreadSwitch","ThreadMessagesProps","DEFAULT_SYSTEM_MESSAGE","AT_BOTTOM_THRESHOLD","getComponent","role","isEditing","_exhaustiveCheck","Error","ThreadMessageComponent","t0","$","_c","_temp","_temp2","t1","Component","t2","ThreadMessageByIndex","index","prev","next","displayName","ThreadMessageByChildren","aui","thread","getState","getItem","setForwardedRef","ref","T","current","useComposedFlatListRef","forwardedRef","flatListRef","node","setFlatListRef","const","useThreadMessagesFlatListAutoScroll","hasMessages","t3","t4","undefined","t5","Symbol","for","contentHeight","viewportHeight","scrollY","metricsRef","isAtBottomRef","lastScrollEventYRef","initializeScrollRequestedRef","pendingScrollToBottomRef","t6","updateIsAtBottom","t7","animated","contentHeight_0","viewportHeight_0","Math","max","scrollToEnd","scrollToBottom","t8","event","nativeEvent","layout","height","handleLayout","t9","event_0","contentOffset","contentSize","layoutMeasurement","previousEventY","wasPinnedToBottom","y","upwardMove","handleScroll","t10","_width","metrics","previousContentHeight","wasAtBottom","pendingScroll","handleContentSizeChange","t11","t12","t13","t14","t15","ThreadMessagesFlatList","flatListProps","onContentSizeChange","onLayout","onScroll","scrollEventThrottle","messages","_temp3","length","handleAutoScrollContentSizeChange","handleAutoScrollLayout","handleAutoScrollScroll","renderItem","keyExtractor","_temp4","scrollTracking","width","ThreadMessages","props","s","s_0","composer","item","id"],"sources":["../../../src/primitives/thread/ThreadMessages.tsx"],"sourcesContent":["import {\n  type ComponentType,\n  type FC,\n  type ForwardedRef,\n  type ReactNode,\n  type RefObject,\n  forwardRef,\n  memo,\n  useCallback,\n  useEffect,\n  useRef,\n} from \"react\";\nimport {\n  FlatList,\n  type FlatListProps,\n  type LayoutChangeEvent,\n  type NativeScrollEvent,\n  type NativeSyntheticEvent,\n} from \"react-native\";\nimport type { MessageState, ThreadMessage } from \"@assistant-ui/core\";\nimport {\n  RenderChildrenWithAccessor,\n  useAuiEvent,\n  useAuiState,\n} from \"@assistant-ui/store\";\nimport { MessageByIndexProvider } from \"@assistant-ui/core/react\";\n\ntype MessageComponents =\n  | {\n      Message: ComponentType;\n      EditComposer?: ComponentType | undefined;\n      UserEditComposer?: ComponentType | undefined;\n      AssistantEditComposer?: ComponentType | undefined;\n      SystemEditComposer?: ComponentType | undefined;\n      UserMessage?: ComponentType | undefined;\n      AssistantMessage?: ComponentType | undefined;\n      SystemMessage?: ComponentType | undefined;\n    }\n  | {\n      Message?: ComponentType | undefined;\n      EditComposer?: ComponentType | undefined;\n      UserEditComposer?: ComponentType | undefined;\n      AssistantEditComposer?: ComponentType | undefined;\n      SystemEditComposer?: ComponentType | undefined;\n      UserMessage: ComponentType;\n      AssistantMessage: ComponentType;\n      SystemMessage?: ComponentType | undefined;\n    };\n\ntype MessagesContent =\n  | {\n      /** @deprecated Use the children render function instead. */\n      components: MessageComponents;\n      children?: never;\n    }\n  | {\n      children: (value: { message: MessageState }) => ReactNode;\n      components?: never;\n    };\n\nexport type ThreadMessagesFlatListProps = Omit<\n  FlatListProps<ThreadMessage>,\n  \"data\" | \"renderItem\" | \"children\"\n> &\n  MessagesContent & {\n    autoScroll?: boolean | undefined;\n    scrollToBottomOnRunStart?: boolean | undefined;\n    scrollToBottomOnInitialize?: boolean | undefined;\n    scrollToBottomOnThreadSwitch?: boolean | undefined;\n  };\n\n/** @deprecated Use ThreadMessagesFlatListProps instead. */\nexport type ThreadMessagesProps = ThreadMessagesFlatListProps;\n\nconst DEFAULT_SYSTEM_MESSAGE = () => null;\nconst AT_BOTTOM_THRESHOLD = 4;\n\nconst getComponent = (\n  components: MessageComponents,\n  role: ThreadMessage[\"role\"],\n  isEditing: boolean,\n) => {\n  switch (role) {\n    case \"user\":\n      if (isEditing) {\n        return (\n          components.UserEditComposer ??\n          components.EditComposer ??\n          components.UserMessage ??\n          (components.Message as ComponentType)\n        );\n      } else {\n        return components.UserMessage ?? (components.Message as ComponentType);\n      }\n    case \"assistant\":\n      if (isEditing) {\n        return (\n          components.AssistantEditComposer ??\n          components.EditComposer ??\n          components.AssistantMessage ??\n          (components.Message as ComponentType)\n        );\n      } else {\n        return (\n          components.AssistantMessage ?? (components.Message as ComponentType)\n        );\n      }\n    case \"system\":\n      if (isEditing) {\n        return (\n          components.SystemEditComposer ??\n          components.EditComposer ??\n          components.SystemMessage ??\n          (components.Message as ComponentType)\n        );\n      } else {\n        return (\n          components.SystemMessage ??\n          (components.Message as ComponentType) ??\n          DEFAULT_SYSTEM_MESSAGE\n        );\n      }\n    default: {\n      const _exhaustiveCheck: never = role;\n      throw new Error(`Unknown message role: ${_exhaustiveCheck}`);\n    }\n  }\n};\n\nconst ThreadMessageComponent: FC<{ components: MessageComponents }> = ({\n  components,\n}) => {\n  const role = useAuiState((s) => s.message.role);\n  const isEditing = useAuiState((s) => s.message.composer.isEditing);\n  const Component = getComponent(components, role, isEditing);\n\n  return <Component />;\n};\n\nconst ThreadMessageByIndex = memo(\n  ({ index, components }: { index: number; components: MessageComponents }) => {\n    return (\n      <MessageByIndexProvider index={index}>\n        <ThreadMessageComponent components={components} />\n      </MessageByIndexProvider>\n    );\n  },\n  (prev, next) =>\n    prev.index === next.index && prev.components === next.components,\n);\nThreadMessageByIndex.displayName = \"ThreadPrimitive.MessageByIndex\";\n\nconst ThreadMessageByChildren = memo(\n  ({\n    index,\n    children,\n  }: {\n    index: number;\n    children: (value: { message: MessageState }) => ReactNode;\n  }) => {\n    return (\n      <MessageByIndexProvider index={index}>\n        <RenderChildrenWithAccessor\n          getItemState={(aui) => aui.thread().message({ index }).getState()}\n        >\n          {(getItem) =>\n            children({\n              get message() {\n                return getItem();\n              },\n            })\n          }\n        </RenderChildrenWithAccessor>\n      </MessageByIndexProvider>\n    );\n  },\n  (prev, next) => prev.index === next.index && prev.children === next.children,\n);\nThreadMessageByChildren.displayName = \"ThreadPrimitive.MessageByChildren\";\n\nconst setForwardedRef = <T,>(ref: ForwardedRef<T>, value: T | null) => {\n  if (typeof ref === \"function\") {\n    ref(value);\n  } else if (ref) {\n    ref.current = value;\n  }\n};\n\nconst useComposedFlatListRef = (\n  forwardedRef: ForwardedRef<FlatList<ThreadMessage>>,\n) => {\n  const flatListRef = useRef<FlatList<ThreadMessage> | null>(null);\n\n  const setFlatListRef = useCallback(\n    (node: FlatList<ThreadMessage> | null) => {\n      flatListRef.current = node;\n      setForwardedRef(forwardedRef, node);\n    },\n    [forwardedRef],\n  );\n\n  return [flatListRef, setFlatListRef] as const;\n};\n\nconst useThreadMessagesFlatListAutoScroll = ({\n  flatListRef,\n  hasMessages,\n  autoScroll = true,\n  scrollToBottomOnRunStart = true,\n  scrollToBottomOnInitialize = true,\n  scrollToBottomOnThreadSwitch = true,\n}: {\n  flatListRef: RefObject<FlatList<ThreadMessage> | null>;\n  hasMessages: boolean;\n  autoScroll?: boolean | undefined;\n  scrollToBottomOnRunStart?: boolean | undefined;\n  scrollToBottomOnInitialize?: boolean | undefined;\n  scrollToBottomOnThreadSwitch?: boolean | undefined;\n}) => {\n  const metricsRef = useRef({\n    contentHeight: 0,\n    viewportHeight: 0,\n    scrollY: 0,\n  });\n  const isAtBottomRef = useRef(true);\n  const lastScrollEventYRef = useRef(0);\n  const initializeScrollRequestedRef = useRef(false);\n  const pendingScrollToBottomRef = useRef<false | { animated: boolean }>(false);\n\n  const updateIsAtBottom = useCallback(() => {\n    const { contentHeight, scrollY, viewportHeight } = metricsRef.current;\n    isAtBottomRef.current =\n      contentHeight <= viewportHeight ||\n      contentHeight - scrollY - viewportHeight <= AT_BOTTOM_THRESHOLD;\n  }, []);\n\n  // Commanding a scroll records the intended position immediately; the\n  // native scroll echo is bridged and throttled, so waiting for it lets a\n  // fast stream observe stale metrics and drop out of following.\n  const scrollToBottom = useCallback(\n    (animated: boolean) => {\n      const { contentHeight, viewportHeight } = metricsRef.current;\n      metricsRef.current.scrollY = Math.max(0, contentHeight - viewportHeight);\n      isAtBottomRef.current = true;\n      flatListRef.current?.scrollToEnd({ animated });\n    },\n    [flatListRef],\n  );\n\n  const handleLayout = useCallback(\n    (event: LayoutChangeEvent) => {\n      metricsRef.current.viewportHeight = event.nativeEvent.layout.height;\n      updateIsAtBottom();\n    },\n    [updateIsAtBottom],\n  );\n\n  const handleScroll = useCallback(\n    (event: NativeSyntheticEvent<NativeScrollEvent>) => {\n      const { contentOffset, contentSize, layoutMeasurement } =\n        event.nativeEvent;\n      const previousEventY = lastScrollEventYRef.current;\n      const wasPinnedToBottom = isAtBottomRef.current;\n      lastScrollEventYRef.current = contentOffset.y;\n      metricsRef.current = {\n        contentHeight: contentSize.height,\n        viewportHeight: layoutMeasurement.height,\n        scrollY: contentOffset.y,\n      };\n      updateIsAtBottom();\n      const upwardMove = contentOffset.y < previousEventY;\n      // Only a deliberate upward move unpins or cancels a pending scroll.\n      // Gestures are detected echo-to-echo because a commanded scroll\n      // optimistically moves the tracked position ahead of its ascending\n      // animation echoes, and those echoes must not unpin mid-flight.\n      if (wasPinnedToBottom && !upwardMove) {\n        isAtBottomRef.current = true;\n      }\n      if (!isAtBottomRef.current && upwardMove) {\n        pendingScrollToBottomRef.current = false;\n      }\n    },\n    [updateIsAtBottom],\n  );\n\n  const handleContentSizeChange = useCallback(\n    (_width: number, height: number) => {\n      const metrics = metricsRef.current;\n      const previousContentHeight = metrics.contentHeight;\n      const wasAtBottom = isAtBottomRef.current;\n      metrics.contentHeight = height;\n      updateIsAtBottom();\n\n      // FlatList.scrollToEnd is a no-op before the list has measured, so the\n      // initialize and thread-switch scrolls land on the next content-size\n      // event, once real metrics exist.\n      const pendingScroll = pendingScrollToBottomRef.current;\n      if (pendingScroll) {\n        pendingScrollToBottomRef.current = false;\n        scrollToBottom(pendingScroll.animated);\n        return;\n      }\n\n      if (!autoScroll) return;\n      if (!wasAtBottom) return;\n      if (previousContentHeight === 0) return;\n      if (height <= previousContentHeight) return;\n\n      scrollToBottom(false);\n    },\n    [autoScroll, scrollToBottom, updateIsAtBottom],\n  );\n\n  useEffect(() => {\n    if (!scrollToBottomOnInitialize) return;\n    if (!hasMessages) {\n      initializeScrollRequestedRef.current = false;\n      return;\n    }\n    if (initializeScrollRequestedRef.current) return;\n\n    initializeScrollRequestedRef.current = true;\n    pendingScrollToBottomRef.current = { animated: false };\n    scrollToBottom(false);\n  }, [hasMessages, scrollToBottom, scrollToBottomOnInitialize]);\n\n  useAuiEvent(\"thread.runStart\", () => {\n    if (!scrollToBottomOnRunStart) return;\n    pendingScrollToBottomRef.current = { animated: true };\n    scrollToBottom(true);\n  });\n\n  useAuiEvent(\"threadListItem.switchedTo\", () => {\n    if (!scrollToBottomOnThreadSwitch) return;\n    initializeScrollRequestedRef.current = false;\n    lastScrollEventYRef.current = 0;\n    pendingScrollToBottomRef.current = { animated: false };\n    scrollToBottom(false);\n  });\n\n  return {\n    handleLayout,\n    handleScroll,\n    handleContentSizeChange,\n  };\n};\n\nexport const ThreadMessagesFlatList = forwardRef<\n  FlatList<ThreadMessage>,\n  ThreadMessagesFlatListProps\n>(\n  (\n    {\n      autoScroll,\n      components,\n      children,\n      onContentSizeChange,\n      onLayout,\n      onScroll,\n      scrollEventThrottle,\n      scrollToBottomOnInitialize,\n      scrollToBottomOnRunStart,\n      scrollToBottomOnThreadSwitch,\n      ...flatListProps\n    },\n    forwardedRef,\n  ) => {\n    const messages = useAuiState((s) => s.thread.messages);\n    const [flatListRef, setFlatListRef] = useComposedFlatListRef(forwardedRef);\n    const {\n      handleContentSizeChange: handleAutoScrollContentSizeChange,\n      handleLayout: handleAutoScrollLayout,\n      handleScroll: handleAutoScrollScroll,\n    } = useThreadMessagesFlatListAutoScroll({\n      flatListRef,\n      hasMessages: messages.length > 0,\n      autoScroll,\n      scrollToBottomOnInitialize,\n      scrollToBottomOnRunStart,\n      scrollToBottomOnThreadSwitch,\n    });\n\n    const renderItem = useCallback(\n      ({ index }: { item: ThreadMessage; index: number }) => {\n        if (children) {\n          return (\n            <ThreadMessageByChildren index={index}>\n              {children}\n            </ThreadMessageByChildren>\n          );\n        }\n        return <ThreadMessageByIndex index={index} components={components!} />;\n      },\n      [components, children],\n    );\n\n    const keyExtractor = useCallback((item: ThreadMessage) => item.id, []);\n\n    const scrollTracking =\n      (autoScroll ?? true) ||\n      (scrollToBottomOnInitialize ?? true) ||\n      (scrollToBottomOnRunStart ?? true) ||\n      (scrollToBottomOnThreadSwitch ?? true);\n\n    const handleLayout = useCallback(\n      (event: LayoutChangeEvent) => {\n        handleAutoScrollLayout(event);\n        onLayout?.(event);\n      },\n      [handleAutoScrollLayout, onLayout],\n    );\n\n    const handleScroll = useCallback(\n      (event: NativeSyntheticEvent<NativeScrollEvent>) => {\n        handleAutoScrollScroll(event);\n        onScroll?.(event);\n      },\n      [handleAutoScrollScroll, onScroll],\n    );\n\n    const handleContentSizeChange = useCallback(\n      (width: number, height: number) => {\n        handleAutoScrollContentSizeChange(width, height);\n        onContentSizeChange?.(width, height);\n      },\n      [handleAutoScrollContentSizeChange, onContentSizeChange],\n    );\n\n    return (\n      <FlatList\n        ref={setFlatListRef}\n        data={messages as unknown as ThreadMessage[]}\n        renderItem={renderItem}\n        keyExtractor={keyExtractor}\n        {...(scrollTracking\n          ? {\n              onContentSizeChange: handleContentSizeChange,\n              onLayout: handleLayout,\n              onScroll: handleScroll,\n              scrollEventThrottle: scrollEventThrottle ?? 16,\n            }\n          : {\n              ...(onContentSizeChange && { onContentSizeChange }),\n              ...(onLayout && { onLayout }),\n              ...(onScroll && { onScroll }),\n              ...(scrollEventThrottle !== undefined && { scrollEventThrottle }),\n            })}\n        {...flatListProps}\n      />\n    );\n  },\n);\nThreadMessagesFlatList.displayName = \"ThreadPrimitive.MessagesFlatList\";\n\n/** @deprecated Use ThreadPrimitive.MessagesFlatList instead. */\nexport const ThreadMessages = forwardRef<\n  FlatList<ThreadMessage>,\n  ThreadMessagesProps\n>(\n  (\n    {\n      autoScroll = false,\n      scrollToBottomOnInitialize = false,\n      scrollToBottomOnRunStart = false,\n      scrollToBottomOnThreadSwitch = false,\n      ...props\n    },\n    ref,\n  ) => (\n    <ThreadMessagesFlatList\n      ref={ref}\n      autoScroll={autoScroll}\n      scrollToBottomOnInitialize={scrollToBottomOnInitialize}\n      scrollToBottomOnRunStart={scrollToBottomOnRunStart}\n      scrollToBottomOnThreadSwitch={scrollToBottomOnThreadSwitch}\n      {...props}\n    />\n  ),\n);\nThreadMessages.displayName = \"ThreadPrimitive.Messages\";\n"],"mappings":"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"}

package/dist/primitives/thread.d.ts

@@ -1,12 +1,12 @@
 import { ThreadRoot, ThreadRootProps } from "./thread/ThreadRoot.js";
-import { ThreadMessages, ThreadMessagesProps } from "./thread/ThreadMessages.js";
+import { ThreadMessages, ThreadMessagesFlatList, ThreadMessagesFlatListProps, ThreadMessagesProps } from "./thread/ThreadMessages.js";
 import { ThreadEmpty, ThreadEmptyProps } from "./thread/ThreadEmpty.js";
 import { ThreadIf, ThreadIfProps } from "./thread/ThreadIf.js";
 import { ThreadSuggestion, ThreadSuggestionProps } from "./thread/ThreadSuggestion.js";
 import { ThreadPrimitiveMessageByIndex as MessageByIndex, ThreadPrimitiveSuggestionByIndex as SuggestionByIndex, ThreadPrimitiveSuggestions as Suggestions, ThreadPrimitiveUnstable_MessageById as Unstable_MessageById } from "@assistant-ui/core/react";
 declare namespace thread_d_exports {
-  export { ThreadEmpty as Empty, ThreadEmptyProps as EmptyProps, ThreadIf as If, ThreadIfProps as IfProps, MessageByIndex, ThreadMessages as Messages, ThreadMessagesProps as MessagesProps, ThreadRoot as Root, ThreadRootProps as RootProps, ThreadSuggestion as Suggestion, SuggestionByIndex, ThreadSuggestionProps as SuggestionProps, Suggestions, Unstable_MessageById };
+  export { ThreadEmpty as Empty, ThreadEmptyProps as EmptyProps, ThreadIf as If, ThreadIfProps as IfProps, MessageByIndex, ThreadMessages as Messages, ThreadMessagesFlatList as MessagesFlatList, ThreadMessagesFlatListProps as MessagesFlatListProps, ThreadMessagesProps as MessagesProps, ThreadRoot as Root, ThreadRootProps as RootProps, ThreadSuggestion as Suggestion, SuggestionByIndex, ThreadSuggestionProps as SuggestionProps, Suggestions, Unstable_MessageById };
 }
 //#endregion
-export { ThreadEmpty as Empty, type ThreadEmptyProps as EmptyProps, ThreadIf as If, type ThreadIfProps as IfProps, MessageByIndex, ThreadMessages as Messages, type ThreadMessagesProps as MessagesProps, ThreadRoot as Root, type ThreadRootProps as RootProps, ThreadSuggestion as Suggestion, SuggestionByIndex, type ThreadSuggestionProps as SuggestionProps, Suggestions, Unstable_MessageById, thread_d_exports };
+export { ThreadEmpty as Empty, type ThreadEmptyProps as EmptyProps, ThreadIf as If, type ThreadIfProps as IfProps, MessageByIndex, ThreadMessages as Messages, ThreadMessagesFlatList as MessagesFlatList, type ThreadMessagesFlatListProps as MessagesFlatListProps, type ThreadMessagesProps as MessagesProps, ThreadRoot as Root, type ThreadRootProps as RootProps, ThreadSuggestion as Suggestion, SuggestionByIndex, type ThreadSuggestionProps as SuggestionProps, Suggestions, Unstable_MessageById, thread_d_exports };
 //# sourceMappingURL=thread.d.ts.map

package/dist/primitives/thread.js

@@ -1,6 +1,6 @@
 import { __exportAll } from "../_virtual/_rolldown/runtime.js";
 import { ThreadRoot } from "./thread/ThreadRoot.js";
-import { ThreadMessages } from "./thread/ThreadMessages.js";
+import { ThreadMessages, ThreadMessagesFlatList } from "./thread/ThreadMessages.js";
 import { ThreadEmpty } from "./thread/ThreadEmpty.js";
 import { ThreadIf } from "./thread/ThreadIf.js";
 import { ThreadSuggestion } from "./thread/ThreadSuggestion.js";
@@ -11,6 +11,7 @@ var thread_exports = /* @__PURE__ */ __exportAll({
 	If: () => ThreadIf,
 	MessageByIndex: () => MessageByIndex,
 	Messages: () => ThreadMessages,
+	MessagesFlatList: () => ThreadMessagesFlatList,
 	Root: () => ThreadRoot,
 	Suggestion: () => ThreadSuggestion,
 	SuggestionByIndex: () => SuggestionByIndex,
@@ -18,6 +19,6 @@ var thread_exports = /* @__PURE__ */ __exportAll({
 	Unstable_MessageById: () => Unstable_MessageById
 });
 //#endregion
-export { ThreadEmpty as Empty, ThreadIf as If, MessageByIndex, ThreadMessages as Messages, ThreadRoot as Root, ThreadSuggestion as Suggestion, SuggestionByIndex, Suggestions, Unstable_MessageById, thread_exports };
+export { ThreadEmpty as Empty, ThreadIf as If, MessageByIndex, ThreadMessages as Messages, ThreadMessagesFlatList as MessagesFlatList, ThreadRoot as Root, ThreadSuggestion as Suggestion, SuggestionByIndex, Suggestions, Unstable_MessageById, thread_exports };
 
 //# sourceMappingURL=thread.js.map

package/dist/primitives/thread.js.map

@@ -1 +1 @@
-{"version":3,"file":"thread.js","names":["ThreadRoot","Root","ThreadRootProps","RootProps","ThreadMessages","Messages","ThreadMessagesProps","MessagesProps","ThreadPrimitiveMessageByIndex","MessageByIndex","ThreadPrimitiveUnstable_MessageById","Unstable_MessageById","ThreadEmpty","Empty","ThreadEmptyProps","EmptyProps","ThreadIf","If","ThreadIfProps","IfProps","ThreadSuggestion","Suggestion","ThreadSuggestionProps","SuggestionProps","ThreadPrimitiveSuggestions","Suggestions","ThreadPrimitiveSuggestionByIndex","SuggestionByIndex"],"sources":["../../src/primitives/thread.ts"],"sourcesContent":["export {\n  ThreadRoot as Root,\n  type ThreadRootProps as RootProps,\n} from \"./thread/ThreadRoot\";\nexport {\n  ThreadMessages as Messages,\n  type ThreadMessagesProps as MessagesProps,\n} from \"./thread/ThreadMessages\";\nexport { ThreadPrimitiveMessageByIndex as MessageByIndex } from \"@assistant-ui/core/react\";\nexport { ThreadPrimitiveUnstable_MessageById as Unstable_MessageById } from \"@assistant-ui/core/react\";\nexport {\n  ThreadEmpty as Empty,\n  type ThreadEmptyProps as EmptyProps,\n} from \"./thread/ThreadEmpty\";\nexport {\n  ThreadIf as If,\n  type ThreadIfProps as IfProps,\n} from \"./thread/ThreadIf\";\nexport {\n  ThreadSuggestion as Suggestion,\n  type ThreadSuggestionProps as SuggestionProps,\n} from \"./thread/ThreadSuggestion\";\nexport {\n  ThreadPrimitiveSuggestions as Suggestions,\n  ThreadPrimitiveSuggestionByIndex as SuggestionByIndex,\n} from \"@assistant-ui/core/react\";\n"],"mappings":""}
+{"version":3,"file":"thread.js","names":["ThreadRoot","Root","ThreadRootProps","RootProps","ThreadMessagesFlatList","MessagesFlatList","ThreadMessagesFlatListProps","MessagesFlatListProps","ThreadMessages","Messages","ThreadMessagesProps","MessagesProps","ThreadPrimitiveMessageByIndex","MessageByIndex","ThreadPrimitiveUnstable_MessageById","Unstable_MessageById","ThreadEmpty","Empty","ThreadEmptyProps","EmptyProps","ThreadIf","If","ThreadIfProps","IfProps","ThreadSuggestion","Suggestion","ThreadSuggestionProps","SuggestionProps","ThreadPrimitiveSuggestions","Suggestions","ThreadPrimitiveSuggestionByIndex","SuggestionByIndex"],"sources":["../../src/primitives/thread.ts"],"sourcesContent":["export {\n  ThreadRoot as Root,\n  type ThreadRootProps as RootProps,\n} from \"./thread/ThreadRoot\";\nexport {\n  ThreadMessagesFlatList as MessagesFlatList,\n  type ThreadMessagesFlatListProps as MessagesFlatListProps,\n  ThreadMessages as Messages,\n  type ThreadMessagesProps as MessagesProps,\n} from \"./thread/ThreadMessages\";\nexport { ThreadPrimitiveMessageByIndex as MessageByIndex } from \"@assistant-ui/core/react\";\nexport { ThreadPrimitiveUnstable_MessageById as Unstable_MessageById } from \"@assistant-ui/core/react\";\nexport {\n  ThreadEmpty as Empty,\n  type ThreadEmptyProps as EmptyProps,\n} from \"./thread/ThreadEmpty\";\nexport {\n  ThreadIf as If,\n  type ThreadIfProps as IfProps,\n} from \"./thread/ThreadIf\";\nexport {\n  ThreadSuggestion as Suggestion,\n  type ThreadSuggestionProps as SuggestionProps,\n} from \"./thread/ThreadSuggestion\";\nexport {\n  ThreadPrimitiveSuggestions as Suggestions,\n  ThreadPrimitiveSuggestionByIndex as SuggestionByIndex,\n} from \"@assistant-ui/core/react\";\n"],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@assistant-ui/react-native",
-  "version": "0.1.30",
+  "version": "0.1.31",
   "description": "React Native bindings for assistant-ui",
   "keywords": [
     "assistant",
@@ -31,10 +31,10 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@assistant-ui/core": "^0.2.21",
-    "@assistant-ui/store": "^0.2.20",
-    "@assistant-ui/tap": "^0.9.4",
-    "assistant-stream": "^0.3.26",
+    "@assistant-ui/core": "^0.2.22",
+    "@assistant-ui/store": "^0.2.21",
+    "@assistant-ui/tap": "^0.9.5",
+    "assistant-stream": "^0.3.27",
     "zustand": "^5.0.14"
   },
   "peerDependencies": {
@@ -51,12 +51,12 @@
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
     "jsdom": "^29.1.1",
-    "react": "^19.2.7",
-    "react-dom": "^19.2.7",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
     "react-native": "^0.86.0",
     "react-native-web": "^0.21.2",
     "vitest": "^4.1.10",
-    "@assistant-ui/x-buildutils": "0.0.18"
+    "@assistant-ui/x-buildutils": "0.0.19"
   },
   "publishConfig": {
     "access": "public",

package/src/primitives/thread/ThreadMessages.test.tsx

@@ -3,7 +3,7 @@ import { createRoot, type Root } from "react-dom/client";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import type { FlatList } from "react-native";
 import type { ThreadMessage } from "@assistant-ui/core";
-import { ThreadMessages } from "./ThreadMessages";
+import { ThreadMessages, ThreadMessagesFlatList } from "./ThreadMessages";
 
 type Msg = { id: string; role: string };
 
@@ -13,16 +13,96 @@ const h = vi.hoisted(() => ({
     message: { role: "user" as string, composer: { isEditing: false } },
   },
   itemState: { role: "user" } as { role: string },
+  events: {} as Record<string, Set<() => void>>,
+  flatListProps: null as Record<string, unknown> | null,
+  scrollToEnd: vi.fn(),
 }));
 
-vi.mock("@assistant-ui/store", () => ({
-  useAuiState: <T,>(selector: (s: typeof h.state) => T) => selector(h.state),
-  RenderChildrenWithAccessor: ({
-    children,
-  }: {
-    children: (getItem: () => unknown) => unknown;
-  }) => children(() => h.itemState),
-}));
+vi.mock("react-native", async (importOriginal) => {
+  const actual = await importOriginal<typeof import("react-native")>();
+  const React = await import("react");
+
+  const FlatListMock = React.forwardRef(function FlatListMock(
+    props: Record<string, unknown>,
+    ref,
+  ) {
+    h.flatListProps = props;
+
+    React.useImperativeHandle(ref, () => ({
+      scrollToEnd: h.scrollToEnd,
+    }));
+
+    const data = (props.data as unknown[]) ?? [];
+    const renderItem = props.renderItem as
+      | ((value: {
+          item: unknown;
+          index: number;
+          separators: {
+            highlight: () => void;
+            unhighlight: () => void;
+            updateProps: () => void;
+          };
+        }) => React.ReactNode)
+      | undefined;
+    const keyExtractor = props.keyExtractor as
+      | ((item: unknown, index: number) => string)
+      | undefined;
+
+    return React.createElement(
+      "div",
+      { "data-testid": "flatlist" },
+      data.map((item, index) =>
+        React.createElement(
+          "div",
+          { key: keyExtractor?.(item, index) ?? index },
+          renderItem?.({
+            item,
+            index,
+            separators: {
+              highlight: vi.fn(),
+              unhighlight: vi.fn(),
+              updateProps: vi.fn(),
+            },
+          }),
+        ),
+      ),
+    );
+  });
+
+  return {
+    ...actual,
+    FlatList: FlatListMock,
+  };
+});
+
+vi.mock("@assistant-ui/store", async () => {
+  const React = await import("react");
+
+  return {
+    useAuiState: <T,>(selector: (s: typeof h.state) => T) => selector(h.state),
+    useAuiEvent: (
+      selector: string | { scope: string; event: string },
+      callback: () => void,
+    ) => {
+      React.useEffect(() => {
+        const event =
+          typeof selector === "string"
+            ? selector
+            : `${selector.scope}.${selector.event}`;
+        const callbacks = (h.events[event] ??= new Set());
+        callbacks.add(callback);
+        return () => {
+          callbacks.delete(callback);
+        };
+      }, [selector, callback]);
+    },
+    RenderChildrenWithAccessor: ({
+      children,
+    }: {
+      children: (getItem: () => unknown) => unknown;
+    }) => children(() => h.itemState),
+  };
+});
 
 vi.mock("@assistant-ui/core/react", () => ({
   MessageByIndexProvider: ({ children }: { children: unknown }) => children,
@@ -39,6 +119,9 @@ describe("ThreadMessages", () => {
     h.state.message.role = "user";
     h.state.message.composer.isEditing = false;
     h.itemState = { role: "user" };
+    h.events = {};
+    h.flatListProps = null;
+    h.scrollToEnd.mockReset();
 
     container = document.createElement("div");
     document.body.appendChild(container);
@@ -58,6 +141,37 @@ describe("ThreadMessages", () => {
     });
   };
 
+  const mountFlatList = async (
+    props: Parameters<typeof ThreadMessagesFlatList>[0],
+  ) => {
+    await act(async () => {
+      root.render(<ThreadMessagesFlatList {...props} />);
+    });
+  };
+
+  const getFlatListProps = () => {
+    const props = h.flatListProps as {
+      onContentSizeChange?: (width: number, height: number) => void;
+      onLayout?: (event: unknown) => void;
+      onScroll?: (event: unknown) => void;
+      scrollEventThrottle?: number;
+    } | null;
+    if (!props) throw new Error("FlatList was not rendered");
+    return props;
+  };
+
+  const emit = async (event: string) => {
+    await act(async () => {
+      h.events[event]?.forEach((callback) => {
+        callback();
+      });
+    });
+  };
+
+  const messageComponents = {
+    Message: () => <span data-testid="c-message">message</span>,
+  };
+
   describe("components mode dispatch", () => {
     const makeComponents = () => ({
       Message: vi.fn(() => <span data-testid="c-message">message</span>),
@@ -209,4 +323,304 @@ describe("ThreadMessages", () => {
 
     expect(ref.current).not.toBeNull();
   });
+
+  it("keeps deprecated Messages off the scroll-tracking path", async () => {
+    h.state.thread.messages = [{ id: "1", role: "user" }];
+    await mount({ components: messageComponents });
+    const props = getFlatListProps();
+
+    expect(props.onScroll).toBeUndefined();
+    expect(props.onLayout).toBeUndefined();
+    expect(props.onContentSizeChange).toBeUndefined();
+    expect(props.scrollEventThrottle).toBeUndefined();
+  });
+
+  it("keeps deprecated Messages from auto-scrolling by default", async () => {
+    h.state.thread.messages = [{ id: "1", role: "user" }];
+    await mount({ components: messageComponents });
+    const props = getFlatListProps();
+
+    await act(async () => {
+      props.onLayout?.({
+        nativeEvent: { layout: { height: 100 } },
+      });
+      props.onScroll?.({
+        nativeEvent: {
+          contentOffset: { y: 0 },
+          contentSize: { height: 100, width: 0 },
+          layoutMeasurement: { height: 100, width: 0 },
+        },
+      });
+      props.onContentSizeChange?.(0, 140);
+    });
+    await emit("thread.runStart");
+    await emit("threadListItem.switchedTo");
+
+    expect(h.scrollToEnd).not.toHaveBeenCalled();
+  });
+
+  describe("MessagesFlatList auto-scroll", () => {
+    it("scrolls to the bottom when messages first appear", async () => {
+      h.state.thread.messages = [{ id: "1", role: "user" }];
+
+      await mountFlatList({ components: messageComponents });
+
+      expect(h.scrollToEnd).toHaveBeenCalledWith({ animated: false });
+    });
+
+    it("scrolls to the bottom when a run starts", async () => {
+      h.state.thread.messages = [{ id: "1", role: "user" }];
+      await mountFlatList({ components: messageComponents });
+      h.scrollToEnd.mockClear();
+
+      await emit("thread.runStart");
+
+      expect(h.scrollToEnd).toHaveBeenCalledWith({ animated: true });
+    });
+
+    it("scrolls when content grows while already at the bottom", async () => {
+      h.state.thread.messages = [{ id: "1", role: "user" }];
+      await mountFlatList({ components: messageComponents });
+      const props = getFlatListProps();
+      h.scrollToEnd.mockClear();
+
+      await act(async () => {
+        props.onLayout?.({
+          nativeEvent: { layout: { height: 100 } },
+        });
+        props.onScroll?.({
+          nativeEvent: {
+            contentOffset: { y: 0 },
+            contentSize: { height: 100, width: 0 },
+            layoutMeasurement: { height: 100, width: 0 },
+          },
+        });
+        props.onContentSizeChange?.(0, 140);
+      });
+
+      expect(h.scrollToEnd).toHaveBeenCalledWith({ animated: false });
+    });
+
+    it("does not treat the first content-size event as automatic content growth", async () => {
+      h.state.thread.messages = [{ id: "1", role: "user" }];
+      await mountFlatList({
+        components: messageComponents,
+        scrollToBottomOnInitialize: false,
+      });
+      const props = getFlatListProps();
+
+      await act(async () => {
+        props.onContentSizeChange?.(0, 140);
+      });
+
+      expect(h.scrollToEnd).not.toHaveBeenCalled();
+    });
+
+    it("lands the initialize scroll on the first content-size event", async () => {
+      h.state.thread.messages = [{ id: "1", role: "user" }];
+      await mountFlatList({ components: messageComponents });
+      const props = getFlatListProps();
+
+      expect(h.scrollToEnd).toHaveBeenCalledTimes(1);
+
+      await act(async () => {
+        props.onContentSizeChange?.(0, 140);
+      });
+
+      expect(h.scrollToEnd).toHaveBeenCalledTimes(2);
+
+      await act(async () => {
+        props.onContentSizeChange?.(0, 140);
+      });
+
+      expect(h.scrollToEnd).toHaveBeenCalledTimes(2);
+    });
+
+    it("lands the thread-switch scroll on the next content-size event", async () => {
+      h.state.thread.messages = [{ id: "1", role: "user" }];
+      await mountFlatList({ components: messageComponents });
+      const props = getFlatListProps();
+      h.scrollToEnd.mockClear();
+
+      await emit("threadListItem.switchedTo");
+      expect(h.scrollToEnd).toHaveBeenCalledTimes(1);
+
+      await act(async () => {
+        props.onContentSizeChange?.(0, 80);
+      });
+
+      expect(h.scrollToEnd).toHaveBeenCalledTimes(2);
+    });
+
+    it("keeps following through consecutive growth events without scroll echoes", async () => {
+      h.state.thread.messages = [{ id: "1", role: "user" }];
+      await mountFlatList({ components: messageComponents });
+      const props = getFlatListProps();
+
+      await act(async () => {
+        props.onLayout?.({
+          nativeEvent: { layout: { height: 100 } },
+        });
+        props.onScroll?.({
+          nativeEvent: {
+            contentOffset: { y: 0 },
+            contentSize: { height: 100, width: 0 },
+            layoutMeasurement: { height: 100, width: 0 },
+          },
+        });
+      });
+      h.scrollToEnd.mockClear();
+
+      await act(async () => {
+        props.onContentSizeChange?.(0, 140);
+      });
+      await act(async () => {
+        props.onContentSizeChange?.(0, 180);
+      });
+
+      expect(h.scrollToEnd).toHaveBeenCalledTimes(2);
+    });
+
+    it("does not scroll when content grows after the user scrolled away", async () => {
+      h.state.thread.messages = [{ id: "1", role: "user" }];
+      await mountFlatList({ components: messageComponents });
+      const props = getFlatListProps();
+      h.scrollToEnd.mockClear();
+
+      await act(async () => {
+        props.onLayout?.({
+          nativeEvent: { layout: { height: 100 } },
+        });
+        props.onScroll?.({
+          nativeEvent: {
+            contentOffset: { y: 200 },
+            contentSize: { height: 300, width: 0 },
+            layoutMeasurement: { height: 100, width: 0 },
+          },
+        });
+        props.onScroll?.({
+          nativeEvent: {
+            contentOffset: { y: 50 },
+            contentSize: { height: 300, width: 0 },
+            layoutMeasurement: { height: 100, width: 0 },
+          },
+        });
+        props.onContentSizeChange?.(0, 340);
+      });
+
+      expect(h.scrollToEnd).not.toHaveBeenCalled();
+    });
+
+    it("lands the run-start scroll once the appended message resizes content", async () => {
+      h.state.thread.messages = [{ id: "1", role: "user" }];
+      await mountFlatList({ components: messageComponents });
+      const props = getFlatListProps();
+
+      await act(async () => {
+        props.onLayout?.({
+          nativeEvent: { layout: { height: 100 } },
+        });
+        props.onScroll?.({
+          nativeEvent: {
+            contentOffset: { y: 200 },
+            contentSize: { height: 300, width: 0 },
+            layoutMeasurement: { height: 100, width: 0 },
+          },
+        });
+        props.onScroll?.({
+          nativeEvent: {
+            contentOffset: { y: 50 },
+            contentSize: { height: 300, width: 0 },
+            layoutMeasurement: { height: 100, width: 0 },
+          },
+        });
+      });
+      h.scrollToEnd.mockClear();
+
+      await emit("thread.runStart");
+      expect(h.scrollToEnd).toHaveBeenCalledTimes(1);
+
+      await act(async () => {
+        props.onScroll?.({
+          nativeEvent: {
+            contentOffset: { y: 120 },
+            contentSize: { height: 300, width: 0 },
+            layoutMeasurement: { height: 100, width: 0 },
+          },
+        });
+        props.onContentSizeChange?.(0, 360);
+      });
+
+      expect(h.scrollToEnd).toHaveBeenCalledTimes(2);
+      expect(h.scrollToEnd).toHaveBeenLastCalledWith({ animated: true });
+    });
+
+    it("scrolls to the bottom when switching threads", async () => {
+      h.state.thread.messages = [{ id: "1", role: "user" }];
+      await mountFlatList({ components: messageComponents });
+      h.scrollToEnd.mockClear();
+
+      await emit("threadListItem.switchedTo");
+
+      expect(h.scrollToEnd).toHaveBeenCalledWith({ animated: false });
+    });
+
+    it("does not rearm initialize scroll when thread-switch scroll is disabled", async () => {
+      h.state.thread.messages = [{ id: "1", role: "user" }];
+      await mountFlatList({
+        components: messageComponents,
+        scrollToBottomOnThreadSwitch: false,
+      });
+      h.scrollToEnd.mockClear();
+
+      await emit("threadListItem.switchedTo");
+
+      h.state.thread.messages = [
+        { id: "2", role: "user" },
+        { id: "3", role: "assistant" },
+      ];
+      await mountFlatList({
+        components: messageComponents,
+        scrollToBottomOnThreadSwitch: false,
+      });
+
+      expect(h.scrollToEnd).not.toHaveBeenCalled();
+    });
+
+    it("honors opt-outs for automatic content growth and run-start scrolls", async () => {
+      h.state.thread.messages = [{ id: "1", role: "user" }];
+      await mountFlatList({
+        autoScroll: false,
+        components: messageComponents,
+        scrollToBottomOnInitialize: false,
+        scrollToBottomOnRunStart: false,
+      });
+      const props = getFlatListProps();
+      h.scrollToEnd.mockClear();
+
+      await act(async () => {
+        props.onLayout?.({
+          nativeEvent: { layout: { height: 100 } },
+        });
+        props.onScroll?.({
+          nativeEvent: {
+            contentOffset: { y: 0 },
+            contentSize: { height: 100, width: 0 },
+            layoutMeasurement: { height: 100, width: 0 },
+          },
+        });
+        props.onContentSizeChange?.(0, 140);
+      });
+      await emit("thread.runStart");
+
+      expect(h.scrollToEnd).not.toHaveBeenCalled();
+    });
+
+    it("sets a useful default scroll throttle", async () => {
+      h.state.thread.messages = [{ id: "1", role: "user" }];
+      await mountFlatList({ components: messageComponents });
+
+      expect(getFlatListProps().scrollEventThrottle).toBe(16);
+    });
+  });
 });