import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState, type SetStateAction } from 'react'; import { runThemeTransition } from './themeTransition'; import { SyncConfig, TerminalSettings, HotkeyScheme, CustomKeyBindings, DEFAULT_KEY_BINDINGS, KeyBinding, UILanguage, SessionLogFormat, normalizeTerminalSettings } from '../../domain/models'; import { STORAGE_KEY_COLOR, STORAGE_KEY_SYNC, STORAGE_KEY_TERM_THEME, STORAGE_KEY_TERM_FOLLOW_APP_THEME, STORAGE_KEY_TERM_THEME_DARK, STORAGE_KEY_TERM_THEME_LIGHT, STORAGE_KEY_THEME, STORAGE_KEY_TERM_FONT_FAMILY, STORAGE_KEY_TERM_FONT_SIZE, STORAGE_KEY_TERM_SETTINGS, STORAGE_KEY_HOTKEY_SCHEME, STORAGE_KEY_CUSTOM_KEY_BINDINGS, STORAGE_KEY_HOTKEY_RECORDING, STORAGE_KEY_CUSTOM_CSS, STORAGE_KEY_UI_LANGUAGE, STORAGE_KEY_ACCENT_MODE, STORAGE_KEY_UI_THEME_LIGHT, STORAGE_KEY_UI_THEME_DARK, STORAGE_KEY_UI_FONT_FAMILY, STORAGE_KEY_SFTP_DOUBLE_CLICK_BEHAVIOR, STORAGE_KEY_SFTP_AUTO_SYNC, STORAGE_KEY_SFTP_SHOW_HIDDEN_FILES, STORAGE_KEY_SFTP_USE_COMPRESSED_UPLOAD, STORAGE_KEY_SFTP_AUTO_OPEN_SIDEBAR, STORAGE_KEY_SFTP_FOLLOW_TERMINAL_CWD, STORAGE_KEY_SFTP_TRANSFER_CONCURRENCY, STORAGE_KEY_SFTP_DEFAULT_VIEW_MODE, STORAGE_KEY_EDITOR_WORD_WRAP, STORAGE_KEY_SESSION_LOGS_ENABLED, STORAGE_KEY_SESSION_LOGS_DIR, STORAGE_KEY_SESSION_LOGS_FORMAT, STORAGE_KEY_SESSION_LOGS_TIMESTAMPS_ENABLED, STORAGE_KEY_SSH_DEBUG_LOGS_ENABLED, STORAGE_KEY_TOGGLE_WINDOW_HOTKEY, STORAGE_KEY_CLOSE_TO_TRAY, STORAGE_KEY_GLOBAL_HOTKEY_ENABLED, STORAGE_KEY_WINDOW_OPACITY, STORAGE_KEY_AUTO_UPDATE_ENABLED, STORAGE_KEY_WORKSPACE_FOCUS_STYLE, STORAGE_KEY_SHOW_RECENT_HOSTS, STORAGE_KEY_SHOW_ONLY_UNGROUPED_HOSTS_IN_ROOT, STORAGE_KEY_SHOW_SFTP_TAB, STORAGE_KEY_SHOW_HOST_TREE_SIDEBAR, STORAGE_KEY_SHELL_ONLY_TAB_NUMBER_SHORTCUTS, STORAGE_KEY_DISABLE_TERMINAL_FONT_ZOOM, } from '../../infrastructure/config/storageKeys'; import { DEFAULT_UI_LOCALE, resolveSupportedLocale } from '../../infrastructure/config/i18n'; import { areCustomKeyBindingsEqual, nextCustomKeyBindingsSyncVersion, parseCustomKeyBindingsStorageRecord, resetCustomKeyBinding, serializeCustomKeyBindingsStorageRecord, shouldApplyIncomingCustomKeyBindingsRecord, updateCustomKeyBinding as updateCustomKeyBindingRecord, } from '../../domain/customKeyBindings'; import { TERMINAL_THEME_AUTO } from '../../domain/terminalAppearance'; import { customThemeStore, useCustomThemes } from '../state/customThemeStore'; import { DEFAULT_FONT_SIZE } from '../../infrastructure/config/fonts'; import { getUiThemeById } from '../../infrastructure/config/uiThemes'; import { DEFAULT_UI_FONT_ID } from '../../infrastructure/config/uiFonts'; import { uiFontStore, useUIFontsLoaded } from './uiFontStore'; import { localStorageAdapter } from '../../infrastructure/persistence/localStorageAdapter'; import { netcattyBridge } from '../../infrastructure/services/netcattyBridge'; import { DEFAULT_ACCENT_MODE, DEFAULT_CUSTOM_ACCENT, DEFAULT_DARK_UI_THEME, DEFAULT_EDITOR_WORD_WRAP, DEFAULT_FONT_FAMILY, DEFAULT_HOTKEY_SCHEME, DEFAULT_LIGHT_UI_THEME, DEFAULT_SESSION_LOGS_ENABLED, DEFAULT_SESSION_LOGS_FORMAT, DEFAULT_SESSION_LOGS_TIMESTAMPS_ENABLED, DEFAULT_SFTP_AUTO_OPEN_SIDEBAR, DEFAULT_SFTP_FOLLOW_TERMINAL_CWD, DEFAULT_SFTP_AUTO_SYNC, DEFAULT_SFTP_DEFAULT_VIEW_MODE, DEFAULT_SFTP_DOUBLE_CLICK_BEHAVIOR, DEFAULT_SFTP_SHOW_HIDDEN_FILES, DEFAULT_SFTP_USE_COMPRESSED_UPLOAD, DEFAULT_SHOW_ONLY_UNGROUPED_HOSTS_IN_ROOT, DEFAULT_SHOW_RECENT_HOSTS, DEFAULT_SHOW_SFTP_TAB, DEFAULT_SHOW_HOST_TREE_SIDEBAR, DEFAULT_SHELL_ONLY_TAB_NUMBER_SHORTCUTS, DEFAULT_DISABLE_TERMINAL_FONT_ZOOM, DEFAULT_SSH_DEBUG_LOGS_ENABLED, DEFAULT_TERMINAL_THEME, DEFAULT_THEME, DEFAULT_WINDOW_OPACITY, clampWindowOpacity, applyThemeTokens, areTerminalSettingsEqual, createCustomKeyBindingsSyncOrigin, getSystemPreference, isValidHslToken, isValidTheme, isValidUiFontId, isValidUiThemeId, migrateIncomingTerminalFontId, readStoredString, serializeTerminalSettings, } from './settingsStateDefaults'; import { useSettingsStorageSync } from './settingsStorageSync'; import { useSettingsIpcSync } from './settingsIpcSync'; import { resolveCurrentTerminalTheme } from './settingsTerminalTheme'; import { useSystemSettingsEffects } from './systemSettingsEffects'; import { applyCustomCssToDocument } from '../../lib/customCss'; export const useSettingsState = () => { const initialCustomKeyBindingsRecord = parseCustomKeyBindingsStorageRecord(localStorageAdapter.readString(STORAGE_KEY_CUSTOM_KEY_BINDINGS)); const uiFontsLoaded = useUIFontsLoaded(); const [theme, setTheme] = useState<'dark' | 'light' | 'system'>(() => { const stored = readStoredString(STORAGE_KEY_THEME); return stored && isValidTheme(stored) ? stored : DEFAULT_THEME; }); // Track the OS color scheme preference (updated by matchMedia listener) const [systemPreference, setSystemPreference] = useState<'light' | 'dark'>(getSystemPreference); // resolvedTheme is always 'light' or 'dark' — derived synchronously from theme + OS preference const resolvedTheme: 'light' | 'dark' = theme === 'system' ? systemPreference : theme; const [lightUiThemeId, setLightUiThemeId] = useState(() => { const stored = readStoredString(STORAGE_KEY_UI_THEME_LIGHT); return stored && isValidUiThemeId('light', stored) ? stored : DEFAULT_LIGHT_UI_THEME; }); const [darkUiThemeId, setDarkUiThemeId] = useState(() => { const stored = readStoredString(STORAGE_KEY_UI_THEME_DARK); return stored && isValidUiThemeId('dark', stored) ? stored : DEFAULT_DARK_UI_THEME; }); const [customAccent, setCustomAccent] = useState(() => { const stored = readStoredString(STORAGE_KEY_COLOR); return stored && isValidHslToken(stored) ? stored.trim() : DEFAULT_CUSTOM_ACCENT; }); const [accentMode, setAccentMode] = useState<'theme' | 'custom'>(() => { const stored = readStoredString(STORAGE_KEY_ACCENT_MODE); if (stored === 'theme' || stored === 'custom') return stored; const legacyColor = readStoredString(STORAGE_KEY_COLOR); return legacyColor && isValidHslToken(legacyColor) ? 'custom' : DEFAULT_ACCENT_MODE; }); const [uiFontFamilyId, setUiFontFamilyId] = useState(() => { const stored = readStoredString(STORAGE_KEY_UI_FONT_FAMILY); return stored && isValidUiFontId(stored) ? stored : DEFAULT_UI_FONT_ID; }); const [syncConfig, setSyncConfig] = useState(() => localStorageAdapter.read(STORAGE_KEY_SYNC)); const [terminalThemeId, setTerminalThemeId] = useState(() => localStorageAdapter.readString(STORAGE_KEY_TERM_THEME) || DEFAULT_TERMINAL_THEME); const [followAppTerminalTheme, setFollowAppTerminalThemeState] = useState(() => { const stored = localStorageAdapter.readString(STORAGE_KEY_TERM_FOLLOW_APP_THEME); if (stored !== null) return stored === 'true'; // First time seeing this key. For genuinely fresh installs (no existing // terminal theme in storage) default ON so the terminal matches the app // theme out of the box. For upgrades from an older version (existing // terminal theme present) default OFF to avoid silently overriding the // user's manual choice. const isUpgrade = !!localStorageAdapter.readString(STORAGE_KEY_TERM_THEME); return !isUpgrade; }); const [terminalThemeDarkId, setTerminalThemeDarkId] = useState( () => localStorageAdapter.readString(STORAGE_KEY_TERM_THEME_DARK) || TERMINAL_THEME_AUTO, ); const [terminalThemeLightId, setTerminalThemeLightId] = useState( () => localStorageAdapter.readString(STORAGE_KEY_TERM_THEME_LIGHT) || TERMINAL_THEME_AUTO, ); const [terminalFontFamilyId, setTerminalFontFamilyId] = useState(() => { const stored = localStorageAdapter.readString(STORAGE_KEY_TERM_FONT_FAMILY); return migrateIncomingTerminalFontId(stored) ?? DEFAULT_FONT_FAMILY; }); const [terminalFontSize, setTerminalFontSize] = useState(() => localStorageAdapter.readNumber(STORAGE_KEY_TERM_FONT_SIZE) || DEFAULT_FONT_SIZE); const [uiLanguage, setUiLanguage] = useState(() => { const stored = readStoredString(STORAGE_KEY_UI_LANGUAGE); return resolveSupportedLocale(stored || DEFAULT_UI_LOCALE); }); const [terminalSettings, setTerminalSettingsState] = useState(() => { const stored = localStorageAdapter.read(STORAGE_KEY_TERM_SETTINGS); return normalizeTerminalSettings(stored); }); const [hotkeyScheme, setHotkeyScheme] = useState(() => { const stored = localStorageAdapter.readString(STORAGE_KEY_HOTKEY_SCHEME); // Validate stored value is a valid HotkeyScheme if (stored === 'disabled' || stored === 'mac' || stored === 'pc') { return stored; } return DEFAULT_HOTKEY_SCHEME; }); const [customKeyBindings, setCustomKeyBindingsState] = useState(() => initialCustomKeyBindingsRecord?.bindings || {} ); const [isHotkeyRecording, setIsHotkeyRecordingState] = useState(false); const [customCSS, setCustomCSS] = useState(() => localStorageAdapter.readString(STORAGE_KEY_CUSTOM_CSS) || '' ); const [sftpDoubleClickBehavior, setSftpDoubleClickBehavior] = useState<'open' | 'transfer'>(() => { const stored = readStoredString(STORAGE_KEY_SFTP_DOUBLE_CLICK_BEHAVIOR); return (stored === 'open' || stored === 'transfer') ? stored : DEFAULT_SFTP_DOUBLE_CLICK_BEHAVIOR; }); const [sftpAutoSync, setSftpAutoSync] = useState(() => { const stored = readStoredString(STORAGE_KEY_SFTP_AUTO_SYNC); return stored === 'true' ? true : DEFAULT_SFTP_AUTO_SYNC; }); const [sftpShowHiddenFiles, setSftpShowHiddenFiles] = useState(() => { const stored = readStoredString(STORAGE_KEY_SFTP_SHOW_HIDDEN_FILES); return stored === 'true' ? true : DEFAULT_SFTP_SHOW_HIDDEN_FILES; }); const [sftpUseCompressedUpload, setSftpUseCompressedUpload] = useState(() => { const stored = readStoredString(STORAGE_KEY_SFTP_USE_COMPRESSED_UPLOAD); // 兼容旧的设置值 if (stored === 'true' || stored === 'enabled' || stored === 'ask') return true; if (stored === 'false' || stored === 'disabled') return false; return DEFAULT_SFTP_USE_COMPRESSED_UPLOAD; }); const [sftpAutoOpenSidebar, setSftpAutoOpenSidebar] = useState(() => { const stored = readStoredString(STORAGE_KEY_SFTP_AUTO_OPEN_SIDEBAR); return stored === 'true' ? true : DEFAULT_SFTP_AUTO_OPEN_SIDEBAR; }); const [sftpFollowTerminalCwd, setSftpFollowTerminalCwd] = useState(() => { const stored = readStoredString(STORAGE_KEY_SFTP_FOLLOW_TERMINAL_CWD); return stored === 'true' ? true : DEFAULT_SFTP_FOLLOW_TERMINAL_CWD; }); const [sftpDefaultViewMode, setSftpDefaultViewMode] = useState<'list' | 'tree'>(() => { const stored = readStoredString(STORAGE_KEY_SFTP_DEFAULT_VIEW_MODE); return (stored === 'list' || stored === 'tree') ? stored : DEFAULT_SFTP_DEFAULT_VIEW_MODE; }); const [showRecentHosts, setShowRecentHostsState] = useState(() => { const stored = localStorageAdapter.readBoolean(STORAGE_KEY_SHOW_RECENT_HOSTS); return stored ?? DEFAULT_SHOW_RECENT_HOSTS; }); const [showOnlyUngroupedHostsInRoot, setShowOnlyUngroupedHostsInRootState] = useState(() => { const stored = localStorageAdapter.readBoolean(STORAGE_KEY_SHOW_ONLY_UNGROUPED_HOSTS_IN_ROOT); return stored ?? DEFAULT_SHOW_ONLY_UNGROUPED_HOSTS_IN_ROOT; }); const [showSftpTab, setShowSftpTabState] = useState(() => { const stored = localStorageAdapter.readBoolean(STORAGE_KEY_SHOW_SFTP_TAB); return stored ?? DEFAULT_SHOW_SFTP_TAB; }); const [showHostTreeSidebar, setShowHostTreeSidebarState] = useState(() => { const stored = localStorageAdapter.readBoolean(STORAGE_KEY_SHOW_HOST_TREE_SIDEBAR); return stored ?? DEFAULT_SHOW_HOST_TREE_SIDEBAR; }); const [shellOnlyTabNumberShortcuts, setShellOnlyTabNumberShortcutsState] = useState(() => { const stored = localStorageAdapter.readBoolean(STORAGE_KEY_SHELL_ONLY_TAB_NUMBER_SHORTCUTS); return stored ?? DEFAULT_SHELL_ONLY_TAB_NUMBER_SHORTCUTS; }); const [disableTerminalFontZoom, setDisableTerminalFontZoomState] = useState(() => { const stored = localStorageAdapter.readBoolean(STORAGE_KEY_DISABLE_TERMINAL_FONT_ZOOM); return stored ?? DEFAULT_DISABLE_TERMINAL_FONT_ZOOM; }); const [sftpTransferConcurrency, setSftpTransferConcurrencyState] = useState(() => { const stored = localStorageAdapter.readNumber(STORAGE_KEY_SFTP_TRANSFER_CONCURRENCY); return stored != null && stored >= 1 && stored <= 16 ? stored : 4; }); // Editor Settings const [editorWordWrap, setEditorWordWrapState] = useState(() => { const stored = readStoredString(STORAGE_KEY_EDITOR_WORD_WRAP); return stored === 'true' ? true : DEFAULT_EDITOR_WORD_WRAP; }); // Session Logs Settings const [sessionLogsEnabled, setSessionLogsEnabled] = useState(() => { const stored = readStoredString(STORAGE_KEY_SESSION_LOGS_ENABLED); return stored === 'true' ? true : DEFAULT_SESSION_LOGS_ENABLED; }); const [sessionLogsDir, setSessionLogsDir] = useState(() => { return readStoredString(STORAGE_KEY_SESSION_LOGS_DIR) || ''; }); const [sessionLogsFormat, setSessionLogsFormat] = useState(() => { const stored = readStoredString(STORAGE_KEY_SESSION_LOGS_FORMAT); if (stored === 'txt' || stored === 'raw' || stored === 'html') return stored; return DEFAULT_SESSION_LOGS_FORMAT; }); const [sessionLogsTimestampsEnabled, setSessionLogsTimestampsEnabled] = useState(() => { const stored = readStoredString(STORAGE_KEY_SESSION_LOGS_TIMESTAMPS_ENABLED); return stored === 'true' ? true : DEFAULT_SESSION_LOGS_TIMESTAMPS_ENABLED; }); const [sshDebugLogsEnabled, setSshDebugLogsEnabled] = useState(() => { const stored = readStoredString(STORAGE_KEY_SSH_DEBUG_LOGS_ENABLED); return stored === 'true' ? true : DEFAULT_SSH_DEBUG_LOGS_ENABLED; }); // Global Toggle Window Settings (Quake Mode) const [toggleWindowHotkey, setToggleWindowHotkey] = useState(() => { const stored = readStoredString(STORAGE_KEY_TOGGLE_WINDOW_HOTKEY); if (stored !== null) return stored; // Default: Ctrl+` (Control+backtick) - similar to VS Code terminal toggle const isMac = typeof navigator !== 'undefined' && /Mac/i.test(navigator.platform); return isMac ? '⌃ + `' : 'Ctrl + `'; }); const [closeToTray, setCloseToTray] = useState(() => { const stored = readStoredString(STORAGE_KEY_CLOSE_TO_TRAY); // Default to true (enabled) if (stored === null) return true; return stored === 'true'; }); const [autoUpdateEnabled, setAutoUpdateEnabled] = useState(() => { const stored = readStoredString(STORAGE_KEY_AUTO_UPDATE_ENABLED); if (stored === null) return true; // Default to enabled return stored === 'true'; }); const [hotkeyRegistrationError, setHotkeyRegistrationError] = useState(null); const [globalHotkeyEnabled, setGlobalHotkeyEnabled] = useState(() => { const stored = readStoredString(STORAGE_KEY_GLOBAL_HOTKEY_ENABLED); if (stored === null) return true; // Default to enabled return stored === 'true'; }); const [windowOpacity, setWindowOpacityState] = useState(() => { const stored = readStoredString(STORAGE_KEY_WINDOW_OPACITY); if (stored === null) return DEFAULT_WINDOW_OPACITY; return clampWindowOpacity(stored); }); const setWindowOpacity = useCallback((nextValue: SetStateAction) => { setWindowOpacityState((prev) => { const candidate = typeof nextValue === 'function' ? (nextValue as (prevState: number) => number)(prev) : nextValue; return clampWindowOpacity(candidate); }); }, []); const incomingTerminalSettingsSignatureRef = useRef(null); const localTerminalSettingsVersionRef = useRef(0); const broadcastedLocalTerminalSettingsVersionRef = useRef(0); const customKeyBindingsVersionRef = useRef(initialCustomKeyBindingsRecord?.version || 0); const customKeyBindingsOriginRef = useRef(initialCustomKeyBindingsRecord?.origin || 'legacy'); const customKeyBindingsLocalOriginRef = useRef(createCustomKeyBindingsSyncOrigin()); const customKeyBindingsMutationSourceRef = useRef<'local' | 'incoming'>('local'); // Fix 1: Mount guard — skip redundant IPC broadcasts & localStorage writes on initial mount. // Set to true by the LAST useEffect declaration; all persist effects see false on first render. const persistMountedRef = useRef(false); const setTerminalSettings = useCallback((nextValue: SetStateAction) => { setTerminalSettingsState((prev) => { const candidate = typeof nextValue === 'function' ? (nextValue as (prevState: TerminalSettings) => TerminalSettings)(prev) : nextValue; const next = normalizeTerminalSettings(candidate); if (areTerminalSettingsEqual(prev, next)) { return prev; } localTerminalSettingsVersionRef.current += 1; return next; }); }, []); const mergeIncomingTerminalSettings = useCallback((incoming: Partial) => { setTerminalSettingsState((prev) => { const next = normalizeTerminalSettings({ ...prev, ...incoming }); if (areTerminalSettingsEqual(prev, next)) { return prev; } // Mark the exact incoming snapshot so only this state is skipped for IPC rebroadcast. incomingTerminalSettingsSignatureRef.current = serializeTerminalSettings(next); return next; }); }, []); const setCustomKeyBindings = useCallback((nextValue: SetStateAction) => { setCustomKeyBindingsState((prev) => { const candidate = typeof nextValue === 'function' ? (nextValue as (prevState: CustomKeyBindings) => CustomKeyBindings)(prev) : nextValue; if (areCustomKeyBindingsEqual(prev, candidate)) { return prev; } customKeyBindingsVersionRef.current = nextCustomKeyBindingsSyncVersion( customKeyBindingsVersionRef.current, ); customKeyBindingsOriginRef.current = customKeyBindingsLocalOriginRef.current; customKeyBindingsMutationSourceRef.current = 'local'; return candidate; }); }, []); const applyIncomingCustomKeyBindings = useCallback((incoming: { bindings: CustomKeyBindings; version: number; origin: string; }) => { setCustomKeyBindingsState((prev) => { if (!shouldApplyIncomingCustomKeyBindingsRecord( { version: customKeyBindingsVersionRef.current, origin: customKeyBindingsOriginRef.current, }, { version: incoming.version, origin: incoming.origin, }, )) { return prev; } customKeyBindingsVersionRef.current = incoming.version; customKeyBindingsOriginRef.current = incoming.origin; customKeyBindingsMutationSourceRef.current = 'incoming'; if (areCustomKeyBindingsEqual(prev, incoming.bindings)) { return prev; } return incoming.bindings; }); }, []); // Helper to notify other windows about settings changes via IPC const notifySettingsChanged = useCallback((key: string, value: unknown) => { try { netcattyBridge.get()?.notifySettingsChanged?.({ key, value }); } catch { // ignore - bridge may not be available } }, []); const setSftpTransferConcurrency = useCallback((value: number) => { const clamped = Math.max(1, Math.min(16, Math.round(value))); setSftpTransferConcurrencyState(clamped); localStorageAdapter.writeString(STORAGE_KEY_SFTP_TRANSFER_CONCURRENCY, String(clamped)); notifySettingsChanged(STORAGE_KEY_SFTP_TRANSFER_CONCURRENCY, clamped); }, [notifySettingsChanged]); const [workspaceFocusStyle, setWorkspaceFocusStyleState] = useState<'dim' | 'border'>(() => { const stored = localStorageAdapter.readString(STORAGE_KEY_WORKSPACE_FOCUS_STYLE); return stored === 'border' ? 'border' : 'dim'; }); const setWorkspaceFocusStyle = useCallback((style: 'dim' | 'border') => { setWorkspaceFocusStyleState(style); localStorageAdapter.writeString(STORAGE_KEY_WORKSPACE_FOCUS_STYLE, style); notifySettingsChanged(STORAGE_KEY_WORKSPACE_FOCUS_STYLE, style); }, [notifySettingsChanged]); const syncAppearanceFromStorage = useCallback(() => { const storedTheme = readStoredString(STORAGE_KEY_THEME); const nextTheme = storedTheme && isValidTheme(storedTheme) ? storedTheme : theme; const storedLightId = readStoredString(STORAGE_KEY_UI_THEME_LIGHT); const nextLightId = storedLightId && isValidUiThemeId('light', storedLightId) ? storedLightId : lightUiThemeId; const storedDarkId = readStoredString(STORAGE_KEY_UI_THEME_DARK); const nextDarkId = storedDarkId && isValidUiThemeId('dark', storedDarkId) ? storedDarkId : darkUiThemeId; const storedAccentMode = readStoredString(STORAGE_KEY_ACCENT_MODE); const nextAccentMode = storedAccentMode === 'theme' || storedAccentMode === 'custom' ? storedAccentMode : accentMode; const storedAccent = readStoredString(STORAGE_KEY_COLOR); const nextAccent = storedAccent && isValidHslToken(storedAccent) ? storedAccent.trim() : customAccent; // Fix 2: Skip expensive DOM operations if nothing actually changed if ( nextTheme === theme && nextLightId === lightUiThemeId && nextDarkId === darkUiThemeId && nextAccentMode === accentMode && nextAccent === customAccent ) { return; } setTheme(nextTheme); setLightUiThemeId(nextLightId); setDarkUiThemeId(nextDarkId); setAccentMode(nextAccentMode); setCustomAccent(nextAccent); const effective = nextTheme === 'system' ? getSystemPreference() : nextTheme; const tokens = getUiThemeById(effective, effective === 'dark' ? nextDarkId : nextLightId).tokens; runThemeTransition(() => { applyThemeTokens(nextTheme, effective, tokens, nextAccentMode, nextAccent); }); }, [theme, lightUiThemeId, darkUiThemeId, accentMode, customAccent]); const syncCustomCssFromStorage = useCallback(() => { const storedCss = localStorageAdapter.readString(STORAGE_KEY_CUSTOM_CSS) || ''; setCustomCSS((prev) => (prev === storedCss ? prev : storedCss)); }, []); const rehydrateAllFromStorage = useCallback(() => { // Theme & appearance (already have helper) syncAppearanceFromStorage(); syncCustomCssFromStorage(); // UI Font const storedFont = readStoredString(STORAGE_KEY_UI_FONT_FAMILY); if (storedFont) setUiFontFamilyId(storedFont); // Language const storedLang = readStoredString(STORAGE_KEY_UI_LANGUAGE); if (storedLang) setUiLanguage(storedLang as UILanguage); // Terminal const storedTermTheme = readStoredString(STORAGE_KEY_TERM_THEME); if (storedTermTheme) setTerminalThemeId(storedTermTheme); const storedTermThemeDark = readStoredString(STORAGE_KEY_TERM_THEME_DARK); if (storedTermThemeDark) setTerminalThemeDarkId(storedTermThemeDark); const storedTermThemeLight = readStoredString(STORAGE_KEY_TERM_THEME_LIGHT); if (storedTermThemeLight) setTerminalThemeLightId(storedTermThemeLight); const storedTermFont = readStoredString(STORAGE_KEY_TERM_FONT_FAMILY); const migratedTermFont = migrateIncomingTerminalFontId(storedTermFont); if (migratedTermFont) setTerminalFontFamilyId(migratedTermFont); const storedTermSize = localStorageAdapter.readNumber(STORAGE_KEY_TERM_FONT_SIZE); if (storedTermSize != null) setTerminalFontSize(storedTermSize); const storedTermSettings = readStoredString(STORAGE_KEY_TERM_SETTINGS); if (storedTermSettings) { try { const parsed = JSON.parse(storedTermSettings); setTerminalSettings(parsed); } catch { /* ignore */ } } // Keyboard const storedKb = parseCustomKeyBindingsStorageRecord( localStorageAdapter.readString(STORAGE_KEY_CUSTOM_KEY_BINDINGS), ); if (storedKb) { applyIncomingCustomKeyBindings(storedKb); } // Editor const storedWrap = readStoredString(STORAGE_KEY_EDITOR_WORD_WRAP); if (storedWrap === 'true' || storedWrap === 'false') setEditorWordWrapState(storedWrap === 'true'); // SSH diagnostics const storedSshDebugLogsEnabled = readStoredString(STORAGE_KEY_SSH_DEBUG_LOGS_ENABLED); if (storedSshDebugLogsEnabled === 'true' || storedSshDebugLogsEnabled === 'false') { setSshDebugLogsEnabled(storedSshDebugLogsEnabled === 'true'); } // SFTP const storedDblClick = readStoredString(STORAGE_KEY_SFTP_DOUBLE_CLICK_BEHAVIOR); if (storedDblClick === 'open' || storedDblClick === 'transfer') setSftpDoubleClickBehavior(storedDblClick); const storedAutoSync = readStoredString(STORAGE_KEY_SFTP_AUTO_SYNC); if (storedAutoSync === 'true' || storedAutoSync === 'false') setSftpAutoSync(storedAutoSync === 'true'); const storedHidden = readStoredString(STORAGE_KEY_SFTP_SHOW_HIDDEN_FILES); if (storedHidden === 'true' || storedHidden === 'false') setSftpShowHiddenFiles(storedHidden === 'true'); const storedCompress = readStoredString(STORAGE_KEY_SFTP_USE_COMPRESSED_UPLOAD); if (storedCompress === 'true' || storedCompress === 'false') setSftpUseCompressedUpload(storedCompress === 'true'); const storedAutoOpenSidebar = readStoredString(STORAGE_KEY_SFTP_AUTO_OPEN_SIDEBAR); if (storedAutoOpenSidebar === 'true' || storedAutoOpenSidebar === 'false') setSftpAutoOpenSidebar(storedAutoOpenSidebar === 'true'); const storedFollowTerminalCwd = readStoredString(STORAGE_KEY_SFTP_FOLLOW_TERMINAL_CWD); if (storedFollowTerminalCwd === 'true' || storedFollowTerminalCwd === 'false') { setSftpFollowTerminalCwd(storedFollowTerminalCwd === 'true'); } const storedDefaultViewMode = readStoredString(STORAGE_KEY_SFTP_DEFAULT_VIEW_MODE); if (storedDefaultViewMode === 'list' || storedDefaultViewMode === 'tree') setSftpDefaultViewMode(storedDefaultViewMode); const storedShowRecentHosts = localStorageAdapter.readBoolean(STORAGE_KEY_SHOW_RECENT_HOSTS); setShowRecentHostsState(storedShowRecentHosts ?? DEFAULT_SHOW_RECENT_HOSTS); const storedShowOnlyUngroupedHostsInRoot = localStorageAdapter.readBoolean(STORAGE_KEY_SHOW_ONLY_UNGROUPED_HOSTS_IN_ROOT); setShowOnlyUngroupedHostsInRootState(storedShowOnlyUngroupedHostsInRoot ?? DEFAULT_SHOW_ONLY_UNGROUPED_HOSTS_IN_ROOT); const storedShowSftpTab = localStorageAdapter.readBoolean(STORAGE_KEY_SHOW_SFTP_TAB); setShowSftpTabState(storedShowSftpTab ?? DEFAULT_SHOW_SFTP_TAB); const storedShowHostTreeSidebar = localStorageAdapter.readBoolean(STORAGE_KEY_SHOW_HOST_TREE_SIDEBAR); setShowHostTreeSidebarState(storedShowHostTreeSidebar ?? DEFAULT_SHOW_HOST_TREE_SIDEBAR); const storedShellOnlyTabNumberShortcuts = localStorageAdapter.readBoolean(STORAGE_KEY_SHELL_ONLY_TAB_NUMBER_SHORTCUTS); setShellOnlyTabNumberShortcutsState(storedShellOnlyTabNumberShortcuts ?? DEFAULT_SHELL_ONLY_TAB_NUMBER_SHORTCUTS); const storedDisableTerminalFontZoom = localStorageAdapter.readBoolean(STORAGE_KEY_DISABLE_TERMINAL_FONT_ZOOM); setDisableTerminalFontZoomState(storedDisableTerminalFontZoom ?? DEFAULT_DISABLE_TERMINAL_FONT_ZOOM); // Workspace focus style const storedFocusStyle = readStoredString(STORAGE_KEY_WORKSPACE_FOCUS_STYLE); if (storedFocusStyle === 'dim' || storedFocusStyle === 'border') setWorkspaceFocusStyleState(storedFocusStyle); // Custom terminal themes customThemeStore.loadFromStorage(); }, [applyIncomingCustomKeyBindings, syncAppearanceFromStorage, syncCustomCssFromStorage, setTerminalSettings]); useLayoutEffect(() => { const tokens = getUiThemeById(resolvedTheme, resolvedTheme === 'dark' ? darkUiThemeId : lightUiThemeId).tokens; const apply = () => applyThemeTokens(theme, resolvedTheme, tokens, accentMode, customAccent); if (persistMountedRef.current) { runThemeTransition(apply); } else { apply(); } localStorageAdapter.writeString(STORAGE_KEY_THEME, theme); localStorageAdapter.writeString(STORAGE_KEY_UI_THEME_LIGHT, lightUiThemeId); localStorageAdapter.writeString(STORAGE_KEY_UI_THEME_DARK, darkUiThemeId); localStorageAdapter.writeString(STORAGE_KEY_ACCENT_MODE, accentMode); localStorageAdapter.writeString(STORAGE_KEY_COLOR, customAccent); // Fix 1: Skip IPC broadcast on initial mount (values already match localStorage) if (!persistMountedRef.current) return; // Fix 3: Send a single IPC instead of 5 — the receiver calls syncAppearanceFromStorage() // which re-reads ALL appearance values from localStorage. notifySettingsChanged(STORAGE_KEY_THEME, theme); }, [theme, resolvedTheme, lightUiThemeId, darkUiThemeId, accentMode, customAccent, notifySettingsChanged]); // Listen for OS color scheme changes to keep systemPreference in sync useEffect(() => { if (typeof window === 'undefined' || !window.matchMedia) return; const mql = window.matchMedia('(prefers-color-scheme: dark)'); const handler = (e: MediaQueryListEvent) => { setSystemPreference(e.matches ? 'dark' : 'light'); }; mql.addEventListener('change', handler); return () => mql.removeEventListener('change', handler); }, []); useLayoutEffect(() => { localStorageAdapter.writeString(STORAGE_KEY_UI_LANGUAGE, uiLanguage); document.documentElement.lang = uiLanguage; netcattyBridge.get()?.setLanguage?.(uiLanguage); // Fix 1: Skip IPC broadcast on initial mount if (persistMountedRef.current) { notifySettingsChanged(STORAGE_KEY_UI_LANGUAGE, uiLanguage); } }, [uiLanguage, notifySettingsChanged]); // Apply and persist UI font family // Re-run when fonts finish loading to get correct family for local fonts useLayoutEffect(() => { const font = uiFontStore.getFontById(uiFontFamilyId); document.documentElement.style.setProperty('--font-sans', font.family); localStorageAdapter.writeString(STORAGE_KEY_UI_FONT_FAMILY, uiFontFamilyId); // Fix 1: Skip IPC broadcast on initial mount if (persistMountedRef.current) { notifySettingsChanged(STORAGE_KEY_UI_FONT_FAMILY, uiFontFamilyId); } }, [uiFontFamilyId, uiFontsLoaded, notifySettingsChanged]); useSettingsIpcSync({ syncAppearanceFromStorage, syncCustomCssFromStorage, setUiLanguage, setUiFontFamilyId, setTerminalThemeId, setTerminalThemeDarkId, setTerminalThemeLightId, setFollowAppTerminalThemeState, setTerminalFontFamilyId, setTerminalFontSize, mergeIncomingTerminalSettings, setEditorWordWrapState, setSessionLogsEnabled, setSessionLogsDir, setSessionLogsFormat, setSessionLogsTimestampsEnabled, setSshDebugLogsEnabled, setHotkeyScheme, applyIncomingCustomKeyBindings, setIsHotkeyRecordingState, setGlobalHotkeyEnabled, setWindowOpacity, setAutoUpdateEnabled, setSftpAutoOpenSidebar, setSftpFollowTerminalCwd, setSftpDefaultViewMode, setWorkspaceFocusStyleState, setShowHostTreeSidebarState, setDisableTerminalFontZoomState, setSftpTransferConcurrencyState, }); useEffect(() => { const bridge = netcattyBridge.get(); if (!bridge?.onLanguageChanged) return; const unsubscribe = bridge.onLanguageChanged((language) => { if (typeof language !== 'string' || !language.length) return; const next = resolveSupportedLocale(language); setUiLanguage((prev) => (prev === next ? prev : next)); }); return () => { try { unsubscribe?.(); } catch { // ignore } }; }, []); useSettingsStorageSync({ theme, lightUiThemeId, darkUiThemeId, accentMode, customAccent, customCSS, uiFontFamilyId, hotkeyScheme, uiLanguage, terminalThemeId, followAppTerminalTheme, terminalFontFamilyId, terminalFontSize, sftpDoubleClickBehavior, sftpAutoSync, sftpShowHiddenFiles, sftpUseCompressedUpload, sftpAutoOpenSidebar, sftpFollowTerminalCwd, sftpDefaultViewMode, showRecentHosts, showOnlyUngroupedHostsInRoot, showSftpTab, showHostTreeSidebar, shellOnlyTabNumberShortcuts, disableTerminalFontZoom, editorWordWrap, sessionLogsEnabled, sessionLogsDir, sessionLogsFormat, sessionLogsTimestampsEnabled, sshDebugLogsEnabled, globalHotkeyEnabled, autoUpdateEnabled, windowOpacity, setTheme, setLightUiThemeId, setDarkUiThemeId, setAccentMode, setCustomAccent, setCustomCSS, setUiFontFamilyId, setHotkeyScheme, setUiLanguage, setTerminalThemeId, setTerminalThemeDarkId, setTerminalThemeLightId, setFollowAppTerminalThemeState, setTerminalFontFamilyId, setTerminalFontSize, setSftpDoubleClickBehavior, setSftpAutoSync, setSftpShowHiddenFiles, setSftpUseCompressedUpload, setSftpAutoOpenSidebar, setSftpFollowTerminalCwd, setSftpDefaultViewMode, setShowRecentHostsState, setShowOnlyUngroupedHostsInRootState, setShowSftpTabState, setShowHostTreeSidebarState, setShellOnlyTabNumberShortcutsState, setDisableTerminalFontZoomState, setEditorWordWrapState, setSessionLogsEnabled, setSessionLogsDir, setSessionLogsFormat, setSessionLogsTimestampsEnabled, setSshDebugLogsEnabled, setGlobalHotkeyEnabled, setWindowOpacity, setAutoUpdateEnabled, setWorkspaceFocusStyleState, setSftpTransferConcurrencyState, applyIncomingCustomKeyBindings, mergeIncomingTerminalSettings, }); useEffect(() => { localStorageAdapter.writeString(STORAGE_KEY_TERM_THEME, terminalThemeId); if (!persistMountedRef.current) return; notifySettingsChanged(STORAGE_KEY_TERM_THEME, terminalThemeId); }, [terminalThemeId, notifySettingsChanged]); useEffect(() => { localStorageAdapter.writeString(STORAGE_KEY_TERM_FOLLOW_APP_THEME, String(followAppTerminalTheme)); if (!persistMountedRef.current) return; notifySettingsChanged(STORAGE_KEY_TERM_FOLLOW_APP_THEME, String(followAppTerminalTheme)); }, [followAppTerminalTheme, notifySettingsChanged]); useEffect(() => { localStorageAdapter.writeString(STORAGE_KEY_TERM_THEME_DARK, terminalThemeDarkId); if (!persistMountedRef.current) return; notifySettingsChanged(STORAGE_KEY_TERM_THEME_DARK, terminalThemeDarkId); }, [terminalThemeDarkId, notifySettingsChanged]); useEffect(() => { localStorageAdapter.writeString(STORAGE_KEY_TERM_THEME_LIGHT, terminalThemeLightId); if (!persistMountedRef.current) return; notifySettingsChanged(STORAGE_KEY_TERM_THEME_LIGHT, terminalThemeLightId); }, [terminalThemeLightId, notifySettingsChanged]); useEffect(() => { localStorageAdapter.writeString(STORAGE_KEY_TERM_FONT_FAMILY, terminalFontFamilyId); if (!persistMountedRef.current) return; notifySettingsChanged(STORAGE_KEY_TERM_FONT_FAMILY, terminalFontFamilyId); }, [terminalFontFamilyId, notifySettingsChanged]); useEffect(() => { localStorageAdapter.writeNumber(STORAGE_KEY_TERM_FONT_SIZE, terminalFontSize); if (!persistMountedRef.current) return; notifySettingsChanged(STORAGE_KEY_TERM_FONT_SIZE, terminalFontSize); }, [terminalFontSize, notifySettingsChanged]); useEffect(() => { localStorageAdapter.write(STORAGE_KEY_TERM_SETTINGS, terminalSettings); if (!persistMountedRef.current) return; const currentSignature = serializeTerminalSettings(terminalSettings); const hasPendingUnbroadcastLocalChanges = localTerminalSettingsVersionRef.current !== broadcastedLocalTerminalSettingsVersionRef.current; if (incomingTerminalSettingsSignatureRef.current === currentSignature && !hasPendingUnbroadcastLocalChanges) { incomingTerminalSettingsSignatureRef.current = null; return; } incomingTerminalSettingsSignatureRef.current = null; notifySettingsChanged(STORAGE_KEY_TERM_SETTINGS, terminalSettings); broadcastedLocalTerminalSettingsVersionRef.current = localTerminalSettingsVersionRef.current; }, [terminalSettings, notifySettingsChanged]); useEffect(() => { localStorageAdapter.writeString(STORAGE_KEY_HOTKEY_SCHEME, hotkeyScheme); if (!persistMountedRef.current) return; notifySettingsChanged(STORAGE_KEY_HOTKEY_SCHEME, hotkeyScheme); }, [hotkeyScheme, notifySettingsChanged]); useEffect(() => { const payload = serializeCustomKeyBindingsStorageRecord({ version: customKeyBindingsVersionRef.current, origin: customKeyBindingsOriginRef.current, bindings: customKeyBindings, }); if (localStorageAdapter.readString(STORAGE_KEY_CUSTOM_KEY_BINDINGS) !== payload) { localStorageAdapter.writeString(STORAGE_KEY_CUSTOM_KEY_BINDINGS, payload); } if (!persistMountedRef.current) return; if (customKeyBindingsMutationSourceRef.current === 'incoming') return; notifySettingsChanged(STORAGE_KEY_CUSTOM_KEY_BINDINGS, { version: customKeyBindingsVersionRef.current, origin: customKeyBindingsOriginRef.current, bindings: customKeyBindings, }); }, [customKeyBindings, notifySettingsChanged]); const setIsHotkeyRecording = useCallback((isRecording: boolean) => { setIsHotkeyRecordingState(isRecording); notifySettingsChanged(STORAGE_KEY_HOTKEY_RECORDING, isRecording); }, [notifySettingsChanged]); const setShowRecentHosts = useCallback((enabled: boolean) => { setShowRecentHostsState(enabled); localStorageAdapter.writeBoolean(STORAGE_KEY_SHOW_RECENT_HOSTS, enabled); if (!persistMountedRef.current) return; notifySettingsChanged(STORAGE_KEY_SHOW_RECENT_HOSTS, enabled); }, [notifySettingsChanged]); const setShowOnlyUngroupedHostsInRoot = useCallback((enabled: boolean) => { setShowOnlyUngroupedHostsInRootState(enabled); localStorageAdapter.writeBoolean(STORAGE_KEY_SHOW_ONLY_UNGROUPED_HOSTS_IN_ROOT, enabled); if (!persistMountedRef.current) return; notifySettingsChanged(STORAGE_KEY_SHOW_ONLY_UNGROUPED_HOSTS_IN_ROOT, enabled); }, [notifySettingsChanged]); const setShowSftpTab = useCallback((enabled: boolean) => { setShowSftpTabState(enabled); localStorageAdapter.writeBoolean(STORAGE_KEY_SHOW_SFTP_TAB, enabled); if (!persistMountedRef.current) return; notifySettingsChanged(STORAGE_KEY_SHOW_SFTP_TAB, enabled); }, [notifySettingsChanged]); const setShowHostTreeSidebar = useCallback((enabled: boolean) => { setShowHostTreeSidebarState(enabled); localStorageAdapter.writeBoolean(STORAGE_KEY_SHOW_HOST_TREE_SIDEBAR, enabled); if (!persistMountedRef.current) return; notifySettingsChanged(STORAGE_KEY_SHOW_HOST_TREE_SIDEBAR, enabled); }, [notifySettingsChanged]); const setShellOnlyTabNumberShortcuts = useCallback((enabled: boolean) => { setShellOnlyTabNumberShortcutsState(enabled); localStorageAdapter.writeBoolean(STORAGE_KEY_SHELL_ONLY_TAB_NUMBER_SHORTCUTS, enabled); if (!persistMountedRef.current) return; notifySettingsChanged(STORAGE_KEY_SHELL_ONLY_TAB_NUMBER_SHORTCUTS, enabled); }, [notifySettingsChanged]); const setDisableTerminalFontZoom = useCallback((enabled: boolean) => { setDisableTerminalFontZoomState(enabled); localStorageAdapter.writeBoolean(STORAGE_KEY_DISABLE_TERMINAL_FONT_ZOOM, enabled); if (!persistMountedRef.current) return; notifySettingsChanged(STORAGE_KEY_DISABLE_TERMINAL_FONT_ZOOM, enabled); }, [notifySettingsChanged]); // Apply and persist custom CSS useEffect(() => { applyCustomCssToDocument(customCSS); localStorageAdapter.writeString(STORAGE_KEY_CUSTOM_CSS, customCSS); // Skip IPC on initial mount if (!persistMountedRef.current) return; notifySettingsChanged(STORAGE_KEY_CUSTOM_CSS, customCSS); }, [customCSS, notifySettingsChanged]); // Persist SFTP double-click behavior useEffect(() => { localStorageAdapter.writeString(STORAGE_KEY_SFTP_DOUBLE_CLICK_BEHAVIOR, sftpDoubleClickBehavior); if (!persistMountedRef.current) return; notifySettingsChanged(STORAGE_KEY_SFTP_DOUBLE_CLICK_BEHAVIOR, sftpDoubleClickBehavior); }, [sftpDoubleClickBehavior, notifySettingsChanged]); // Persist SFTP auto-sync setting useEffect(() => { localStorageAdapter.writeString(STORAGE_KEY_SFTP_AUTO_SYNC, sftpAutoSync ? 'true' : 'false'); if (!persistMountedRef.current) return; notifySettingsChanged(STORAGE_KEY_SFTP_AUTO_SYNC, sftpAutoSync); }, [sftpAutoSync, notifySettingsChanged]); // Persist SFTP show hidden files setting useEffect(() => { localStorageAdapter.writeString(STORAGE_KEY_SFTP_SHOW_HIDDEN_FILES, sftpShowHiddenFiles ? 'true' : 'false'); if (!persistMountedRef.current) return; notifySettingsChanged(STORAGE_KEY_SFTP_SHOW_HIDDEN_FILES, sftpShowHiddenFiles); }, [sftpShowHiddenFiles, notifySettingsChanged]); // Persist SFTP compressed upload setting useEffect(() => { localStorageAdapter.writeString(STORAGE_KEY_SFTP_USE_COMPRESSED_UPLOAD, sftpUseCompressedUpload ? 'true' : 'false'); if (!persistMountedRef.current) return; notifySettingsChanged(STORAGE_KEY_SFTP_USE_COMPRESSED_UPLOAD, sftpUseCompressedUpload); }, [sftpUseCompressedUpload, notifySettingsChanged]); // Persist SFTP auto-open sidebar setting useEffect(() => { localStorageAdapter.writeString(STORAGE_KEY_SFTP_AUTO_OPEN_SIDEBAR, sftpAutoOpenSidebar ? 'true' : 'false'); if (!persistMountedRef.current) return; notifySettingsChanged(STORAGE_KEY_SFTP_AUTO_OPEN_SIDEBAR, sftpAutoOpenSidebar); }, [sftpAutoOpenSidebar, notifySettingsChanged]); // Persist SFTP follow terminal cwd setting useEffect(() => { localStorageAdapter.writeString(STORAGE_KEY_SFTP_FOLLOW_TERMINAL_CWD, sftpFollowTerminalCwd ? 'true' : 'false'); if (!persistMountedRef.current) return; notifySettingsChanged(STORAGE_KEY_SFTP_FOLLOW_TERMINAL_CWD, sftpFollowTerminalCwd); }, [sftpFollowTerminalCwd, notifySettingsChanged]); // Persist SFTP default view mode useEffect(() => { localStorageAdapter.writeString(STORAGE_KEY_SFTP_DEFAULT_VIEW_MODE, sftpDefaultViewMode); if (!persistMountedRef.current) return; notifySettingsChanged(STORAGE_KEY_SFTP_DEFAULT_VIEW_MODE, sftpDefaultViewMode); }, [sftpDefaultViewMode, notifySettingsChanged]); // Persist Session Logs settings useEffect(() => { localStorageAdapter.writeString(STORAGE_KEY_SESSION_LOGS_ENABLED, sessionLogsEnabled ? 'true' : 'false'); if (!persistMountedRef.current) return; notifySettingsChanged(STORAGE_KEY_SESSION_LOGS_ENABLED, sessionLogsEnabled); }, [sessionLogsEnabled, notifySettingsChanged]); useEffect(() => { localStorageAdapter.writeString(STORAGE_KEY_SESSION_LOGS_DIR, sessionLogsDir); if (!persistMountedRef.current) return; notifySettingsChanged(STORAGE_KEY_SESSION_LOGS_DIR, sessionLogsDir); }, [sessionLogsDir, notifySettingsChanged]); useEffect(() => { localStorageAdapter.writeString(STORAGE_KEY_SESSION_LOGS_FORMAT, sessionLogsFormat); if (!persistMountedRef.current) return; notifySettingsChanged(STORAGE_KEY_SESSION_LOGS_FORMAT, sessionLogsFormat); }, [sessionLogsFormat, notifySettingsChanged]); useEffect(() => { localStorageAdapter.writeString(STORAGE_KEY_SESSION_LOGS_TIMESTAMPS_ENABLED, sessionLogsTimestampsEnabled ? 'true' : 'false'); if (!persistMountedRef.current) return; notifySettingsChanged(STORAGE_KEY_SESSION_LOGS_TIMESTAMPS_ENABLED, sessionLogsTimestampsEnabled); }, [sessionLogsTimestampsEnabled, notifySettingsChanged]); useEffect(() => { localStorageAdapter.writeString(STORAGE_KEY_SSH_DEBUG_LOGS_ENABLED, sshDebugLogsEnabled ? 'true' : 'false'); if (!persistMountedRef.current) return; notifySettingsChanged(STORAGE_KEY_SSH_DEBUG_LOGS_ENABLED, sshDebugLogsEnabled); }, [sshDebugLogsEnabled, notifySettingsChanged]); useSystemSettingsEffects({ toggleWindowHotkey, globalHotkeyEnabled, closeToTray, windowOpacity, autoUpdateEnabled, persistMountedRef, setHotkeyRegistrationError, setAutoUpdateEnabled, notifySettingsChanged, }); // Fix 1: Mark all persist effects as mounted. // This MUST be declared AFTER all persist useEffects so that React runs it last // during the initial mount cycle (effects fire in declaration order). useEffect(() => { persistMountedRef.current = true; }, []); // Get merged key bindings (defaults + custom overrides) const keyBindings = useMemo((): KeyBinding[] => { return DEFAULT_KEY_BINDINGS.map(binding => { const custom = customKeyBindings[binding.id]; if (!custom) return binding; return { ...binding, mac: custom.mac ?? binding.mac, pc: custom.pc ?? binding.pc, }; }); }, [customKeyBindings]); // Update a single key binding const updateKeyBinding = useCallback((bindingId: string, scheme: 'mac' | 'pc', newKey: string) => { setCustomKeyBindings(prev => updateCustomKeyBindingRecord(prev, bindingId, scheme, newKey)); }, [setCustomKeyBindings]); // Reset a key binding to default const resetKeyBinding = useCallback((bindingId: string, scheme?: 'mac' | 'pc') => { setCustomKeyBindings(prev => resetCustomKeyBinding(prev, bindingId, scheme)); }, [setCustomKeyBindings]); // Reset all key bindings to defaults const resetAllKeyBindings = useCallback(() => { setCustomKeyBindings({}); }, [setCustomKeyBindings]); const updateSyncConfig = useCallback((config: SyncConfig | null) => { setSyncConfig(config); localStorageAdapter.write(STORAGE_KEY_SYNC, config); }, []); // Subscribe to custom theme changes so editing in-place triggers re-render const customThemes = useCustomThemes(); const currentTerminalTheme = useMemo(() => resolveCurrentTerminalTheme({ terminalThemeId, terminalThemeDarkId, terminalThemeLightId, customThemes, followAppTerminalTheme, resolvedTheme, lightUiThemeId, darkUiThemeId, accentMode, customAccent, }), [terminalThemeId, terminalThemeDarkId, terminalThemeLightId, customThemes, followAppTerminalTheme, resolvedTheme, lightUiThemeId, darkUiThemeId, accentMode, customAccent]); const updateTerminalSetting = useCallback(( key: K, value: TerminalSettings[K] ) => { setTerminalSettings(prev => ({ ...prev, [key]: value })); }, [setTerminalSettings]); const applyAppTheme = useCallback(() => { const tokens = getUiThemeById(resolvedTheme, resolvedTheme === 'dark' ? darkUiThemeId : lightUiThemeId).tokens; applyThemeTokens(theme, resolvedTheme, tokens, accentMode, customAccent); }, [theme, resolvedTheme, lightUiThemeId, darkUiThemeId, accentMode, customAccent]); return { theme, setTheme, resolvedTheme, lightUiThemeId, setLightUiThemeId, darkUiThemeId, setDarkUiThemeId, accentMode, setAccentMode, customAccent, setCustomAccent, uiFontFamilyId, setUiFontFamilyId, syncConfig, updateSyncConfig, uiLanguage, setUiLanguage, terminalThemeId, setTerminalThemeId, followAppTerminalTheme, setFollowAppTerminalTheme: setFollowAppTerminalThemeState, terminalThemeDarkId, setTerminalThemeDarkId, terminalThemeLightId, setTerminalThemeLightId, currentTerminalTheme, terminalFontFamilyId, setTerminalFontFamilyId, terminalFontSize, setTerminalFontSize, terminalSettings, setTerminalSettings, updateTerminalSetting, hotkeyScheme, setHotkeyScheme, keyBindings, customKeyBindings, updateKeyBinding, resetKeyBinding, resetAllKeyBindings, isHotkeyRecording, setIsHotkeyRecording, customCSS, setCustomCSS, sftpDoubleClickBehavior, setSftpDoubleClickBehavior, sftpAutoSync, setSftpAutoSync, sftpShowHiddenFiles, setSftpShowHiddenFiles, sftpUseCompressedUpload, setSftpUseCompressedUpload, sftpAutoOpenSidebar, setSftpAutoOpenSidebar, sftpFollowTerminalCwd, setSftpFollowTerminalCwd, sftpDefaultViewMode, setSftpDefaultViewMode, showRecentHosts, setShowRecentHosts, showOnlyUngroupedHostsInRoot, setShowOnlyUngroupedHostsInRoot, showSftpTab, setShowSftpTab, showHostTreeSidebar, setShowHostTreeSidebar, shellOnlyTabNumberShortcuts, setShellOnlyTabNumberShortcuts, disableTerminalFontZoom, setDisableTerminalFontZoom, sftpTransferConcurrency, setSftpTransferConcurrency, // Editor Settings editorWordWrap, setEditorWordWrap: useCallback((enabled: boolean) => { setEditorWordWrapState(enabled); localStorageAdapter.writeString(STORAGE_KEY_EDITOR_WORD_WRAP, String(enabled)); notifySettingsChanged(STORAGE_KEY_EDITOR_WORD_WRAP, enabled); }, [notifySettingsChanged]), // Session Logs sessionLogsEnabled, setSessionLogsEnabled, sessionLogsDir, setSessionLogsDir, sessionLogsFormat, setSessionLogsFormat, sessionLogsTimestampsEnabled, setSessionLogsTimestampsEnabled, sshDebugLogsEnabled, setSshDebugLogsEnabled, // Global Toggle Window (Quake Mode) toggleWindowHotkey, setToggleWindowHotkey, closeToTray, setCloseToTray, autoUpdateEnabled, setAutoUpdateEnabled, hotkeyRegistrationError, globalHotkeyEnabled, setGlobalHotkeyEnabled, windowOpacity, setWindowOpacity, rehydrateAllFromStorage, applyAppTheme, workspaceFocusStyle, setWorkspaceFocusStyle, // Opaque version that changes when any synced setting changes, used by useAutoSync. // eslint-disable-next-line react-hooks/exhaustive-deps settingsVersion: useMemo(() => Math.random(), [ theme, lightUiThemeId, darkUiThemeId, accentMode, customAccent, uiFontFamilyId, uiLanguage, customCSS, terminalThemeId, terminalFontFamilyId, terminalFontSize, terminalSettings, customKeyBindings, editorWordWrap, sftpDoubleClickBehavior, sftpAutoSync, sftpShowHiddenFiles, sftpUseCompressedUpload, sftpAutoOpenSidebar, sftpFollowTerminalCwd, sftpDefaultViewMode, showRecentHosts, showOnlyUngroupedHostsInRoot, showSftpTab, showHostTreeSidebar, shellOnlyTabNumberShortcuts, disableTerminalFontZoom, customThemes, workspaceFocusStyle, sessionLogsTimestampsEnabled, sshDebugLogsEnabled, ]), }; };