@docusaurus/theme-classic 2.0.0-beta.138b4c997 → 2.0.0-beta.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (349) hide show
  1. package/README.md +1 -1
  2. package/lib/admonitions.css +35 -0
  3. package/lib/deps.d.ts +13 -0
  4. package/lib/index.js +16 -15
  5. package/lib/prism-include-languages.js +9 -5
  6. package/{lib-next/types.d.ts → lib/theme-classic.d.ts} +374 -150
  7. package/lib/translations.js +16 -7
  8. package/lib/types.d.ts +0 -587
  9. package/lib/validateThemeConfig.js +232 -246
  10. package/lib-next/theme/Admonition/index.js +101 -0
  11. package/lib-next/theme/AnnouncementBar/index.js +7 -12
  12. package/lib-next/theme/AnnouncementBar/styles.module.css +23 -32
  13. package/lib-next/theme/BackToTopButton/index.js +131 -0
  14. package/lib-next/theme/BackToTopButton/styles.module.css +42 -0
  15. package/lib-next/theme/BlogArchivePage/index.js +80 -0
  16. package/lib-next/theme/BlogLayout/index.js +40 -0
  17. package/lib-next/theme/BlogListPage/index.js +17 -25
  18. package/lib-next/theme/BlogPostAuthor/index.js +46 -0
  19. package/{lib/theme/MDXPage → lib-next/theme/BlogPostAuthor}/styles.module.css +4 -2
  20. package/lib-next/theme/BlogPostAuthors/index.js +34 -0
  21. package/{lib/theme/IconExternalLink → lib-next/theme/BlogPostAuthors}/styles.module.css +3 -4
  22. package/lib-next/theme/BlogPostItem/index.js +79 -86
  23. package/lib-next/theme/BlogPostPage/index.js +70 -35
  24. package/lib-next/theme/BlogSidebar/index.js +11 -13
  25. package/lib-next/theme/BlogSidebar/styles.module.css +2 -2
  26. package/lib-next/theme/BlogTagsListPage/index.js +14 -55
  27. package/lib-next/theme/BlogTagsPostsPage/index.js +29 -39
  28. package/lib-next/theme/CodeBlock/index.js +23 -149
  29. package/lib-next/theme/CodeBlock/styles.module.css +12 -9
  30. package/lib-next/theme/Details/index.js +20 -0
  31. package/lib-next/theme/Details/styles.module.css +13 -0
  32. package/lib-next/theme/DocCard/index.js +80 -0
  33. package/lib-next/theme/DocCard/styles.module.css +43 -0
  34. package/lib-next/theme/DocCardList/index.js +19 -0
  35. package/lib-next/theme/DocCategoryGeneratedIndexPage/index.js +49 -0
  36. package/lib-next/theme/DocCategoryGeneratedIndexPage/styles.module.css +18 -0
  37. package/lib-next/theme/DocItem/index.js +40 -51
  38. package/lib-next/theme/DocItem/styles.module.css +5 -9
  39. package/lib-next/theme/DocItemFooter/index.js +79 -0
  40. package/{lib/theme/DocItem → lib-next/theme/DocItemFooter}/styles.module.css +1 -9
  41. package/lib-next/theme/DocPage/index.js +46 -49
  42. package/lib-next/theme/DocPage/styles.module.css +5 -6
  43. package/lib-next/theme/DocPaginator/index.js +5 -33
  44. package/lib-next/theme/DocPaginatorNavLink/index.js +36 -0
  45. package/lib-next/theme/DocSidebar/index.js +65 -285
  46. package/lib-next/theme/DocSidebar/styles.module.css +0 -18
  47. package/lib-next/theme/DocSidebarItem/index.js +217 -0
  48. package/{lib/theme/ThemedImage → lib-next/theme/DocSidebarItem}/styles.module.css +10 -9
  49. package/lib-next/theme/DocTagDocListPage/index.js +89 -0
  50. package/lib-next/theme/DocTagsListPage/index.js +38 -0
  51. package/lib-next/theme/DocVersionBadge/index.js +27 -0
  52. package/lib-next/theme/DocVersionBanner/index.js +28 -14
  53. package/lib-next/theme/EditThisPage/index.js +6 -1
  54. package/lib-next/theme/ErrorPageContent.js +35 -0
  55. package/lib-next/theme/Footer/index.js +100 -40
  56. package/lib-next/theme/Heading/index.js +24 -29
  57. package/lib-next/theme/Heading/styles.css +5 -6
  58. package/lib-next/theme/Heading/styles.module.css +9 -5
  59. package/lib-next/theme/IconArrow/index.js +2 -2
  60. package/lib-next/theme/IconClose/index.js +23 -0
  61. package/lib-next/theme/IconEdit/index.js +2 -2
  62. package/lib-next/theme/IconExternalLink/index.js +2 -2
  63. package/lib-next/theme/IconLanguage/index.js +2 -2
  64. package/lib-next/theme/IconMenu/index.js +2 -2
  65. package/lib-next/theme/LastUpdated/index.js +3 -2
  66. package/lib-next/theme/Layout/index.js +3 -1
  67. package/lib-next/theme/LayoutHead/index.js +18 -23
  68. package/lib-next/theme/LayoutProviders/index.js +9 -3
  69. package/lib-next/theme/Logo/index.js +25 -21
  70. package/lib-next/theme/MDXComponents/index.js +34 -7
  71. package/{lib/theme/hooks → lib-next/theme/MDXComponents}/styles.css +3 -2
  72. package/lib-next/theme/MDXPage/index.js +10 -2
  73. package/lib-next/theme/Navbar/index.js +193 -56
  74. package/lib-next/theme/Navbar/styles.module.css +10 -3
  75. package/lib-next/theme/NavbarItem/DefaultNavbarItem.js +45 -147
  76. package/lib-next/theme/NavbarItem/DocNavbarItem.js +7 -7
  77. package/lib-next/theme/NavbarItem/DocsVersionDropdownNavbarItem.js +31 -19
  78. package/lib-next/theme/NavbarItem/DropdownNavbarItem.js +158 -0
  79. package/lib-next/theme/NavbarItem/{LocaleDropdownNavbarItem.js → LocaleDropdownNavbarItem/index.js} +4 -12
  80. package/lib-next/theme/NavbarItem/LocaleDropdownNavbarItem/styles.module.css +11 -0
  81. package/lib-next/theme/NavbarItem/index.js +25 -12
  82. package/lib-next/theme/{SearchMetadatas → SearchMetadata}/index.js +1 -1
  83. package/lib-next/theme/Seo/index.js +11 -7
  84. package/lib-next/theme/SkipToContent/index.js +5 -2
  85. package/lib-next/theme/TOC/index.js +12 -36
  86. package/lib-next/theme/TOC/styles.module.css +1 -1
  87. package/lib-next/theme/TOCCollapsible/index.js +54 -0
  88. package/lib-next/theme/TOCCollapsible/styles.module.css +50 -0
  89. package/lib-next/theme/TOCInline/index.js +10 -28
  90. package/lib-next/theme/TOCItems/index.js +85 -0
  91. package/lib-next/theme/Tabs/__tests__/index.test.js +142 -0
  92. package/lib-next/theme/Tabs/index.js +103 -48
  93. package/lib-next/theme/Tabs/styles.module.css +0 -13
  94. package/lib-next/theme/Tag/index.js +27 -0
  95. package/lib-next/theme/Tag/styles.module.css +70 -0
  96. package/lib-next/theme/TagsListByLetter/index.js +42 -0
  97. package/lib-next/theme/TagsListByLetter/styles.module.css +11 -0
  98. package/lib-next/theme/TagsListInline/index.js +31 -0
  99. package/lib-next/theme/TagsListInline/styles.module.css +15 -0
  100. package/lib-next/theme/ThemeProvider/index.js +10 -7
  101. package/lib-next/theme/ThemedImage/index.js +5 -5
  102. package/lib-next/theme/Toggle/index.js +34 -37
  103. package/lib-next/theme/Toggle/styles.module.css +91 -3
  104. package/lib-next/theme/UserPreferencesProvider/index.js +9 -6
  105. package/lib-next/theme/hooks/useHideableNavbar.js +31 -44
  106. package/lib-next/theme/hooks/useTheme.js +4 -5
  107. package/lib-next/theme/hooks/useWindowSize.js +34 -20
  108. package/lib-next/theme/prism-include-languages.js +2 -1
  109. package/package.json +27 -25
  110. package/src/admonitions.css +35 -0
  111. package/src/deps.d.ts +13 -0
  112. package/src/index.ts +23 -20
  113. package/{lib-next/prism-include-languages.js → src/prism-include-languages.ts} +0 -0
  114. package/src/theme/Admonition/index.tsx +106 -0
  115. package/src/theme/AnnouncementBar/index.tsx +8 -12
  116. package/src/theme/AnnouncementBar/styles.module.css +23 -32
  117. package/src/theme/BackToTopButton/index.tsx +142 -0
  118. package/src/theme/BackToTopButton/styles.module.css +42 -0
  119. package/src/theme/BlogArchivePage/index.tsx +91 -0
  120. package/src/theme/BlogLayout/index.tsx +44 -0
  121. package/src/theme/BlogListPage/index.tsx +18 -25
  122. package/src/theme/BlogPostAuthor/index.tsx +49 -0
  123. package/{lib/theme/IconEdit → src/theme/BlogPostAuthor}/styles.module.css +4 -3
  124. package/src/theme/BlogPostAuthors/index.tsx +39 -0
  125. package/src/theme/BlogPostAuthors/styles.module.css +11 -0
  126. package/src/theme/BlogPostItem/index.tsx +70 -80
  127. package/src/theme/BlogPostPage/index.tsx +72 -35
  128. package/src/theme/BlogSidebar/index.tsx +11 -13
  129. package/src/theme/BlogSidebar/styles.module.css +2 -2
  130. package/src/theme/BlogTagsListPage/index.tsx +14 -57
  131. package/src/theme/BlogTagsPostsPage/index.tsx +29 -39
  132. package/src/theme/CodeBlock/index.tsx +27 -151
  133. package/src/theme/CodeBlock/styles.module.css +12 -9
  134. package/src/theme/Details/index.tsx +24 -0
  135. package/src/theme/Details/styles.module.css +13 -0
  136. package/src/theme/DocCard/index.tsx +100 -0
  137. package/src/theme/DocCard/styles.module.css +43 -0
  138. package/src/theme/DocCardList/index.tsx +27 -0
  139. package/src/theme/DocCategoryGeneratedIndexPage/index.tsx +53 -0
  140. package/src/theme/DocCategoryGeneratedIndexPage/styles.module.css +18 -0
  141. package/src/theme/DocItem/index.tsx +43 -51
  142. package/src/theme/DocItem/styles.module.css +5 -9
  143. package/src/theme/DocItemFooter/index.tsx +91 -0
  144. package/{lib/theme/BlogPostItem → src/theme/DocItemFooter}/styles.module.css +8 -8
  145. package/src/theme/DocPage/index.tsx +44 -42
  146. package/src/theme/DocPage/styles.module.css +5 -6
  147. package/src/theme/DocPaginator/index.tsx +5 -33
  148. package/src/theme/DocPaginatorNavLink/index.tsx +38 -0
  149. package/src/theme/DocSidebar/index.tsx +76 -297
  150. package/src/theme/DocSidebar/styles.module.css +0 -18
  151. package/src/theme/DocSidebarItem/index.tsx +242 -0
  152. package/{lib/theme/Footer → src/theme/DocSidebarItem}/styles.module.css +10 -6
  153. package/src/theme/DocTagDocListPage/index.tsx +89 -0
  154. package/src/theme/DocTagsListPage/index.tsx +41 -0
  155. package/src/theme/DocVersionBadge/index.tsx +30 -0
  156. package/src/theme/DocVersionBanner/index.tsx +48 -21
  157. package/src/theme/EditThisPage/index.tsx +6 -1
  158. package/src/theme/ErrorPageContent.tsx +41 -0
  159. package/src/theme/Footer/index.tsx +113 -43
  160. package/src/theme/Heading/index.tsx +24 -31
  161. package/src/theme/Heading/styles.css +5 -6
  162. package/src/theme/Heading/styles.module.css +9 -5
  163. package/src/theme/IconArrow/index.tsx +2 -2
  164. package/src/theme/IconClose/index.tsx +26 -0
  165. package/src/theme/IconEdit/index.tsx +2 -2
  166. package/src/theme/IconExternalLink/index.tsx +2 -5
  167. package/src/theme/IconLanguage/index.tsx +2 -6
  168. package/src/theme/IconMenu/index.tsx +3 -3
  169. package/src/theme/LastUpdated/index.tsx +3 -2
  170. package/src/theme/Layout/index.tsx +3 -1
  171. package/src/theme/LayoutHead/index.tsx +18 -17
  172. package/src/theme/LayoutProviders/index.tsx +9 -3
  173. package/src/theme/Logo/index.tsx +21 -17
  174. package/src/theme/MDXComponents/index.tsx +39 -5
  175. package/src/theme/MDXComponents/styles.css +11 -0
  176. package/src/theme/MDXPage/index.tsx +10 -2
  177. package/src/theme/Navbar/index.tsx +203 -61
  178. package/src/theme/Navbar/styles.module.css +10 -3
  179. package/src/theme/NavbarItem/DefaultNavbarItem.tsx +42 -154
  180. package/src/theme/NavbarItem/DocNavbarItem.tsx +12 -16
  181. package/src/theme/NavbarItem/DocsVersionDropdownNavbarItem.tsx +33 -21
  182. package/src/theme/NavbarItem/DocsVersionNavbarItem.tsx +7 -3
  183. package/src/theme/NavbarItem/DropdownNavbarItem.tsx +180 -0
  184. package/src/theme/NavbarItem/{LocaleDropdownNavbarItem.tsx → LocaleDropdownNavbarItem/index.tsx} +8 -9
  185. package/src/theme/NavbarItem/LocaleDropdownNavbarItem/styles.module.css +11 -0
  186. package/src/theme/NavbarItem/index.tsx +41 -16
  187. package/src/theme/{SearchMetadatas → SearchMetadata}/index.tsx +2 -2
  188. package/src/theme/Seo/index.tsx +7 -4
  189. package/src/theme/SkipToContent/index.tsx +5 -2
  190. package/src/theme/TOC/index.tsx +12 -41
  191. package/src/theme/TOC/styles.module.css +1 -1
  192. package/src/theme/TOCCollapsible/index.tsx +58 -0
  193. package/src/theme/TOCCollapsible/styles.module.css +50 -0
  194. package/src/theme/TOCInline/index.tsx +13 -32
  195. package/src/theme/TOCItems/index.tsx +96 -0
  196. package/src/theme/Tabs/index.tsx +110 -54
  197. package/src/theme/Tabs/styles.module.css +0 -13
  198. package/src/theme/Tag/index.tsx +31 -0
  199. package/src/theme/Tag/styles.module.css +70 -0
  200. package/src/theme/TagsListByLetter/index.tsx +45 -0
  201. package/src/theme/TagsListByLetter/styles.module.css +11 -0
  202. package/src/theme/TagsListInline/index.tsx +35 -0
  203. package/src/theme/TagsListInline/styles.module.css +15 -0
  204. package/src/theme/ThemeProvider/index.tsx +6 -2
  205. package/src/theme/ThemedImage/index.tsx +5 -5
  206. package/src/theme/Toggle/index.tsx +36 -43
  207. package/src/theme/Toggle/styles.module.css +91 -3
  208. package/src/theme/UserPreferencesProvider/index.tsx +9 -6
  209. package/src/theme/hooks/useHideableNavbar.ts +32 -45
  210. package/src/theme/hooks/useTabGroupChoice.ts +2 -2
  211. package/src/theme/hooks/useTheme.ts +4 -5
  212. package/src/theme/hooks/useWindowSize.ts +38 -20
  213. package/src/theme/prism-include-languages.ts +3 -2
  214. package/src/theme-classic.d.ts +822 -0
  215. package/src/translations.ts +41 -23
  216. package/src/types.d.ts +0 -587
  217. package/src/{validateThemeConfig.js → validateThemeConfig.ts} +160 -98
  218. package/babel.config.js +0 -35
  219. package/codeTranslations/README.md +0 -20
  220. package/codeTranslations/ar.json +0 -57
  221. package/codeTranslations/base.json +0 -112
  222. package/codeTranslations/bn.json +0 -56
  223. package/codeTranslations/da.json +0 -57
  224. package/codeTranslations/de.json +0 -57
  225. package/codeTranslations/es.json +0 -57
  226. package/codeTranslations/fa.json +0 -57
  227. package/codeTranslations/fil.json +0 -57
  228. package/codeTranslations/fr.json +0 -57
  229. package/codeTranslations/he.json +0 -57
  230. package/codeTranslations/hi.json +0 -57
  231. package/codeTranslations/ja.json +0 -57
  232. package/codeTranslations/ko.json +0 -57
  233. package/codeTranslations/pl.json +0 -57
  234. package/codeTranslations/pt-BR.json +0 -57
  235. package/codeTranslations/pt-PT.json +0 -57
  236. package/codeTranslations/ru.json +0 -57
  237. package/codeTranslations/tr.json +0 -57
  238. package/codeTranslations/vi.json +0 -57
  239. package/codeTranslations/zh-Hans.json +0 -57
  240. package/codeTranslations/zh-Hant.json +0 -57
  241. package/lib/__tests__/__snapshots__/translations.test.ts.snap +0 -116
  242. package/lib/__tests__/translations.test.js +0 -112
  243. package/lib/__tests__/validateThemeConfig.test.js +0 -333
  244. package/lib/theme/AnnouncementBar/index.js +0 -72
  245. package/lib/theme/AnnouncementBar/styles.module.css +0 -72
  246. package/lib/theme/BlogListPage/index.js +0 -71
  247. package/lib/theme/BlogListPaginator/index.js +0 -63
  248. package/lib/theme/BlogPostItem/index.js +0 -161
  249. package/lib/theme/BlogPostPage/index.js +0 -69
  250. package/lib/theme/BlogPostPaginator/index.js +0 -64
  251. package/lib/theme/BlogSidebar/index.js +0 -51
  252. package/lib/theme/BlogSidebar/styles.module.css +0 -44
  253. package/lib/theme/BlogTagsListPage/index.js +0 -76
  254. package/lib/theme/BlogTagsPostsPage/index.js +0 -100
  255. package/lib/theme/CodeBlock/index.js +0 -253
  256. package/lib/theme/CodeBlock/styles.module.css +0 -68
  257. package/lib/theme/DocItem/index.js +0 -129
  258. package/lib/theme/DocPage/index.js +0 -173
  259. package/lib/theme/DocPage/styles.module.css +0 -86
  260. package/lib/theme/DocPaginator/index.js +0 -63
  261. package/lib/theme/DocSidebar/index.js +0 -306
  262. package/lib/theme/DocSidebar/styles.module.css +0 -124
  263. package/lib/theme/DocVersionBanner/index.js +0 -128
  264. package/lib/theme/EditThisPage/index.js +0 -31
  265. package/lib/theme/Footer/index.js +0 -108
  266. package/lib/theme/Heading/index.js +0 -76
  267. package/lib/theme/Heading/styles.css +0 -23
  268. package/lib/theme/Heading/styles.module.css +0 -15
  269. package/lib/theme/IconArrow/index.js +0 -28
  270. package/lib/theme/IconEdit/index.js +0 -34
  271. package/lib/theme/IconExternalLink/index.js +0 -30
  272. package/lib/theme/IconLanguage/index.js +0 -29
  273. package/lib/theme/IconMenu/index.js +0 -30
  274. package/lib/theme/LastUpdated/index.js +0 -61
  275. package/lib/theme/Layout/index.js +0 -64
  276. package/lib/theme/Layout/styles.css +0 -27
  277. package/lib/theme/LayoutHead/index.js +0 -144
  278. package/lib/theme/LayoutProviders/index.js +0 -36
  279. package/lib/theme/Logo/index.js +0 -60
  280. package/lib/theme/MDXComponents/index.js +0 -65
  281. package/lib/theme/MDXPage/index.js +0 -66
  282. package/lib/theme/Navbar/index.js +0 -147
  283. package/lib/theme/Navbar/styles.module.css +0 -20
  284. package/lib/theme/NavbarItem/DefaultNavbarItem.js +0 -209
  285. package/lib/theme/NavbarItem/DocNavbarItem.js +0 -63
  286. package/lib/theme/NavbarItem/DocsVersionDropdownNavbarItem.js +0 -76
  287. package/lib/theme/NavbarItem/DocsVersionNavbarItem.js +0 -43
  288. package/lib/theme/NavbarItem/LocaleDropdownNavbarItem.js +0 -72
  289. package/lib/theme/NavbarItem/SearchNavbarItem.js +0 -28
  290. package/lib/theme/NavbarItem/index.js +0 -54
  291. package/lib/theme/NotFound.js +0 -57
  292. package/lib/theme/SearchBar.js +0 -15
  293. package/lib/theme/SearchMetadatas/index.js +0 -33
  294. package/lib/theme/Seo/index.js +0 -49
  295. package/lib/theme/SkipToContent/index.js +0 -63
  296. package/lib/theme/SkipToContent/styles.module.css +0 -14
  297. package/lib/theme/TOC/index.js +0 -59
  298. package/lib/theme/TOC/styles.module.css +0 -23
  299. package/lib/theme/TOCInline/index.js +0 -53
  300. package/lib/theme/TOCInline/styles.module.css +0 -12
  301. package/lib/theme/TabItem/index.js +0 -32
  302. package/lib/theme/Tabs/index.js +0 -150
  303. package/lib/theme/Tabs/styles.module.css +0 -23
  304. package/lib/theme/ThemeContext.js +0 -21
  305. package/lib/theme/ThemeProvider/index.js +0 -38
  306. package/lib/theme/ThemedImage/index.js +0 -49
  307. package/lib/theme/Toggle/index.js +0 -94
  308. package/lib/theme/Toggle/styles.css +0 -103
  309. package/lib/theme/Toggle/styles.module.css +0 -17
  310. package/lib/theme/UserPreferencesContext.js +0 -18
  311. package/lib/theme/UserPreferencesProvider/index.js +0 -36
  312. package/lib/theme/hooks/useContextualSearchFilters.js +0 -47
  313. package/lib/theme/hooks/useDocs.js +0 -18
  314. package/lib/theme/hooks/useHideableNavbar.js +0 -92
  315. package/lib/theme/hooks/useKeyboardNavigation.js +0 -45
  316. package/lib/theme/hooks/useLocationHash.js +0 -28
  317. package/lib/theme/hooks/useLockBodyScroll.js +0 -26
  318. package/lib/theme/hooks/usePrismTheme.js +0 -36
  319. package/lib/theme/hooks/useScrollPosition.js +0 -49
  320. package/lib/theme/hooks/useTOCHighlight.js +0 -87
  321. package/lib/theme/hooks/useTabGroupChoice.js +0 -51
  322. package/lib/theme/hooks/useTheme.js +0 -99
  323. package/lib/theme/hooks/useThemeContext.js +0 -31
  324. package/lib/theme/hooks/useUserPreferencesContext.js +0 -31
  325. package/lib/theme/hooks/useWindowSize.js +0 -55
  326. package/lib/theme/prism-include-languages.js +0 -39
  327. package/lib-next/__tests__/__snapshots__/translations.test.ts.snap +0 -116
  328. package/lib-next/__tests__/translations.test.js +0 -128
  329. package/lib-next/__tests__/validateThemeConfig.test.js +0 -333
  330. package/lib-next/index.js +0 -221
  331. package/lib-next/theme/Toggle/styles.css +0 -103
  332. package/lib-next/theme/hooks/useContextualSearchFilters.js +0 -41
  333. package/lib-next/theme/hooks/useLocationHash.js +0 -20
  334. package/lib-next/theme/hooks/useScrollPosition.js +0 -38
  335. package/lib-next/theme/hooks/useTOCHighlight.js +0 -84
  336. package/lib-next/translations.js +0 -145
  337. package/lib-next/validateThemeConfig.js +0 -317
  338. package/src/__tests__/__snapshots__/translations.test.ts.snap +0 -116
  339. package/src/__tests__/translations.test.ts +0 -116
  340. package/src/__tests__/validateThemeConfig.test.js +0 -333
  341. package/src/prism-include-languages.js +0 -11
  342. package/src/theme/Toggle/styles.css +0 -103
  343. package/src/theme/hooks/useContextualSearchFilters.ts +0 -52
  344. package/src/theme/hooks/useLocationHash.ts +0 -25
  345. package/src/theme/hooks/useScrollPosition.ts +0 -45
  346. package/src/theme/hooks/useTOCHighlight.ts +0 -98
  347. package/tsconfig.json +0 -12
  348. package/update-code-translations.js +0 -240
  349. package/update-code-translations.test.js +0 -33
