@aigentyc/chat-sdk 0.5.1 → 0.5.3

package/dist/{ChatInterface-DrzYAWnG.d.cts → ChatInterface-Bo0dU48x.d.cts}

@@ -1,6 +1,28 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Q as QuestionConfig } from './types-DRa1zFlN.cjs';
 
+/**
+ * How wide the desktop chat panel is, and where the panels beside it go.
+ *
+ * The panel used to be a fixed `max-w-[780px]`, and the preview and live-chat
+ * panels that open next to it hardcoded the same number as `790px` / `800px`.
+ * A host that needed a wider or narrower chat had no way to ask for one, and
+ * changing the first number alone would have left the other two overlapping it
+ * or floating off in space. Everything that depends on the width now reads it
+ * from here.
+ */
+/** Maximum width of the desktop chat panel when the host does not choose one. */
+declare const DEFAULT_PANEL_WIDTH = 780;
+/**
+ * Maximum width of the desktop chat panel.
+ *
+ * - a number is pixels (`960`)
+ * - a string is any CSS length (`"960px"`, `"60vw"`, `"min(960px, 60vw)"`)
+ *
+ * The panel is still never wider than the viewport.
+ */
+type PanelWidth = number | string;
+
 interface ChatInterfaceProps {
     /** Allow per-instance overrides of any context value */
     isOpen?: boolean;
@@ -36,6 +58,14 @@ interface ChatInterfaceProps {
      * - `"stream-order"` — parts render in the order received from the API
      */
     messagePartOrder?: "text-first" | "tools-first" | "stream-order";
+    /**
+     * Where the view settles while an answer streams in.
+     * - `"latest-turn"` (default) — follows the answer down only until the
+     *   visitor's question reaches the top, then holds there, so a long reply is
+     *   read from its first line
+     * - `"bottom"` — always follows the end of the content
+     */
+    scrollAnchor?: "latest-turn" | "bottom";
 }
 interface AssistantMessageSlotProps {
     message: {
@@ -61,4 +91,4 @@ interface UserMessageSlotProps {
 }
 declare function ChatInterface(props: ChatInterfaceProps): react_jsx_runtime.JSX.Element;
 
-export { type AssistantMessageSlotProps as A, type ChatInterfaceProps as C, type UserMessageSlotProps as U, ChatInterface as a };
+export { type AssistantMessageSlotProps as A, type ChatInterfaceProps as C, DEFAULT_PANEL_WIDTH as D, type PanelWidth as P, type UserMessageSlotProps as U, ChatInterface as a };

package/dist/{ChatInterface-qiVhkmx3.d.ts → ChatInterface-D5tY6WT1.d.ts}

@@ -1,6 +1,28 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Q as QuestionConfig } from './types-DRa1zFlN.js';
 
+/**
+ * How wide the desktop chat panel is, and where the panels beside it go.
+ *
+ * The panel used to be a fixed `max-w-[780px]`, and the preview and live-chat
+ * panels that open next to it hardcoded the same number as `790px` / `800px`.
+ * A host that needed a wider or narrower chat had no way to ask for one, and
+ * changing the first number alone would have left the other two overlapping it
+ * or floating off in space. Everything that depends on the width now reads it
+ * from here.
+ */
+/** Maximum width of the desktop chat panel when the host does not choose one. */
+declare const DEFAULT_PANEL_WIDTH = 780;
+/**
+ * Maximum width of the desktop chat panel.
+ *
+ * - a number is pixels (`960`)
+ * - a string is any CSS length (`"960px"`, `"60vw"`, `"min(960px, 60vw)"`)
+ *
+ * The panel is still never wider than the viewport.
+ */
+type PanelWidth = number | string;
+
 interface ChatInterfaceProps {
     /** Allow per-instance overrides of any context value */
     isOpen?: boolean;
@@ -36,6 +58,14 @@ interface ChatInterfaceProps {
      * - `"stream-order"` — parts render in the order received from the API
      */
     messagePartOrder?: "text-first" | "tools-first" | "stream-order";
+    /**
+     * Where the view settles while an answer streams in.
+     * - `"latest-turn"` (default) — follows the answer down only until the
+     *   visitor's question reaches the top, then holds there, so a long reply is
+     *   read from its first line
+     * - `"bottom"` — always follows the end of the content
+     */
+    scrollAnchor?: "latest-turn" | "bottom";
 }
 interface AssistantMessageSlotProps {
     message: {
@@ -61,4 +91,4 @@ interface UserMessageSlotProps {
 }
 declare function ChatInterface(props: ChatInterfaceProps): react_jsx_runtime.JSX.Element;
 
-export { type AssistantMessageSlotProps as A, type ChatInterfaceProps as C, type UserMessageSlotProps as U, ChatInterface as a };
+export { type AssistantMessageSlotProps as A, type ChatInterfaceProps as C, DEFAULT_PANEL_WIDTH as D, type PanelWidth as P, type UserMessageSlotProps as U, ChatInterface as a };

package/dist/ai-elements.cjs

@@ -2,7 +2,7 @@
 'use strict';
 
 var chunkDDATCJ3O_cjs = require('./chunk-DDATCJ3O.cjs');
-var chunk6CVBJ4EI_cjs = require('./chunk-6CVBJ4EI.cjs');
+var chunkB277MAUK_cjs = require('./chunk-B277MAUK.cjs');
 require('./chunk-X7R334SB.cjs');
 require('./chunk-72QJ2ORD.cjs');
 var chunkJOO6C3XT_cjs = require('./chunk-JOO6C3XT.cjs');
@@ -3600,103 +3600,115 @@ var Image = ({
 
 Object.defineProperty(exports, "Conversation", {
   enumerable: true,
-  get: function () { return chunk6CVBJ4EI_cjs.Conversation; }
+  get: function () { return chunkB277MAUK_cjs.Conversation; }
 });
 Object.defineProperty(exports, "ConversationContent", {
   enumerable: true,
-  get: function () { return chunk6CVBJ4EI_cjs.ConversationContent; }
+  get: function () { return chunkB277MAUK_cjs.ConversationContent; }
 });
 Object.defineProperty(exports, "ConversationEmptyState", {
   enumerable: true,
-  get: function () { return chunk6CVBJ4EI_cjs.ConversationEmptyState; }
+  get: function () { return chunkB277MAUK_cjs.ConversationEmptyState; }
 });
 Object.defineProperty(exports, "ConversationScrollButton", {
   enumerable: true,
-  get: function () { return chunk6CVBJ4EI_cjs.ConversationScrollButton; }
+  get: function () { return chunkB277MAUK_cjs.ConversationScrollButton; }
+});
+Object.defineProperty(exports, "FollowLatestTurn", {
+  enumerable: true,
+  get: function () { return chunkB277MAUK_cjs.FollowLatestTurn; }
+});
+Object.defineProperty(exports, "LATEST_TURN_ATTR", {
+  enumerable: true,
+  get: function () { return chunkB277MAUK_cjs.LATEST_TURN_ATTR; }
 });
 Object.defineProperty(exports, "Loader", {
   enumerable: true,
-  get: function () { return chunk6CVBJ4EI_cjs.Loader; }
+  get: function () { return chunkB277MAUK_cjs.Loader; }
 });
 Object.defineProperty(exports, "Message", {
   enumerable: true,
-  get: function () { return chunk6CVBJ4EI_cjs.Message; }
+  get: function () { return chunkB277MAUK_cjs.Message; }
 });
 Object.defineProperty(exports, "MessageAction", {
   enumerable: true,
-  get: function () { return chunk6CVBJ4EI_cjs.MessageAction; }
+  get: function () { return chunkB277MAUK_cjs.MessageAction; }
 });
 Object.defineProperty(exports, "MessageActions", {
   enumerable: true,
-  get: function () { return chunk6CVBJ4EI_cjs.MessageActions; }
+  get: function () { return chunkB277MAUK_cjs.MessageActions; }
 });
 Object.defineProperty(exports, "MessageAttachment", {
   enumerable: true,
-  get: function () { return chunk6CVBJ4EI_cjs.MessageAttachment; }
+  get: function () { return chunkB277MAUK_cjs.MessageAttachment; }
 });
 Object.defineProperty(exports, "MessageAttachments", {
   enumerable: true,
-  get: function () { return chunk6CVBJ4EI_cjs.MessageAttachments; }
+  get: function () { return chunkB277MAUK_cjs.MessageAttachments; }
 });
 Object.defineProperty(exports, "MessageBranch", {
   enumerable: true,
-  get: function () { return chunk6CVBJ4EI_cjs.MessageBranch; }
+  get: function () { return chunkB277MAUK_cjs.MessageBranch; }
 });
 Object.defineProperty(exports, "MessageBranchContent", {
   enumerable: true,
-  get: function () { return chunk6CVBJ4EI_cjs.MessageBranchContent; }
+  get: function () { return chunkB277MAUK_cjs.MessageBranchContent; }
 });
 Object.defineProperty(exports, "MessageBranchNext", {
   enumerable: true,
-  get: function () { return chunk6CVBJ4EI_cjs.MessageBranchNext; }
+  get: function () { return chunkB277MAUK_cjs.MessageBranchNext; }
 });
 Object.defineProperty(exports, "MessageBranchPage", {
   enumerable: true,
-  get: function () { return chunk6CVBJ4EI_cjs.MessageBranchPage; }
+  get: function () { return chunkB277MAUK_cjs.MessageBranchPage; }
 });
 Object.defineProperty(exports, "MessageBranchPrevious", {
   enumerable: true,
-  get: function () { return chunk6CVBJ4EI_cjs.MessageBranchPrevious; }
+  get: function () { return chunkB277MAUK_cjs.MessageBranchPrevious; }
 });
 Object.defineProperty(exports, "MessageBranchSelector", {
   enumerable: true,
-  get: function () { return chunk6CVBJ4EI_cjs.MessageBranchSelector; }
+  get: function () { return chunkB277MAUK_cjs.MessageBranchSelector; }
 });
 Object.defineProperty(exports, "MessageContent", {
   enumerable: true,
-  get: function () { return chunk6CVBJ4EI_cjs.MessageContent; }
+  get: function () { return chunkB277MAUK_cjs.MessageContent; }
 });
 Object.defineProperty(exports, "MessageFeedback", {
   enumerable: true,
-  get: function () { return chunk6CVBJ4EI_cjs.MessageFeedback; }
+  get: function () { return chunkB277MAUK_cjs.MessageFeedback; }
 });
 Object.defineProperty(exports, "MessageResponse", {
   enumerable: true,
-  get: function () { return chunk6CVBJ4EI_cjs.MessageResponse; }
+  get: function () { return chunkB277MAUK_cjs.MessageResponse; }
 });
 Object.defineProperty(exports, "MessageToolbar", {
   enumerable: true,
-  get: function () { return chunk6CVBJ4EI_cjs.MessageToolbar; }
+  get: function () { return chunkB277MAUK_cjs.MessageToolbar; }
 });
 Object.defineProperty(exports, "Source", {
   enumerable: true,
-  get: function () { return chunk6CVBJ4EI_cjs.Source; }
+  get: function () { return chunkB277MAUK_cjs.Source; }
 });
 Object.defineProperty(exports, "Sources", {
   enumerable: true,
-  get: function () { return chunk6CVBJ4EI_cjs.Sources; }
+  get: function () { return chunkB277MAUK_cjs.Sources; }
 });
 Object.defineProperty(exports, "SourcesContent", {
   enumerable: true,
-  get: function () { return chunk6CVBJ4EI_cjs.SourcesContent; }
+  get: function () { return chunkB277MAUK_cjs.SourcesContent; }
 });
 Object.defineProperty(exports, "SourcesTrigger", {
   enumerable: true,
-  get: function () { return chunk6CVBJ4EI_cjs.SourcesTrigger; }
+  get: function () { return chunkB277MAUK_cjs.SourcesTrigger; }
 });
 Object.defineProperty(exports, "SpinnerLoader", {
   enumerable: true,
-  get: function () { return chunk6CVBJ4EI_cjs.SpinnerLoader; }
+  get: function () { return chunkB277MAUK_cjs.SpinnerLoader; }
+});
+Object.defineProperty(exports, "anchorToLatestTurn", {
+  enumerable: true,
+  get: function () { return chunkB277MAUK_cjs.anchorToLatestTurn; }
 });
 exports.AIImage = Image;
 exports.Artifact = Artifact;

package/dist/ai-elements.d.cts

@@ -67,7 +67,69 @@ type MessageToolbarProps = ComponentProps<"div">;
 declare const MessageToolbar: ({ className, children, ...props }: MessageToolbarProps) => react_jsx_runtime.JSX.Element;
 
 type ConversationProps = ComponentProps<typeof StickToBottom>;
+/**
+ * Marks the turn the visitor sent last. {@link anchorToLatestTurn} stops the
+ * view there instead of at the bottom of whatever came back.
+ */
+declare const LATEST_TURN_ATTR = "data-ac-latest-turn";
+type TargetScrollTop = NonNullable<ConversationProps["targetScrollTop"]>;
+/**
+ * Where "the bottom" is for a conversation: never further down than the point
+ * where the latest question reaches the top of the view.
+ *
+ * ## Why not simply stick to the bottom
+ *
+ * `StickToBottom` follows the end of the content, which is right while an
+ * answer is shorter than the view and wrong the moment it is taller. A reply
+ * that carries a product grid can run to thousands of pixels; following its
+ * end lands the visitor on the last row of cards with the written answer
+ * scrolled far out of sight above. Nothing on screen changes while the text
+ * streams in up there, so a turn that worked reads as a chat that stopped
+ * answering — which is how it was reported from the field.
+ *
+ * Capping the target instead gives the reading order people expect: the
+ * question pinned at the top, the answer growing downward from it.
+ *
+ * ## Why it is safe to hand to the library
+ *
+ * `use-stick-to-bottom` clamps the result to `min(this, bottom)`, so an answer
+ * that fits on screen behaves exactly as before. It also treats this capped
+ * position as "at the bottom" — so the lock holds while the answer grows, and a
+ * visitor who scrolls away still escapes it as usual.
+ *
+ * Measured from the live layout on every call rather than cached: the anchor
+ * moves whenever anything above it changes size (an image loading, an older
+ * result folding away), and the library already memoises per animation frame.
+ */
+declare const anchorToLatestTurn: TargetScrollTop;
 declare const Conversation: ({ className, ...props }: ConversationProps) => react_jsx_runtime.JSX.Element;
+/**
+ * Bring the view to a turn the visitor just sent. Render inside a
+ * {@link Conversation}; `turnKey` is the id of that turn.
+ *
+ * ## Why the anchor alone is not enough
+ *
+ * `use-stick-to-bottom` follows new content only while it believes the view is
+ * locked to the end, and it drops that lock on any upward scroll it did not
+ * make itself — a visitor reading back, but also the browser keeping content
+ * steady when something above the view shrinks, as an older result card does
+ * when it folds away. Once released it stays released: content growth is
+ * handled with the current position preserved, so every later answer streamed
+ * in below the fold while the view sat still, and the conversation read as one
+ * that had stopped answering.
+ *
+ * Sending a message is the one moment the visitor has plainly asked to follow
+ * along, so this re-engages the lock then. The scroll target is capped by
+ * {@link anchorToLatestTurn}, so "re-engage" lands on the new question rather
+ * than on the end of a long answer, and the library only ever scrolls
+ * downward, so it never drags the view back up over something being read.
+ *
+ * Deferred a frame so the new turn has been laid out when the target is
+ * measured.
+ */
+declare const FollowLatestTurn: ({ turnKey }: {
+    turnKey?: string;
+}) => null;
 type ConversationContentProps = ComponentProps<typeof StickToBottom.Content>;
 declare const ConversationContent: ({ className, ...props }: ConversationContentProps) => react_jsx_runtime.JSX.Element;
 type ConversationEmptyStateProps = ComponentProps<"div"> & {
@@ -873,4 +935,4 @@ type ImageProps = Experimental_GeneratedImage & {
 };
 declare const Image: ({ base64, uint8Array, mediaType, ...props }: ImageProps) => react_jsx_runtime.JSX.Element;
 
-export { Image as AIImage, Artifact, ArtifactAction, type ArtifactActionProps, ArtifactActions, type ArtifactActionsProps, ArtifactClose, type ArtifactCloseProps, ArtifactContent, type ArtifactContentProps, ArtifactDescription, type ArtifactDescriptionProps, ArtifactHeader, type ArtifactHeaderProps, type ArtifactProps, ArtifactTitle, type ArtifactTitleProps, type AttachmentsContext, Canvas, ChainOfThought, ChainOfThoughtContent, type ChainOfThoughtContentProps, ChainOfThoughtHeader, type ChainOfThoughtHeaderProps, ChainOfThoughtImage, type ChainOfThoughtImageProps, type ChainOfThoughtProps, ChainOfThoughtSearchResult, type ChainOfThoughtSearchResultProps, ChainOfThoughtSearchResults, type ChainOfThoughtSearchResultsProps, ChainOfThoughtStep, type ChainOfThoughtStepProps, Checkpoint, CheckpointIcon, type CheckpointIconProps, type CheckpointProps, CheckpointTrigger, type CheckpointTriggerProps, CodeBlock, CodeBlockCopyButton, type CodeBlockCopyButtonProps, ComponentRenderer, type ComponentRendererProps, Confirmation, ConfirmationAccepted, type ConfirmationAcceptedProps, ConfirmationAction, type ConfirmationActionProps, ConfirmationActions, type ConfirmationActionsProps, type ConfirmationProps, ConfirmationRejected, type ConfirmationRejectedProps, ConfirmationRequest, type ConfirmationRequestProps, ConfirmationTitle, type ConfirmationTitleProps, Connection, Context, ContextCacheUsage, type ContextCacheUsageProps, ContextContent, ContextContentBody, type ContextContentBodyProps, ContextContentFooter, type ContextContentFooterProps, ContextContentHeader, type ContextContentHeaderProps, type ContextContentProps, ContextInputUsage, type ContextInputUsageProps, ContextOutputUsage, type ContextOutputUsageProps, type ContextProps, ContextReasoningUsage, type ContextReasoningUsageProps, ContextTrigger, type ContextTriggerProps, Controls, type ControlsProps, Conversation, ConversationContent, type ConversationContentProps, ConversationEmptyState, type ConversationEmptyStateProps, type ConversationProps, ConversationScrollButton, type ConversationScrollButtonProps, Edge, FollowupButtons, InlineCitation, InlineCitationCard, InlineCitationCardBody, type InlineCitationCardBodyProps, type InlineCitationCardProps, InlineCitationCardTrigger, type InlineCitationCardTriggerProps, InlineCitationCarousel, InlineCitationCarouselContent, type InlineCitationCarouselContentProps, InlineCitationCarouselHeader, type InlineCitationCarouselHeaderProps, InlineCitationCarouselIndex, type InlineCitationCarouselIndexProps, InlineCitationCarouselItem, type InlineCitationCarouselItemProps, InlineCitationCarouselNext, type InlineCitationCarouselNextProps, InlineCitationCarouselPrev, type InlineCitationCarouselPrevProps, type InlineCitationCarouselProps, type InlineCitationProps, InlineCitationQuote, type InlineCitationQuoteProps, InlineCitationSource, type InlineCitationSourceProps, InlineCitationText, type InlineCitationTextProps, Loader, type LoaderProps, Message, MessageAction, type MessageActionProps, MessageActions, type MessageActionsProps, MessageAttachment, type MessageAttachmentProps, MessageAttachments, type MessageAttachmentsProps, MessageBranch, MessageBranchContent, type MessageBranchContentProps, MessageBranchNext, type MessageBranchNextProps, MessageBranchPage, type MessageBranchPageProps, MessageBranchPrevious, type MessageBranchPreviousProps, type MessageBranchProps, MessageBranchSelector, type MessageBranchSelectorProps, MessageContent, type MessageContentProps, type MessageProps, MessageResponse, type MessageResponseProps, MessageToolbar, type MessageToolbarProps, ModelSelector, ModelSelectorContent, type ModelSelectorContentProps, ModelSelectorDialog, type ModelSelectorDialogProps, ModelSelectorEmpty, type ModelSelectorEmptyProps, ModelSelectorGroup, type ModelSelectorGroupProps, ModelSelectorInput, type ModelSelectorInputProps, ModelSelectorItem, type ModelSelectorItemProps, ModelSelectorList, type ModelSelectorListProps, ModelSelectorLogo, ModelSelectorLogoGroup, type ModelSelectorLogoGroupProps, type ModelSelectorLogoProps, ModelSelectorName, type ModelSelectorNameProps, type ModelSelectorProps, ModelSelectorSeparator, type ModelSelectorSeparatorProps, ModelSelectorShortcut, type ModelSelectorShortcutProps, ModelSelectorTrigger, type ModelSelectorTriggerProps, Node, NodeAction, type NodeActionProps, NodeContent, type NodeContentProps, NodeDescription, type NodeDescriptionProps, NodeFooter, type NodeFooterProps, NodeHeader, type NodeHeaderProps, type NodeProps, NodeTitle, type NodeTitleProps, OpenIn, OpenInChatGPT, OpenInClaude, OpenInContent, type OpenInContentProps, OpenInCursor, OpenInItem, type OpenInItemProps, OpenInLabel, type OpenInLabelProps, type OpenInProps, OpenInScira, OpenInSeparator, type OpenInSeparatorProps, OpenInT3, OpenInTrigger, type OpenInTriggerProps, OpenInv0, Panel, Plan, PlanAction, type PlanActionProps, PlanContent, type PlanContentProps, PlanDescription, type PlanDescriptionProps, PlanFooter, type PlanFooterProps, PlanHeader, type PlanHeaderProps, type PlanProps, PlanTitle, type PlanTitleProps, PlanTrigger, type PlanTriggerProps, PromptInput, PromptInputActionAddAttachments, type PromptInputActionAddAttachmentsProps, PromptInputActionMenu, PromptInputActionMenuContent, type PromptInputActionMenuContentProps, PromptInputActionMenuItem, type PromptInputActionMenuItemProps, type PromptInputActionMenuProps, PromptInputActionMenuTrigger, type PromptInputActionMenuTriggerProps, PromptInputAttachment, type PromptInputAttachmentProps, PromptInputAttachments, type PromptInputAttachmentsProps, PromptInputBody, type PromptInputBodyProps, PromptInputButton, type PromptInputButtonProps, PromptInputCommand, PromptInputCommandEmpty, type PromptInputCommandEmptyProps, PromptInputCommandGroup, type PromptInputCommandGroupProps, PromptInputCommandInput, type PromptInputCommandInputProps, PromptInputCommandItem, type PromptInputCommandItemProps, PromptInputCommandList, type PromptInputCommandListProps, type PromptInputCommandProps, PromptInputCommandSeparator, type PromptInputCommandSeparatorProps, type PromptInputControllerProps, PromptInputFooter, type PromptInputFooterProps, PromptInputHeader, type PromptInputHeaderProps, PromptInputHoverCard, PromptInputHoverCardContent, type PromptInputHoverCardContentProps, type PromptInputHoverCardProps, PromptInputHoverCardTrigger, type PromptInputHoverCardTriggerProps, type PromptInputMessage, type PromptInputProps, PromptInputProvider, type PromptInputProviderProps, PromptInputSelect, PromptInputSelectContent, type PromptInputSelectContentProps, PromptInputSelectItem, type PromptInputSelectItemProps, type PromptInputSelectProps, PromptInputSelectTrigger, type PromptInputSelectTriggerProps, PromptInputSelectValue, type PromptInputSelectValueProps, PromptInputSpeechButton, type PromptInputSpeechButtonProps, PromptInputSubmit, type PromptInputSubmitProps, PromptInputTab, PromptInputTabBody, type PromptInputTabBodyProps, PromptInputTabItem, type PromptInputTabItemProps, PromptInputTabLabel, type PromptInputTabLabelProps, type PromptInputTabProps, PromptInputTabsList, type PromptInputTabsListProps, PromptInputTextarea, type PromptInputTextareaProps, PromptInputTools, type PromptInputToolsProps, Queue, QueueItem, QueueItemAction, type QueueItemActionProps, QueueItemActions, type QueueItemActionsProps, QueueItemAttachment, type QueueItemAttachmentProps, QueueItemContent, type QueueItemContentProps, QueueItemDescription, type QueueItemDescriptionProps, QueueItemFile, type QueueItemFileProps, QueueItemImage, type QueueItemImageProps, QueueItemIndicator, type QueueItemIndicatorProps, type QueueItemProps, QueueList, type QueueListProps, type QueueMessage, type QueueMessagePart, type QueueProps, QueueSection, QueueSectionContent, type QueueSectionContentProps, QueueSectionLabel, type QueueSectionLabelProps, type QueueSectionProps, QueueSectionTrigger, type QueueSectionTriggerProps, type QueueTodo, Reasoning, ReasoningContent, type ReasoningContentProps, type ReasoningProps, ReasoningTrigger, type ReasoningTriggerProps, Shimmer, Source, type SourceProps, Sources, SourcesContent, type SourcesContentProps, type SourcesProps, SourcesTrigger, type SourcesTriggerProps, SpinnerLoader, type SpinnerLoaderProps, Suggestion, type SuggestionProps, Suggestions, type SuggestionsProps, Task, TaskContent, type TaskContentProps, TaskItem, TaskItemFile, type TaskItemFileProps, type TaskItemProps, type TaskProps, TaskTrigger, type TaskTriggerProps, type TextInputContext, type TextShimmerProps, ThinkingSpinner, Tool, ToolContent, type ToolContentProps, ToolHeader, type ToolHeaderProps, ToolInput, type ToolInputProps, ToolOutput, type ToolOutputProps, type ToolProps, Toolbar, WebPreview, WebPreviewBody, type WebPreviewBodyProps, WebPreviewConsole, type WebPreviewConsoleProps, type WebPreviewContextValue, WebPreviewNavigation, WebPreviewNavigationButton, type WebPreviewNavigationButtonProps, type WebPreviewNavigationProps, type WebPreviewProps, WebPreviewUrl, type WebPreviewUrlProps, highlightCode, usePromptInputAttachments, usePromptInputController, useProviderAttachments, useReasoning };
+export { Image as AIImage, Artifact, ArtifactAction, type ArtifactActionProps, ArtifactActions, type ArtifactActionsProps, ArtifactClose, type ArtifactCloseProps, ArtifactContent, type ArtifactContentProps, ArtifactDescription, type ArtifactDescriptionProps, ArtifactHeader, type ArtifactHeaderProps, type ArtifactProps, ArtifactTitle, type ArtifactTitleProps, type AttachmentsContext, Canvas, ChainOfThought, ChainOfThoughtContent, type ChainOfThoughtContentProps, ChainOfThoughtHeader, type ChainOfThoughtHeaderProps, ChainOfThoughtImage, type ChainOfThoughtImageProps, type ChainOfThoughtProps, ChainOfThoughtSearchResult, type ChainOfThoughtSearchResultProps, ChainOfThoughtSearchResults, type ChainOfThoughtSearchResultsProps, ChainOfThoughtStep, type ChainOfThoughtStepProps, Checkpoint, CheckpointIcon, type CheckpointIconProps, type CheckpointProps, CheckpointTrigger, type CheckpointTriggerProps, CodeBlock, CodeBlockCopyButton, type CodeBlockCopyButtonProps, ComponentRenderer, type ComponentRendererProps, Confirmation, ConfirmationAccepted, type ConfirmationAcceptedProps, ConfirmationAction, type ConfirmationActionProps, ConfirmationActions, type ConfirmationActionsProps, type ConfirmationProps, ConfirmationRejected, type ConfirmationRejectedProps, ConfirmationRequest, type ConfirmationRequestProps, ConfirmationTitle, type ConfirmationTitleProps, Connection, Context, ContextCacheUsage, type ContextCacheUsageProps, ContextContent, ContextContentBody, type ContextContentBodyProps, ContextContentFooter, type ContextContentFooterProps, ContextContentHeader, type ContextContentHeaderProps, type ContextContentProps, ContextInputUsage, type ContextInputUsageProps, ContextOutputUsage, type ContextOutputUsageProps, type ContextProps, ContextReasoningUsage, type ContextReasoningUsageProps, ContextTrigger, type ContextTriggerProps, Controls, type ControlsProps, Conversation, ConversationContent, type ConversationContentProps, ConversationEmptyState, type ConversationEmptyStateProps, type ConversationProps, ConversationScrollButton, type ConversationScrollButtonProps, Edge, FollowLatestTurn, FollowupButtons, InlineCitation, InlineCitationCard, InlineCitationCardBody, type InlineCitationCardBodyProps, type InlineCitationCardProps, InlineCitationCardTrigger, type InlineCitationCardTriggerProps, InlineCitationCarousel, InlineCitationCarouselContent, type InlineCitationCarouselContentProps, InlineCitationCarouselHeader, type InlineCitationCarouselHeaderProps, InlineCitationCarouselIndex, type InlineCitationCarouselIndexProps, InlineCitationCarouselItem, type InlineCitationCarouselItemProps, InlineCitationCarouselNext, type InlineCitationCarouselNextProps, InlineCitationCarouselPrev, type InlineCitationCarouselPrevProps, type InlineCitationCarouselProps, type InlineCitationProps, InlineCitationQuote, type InlineCitationQuoteProps, InlineCitationSource, type InlineCitationSourceProps, InlineCitationText, type InlineCitationTextProps, LATEST_TURN_ATTR, Loader, type LoaderProps, Message, MessageAction, type MessageActionProps, MessageActions, type MessageActionsProps, MessageAttachment, type MessageAttachmentProps, MessageAttachments, type MessageAttachmentsProps, MessageBranch, MessageBranchContent, type MessageBranchContentProps, MessageBranchNext, type MessageBranchNextProps, MessageBranchPage, type MessageBranchPageProps, MessageBranchPrevious, type MessageBranchPreviousProps, type MessageBranchProps, MessageBranchSelector, type MessageBranchSelectorProps, MessageContent, type MessageContentProps, type MessageProps, MessageResponse, type MessageResponseProps, MessageToolbar, type MessageToolbarProps, ModelSelector, ModelSelectorContent, type ModelSelectorContentProps, ModelSelectorDialog, type ModelSelectorDialogProps, ModelSelectorEmpty, type ModelSelectorEmptyProps, ModelSelectorGroup, type ModelSelectorGroupProps, ModelSelectorInput, type ModelSelectorInputProps, ModelSelectorItem, type ModelSelectorItemProps, ModelSelectorList, type ModelSelectorListProps, ModelSelectorLogo, ModelSelectorLogoGroup, type ModelSelectorLogoGroupProps, type ModelSelectorLogoProps, ModelSelectorName, type ModelSelectorNameProps, type ModelSelectorProps, ModelSelectorSeparator, type ModelSelectorSeparatorProps, ModelSelectorShortcut, type ModelSelectorShortcutProps, ModelSelectorTrigger, type ModelSelectorTriggerProps, Node, NodeAction, type NodeActionProps, NodeContent, type NodeContentProps, NodeDescription, type NodeDescriptionProps, NodeFooter, type NodeFooterProps, NodeHeader, type NodeHeaderProps, type NodeProps, NodeTitle, type NodeTitleProps, OpenIn, OpenInChatGPT, OpenInClaude, OpenInContent, type OpenInContentProps, OpenInCursor, OpenInItem, type OpenInItemProps, OpenInLabel, type OpenInLabelProps, type OpenInProps, OpenInScira, OpenInSeparator, type OpenInSeparatorProps, OpenInT3, OpenInTrigger, type OpenInTriggerProps, OpenInv0, Panel, Plan, PlanAction, type PlanActionProps, PlanContent, type PlanContentProps, PlanDescription, type PlanDescriptionProps, PlanFooter, type PlanFooterProps, PlanHeader, type PlanHeaderProps, type PlanProps, PlanTitle, type PlanTitleProps, PlanTrigger, type PlanTriggerProps, PromptInput, PromptInputActionAddAttachments, type PromptInputActionAddAttachmentsProps, PromptInputActionMenu, PromptInputActionMenuContent, type PromptInputActionMenuContentProps, PromptInputActionMenuItem, type PromptInputActionMenuItemProps, type PromptInputActionMenuProps, PromptInputActionMenuTrigger, type PromptInputActionMenuTriggerProps, PromptInputAttachment, type PromptInputAttachmentProps, PromptInputAttachments, type PromptInputAttachmentsProps, PromptInputBody, type PromptInputBodyProps, PromptInputButton, type PromptInputButtonProps, PromptInputCommand, PromptInputCommandEmpty, type PromptInputCommandEmptyProps, PromptInputCommandGroup, type PromptInputCommandGroupProps, PromptInputCommandInput, type PromptInputCommandInputProps, PromptInputCommandItem, type PromptInputCommandItemProps, PromptInputCommandList, type PromptInputCommandListProps, type PromptInputCommandProps, PromptInputCommandSeparator, type PromptInputCommandSeparatorProps, type PromptInputControllerProps, PromptInputFooter, type PromptInputFooterProps, PromptInputHeader, type PromptInputHeaderProps, PromptInputHoverCard, PromptInputHoverCardContent, type PromptInputHoverCardContentProps, type PromptInputHoverCardProps, PromptInputHoverCardTrigger, type PromptInputHoverCardTriggerProps, type PromptInputMessage, type PromptInputProps, PromptInputProvider, type PromptInputProviderProps, PromptInputSelect, PromptInputSelectContent, type PromptInputSelectContentProps, PromptInputSelectItem, type PromptInputSelectItemProps, type PromptInputSelectProps, PromptInputSelectTrigger, type PromptInputSelectTriggerProps, PromptInputSelectValue, type PromptInputSelectValueProps, PromptInputSpeechButton, type PromptInputSpeechButtonProps, PromptInputSubmit, type PromptInputSubmitProps, PromptInputTab, PromptInputTabBody, type PromptInputTabBodyProps, PromptInputTabItem, type PromptInputTabItemProps, PromptInputTabLabel, type PromptInputTabLabelProps, type PromptInputTabProps, PromptInputTabsList, type PromptInputTabsListProps, PromptInputTextarea, type PromptInputTextareaProps, PromptInputTools, type PromptInputToolsProps, Queue, QueueItem, QueueItemAction, type QueueItemActionProps, QueueItemActions, type QueueItemActionsProps, QueueItemAttachment, type QueueItemAttachmentProps, QueueItemContent, type QueueItemContentProps, QueueItemDescription, type QueueItemDescriptionProps, QueueItemFile, type QueueItemFileProps, QueueItemImage, type QueueItemImageProps, QueueItemIndicator, type QueueItemIndicatorProps, type QueueItemProps, QueueList, type QueueListProps, type QueueMessage, type QueueMessagePart, type QueueProps, QueueSection, QueueSectionContent, type QueueSectionContentProps, QueueSectionLabel, type QueueSectionLabelProps, type QueueSectionProps, QueueSectionTrigger, type QueueSectionTriggerProps, type QueueTodo, Reasoning, ReasoningContent, type ReasoningContentProps, type ReasoningProps, ReasoningTrigger, type ReasoningTriggerProps, Shimmer, Source, type SourceProps, Sources, SourcesContent, type SourcesContentProps, type SourcesProps, SourcesTrigger, type SourcesTriggerProps, SpinnerLoader, type SpinnerLoaderProps, Suggestion, type SuggestionProps, Suggestions, type SuggestionsProps, Task, TaskContent, type TaskContentProps, TaskItem, TaskItemFile, type TaskItemFileProps, type TaskItemProps, type TaskProps, TaskTrigger, type TaskTriggerProps, type TextInputContext, type TextShimmerProps, ThinkingSpinner, Tool, ToolContent, type ToolContentProps, ToolHeader, type ToolHeaderProps, ToolInput, type ToolInputProps, ToolOutput, type ToolOutputProps, type ToolProps, Toolbar, WebPreview, WebPreviewBody, type WebPreviewBodyProps, WebPreviewConsole, type WebPreviewConsoleProps, type WebPreviewContextValue, WebPreviewNavigation, WebPreviewNavigationButton, type WebPreviewNavigationButtonProps, type WebPreviewNavigationProps, type WebPreviewProps, WebPreviewUrl, type WebPreviewUrlProps, anchorToLatestTurn, highlightCode, usePromptInputAttachments, usePromptInputController, useProviderAttachments, useReasoning };

package/dist/ai-elements.d.ts

@@ -67,7 +67,69 @@ type MessageToolbarProps = ComponentProps<"div">;
 declare const MessageToolbar: ({ className, children, ...props }: MessageToolbarProps) => react_jsx_runtime.JSX.Element;
 
 type ConversationProps = ComponentProps<typeof StickToBottom>;
+/**
+ * Marks the turn the visitor sent last. {@link anchorToLatestTurn} stops the
+ * view there instead of at the bottom of whatever came back.
+ */
+declare const LATEST_TURN_ATTR = "data-ac-latest-turn";
+type TargetScrollTop = NonNullable<ConversationProps["targetScrollTop"]>;
+/**
+ * Where "the bottom" is for a conversation: never further down than the point
+ * where the latest question reaches the top of the view.
+ *
+ * ## Why not simply stick to the bottom
+ *
+ * `StickToBottom` follows the end of the content, which is right while an
+ * answer is shorter than the view and wrong the moment it is taller. A reply
+ * that carries a product grid can run to thousands of pixels; following its
+ * end lands the visitor on the last row of cards with the written answer
+ * scrolled far out of sight above. Nothing on screen changes while the text
+ * streams in up there, so a turn that worked reads as a chat that stopped
+ * answering — which is how it was reported from the field.
+ *
+ * Capping the target instead gives the reading order people expect: the
+ * question pinned at the top, the answer growing downward from it.
+ *
+ * ## Why it is safe to hand to the library
+ *
+ * `use-stick-to-bottom` clamps the result to `min(this, bottom)`, so an answer
+ * that fits on screen behaves exactly as before. It also treats this capped
+ * position as "at the bottom" — so the lock holds while the answer grows, and a
+ * visitor who scrolls away still escapes it as usual.
+ *
+ * Measured from the live layout on every call rather than cached: the anchor
+ * moves whenever anything above it changes size (an image loading, an older
+ * result folding away), and the library already memoises per animation frame.
+ */
+declare const anchorToLatestTurn: TargetScrollTop;
 declare const Conversation: ({ className, ...props }: ConversationProps) => react_jsx_runtime.JSX.Element;
+/**
+ * Bring the view to a turn the visitor just sent. Render inside a
+ * {@link Conversation}; `turnKey` is the id of that turn.
+ *
+ * ## Why the anchor alone is not enough
+ *
+ * `use-stick-to-bottom` follows new content only while it believes the view is
+ * locked to the end, and it drops that lock on any upward scroll it did not
+ * make itself — a visitor reading back, but also the browser keeping content
+ * steady when something above the view shrinks, as an older result card does
+ * when it folds away. Once released it stays released: content growth is
+ * handled with the current position preserved, so every later answer streamed
+ * in below the fold while the view sat still, and the conversation read as one
+ * that had stopped answering.
+ *
+ * Sending a message is the one moment the visitor has plainly asked to follow
+ * along, so this re-engages the lock then. The scroll target is capped by
+ * {@link anchorToLatestTurn}, so "re-engage" lands on the new question rather
+ * than on the end of a long answer, and the library only ever scrolls
+ * downward, so it never drags the view back up over something being read.
+ *
+ * Deferred a frame so the new turn has been laid out when the target is
+ * measured.
+ */
+declare const FollowLatestTurn: ({ turnKey }: {
+    turnKey?: string;
+}) => null;
 type ConversationContentProps = ComponentProps<typeof StickToBottom.Content>;
 declare const ConversationContent: ({ className, ...props }: ConversationContentProps) => react_jsx_runtime.JSX.Element;
 type ConversationEmptyStateProps = ComponentProps<"div"> & {
@@ -873,4 +935,4 @@ type ImageProps = Experimental_GeneratedImage & {
 };
 declare const Image: ({ base64, uint8Array, mediaType, ...props }: ImageProps) => react_jsx_runtime.JSX.Element;
 
-export { Image as AIImage, Artifact, ArtifactAction, type ArtifactActionProps, ArtifactActions, type ArtifactActionsProps, ArtifactClose, type ArtifactCloseProps, ArtifactContent, type ArtifactContentProps, ArtifactDescription, type ArtifactDescriptionProps, ArtifactHeader, type ArtifactHeaderProps, type ArtifactProps, ArtifactTitle, type ArtifactTitleProps, type AttachmentsContext, Canvas, ChainOfThought, ChainOfThoughtContent, type ChainOfThoughtContentProps, ChainOfThoughtHeader, type ChainOfThoughtHeaderProps, ChainOfThoughtImage, type ChainOfThoughtImageProps, type ChainOfThoughtProps, ChainOfThoughtSearchResult, type ChainOfThoughtSearchResultProps, ChainOfThoughtSearchResults, type ChainOfThoughtSearchResultsProps, ChainOfThoughtStep, type ChainOfThoughtStepProps, Checkpoint, CheckpointIcon, type CheckpointIconProps, type CheckpointProps, CheckpointTrigger, type CheckpointTriggerProps, CodeBlock, CodeBlockCopyButton, type CodeBlockCopyButtonProps, ComponentRenderer, type ComponentRendererProps, Confirmation, ConfirmationAccepted, type ConfirmationAcceptedProps, ConfirmationAction, type ConfirmationActionProps, ConfirmationActions, type ConfirmationActionsProps, type ConfirmationProps, ConfirmationRejected, type ConfirmationRejectedProps, ConfirmationRequest, type ConfirmationRequestProps, ConfirmationTitle, type ConfirmationTitleProps, Connection, Context, ContextCacheUsage, type ContextCacheUsageProps, ContextContent, ContextContentBody, type ContextContentBodyProps, ContextContentFooter, type ContextContentFooterProps, ContextContentHeader, type ContextContentHeaderProps, type ContextContentProps, ContextInputUsage, type ContextInputUsageProps, ContextOutputUsage, type ContextOutputUsageProps, type ContextProps, ContextReasoningUsage, type ContextReasoningUsageProps, ContextTrigger, type ContextTriggerProps, Controls, type ControlsProps, Conversation, ConversationContent, type ConversationContentProps, ConversationEmptyState, type ConversationEmptyStateProps, type ConversationProps, ConversationScrollButton, type ConversationScrollButtonProps, Edge, FollowupButtons, InlineCitation, InlineCitationCard, InlineCitationCardBody, type InlineCitationCardBodyProps, type InlineCitationCardProps, InlineCitationCardTrigger, type InlineCitationCardTriggerProps, InlineCitationCarousel, InlineCitationCarouselContent, type InlineCitationCarouselContentProps, InlineCitationCarouselHeader, type InlineCitationCarouselHeaderProps, InlineCitationCarouselIndex, type InlineCitationCarouselIndexProps, InlineCitationCarouselItem, type InlineCitationCarouselItemProps, InlineCitationCarouselNext, type InlineCitationCarouselNextProps, InlineCitationCarouselPrev, type InlineCitationCarouselPrevProps, type InlineCitationCarouselProps, type InlineCitationProps, InlineCitationQuote, type InlineCitationQuoteProps, InlineCitationSource, type InlineCitationSourceProps, InlineCitationText, type InlineCitationTextProps, Loader, type LoaderProps, Message, MessageAction, type MessageActionProps, MessageActions, type MessageActionsProps, MessageAttachment, type MessageAttachmentProps, MessageAttachments, type MessageAttachmentsProps, MessageBranch, MessageBranchContent, type MessageBranchContentProps, MessageBranchNext, type MessageBranchNextProps, MessageBranchPage, type MessageBranchPageProps, MessageBranchPrevious, type MessageBranchPreviousProps, type MessageBranchProps, MessageBranchSelector, type MessageBranchSelectorProps, MessageContent, type MessageContentProps, type MessageProps, MessageResponse, type MessageResponseProps, MessageToolbar, type MessageToolbarProps, ModelSelector, ModelSelectorContent, type ModelSelectorContentProps, ModelSelectorDialog, type ModelSelectorDialogProps, ModelSelectorEmpty, type ModelSelectorEmptyProps, ModelSelectorGroup, type ModelSelectorGroupProps, ModelSelectorInput, type ModelSelectorInputProps, ModelSelectorItem, type ModelSelectorItemProps, ModelSelectorList, type ModelSelectorListProps, ModelSelectorLogo, ModelSelectorLogoGroup, type ModelSelectorLogoGroupProps, type ModelSelectorLogoProps, ModelSelectorName, type ModelSelectorNameProps, type ModelSelectorProps, ModelSelectorSeparator, type ModelSelectorSeparatorProps, ModelSelectorShortcut, type ModelSelectorShortcutProps, ModelSelectorTrigger, type ModelSelectorTriggerProps, Node, NodeAction, type NodeActionProps, NodeContent, type NodeContentProps, NodeDescription, type NodeDescriptionProps, NodeFooter, type NodeFooterProps, NodeHeader, type NodeHeaderProps, type NodeProps, NodeTitle, type NodeTitleProps, OpenIn, OpenInChatGPT, OpenInClaude, OpenInContent, type OpenInContentProps, OpenInCursor, OpenInItem, type OpenInItemProps, OpenInLabel, type OpenInLabelProps, type OpenInProps, OpenInScira, OpenInSeparator, type OpenInSeparatorProps, OpenInT3, OpenInTrigger, type OpenInTriggerProps, OpenInv0, Panel, Plan, PlanAction, type PlanActionProps, PlanContent, type PlanContentProps, PlanDescription, type PlanDescriptionProps, PlanFooter, type PlanFooterProps, PlanHeader, type PlanHeaderProps, type PlanProps, PlanTitle, type PlanTitleProps, PlanTrigger, type PlanTriggerProps, PromptInput, PromptInputActionAddAttachments, type PromptInputActionAddAttachmentsProps, PromptInputActionMenu, PromptInputActionMenuContent, type PromptInputActionMenuContentProps, PromptInputActionMenuItem, type PromptInputActionMenuItemProps, type PromptInputActionMenuProps, PromptInputActionMenuTrigger, type PromptInputActionMenuTriggerProps, PromptInputAttachment, type PromptInputAttachmentProps, PromptInputAttachments, type PromptInputAttachmentsProps, PromptInputBody, type PromptInputBodyProps, PromptInputButton, type PromptInputButtonProps, PromptInputCommand, PromptInputCommandEmpty, type PromptInputCommandEmptyProps, PromptInputCommandGroup, type PromptInputCommandGroupProps, PromptInputCommandInput, type PromptInputCommandInputProps, PromptInputCommandItem, type PromptInputCommandItemProps, PromptInputCommandList, type PromptInputCommandListProps, type PromptInputCommandProps, PromptInputCommandSeparator, type PromptInputCommandSeparatorProps, type PromptInputControllerProps, PromptInputFooter, type PromptInputFooterProps, PromptInputHeader, type PromptInputHeaderProps, PromptInputHoverCard, PromptInputHoverCardContent, type PromptInputHoverCardContentProps, type PromptInputHoverCardProps, PromptInputHoverCardTrigger, type PromptInputHoverCardTriggerProps, type PromptInputMessage, type PromptInputProps, PromptInputProvider, type PromptInputProviderProps, PromptInputSelect, PromptInputSelectContent, type PromptInputSelectContentProps, PromptInputSelectItem, type PromptInputSelectItemProps, type PromptInputSelectProps, PromptInputSelectTrigger, type PromptInputSelectTriggerProps, PromptInputSelectValue, type PromptInputSelectValueProps, PromptInputSpeechButton, type PromptInputSpeechButtonProps, PromptInputSubmit, type PromptInputSubmitProps, PromptInputTab, PromptInputTabBody, type PromptInputTabBodyProps, PromptInputTabItem, type PromptInputTabItemProps, PromptInputTabLabel, type PromptInputTabLabelProps, type PromptInputTabProps, PromptInputTabsList, type PromptInputTabsListProps, PromptInputTextarea, type PromptInputTextareaProps, PromptInputTools, type PromptInputToolsProps, Queue, QueueItem, QueueItemAction, type QueueItemActionProps, QueueItemActions, type QueueItemActionsProps, QueueItemAttachment, type QueueItemAttachmentProps, QueueItemContent, type QueueItemContentProps, QueueItemDescription, type QueueItemDescriptionProps, QueueItemFile, type QueueItemFileProps, QueueItemImage, type QueueItemImageProps, QueueItemIndicator, type QueueItemIndicatorProps, type QueueItemProps, QueueList, type QueueListProps, type QueueMessage, type QueueMessagePart, type QueueProps, QueueSection, QueueSectionContent, type QueueSectionContentProps, QueueSectionLabel, type QueueSectionLabelProps, type QueueSectionProps, QueueSectionTrigger, type QueueSectionTriggerProps, type QueueTodo, Reasoning, ReasoningContent, type ReasoningContentProps, type ReasoningProps, ReasoningTrigger, type ReasoningTriggerProps, Shimmer, Source, type SourceProps, Sources, SourcesContent, type SourcesContentProps, type SourcesProps, SourcesTrigger, type SourcesTriggerProps, SpinnerLoader, type SpinnerLoaderProps, Suggestion, type SuggestionProps, Suggestions, type SuggestionsProps, Task, TaskContent, type TaskContentProps, TaskItem, TaskItemFile, type TaskItemFileProps, type TaskItemProps, type TaskProps, TaskTrigger, type TaskTriggerProps, type TextInputContext, type TextShimmerProps, ThinkingSpinner, Tool, ToolContent, type ToolContentProps, ToolHeader, type ToolHeaderProps, ToolInput, type ToolInputProps, ToolOutput, type ToolOutputProps, type ToolProps, Toolbar, WebPreview, WebPreviewBody, type WebPreviewBodyProps, WebPreviewConsole, type WebPreviewConsoleProps, type WebPreviewContextValue, WebPreviewNavigation, WebPreviewNavigationButton, type WebPreviewNavigationButtonProps, type WebPreviewNavigationProps, type WebPreviewProps, WebPreviewUrl, type WebPreviewUrlProps, highlightCode, usePromptInputAttachments, usePromptInputController, useProviderAttachments, useReasoning };
+export { Image as AIImage, Artifact, ArtifactAction, type ArtifactActionProps, ArtifactActions, type ArtifactActionsProps, ArtifactClose, type ArtifactCloseProps, ArtifactContent, type ArtifactContentProps, ArtifactDescription, type ArtifactDescriptionProps, ArtifactHeader, type ArtifactHeaderProps, type ArtifactProps, ArtifactTitle, type ArtifactTitleProps, type AttachmentsContext, Canvas, ChainOfThought, ChainOfThoughtContent, type ChainOfThoughtContentProps, ChainOfThoughtHeader, type ChainOfThoughtHeaderProps, ChainOfThoughtImage, type ChainOfThoughtImageProps, type ChainOfThoughtProps, ChainOfThoughtSearchResult, type ChainOfThoughtSearchResultProps, ChainOfThoughtSearchResults, type ChainOfThoughtSearchResultsProps, ChainOfThoughtStep, type ChainOfThoughtStepProps, Checkpoint, CheckpointIcon, type CheckpointIconProps, type CheckpointProps, CheckpointTrigger, type CheckpointTriggerProps, CodeBlock, CodeBlockCopyButton, type CodeBlockCopyButtonProps, ComponentRenderer, type ComponentRendererProps, Confirmation, ConfirmationAccepted, type ConfirmationAcceptedProps, ConfirmationAction, type ConfirmationActionProps, ConfirmationActions, type ConfirmationActionsProps, type ConfirmationProps, ConfirmationRejected, type ConfirmationRejectedProps, ConfirmationRequest, type ConfirmationRequestProps, ConfirmationTitle, type ConfirmationTitleProps, Connection, Context, ContextCacheUsage, type ContextCacheUsageProps, ContextContent, ContextContentBody, type ContextContentBodyProps, ContextContentFooter, type ContextContentFooterProps, ContextContentHeader, type ContextContentHeaderProps, type ContextContentProps, ContextInputUsage, type ContextInputUsageProps, ContextOutputUsage, type ContextOutputUsageProps, type ContextProps, ContextReasoningUsage, type ContextReasoningUsageProps, ContextTrigger, type ContextTriggerProps, Controls, type ControlsProps, Conversation, ConversationContent, type ConversationContentProps, ConversationEmptyState, type ConversationEmptyStateProps, type ConversationProps, ConversationScrollButton, type ConversationScrollButtonProps, Edge, FollowLatestTurn, FollowupButtons, InlineCitation, InlineCitationCard, InlineCitationCardBody, type InlineCitationCardBodyProps, type InlineCitationCardProps, InlineCitationCardTrigger, type InlineCitationCardTriggerProps, InlineCitationCarousel, InlineCitationCarouselContent, type InlineCitationCarouselContentProps, InlineCitationCarouselHeader, type InlineCitationCarouselHeaderProps, InlineCitationCarouselIndex, type InlineCitationCarouselIndexProps, InlineCitationCarouselItem, type InlineCitationCarouselItemProps, InlineCitationCarouselNext, type InlineCitationCarouselNextProps, InlineCitationCarouselPrev, type InlineCitationCarouselPrevProps, type InlineCitationCarouselProps, type InlineCitationProps, InlineCitationQuote, type InlineCitationQuoteProps, InlineCitationSource, type InlineCitationSourceProps, InlineCitationText, type InlineCitationTextProps, LATEST_TURN_ATTR, Loader, type LoaderProps, Message, MessageAction, type MessageActionProps, MessageActions, type MessageActionsProps, MessageAttachment, type MessageAttachmentProps, MessageAttachments, type MessageAttachmentsProps, MessageBranch, MessageBranchContent, type MessageBranchContentProps, MessageBranchNext, type MessageBranchNextProps, MessageBranchPage, type MessageBranchPageProps, MessageBranchPrevious, type MessageBranchPreviousProps, type MessageBranchProps, MessageBranchSelector, type MessageBranchSelectorProps, MessageContent, type MessageContentProps, type MessageProps, MessageResponse, type MessageResponseProps, MessageToolbar, type MessageToolbarProps, ModelSelector, ModelSelectorContent, type ModelSelectorContentProps, ModelSelectorDialog, type ModelSelectorDialogProps, ModelSelectorEmpty, type ModelSelectorEmptyProps, ModelSelectorGroup, type ModelSelectorGroupProps, ModelSelectorInput, type ModelSelectorInputProps, ModelSelectorItem, type ModelSelectorItemProps, ModelSelectorList, type ModelSelectorListProps, ModelSelectorLogo, ModelSelectorLogoGroup, type ModelSelectorLogoGroupProps, type ModelSelectorLogoProps, ModelSelectorName, type ModelSelectorNameProps, type ModelSelectorProps, ModelSelectorSeparator, type ModelSelectorSeparatorProps, ModelSelectorShortcut, type ModelSelectorShortcutProps, ModelSelectorTrigger, type ModelSelectorTriggerProps, Node, NodeAction, type NodeActionProps, NodeContent, type NodeContentProps, NodeDescription, type NodeDescriptionProps, NodeFooter, type NodeFooterProps, NodeHeader, type NodeHeaderProps, type NodeProps, NodeTitle, type NodeTitleProps, OpenIn, OpenInChatGPT, OpenInClaude, OpenInContent, type OpenInContentProps, OpenInCursor, OpenInItem, type OpenInItemProps, OpenInLabel, type OpenInLabelProps, type OpenInProps, OpenInScira, OpenInSeparator, type OpenInSeparatorProps, OpenInT3, OpenInTrigger, type OpenInTriggerProps, OpenInv0, Panel, Plan, PlanAction, type PlanActionProps, PlanContent, type PlanContentProps, PlanDescription, type PlanDescriptionProps, PlanFooter, type PlanFooterProps, PlanHeader, type PlanHeaderProps, type PlanProps, PlanTitle, type PlanTitleProps, PlanTrigger, type PlanTriggerProps, PromptInput, PromptInputActionAddAttachments, type PromptInputActionAddAttachmentsProps, PromptInputActionMenu, PromptInputActionMenuContent, type PromptInputActionMenuContentProps, PromptInputActionMenuItem, type PromptInputActionMenuItemProps, type PromptInputActionMenuProps, PromptInputActionMenuTrigger, type PromptInputActionMenuTriggerProps, PromptInputAttachment, type PromptInputAttachmentProps, PromptInputAttachments, type PromptInputAttachmentsProps, PromptInputBody, type PromptInputBodyProps, PromptInputButton, type PromptInputButtonProps, PromptInputCommand, PromptInputCommandEmpty, type PromptInputCommandEmptyProps, PromptInputCommandGroup, type PromptInputCommandGroupProps, PromptInputCommandInput, type PromptInputCommandInputProps, PromptInputCommandItem, type PromptInputCommandItemProps, PromptInputCommandList, type PromptInputCommandListProps, type PromptInputCommandProps, PromptInputCommandSeparator, type PromptInputCommandSeparatorProps, type PromptInputControllerProps, PromptInputFooter, type PromptInputFooterProps, PromptInputHeader, type PromptInputHeaderProps, PromptInputHoverCard, PromptInputHoverCardContent, type PromptInputHoverCardContentProps, type PromptInputHoverCardProps, PromptInputHoverCardTrigger, type PromptInputHoverCardTriggerProps, type PromptInputMessage, type PromptInputProps, PromptInputProvider, type PromptInputProviderProps, PromptInputSelect, PromptInputSelectContent, type PromptInputSelectContentProps, PromptInputSelectItem, type PromptInputSelectItemProps, type PromptInputSelectProps, PromptInputSelectTrigger, type PromptInputSelectTriggerProps, PromptInputSelectValue, type PromptInputSelectValueProps, PromptInputSpeechButton, type PromptInputSpeechButtonProps, PromptInputSubmit, type PromptInputSubmitProps, PromptInputTab, PromptInputTabBody, type PromptInputTabBodyProps, PromptInputTabItem, type PromptInputTabItemProps, PromptInputTabLabel, type PromptInputTabLabelProps, type PromptInputTabProps, PromptInputTabsList, type PromptInputTabsListProps, PromptInputTextarea, type PromptInputTextareaProps, PromptInputTools, type PromptInputToolsProps, Queue, QueueItem, QueueItemAction, type QueueItemActionProps, QueueItemActions, type QueueItemActionsProps, QueueItemAttachment, type QueueItemAttachmentProps, QueueItemContent, type QueueItemContentProps, QueueItemDescription, type QueueItemDescriptionProps, QueueItemFile, type QueueItemFileProps, QueueItemImage, type QueueItemImageProps, QueueItemIndicator, type QueueItemIndicatorProps, type QueueItemProps, QueueList, type QueueListProps, type QueueMessage, type QueueMessagePart, type QueueProps, QueueSection, QueueSectionContent, type QueueSectionContentProps, QueueSectionLabel, type QueueSectionLabelProps, type QueueSectionProps, QueueSectionTrigger, type QueueSectionTriggerProps, type QueueTodo, Reasoning, ReasoningContent, type ReasoningContentProps, type ReasoningProps, ReasoningTrigger, type ReasoningTriggerProps, Shimmer, Source, type SourceProps, Sources, SourcesContent, type SourcesContentProps, type SourcesProps, SourcesTrigger, type SourcesTriggerProps, SpinnerLoader, type SpinnerLoaderProps, Suggestion, type SuggestionProps, Suggestions, type SuggestionsProps, Task, TaskContent, type TaskContentProps, TaskItem, TaskItemFile, type TaskItemFileProps, type TaskItemProps, type TaskProps, TaskTrigger, type TaskTriggerProps, type TextInputContext, type TextShimmerProps, ThinkingSpinner, Tool, ToolContent, type ToolContentProps, ToolHeader, type ToolHeaderProps, ToolInput, type ToolInputProps, ToolOutput, type ToolOutputProps, type ToolProps, Toolbar, WebPreview, WebPreviewBody, type WebPreviewBodyProps, WebPreviewConsole, type WebPreviewConsoleProps, type WebPreviewContextValue, WebPreviewNavigation, WebPreviewNavigationButton, type WebPreviewNavigationButtonProps, type WebPreviewNavigationProps, type WebPreviewProps, WebPreviewUrl, type WebPreviewUrlProps, anchorToLatestTurn, highlightCode, usePromptInputAttachments, usePromptInputController, useProviderAttachments, useReasoning };

package/dist/ai-elements.js

@@ -1,6 +1,6 @@
 "use client";
 import { detectLanguage, LATIN } from './chunk-BYTPAQ7F.js';
-export { Conversation, ConversationContent, ConversationEmptyState, ConversationScrollButton, Loader, Message, MessageAction, MessageActions, MessageAttachment, MessageAttachments, MessageBranch, MessageBranchContent, MessageBranchNext, MessageBranchPage, MessageBranchPrevious, MessageBranchSelector, MessageContent, MessageFeedback, MessageResponse, MessageToolbar, Source, Sources, SourcesContent, SourcesTrigger, SpinnerLoader } from './chunk-CNGIOCLR.js';
+export { Conversation, ConversationContent, ConversationEmptyState, ConversationScrollButton, FollowLatestTurn, LATEST_TURN_ATTR, Loader, Message, MessageAction, MessageActions, MessageAttachment, MessageAttachments, MessageBranch, MessageBranchContent, MessageBranchNext, MessageBranchPage, MessageBranchPrevious, MessageBranchSelector, MessageContent, MessageFeedback, MessageResponse, MessageToolbar, Source, Sources, SourcesContent, SourcesTrigger, SpinnerLoader, anchorToLatestTurn } from './chunk-O5TPHZRP.js';
 import './chunk-MZQKGNWF.js';
 import './chunk-LDQVDUUJ.js';
 import { processImagesInHtml } from './chunk-PS3U7T37.js';

package/dist/{chunk-6CVBJ4EI.cjs → chunk-B277MAUK.cjs}

@@ -13,6 +13,29 @@ var classVarianceAuthority = require('class-variance-authority');
 var reactDom = require('react-dom');
 var streamdown = require('streamdown');
 
+var LATEST_TURN_ATTR = "data-ac-latest-turn";
+var LATEST_TURN_GAP_PX = 16;
+var SCROLL_KEYS = /* @__PURE__ */ new Set([
+  "ArrowUp",
+  "ArrowDown",
+  "PageUp",
+  "PageDown",
+  "Home",
+  "End",
+  " "
+]);
+var anchorToLatestTurn = (bottom, { scrollElement, contentElement }) => {
+  const anchorTop = latestTurnTop(scrollElement, contentElement);
+  if (anchorTop === null) return bottom;
+  return Math.min(bottom, Math.max(0, anchorTop - LATEST_TURN_GAP_PX));
+};
+function latestTurnTop(scrollElement, contentElement) {
+  const anchor = contentElement.querySelector(
+    `[${LATEST_TURN_ATTR}]`
+  );
+  if (!anchor) return null;
+  return anchor.getBoundingClientRect().top - scrollElement.getBoundingClientRect().top + scrollElement.scrollTop;
+}
 var Conversation = ({ className, ...props }) => /* @__PURE__ */ jsxRuntime.jsx(
   useStickToBottom.StickToBottom,
   {
@@ -23,6 +46,52 @@ var Conversation = ({ className, ...props }) => /* @__PURE__ */ jsxRuntime.jsx(
     ...props
   }
 );
+var FollowLatestTurn = ({ turnKey }) => {
+  const { scrollToBottom, scrollRef, contentRef, state } = useStickToBottom.useStickToBottomContext();
+  react.useEffect(() => {
+    if (!turnKey) return;
+    const frame = requestAnimationFrame(() => {
+      void scrollToBottom();
+    });
+    return () => cancelAnimationFrame(frame);
+  }, [turnKey, scrollToBottom]);
+  react.useEffect(() => {
+    const scroll = scrollRef.current;
+    const content = contentRef.current;
+    if (!turnKey || !scroll || !content) return;
+    let previous = latestTurnTop(scroll, content);
+    let steering = false;
+    const takeOver = () => {
+      steering = true;
+    };
+    const onKey = (event) => {
+      if (SCROLL_KEYS.has(event.key)) steering = true;
+    };
+    const observer = new ResizeObserver(() => {
+      const current = latestTurnTop(scroll, content);
+      if (!steering && previous !== null && current !== null) {
+        const shift = current - previous;
+        if (Math.abs(shift) > 1) {
+          state.scrollTop = Math.max(0, state.scrollTop + shift);
+        }
+      }
+      previous = current;
+    });
+    observer.observe(content);
+    scroll.addEventListener("wheel", takeOver, { passive: true });
+    scroll.addEventListener("touchmove", takeOver, { passive: true });
+    scroll.addEventListener("pointerdown", takeOver, { passive: true });
+    scroll.addEventListener("keydown", onKey);
+    return () => {
+      observer.disconnect();
+      scroll.removeEventListener("wheel", takeOver);
+      scroll.removeEventListener("touchmove", takeOver);
+      scroll.removeEventListener("pointerdown", takeOver);
+      scroll.removeEventListener("keydown", onKey);
+    };
+  }, [turnKey, scrollRef, contentRef, state]);
+  return null;
+};
 var ConversationContent = ({
   className,
   ...props
@@ -1099,6 +1168,8 @@ exports.Conversation = Conversation;
 exports.ConversationContent = ConversationContent;
 exports.ConversationEmptyState = ConversationEmptyState;
 exports.ConversationScrollButton = ConversationScrollButton;
+exports.FollowLatestTurn = FollowLatestTurn;
+exports.LATEST_TURN_ATTR = LATEST_TURN_ATTR;
 exports.Loader = Loader;
 exports.Message = Message;
 exports.MessageAction = MessageAction;
@@ -1120,5 +1191,6 @@ exports.Sources = Sources;
 exports.SourcesContent = SourcesContent;
 exports.SourcesTrigger = SourcesTrigger;
 exports.SpinnerLoader = SpinnerLoader;
-//# sourceMappingURL=chunk-6CVBJ4EI.cjs.map
-//# sourceMappingURL=chunk-6CVBJ4EI.cjs.map
+exports.anchorToLatestTurn = anchorToLatestTurn;
+//# sourceMappingURL=chunk-B277MAUK.cjs.map
+//# sourceMappingURL=chunk-B277MAUK.cjs.map