Skip to content
Source
Sign inSign up
TanStack/ai
Open History to see the last commit

DevtoolsHarness.tsx

90 lines2.9 KB

1import { useEffect, useState } from 'react'
2import { AiDevtoolsPanel } from '@tanstack/react-ai-devtools/production'
3import { ClientEventBus } from '@tanstack/devtools-event-bus/client'
4import type { ReactNode } from 'react'
5​
6// In production apps the <TanStackDevtools> host starts a ClientEventBus,
7// which is what relays aiEventClient.emit() through the window event bus
8// into aiEventClient.on() listeners. The E2E harness mounts the AI devtools
9// panel directly (bypassing that host so we don't depend on
10// NODE_ENV=development gating), so we start a bus ourselves once per page.
11const busSingletonKey = Symbol.for('tanstack.ai.devtools.e2e.clientEventBus')
12​
13function ensureEventBus(): void {
14 if (typeof window === 'undefined') return
15 const slot = globalThis as typeof globalThis & {
16 [busSingletonKey]?: ClientEventBus
17 }
18 if (slot[busSingletonKey]) return
19 const bus = new ClientEventBus()
20 bus.start()
21 slot[busSingletonKey] = bus
23​
24if (typeof window !== 'undefined') {
25 ensureEventBus()
27​
28export function DevtoolsHarness({
29 children,
30 initialOpen = false,
31}: {
32 children: ReactNode
33 initialOpen?: boolean
34}) {
35 const [isHydrated, setIsHydrated] = useState(false)
36 const [isOpen, setIsOpen] = useState(initialOpen)
37 const [hasOpened, setHasOpened] = useState(initialOpen)
38​
39 useEffect(() => {
40 setIsHydrated(true)
41 }, [])
42​
43 const openDevtools = () => {
44 setHasOpened(true)
45 setIsOpen(true)
46 }
47​
48 return (
49 <div
50 data-testid="devtools-harness"
51 className="grid min-h-[calc(100vh-58px)] grid-cols-1 gap-0 bg-gray-950 text-gray-100 lg:grid-cols-[minmax(360px,0.78fr)_minmax(520px,1.22fr)]"
52 >
53 <section className="min-h-[420px] overflow-auto border-b border-gray-800 lg:border-b-0 lg:border-r">
54 <div className="flex items-center gap-2 border-b border-gray-800 bg-gray-900/70 px-4 py-3">
55 {isHydrated ? (
56 <span data-testid="devtools-hydrated" className="sr-only">
57 hydrated
58 </span>
59 ) : null}
60 <button
61 type="button"
62 data-testid="open-devtools"
63 className="rounded bg-orange-500 px-3 py-1.5 text-sm font-medium text-white disabled:opacity-60"
64 onClick={openDevtools}
65 disabled={!isHydrated || isOpen}
66 >
67 Open Devtools
68 </button>
69 <button
70 type="button"
71 data-testid="close-devtools"
72 className="rounded border border-gray-700 px-3 py-1.5 text-sm text-gray-200 disabled:opacity-60"
73 onClick={() => setIsOpen(false)}
74 disabled={!isHydrated || !isOpen}
75 >
76 Close Devtools
77 </button>
78 </div>
79 <div className="p-4">{children}</div>
80 </section>
81 <aside
82 data-testid="devtools-panel-host"
83 className="min-h-[620px] bg-gray-950"
84 hidden={!isOpen}
85 >
86 {hasOpened ? <AiDevtoolsPanel /> : null}
87 </aside>
88 </div>
89 )