settings-modal-context.tsx 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337
  1. import { createContext, FC, useContext, useMemo, useState } from 'react'
  2. import { useLayoutContext } from '@/shared/context/layout-context'
  3. import AutoCloseBracketsSetting from '@/features/settings/components/editor-settings/auto-close-brackets-setting'
  4. import AutoCompleteSetting from '@/features/settings/components/editor-settings/auto-complete-setting'
  5. import CodeCheckSetting from '@/features/settings/components/editor-settings/code-check-setting'
  6. import PreviewTabsSetting from '@/features/settings/components/editor-settings/preview-tabs-setting'
  7. import KeybindingSetting from '@/features/settings/components/editor-settings/keybinding-setting'
  8. import PDFViewerSetting from '@/features/settings/components/editor-settings/pdf-viewer-setting'
  9. import importOverleafModules from '../../../../macros/import-overleaf-module.macro'
  10. import SpellCheckSetting from '@/features/settings/components/editor-settings/spell-check-setting'
  11. import DictionarySetting from '@/features/settings/components/editor-settings/dictionary-setting'
  12. import { useTranslation } from 'react-i18next'
  13. import BreadcrumbsSetting from '@/features/settings/components/editor-settings/breadcrumbs-setting'
  14. import NonBlinkingCursorSetting from '@/features/settings/components/editor-settings/non-blinking-cursor-setting'
  15. import MathPreviewSetting from '@/features/settings/components/editor-settings/math-preview-setting'
  16. import RootDocumentSetting from '@/features/settings/components/compiler-settings/root-document-setting'
  17. import CompilerSetting from '@/features/settings/components/compiler-settings/compiler-setting'
  18. import ImageNameSetting from '@/features/settings/components/compiler-settings/image-name-setting'
  19. import DraftSetting from '@/features/settings/components/compiler-settings/draft-setting'
  20. import StopOnFirstErrorSetting from '@/features/settings/components/compiler-settings/stop-on-first-error-setting'
  21. import AutoCompileSetting from '@/features/settings/components/compiler-settings/auto-compile-setting'
  22. import OverallThemeSetting from '@/features/settings/components/appearance-settings/overall-theme-setting'
  23. import EditorThemeSetting from '@/features/settings/components/appearance-settings/editor-theme-setting'
  24. import FontSizeSetting from '@/features/settings/components/appearance-settings/font-size-setting'
  25. import LineHeightSetting from '@/features/settings/components/appearance-settings/line-height-setting'
  26. import FontFamilySetting from '@/features/settings/components/appearance-settings/font-family-setting'
  27. import { EditorLeftMenuProvider } from '@/features/editor-left-menu/components/editor-left-menu-context'
  28. import DarkModePdfSetting from '@/features/settings/components/appearance-settings/dark-mode-pdf-setting'
  29. import { useProjectSettingsContext } from '@/features/editor-left-menu/context/project-settings-context'
  30. import { useFeatureFlag } from '@/shared/context/split-test-context'
  31. import ProjectNotificationsSetting from '@/features/settings/components/editor-settings/project-notifications-setting'
  32. import getMeta from '@/utils/meta'
  33. import type {
  34. SettingsEntry,
  35. SettingsSection,
  36. SettingsSectionHook,
  37. } from '@/features/settings/context/types'
  38. const [referenceSearchSettingModule] = importOverleafModules(
  39. 'referenceSearchSetting'
  40. )
  41. const ReferenceSearchSetting = referenceSearchSettingModule?.import.default
  42. const editorTabExtraSectionHooks: SettingsSectionHook[] = importOverleafModules(
  43. 'settingsModalEditorTabSections'
  44. )
  45. .map((m: any) => m?.import?.default)
  46. .filter((h: unknown): h is SettingsSectionHook => typeof h === 'function')
  47. const useSlotSections = (hooks: SettingsSectionHook[]): SettingsSection[] =>
  48. hooks.map(hook => hook()).filter((s): s is SettingsSection => s != null)
  49. type SettingsModalState = {
  50. show: boolean
  51. setShow: (shown: boolean) => void
  52. activeTab: string | null | undefined
  53. setActiveTab: (tab: string | null | undefined) => void
  54. settingsTabs: SettingsEntry[]
  55. settingToTabMap: Map<string, string>
  56. }
  57. export const SettingsModalContext = createContext<
  58. SettingsModalState | undefined
  59. >(undefined)
  60. export const SettingsModalProvider: FC<React.PropsWithChildren> = ({
  61. children,
  62. }) => {
  63. const { t } = useTranslation()
  64. const { isOverleaf } = getMeta('ol-ExposedSettings')
  65. const { overallTheme } = useProjectSettingsContext()
  66. // TODO ide-redesign-cleanup: Rename this field and move it directly into this context
  67. const { leftMenuShown, setLeftMenuShown } = useLayoutContext()
  68. const hasEmailNotifications = useFeatureFlag('email-notifications')
  69. const hasEditorTabs = useFeatureFlag('editor-tabs')
  70. const editorTabExtraSections = useSlotSections(editorTabExtraSectionHooks)
  71. const allSettingsTabs: SettingsEntry[] = useMemo(
  72. () => [
  73. {
  74. key: 'editor',
  75. title: t('editor'),
  76. icon: 'code',
  77. sections: [
  78. {
  79. key: 'general',
  80. settings: [
  81. {
  82. key: 'autoComplete',
  83. component: <AutoCompleteSetting />,
  84. },
  85. {
  86. key: 'autoPairDelimiters',
  87. component: <AutoCloseBracketsSetting />,
  88. },
  89. {
  90. key: 'nonBlinkingCursor',
  91. component: <NonBlinkingCursorSetting />,
  92. },
  93. {
  94. key: 'syntaxValidation',
  95. component: <CodeCheckSetting />,
  96. },
  97. {
  98. key: 'previewTabs',
  99. component: <PreviewTabsSetting />,
  100. hidden: !hasEditorTabs,
  101. },
  102. {
  103. key: 'mode',
  104. component: <KeybindingSetting />,
  105. },
  106. {
  107. key: 'pdfViewer',
  108. component: <PDFViewerSetting />,
  109. },
  110. {
  111. key: 'write-and-cite-settings',
  112. component: <ReferenceSearchSetting />,
  113. hidden: !ReferenceSearchSetting,
  114. },
  115. ],
  116. },
  117. {
  118. key: 'spellcheck',
  119. title: t('spellcheck'),
  120. settings: [
  121. {
  122. key: 'spellCheckLanguage',
  123. component: <SpellCheckSetting />,
  124. },
  125. {
  126. key: 'dictionary-settings',
  127. component: <DictionarySetting />,
  128. },
  129. ],
  130. },
  131. {
  132. key: 'tools',
  133. title: t('tools'),
  134. settings: [
  135. {
  136. key: 'breadcrumbs-setting',
  137. component: <BreadcrumbsSetting />,
  138. },
  139. {
  140. key: 'mathPreview',
  141. component: <MathPreviewSetting />,
  142. },
  143. ],
  144. },
  145. ...editorTabExtraSections,
  146. ],
  147. },
  148. {
  149. key: 'compiler',
  150. title: t('compiler'),
  151. icon: 'picture_as_pdf',
  152. sections: [
  153. {
  154. key: 'general',
  155. settings: [
  156. {
  157. key: 'rootDocId',
  158. component: <RootDocumentSetting />,
  159. },
  160. {
  161. key: 'compiler',
  162. component: <CompilerSetting />,
  163. },
  164. {
  165. key: 'imageName',
  166. component: <ImageNameSetting />,
  167. },
  168. {
  169. key: 'draft',
  170. component: <DraftSetting />,
  171. },
  172. {
  173. key: 'stopOnFirstError',
  174. component: <StopOnFirstErrorSetting />,
  175. },
  176. {
  177. key: 'autoCompile',
  178. component: <AutoCompileSetting />,
  179. },
  180. ],
  181. },
  182. ],
  183. },
  184. {
  185. key: 'appearance',
  186. title: t('appearance'),
  187. icon: 'brush',
  188. sections: [
  189. {
  190. key: 'general',
  191. settings: [
  192. {
  193. key: 'overallTheme',
  194. component: <OverallThemeSetting />,
  195. },
  196. {
  197. key: 'editorTheme',
  198. component: <EditorThemeSetting />,
  199. },
  200. {
  201. key: 'pdfDarkMode',
  202. component: <DarkModePdfSetting />,
  203. hidden: overallTheme === 'light-',
  204. },
  205. {
  206. key: 'fontSize',
  207. component: <FontSizeSetting />,
  208. },
  209. {
  210. key: 'fontFamily',
  211. component: <FontFamilySetting />,
  212. },
  213. {
  214. key: 'lineHeight',
  215. component: <LineHeightSetting />,
  216. },
  217. ],
  218. },
  219. ],
  220. },
  221. {
  222. key: 'project_notifications',
  223. title: t('project_notifications'),
  224. icon: 'notifications' as const,
  225. sections: [
  226. {
  227. key: 'general',
  228. settings: [
  229. {
  230. key: 'projectNotifications',
  231. component: <ProjectNotificationsSetting />,
  232. },
  233. ],
  234. },
  235. ],
  236. hidden: !hasEmailNotifications,
  237. },
  238. {
  239. key: 'account_settings',
  240. title: t('account_settings'),
  241. icon: 'settings',
  242. href: '/user/settings',
  243. },
  244. {
  245. key: 'subscription',
  246. title: t('subscription'),
  247. icon: 'account_balance',
  248. href: '/user/subscription',
  249. hidden: !isOverleaf,
  250. },
  251. ],
  252. [
  253. t,
  254. hasEditorTabs,
  255. overallTheme,
  256. hasEmailNotifications,
  257. isOverleaf,
  258. editorTabExtraSections,
  259. ]
  260. )
  261. const settingsTabs = useMemo(
  262. () => allSettingsTabs.filter(tab => !tab.hidden),
  263. [allSettingsTabs]
  264. )
  265. const settingToTabMap = useMemo(() => {
  266. const map = new Map<string, string>()
  267. settingsTabs
  268. .filter(t => 'sections' in t)
  269. .forEach(tab => {
  270. tab.sections.forEach(section => {
  271. section.settings.forEach(setting => {
  272. map.set(setting.key, tab.key)
  273. })
  274. })
  275. })
  276. return map
  277. }, [settingsTabs])
  278. const [activeTab, setActiveTab] = useState<string | null | undefined>(
  279. settingsTabs[0]?.key
  280. )
  281. const value = useMemo(
  282. () => ({
  283. show: leftMenuShown,
  284. setShow: setLeftMenuShown,
  285. activeTab,
  286. setActiveTab,
  287. settingsTabs,
  288. settingToTabMap,
  289. }),
  290. [
  291. leftMenuShown,
  292. setLeftMenuShown,
  293. activeTab,
  294. setActiveTab,
  295. settingsTabs,
  296. settingToTabMap,
  297. ]
  298. )
  299. return (
  300. // TODO ide-redesign-cleanup: Merge <EditorLeftMenuProvider> into <SettingsModalProvider>
  301. <EditorLeftMenuProvider>
  302. <SettingsModalContext.Provider value={value}>
  303. {children}
  304. </SettingsModalContext.Provider>
  305. </EditorLeftMenuProvider>
  306. )
  307. }
  308. export const useSettingsModalContext = () => {
  309. const value = useContext(SettingsModalContext)
  310. if (!value) {
  311. throw new Error(
  312. `useSettingsModalContext is only available inside SettingsModalProvider`
  313. )
  314. }
  315. return value
  316. }