@assistant-ui/react 0.15.25 → 0.15.27

package/dist/primitives/thread/useThreadViewportAutoScroll.js

@@ -1,15 +1,25 @@
 "use client";
 import { useThreadViewportStore } from "../../context/react/ThreadViewportContext.js";
 import { writableStore } from "../../context/ReadonlyStore.js";
+import { useIsomorphicLayoutEffect } from "../../utils/useIsomorphicLayoutEffect.js";
 import { useOnScrollToBottom } from "../../utils/hooks/useOnScrollToBottom.js";
 import { useManagedRef } from "../../utils/hooks/useManagedRef.js";
 import { useOnResizeContent } from "../../utils/hooks/useOnResizeContent.js";
-import { useCallback, useLayoutEffect, useRef } from "@assistant-ui/tap/react-shim";
+import { useCallback, useRef } from "@assistant-ui/tap/react-shim";
 import { useAui, useAuiEvent, useAuiState } from "@assistant-ui/store";
 import { useComposedRefs } from "radix-ui/internal";
 import { isUserScrollUp, isViewportAtBottom, viewportOverflows } from "@assistant-ui/store/client";
 //#region src/primitives/thread/useThreadViewportAutoScroll.ts
-const ACTIVATION_KEYS = /* @__PURE__ */ new Set(["Enter", " "]);
+const SCROLL_KEYS = /* @__PURE__ */ new Set([
+	" ",
+	"ArrowUp",
+	"ArrowDown",
+	"PageUp",
+	"PageDown",
+	"Home",
+	"End"
+]);
+const INTENT_CANCEL_KEYS = /* @__PURE__ */ new Set(["Enter", ...SCROLL_KEYS]);
 const TEXT_ENTRY_SELECTOR = [
 	"textarea",
 	"select",
@@ -17,6 +27,13 @@ const TEXT_ENTRY_SELECTOR = [
 	"input:not([type='checkbox']):not([type='radio']):not([type='button']):not([type='submit']):not([type='reset']):not([type='image']):not([type='range']):not([type='file']):not([type='color'])"
 ].join(", ");
 const MESSAGE_SELECTOR = "[data-message-id]";
+const DISCLOSURE_SELECTOR = "[aria-expanded], summary";
+const isOpeningDisclosure = (target) => {
+	const control = target.closest(DISCLOSURE_SELECTOR);
+	if (!control) return false;
+	if (control.tagName === "SUMMARY") return control.parentElement?.hasAttribute("open") === false;
+	return control.getAttribute("aria-expanded") === "false" && (control.getAttribute("aria-haspopup") ?? "false") === "false" && control.getAttribute("role") !== "combobox";
+};
 const offsetInViewport = (element, viewport) => element.getBoundingClientRect().top - viewport.getBoundingClientRect().top;
 const measureFirstMessage = (viewport) => {
 	const element = viewport.querySelector(MESSAGE_SELECTOR);
@@ -88,8 +105,10 @@ const useThreadViewportAutoScroll = ({ autoScroll, scrollToBottomOnRunStart = tr
 	const heldScrollTopRef = useRef(0);
 	const scrollingToBottomBehaviorRef = useRef(null);
 	const followBottomRef = useRef(autoScroll);
+	const followPausedRef = useRef(false);
+	const scrolledSincePauseRef = useRef(false);
 	const previousAutoScrollRef = useRef(autoScroll);
-	useLayoutEffect(() => {
+	useIsomorphicLayoutEffect(() => {
 		const previousAutoScroll = previousAutoScrollRef.current;
 		previousAutoScrollRef.current = autoScroll;
 		if (previousAutoScroll || !autoScroll) return;
@@ -100,12 +119,15 @@ const useThreadViewportAutoScroll = ({ autoScroll, scrollToBottomOnRunStart = tr
 		const div_0 = divRef.current;
 		if (!div_0) return;
 		followBottomRef.current = true;
+		followPausedRef.current = false;
 		scrollingToBottomBehaviorRef.current = behavior;
 		prependAnchorRef.current = null;
 		div_0.scrollTo({
 			top: div_0.scrollHeight,
 			behavior
 		});
+		lastScrollTop.current = div_0.scrollTop;
+		lastScrollHeight.current = div_0.scrollHeight;
 	}, []);
 	const cancelScheduledFrame = useCallback(() => {
 		if (scheduledFrameRef.current === null) return;
@@ -120,24 +142,27 @@ const useThreadViewportAutoScroll = ({ autoScroll, scrollToBottomOnRunStart = tr
 			scrollToBottom(behavior_0);
 		});
 	}, [cancelScheduledFrame, scrollToBottom]);
-	useLayoutEffect(() => () => cancelScheduledFrame(), [cancelScheduledFrame]);
+	useIsomorphicLayoutEffect(() => () => cancelScheduledFrame(), [cancelScheduledFrame]);
 	const hasActiveTopAnchor = useCallback(() => {
 		const state = threadViewportStore.getState();
 		return state.turnAnchor === "top" && state.element.viewport === divRef.current && state.element.anchor !== null;
 	}, [threadViewportStore]);
-	const handleScroll = () => {
+	const onScroll = () => {
 		const div_1 = divRef.current;
 		if (!div_1) return;
 		if (prependAnchorRef.current && Math.abs(div_1.scrollTop - heldScrollTopRef.current) >= 1) prependAnchorRef.current = null;
 		const isAtBottom = threadViewportStore.getState().isAtBottom;
 		const newIsAtBottom = isViewportAtBottom(div_1);
-		if (!newIsAtBottom && lastScrollTop.current < div_1.scrollTop) {} else {
+		if (scrollingToBottomBehaviorRef.current !== null && !newIsAtBottom && lastScrollTop.current < div_1.scrollTop) {} else {
 			const userScrolledUp = isUserScrollUp({
 				scrollTop: lastScrollTop.current,
 				scrollHeight: lastScrollHeight.current
 			}, div_1);
 			if (newIsAtBottom) {
-				if (viewportOverflows(div_1)) scrollingToBottomBehaviorRef.current = null;
+				if (viewportOverflows(div_1)) {
+					scrollingToBottomBehaviorRef.current = null;
+					if (scrolledSincePauseRef.current) followPausedRef.current = false;
+				}
 				if (autoScroll) followBottomRef.current = true;
 			} else if (userScrolledUp) {
 				cancelScheduledFrame();
@@ -150,30 +175,58 @@ const useThreadViewportAutoScroll = ({ autoScroll, scrollToBottomOnRunStart = tr
 		lastScrollHeight.current = div_1.scrollHeight;
 		firstMessageRef.current = measureFirstMessage(div_1);
 	};
-	const resizeRef = useOnResizeContent(() => {
+	const onScrollRef = useRef(onScroll);
+	useIsomorphicLayoutEffect(() => {
+		onScrollRef.current = onScroll;
+	});
+	const handleScroll = useCallback(() => onScrollRef.current(), []);
+	const onResize = () => {
 		const div_2 = divRef.current;
 		if (!div_2) return;
 		const { scrollHeight, clientHeight } = div_2;
 		if (scrollHeight === lastObservedScrollHeight.current && clientHeight === lastObservedClientHeight.current) return;
 		lastObservedScrollHeight.current = scrollHeight;
 		lastObservedClientHeight.current = clientHeight;
-		const scrollBehavior = scrollingToBottomBehaviorRef.current;
-		if (scrollBehavior && hasActiveTopAnchor()) scrollingToBottomBehaviorRef.current = null;
-		else if (scrollBehavior) scrollToBottom(scrollBehavior);
-		else if (autoScroll && !(isRunning && hasActiveTopAnchor()) && followBottomRef.current) scrollToBottom("instant");
-		else if (prependAnchorRef.current && !keepMessageAt(div_2, prependAnchorRef.current, heldScrollTopRef)) prependAnchorRef.current = null;
+		if (scheduledFrameRef.current === null) {
+			const scrollBehavior = scrollingToBottomBehaviorRef.current;
+			if (scrollBehavior && hasActiveTopAnchor()) scrollingToBottomBehaviorRef.current = null;
+			else if (scrollBehavior) scrollToBottom(scrollBehavior);
+			else if (autoScroll && !(isRunning && hasActiveTopAnchor()) && followBottomRef.current && !followPausedRef.current) scrollToBottom("instant");
+			else if (prependAnchorRef.current && !keepMessageAt(div_2, prependAnchorRef.current, heldScrollTopRef)) prependAnchorRef.current = null;
+		}
 		handleScroll();
+	};
+	const onResizeRef = useRef(onResize);
+	useIsomorphicLayoutEffect(() => {
+		onResizeRef.current = onResize;
 	});
-	const scrollRef = useManagedRef((el) => {
+	const resizeRef = useOnResizeContent(() => onResizeRef.current());
+	const scrollRef = useManagedRef(useCallback((el) => {
 		const cancelPendingScrollToBottom = () => {
+			if (scrollingToBottomBehaviorRef.current === null && scheduledFrameRef.current === null) return;
 			cancelScheduledFrame();
 			scrollingToBottomBehaviorRef.current = null;
+			handleScroll();
 		};
 		const cancelOnKeyDown = (event) => {
-			if (!ACTIVATION_KEYS.has(event.key)) return;
+			if (!INTENT_CANCEL_KEYS.has(event.key)) return;
 			if (event.target?.closest?.(TEXT_ENTRY_SELECTOR)) return;
 			cancelPendingScrollToBottom();
 		};
+		const pauseFollowOnExpand = (event_0) => {
+			const target_0 = event_0.target;
+			if (!target_0?.closest?.(MESSAGE_SELECTOR) || target_0.closest(TEXT_ENTRY_SELECTOR) || !isOpeningDisclosure(target_0)) return;
+			followPausedRef.current = true;
+			scrolledSincePauseRef.current = false;
+			cancelPendingScrollToBottom();
+		};
+		const noteScrollGesture = (event_1) => {
+			if (event_1 instanceof KeyboardEvent) {
+				if (!SCROLL_KEYS.has(event_1.key)) return;
+				if (event_1.target?.closest?.(TEXT_ENTRY_SELECTOR)) return;
+			} else if (event_1.type === "pointerdown" && event_1.target !== el) return;
+			scrolledSincePauseRef.current = true;
+		};
 		const releasePrependAnchor = () => {
 			prependAnchorRef.current = null;
 		};
@@ -183,22 +236,36 @@ const useThreadViewportAutoScroll = ({ autoScroll, scrollToBottomOnRunStart = tr
 			"touchstart",
 			"keydown"
 		];
+		const resumeGestures = [
+			"pointerdown",
+			"wheel",
+			"touchmove",
+			"keydown"
+		];
 		el.addEventListener("scroll", handleScroll);
 		el.addEventListener("pointerdown", cancelPendingScrollToBottom);
+		el.addEventListener("wheel", cancelPendingScrollToBottom, { passive: true });
+		el.addEventListener("touchstart", cancelPendingScrollToBottom, { passive: true });
 		el.addEventListener("keydown", cancelOnKeyDown);
-		for (const gesture of gestures) el.addEventListener(gesture, releasePrependAnchor, { passive: true });
+		el.addEventListener("click", pauseFollowOnExpand, { capture: true });
+		for (const gesture of resumeGestures) el.addEventListener(gesture, noteScrollGesture, { passive: true });
+		for (const gesture_0 of gestures) el.addEventListener(gesture_0, releasePrependAnchor, { passive: true });
 		return () => {
 			el.removeEventListener("scroll", handleScroll);
 			el.removeEventListener("pointerdown", cancelPendingScrollToBottom);
+			el.removeEventListener("wheel", cancelPendingScrollToBottom);
+			el.removeEventListener("touchstart", cancelPendingScrollToBottom);
 			el.removeEventListener("keydown", cancelOnKeyDown);
-			for (const gesture_0 of gestures) el.removeEventListener(gesture_0, releasePrependAnchor);
+			el.removeEventListener("click", pauseFollowOnExpand, { capture: true });
+			for (const gesture_1 of resumeGestures) el.removeEventListener(gesture_1, noteScrollGesture);
+			for (const gesture_2 of gestures) el.removeEventListener(gesture_2, releasePrependAnchor);
 		};
-	});
+	}, [cancelScheduledFrame, handleScroll]));
 	const previousRef = useRef({
 		threadId,
 		firstMessageId
 	});
-	useLayoutEffect(() => {
+	useIsomorphicLayoutEffect(() => {
 		const previous = previousRef.current;
 		previousRef.current = {
 			threadId,
@@ -210,7 +277,7 @@ const useThreadViewportAutoScroll = ({ autoScroll, scrollToBottomOnRunStart = tr
 		}
 		const div_3 = divRef.current;
 		const previousFirstMessageId = previous.firstMessageId;
-		if (!div_3 || previousFirstMessageId === void 0 || previousFirstMessageId === firstMessageId || autoScroll && followBottomRef.current || scrollingToBottomBehaviorRef.current !== null) return;
+		if (!div_3 || previousFirstMessageId === void 0 || previousFirstMessageId === firstMessageId || autoScroll && followBottomRef.current && !followPausedRef.current || scrollingToBottomBehaviorRef.current !== null) return;
 		if (!aui.thread.getState().messages.some((message, index) => index > 0 && message.id === previousFirstMessageId)) return;
 		const anchor = firstMessageRef.current;
 		if (anchor?.id === previousFirstMessageId && keepMessageAt(div_3, anchor, heldScrollTopRef)) prependAnchorRef.current = measureReaderMessage(div_3) ?? anchor;
@@ -229,7 +296,7 @@ const useThreadViewportAutoScroll = ({ autoScroll, scrollToBottomOnRunStart = tr
 		firstMessageId,
 		threadId
 	]);
-	useLayoutEffect(() => {
+	useIsomorphicLayoutEffect(() => {
 		if (!scrollToBottomOnInitialize) return;
 		if (!hasMessages) {
 			initializeScrollRequestedRef.current = false;
@@ -249,11 +316,13 @@ const useThreadViewportAutoScroll = ({ autoScroll, scrollToBottomOnRunStart = tr
 	});
 	useAuiEvent("thread.runStart", () => {
 		prependAnchorRef.current = null;
+		followPausedRef.current = false;
 		if (!scrollToBottomOnRunStart) return;
 		if (threadViewportStore.getState().turnAnchor === "top") return;
 		scheduleScrollToBottom("auto");
 	});
 	useAuiEvent("threads.selectionChanged", () => {
+		followPausedRef.current = false;
 		if (!scrollToBottomOnThreadSwitch) return;
 		scheduleScrollToBottom("instant");
 	});

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

@@ -1 +1 @@
-{"version":3,"file":"useThreadViewportAutoScroll.js","names":["useComposedRefs","useCallback","useLayoutEffect","useRef","RefCallback","useAui","useAuiEvent","useAuiState","isUserScrollUp","isViewportAtBottom","viewportOverflows","useOnResizeContent","useOnScrollToBottom","useManagedRef","writableStore","useThreadViewportStore","ACTIVATION_KEYS","Set","TEXT_ENTRY_SELECTOR","join","MESSAGE_SELECTOR","MessageOffset","id","offset","offsetInViewport","element","Element","viewport","getBoundingClientRect","top","measureFirstMessage","HTMLElement","querySelector","dataset","measureReaderMessage","bottom","spanning","querySelectorAll","rect","findMessage","keepMessageAt","anchor","heldScrollTop","current","delta","scrollTop","Math","abs","scrollTo","behavior","useThreadViewportAutoScroll","Options","autoScroll","scrollToBottomOnRunStart","scrollToBottomOnInitialize","scrollToBottomOnThreadSwitch","TElement","aui","divRef","hasMessages","s","thread","messages","length","firstMessageId","threadId","threadListItem","isRunning","initializeScrollRequestedRef","scheduledFrameRef","threadViewportStore","undefined","getState","turnAnchor","lastScrollTop","lastScrollHeight","lastObservedScrollHeight","lastObservedClientHeight","firstMessageRef","prependAnchorRef","heldScrollTopRef","scrollingToBottomBehaviorRef","ScrollBehavior","followBottomRef","previousAutoScrollRef","previousAutoScroll","div","scrollToBottom","scrollHeight","cancelScheduledFrame","cancelAnimationFrame","scheduleScrollToBottom","requestAnimationFrame","hasActiveTopAnchor","state","handleScroll","isAtBottom","newIsAtBottom","isInFlightDownwardScroll","userScrolledUp","shouldUpdate","setState","resizeRef","clientHeight","scrollBehavior","scrollRef","el","cancelPendingScrollToBottom","cancelOnKeyDown","event","KeyboardEvent","has","key","target","closest","releasePrependAnchor","gestures","const","addEventListener","gesture","passive","removeEventListener","previousRef","previous","previousFirstMessageId","prepended","some","message","index","autoScrollRef"],"sources":["../../../src/primitives/thread/useThreadViewportAutoScroll.ts"],"sourcesContent":["\"use client\";\n\nimport { useComposedRefs } from \"radix-ui/internal\";\nimport { useCallback, useLayoutEffect, useRef, type RefCallback } from \"react\";\nimport { useAui, useAuiEvent, useAuiState } from \"@assistant-ui/store\";\nimport {\n  isUserScrollUp,\n  isViewportAtBottom,\n  viewportOverflows,\n} from \"@assistant-ui/store/client\";\nimport { useOnResizeContent } from \"../../utils/hooks/useOnResizeContent\";\nimport { useOnScrollToBottom } from \"../../utils/hooks/useOnScrollToBottom\";\nimport { useManagedRef } from \"../../utils/hooks/useManagedRef\";\nimport { writableStore } from \"../../context/ReadonlyStore\";\nimport { useThreadViewportStore } from \"../../context/react/ThreadViewportContext\";\n\n// Enter and Space activate a focused control, which is how a collapsible tool\n// call expands without a pointer event ever firing. No other key changes thread\n// content: the keys that scroll the viewport reach handleScroll, which already\n// clears the intent when the user scrolls up.\nconst ACTIVATION_KEYS = new Set([\"Enter\", \" \"]);\n\n// A control that consumes the activation key itself instead of acting on thread\n// content. `contenteditable=\"false\"` marks a non-editable island inside an\n// editable tree, so it is excluded the way ComposerRoot already excludes it;\n// the input types left out are the ones a key activates rather than fills.\nconst TEXT_ENTRY_SELECTOR = [\n  \"textarea\",\n  \"select\",\n  \"[contenteditable]:not([contenteditable='false'])\",\n  \"input:not([type='checkbox']):not([type='radio']):not([type='button'])\" +\n    \":not([type='submit']):not([type='reset']):not([type='image'])\" +\n    \":not([type='range']):not([type='file']):not([type='color'])\",\n].join(\", \");\n\nconst MESSAGE_SELECTOR = \"[data-message-id]\";\n\ntype MessageOffset = { readonly id: string; readonly offset: number };\n\nconst offsetInViewport = (element: Element, viewport: Element) =>\n  element.getBoundingClientRect().top - viewport.getBoundingClientRect().top;\n\nconst measureFirstMessage = (viewport: HTMLElement): MessageOffset | null => {\n  const element = viewport.querySelector<HTMLElement>(MESSAGE_SELECTOR);\n  const id = element?.dataset[\"messageId\"];\n  return element && id\n    ? { id, offset: offsetInViewport(element, viewport) }\n    : null;\n};\n\n/** The first message that starts in view, else the one spanning its top edge. */\nconst measureReaderMessage = (viewport: HTMLElement): MessageOffset | null => {\n  const { top, bottom } = viewport.getBoundingClientRect();\n  let spanning: MessageOffset | null = null;\n  for (const element of viewport.querySelectorAll<HTMLElement>(\n    MESSAGE_SELECTOR,\n  )) {\n    const rect = element.getBoundingClientRect();\n    if (rect.bottom <= top) continue;\n    if (rect.top >= bottom) break;\n    const id = element.dataset[\"messageId\"];\n    if (!id) continue;\n    if (rect.top >= top) return { id, offset: rect.top - top };\n    spanning ??= { id, offset: rect.top - top };\n  }\n  return spanning;\n};\n\nconst findMessage = (viewport: HTMLElement, id: string) => {\n  for (const element of viewport.querySelectorAll<HTMLElement>(\n    MESSAGE_SELECTOR,\n  )) {\n    if (element.dataset[\"messageId\"] === id) return element;\n  }\n  return null;\n};\n\n/**\n * Scrolls so the message sits at `anchor.offset` again, recording the\n * position it scrolls to in `heldScrollTop` before the scroll event can\n * report it; false when the message is gone.\n */\nconst keepMessageAt = (\n  viewport: HTMLElement,\n  anchor: MessageOffset,\n  heldScrollTop: { current: number },\n) => {\n  const element = findMessage(viewport, anchor.id);\n  if (!element) return false;\n  const delta = offsetInViewport(element, viewport) - anchor.offset;\n  heldScrollTop.current = viewport.scrollTop + delta;\n  if (Math.abs(delta) >= 1) {\n    viewport.scrollTo({ top: heldScrollTop.current, behavior: \"instant\" });\n  }\n  heldScrollTop.current = viewport.scrollTop;\n  return true;\n};\n\nexport namespace useThreadViewportAutoScroll {\n  export type Options = {\n    /**\n     * Whether to automatically scroll to the bottom when new messages are added.\n     * When enabled, the viewport will automatically scroll to show the latest content.\n     *\n     * Default false if `turnAnchor` is \"top\", otherwise defaults to true.\n     */\n    autoScroll?: boolean | undefined;\n\n    /**\n     * Whether to scroll to bottom when a new run starts.\n     *\n     * Defaults to true.\n     */\n    scrollToBottomOnRunStart?: boolean | undefined;\n\n    /**\n     * Whether to scroll to bottom when messages first appear in the thread.\n     *\n     * Defaults to true.\n     */\n    scrollToBottomOnInitialize?: boolean | undefined;\n\n    /**\n     * Whether to scroll to bottom when switching to a different thread.\n     *\n     * Defaults to true.\n     */\n    scrollToBottomOnThreadSwitch?: boolean | undefined;\n  };\n}\n\nexport const useThreadViewportAutoScroll = <TElement extends HTMLElement>({\n  autoScroll,\n  scrollToBottomOnRunStart = true,\n  scrollToBottomOnInitialize = true,\n  scrollToBottomOnThreadSwitch = true,\n}: useThreadViewportAutoScroll.Options): RefCallback<TElement> => {\n  const aui = useAui();\n  const divRef = useRef<TElement>(null);\n  const hasMessages = useAuiState((s) => s.thread.messages.length > 0);\n  const firstMessageId = useAuiState((s) => s.thread.messages[0]?.id);\n  const threadId = useAuiState((s) => s.threadListItem.id);\n  const isRunning = useAuiState((s) => s.thread.isRunning);\n  const initializeScrollRequestedRef = useRef(false);\n  const scheduledFrameRef = useRef<number | null>(null);\n\n  const threadViewportStore = useThreadViewportStore();\n  if (autoScroll === undefined) {\n    autoScroll = threadViewportStore.getState().turnAnchor !== \"top\";\n  }\n\n  const lastScrollTop = useRef<number>(0);\n  const lastScrollHeight = useRef<number>(0);\n  const lastObservedScrollHeight = useRef<number>(0);\n  const lastObservedClientHeight = useRef<number>(0);\n  const firstMessageRef = useRef<MessageOffset | null>(null);\n  // The row the reader sees when earlier messages land, held until a gesture\n  // or a scroll this hook did not make, so content above it that settles\n  // afterwards (lazy layout, late media) does not move it on engines without\n  // native scroll anchoring.\n  const prependAnchorRef = useRef<MessageOffset | null>(null);\n  const heldScrollTopRef = useRef(0);\n\n  // Pending bottom-scroll intent. Planted by initialize/run-start/switch/button\n  // triggers, cleared when handleScroll confirms we reached bottom, or when the\n  // user actively scrolls up while content size is stable.\n  const scrollingToBottomBehaviorRef = useRef<ScrollBehavior | null>(null);\n  const followBottomRef = useRef(autoScroll);\n  const previousAutoScrollRef = useRef(autoScroll);\n\n  useLayoutEffect(() => {\n    const previousAutoScroll = previousAutoScrollRef.current;\n    previousAutoScrollRef.current = autoScroll;\n    if (previousAutoScroll || !autoScroll) return;\n\n    const div = divRef.current;\n    followBottomRef.current = div !== null && isViewportAtBottom(div);\n  }, [autoScroll]);\n\n  const scrollToBottom = useCallback((behavior: ScrollBehavior) => {\n    const div = divRef.current;\n    if (!div) return;\n\n    followBottomRef.current = true;\n    scrollingToBottomBehaviorRef.current = behavior;\n    prependAnchorRef.current = null;\n    div.scrollTo({ top: div.scrollHeight, behavior });\n  }, []);\n\n  const cancelScheduledFrame = useCallback(() => {\n    if (scheduledFrameRef.current === null) return;\n    cancelAnimationFrame(scheduledFrameRef.current);\n    scheduledFrameRef.current = null;\n  }, []);\n\n  const scheduleScrollToBottom = useCallback(\n    (behavior: ScrollBehavior) => {\n      scrollingToBottomBehaviorRef.current = behavior;\n      cancelScheduledFrame();\n      scheduledFrameRef.current = requestAnimationFrame(() => {\n        scheduledFrameRef.current = null;\n        scrollToBottom(behavior);\n      });\n    },\n    [cancelScheduledFrame, scrollToBottom],\n  );\n\n  useLayoutEffect(() => () => cancelScheduledFrame(), [cancelScheduledFrame]);\n\n  const hasActiveTopAnchor = useCallback(() => {\n    const state = threadViewportStore.getState();\n    return (\n      state.turnAnchor === \"top\" &&\n      state.element.viewport === divRef.current &&\n      state.element.anchor !== null\n    );\n  }, [threadViewportStore]);\n\n  const handleScroll = () => {\n    const div = divRef.current;\n    if (!div) return;\n\n    if (\n      prependAnchorRef.current &&\n      Math.abs(div.scrollTop - heldScrollTopRef.current) >= 1\n    ) {\n      prependAnchorRef.current = null;\n    }\n\n    const isAtBottom = threadViewportStore.getState().isAtBottom;\n    const newIsAtBottom = isViewportAtBottom(div);\n\n    const isInFlightDownwardScroll =\n      !newIsAtBottom && lastScrollTop.current < div.scrollTop;\n    if (isInFlightDownwardScroll) {\n      // no-op: a smooth scroll-to-bottom fires many midpoint scroll events\n      // before landing, don't flicker isAtBottom or clear intent mid-animation\n    } else {\n      const userScrolledUp = isUserScrollUp(\n        {\n          scrollTop: lastScrollTop.current,\n          scrollHeight: lastScrollHeight.current,\n        },\n        div,\n      );\n\n      if (newIsAtBottom) {\n        // newIsAtBottom is ambiguous when the viewport doesn't overflow —\n        // keep intent alive until content can actually scroll\n        if (viewportOverflows(div)) {\n          scrollingToBottomBehaviorRef.current = null;\n        }\n        if (autoScroll) followBottomRef.current = true;\n      } else if (userScrolledUp) {\n        cancelScheduledFrame();\n        scrollingToBottomBehaviorRef.current = null;\n        followBottomRef.current = false;\n      }\n\n      const shouldUpdate =\n        newIsAtBottom || scrollingToBottomBehaviorRef.current === null;\n\n      if (shouldUpdate && newIsAtBottom !== isAtBottom) {\n        writableStore(threadViewportStore).setState({\n          isAtBottom: newIsAtBottom,\n        });\n      }\n    }\n\n    lastScrollTop.current = div.scrollTop;\n    lastScrollHeight.current = div.scrollHeight;\n    firstMessageRef.current = measureFirstMessage(div);\n  };\n\n  const resizeRef = useOnResizeContent(() => {\n    const div = divRef.current;\n    if (!div) return;\n\n    const { scrollHeight, clientHeight } = div;\n    if (\n      scrollHeight === lastObservedScrollHeight.current &&\n      clientHeight === lastObservedClientHeight.current\n    ) {\n      return;\n    }\n    lastObservedScrollHeight.current = scrollHeight;\n    lastObservedClientHeight.current = clientHeight;\n\n    const scrollBehavior = scrollingToBottomBehaviorRef.current;\n    if (scrollBehavior && hasActiveTopAnchor()) {\n      // Let the top-anchor reserve own scrolling while a run starts to avoid a bottom-scroll race.\n      scrollingToBottomBehaviorRef.current = null;\n    } else if (scrollBehavior) {\n      scrollToBottom(scrollBehavior);\n    } else if (\n      autoScroll &&\n      !(isRunning && hasActiveTopAnchor()) &&\n      followBottomRef.current\n    ) {\n      scrollToBottom(\"instant\");\n    } else if (\n      prependAnchorRef.current &&\n      !keepMessageAt(div, prependAnchorRef.current, heldScrollTopRef)\n    ) {\n      prependAnchorRef.current = null;\n    }\n\n    handleScroll();\n  });\n\n  const scrollRef = useManagedRef<HTMLElement>((el) => {\n    // A user gesture invalidates pending bottom-scroll intent; otherwise an\n    // intent kept alive by a non-overflowing thread (see handleScroll) hijacks\n    // the next content growth, e.g. expanding a collapsible tool call. Keyboard\n    // activation reaches that same content without ever emitting a pointer\n    // event, so it has to cancel the intent too.\n    const cancelPendingScrollToBottom = () => {\n      // A scheduled frame re-plants the intent when it runs, so clearing the\n      // ref alone leaves the gesture undone.\n      cancelScheduledFrame();\n      scrollingToBottomBehaviorRef.current = null;\n    };\n    // The composer renders inside the viewport, so its keystrokes bubble here;\n    // only an activation key aimed at something other than a text field is a\n    // gesture on thread content.\n    const cancelOnKeyDown = (event: KeyboardEvent) => {\n      if (!ACTIVATION_KEYS.has(event.key)) return;\n      const target = event.target as Element | null;\n      if (target?.closest?.(TEXT_ENTRY_SELECTOR)) return;\n      cancelPendingScrollToBottom();\n    };\n    const releasePrependAnchor = () => {\n      prependAnchorRef.current = null;\n    };\n    const gestures = [\"pointerdown\", \"wheel\", \"touchstart\", \"keydown\"] as const;\n    el.addEventListener(\"scroll\", handleScroll);\n    el.addEventListener(\"pointerdown\", cancelPendingScrollToBottom);\n    el.addEventListener(\"keydown\", cancelOnKeyDown);\n    for (const gesture of gestures) {\n      el.addEventListener(gesture, releasePrependAnchor, { passive: true });\n    }\n    return () => {\n      el.removeEventListener(\"scroll\", handleScroll);\n      el.removeEventListener(\"pointerdown\", cancelPendingScrollToBottom);\n      el.removeEventListener(\"keydown\", cancelOnKeyDown);\n      for (const gesture of gestures) {\n        el.removeEventListener(gesture, releasePrependAnchor);\n      }\n    };\n  });\n\n  // Earlier messages prepended above the reader put the old first message back\n  // where the reader saw it, so growth below it in the same commit (a\n  // streaming reply) is not mistaken for the page; where the browser already\n  // anchored the scroll, this is a no-op.\n  const previousRef = useRef({ threadId, firstMessageId });\n  useLayoutEffect(() => {\n    const previous = previousRef.current;\n    previousRef.current = { threadId, firstMessageId };\n    if (previous.threadId !== threadId) {\n      prependAnchorRef.current = null;\n      return;\n    }\n    const div = divRef.current;\n    const previousFirstMessageId = previous.firstMessageId;\n    if (\n      !div ||\n      previousFirstMessageId === undefined ||\n      previousFirstMessageId === firstMessageId ||\n      (autoScroll && followBottomRef.current) ||\n      scrollingToBottomBehaviorRef.current !== null\n    )\n      return;\n    const prepended = aui.thread\n      .getState()\n      .messages.some(\n        (message, index) => index > 0 && message.id === previousFirstMessageId,\n      );\n    if (!prepended) return;\n\n    const anchor = firstMessageRef.current;\n    if (\n      anchor?.id === previousFirstMessageId &&\n      keepMessageAt(div, anchor, heldScrollTopRef)\n    ) {\n      prependAnchorRef.current = measureReaderMessage(div) ?? anchor;\n    } else {\n      // Message roots that render no `data-message-id` leave only the total\n      // growth to go on, which counts any growth below the reader too.\n      const top =\n        div.scrollHeight - (lastScrollHeight.current - lastScrollTop.current);\n      if (Math.abs(div.scrollTop - top) >= 1) {\n        div.scrollTo({ top, behavior: \"instant\" });\n      }\n    }\n    lastScrollTop.current = div.scrollTop;\n    lastScrollHeight.current = div.scrollHeight;\n  }, [aui, autoScroll, firstMessageId, threadId]);\n\n  useLayoutEffect(() => {\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    // defer to an in-flight run (e.g. first message on a new thread) that\n    // already planted intent — otherwise we'd downgrade its \"auto\" to \"instant\"\n    if (scrollingToBottomBehaviorRef.current !== null) return;\n    scheduleScrollToBottom(\"instant\");\n  }, [hasMessages, scheduleScrollToBottom, scrollToBottomOnInitialize]);\n\n  useOnScrollToBottom(({ behavior }) => {\n    scrollToBottom(behavior);\n  });\n\n  useAuiEvent(\"thread.runStart\", () => {\n    prependAnchorRef.current = null;\n    if (!scrollToBottomOnRunStart) return;\n    if (threadViewportStore.getState().turnAnchor === \"top\") return;\n    scheduleScrollToBottom(\"auto\");\n  });\n\n  useAuiEvent(\"threads.selectionChanged\", () => {\n    if (!scrollToBottomOnThreadSwitch) return;\n    scheduleScrollToBottom(\"instant\");\n  });\n\n  const autoScrollRef = useComposedRefs<TElement>(resizeRef, scrollRef, divRef);\n  return autoScrollRef as RefCallback<TElement>;\n};\n"],"mappings":"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"}
+{"version":3,"file":"useThreadViewportAutoScroll.js","names":["useComposedRefs","useCallback","useRef","RefCallback","useAui","useAuiEvent","useAuiState","isUserScrollUp","isViewportAtBottom","viewportOverflows","useOnResizeContent","useOnScrollToBottom","useManagedRef","writableStore","useThreadViewportStore","useIsomorphicLayoutEffect","SCROLL_KEYS","Set","INTENT_CANCEL_KEYS","TEXT_ENTRY_SELECTOR","join","MESSAGE_SELECTOR","DISCLOSURE_SELECTOR","isOpeningDisclosure","target","Element","control","closest","tagName","parentElement","hasAttribute","getAttribute","MessageOffset","id","offset","offsetInViewport","element","viewport","getBoundingClientRect","top","measureFirstMessage","HTMLElement","querySelector","dataset","measureReaderMessage","bottom","spanning","querySelectorAll","rect","findMessage","keepMessageAt","anchor","heldScrollTop","current","delta","scrollTop","Math","abs","scrollTo","behavior","useThreadViewportAutoScroll","Options","autoScroll","scrollToBottomOnRunStart","scrollToBottomOnInitialize","scrollToBottomOnThreadSwitch","TElement","aui","divRef","hasMessages","s","thread","messages","length","firstMessageId","threadId","threadListItem","isRunning","initializeScrollRequestedRef","scheduledFrameRef","threadViewportStore","undefined","getState","turnAnchor","lastScrollTop","lastScrollHeight","lastObservedScrollHeight","lastObservedClientHeight","firstMessageRef","prependAnchorRef","heldScrollTopRef","scrollingToBottomBehaviorRef","ScrollBehavior","followBottomRef","followPausedRef","scrolledSincePauseRef","previousAutoScrollRef","previousAutoScroll","div","scrollToBottom","scrollHeight","cancelScheduledFrame","cancelAnimationFrame","scheduleScrollToBottom","requestAnimationFrame","hasActiveTopAnchor","state","onScroll","isAtBottom","newIsAtBottom","isInFlightDownwardScroll","userScrolledUp","shouldUpdate","setState","onScrollRef","handleScroll","onResize","clientHeight","scrollBehavior","onResizeRef","resizeRef","scrollRef","el","cancelPendingScrollToBottom","cancelOnKeyDown","event","KeyboardEvent","has","key","pauseFollowOnExpand","MouseEvent","noteScrollGesture","Event","type","releasePrependAnchor","gestures","const","resumeGestures","addEventListener","passive","capture","gesture","removeEventListener","previousRef","previous","previousFirstMessageId","prepended","some","message","index","autoScrollRef"],"sources":["../../../src/primitives/thread/useThreadViewportAutoScroll.ts"],"sourcesContent":["\"use client\";\n\nimport { useComposedRefs } from \"radix-ui/internal\";\nimport { useCallback, useRef, type RefCallback } from \"react\";\nimport { useAui, useAuiEvent, useAuiState } from \"@assistant-ui/store\";\nimport {\n  isUserScrollUp,\n  isViewportAtBottom,\n  viewportOverflows,\n} from \"@assistant-ui/store/client\";\nimport { useOnResizeContent } from \"../../utils/hooks/useOnResizeContent\";\nimport { useOnScrollToBottom } from \"../../utils/hooks/useOnScrollToBottom\";\nimport { useManagedRef } from \"../../utils/hooks/useManagedRef\";\nimport { writableStore } from \"../../context/ReadonlyStore\";\nimport { useThreadViewportStore } from \"../../context/react/ThreadViewportContext\";\nimport { useIsomorphicLayoutEffect } from \"../../utils/useIsomorphicLayoutEffect\";\n\nconst SCROLL_KEYS = new Set([\n  \" \",\n  \"ArrowUp\",\n  \"ArrowDown\",\n  \"PageUp\",\n  \"PageDown\",\n  \"Home\",\n  \"End\",\n]);\n\n// Enter and Space activate focused controls, while navigation keys can\n// interrupt scrolling without producing a scroll event.\nconst INTENT_CANCEL_KEYS = new Set([\"Enter\", ...SCROLL_KEYS]);\n\n// A control that consumes the activation key itself instead of acting on thread\n// content. `contenteditable=\"false\"` marks a non-editable island inside an\n// editable tree, so it is excluded the way ComposerRoot already excludes it;\n// the input types left out are the ones a key activates rather than fills.\nconst TEXT_ENTRY_SELECTOR = [\n  \"textarea\",\n  \"select\",\n  \"[contenteditable]:not([contenteditable='false'])\",\n  \"input:not([type='checkbox']):not([type='radio']):not([type='button'])\" +\n    \":not([type='submit']):not([type='reset']):not([type='image'])\" +\n    \":not([type='range']):not([type='file']):not([type='color'])\",\n].join(\", \");\n\nconst MESSAGE_SELECTOR = \"[data-message-id]\";\n\nconst DISCLOSURE_SELECTOR = \"[aria-expanded], summary\";\n\n// A popup trigger (menu, dialog, listbox) also carries aria-expanded, but what\n// it opens is portaled away from the thread, so only disclosures count.\nconst isOpeningDisclosure = (target: Element): boolean => {\n  const control = target.closest(DISCLOSURE_SELECTOR);\n  if (!control) return false;\n  if (control.tagName === \"SUMMARY\")\n    return control.parentElement?.hasAttribute(\"open\") === false;\n  return (\n    control.getAttribute(\"aria-expanded\") === \"false\" &&\n    (control.getAttribute(\"aria-haspopup\") ?? \"false\") === \"false\" &&\n    control.getAttribute(\"role\") !== \"combobox\"\n  );\n};\n\ntype MessageOffset = { readonly id: string; readonly offset: number };\n\nconst offsetInViewport = (element: Element, viewport: Element) =>\n  element.getBoundingClientRect().top - viewport.getBoundingClientRect().top;\n\nconst measureFirstMessage = (viewport: HTMLElement): MessageOffset | null => {\n  const element = viewport.querySelector<HTMLElement>(MESSAGE_SELECTOR);\n  const id = element?.dataset[\"messageId\"];\n  return element && id\n    ? { id, offset: offsetInViewport(element, viewport) }\n    : null;\n};\n\n/** The first message that starts in view, else the one spanning its top edge. */\nconst measureReaderMessage = (viewport: HTMLElement): MessageOffset | null => {\n  const { top, bottom } = viewport.getBoundingClientRect();\n  let spanning: MessageOffset | null = null;\n  for (const element of viewport.querySelectorAll<HTMLElement>(\n    MESSAGE_SELECTOR,\n  )) {\n    const rect = element.getBoundingClientRect();\n    if (rect.bottom <= top) continue;\n    if (rect.top >= bottom) break;\n    const id = element.dataset[\"messageId\"];\n    if (!id) continue;\n    if (rect.top >= top) return { id, offset: rect.top - top };\n    spanning ??= { id, offset: rect.top - top };\n  }\n  return spanning;\n};\n\nconst findMessage = (viewport: HTMLElement, id: string) => {\n  for (const element of viewport.querySelectorAll<HTMLElement>(\n    MESSAGE_SELECTOR,\n  )) {\n    if (element.dataset[\"messageId\"] === id) return element;\n  }\n  return null;\n};\n\n/**\n * Scrolls so the message sits at `anchor.offset` again, recording the\n * position it scrolls to in `heldScrollTop` before the scroll event can\n * report it; false when the message is gone.\n */\nconst keepMessageAt = (\n  viewport: HTMLElement,\n  anchor: MessageOffset,\n  heldScrollTop: { current: number },\n) => {\n  const element = findMessage(viewport, anchor.id);\n  if (!element) return false;\n  const delta = offsetInViewport(element, viewport) - anchor.offset;\n  heldScrollTop.current = viewport.scrollTop + delta;\n  if (Math.abs(delta) >= 1) {\n    viewport.scrollTo({ top: heldScrollTop.current, behavior: \"instant\" });\n  }\n  heldScrollTop.current = viewport.scrollTop;\n  return true;\n};\n\nexport namespace useThreadViewportAutoScroll {\n  export type Options = {\n    /**\n     * Whether to automatically scroll to the bottom when new messages are added.\n     * When enabled, the viewport will automatically scroll to show the latest content.\n     *\n     * Default false if `turnAnchor` is \"top\", otherwise defaults to true.\n     */\n    autoScroll?: boolean | undefined;\n\n    /**\n     * Whether to scroll to bottom when a new run starts.\n     *\n     * Defaults to true.\n     */\n    scrollToBottomOnRunStart?: boolean | undefined;\n\n    /**\n     * Whether to scroll to bottom when messages first appear in the thread.\n     *\n     * Defaults to true.\n     */\n    scrollToBottomOnInitialize?: boolean | undefined;\n\n    /**\n     * Whether to scroll to bottom when switching to a different thread.\n     *\n     * Defaults to true.\n     */\n    scrollToBottomOnThreadSwitch?: boolean | undefined;\n  };\n}\n\nexport const useThreadViewportAutoScroll = <TElement extends HTMLElement>({\n  autoScroll,\n  scrollToBottomOnRunStart = true,\n  scrollToBottomOnInitialize = true,\n  scrollToBottomOnThreadSwitch = true,\n}: useThreadViewportAutoScroll.Options): RefCallback<TElement> => {\n  const aui = useAui();\n  const divRef = useRef<TElement>(null);\n  const hasMessages = useAuiState((s) => s.thread.messages.length > 0);\n  const firstMessageId = useAuiState((s) => s.thread.messages[0]?.id);\n  const threadId = useAuiState((s) => s.threadListItem.id);\n  const isRunning = useAuiState((s) => s.thread.isRunning);\n  const initializeScrollRequestedRef = useRef(false);\n  const scheduledFrameRef = useRef<number | null>(null);\n\n  const threadViewportStore = useThreadViewportStore();\n  if (autoScroll === undefined) {\n    autoScroll = threadViewportStore.getState().turnAnchor !== \"top\";\n  }\n\n  const lastScrollTop = useRef<number>(0);\n  const lastScrollHeight = useRef<number>(0);\n  const lastObservedScrollHeight = useRef<number>(0);\n  const lastObservedClientHeight = useRef<number>(0);\n  const firstMessageRef = useRef<MessageOffset | null>(null);\n  // The row the reader sees when earlier messages land, held until a gesture\n  // or a scroll this hook did not make, so content above it that settles\n  // afterwards (lazy layout, late media) does not move it on engines without\n  // native scroll anchoring.\n  const prependAnchorRef = useRef<MessageOffset | null>(null);\n  const heldScrollTopRef = useRef(0);\n\n  // Pending bottom-scroll intent. Planted by initialize/run-start/switch/button\n  // triggers, cleared when handleScroll confirms we reached bottom, or when the\n  // user actively scrolls up while content size is stable.\n  const scrollingToBottomBehaviorRef = useRef<ScrollBehavior | null>(null);\n  const followBottomRef = useRef(autoScroll);\n  // Set by expanding a disclosure; suspends follow without clearing its intent\n  // until a scroll gesture reaches an overflowing bottom (content that fits\n  // reads as at the bottom), a run starts, the thread changes, or the reader\n  // asks for the bottom again.\n  const followPausedRef = useRef(false);\n  const scrolledSincePauseRef = useRef(false);\n  const previousAutoScrollRef = useRef(autoScroll);\n\n  useIsomorphicLayoutEffect(() => {\n    const previousAutoScroll = previousAutoScrollRef.current;\n    previousAutoScrollRef.current = autoScroll;\n    if (previousAutoScroll || !autoScroll) return;\n\n    const div = divRef.current;\n    followBottomRef.current = div !== null && isViewportAtBottom(div);\n  }, [autoScroll]);\n\n  const scrollToBottom = useCallback((behavior: ScrollBehavior) => {\n    const div = divRef.current;\n    if (!div) return;\n\n    followBottomRef.current = true;\n    followPausedRef.current = false;\n    scrollingToBottomBehaviorRef.current = behavior;\n    prependAnchorRef.current = null;\n    div.scrollTo({ top: div.scrollHeight, behavior });\n    lastScrollTop.current = div.scrollTop;\n    lastScrollHeight.current = div.scrollHeight;\n  }, []);\n\n  const cancelScheduledFrame = useCallback(() => {\n    if (scheduledFrameRef.current === null) return;\n    cancelAnimationFrame(scheduledFrameRef.current);\n    scheduledFrameRef.current = null;\n  }, []);\n\n  const scheduleScrollToBottom = useCallback(\n    (behavior: ScrollBehavior) => {\n      scrollingToBottomBehaviorRef.current = behavior;\n      cancelScheduledFrame();\n      scheduledFrameRef.current = requestAnimationFrame(() => {\n        scheduledFrameRef.current = null;\n        scrollToBottom(behavior);\n      });\n    },\n    [cancelScheduledFrame, scrollToBottom],\n  );\n\n  useIsomorphicLayoutEffect(\n    () => () => cancelScheduledFrame(),\n    [cancelScheduledFrame],\n  );\n\n  const hasActiveTopAnchor = useCallback(() => {\n    const state = threadViewportStore.getState();\n    return (\n      state.turnAnchor === \"top\" &&\n      state.element.viewport === divRef.current &&\n      state.element.anchor !== null\n    );\n  }, [threadViewportStore]);\n\n  const onScroll = () => {\n    const div = divRef.current;\n    if (!div) return;\n\n    if (\n      prependAnchorRef.current &&\n      Math.abs(div.scrollTop - heldScrollTopRef.current) >= 1\n    ) {\n      prependAnchorRef.current = null;\n    }\n\n    const isAtBottom = threadViewportStore.getState().isAtBottom;\n    const newIsAtBottom = isViewportAtBottom(div);\n\n    const isInFlightDownwardScroll =\n      scrollingToBottomBehaviorRef.current !== null &&\n      !newIsAtBottom &&\n      lastScrollTop.current < div.scrollTop;\n    if (isInFlightDownwardScroll) {\n      // no-op: a smooth scroll-to-bottom fires many midpoint scroll events\n      // before landing, don't flicker isAtBottom or clear intent mid-animation\n    } else {\n      const userScrolledUp = isUserScrollUp(\n        {\n          scrollTop: lastScrollTop.current,\n          scrollHeight: lastScrollHeight.current,\n        },\n        div,\n      );\n\n      if (newIsAtBottom) {\n        // newIsAtBottom is ambiguous when the viewport doesn't overflow —\n        // keep intent alive until content can actually scroll\n        if (viewportOverflows(div)) {\n          scrollingToBottomBehaviorRef.current = null;\n          if (scrolledSincePauseRef.current) followPausedRef.current = false;\n        }\n        if (autoScroll) followBottomRef.current = true;\n      } else if (userScrolledUp) {\n        cancelScheduledFrame();\n        scrollingToBottomBehaviorRef.current = null;\n        followBottomRef.current = false;\n      }\n\n      const shouldUpdate =\n        newIsAtBottom || scrollingToBottomBehaviorRef.current === null;\n\n      if (shouldUpdate && newIsAtBottom !== isAtBottom) {\n        writableStore(threadViewportStore).setState({\n          isAtBottom: newIsAtBottom,\n        });\n      }\n    }\n\n    lastScrollTop.current = div.scrollTop;\n    lastScrollHeight.current = div.scrollHeight;\n    firstMessageRef.current = measureFirstMessage(div);\n  };\n  const onScrollRef = useRef(onScroll);\n  useIsomorphicLayoutEffect(() => {\n    onScrollRef.current = onScroll;\n  });\n  const handleScroll = useCallback(() => onScrollRef.current(), []);\n\n  const onResize = () => {\n    const div = divRef.current;\n    if (!div) return;\n\n    const { scrollHeight, clientHeight } = div;\n    if (\n      scrollHeight === lastObservedScrollHeight.current &&\n      clientHeight === lastObservedClientHeight.current\n    ) {\n      return;\n    }\n    lastObservedScrollHeight.current = scrollHeight;\n    lastObservedClientHeight.current = clientHeight;\n\n    // A scheduled frame owns the pending behavior; resize callbacks must not apply it early.\n    if (scheduledFrameRef.current === null) {\n      const scrollBehavior = scrollingToBottomBehaviorRef.current;\n      if (scrollBehavior && hasActiveTopAnchor()) {\n        // Let the top-anchor reserve own scrolling while a run starts to avoid a bottom-scroll race.\n        scrollingToBottomBehaviorRef.current = null;\n      } else if (scrollBehavior) {\n        scrollToBottom(scrollBehavior);\n      } else if (\n        autoScroll &&\n        !(isRunning && hasActiveTopAnchor()) &&\n        followBottomRef.current &&\n        !followPausedRef.current\n      ) {\n        scrollToBottom(\"instant\");\n      } else if (\n        prependAnchorRef.current &&\n        !keepMessageAt(div, prependAnchorRef.current, heldScrollTopRef)\n      ) {\n        prependAnchorRef.current = null;\n      }\n    }\n\n    handleScroll();\n  };\n  const onResizeRef = useRef(onResize);\n  useIsomorphicLayoutEffect(() => {\n    onResizeRef.current = onResize;\n  });\n  const resizeRef = useOnResizeContent(() => onResizeRef.current());\n\n  const scrollRef = useManagedRef<HTMLElement>(\n    useCallback(\n      (el) => {\n        // A user gesture invalidates pending bottom-scroll intent; otherwise an\n        // intent kept alive by a non-overflowing thread (see handleScroll) hijacks\n        // the next content growth, e.g. expanding a collapsible tool call. Keyboard\n        // activation reaches that same content without ever emitting a pointer\n        // event, so it has to cancel the intent too.\n        const cancelPendingScrollToBottom = () => {\n          // With nothing pending, the last scroll event already published isAtBottom.\n          if (\n            scrollingToBottomBehaviorRef.current === null &&\n            scheduledFrameRef.current === null\n          )\n            return;\n          // A scheduled frame re-plants the intent when it runs, so clearing the\n          // ref alone leaves the gesture undone.\n          cancelScheduledFrame();\n          scrollingToBottomBehaviorRef.current = null;\n          handleScroll();\n        };\n        // The composer renders inside the viewport, so its keystrokes bubble here;\n        // cancellation keys only represent a gesture on thread content when they\n        // originate outside text entry.\n        const cancelOnKeyDown = (event: KeyboardEvent) => {\n          if (!INTENT_CANCEL_KEYS.has(event.key)) return;\n          const target = event.target as Element | null;\n          if (target?.closest?.(TEXT_ENTRY_SELECTOR)) return;\n          cancelPendingScrollToBottom();\n        };\n        // Expanding a disclosure inside a message, such as a reasoning block or a\n        // tool call card, means the reader is inspecting it, so bottom follow\n        // pauses until the reader scrolls or asks for the bottom again. Every\n        // other interaction, including copying or selecting text, keeps\n        // following. Activation is read from click, which keyboard activation also\n        // dispatches, in the capture phase so the state is read before any handler\n        // on the disclosure flips it or stops the event.\n        const pauseFollowOnExpand = (event: MouseEvent) => {\n          const target = event.target as Element | null;\n          if (\n            !target?.closest?.(MESSAGE_SELECTOR) ||\n            target.closest(TEXT_ENTRY_SELECTOR) ||\n            !isOpeningDisclosure(target)\n          )\n            return;\n          followPausedRef.current = true;\n          scrolledSincePauseRef.current = false;\n          cancelPendingScrollToBottom();\n        };\n        const noteScrollGesture = (event: Event) => {\n          if (event instanceof KeyboardEvent) {\n            if (!SCROLL_KEYS.has(event.key)) return;\n            if (\n              (event.target as Element | null)?.closest?.(TEXT_ENTRY_SELECTOR)\n            )\n              return;\n          } else if (event.type === \"pointerdown\" && event.target !== el) {\n            return;\n          }\n          scrolledSincePauseRef.current = true;\n        };\n        const releasePrependAnchor = () => {\n          prependAnchorRef.current = null;\n        };\n        const gestures = [\n          \"pointerdown\",\n          \"wheel\",\n          \"touchstart\",\n          \"keydown\",\n        ] as const;\n        const resumeGestures = [\n          \"pointerdown\",\n          \"wheel\",\n          \"touchmove\",\n          \"keydown\",\n        ] as const;\n        el.addEventListener(\"scroll\", handleScroll);\n        el.addEventListener(\"pointerdown\", cancelPendingScrollToBottom);\n        el.addEventListener(\"wheel\", cancelPendingScrollToBottom, {\n          passive: true,\n        });\n        el.addEventListener(\"touchstart\", cancelPendingScrollToBottom, {\n          passive: true,\n        });\n        el.addEventListener(\"keydown\", cancelOnKeyDown);\n        el.addEventListener(\"click\", pauseFollowOnExpand, { capture: true });\n        for (const gesture of resumeGestures) {\n          el.addEventListener(gesture, noteScrollGesture, { passive: true });\n        }\n        for (const gesture of gestures) {\n          el.addEventListener(gesture, releasePrependAnchor, { passive: true });\n        }\n        return () => {\n          el.removeEventListener(\"scroll\", handleScroll);\n          el.removeEventListener(\"pointerdown\", cancelPendingScrollToBottom);\n          el.removeEventListener(\"wheel\", cancelPendingScrollToBottom);\n          el.removeEventListener(\"touchstart\", cancelPendingScrollToBottom);\n          el.removeEventListener(\"keydown\", cancelOnKeyDown);\n          el.removeEventListener(\"click\", pauseFollowOnExpand, {\n            capture: true,\n          });\n          for (const gesture of resumeGestures) {\n            el.removeEventListener(gesture, noteScrollGesture);\n          }\n          for (const gesture of gestures) {\n            el.removeEventListener(gesture, releasePrependAnchor);\n          }\n        };\n      },\n      [cancelScheduledFrame, handleScroll],\n    ),\n  );\n\n  // Earlier messages prepended above the reader put the old first message back\n  // where the reader saw it, so growth below it in the same commit (a\n  // streaming reply) is not mistaken for the page; where the browser already\n  // anchored the scroll, this is a no-op.\n  const previousRef = useRef({ threadId, firstMessageId });\n  useIsomorphicLayoutEffect(() => {\n    const previous = previousRef.current;\n    previousRef.current = { threadId, firstMessageId };\n    if (previous.threadId !== threadId) {\n      prependAnchorRef.current = null;\n      return;\n    }\n    const div = divRef.current;\n    const previousFirstMessageId = previous.firstMessageId;\n    if (\n      !div ||\n      previousFirstMessageId === undefined ||\n      previousFirstMessageId === firstMessageId ||\n      (autoScroll && followBottomRef.current && !followPausedRef.current) ||\n      scrollingToBottomBehaviorRef.current !== null\n    )\n      return;\n    const prepended = aui.thread\n      .getState()\n      .messages.some(\n        (message, index) => index > 0 && message.id === previousFirstMessageId,\n      );\n    if (!prepended) return;\n\n    const anchor = firstMessageRef.current;\n    if (\n      anchor?.id === previousFirstMessageId &&\n      keepMessageAt(div, anchor, heldScrollTopRef)\n    ) {\n      prependAnchorRef.current = measureReaderMessage(div) ?? anchor;\n    } else {\n      // Message roots that render no `data-message-id` leave only the total\n      // growth to go on, which counts any growth below the reader too.\n      const top =\n        div.scrollHeight - (lastScrollHeight.current - lastScrollTop.current);\n      if (Math.abs(div.scrollTop - top) >= 1) {\n        div.scrollTo({ top, behavior: \"instant\" });\n      }\n    }\n    lastScrollTop.current = div.scrollTop;\n    lastScrollHeight.current = div.scrollHeight;\n  }, [aui, autoScroll, firstMessageId, threadId]);\n\n  useIsomorphicLayoutEffect(() => {\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    // defer to an in-flight run (e.g. first message on a new thread) that\n    // already planted intent — otherwise we'd downgrade its \"auto\" to \"instant\"\n    if (scrollingToBottomBehaviorRef.current !== null) return;\n    scheduleScrollToBottom(\"instant\");\n  }, [hasMessages, scheduleScrollToBottom, scrollToBottomOnInitialize]);\n\n  useOnScrollToBottom(({ behavior }) => {\n    scrollToBottom(behavior);\n  });\n\n  useAuiEvent(\"thread.runStart\", () => {\n    prependAnchorRef.current = null;\n    followPausedRef.current = false;\n    if (!scrollToBottomOnRunStart) return;\n    if (threadViewportStore.getState().turnAnchor === \"top\") return;\n    scheduleScrollToBottom(\"auto\");\n  });\n\n  useAuiEvent(\"threads.selectionChanged\", () => {\n    followPausedRef.current = false;\n    if (!scrollToBottomOnThreadSwitch) return;\n    scheduleScrollToBottom(\"instant\");\n  });\n\n  const autoScrollRef = useComposedRefs<TElement>(resizeRef, scrollRef, divRef);\n  return autoScrollRef as RefCallback<TElement>;\n};\n"],"mappings":";;;;;;;;;;;;AAiBA,MAAMgB,8BAAc,IAAIC,IAAI;CAC1B;CACA;CACA;CACA;CACA;CACA;CACA;AAAK,CACN;AAID,MAAMC,qCAAqB,IAAID,IAAI,CAAC,SAAS,GAAGD,WAAW,CAAC;AAM5D,MAAMG,sBAAsB;CAC1B;CACA;CACA;CACA;AAE+D,CAChE,CAACC,KAAK,IAAI;AAEX,MAAMC,mBAAmB;AAEzB,MAAMC,sBAAsB;AAI5B,MAAMC,uBAAuBC,WAA6B;CACxD,MAAME,UAAUF,OAAOG,QAAQL,mBAAmB;CAClD,IAAI,CAACI,SAAS,OAAO;CACrB,IAAIA,QAAQE,YAAY,WACtB,OAAOF,QAAQG,eAAeC,aAAa,MAAM,MAAM;CACzD,OACEJ,QAAQK,aAAa,eAAe,MAAM,YACzCL,QAAQK,aAAa,eAAe,KAAK,aAAa,WACvDL,QAAQK,aAAa,MAAM,MAAM;AAErC;AAIA,MAAMI,oBAAoBC,SAAkBC,aAC1CD,QAAQE,sBAAsB,CAAC,CAACC,MAAMF,SAASC,sBAAsB,CAAC,CAACC;AAEzE,MAAMC,uBAAuBH,aAAgD;CAC3E,MAAMD,UAAUC,SAASK,cAA2BrB,gBAAgB;CACpE,MAAMY,KAAKG,SAASO,QAAQ;CAC5B,OAAOP,WAAWH,KACd;EAAEA;EAAIC,QAAQC,iBAAiBC,SAASC,QAAQ;CAAE,IAClD;AACN;;AAGA,MAAMO,wBAAwBP,aAAgD;CAC5E,MAAM,EAAEE,KAAKM,WAAWR,SAASC,sBAAsB;CACvD,IAAIQ,WAAiC;CACrC,KAAK,MAAMV,WAAWC,SAASU,iBAC7B1B,gBACF,GAAG;EACD,MAAM2B,OAAOZ,QAAQE,sBAAsB;EAC3C,IAAIU,KAAKH,UAAUN,KAAK;EACxB,IAAIS,KAAKT,OAAOM,QAAQ;EACxB,MAAMZ,KAAKG,QAAQO,QAAQ;EAC3B,IAAI,CAACV,IAAI;EACT,IAAIe,KAAKT,OAAOA,KAAK,OAAO;GAAEN;GAAIC,QAAQc,KAAKT,MAAMA;EAAI;EACzDO,aAAa;GAAEb;GAAIC,QAAQc,KAAKT,MAAMA;EAAI;CAC5C;CACA,OAAOO;AACT;AAEA,MAAMG,eAAeZ,UAAuBJ,OAAe;CACzD,KAAK,MAAMG,WAAWC,SAASU,iBAC7B1B,gBACF,GACE,IAAIe,QAAQO,QAAQ,iBAAiBV,IAAI,OAAOG;CAElD,OAAO;AACT;;;;;;AAOA,MAAMc,iBACJb,UACAc,QACAC,kBACG;CACH,MAAMhB,UAAUa,YAAYZ,UAAUc,OAAOlB,EAAE;CAC/C,IAAI,CAACG,SAAS,OAAO;CACrB,MAAMkB,QAAQnB,iBAAiBC,SAASC,QAAQ,IAAIc,OAAOjB;CAC3DkB,cAAcC,UAAUhB,SAASkB,YAAYD;CAC7C,IAAIE,KAAKC,IAAIH,KAAK,KAAK,GACrBjB,SAASqB,SAAS;EAAEnB,KAAKa,cAAcC;EAASM,UAAU;CAAU,CAAC;CAEvEP,cAAcC,UAAUhB,SAASkB;CACjC,OAAO;AACT;AAmCA,MAAaK,+BAA6D,EACxEE,YACAC,2BAA2B,MAC3BC,6BAA6B,MAC7BC,+BAA+B,WACiC;CAChE,MAAME,MAAM/D,OAAO;CACnB,MAAMgE,SAASlE,OAAiB,IAAI;CACpC,MAAMmE,cAAc/D,aAAagE,MAAMA,EAAEC,OAAOC,SAASC,SAAS,CAAC;CACnE,MAAMC,iBAAiBpE,aAAagE,QAAMA,IAAEC,OAAOC,SAAS,EAAE,EAAEvC,EAAE;CAClE,MAAM0C,WAAWrE,aAAagE,QAAMA,IAAEM,eAAe3C,EAAE;CACvD,MAAM4C,YAAYvE,aAAagE,QAAMA,IAAEC,OAAOM,SAAS;CACvD,MAAMC,+BAA+B5E,OAAO,KAAK;CACjD,MAAM6E,oBAAoB7E,OAAsB,IAAI;CAEpD,MAAM8E,sBAAsBlE,uBAAuB;CACnD,IAAIgD,eAAemB,KAAAA,GACjBnB,aAAakB,oBAAoBE,SAAS,CAAC,CAACC,eAAe;CAG7D,MAAMC,gBAAgBlF,OAAe,CAAC;CACtC,MAAMmF,mBAAmBnF,OAAe,CAAC;CACzC,MAAMoF,2BAA2BpF,OAAe,CAAC;CACjD,MAAMqF,2BAA2BrF,OAAe,CAAC;CACjD,MAAMsF,kBAAkBtF,OAA6B,IAAI;CAKzD,MAAMuF,mBAAmBvF,OAA6B,IAAI;CAC1D,MAAMwF,mBAAmBxF,OAAO,CAAC;CAKjC,MAAMyF,+BAA+BzF,OAA8B,IAAI;CACvE,MAAM2F,kBAAkB3F,OAAO4D,UAAU;CAKzC,MAAMgC,kBAAkB5F,OAAO,KAAK;CACpC,MAAM6F,wBAAwB7F,OAAO,KAAK;CAC1C,MAAM8F,wBAAwB9F,OAAO4D,UAAU;CAE/C/C,gCAAgC;EAC9B,MAAMkF,qBAAqBD,sBAAsB3C;EACjD2C,sBAAsB3C,UAAUS;EAChC,IAAImC,sBAAsB,CAACnC,YAAY;EAEvC,MAAMoC,MAAM9B,OAAOf;EACnBwC,gBAAgBxC,UAAU6C,QAAQ,QAAQ1F,mBAAmB0F,GAAG;CAClE,GAAG,CAACpC,UAAU,CAAC;CAEf,MAAMqC,iBAAiBlG,aAAa0D,aAA6B;EAC/D,MAAMuC,QAAM9B,OAAOf;EACnB,IAAI,CAAC6C,OAAK;EAEVL,gBAAgBxC,UAAU;EAC1ByC,gBAAgBzC,UAAU;EAC1BsC,6BAA6BtC,UAAUM;EACvC8B,iBAAiBpC,UAAU;EAC3B6C,MAAIxC,SAAS;GAAEnB,KAAK2D,MAAIE;GAAczC;EAAS,CAAC;EAChDyB,cAAc/B,UAAU6C,MAAI3C;EAC5B8B,iBAAiBhC,UAAU6C,MAAIE;CACjC,GAAG,CAAA,CAAE;CAEL,MAAMC,uBAAuBpG,kBAAkB;EAC7C,IAAI8E,kBAAkB1B,YAAY,MAAM;EACxCiD,qBAAqBvB,kBAAkB1B,OAAO;EAC9C0B,kBAAkB1B,UAAU;CAC9B,GAAG,CAAA,CAAE;CAEL,MAAMkD,yBAAyBtG,aAC5B0D,eAA6B;EAC5BgC,6BAA6BtC,UAAUM;EACvC0C,qBAAqB;EACrBtB,kBAAkB1B,UAAUmD,4BAA4B;GACtDzB,kBAAkB1B,UAAU;GAC5B8C,eAAexC,UAAQ;EACzB,CAAC;CACH,GACA,CAAC0C,sBAAsBF,cAAc,CACvC;CAEApF,sCACcsF,qBAAqB,GACjC,CAACA,oBAAoB,CACvB;CAEA,MAAMI,qBAAqBxG,kBAAkB;EAC3C,MAAMyG,QAAQ1B,oBAAoBE,SAAS;EAC3C,OACEwB,MAAMvB,eAAe,SACrBuB,MAAMtE,QAAQC,aAAa+B,OAAOf,WAClCqD,MAAMtE,QAAQe,WAAW;CAE7B,GAAG,CAAC6B,mBAAmB,CAAC;CAExB,MAAM2B,iBAAiB;EACrB,MAAMT,QAAM9B,OAAOf;EACnB,IAAI,CAAC6C,OAAK;EAEV,IACET,iBAAiBpC,WACjBG,KAAKC,IAAIyC,MAAI3C,YAAYmC,iBAAiBrC,OAAO,KAAK,GAEtDoC,iBAAiBpC,UAAU;EAG7B,MAAMuD,aAAa5B,oBAAoBE,SAAS,CAAC,CAAC0B;EAClD,MAAMC,gBAAgBrG,mBAAmB0F,KAAG;EAM5C,IAHEP,6BAA6BtC,YAAY,QACzC,CAACwD,iBACDzB,cAAc/B,UAAU6C,MAAI3C,WACA,CAE5B,OACK;GACL,MAAMwD,iBAAiBxG,eACrB;IACEgD,WAAW6B,cAAc/B;IACzB+C,cAAcf,iBAAiBhC;GACjC,GACA6C,KACF;GAEA,IAAIW,eAAe;IAGjB,IAAIpG,kBAAkByF,KAAG,GAAG;KAC1BP,6BAA6BtC,UAAU;KACvC,IAAI0C,sBAAsB1C,SAASyC,gBAAgBzC,UAAU;IAC/D;IACA,IAAIS,YAAY+B,gBAAgBxC,UAAU;GAC5C,OAAO,IAAI0D,gBAAgB;IACzBV,qBAAqB;IACrBV,6BAA6BtC,UAAU;IACvCwC,gBAAgBxC,UAAU;GAC5B;GAKA,KAFEwD,iBAAiBlB,6BAA6BtC,YAAY,SAExCwD,kBAAkBD,YACpC/F,cAAcmE,mBAAmB,CAAC,CAACiC,SAAS,EAC1CL,YAAYC,cACd,CAAC;EAEL;EAEAzB,cAAc/B,UAAU6C,MAAI3C;EAC5B8B,iBAAiBhC,UAAU6C,MAAIE;EAC/BZ,gBAAgBnC,UAAUb,oBAAoB0D,KAAG;CACnD;CACA,MAAMgB,cAAchH,OAAOyG,QAAQ;CACnC5F,gCAAgC;EAC9BmG,YAAY7D,UAAUsD;CACxB,CAAC;CACD,MAAMQ,eAAelH,kBAAkBiH,YAAY7D,QAAQ,GAAG,CAAA,CAAE;CAEhE,MAAM+D,iBAAiB;EACrB,MAAMlB,QAAM9B,OAAOf;EACnB,IAAI,CAAC6C,OAAK;EAEV,MAAM,EAAEE,cAAciB,iBAAiBnB;EACvC,IACEE,iBAAiBd,yBAAyBjC,WAC1CgE,iBAAiB9B,yBAAyBlC,SAE1C;EAEFiC,yBAAyBjC,UAAU+C;EACnCb,yBAAyBlC,UAAUgE;EAGnC,IAAItC,kBAAkB1B,YAAY,MAAM;GACtC,MAAMiE,iBAAiB3B,6BAA6BtC;GACpD,IAAIiE,kBAAkBb,mBAAmB,GAEvCd,6BAA6BtC,UAAU;QAClC,IAAIiE,gBACTnB,eAAemB,cAAc;QACxB,IACLxD,cACA,EAAEe,aAAa4B,mBAAmB,MAClCZ,gBAAgBxC,WAChB,CAACyC,gBAAgBzC,SAEjB8C,eAAe,SAAS;QACnB,IACLV,iBAAiBpC,WACjB,CAACH,cAAcgD,OAAKT,iBAAiBpC,SAASqC,gBAAgB,GAE9DD,iBAAiBpC,UAAU;EAE/B;EAEA8D,aAAa;CACf;CACA,MAAMI,cAAcrH,OAAOkH,QAAQ;CACnCrG,gCAAgC;EAC9BwG,YAAYlE,UAAU+D;CACxB,CAAC;CACD,MAAMI,YAAY9G,yBAAyB6G,YAAYlE,QAAQ,CAAC;CAEhE,MAAMoE,YAAY7G,cAChBX,aACGyH,OAAO;EAMN,MAAMC,oCAAoC;GAExC,IACEhC,6BAA6BtC,YAAY,QACzC0B,kBAAkB1B,YAAY,MAE9B;GAGFgD,qBAAqB;GACrBV,6BAA6BtC,UAAU;GACvC8D,aAAa;EACf;EAIA,MAAMS,mBAAmBC,UAAyB;GAChD,IAAI,CAAC3G,mBAAmB6G,IAAIF,MAAMG,GAAG,GAAG;GAExC,IADeH,MAAMrG,QACTG,UAAUR,mBAAmB,GAAG;GAC5CwG,4BAA4B;EAC9B;EAQA,MAAMM,uBAAuBJ,YAAsB;GACjD,MAAMrG,WAASqG,QAAMrG;GACrB,IACE,CAACA,UAAQG,UAAUN,gBAAgB,KACnCG,SAAOG,QAAQR,mBAAmB,KAClC,CAACI,oBAAoBC,QAAM,GAE3B;GACFsE,gBAAgBzC,UAAU;GAC1B0C,sBAAsB1C,UAAU;GAChCsE,4BAA4B;EAC9B;EACA,MAAMQ,qBAAqBN,YAAiB;GAC1C,IAAIA,mBAAiBC,eAAe;IAClC,IAAI,CAAC9G,YAAY+G,IAAIF,QAAMG,GAAG,GAAG;IACjC,IACGH,QAAMrG,QAA2BG,UAAUR,mBAAmB,GAE/D;GACJ,OAAO,IAAI0G,QAAMQ,SAAS,iBAAiBR,QAAMrG,WAAWkG,IAC1D;GAEF3B,sBAAsB1C,UAAU;EAClC;EACA,MAAMiF,6BAA6B;GACjC7C,iBAAiBpC,UAAU;EAC7B;EACA,MAAMkF,WAAW;GACf;GACA;GACA;GACA;EAAS;EAEX,MAAME,iBAAiB;GACrB;GACA;GACA;GACA;EAAS;EAEXf,GAAGgB,iBAAiB,UAAUvB,YAAY;EAC1CO,GAAGgB,iBAAiB,eAAef,2BAA2B;EAC9DD,GAAGgB,iBAAiB,SAASf,6BAA6B,EACxDgB,SAAS,KACX,CAAC;EACDjB,GAAGgB,iBAAiB,cAAcf,6BAA6B,EAC7DgB,SAAS,KACX,CAAC;EACDjB,GAAGgB,iBAAiB,WAAWd,eAAe;EAC9CF,GAAGgB,iBAAiB,SAAST,qBAAqB,EAAEW,SAAS,KAAK,CAAC;EACnE,KAAK,MAAMC,WAAWJ,gBACpBf,GAAGgB,iBAAiBG,SAASV,mBAAmB,EAAEQ,SAAS,KAAK,CAAC;EAEnE,KAAK,MAAME,aAAWN,UACpBb,GAAGgB,iBAAiBG,WAASP,sBAAsB,EAAEK,SAAS,KAAK,CAAC;EAEtE,aAAa;GACXjB,GAAGoB,oBAAoB,UAAU3B,YAAY;GAC7CO,GAAGoB,oBAAoB,eAAenB,2BAA2B;GACjED,GAAGoB,oBAAoB,SAASnB,2BAA2B;GAC3DD,GAAGoB,oBAAoB,cAAcnB,2BAA2B;GAChED,GAAGoB,oBAAoB,WAAWlB,eAAe;GACjDF,GAAGoB,oBAAoB,SAASb,qBAAqB,EACnDW,SAAS,KACX,CAAC;GACD,KAAK,MAAMC,aAAWJ,gBACpBf,GAAGoB,oBAAoBD,WAASV,iBAAiB;GAEnD,KAAK,MAAMU,aAAWN,UACpBb,GAAGoB,oBAAoBD,WAASP,oBAAoB;EAExD;CACF,GACA,CAACjC,sBAAsBc,YAAY,CACrC,CACF;CAMA,MAAM4B,cAAc7I,OAAO;EAAEyE;EAAUD;CAAe,CAAC;CACvD3D,gCAAgC;EAC9B,MAAMiI,WAAWD,YAAY1F;EAC7B0F,YAAY1F,UAAU;GAAEsB;GAAUD;EAAe;EACjD,IAAIsE,SAASrE,aAAaA,UAAU;GAClCc,iBAAiBpC,UAAU;GAC3B;EACF;EACA,MAAM6C,QAAM9B,OAAOf;EACnB,MAAM4F,yBAAyBD,SAAStE;EACxC,IACE,CAACwB,SACD+C,2BAA2BhE,KAAAA,KAC3BgE,2BAA2BvE,kBAC1BZ,cAAc+B,gBAAgBxC,WAAW,CAACyC,gBAAgBzC,WAC3DsC,6BAA6BtC,YAAY,MAEzC;EAMF,IAAI,CALcc,IAAII,OACnBW,SAAS,CAAC,CACVV,SAAS2E,MACPC,SAASC,UAAUA,QAAQ,KAAKD,QAAQnH,OAAOgH,sBAE/CC,GAAW;EAEhB,MAAM/F,SAASqC,gBAAgBnC;EAC/B,IACEF,QAAQlB,OAAOgH,0BACf/F,cAAcgD,OAAK/C,QAAQuC,gBAAgB,GAE3CD,iBAAiBpC,UAAUT,qBAAqBsD,KAAG,KAAK/C;OACnD;GAGL,MAAMZ,MACJ2D,MAAIE,gBAAgBf,iBAAiBhC,UAAU+B,cAAc/B;GAC/D,IAAIG,KAAKC,IAAIyC,MAAI3C,YAAYhB,GAAG,KAAK,GACnC2D,MAAIxC,SAAS;IAAEnB;IAAKoB,UAAU;GAAU,CAAC;EAE7C;EACAyB,cAAc/B,UAAU6C,MAAI3C;EAC5B8B,iBAAiBhC,UAAU6C,MAAIE;CACjC,GAAG;EAACjC;EAAKL;EAAYY;EAAgBC;CAAQ,CAAC;CAE9C5D,gCAAgC;EAC9B,IAAI,CAACiD,4BAA4B;EACjC,IAAI,CAACK,aAAa;GAChBS,6BAA6BzB,UAAU;GACvC;EACF;EACA,IAAIyB,6BAA6BzB,SAAS;EAE1CyB,6BAA6BzB,UAAU;EAGvC,IAAIsC,6BAA6BtC,YAAY,MAAM;EACnDkD,uBAAuB,SAAS;CAClC,GAAG;EAAClC;EAAakC;EAAwBvC;CAA0B,CAAC;CAEpErD,qBAAqB,EAAEgD,UAAAA,iBAAe;EACpCwC,eAAexC,UAAQ;CACzB,CAAC;CAEDtD,YAAY,yBAAyB;EACnCoF,iBAAiBpC,UAAU;EAC3ByC,gBAAgBzC,UAAU;EAC1B,IAAI,CAACU,0BAA0B;EAC/B,IAAIiB,oBAAoBE,SAAS,CAAC,CAACC,eAAe,OAAO;EACzDoB,uBAAuB,MAAM;CAC/B,CAAC;CAEDlG,YAAY,kCAAkC;EAC5CyF,gBAAgBzC,UAAU;EAC1B,IAAI,CAACY,8BAA8B;EACnCsC,uBAAuB,SAAS;CAClC,CAAC;CAGD,OADsBvG,gBAA0BwH,WAAWC,WAAWrD,MAC/DkF;AACT"}

package/dist/sandbox-host/SandboxHost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SandboxHost.d.ts","sourceRoot":"","sources":["../../src/sandbox-host/SandboxHost.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,aAAa,EAKnB,MAAM,OAAO,CAAC;AACf,OAAO,EAEL,KAAK,aAAa,EAElB,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAO5B,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,IAAI,CACjC,aAAa,EACb,QAAQ,GAAG,QAAQ,GAAG,aAAa,CACpC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACzC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,cAAc,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,YAAY,EAAE,CACZ,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,cAAc,KACjB,aAAa,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;CACjE,CAAC;AAEF,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnD,OAAO,CAIT;AASD,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,UAAU,EACV,OAAO,EACP,SAA8B,EAC9B,YAAY,EACZ,OAAO,EACP,cAAc,GACf,EAAE,gBAAgB,+BAkKlB"}
+{"version":3,"file":"SandboxHost.d.ts","sourceRoot":"","sources":["../../src/sandbox-host/SandboxHost.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAA+B,MAAM,OAAO,CAAC;AAExE,OAAO,EAEL,KAAK,aAAa,EAElB,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAO5B,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,IAAI,CACjC,aAAa,EACb,QAAQ,GAAG,QAAQ,GAAG,aAAa,CACpC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACzC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,cAAc,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,YAAY,EAAE,CACZ,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,cAAc,KACjB,aAAa,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;CACjE,CAAC;AAEF,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnD,OAAO,CAIT;AASD,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,UAAU,EACV,OAAO,EACP,SAA8B,EAC9B,YAAY,EACZ,OAAO,EACP,cAAc,GACf,EAAE,gBAAgB,+BAkKlB"}

package/dist/sandbox-host/SandboxHost.js

@@ -1,6 +1,7 @@
 "use client";
+import { useIsomorphicLayoutEffect } from "../utils/useIsomorphicLayoutEffect.js";
 import { c } from "@assistant-ui/tap/react-shim/compiler-runtime";
-import { useEffect, useLayoutEffect, useRef, useState } from "@assistant-ui/tap/react-shim";
+import { useEffect, useRef, useState } from "@assistant-ui/tap/react-shim";
 import { invokeUserCallback } from "@assistant-ui/core/internal";
 import { jsx } from "react/jsx-runtime";
 import { SafeContentFrame, isShimLoadError } from "safe-content-frame";
@@ -59,7 +60,7 @@ function SandboxHost(t0) {
 		t3 = $[9];
 		t4 = $[10];
 	}
-	useLayoutEffect(t3, t4);
+	useIsomorphicLayoutEffect(t3, t4);
 	let t5;
 	if ($[11] === Symbol.for("react.memo_cache_sentinel")) {
 		t5 = () => {

package/dist/sandbox-host/SandboxHost.js.map

@@ -1 +1 @@
-{"version":3,"file":"SandboxHost.js","names":["c","_c","CSSProperties","useEffect","useLayoutEffect","useRef","useState","isShimLoadError","RenderedFrame","SafeContentFrame","SandboxOption","invokeUserCallback","DEFAULT_PRODUCT","DEFAULT_MAX_HEIGHT","LOAD_TIMEOUT_MS","SandboxHostConfig","sandbox","useShadowDom","enableBrowserCaching","salt","product","className","style","unsafeDocumentWrite","SandboxHostFrame","Pick","SandboxHostApi","setHeight","height","SandboxBridge","onMessage","event","MessageEvent","dispose","SandboxContent","html","SandboxHostProps","content","contentKey","maxHeight","createBridge","frame","host","onError","error","Error","containerProps","Record","isSandboxFrameMessage","iframe","HTMLIFrameElement","origin","source","contentWindow","LiveSnapshot","SandboxHost","t0","$","t1","undefined","containerRef","contentHeight","setContentHeight","t2","liveRef","t3","t4","current","t5","Symbol","for","container","cancelled","bridge","renderController","AbortController","liveContent","sb","reportError","err","String","bind","scf","renderOpts","signal","renderHtml","then","rendered","hostApi","Number","isFinite","sendMessage","window","addEventListener","fullyLoadedPromiseWithTimeout","catch","err_0","code","err_1","cleanupFailed","cleanupError","runCleanup","cleanup","t6","console","listener","removeEventListener","bridgeToDispose","abort","frameToDispose","resolvedHeight","Math","min","t7","mergedStyle","t8","t9","_c"],"sources":["../../src/sandbox-host/SandboxHost.tsx"],"sourcesContent":["\"use client\";\n\nimport {\n  type CSSProperties,\n  useEffect,\n  useLayoutEffect,\n  useRef,\n  useState,\n} from \"react\";\nimport {\n  isShimLoadError,\n  type RenderedFrame,\n  SafeContentFrame,\n  type SandboxOption,\n} from \"safe-content-frame\";\nimport { invokeUserCallback } from \"@assistant-ui/core/internal\";\n\nconst DEFAULT_PRODUCT = \"assistant-ui-sandbox\";\nconst DEFAULT_MAX_HEIGHT = 800;\nconst LOAD_TIMEOUT_MS = 10_000;\n\nexport type SandboxHostConfig = {\n  sandbox?: SandboxOption[];\n  useShadowDom?: boolean;\n  enableBrowserCaching?: boolean;\n  salt?: string;\n  product?: string;\n  className?: string;\n  style?: CSSProperties;\n  unsafeDocumentWrite?: boolean;\n};\n\nexport type SandboxHostFrame = Pick<\n  RenderedFrame,\n  \"iframe\" | \"origin\" | \"sendMessage\"\n>;\n\nexport type SandboxHostApi = {\n  setHeight: (height: number) => void;\n};\n\nexport type SandboxBridge = {\n  onMessage: (event: MessageEvent) => void;\n  dispose: () => void;\n};\n\nexport type SandboxContent = { html: string };\n\nexport type SandboxHostProps = {\n  content: SandboxContent;\n  contentKey: string;\n  sandbox?: SandboxHostConfig | undefined;\n  maxHeight?: number | undefined;\n  createBridge: (\n    frame: SandboxHostFrame,\n    host: SandboxHostApi,\n  ) => SandboxBridge;\n  onError?: ((error: Error) => void) | undefined;\n  containerProps?: Record<string, string | undefined> | undefined;\n};\n\nexport function isSandboxFrameMessage(\n  event: MessageEvent,\n  frame: { iframe: HTMLIFrameElement; origin: string },\n): boolean {\n  return (\n    event.source === frame.iframe.contentWindow && event.origin === frame.origin\n  );\n}\n\ntype LiveSnapshot = {\n  content: SandboxContent;\n  sandbox: SandboxHostConfig | undefined;\n  createBridge: SandboxHostProps[\"createBridge\"];\n  onError: SandboxHostProps[\"onError\"];\n};\n\nexport function SandboxHost({\n  content,\n  contentKey,\n  sandbox,\n  maxHeight = DEFAULT_MAX_HEIGHT,\n  createBridge,\n  onError,\n  containerProps,\n}: SandboxHostProps) {\n  const containerRef = useRef<HTMLDivElement>(null);\n  const [contentHeight, setContentHeight] = useState<number | undefined>(\n    undefined,\n  );\n\n  const liveRef = useRef<LiveSnapshot>({\n    content,\n    sandbox,\n    createBridge,\n    onError,\n  });\n  useLayoutEffect(() => {\n    liveRef.current = { content, sandbox, createBridge, onError };\n  }, [content, sandbox, createBridge, onError]);\n\n  useEffect(() => {\n    const container = containerRef.current;\n    if (!container) return;\n\n    let cancelled = false;\n    let frame: RenderedFrame | null = null;\n    let bridge: SandboxBridge | null = null;\n    let onMessage: ((event: MessageEvent) => void) | null = null;\n    const renderController = new AbortController();\n\n    const { content: liveContent, sandbox: sb } = liveRef.current;\n\n    const reportError = (err: unknown) => {\n      const error = err instanceof Error ? err : new Error(String(err));\n      invokeUserCallback(\n        \"assistant-ui\",\n        \"SandboxHost onError\",\n        liveRef.current.onError?.bind(liveRef.current),\n        error,\n      );\n    };\n\n    const scf = new SafeContentFrame(sb?.product ?? DEFAULT_PRODUCT, {\n      ...(sb?.sandbox !== undefined && { sandbox: sb.sandbox }),\n      ...(sb?.useShadowDom !== undefined && { useShadowDom: sb.useShadowDom }),\n      ...(sb?.enableBrowserCaching !== undefined && {\n        enableBrowserCaching: sb.enableBrowserCaching,\n      }),\n      ...(sb?.salt !== undefined && { salt: sb.salt }),\n    });\n\n    const renderOpts = {\n      signal: renderController.signal,\n      ...(sb?.unsafeDocumentWrite !== undefined && {\n        unsafeDocumentWrite: sb.unsafeDocumentWrite,\n      }),\n    };\n\n    scf\n      .renderHtml(liveContent.html, container, renderOpts)\n      .then((rendered) => {\n        if (cancelled) {\n          rendered.dispose();\n          return;\n        }\n        frame = rendered;\n\n        const hostApi: SandboxHostApi = {\n          setHeight: (height) => {\n            if (\n              typeof height === \"number\" &&\n              Number.isFinite(height) &&\n              height > 0\n            ) {\n              setContentHeight(height);\n            }\n          },\n        };\n\n        bridge = liveRef.current.createBridge(\n          {\n            iframe: rendered.iframe,\n            origin: rendered.origin,\n            sendMessage: rendered.sendMessage,\n          },\n          hostApi,\n        );\n\n        // Single owner of the window listener; the cross-origin guard runs\n        // here so the bridge only sees frame-validated messages.\n        onMessage = (event) => {\n          if (!isSandboxFrameMessage(event, rendered)) return;\n          bridge?.onMessage(event);\n        };\n        window.addEventListener(\"message\", onMessage);\n\n        // renderHtml resolves at iframe load, which a shim that was never\n        // served also reaches, so a completed render is only known once the\n        // frame says so. render-timeout is excluded because the shim is\n        // running and the guest may still paint, and reporting it would leave\n        // a host that renders an error state showing one over a frame that\n        // recovers.\n        rendered.fullyLoadedPromiseWithTimeout(LOAD_TIMEOUT_MS).catch((err) => {\n          if (cancelled) return;\n          if (isShimLoadError(err) && err.code === \"render-timeout\") return;\n          reportError(err);\n        });\n      })\n      .catch((err) => {\n        if (cancelled) return;\n        frame?.dispose();\n        frame = null;\n        reportError(err);\n      });\n\n    return () => {\n      cancelled = true;\n      let cleanupFailed = false;\n      let cleanupError: unknown;\n      const runCleanup = (cleanup: () => void) => {\n        try {\n          cleanup();\n        } catch (error) {\n          if (cleanupFailed) {\n            console.error(error);\n          } else {\n            cleanupFailed = true;\n            cleanupError = error;\n          }\n        }\n      };\n\n      if (onMessage) {\n        const listener = onMessage;\n        onMessage = null;\n        runCleanup(() => window.removeEventListener(\"message\", listener));\n      }\n      const bridgeToDispose = bridge;\n      bridge = null;\n      if (bridgeToDispose) runCleanup(() => bridgeToDispose.dispose());\n      runCleanup(() => renderController.abort());\n      const frameToDispose = frame;\n      frame = null;\n      if (frameToDispose) runCleanup(() => frameToDispose.dispose());\n      runCleanup(() => setContentHeight(undefined));\n\n      if (cleanupFailed) throw cleanupError;\n    };\n    // oxlint-disable-next-line react/exhaustive-deps -- re-init only on contentKey change; live values flow through liveRef\n  }, [contentKey]);\n\n  const resolvedHeight =\n    contentHeight != null ? Math.min(contentHeight, maxHeight) : undefined;\n  const mergedStyle =\n    resolvedHeight != null\n      ? { ...sandbox?.style, height: resolvedHeight }\n      : sandbox?.style;\n\n  return (\n    <div\n      {...containerProps}\n      ref={containerRef}\n      className={sandbox?.className}\n      style={mergedStyle}\n    />\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"SandboxHost.js","names":["c","_c","CSSProperties","useEffect","useRef","useState","useIsomorphicLayoutEffect","isShimLoadError","RenderedFrame","SafeContentFrame","SandboxOption","invokeUserCallback","DEFAULT_PRODUCT","DEFAULT_MAX_HEIGHT","LOAD_TIMEOUT_MS","SandboxHostConfig","sandbox","useShadowDom","enableBrowserCaching","salt","product","className","style","unsafeDocumentWrite","SandboxHostFrame","Pick","SandboxHostApi","setHeight","height","SandboxBridge","onMessage","event","MessageEvent","dispose","SandboxContent","html","SandboxHostProps","content","contentKey","maxHeight","createBridge","frame","host","onError","error","Error","containerProps","Record","isSandboxFrameMessage","iframe","HTMLIFrameElement","origin","source","contentWindow","LiveSnapshot","SandboxHost","t0","$","t1","undefined","containerRef","contentHeight","setContentHeight","t2","liveRef","t3","t4","current","t5","Symbol","for","container","cancelled","bridge","renderController","AbortController","liveContent","sb","reportError","err","String","bind","scf","renderOpts","signal","renderHtml","then","rendered","hostApi","Number","isFinite","sendMessage","window","addEventListener","fullyLoadedPromiseWithTimeout","catch","err_0","code","err_1","cleanupFailed","cleanupError","runCleanup","cleanup","t6","console","listener","removeEventListener","bridgeToDispose","abort","frameToDispose","resolvedHeight","Math","min","t7","mergedStyle","t8","t9","_c"],"sources":["../../src/sandbox-host/SandboxHost.tsx"],"sourcesContent":["\"use client\";\n\nimport { type CSSProperties, useEffect, useRef, useState } from \"react\";\nimport { useIsomorphicLayoutEffect } from \"../utils/useIsomorphicLayoutEffect\";\nimport {\n  isShimLoadError,\n  type RenderedFrame,\n  SafeContentFrame,\n  type SandboxOption,\n} from \"safe-content-frame\";\nimport { invokeUserCallback } from \"@assistant-ui/core/internal\";\n\nconst DEFAULT_PRODUCT = \"assistant-ui-sandbox\";\nconst DEFAULT_MAX_HEIGHT = 800;\nconst LOAD_TIMEOUT_MS = 10_000;\n\nexport type SandboxHostConfig = {\n  sandbox?: SandboxOption[];\n  useShadowDom?: boolean;\n  enableBrowserCaching?: boolean;\n  salt?: string;\n  product?: string;\n  className?: string;\n  style?: CSSProperties;\n  unsafeDocumentWrite?: boolean;\n};\n\nexport type SandboxHostFrame = Pick<\n  RenderedFrame,\n  \"iframe\" | \"origin\" | \"sendMessage\"\n>;\n\nexport type SandboxHostApi = {\n  setHeight: (height: number) => void;\n};\n\nexport type SandboxBridge = {\n  onMessage: (event: MessageEvent) => void;\n  dispose: () => void;\n};\n\nexport type SandboxContent = { html: string };\n\nexport type SandboxHostProps = {\n  content: SandboxContent;\n  contentKey: string;\n  sandbox?: SandboxHostConfig | undefined;\n  maxHeight?: number | undefined;\n  createBridge: (\n    frame: SandboxHostFrame,\n    host: SandboxHostApi,\n  ) => SandboxBridge;\n  onError?: ((error: Error) => void) | undefined;\n  containerProps?: Record<string, string | undefined> | undefined;\n};\n\nexport function isSandboxFrameMessage(\n  event: MessageEvent,\n  frame: { iframe: HTMLIFrameElement; origin: string },\n): boolean {\n  return (\n    event.source === frame.iframe.contentWindow && event.origin === frame.origin\n  );\n}\n\ntype LiveSnapshot = {\n  content: SandboxContent;\n  sandbox: SandboxHostConfig | undefined;\n  createBridge: SandboxHostProps[\"createBridge\"];\n  onError: SandboxHostProps[\"onError\"];\n};\n\nexport function SandboxHost({\n  content,\n  contentKey,\n  sandbox,\n  maxHeight = DEFAULT_MAX_HEIGHT,\n  createBridge,\n  onError,\n  containerProps,\n}: SandboxHostProps) {\n  const containerRef = useRef<HTMLDivElement>(null);\n  const [contentHeight, setContentHeight] = useState<number | undefined>(\n    undefined,\n  );\n\n  const liveRef = useRef<LiveSnapshot>({\n    content,\n    sandbox,\n    createBridge,\n    onError,\n  });\n  useIsomorphicLayoutEffect(() => {\n    liveRef.current = { content, sandbox, createBridge, onError };\n  }, [content, sandbox, createBridge, onError]);\n\n  useEffect(() => {\n    const container = containerRef.current;\n    if (!container) return;\n\n    let cancelled = false;\n    let frame: RenderedFrame | null = null;\n    let bridge: SandboxBridge | null = null;\n    let onMessage: ((event: MessageEvent) => void) | null = null;\n    const renderController = new AbortController();\n\n    const { content: liveContent, sandbox: sb } = liveRef.current;\n\n    const reportError = (err: unknown) => {\n      const error = err instanceof Error ? err : new Error(String(err));\n      invokeUserCallback(\n        \"assistant-ui\",\n        \"SandboxHost onError\",\n        liveRef.current.onError?.bind(liveRef.current),\n        error,\n      );\n    };\n\n    const scf = new SafeContentFrame(sb?.product ?? DEFAULT_PRODUCT, {\n      ...(sb?.sandbox !== undefined && { sandbox: sb.sandbox }),\n      ...(sb?.useShadowDom !== undefined && { useShadowDom: sb.useShadowDom }),\n      ...(sb?.enableBrowserCaching !== undefined && {\n        enableBrowserCaching: sb.enableBrowserCaching,\n      }),\n      ...(sb?.salt !== undefined && { salt: sb.salt }),\n    });\n\n    const renderOpts = {\n      signal: renderController.signal,\n      ...(sb?.unsafeDocumentWrite !== undefined && {\n        unsafeDocumentWrite: sb.unsafeDocumentWrite,\n      }),\n    };\n\n    scf\n      .renderHtml(liveContent.html, container, renderOpts)\n      .then((rendered) => {\n        if (cancelled) {\n          rendered.dispose();\n          return;\n        }\n        frame = rendered;\n\n        const hostApi: SandboxHostApi = {\n          setHeight: (height) => {\n            if (\n              typeof height === \"number\" &&\n              Number.isFinite(height) &&\n              height > 0\n            ) {\n              setContentHeight(height);\n            }\n          },\n        };\n\n        bridge = liveRef.current.createBridge(\n          {\n            iframe: rendered.iframe,\n            origin: rendered.origin,\n            sendMessage: rendered.sendMessage,\n          },\n          hostApi,\n        );\n\n        // Single owner of the window listener; the cross-origin guard runs\n        // here so the bridge only sees frame-validated messages.\n        onMessage = (event) => {\n          if (!isSandboxFrameMessage(event, rendered)) return;\n          bridge?.onMessage(event);\n        };\n        window.addEventListener(\"message\", onMessage);\n\n        // renderHtml resolves at iframe load, which a shim that was never\n        // served also reaches, so a completed render is only known once the\n        // frame says so. render-timeout is excluded because the shim is\n        // running and the guest may still paint, and reporting it would leave\n        // a host that renders an error state showing one over a frame that\n        // recovers.\n        rendered.fullyLoadedPromiseWithTimeout(LOAD_TIMEOUT_MS).catch((err) => {\n          if (cancelled) return;\n          if (isShimLoadError(err) && err.code === \"render-timeout\") return;\n          reportError(err);\n        });\n      })\n      .catch((err) => {\n        if (cancelled) return;\n        frame?.dispose();\n        frame = null;\n        reportError(err);\n      });\n\n    return () => {\n      cancelled = true;\n      let cleanupFailed = false;\n      let cleanupError: unknown;\n      const runCleanup = (cleanup: () => void) => {\n        try {\n          cleanup();\n        } catch (error) {\n          if (cleanupFailed) {\n            console.error(error);\n          } else {\n            cleanupFailed = true;\n            cleanupError = error;\n          }\n        }\n      };\n\n      if (onMessage) {\n        const listener = onMessage;\n        onMessage = null;\n        runCleanup(() => window.removeEventListener(\"message\", listener));\n      }\n      const bridgeToDispose = bridge;\n      bridge = null;\n      if (bridgeToDispose) runCleanup(() => bridgeToDispose.dispose());\n      runCleanup(() => renderController.abort());\n      const frameToDispose = frame;\n      frame = null;\n      if (frameToDispose) runCleanup(() => frameToDispose.dispose());\n      runCleanup(() => setContentHeight(undefined));\n\n      if (cleanupFailed) throw cleanupError;\n    };\n    // oxlint-disable-next-line react/exhaustive-deps -- re-init only on contentKey change; live values flow through liveRef\n  }, [contentKey]);\n\n  const resolvedHeight =\n    contentHeight != null ? Math.min(contentHeight, maxHeight) : undefined;\n  const mergedStyle =\n    resolvedHeight != null\n      ? { ...sandbox?.style, height: resolvedHeight }\n      : sandbox?.style;\n\n  return (\n    <div\n      {...containerProps}\n      ref={containerRef}\n      className={sandbox?.className}\n      style={mergedStyle}\n    />\n  );\n}\n"],"mappings":"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"}

package/dist/unstable/useComposerInput.d.ts

@@ -1,5 +1,6 @@
 import type { ComposerSendOptions } from "@assistant-ui/core/store";
 import { type TriggerPopoverAriaProps } from "../primitives/composer/useComposerInputState.js";
+/** @deprecated Experimental since 2026-06-23. Not scheduled for removal; the API may change in any release. */
 export type Unstable_UseComposerInputOptions = {
     /**
      * Disables the input in addition to the composer's own disabled sources
@@ -8,6 +9,7 @@ export type Unstable_UseComposerInputOptions = {
      */
     disabled?: boolean | undefined;
 };
+/** @deprecated Experimental since 2026-06-23. Not scheduled for removal; the API may change in any release. */
 export type Unstable_ComposerInput = {
     /** Current composer text, or `""` when the composer is not editing. */
     value: string;
@@ -35,8 +37,6 @@ export type Unstable_ComposerInput = {
     canSend: boolean;
 };
 /**
- * @deprecated Under active development and might change without notice.
- *
  * Headless bridge to the composer's text value and send action, for building a
  * custom composer input without `ComposerPrimitive.Input`. It is a thin bridge,
  * not a second input: it does not own keyboard behavior, autosize, IME or
@@ -44,6 +44,8 @@ export type Unstable_ComposerInput = {
  * state. Spread `unstable_useTriggerPopoverAriaProps()` onto your element for
  * trigger-popover combobox semantics.
  *
+ * @deprecated Experimental since 2026-06-23. Not scheduled for removal; the API may change in any release.
+ *
  * @example
  * ```tsx
  * const { value, setText, send, isDisabled, canSend } = unstable_useComposerInput();
@@ -52,6 +54,8 @@ export type Unstable_ComposerInput = {
  *   disabled={isDisabled}
  *   onChange={(e) => setText(e.target.value)}
  *   onKeyDown={(e) => {
+ *     if (e.nativeEvent.isComposing || e.keyCode === 229) return;
+ *
  *     if (e.key === "Enter" && !e.shiftKey && canSend) {
  *       e.preventDefault();
  *       send();
@@ -61,16 +65,17 @@ export type Unstable_ComposerInput = {
  * ```
  */
 export declare function unstable_useComposerInput(options?: Unstable_UseComposerInputOptions): Unstable_ComposerInput;
+/** @deprecated Experimental since 2026-06-23. Not scheduled for removal; the API may change in any release. */
 export type Unstable_TriggerPopoverAriaProps = TriggerPopoverAriaProps;
 /**
- * @deprecated Under active development and might change without notice.
- *
  * ARIA combobox attributes for the focused element (typically the composer
  * input) describing the open trigger popover, per the WAI-ARIA editable
  * combobox pattern. Returns an empty object outside a `TriggerPopoverRoot` or
  * when no popover is open. Spread these last so they take precedence over any
  * matching ARIA props you set yourself, mirroring `ComposerPrimitive.Input`.
  *
+ * @deprecated Experimental since 2026-06-23. Not scheduled for removal; the API may change in any release.
+ *
  * @example
  * ```tsx
  * const aria = unstable_useTriggerPopoverAriaProps();

package/dist/unstable/useComposerInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useComposerInput.d.ts","sourceRoot":"","sources":["../../src/unstable/useComposerInput.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EACL,KAAK,uBAAuB,EAI7B,wDAAqD;AAEtD,MAAM,MAAM,gCAAgC,GAAG;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;;OAGG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC1C;;;OAGG;IACH,UAAU,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,CAAC,EAAE,gCAAgC,GACzC,sBAAsB,CA0BxB;AAED,MAAM,MAAM,gCAAgC,GAAG,uBAAuB,CAAC;AAEvE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mCAAmC,IAAI,gCAAgC,CAEtF"}
+{"version":3,"file":"useComposerInput.d.ts","sourceRoot":"","sources":["../../src/unstable/useComposerInput.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EACL,KAAK,uBAAuB,EAI7B,wDAAqD;AAEtD,+GAA+G;AAC/G,MAAM,MAAM,gCAAgC,GAAG;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAChC,CAAC;AAEF,+GAA+G;AAC/G,MAAM,MAAM,sBAAsB,GAAG;IACnC,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;;OAGG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC1C;;;OAGG;IACH,UAAU,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,CAAC,EAAE,gCAAgC,GACzC,sBAAsB,CA0BxB;AAED,+GAA+G;AAC/G,MAAM,MAAM,gCAAgC,GAAG,uBAAuB,CAAC;AAEvE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mCAAmC,IAAI,gCAAgC,CAEtF"}

package/dist/unstable/useComposerInput.js

@@ -6,8 +6,6 @@ import { useAui } from "@assistant-ui/store";
 import { flushTapSync } from "@assistant-ui/tap";
 //#region src/unstable/useComposerInput.ts
 /**
-* @deprecated Under active development and might change without notice.
-*
 * Headless bridge to the composer's text value and send action, for building a
 * custom composer input without `ComposerPrimitive.Input`. It is a thin bridge,
 * not a second input: it does not own keyboard behavior, autosize, IME or
@@ -15,6 +13,8 @@ import { flushTapSync } from "@assistant-ui/tap";
 * state. Spread `unstable_useTriggerPopoverAriaProps()` onto your element for
 * trigger-popover combobox semantics.
 *
+* @deprecated Experimental since 2026-06-23. Not scheduled for removal; the API may change in any release.
+*
 * @example
 * ```tsx
 * const { value, setText, send, isDisabled, canSend } = unstable_useComposerInput();
@@ -23,6 +23,8 @@ import { flushTapSync } from "@assistant-ui/tap";
 *   disabled={isDisabled}
 *   onChange={(e) => setText(e.target.value)}
 *   onKeyDown={(e) => {
+*     if (e.nativeEvent.isComposing || e.keyCode === 229) return;
+*
 *     if (e.key === "Enter" && !e.shiftKey && canSend) {
 *       e.preventDefault();
 *       send();
@@ -55,14 +57,14 @@ function unstable_useComposerInput(options) {
 	};
 }
 /**
-* @deprecated Under active development and might change without notice.
-*
 * ARIA combobox attributes for the focused element (typically the composer
 * input) describing the open trigger popover, per the WAI-ARIA editable
 * combobox pattern. Returns an empty object outside a `TriggerPopoverRoot` or
 * when no popover is open. Spread these last so they take precedence over any
 * matching ARIA props you set yourself, mirroring `ComposerPrimitive.Input`.
 *
+* @deprecated Experimental since 2026-06-23. Not scheduled for removal; the API may change in any release.
+*
 * @example
 * ```tsx
 * const aria = unstable_useTriggerPopoverAriaProps();