/** * Hook for LSP plugin recommendations * * Detects file edits and recommends LSP plugins when: * - File extension matches an LSP plugin * - LSP binary is already installed on the system * - Plugin is not already installed * - User hasn't disabled recommendations * * Only shows one recommendation per session. */ import { extname, join } from 'path' import * as React from 'react' import { hasShownLspRecommendationThisSession, setLspRecommendationShownThisSession, } from '../bootstrap/state.js' import { useNotifications } from '../context/notifications.js' import { useAppState } from '../state/AppState.js' import { saveGlobalConfig } from '../utils/config.js' import { logForDebugging } from '../utils/debug.js' import { logError } from '../utils/log.js' import { addToNeverSuggest, getMatchingLspPlugins, incrementIgnoredCount, } from '../utils/plugins/lspRecommendation.js' import { cacheAndRegisterPlugin } from '../utils/plugins/pluginInstallationHelpers.js' import { getSettingsForSource, updateSettingsForSource, } from '../utils/settings/settings.js' import { installPluginAndNotify, usePluginRecommendationBase, } from './usePluginRecommendationBase.js' // Threshold for detecting timeout vs explicit dismiss (ms) // Menu auto-dismisses at 30s, so anything over 28s is likely timeout const TIMEOUT_THRESHOLD_MS = 28_000 export type LspRecommendationState = { pluginId: string pluginName: string pluginDescription?: string fileExtension: string shownAt: number // Timestamp for timeout detection } | null type UseLspPluginRecommendationResult = { recommendation: LspRecommendationState handleResponse: (response: 'yes' | 'no' | 'never' | 'disable') => void } export function useLspPluginRecommendation(): UseLspPluginRecommendationResult { const trackedFiles = useAppState(s => s.fileHistory.trackedFiles) const { addNotification } = useNotifications() const checkedFilesRef = React.useRef>(new Set()) const { recommendation, clearRecommendation, tryResolve } = usePluginRecommendationBase>() React.useEffect(() => { tryResolve(async () => { if (hasShownLspRecommendationThisSession()) return null const newFiles: string[] = [] for (const file of trackedFiles) { if (!checkedFilesRef.current.has(file)) { checkedFilesRef.current.add(file) newFiles.push(file) } } for (const filePath of newFiles) { try { const matches = await getMatchingLspPlugins(filePath) const match = matches[0] // official plugins prioritized if (match) { logForDebugging( `[useLspPluginRecommendation] Found match: ${match.pluginName} for ${filePath}`, ) setLspRecommendationShownThisSession(true) return { pluginId: match.pluginId, pluginName: match.pluginName, pluginDescription: match.description, fileExtension: extname(filePath), shownAt: Date.now(), } } } catch (error) { logError(error) } } return null }) }, [trackedFiles, tryResolve]) const handleResponse = React.useCallback( (response: 'yes' | 'no' | 'never' | 'disable') => { if (!recommendation) return const { pluginId, pluginName, shownAt } = recommendation logForDebugging( `[useLspPluginRecommendation] User response: ${response} for ${pluginName}`, ) switch (response) { case 'yes': void installPluginAndNotify( pluginId, pluginName, 'lsp-plugin', addNotification, async pluginData => { logForDebugging( `[useLspPluginRecommendation] Installing plugin: ${pluginId}`, ) const localSourcePath = typeof pluginData.entry.source === 'string' ? join( pluginData.marketplaceInstallLocation, pluginData.entry.source, ) : undefined await cacheAndRegisterPlugin( pluginId, pluginData.entry, 'user', undefined, // projectPath - not needed for user scope localSourcePath, ) // Enable in user settings so it loads on restart const settings = getSettingsForSource('userSettings') updateSettingsForSource('userSettings', { enabledPlugins: { ...settings?.enabledPlugins, [pluginId]: true, }, }) logForDebugging( `[useLspPluginRecommendation] Plugin installed: ${pluginId}`, ) }, ) break case 'no': { const elapsed = Date.now() - shownAt if (elapsed >= TIMEOUT_THRESHOLD_MS) { logForDebugging( `[useLspPluginRecommendation] Timeout detected (${elapsed}ms), incrementing ignored count`, ) incrementIgnoredCount() } break } case 'never': addToNeverSuggest(pluginId) break case 'disable': saveGlobalConfig(current => { if (current.lspRecommendationDisabled) return current return { ...current, lspRecommendationDisabled: true } }) break } clearRecommendation() }, [recommendation, addNotification, clearRecommendation], ) return { recommendation, handleResponse } }