package/lib-next/theme/Seo/index.js CHANGED
@@ -6,14 +6,16 @@
6
6
  */
7
7
  import React from 'react';
8
8
  import Head from '@docusaurus/Head';
9
- import {useThemeConfig, useTitleFormatter} from '@docusaurus/theme-common';
10
- import useBaseUrl from '@docusaurus/useBaseUrl';
11
- export default function Seo({title, description, keywords, image}) {
12
- const {image: defaultImage} = useThemeConfig();
9
+ import {useTitleFormatter} from '@docusaurus/theme-common';
10
+ import {useBaseUrlUtils} from '@docusaurus/useBaseUrl';
11
+ export default function Seo({title, description, keywords, image, children}) {
13
12
  const pageTitle = useTitleFormatter(title);
14
- const pageImage = useBaseUrl(image || defaultImage, {
15
- absolute: true,
16
- });
13
+ const {withBaseUrl} = useBaseUrlUtils();
14
+ const pageImage = image
15
+ ? withBaseUrl(image, {
16
+ absolute: true,
17
+ })
18
+ : undefined;
17
19
  return (
18
20
  <Head>
19
21
  {title && <title>{pageTitle}</title>}
@@ -31,6 +33,8 @@ export default function Seo({title, description, keywords, image}) {
31
33
 
32
34
  {pageImage && <meta property="og:image" content={pageImage} />}
33
35
  {pageImage && <meta name="twitter:image" content={pageImage} />}
36
+
37
+ {children}
34
38
  </Head>
35
39
  );
36
40
  }
package/lib-next/theme/SkipToContent/index.js CHANGED
@@ -5,6 +5,7 @@
5
5
  * LICENSE file in the root directory of this source tree.
6
6
  */
7
7
  import React, {useRef} from 'react';
8
+ import {useHistory} from '@docusaurus/router';
8
9
  import Translate from '@docusaurus/Translate';
9
10
  import {useLocationChange} from '@docusaurus/theme-common';
10
11
  import styles from './styles.module.css';
@@ -17,6 +18,7 @@ function programmaticFocus(el) {
17
18
 
18
19
  function SkipToContent() {
19
20
  const containerRef = useRef(null);
21
+ const {action} = useHistory();
20
22
 
21
23
  const handleSkip = (e) => {
22
24
  e.preventDefault();
@@ -30,13 +32,14 @@ function SkipToContent() {
30
32
  };
31
33
 
32
34
  useLocationChange(({location}) => {
33
- if (containerRef.current && !location.hash) {
35
+ if (containerRef.current && !location.hash && action === 'PUSH') {
34
36
  programmaticFocus(containerRef.current);
35
37
  }
36
38
  });
37
39
  return (
38
40
  <div ref={containerRef}>
39
- <a href="#main" className={styles.skipToContent} onClick={handleSkip}>
41
+ {/* eslint-disable-next-line jsx-a11y/anchor-is-valid */}
42
+ <a href="#" className={styles.skipToContent} onClick={handleSkip}>
40
43
  <Translate
41
44
  id="theme.common.skipToMainContent"
42
45
  description="The skip to content label used for accessibility, allowing to rapidly navigate to main content with keyboard tab/enter navigation">
package/lib-next/theme/TOC/index.js CHANGED
@@ -6,45 +6,21 @@
6
6
  */
7
7
  import React from 'react';
8
8
  import clsx from 'clsx';
9
- import useTOCHighlight from '@theme/hooks/useTOCHighlight';
10
- import styles from './styles.module.css';
11
- const LINK_CLASS_NAME = 'table-of-contents__link';
12
- const ACTIVE_LINK_CLASS_NAME = 'table-of-contents__link--active';
13
- const TOP_OFFSET = 100;
14
- /* eslint-disable jsx-a11y/control-has-associated-label */
9
+ import TOCItems from '@theme/TOCItems';
10
+ import styles from './styles.module.css'; // Using a custom className
11
+ // This prevents TOC highlighting to highlight TOCInline/TOCCollapsible by mistake
15
12
 
16
- function Headings({toc, isChild}) {
17
- if (!toc.length) {
18
- return null;
19
- }
13
+ const LINK_CLASS_NAME = 'table-of-contents__link toc-highlight';
14
+ const LINK_ACTIVE_CLASS_NAME = 'table-of-contents__link--active';
20
15
 
16
+ function TOC({className, ...props}) {
21
17
  return (
22
- <ul
23
- className={
24
- isChild ? '' : 'table-of-contents table-of-contents__left-border'
25
- }>
26
- {toc.map((heading) => (
27
- <li key={heading.id}>
28
- <a
29
- href={`#${heading.id}`}
30
- className={LINK_CLASS_NAME} // Developer provided the HTML, so assume it's safe.
31
- // eslint-disable-next-line react/no-danger
32
- dangerouslySetInnerHTML={{
33
- __html: heading.value,
34
- }}
35
- />
36
- <Headings isChild toc={heading.children} />
37
- </li>
38
- ))}
39
- </ul>
40
- );
41
- }
42
-
43
- function TOC({toc}) {
44
- useTOCHighlight(LINK_CLASS_NAME, ACTIVE_LINK_CLASS_NAME, TOP_OFFSET);
45
- return (
46
- <div className={clsx(styles.tableOfContents, 'thin-scrollbar')}>
47
- <Headings toc={toc} />
18
+ <div className={clsx(styles.tableOfContents, 'thin-scrollbar', className)}>
19
+ <TOCItems
20
+ {...props}
21
+ linkClassName={LINK_CLASS_NAME}
22
+ linkActiveClassName={LINK_ACTIVE_CLASS_NAME}
23
+ />
48
24
  </div>
49
25
  );
50
26
  }
package/lib-next/theme/TOC/styles.module.css CHANGED
@@ -12,7 +12,7 @@
12
12
  top: calc(var(--ifm-navbar-height) + 1rem);
13
13
  }
14
14
 
15
- @media only screen and (max-width: 996px) {
15
+ @media (max-width: 996px) {
16
16
  .tableOfContents {
17
17
  display: none;
18
18
  }
package/lib-next/theme/TOCCollapsible/index.js ADDED
@@ -0,0 +1,54 @@
1
+ /**
2
+ * Copyright (c) Facebook, Inc. and its affiliates.
3
+ *
4
+ * This source code is licensed under the MIT license found in the
5
+ * LICENSE file in the root directory of this source tree.
6
+ */
7
+ import React from 'react';
8
+ import clsx from 'clsx';
9
+ import Translate from '@docusaurus/Translate';
10
+ import {useCollapsible, Collapsible} from '@docusaurus/theme-common';
11
+ import styles from './styles.module.css';
12
+ import TOCItems from '@theme/TOCItems';
13
+ export default function TOCCollapsible({
14
+ toc,
15
+ className,
16
+ minHeadingLevel,
17
+ maxHeadingLevel,
18
+ }) {
19
+ const {collapsed, toggleCollapsed} = useCollapsible({
20
+ initialState: true,
21
+ });
22
+ return (
23
+ <div
24
+ className={clsx(
25
+ styles.tocCollapsible,
26
+ {
27
+ [styles.tocCollapsibleExpanded]: !collapsed,
28
+ },
29
+ className,
30
+ )}>
31
+ <button
32
+ type="button"
33
+ className={clsx('clean-btn', styles.tocCollapsibleButton)}
34
+ onClick={toggleCollapsed}>
35
+ <Translate
36
+ id="theme.TOCCollapsible.toggleButtonLabel"
37
+ description="The label used by the button on the collapsible TOC component">
38
+ On this page
39
+ </Translate>
40
+ </button>
41
+
42
+ <Collapsible
43
+ lazy
44
+ className={styles.tocCollapsibleContent}
45
+ collapsed={collapsed}>
46
+ <TOCItems
47
+ toc={toc}
48
+ minHeadingLevel={minHeadingLevel}
49
+ maxHeadingLevel={maxHeadingLevel}
50
+ />
51
+ </Collapsible>
52
+ </div>
53
+ );
54
+ }
package/lib-next/theme/TOCCollapsible/styles.module.css ADDED
@@ -0,0 +1,50 @@
1
+ /**
2
+ * Copyright (c) Facebook, Inc. and its affiliates.
3
+ *
4
+ * This source code is licensed under the MIT license found in the
5
+ * LICENSE file in the root directory of this source tree.
6
+ */
7
+
8
+ .tocCollapsible {
9
+ background-color: var(--ifm-menu-color-background-active);
10
+ border-radius: var(--ifm-global-radius);
11
+ margin: 1rem 0;
12
+ }
13
+
14
+ .tocCollapsibleButton {
15
+ font-size: inherit;
16
+ display: flex;
17
+ justify-content: space-between;
18
+ align-items: center;
19
+ padding: 0.4rem 0.8rem;
20
+ width: 100%;
21
+ }
22
+
23
+ .tocCollapsibleButton:after {
24
+ content: '';
25
+ background: var(--ifm-menu-link-sublist-icon) 50% 50% / 2rem 2rem no-repeat;
26
+ filter: var(--ifm-menu-link-sublist-icon-filter);
27
+ height: 1.25rem;
28
+ width: 1.25rem;
29
+ transform: rotate(180deg);
30
+ transition: transform var(--ifm-transition-fast);
31
+ }
32
+
33
+ .tocCollapsibleContent > ul {
34
+ border-left: none;
35
+ border-top: 1px solid var(--ifm-color-emphasis-300);
36
+ padding: 0.2rem 0;
37
+ font-size: 15px;
38
+ }
39
+
40
+ .tocCollapsibleContent ul li {
41
+ margin: 0.4rem 0.8rem;
42
+ }
43
+
44
+ .tocCollapsibleContent a {
45
+ display: block;
46
+ }
47
+
48
+ .tocCollapsibleExpanded .tocCollapsibleButton:after {
49
+ transform: none;
50
+ }
package/lib-next/theme/TOCInline/index.js CHANGED
@@ -5,37 +5,19 @@
5
5
  * LICENSE file in the root directory of this source tree.
6
6
  */
7
7
  import React from 'react';
8
- import clsx from 'clsx';
9
8
  import styles from './styles.module.css';
9
+ import TOCItems from '@theme/TOCItems';
10
10
 
11
- /* eslint-disable jsx-a11y/control-has-associated-label */
12
- function HeadingsInline({toc, isChild}) {
13
- if (!toc.length) {
14
- return null;
15
- }
16
-
17
- return (
18
- <ul className={isChild ? '' : 'table-of-contents'}>
19
- {toc.map((heading) => (
20
- <li key={heading.id}>
21
- <a
22
- href={`#${heading.id}`} // Developer provided the HTML, so assume it's safe.
23
- // eslint-disable-next-line react/no-danger
24
- dangerouslySetInnerHTML={{
25
- __html: heading.value,
26
- }}
27
- />
28
- <HeadingsInline isChild toc={heading.children} />
29
- </li>
30
- ))}
31
- </ul>
32
- );
33
- }
34
-
35
- function TOCInline({toc}) {
11
+ function TOCInline({toc, minHeadingLevel, maxHeadingLevel}) {
36
12
  return (
37
- <div className={clsx(styles.tableOfContentsInline)}>
38
- <HeadingsInline toc={toc} />
13
+ <div className={styles.tableOfContentsInline}>
14
+ <TOCItems
15
+ toc={toc}
16
+ minHeadingLevel={minHeadingLevel}
17
+ maxHeadingLevel={maxHeadingLevel}
18
+ className="table-of-contents"
19
+ linkClassName={null}
20
+ />
39
21
  </div>
40
22
  );
41
23
  }
package/lib-next/theme/TOCItems/index.js ADDED
@@ -0,0 +1,85 @@
1
+ /**
2
+ * Copyright (c) Facebook, Inc. and its affiliates.
3
+ *
4
+ * This source code is licensed under the MIT license found in the
5
+ * LICENSE file in the root directory of this source tree.
6
+ */
7
+ import React, {useMemo} from 'react';
8
+ import {
9
+ useThemeConfig,
10
+ useTOCFilter,
11
+ useTOCHighlight,
12
+ } from '@docusaurus/theme-common'; // Recursive component rendering the toc tree
13
+
14
+ /* eslint-disable jsx-a11y/control-has-associated-label */
15
+
16
+ function TOCItemList({toc, className, linkClassName, isChild}) {
17
+ if (!toc.length) {
18
+ return null;
19
+ }
20
+
21
+ return (
22
+ <ul className={isChild ? undefined : className}>
23
+ {toc.map((heading) => (
24
+ <li key={heading.id}>
25
+ <a
26
+ href={`#${heading.id}`}
27
+ className={linkClassName ?? undefined} // Developer provided the HTML, so assume it's safe.
28
+ // eslint-disable-next-line react/no-danger
29
+ dangerouslySetInnerHTML={{
30
+ __html: heading.value,
31
+ }}
32
+ />
33
+ <TOCItemList
34
+ isChild
35
+ toc={heading.children}
36
+ className={className}
37
+ linkClassName={linkClassName}
38
+ />
39
+ </li>
40
+ ))}
41
+ </ul>
42
+ );
43
+ }
44
+
45
+ export default function TOCItems({
46
+ toc,
47
+ className = 'table-of-contents table-of-contents__left-border',
48
+ linkClassName = 'table-of-contents__link',
49
+ linkActiveClassName = undefined,
50
+ minHeadingLevel: minHeadingLevelOption,
51
+ maxHeadingLevel: maxHeadingLevelOption,
52
+ ...props
53
+ }) {
54
+ const themeConfig = useThemeConfig();
55
+ const minHeadingLevel =
56
+ minHeadingLevelOption ?? themeConfig.tableOfContents.minHeadingLevel;
57
+ const maxHeadingLevel =
58
+ maxHeadingLevelOption ?? themeConfig.tableOfContents.maxHeadingLevel;
59
+ const tocFiltered = useTOCFilter({
60
+ toc,
61
+ minHeadingLevel,
62
+ maxHeadingLevel,
63
+ });
64
+ const tocHighlightConfig = useMemo(() => {
65
+ if (linkClassName && linkActiveClassName) {
66
+ return {
67
+ linkClassName,
68
+ linkActiveClassName,
69
+ minHeadingLevel,
70
+ maxHeadingLevel,
71
+ };
72
+ }
73
+
74
+ return undefined;
75
+ }, [linkClassName, linkActiveClassName, minHeadingLevel, maxHeadingLevel]);
76
+ useTOCHighlight(tocHighlightConfig);
77
+ return (
78
+ <TOCItemList
79
+ toc={tocFiltered}
80
+ className={className}
81
+ linkClassName={linkClassName}
82
+ {...props}
83
+ />
84
+ );
85
+ }
package/lib-next/theme/Tabs/__tests__/index.test.js ADDED
@@ -0,0 +1,142 @@
1
+ /**
2
+ * Copyright (c) Facebook, Inc. and its affiliates.
3
+ *
4
+ * This source code is licensed under the MIT license found in the
5
+ * LICENSE file in the root directory of this source tree.
6
+ */
7
+ import React from 'react';
8
+ import renderer from 'react-test-renderer';
9
+ import Tabs from '../index';
10
+ import TabItem from '../../TabItem';
11
+ import UserPreferencesProvider from '@theme/UserPreferencesProvider';
12
+ import {ScrollControllerProvider} from '@docusaurus/theme-common';
13
+ describe('Tabs', () => {
14
+ test('Should reject bad Tabs child', () => {
15
+ expect(() => {
16
+ renderer.create(
17
+ <Tabs>
18
+ <div>Naughty</div>
19
+ <TabItem value="good">Good</TabItem>
20
+ </Tabs>,
21
+ );
22
+ }).toThrowErrorMatchingInlineSnapshot(
23
+ `"Docusaurus error: Bad <Tabs> child <div>: all children of the <Tabs> component should be <TabItem>, and every <TabItem> should have a unique \\"value\\" prop."`,
24
+ );
25
+ });
26
+ test('Should reject bad Tabs defaultValue', () => {
27
+ expect(() => {
28
+ renderer.create(
29
+ <Tabs defaultValue="bad">
30
+ <TabItem value="v1">Tab 1</TabItem>
31
+ <TabItem value="v2">Tab 2</TabItem>
32
+ </Tabs>,
33
+ );
34
+ }).toThrowErrorMatchingInlineSnapshot(
35
+ `"Docusaurus error: The <Tabs> has a defaultValue \\"bad\\" but none of its children has the corresponding value. Available values are: v1, v2. If you intend to show no default tab, use defaultValue={null} instead."`,
36
+ );
37
+ });
38
+ test('Should reject duplicate values', () => {
39
+ expect(() => {
40
+ renderer.create(
41
+ <Tabs>
42
+ <TabItem value="v1">Tab 1</TabItem>
43
+ <TabItem value="v2">Tab 2</TabItem>
44
+ <TabItem value="v3">Tab 3</TabItem>
45
+ <TabItem value="v4">Tab 4</TabItem>
46
+ <TabItem value="v1">Tab 5</TabItem>
47
+ <TabItem value="v2">Tab 6</TabItem>
48
+ </Tabs>,
49
+ );
50
+ }).toThrowErrorMatchingInlineSnapshot(
51
+ `"Docusaurus error: Duplicate values \\"v1, v2\\" found in <Tabs>. Every value needs to be unique."`,
52
+ );
53
+ });
54
+ test('Should accept valid Tabs config', () => {
55
+ expect(() => {
56
+ renderer.create(
57
+ <ScrollControllerProvider>
58
+ <UserPreferencesProvider>
59
+ <Tabs>
60
+ <TabItem value="v1">Tab 1</TabItem>
61
+ <TabItem value="v2">Tab 2</TabItem>
62
+ </Tabs>
63
+ <Tabs>
64
+ <TabItem value="v1">Tab 1</TabItem>
65
+ <TabItem value="v2" default>
66
+ Tab 2
67
+ </TabItem>
68
+ </Tabs>
69
+ <Tabs defaultValue="v1">
70
+ <TabItem value="v1" label="V1">
71
+ Tab 1
72
+ </TabItem>
73
+ <TabItem value="v2" label="V2">
74
+ Tab 2
75
+ </TabItem>
76
+ </Tabs>
77
+ <Tabs
78
+ defaultValue="v1"
79
+ values={[
80
+ {
81
+ value: 'v1',
82
+ label: 'V1',
83
+ },
84
+ {
85
+ value: 'v2',
86
+ label: 'V2',
87
+ },
88
+ ]}>
89
+ <TabItem value="v1">Tab 1</TabItem>
90
+ <TabItem value="v2">Tab 2</TabItem>
91
+ </Tabs>
92
+ <Tabs
93
+ defaultValue={null}
94
+ values={[
95
+ {
96
+ value: 'v1',
97
+ label: 'V1',
98
+ },
99
+ {
100
+ value: 'v2',
101
+ label: 'V2',
102
+ },
103
+ ]}>
104
+ <TabItem value="v1">Tab 1</TabItem>
105
+ <TabItem value="v2">Tab 2</TabItem>
106
+ </Tabs>
107
+ <Tabs defaultValue={null}>
108
+ <TabItem value="v1" label="V1">
109
+ Tab 1
110
+ </TabItem>
111
+ <TabItem value="v2" label="V2">
112
+ Tab 2
113
+ </TabItem>
114
+ </Tabs>
115
+ </UserPreferencesProvider>
116
+ </ScrollControllerProvider>,
117
+ );
118
+ }).not.toThrow(); // TODO Better Jest infrastructure to mock the Layout
119
+ }); // https://github.com/facebook/docusaurus/issues/5729
120
+
121
+ test('Should accept dynamic Tabs with number values', () => {
122
+ expect(() => {
123
+ const tabs = ['Apple', 'Banana', 'Carrot'];
124
+ renderer.create(
125
+ <ScrollControllerProvider>
126
+ <UserPreferencesProvider>
127
+ <Tabs
128
+ values={tabs.map((t, idx) => ({
129
+ label: t,
130
+ value: idx,
131
+ }))}
132
+ defaultValue={0}>
133
+ {tabs.map((t, idx) => (
134
+ <TabItem value={idx}>{t}</TabItem>
135
+ ))}
136
+ </Tabs>
137
+ </UserPreferencesProvider>
138
+ </ScrollControllerProvider>,
139
+ );
140
+ }).not.toThrow();
141
+ });
142
+ });