@portablecore/chat 0.2.16 → 0.3.1

package/dist/hooks/use-chat-scroll.js

@@ -10,22 +10,29 @@ exports.useChatScroll = useChatScroll;
  *  - A new message arrives (smooth, if user was near bottom)
  *  - Streaming content grows (RAF-gated, if user was near bottom)
  *
- * Respects user intent: if user scrolled up, don't pull them down.
- * Includes a programmatic scroll guard so auto-scrolls don't
- * accidentally trip the "user scrolled away" detection.
+ * Scroll guards (ported from legacy ChatInterface):
+ *  - 600ms user scroll debounce for mobile momentum scrolling
+ *  - 200ms programmatic scroll guard to prevent auto-scroll events
+ *    from being misinterpreted as user scrolls
+ *  - userTookOverDuringStreaming flag that persists until streaming ends,
+ *    preventing the RAF loop from fighting user intent
  *
  * Supports an optional virtualizer ref for large message lists.
  * The ref is read at call time (not a dependency) to avoid circular hooks.
  */
 const react_1 = require("react");
 const NEAR_BOTTOM_THRESHOLD = 100;
-const PROGRAMMATIC_SCROLL_GUARD_MS = 150;
+const PROGRAMMATIC_SCROLL_GUARD_MS = 200;
+const USER_SCROLL_DEBOUNCE_MS = 600;
 function useChatScroll({ messages, streaming, selectedThreadId, virtualizerRef, }) {
     const scrollRef = (0, react_1.useRef)(null);
     const wasNearBottom = (0, react_1.useRef)(true);
     const prevThreadIdRef = (0, react_1.useRef)(undefined);
-    const lastProgrammaticScroll = (0, react_1.useRef)(0);
     const rafRef = (0, react_1.useRef)(null);
+    const isUserScrolling = (0, react_1.useRef)(false);
+    const userScrollTimeout = (0, react_1.useRef)(null);
+    const lastProgrammaticScroll = (0, react_1.useRef)(0);
+    const userTookOverDuringStreaming = (0, react_1.useRef)(false);
     const isNearBottom = (0, react_1.useCallback)(() => {
         const el = scrollRef.current;
         if (!el)
@@ -48,26 +55,44 @@ function useChatScroll({ messages, streaming, selectedThreadId, virtualizerRef,
             el.scrollTo({ top: el.scrollHeight, behavior });
         }
     }, 
-    // virtualizerRef is a stable ref, not a dependency
     // eslint-disable-next-line react-hooks/exhaustive-deps
     [messages.length]);
-    // Track whether user is near bottom (with programmatic scroll guard)
+    // Unified scroll listener: tracks near-bottom state + user scroll guards
     (0, react_1.useEffect)(() => {
         const el = scrollRef.current;
         if (!el)
             return;
-        const onScroll = () => {
+        const handleScroll = () => {
             const elapsed = Date.now() - lastProgrammaticScroll.current;
             if (elapsed < PROGRAMMATIC_SCROLL_GUARD_MS)
                 return;
             wasNearBottom.current = isNearBottom();
+            isUserScrolling.current = true;
+            if (streaming) {
+                const nearBottom = el.scrollHeight - el.scrollTop - el.clientHeight < NEAR_BOTTOM_THRESHOLD;
+                if (!nearBottom) {
+                    userTookOverDuringStreaming.current = true;
+                }
+            }
+            if (userScrollTimeout.current) {
+                clearTimeout(userScrollTimeout.current);
+            }
+            userScrollTimeout.current = setTimeout(() => {
+                isUserScrolling.current = false;
+            }, USER_SCROLL_DEBOUNCE_MS);
         };
-        el.addEventListener("scroll", onScroll, { passive: true });
-        return () => el.removeEventListener("scroll", onScroll);
-    }, [isNearBottom]);
+        el.addEventListener("scroll", handleScroll, { passive: true });
+        return () => el.removeEventListener("scroll", handleScroll);
+    }, [isNearBottom, streaming]);
+    // Reset userTookOver when streaming ends
+    (0, react_1.useEffect)(() => {
+        if (!streaming) {
+            userTookOverDuringStreaming.current = false;
+        }
+    }, [streaming]);
     // Auto-scroll on new messages
     (0, react_1.useEffect)(() => {
-        if (wasNearBottom.current) {
+        if (wasNearBottom.current && !isUserScrolling.current) {
             scrollToBottom("smooth");
         }
     }, [messages.length, scrollToBottom]);
@@ -81,7 +106,9 @@ function useChatScroll({ messages, streaming, selectedThreadId, virtualizerRef,
             return;
         }
         const tick = () => {
-            if (wasNearBottom.current) {
+            if (wasNearBottom.current &&
+                !userTookOverDuringStreaming.current &&
+                !isUserScrolling.current) {
                 scrollToBottom("smooth");
             }
             rafRef.current = requestAnimationFrame(tick);
@@ -123,6 +150,13 @@ function useChatScroll({ messages, streaming, selectedThreadId, virtualizerRef,
             }
         });
     }, [selectedThreadId, scrollToBottom]);
-    return { scrollRef, scrollToBottom, isNearBottom };
+    return {
+        scrollRef,
+        scrollToBottom,
+        isNearBottom,
+        isUserScrolling,
+        userTookOverDuringStreaming,
+        lastProgrammaticScroll,
+    };
 }
 //# sourceMappingURL=use-chat-scroll.js.map

package/dist/hooks/use-chat-scroll.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-chat-scroll.js","sourceRoot":"","sources":["../../src/hooks/use-chat-scroll.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-chat-scroll.js","sourceRoot":"","sources":["../../src/hooks/use-chat-scroll.ts"],"names":[],"mappings":"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"}

package/dist/hooks/use-content-density.d.ts

@@ -0,0 +1,35 @@
+import type { LiteMessage, MessageViewMode } from "@portablecore/types/chat";
+interface UseContentDensityOptions {
+    messages: LiteMessage[];
+    initialViewMode?: MessageViewMode;
+    currentUserId: string;
+    onViewModeChange?: (mode: MessageViewMode) => void;
+    /** How many recent messages stay full in Smart mode (default 10) */
+    recentMessageCount?: number;
+}
+export interface ContentDensityState {
+    viewMode: MessageViewMode;
+    setViewMode: (mode: MessageViewMode) => void;
+    /** True when the message should render shortContent instead of content */
+    shouldShowShort: (messageId: string) => boolean;
+    /** Toggle a single message between expanded/collapsed */
+    toggleExpanded: (messageId: string, currentlyShowingFull: boolean) => void;
+}
+/**
+ * Auto-determine the default view mode based on chat characteristics.
+ * Group chats and long chats default to Smart; short chats default to Full.
+ */
+export declare function getDefaultViewMode(chatLength: number, chatType?: string): MessageViewMode;
+/**
+ * Manages Content Density state: view mode, per-message expansion overrides,
+ * and the core logic for deciding whether to show short or full content.
+ *
+ * Mode behaviors:
+ * - "full": all messages expanded
+ * - "brief": all messages with shortContent are compressed
+ * - "smart": recency-weighted auto-selection. Recent N messages stay full,
+ *   older messages that the current user prompted stay full, all others brief.
+ */
+export declare function useContentDensity({ messages, initialViewMode, currentUserId, onViewModeChange, recentMessageCount, }: UseContentDensityOptions): ContentDensityState;
+export {};
+//# sourceMappingURL=use-content-density.d.ts.map

package/dist/hooks/use-content-density.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-content-density.d.ts","sourceRoot":"","sources":["../../src/hooks/use-content-density.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAE5E,UAAU,wBAAwB;IAChC,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC,aAAa,EAAE,MAAM,CAAA;IACrB,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAA;IAClD,oEAAoE;IACpE,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,eAAe,CAAA;IACzB,WAAW,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAA;IAC5C,0EAA0E;IAC1E,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAA;IAC/C,yDAAyD;IACzD,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,KAAK,IAAI,CAAA;CAC3E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,eAAe,CAIjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,eAAyB,EACzB,aAAa,EACb,gBAAgB,EAChB,kBAAuB,GACxB,EAAE,wBAAwB,GAAG,mBAAmB,CAkFhD"}

package/dist/hooks/use-content-density.js

@@ -0,0 +1,96 @@
+"use client";
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDefaultViewMode = getDefaultViewMode;
+exports.useContentDensity = useContentDensity;
+const react_1 = require("react");
+/**
+ * Auto-determine the default view mode based on chat characteristics.
+ * Group chats and long chats default to Smart; short chats default to Full.
+ */
+function getDefaultViewMode(chatLength, chatType) {
+    if (chatType === "group")
+        return "smart";
+    if (chatLength > 50)
+        return "smart";
+    return "full";
+}
+/**
+ * Manages Content Density state: view mode, per-message expansion overrides,
+ * and the core logic for deciding whether to show short or full content.
+ *
+ * Mode behaviors:
+ * - "full": all messages expanded
+ * - "brief": all messages with shortContent are compressed
+ * - "smart": recency-weighted auto-selection. Recent N messages stay full,
+ *   older messages that the current user prompted stay full, all others brief.
+ */
+function useContentDensity({ messages, initialViewMode = "smart", currentUserId, onViewModeChange, recentMessageCount = 10, }) {
+    const [viewMode, setViewModeInternal] = (0, react_1.useState)(initialViewMode);
+    const [overrides, setOverrides] = (0, react_1.useState)(() => new Map());
+    const initialViewModeRef = (0, react_1.useRef)(initialViewMode);
+    const setViewMode = (0, react_1.useCallback)((mode) => {
+        setViewModeInternal(mode);
+        setOverrides(new Map());
+        onViewModeChange?.(mode);
+    }, [onViewModeChange]);
+    (0, react_1.useEffect)(() => {
+        if (viewMode !== initialViewModeRef.current) {
+            onViewModeChange?.(viewMode);
+        }
+    }, []); // eslint-disable-line react-hooks/exhaustive-deps
+    const messageIndex = (0, react_1.useMemo)(() => {
+        const map = new Map();
+        for (let i = 0; i < messages.length; i++) {
+            map.set(messages[i].id, i);
+        }
+        return map;
+    }, [messages]);
+    const shouldShowShort = (0, react_1.useCallback)((messageId) => {
+        const idx = messageIndex.get(messageId);
+        if (idx === undefined)
+            return false;
+        const msg = messages[idx];
+        if (!msg || msg.role !== "assistant" || !msg.shortContent)
+            return false;
+        const override = overrides.get(messageId);
+        if (override === "expanded")
+            return false;
+        if (override === "collapsed")
+            return true;
+        if (viewMode === "full")
+            return false;
+        if (viewMode === "brief")
+            return true;
+        // Smart mode: recency + authorship
+        if (viewMode === "smart") {
+            const totalMessages = messages.length;
+            const isRecent = totalMessages - idx <= recentMessageCount;
+            if (isRecent)
+                return false;
+            // Check if the current user prompted this response
+            for (let i = idx - 1; i >= 0; i--) {
+                const prevMsg = messages[i];
+                if (prevMsg && prevMsg.role === "user") {
+                    const promptingUserId = prevMsg.senderUserId || currentUserId;
+                    return promptingUserId !== currentUserId;
+                }
+            }
+        }
+        return false;
+    }, [messages, messageIndex, overrides, viewMode, currentUserId, recentMessageCount]);
+    const toggleExpanded = (0, react_1.useCallback)((messageId, currentlyShowingFull) => {
+        setOverrides((prev) => {
+            const next = new Map(prev);
+            next.set(messageId, currentlyShowingFull ? "collapsed" : "expanded");
+            return next;
+        });
+    }, []);
+    return {
+        viewMode,
+        setViewMode,
+        shouldShowShort,
+        toggleExpanded,
+    };
+}
+//# sourceMappingURL=use-content-density.js.map

package/dist/hooks/use-content-density.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-content-density.js","sourceRoot":"","sources":["../../src/hooks/use-content-density.ts"],"names":[],"mappings":"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"}

package/dist/hooks/use-focus-mode.d.ts

@@ -1,29 +1,7 @@
-import type { LiteMessage, MessageViewMode } from "@portablecore/types/chat";
-interface UseFocusModeOptions {
-    messages: LiteMessage[];
-    enabled: boolean;
-    initialViewMode?: MessageViewMode;
-    currentUserId: string;
-    onViewModeChange?: (mode: MessageViewMode) => void;
-}
-export interface FocusModeState {
-    viewMode: MessageViewMode;
-    setViewMode: (mode: MessageViewMode) => void;
-    /** True when the message should render shortContent instead of content */
-    shouldShowShort: (messageId: string) => boolean;
-    /** Toggle a single message between expanded/collapsed */
-    toggleExpanded: (messageId: string, currentlyShowingFull: boolean) => void;
-    enabled: boolean;
-}
 /**
- * Manages focus mode state: view mode, per-message expansion overrides,
- * and the core logic for deciding whether to show short or full content.
- *
- * Mirrors the legacy ChatInterface focus mode exactly:
- * - "long": all messages expanded
- * - "short": all messages with shortContent are compressed
- * - "focus": messages you prompted are expanded, others' compressed
+ * @deprecated Use useContentDensity from ./use-content-density.ts instead.
+ * This file re-exports the new hook for backward compatibility.
  */
-export declare function useFocusMode({ messages, enabled, initialViewMode, currentUserId, onViewModeChange, }: UseFocusModeOptions): FocusModeState;
-export {};
+export { useContentDensity as useFocusMode } from "./use-content-density.js";
+export type { ContentDensityState as FocusModeState } from "./use-content-density.js";
 //# sourceMappingURL=use-focus-mode.d.ts.map

package/dist/hooks/use-focus-mode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-focus-mode.d.ts","sourceRoot":"","sources":["../../src/hooks/use-focus-mode.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAE5E,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB,OAAO,EAAE,OAAO,CAAA;IAChB,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC,aAAa,EAAE,MAAM,CAAA;IACrB,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAA;CACnD;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,eAAe,CAAA;IACzB,WAAW,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAA;IAC5C,0EAA0E;IAC1E,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAA;IAC/C,yDAAyD;IACzD,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,KAAK,IAAI,CAAA;IAC1E,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,OAAO,EACP,eAAyB,EACzB,aAAa,EACb,gBAAgB,GACjB,EAAE,mBAAmB,GAAG,cAAc,CAkFtC"}
+{"version":3,"file":"use-focus-mode.d.ts","sourceRoot":"","sources":["../../src/hooks/use-focus-mode.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,IAAI,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5E,YAAY,EAAE,mBAAmB,IAAI,cAAc,EAAE,MAAM,0BAA0B,CAAA"}

package/dist/hooks/use-focus-mode.js

@@ -1,81 +1,11 @@
 "use client";
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useFocusMode = useFocusMode;
-const react_1 = require("react");
+exports.useFocusMode = void 0;
 /**
- * Manages focus mode state: view mode, per-message expansion overrides,
- * and the core logic for deciding whether to show short or full content.
- *
- * Mirrors the legacy ChatInterface focus mode exactly:
- * - "long": all messages expanded
- * - "short": all messages with shortContent are compressed
- * - "focus": messages you prompted are expanded, others' compressed
+ * @deprecated Use useContentDensity from ./use-content-density.ts instead.
+ * This file re-exports the new hook for backward compatibility.
  */
-function useFocusMode({ messages, enabled, initialViewMode = "focus", currentUserId, onViewModeChange, }) {
-    const [viewMode, setViewModeInternal] = (0, react_1.useState)(enabled ? initialViewMode : "long");
-    const [overrides, setOverrides] = (0, react_1.useState)(() => new Map());
-    const initialViewModeRef = (0, react_1.useRef)(initialViewMode);
-    const setViewMode = (0, react_1.useCallback)((mode) => {
-        setViewModeInternal(mode);
-        setOverrides(new Map());
-        onViewModeChange?.(mode);
-    }, [onViewModeChange]);
-    (0, react_1.useEffect)(() => {
-        if (viewMode !== initialViewModeRef.current) {
-            onViewModeChange?.(viewMode);
-        }
-    }, []); // eslint-disable-line react-hooks/exhaustive-deps
-    const messageIndex = (0, react_1.useMemo)(() => {
-        const map = new Map();
-        for (let i = 0; i < messages.length; i++) {
-            map.set(messages[i].id, i);
-        }
-        return map;
-    }, [messages]);
-    const shouldShowShort = (0, react_1.useCallback)((messageId) => {
-        if (!enabled)
-            return false;
-        const idx = messageIndex.get(messageId);
-        if (idx === undefined)
-            return false;
-        const msg = messages[idx];
-        if (!msg || msg.role !== "assistant" || !msg.shortContent)
-            return false;
-        const override = overrides.get(messageId);
-        if (override === "expanded")
-            return false;
-        if (override === "collapsed")
-            return true;
-        if (viewMode === "long")
-            return false;
-        if (viewMode === "short")
-            return true;
-        // Focus mode: expand if current user prompted this response
-        if (viewMode === "focus") {
-            for (let i = idx - 1; i >= 0; i--) {
-                const prevMsg = messages[i];
-                if (prevMsg && prevMsg.role === "user") {
-                    const promptingUserId = prevMsg.senderUserId || currentUserId;
-                    return promptingUserId !== currentUserId;
-                }
-            }
-        }
-        return false;
-    }, [enabled, messages, messageIndex, overrides, viewMode, currentUserId]);
-    const toggleExpanded = (0, react_1.useCallback)((messageId, currentlyShowingFull) => {
-        setOverrides((prev) => {
-            const next = new Map(prev);
-            next.set(messageId, currentlyShowingFull ? "collapsed" : "expanded");
-            return next;
-        });
-    }, []);
-    return {
-        viewMode,
-        setViewMode,
-        shouldShowShort,
-        toggleExpanded,
-        enabled,
-    };
-}
+var use_content_density_js_1 = require("./use-content-density.js");
+Object.defineProperty(exports, "useFocusMode", { enumerable: true, get: function () { return use_content_density_js_1.useContentDensity; } });
 //# sourceMappingURL=use-focus-mode.js.map

package/dist/hooks/use-focus-mode.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-focus-mode.js","sourceRoot":"","sources":["../../src/hooks/use-focus-mode.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-focus-mode.js","sourceRoot":"","sources":["../../src/hooks/use-focus-mode.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;;;;AAEZ;;;GAGG;AAEH,mEAA4E;AAAnE,sHAAA,iBAAiB,OAAgB"}

package/dist/hooks/use-virtual-messages.d.ts

@@ -1,12 +1,21 @@
 import { type Virtualizer } from "@tanstack/react-virtual";
 import type { RenderableMessage } from "../types.js";
 export declare const VIRTUALIZATION_THRESHOLD = 100;
+export declare const PRE_MEASURE_THRESHOLD = 100;
+export type MessageHeights = number | {
+    short: number;
+    long: number;
+};
 interface UseVirtualMessagesOptions {
     renderableMessages: RenderableMessage[];
     scrollRef: React.RefObject<HTMLDivElement>;
     /** Increment to force re-measurement (focus mode toggle, thread switch) */
     measureVersion?: number;
     enabled?: boolean;
+    /** Pre-measured heights from hidden containers (optional) */
+    preMeasuredHeights?: Map<string, MessageHeights>;
+    /** Returns true if message is showing full content (for short/long estimation) */
+    getMessageIsExpanded?: (messageId: string, index: number) => boolean;
 }
 export type VirtualState = {
     active: false;
@@ -15,7 +24,11 @@ export type VirtualState = {
     virtualizer: Virtualizer<HTMLDivElement, Element>;
     virtualItems: ReturnType<Virtualizer<HTMLDivElement, Element>["getVirtualItems"]>;
     totalSize: number;
+    /** True once layout has stabilized after initial render */
+    isSettled: boolean;
+    /** True during mode transition (virtualizer count briefly set to 0) */
+    isResetting: boolean;
 };
-export declare function useVirtualMessages({ renderableMessages, scrollRef, measureVersion, enabled, }: UseVirtualMessagesOptions): VirtualState;
+export declare function useVirtualMessages({ renderableMessages, scrollRef, measureVersion, enabled, preMeasuredHeights, getMessageIsExpanded, }: UseVirtualMessagesOptions): VirtualState;
 export {};
 //# sourceMappingURL=use-virtual-messages.d.ts.map

package/dist/hooks/use-virtual-messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-virtual-messages.d.ts","sourceRoot":"","sources":["../../src/hooks/use-virtual-messages.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEpD,eAAO,MAAM,wBAAwB,MAAM,CAAA;AAE3C,UAAU,yBAAyB;IACjC,kBAAkB,EAAE,iBAAiB,EAAE,CAAA;IACvC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,CAAA;IAC1C,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,GACjB;IACE,MAAM,EAAE,IAAI,CAAA;IACZ,WAAW,EAAE,WAAW,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA;IACjD,YAAY,EAAE,UAAU,CAAC,WAAW,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAA;IACjF,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAyBL,wBAAgB,kBAAkB,CAAC,EACjC,kBAAkB,EAClB,SAAS,EACT,cAAkB,EAClB,OAAc,GACf,EAAE,yBAAyB,GAAG,YAAY,CA8C1C"}
+{"version":3,"file":"use-virtual-messages.d.ts","sourceRoot":"","sources":["../../src/hooks/use-virtual-messages.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEpD,eAAO,MAAM,wBAAwB,MAAM,CAAA;AAC3C,eAAO,MAAM,qBAAqB,MAAM,CAAA;AAExC,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAErE,UAAU,yBAAyB;IACjC,kBAAkB,EAAE,iBAAiB,EAAE,CAAA;IACvC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,CAAA;IAC1C,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,6DAA6D;IAC7D,kBAAkB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IAChD,kFAAkF;IAClF,oBAAoB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;CACrE;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,GACjB;IACE,MAAM,EAAE,IAAI,CAAA;IACZ,WAAW,EAAE,WAAW,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA;IACjD,YAAY,EAAE,UAAU,CAAC,WAAW,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAA;IACjF,SAAS,EAAE,MAAM,CAAA;IACjB,2DAA2D;IAC3D,SAAS,EAAE,OAAO,CAAA;IAClB,uEAAuE;IACvE,WAAW,EAAE,OAAO,CAAA;CACrB,CAAA;AAuCL,wBAAgB,kBAAkB,CAAC,EACjC,kBAAkB,EAClB,SAAS,EACT,cAAkB,EAClB,OAAc,EACd,kBAAkB,EAClB,oBAAoB,GACrB,EAAE,yBAAyB,GAAG,YAAY,CAkH1C"}

package/dist/hooks/use-virtual-messages.js

@@ -1,57 +1,139 @@
 "use client";
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VIRTUALIZATION_THRESHOLD = void 0;
+exports.PRE_MEASURE_THRESHOLD = exports.VIRTUALIZATION_THRESHOLD = void 0;
 exports.useVirtualMessages = useVirtualMessages;
+/**
+ * useVirtualMessages — Battle-tested virtualizer for large chat histories.
+ *
+ * Ported from the legacy ChatInterface's tanstack/react-virtual integration,
+ * which included workarounds for variable-height messages, mode transitions,
+ * and mobile scrolling. Gated behind config.features.jsVirtualization.
+ *
+ * Key patterns ported from legacy:
+ * - Overscan 100 (pre-render many items above/below viewport)
+ * - Content-length-based height estimation with short/long awareness
+ * - Mode version in getItemKey for cache invalidation on view mode changes
+ * - isResetting state (count-to-0) for mode transitions
+ * - Settlement polling (50ms, 4-stable, 40-max) with 2.5s fallback
+ * - Pre-measured heights map integration for accurate initial positioning
+ */
 const react_1 = require("react");
 const react_virtual_1 = require("@tanstack/react-virtual");
 exports.VIRTUALIZATION_THRESHOLD = 100;
-function estimateMessageHeight(rm) {
-    const content = rm.message.content || "";
-    const len = content.length;
-    const charsPerLine = 80;
-    const lineHeight = 24;
-    let base;
-    if (rm.message.role === "user") {
-        base = 40;
-    }
-    else {
-        base = 60;
+exports.PRE_MEASURE_THRESHOLD = 100;
+function estimateMessageHeight(rm, preMeasuredHeights, isExpanded) {
+    const msg = rm.message;
+    const PADDING = 24;
+    if (preMeasuredHeights) {
+        const cached = preMeasuredHeights.get(msg.id);
+        if (cached) {
+            if (typeof cached === "object") {
+                return isExpanded ? cached.long : cached.short;
+            }
+            return cached;
+        }
     }
-    if (rm.showDateSeparator) {
+    let base = 0;
+    if (rm.showDateSeparator)
         base += 48;
+    if (msg.role === "user") {
+        const hasDocuments = msg.metadata?.hasDocuments;
+        return base + (hasDocuments ? 150 : 80) + PADDING;
     }
-    const lines = Math.ceil(len / charsPerLine);
-    const estimated = base + lines * lineHeight;
-    return Math.max(60, Math.min(estimated, 800));
+    const relevantContent = !isExpanded && msg.shortContent ? msg.shortContent : msg.content;
+    const contentLength = relevantContent?.length || 0;
+    if (contentLength < 200)
+        return base + 100 + PADDING;
+    if (contentLength < 500)
+        return base + 150 + PADDING;
+    if (contentLength < 1000)
+        return base + 250 + PADDING;
+    if (contentLength < 2000)
+        return base + 400 + PADDING;
+    return base + 600 + PADDING;
 }
-function useVirtualMessages({ renderableMessages, scrollRef, measureVersion = 0, enabled = true, }) {
+function useVirtualMessages({ renderableMessages, scrollRef, measureVersion = 0, enabled = true, preMeasuredHeights, getMessageIsExpanded, }) {
     const count = renderableMessages.length;
     const shouldVirtualize = enabled && count >= exports.VIRTUALIZATION_THRESHOLD;
     const messagesRef = (0, react_1.useRef)(renderableMessages);
     messagesRef.current = renderableMessages;
+    const preMeasuredRef = (0, react_1.useRef)(preMeasuredHeights);
+    preMeasuredRef.current = preMeasuredHeights;
+    const getExpandedRef = (0, react_1.useRef)(getMessageIsExpanded);
+    getExpandedRef.current = getMessageIsExpanded;
+    const [modeVersion, setModeVersion] = (0, react_1.useState)(0);
+    const [isResetting, setIsResetting] = (0, react_1.useState)(false);
+    const [isSettled, setIsSettled] = (0, react_1.useState)(!shouldVirtualize);
+    const prevMeasureVersion = (0, react_1.useRef)(measureVersion);
+    (0, react_1.useEffect)(() => {
+        if (prevMeasureVersion.current !== measureVersion && shouldVirtualize) {
+            prevMeasureVersion.current = measureVersion;
+            setIsResetting(true);
+            setIsSettled(false);
+            setModeVersion((v) => v + 1);
+            requestAnimationFrame(() => {
+                setIsResetting(false);
+            });
+        }
+    }, [measureVersion, shouldVirtualize]);
     const virtualizer = (0, react_virtual_1.useVirtualizer)({
-        count: shouldVirtualize ? count : 0,
+        count: isResetting ? 0 : shouldVirtualize ? count : 0,
         getScrollElement: () => scrollRef.current,
         estimateSize: (0, react_1.useCallback)((index) => {
             const rm = messagesRef.current[index];
             if (!rm)
                 return 100;
-            return estimateMessageHeight(rm);
+            const isExpanded = getExpandedRef.current?.(rm.message.id, index) ?? true;
+            return estimateMessageHeight(rm, preMeasuredRef.current, isExpanded);
         }, []),
         getItemKey: (0, react_1.useCallback)((index) => {
             const rm = messagesRef.current[index];
-            return rm?.message.id ?? index;
-        }, []),
-        overscan: 30,
+            return `${rm?.message.id ?? index}-v${modeVersion}`;
+        }, [modeVersion]),
+        overscan: 100,
     });
-    const prevMeasureVersion = (0, react_1.useRef)(measureVersion);
+    // Settlement polling: watch for scrollHeight stability after initial render.
+    // 50ms polling, need 4 consecutive stable checks (~200ms), give up after 40 (~2s).
     (0, react_1.useEffect)(() => {
-        if (prevMeasureVersion.current !== measureVersion && shouldVirtualize) {
-            prevMeasureVersion.current = measureVersion;
-            virtualizer.measure();
+        if (!shouldVirtualize || isResetting || isSettled)
+            return;
+        const container = scrollRef.current;
+        if (!container) {
+            setIsSettled(true);
+            return;
         }
-    }, [measureVersion, shouldVirtualize, virtualizer]);
+        let lastScrollHeight = container.scrollHeight;
+        let stableCount = 0;
+        const STABLE_THRESHOLD = 4;
+        const MAX_CHECKS = 40;
+        let checkCount = 0;
+        let pollTimer;
+        const checkSettlement = () => {
+            checkCount++;
+            const currentScrollHeight = container.scrollHeight;
+            if (currentScrollHeight !== lastScrollHeight) {
+                lastScrollHeight = currentScrollHeight;
+                stableCount = 0;
+            }
+            else {
+                stableCount++;
+            }
+            if (stableCount >= STABLE_THRESHOLD || checkCount >= MAX_CHECKS) {
+                setIsSettled(true);
+                return;
+            }
+            pollTimer = setTimeout(checkSettlement, 50);
+        };
+        pollTimer = setTimeout(checkSettlement, 50);
+        const fallbackTimer = setTimeout(() => {
+            setIsSettled(true);
+        }, 2500);
+        return () => {
+            clearTimeout(pollTimer);
+            clearTimeout(fallbackTimer);
+        };
+    }, [shouldVirtualize, isResetting, isSettled, scrollRef]);
     if (!shouldVirtualize) {
         return { active: false };
     }
@@ -60,6 +142,8 @@ function useVirtualMessages({ renderableMessages, scrollRef, measureVersion = 0,
         virtualizer,
         virtualItems: virtualizer.getVirtualItems(),
         totalSize: virtualizer.getTotalSize(),
+        isSettled,
+        isResetting,
     };
 }
 //# sourceMappingURL=use-virtual-messages.js.map