Open History to see the last commit
1import { workspaceAreaProps } from "../../lib/workspaceFocus";
2import {
3 useLayoutEffect,
4 useState,
5 type MouseEventHandler,
6 type ReactNode,
7 type RefObject,
8} from "react";
9import type { ScopedThreadRef } from "@t3tools/contracts";
10import { ScrollArea } from "../ui/scroll-area";
11import { cn } from "../../lib/utils";
12import { Popover, PopoverPopup, PopoverCreateHandle } from "../ui/popover";
13import { selectThreadPanelOpen, useRightPanelStore } from "../../rightPanelStore";
14import { useChatCanvas } from "./ChatCanvasContext";
15import {
16 THREAD_DETAILS_CARD_GAP,
17 resolveThreadDetailsCardDensity,
18} from "./threadDetailsCardLayout";
19import { observeResize } from "../../lib/observeResize";
20import { requestWorkspaceFocus } from "../../lib/workspaceFocus";
21
22export function ThreadDetailsCard({
23 threadRef,
24 anchor,
25 handle,
26 contentKey,
27 onContextMenu,
28 children,
29}: {
30 threadRef: ScopedThreadRef;
31 anchor: RefObject<Element | null>;
32 handle: ReturnType<typeof PopoverCreateHandle>;
33 /** Changes when the set of rendered items changes, so cached heights are measured again. */
34 contentKey: string;
35 onContextMenu?: MouseEventHandler<HTMLDivElement>;
36 children: (density: "full" | "compact" | "essential") => ReactNode;
37}) {
38 const detailsArea = workspaceAreaProps("details", 3, "Thread details");
39 const canvas = useChatCanvas();
40 const preferredPlacement = canvas?.preferredDetailsCard ?? null;
41 const placement = canvas?.detailsCardPlacement ?? null;
42 const mode = placement ? "inline" : "popover";
43 const topInset = canvas?.detailsCardTopInset ?? 0;
44 const inlineOpen = useRightPanelStore((state) =>
45 selectThreadPanelOpen(state.threadPanelVisibilityByThreadKey, threadRef, "inline"),
46 );
47 const popoverOpen = useRightPanelStore((state) =>
48 selectThreadPanelOpen(state.threadPanelVisibilityByThreadKey, threadRef, "popover"),
49 );
50 const measurementKey = `${threadRef.environmentId}:${threadRef.threadId}:${preferredPlacement?.width ?? "popup"}:${contentKey}`;
51 const [measurements, setMeasurements] = useState({
52 key: measurementKey,
53 heights: { full: 0, compact: 0 },
54 });
55 const contentHeights =
56 measurements.key === measurementKey ? measurements.heights : { full: 0, compact: 0 };
57 const height = placement?.height ?? Math.max(0, (canvas?.container.height ?? 0) - 52);
58 const density = resolveThreadDetailsCardDensity(height, contentHeights);
59 const measureDetailsCard = canvas?.measureDetailsCard;
60 const cardWidth = preferredPlacement?.width;
61 // The mode derives from canvas measurements, the preview frame and the
62 // inline flag, which live in three stores, so no single write site sees the
63 // card leave popover mode. A flag left set would reopen the popover unasked
64 // when the card returns to popover mode.
65 // oxlint-disable-next-line t3code/no-unreasoned-state-sync -- closes the popover flag in the right panel store when the derived mode turns inline
66 useLayoutEffect(() => {
67 if (mode === "inline" && popoverOpen)
68 useRightPanelStore.getState().setThreadPanelOpen(threadRef, "popover", false);
69 }, [mode, popoverOpen, threadRef]);
70 const [contentElement, setContentElement] = useState<HTMLDivElement | null>(null);
71 const { environmentId, threadId } = threadRef;
72 // Re-measures when the density or measurement key changes, so each density's
73 // height is measured once it renders.
74 // oxlint-disable-next-line t3code/no-unreasoned-state-sync -- measures the card's DOM height via ResizeObserver and reports it to the canvas
75 useLayoutEffect(() => {
76 const element = contentElement;
77 if (!element || density === "essential") return;
78 const measure = () => {
79 const frame = element.closest<HTMLElement>("[data-thread-details-card]");
80 const next = element.offsetHeight + (frame ? frame.offsetHeight - frame.clientHeight : 0);
81 // PR lists, servers, lineage, side chats and automations scroll as they grow. Counting them
82 // toward density would hide the section and workspace controls when the user asks to see more.
83 const lists = element.querySelectorAll<HTMLElement>(
84 "[data-thread-relationships-panel], [data-thread-side-chats-panel], [data-thread-details-pr-list], [data-thread-automations-panel], [data-thread-details-server-overflow]",
85 );
86 const fittingHeight =
87 next - Array.from(lists).reduce((sum, list) => sum + list.offsetHeight, 0);
88 setMeasurements((current) => {
89 const heights = current.key === measurementKey ? current.heights : { full: 0, compact: 0 };
90 return current.key === measurementKey && heights[density] === fittingHeight
91 ? current
92 : { key: measurementKey, heights: { ...heights, [density]: fittingHeight } };
93 });
94 // Only the laid-out DOM knows the full card height, and the canvas keeps preview
95 // frames clear of it, so it is reported from this measure effect.
96 if (density === "full" && cardWidth !== undefined) {
97 measureDetailsCard?.({
98 threadRef: { environmentId, threadId },
99 width: cardWidth,
100 fullContentHeight: next,
101 });
102 }
103 };
104 measure();
105 return observeResize(element, measure);
106 }, [
107 contentElement,
108 density,
109 measurementKey,
110 cardWidth,
111 measureDetailsCard,
112 environmentId,
113 threadId,
114 ]);
115 const card = (
116 <div
117 className={cn(
118 "dropdown-glass isolate contain-paint grid max-h-full grid-rows-[minmax(0,1fr)] overflow-hidden rounded-2xl",
119 mode === "popover" &&
120 "max-h-[min(calc(100dvh-6.5rem),calc(var(--available-height,100dvh)-1rem))]",
121 )}
122 style={placement ? { maxHeight: height } : undefined}
123 onContextMenu={onContextMenu}
124 data-thread-details-card
125 >
126 <ScrollArea scrollFade className="min-h-0">
127 <div ref={setContentElement}>{children(density)}</div>
128 </ScrollArea>
129 </div>
130 );
131 return (
132 <Popover
133 handle={handle}
134 open={mode === "popover" && popoverOpen}
135 onOpenChange={(open, details) => {
136 const target =
137 details.reason === "focus-out"
138 ? (details.event as FocusEvent).relatedTarget
139 : details.reason === "outside-press"
140 ? details.event.target
141 : null;
142 if (!open && target instanceof Element && target.closest("[data-thread-find-bar]")) {
143 details.cancel();
144 return;
145 }
146 useRightPanelStore.getState().setThreadPanelOpen(threadRef, "popover", open);
147 }}
148 >
149 {placement && inlineOpen ? (
150 <aside
151 {...detailsArea}
152 data-workspace-focus-key={`details:${threadRef.environmentId}:${threadRef.threadId}`}
153 // Skip the return transition to avoid overlapping the rising preview.
154 className={cn(
155 "absolute z-20",
156 topInset > 0 && "transition-[top] duration-150 ease-out motion-reduce:transition-none",
157 )}
158 style={{
159 right: placement.right,
160 top: placement.y,
161 width: placement.width,
162 maxHeight: height,
163 }}
164 data-density={density}
165 data-thread-details-panel="inline"
166 >
167 {card}
168 </aside>
169 ) : null}
170 {/* Rendered in both modes: base-ui keeps a popup that unmounts mid-open
171 mounted, because its exit animation never finishes. Staying in the tree
172 lets it close cleanly when the card switches inline. */}
173 <PopoverPopup
174 {...(mode === "popover" ? detailsArea : {})}
175 role="dialog"
176 data-workspace-focus-key={`details:${threadRef.environmentId}:${threadRef.threadId}`}
177 initialFocus={() => {
178 requestWorkspaceFocus({ area: "details" });
179 return false;
180 }}
181 anchor={anchor}
182 align="end"
183 // Account for the find panel's 8px card padding.
184 alignOffset={THREAD_DETAILS_CARD_GAP - 8}
185 collisionAvoidance={{ side: "shift", align: "shift", fallbackAxisSide: "none" }}
186 side="bottom"
187 sideOffset={topInset}
188 variant="panel"
189 padding="none"
190 >
191 {mode === "popover" ? (
192 <div data-density={density} data-thread-details-panel="popover">
193 {card}
194 </div>
195 ) : null}
196 </PopoverPopup>
197 </Popover>
198 );
199}