import { useEffect, useMemo, useRef, useSyncExternalStore } from 'react'; import { useI18n } from '../i18n/I18nProvider'; import { toast } from '../../components/ui/toast'; import { collectSidePanelPanes, isPluginSidePanelTool, type SidePanelLayout } from '../../domain/sidePanelLayout'; import { activeTabStore, useActiveTabId } from './activeTabStore'; import { getSidePanelLiveSnapshot, subscribeSidePanelLiveSnapshot } from './sidePanelLiveStore'; import { usePluginContributions } from './usePluginContributions'; import { OPEN_PLUGIN_VIEW_EVENT, type OpenPluginViewDetail } from './usePluginViewLifecycle'; export const OPEN_PLUGIN_TERMINAL_SIDEBAR_EVENT = 'netcatty:open-plugin-terminal-sidebar'; export const PLUGIN_TERMINAL_SIDEBAR_CONTEXT = Object.freeze({ 'netcatty.surface': 'terminal-sidebar' }); /** Required production view-context projection, not a plugin-facing API. */ export interface PluginSidebarHostActions { getActiveTerminalSessionId(): string | null; handleSwitchSidePanelTab(tool: import('../../domain/sidePanelLayout').SidePanelTool): void; handleWithdrawPluginSidebarPane(tabId: string, paneId: string, expectedTool: import('../../domain/sidePanelLayout').SidePanelTool): void; } export interface PluginTerminalSidebarPage { tool: `plugin-view:${string}`; viewId: string; pluginId: string; pluginName: string; version: string; title: string; icon?: NetcattyPluginIconReference; order: number; } export function collectPluginTerminalSidebarPages(plugins: NetcattyPluginContributionSnapshot['plugins']): PluginTerminalSidebarPage[] { return plugins.flatMap((plugin) => plugin.views.filter((view) => view.location === 'terminal-sidebar' && view.visible) .map((view): PluginTerminalSidebarPage => ({ tool: `plugin-view:${view.id}`, viewId: view.id, pluginId: plugin.id, pluginName: plugin.displayName, version: plugin.version, title: view.title, icon: view.icon, order: view.order ?? 0 }))) .sort((a, b) => a.order - b.order || a.viewId.localeCompare(b.viewId)); } export function requestOpenPluginTerminalSidebar(viewId: string, sessionId: string) { window.dispatchEvent(new CustomEvent(OPEN_PLUGIN_TERMINAL_SIDEBAR_EVENT, { detail: { viewId, sessionId } })); } export function usePluginTerminalSidebar(host: { layouts: ReadonlyMap; getSession(): string | null; isTerminalTab(tabId: string): boolean; select(tool: `plugin-view:${string}`): void; withdraw(tabId: string, paneId: string, tool: `plugin-view:${string}`): void; }) { const { locale, t } = useI18n(); const activeTabId = useActiveTabId(); // Follow workspace focus without subscribing the whole sidebar to cwd/title // or forwarding the host's live session DTO to a plugin. useSyncExternalStore((listener) => subscribeSidePanelLiveSnapshot(true, listener), () => getSidePanelLiveSnapshot(true).focusedSessionId, () => null); const hostRef = useRef(host); hostRef.current = host; const contributions = usePluginContributions({ locale, context: PLUGIN_TERMINAL_SIDEBAR_CONTEXT }); const pages = useMemo(() => collectPluginTerminalSidebarPages(contributions.snapshot.plugins), [contributions.snapshot.plugins]); const sessionId = activeTabId && host.isTerminalTab(activeTabId) ? host.getSession() : null; useEffect(() => { const open = (event: Event) => { const detail = (event as CustomEvent).detail; const page = pages.find((item) => item.viewId === detail?.viewId); if (!page) return; const tabId = activeTabStore.getActiveTabId(); const current = hostRef.current.getSession(); if (!hostRef.current.isTerminalTab(tabId) || !current || (detail.sessionId && detail.sessionId !== current)) { toast.info(t('plugins.sidebar.selectTerminal')); return; } hostRef.current.select(page.tool); }; window.addEventListener(OPEN_PLUGIN_TERMINAL_SIDEBAR_EVENT, open); window.addEventListener(OPEN_PLUGIN_VIEW_EVENT, open); return () => { window.removeEventListener(OPEN_PLUGIN_TERMINAL_SIDEBAR_EVENT, open); window.removeEventListener(OPEN_PLUGIN_VIEW_EVENT, open); }; }, [pages, t]); useEffect(() => { if (contributions.loading) return; const allowed = new Set(pages.map((page) => page.tool)); for (const [tabId, layout] of host.layouts) for (const pane of collectSidePanelPanes(layout.root)) { if (isPluginSidePanelTool(pane.tool) && !allowed.has(pane.tool)) host.withdraw(tabId, pane.id, pane.tool); } }, [contributions.loading, host, pages]); return { pages, contributions, tabId: activeTabId, sessionId }; }