@docusaurus/theme-common 2.0.0-beta.16 → 2.0.0-beta.17
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.
- package/lib/components/Collapsible/index.js +4 -5
- package/lib/components/Collapsible/index.js.map +1 -1
- package/lib/hooks/useHideableNavbar.js +1 -1
- package/lib/hooks/useHideableNavbar.js.map +1 -1
- package/lib/hooks/useSearchPage.js +1 -2
- package/lib/hooks/useSearchPage.js.map +1 -1
- package/lib/index.d.ts +1 -1
- package/lib/index.d.ts.map +1 -1
- package/lib/index.js +1 -1
- package/lib/index.js.map +1 -1
- package/lib/utils/announcementBarUtils.d.ts +1 -1
- package/lib/utils/announcementBarUtils.d.ts.map +1 -1
- package/lib/utils/announcementBarUtils.js +4 -3
- package/lib/utils/announcementBarUtils.js.map +1 -1
- package/lib/utils/codeBlockUtils.js +2 -3
- package/lib/utils/codeBlockUtils.js.map +1 -1
- package/lib/utils/colorModeUtils.d.ts +1 -1
- package/lib/utils/colorModeUtils.d.ts.map +1 -1
- package/lib/utils/colorModeUtils.js +2 -1
- package/lib/utils/colorModeUtils.js.map +1 -1
- package/lib/utils/docSidebarItemsExpandedState.d.ts.map +1 -1
- package/lib/utils/docSidebarItemsExpandedState.js +2 -1
- package/lib/utils/docSidebarItemsExpandedState.js.map +1 -1
- package/lib/utils/docsPreferredVersion/DocsPreferredVersionProvider.d.ts.map +1 -1
- package/lib/utils/docsPreferredVersion/DocsPreferredVersionProvider.js +2 -1
- package/lib/utils/docsPreferredVersion/DocsPreferredVersionProvider.js.map +1 -1
- package/lib/utils/docsUtils.d.ts.map +1 -1
- package/lib/utils/docsUtils.js +4 -4
- package/lib/utils/docsUtils.js.map +1 -1
- package/lib/utils/mobileSecondaryMenu.d.ts.map +1 -1
- package/lib/utils/mobileSecondaryMenu.js +2 -1
- package/lib/utils/mobileSecondaryMenu.js.map +1 -1
- package/lib/utils/pathUtils.js +3 -6
- package/lib/utils/pathUtils.js.map +1 -1
- package/lib/utils/reactUtils.d.ts +5 -2
- package/lib/utils/reactUtils.d.ts.map +1 -1
- package/lib/utils/reactUtils.js +7 -0
- package/lib/utils/reactUtils.js.map +1 -1
- package/lib/utils/routesUtils.d.ts +4 -1
- package/lib/utils/routesUtils.d.ts.map +1 -1
- package/lib/utils/routesUtils.js +25 -17
- package/lib/utils/routesUtils.js.map +1 -1
- package/lib/utils/scrollUtils.d.ts.map +1 -1
- package/lib/utils/scrollUtils.js +3 -4
- package/lib/utils/scrollUtils.js.map +1 -1
- package/lib/utils/storageUtils.js +1 -1
- package/lib/utils/storageUtils.js.map +1 -1
- package/lib/utils/tabGroupChoiceUtils.d.ts.map +1 -1
- package/lib/utils/tabGroupChoiceUtils.js +2 -1
- package/lib/utils/tabGroupChoiceUtils.js.map +1 -1
- package/lib/utils/tagsUtils.js +1 -2
- package/lib/utils/tagsUtils.js.map +1 -1
- package/lib/utils/useContextualSearchFilters.js +2 -3
- package/lib/utils/useContextualSearchFilters.js.map +1 -1
- package/lib/utils/useTOCHighlight.js +2 -4
- package/lib/utils/useTOCHighlight.js.map +1 -1
- package/lib/utils/useThemeConfig.d.ts +0 -7
- package/lib/utils/useThemeConfig.d.ts.map +1 -1
- package/lib/utils/useThemeConfig.js.map +1 -1
- package/package.json +8 -8
- package/src/index.ts +1 -0
- package/src/utils/announcementBarUtils.tsx +4 -5
- package/src/utils/colorModeUtils.tsx +5 -3
- package/src/utils/docSidebarItemsExpandedState.tsx +2 -3
- package/src/utils/docsPreferredVersion/DocsPreferredVersionProvider.tsx +2 -3
- package/src/utils/docsUtils.tsx +3 -2
- package/src/utils/mobileSecondaryMenu.tsx +2 -3
- package/src/utils/reactUtils.tsx +10 -0
- package/src/utils/routesUtils.ts +38 -21
- package/src/utils/scrollUtils.tsx +2 -4
- package/src/utils/tabGroupChoiceUtils.tsx +2 -3
- package/src/utils/useThemeConfig.ts +0 -7
package/lib/utils/routesUtils.js
CHANGED
|
@@ -6,28 +6,36 @@
|
|
|
6
6
|
*/
|
|
7
7
|
import GeneratedRoutes from '@generated/routes';
|
|
8
8
|
import { useMemo } from 'react';
|
|
9
|
-
|
|
10
|
-
return route.path === '/' && route.exact === true;
|
|
11
|
-
}
|
|
12
|
-
function isHomeParentRoute(route) {
|
|
13
|
-
return route.path === '/' && route.exact === false;
|
|
14
|
-
}
|
|
9
|
+
import useDocusaurusContext from '@docusaurus/useDocusaurusContext';
|
|
15
10
|
// Note that all sites don't always have a homepage in practice
|
|
16
11
|
// See https://github.com/facebook/docusaurus/pull/6517#issuecomment-1048709116
|
|
17
|
-
export function findHomePageRoute(routes
|
|
18
|
-
|
|
19
|
-
return
|
|
12
|
+
export function findHomePageRoute({ baseUrl, routes: initialRoutes, }) {
|
|
13
|
+
function isHomePageRoute(route) {
|
|
14
|
+
return route.path === baseUrl && route.exact === true;
|
|
15
|
+
}
|
|
16
|
+
function isHomeParentRoute(route) {
|
|
17
|
+
return route.path === baseUrl && !route.exact;
|
|
20
18
|
}
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
19
|
+
function doFindHomePageRoute(routes) {
|
|
20
|
+
if (routes.length === 0) {
|
|
21
|
+
return undefined;
|
|
22
|
+
}
|
|
23
|
+
const homePage = routes.find(isHomePageRoute);
|
|
24
|
+
if (homePage) {
|
|
25
|
+
return homePage;
|
|
26
|
+
}
|
|
27
|
+
const indexSubRoutes = routes
|
|
28
|
+
.filter(isHomeParentRoute)
|
|
29
|
+
.flatMap((route) => route.routes ?? []);
|
|
30
|
+
return doFindHomePageRoute(indexSubRoutes);
|
|
24
31
|
}
|
|
25
|
-
|
|
26
|
-
.filter(isHomeParentRoute)
|
|
27
|
-
.flatMap((route) => { var _a; return (_a = route.routes) !== null && _a !== void 0 ? _a : []; });
|
|
28
|
-
return findHomePageRoute(indexSubRoutes);
|
|
32
|
+
return doFindHomePageRoute(initialRoutes);
|
|
29
33
|
}
|
|
30
34
|
export function useHomePageRoute() {
|
|
31
|
-
|
|
35
|
+
const { baseUrl } = useDocusaurusContext().siteConfig;
|
|
36
|
+
return useMemo(() => findHomePageRoute({
|
|
37
|
+
routes: GeneratedRoutes,
|
|
38
|
+
baseUrl,
|
|
39
|
+
}), [baseUrl]);
|
|
32
40
|
}
|
|
33
41
|
//# sourceMappingURL=routesUtils.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"routesUtils.js","sourceRoot":"","sources":["../../src/utils/routesUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,eAA6B,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAC,OAAO,EAAC,MAAM,OAAO,CAAC;
|
|
1
|
+
{"version":3,"file":"routesUtils.js","sourceRoot":"","sources":["../../src/utils/routesUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,eAA6B,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAC,OAAO,EAAC,MAAM,OAAO,CAAC;AAC9B,OAAO,oBAAoB,MAAM,kCAAkC,CAAC;AAEpE,+DAA+D;AAC/D,+EAA+E;AAC/E,MAAM,UAAU,iBAAiB,CAAC,EAChC,OAAO,EACP,MAAM,EAAE,aAAa,GAItB;IACC,SAAS,eAAe,CAAC,KAAY;QACnC,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC;IACxD,CAAC;IAED,SAAS,iBAAiB,CAAC,KAAY;QACrC,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;IAChD,CAAC;IAED,SAAS,mBAAmB,CAAC,MAAe;QAC1C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE;YACvB,OAAO,SAAS,CAAC;SAClB;QACD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC9C,IAAI,QAAQ,EAAE;YACZ,OAAO,QAAQ,CAAC;SACjB;QACD,MAAM,cAAc,GAAG,MAAM;aAC1B,MAAM,CAAC,iBAAiB,CAAC;aACzB,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;QAC1C,OAAO,mBAAmB,CAAC,cAAc,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,mBAAmB,CAAC,aAAa,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,MAAM,EAAC,OAAO,EAAC,GAAG,oBAAoB,EAAE,CAAC,UAAU,CAAC;IACpD,OAAO,OAAO,CACZ,GAAG,EAAE,CACH,iBAAiB,CAAC;QAChB,MAAM,EAAE,eAAe;QACvB,OAAO;KACR,CAAC,EACJ,CAAC,OAAO,CAAC,CACV,CAAC;AACJ,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"scrollUtils.d.ts","sourceRoot":"","sources":["../../src/utils/scrollUtils.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,EAEZ,KAAK,SAAS,EAOf,MAAM,OAAO,CAAC;AAIf;;;;;;GAMG;AACH,aAAK,gBAAgB,GAAG;IACtB;;OAEG;IACH,sBAAsB,EAAE,KAAK,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACxD;;OAEG;IACH,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B;;OAEG;IACH,mBAAmB,EAAE,MAAM,IAAI,CAAC;CACjC,CAAC;AAuBF,wBAAgB,wBAAwB,CAAC,EACvC,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,GAAG,CAAC,OAAO,CAMd;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,
|
|
1
|
+
{"version":3,"file":"scrollUtils.d.ts","sourceRoot":"","sources":["../../src/utils/scrollUtils.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,EAEZ,KAAK,SAAS,EAOf,MAAM,OAAO,CAAC;AAIf;;;;;;GAMG;AACH,aAAK,gBAAgB,GAAG;IACtB;;OAEG;IACH,sBAAsB,EAAE,KAAK,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACxD;;OAEG;IACH,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B;;OAEG;IACH,mBAAmB,EAAE,MAAM,IAAI,CAAC;CACjC,CAAC;AAuBF,wBAAgB,wBAAwB,CAAC,EACvC,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,GAAG,CAAC,OAAO,CAMd;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,CAMtD;AAUD,aAAK,cAAc,GAAG;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAC,CAAC;AAEzD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,CACN,QAAQ,EAAE,cAAc,EACxB,YAAY,EAAE,cAAc,GAAG,IAAI,KAChC,IAAI,EACT,IAAI,GAAE,OAAO,EAAO,GACnB,IAAI,CAkCN;AA+CD,aAAK,8BAA8B,GAAG;IACpC,yCAAyC,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,IAAI,CAAC;CACtE,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,IAAI,8BAA8B,CAwCzE"}
|
package/lib/utils/scrollUtils.js
CHANGED
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
* LICENSE file in the root directory of this source tree.
|
|
6
6
|
*/
|
|
7
7
|
import React, { createContext, useCallback, useContext, useEffect, useLayoutEffect, useMemo, useRef, } from 'react';
|
|
8
|
-
import { useDynamicCallback } from './reactUtils';
|
|
8
|
+
import { useDynamicCallback, ReactContextError } from './reactUtils';
|
|
9
9
|
import ExecutionEnvironment from '@docusaurus/ExecutionEnvironment';
|
|
10
10
|
function useScrollControllerContextValue() {
|
|
11
11
|
const scrollEventsEnabledRef = useRef(true);
|
|
@@ -26,7 +26,7 @@ export function ScrollControllerProvider({ children, }) {
|
|
|
26
26
|
export function useScrollController() {
|
|
27
27
|
const context = useContext(ScrollMonitorContext);
|
|
28
28
|
if (context == null) {
|
|
29
|
-
throw new
|
|
29
|
+
throw new ReactContextError('ScrollControllerProvider');
|
|
30
30
|
}
|
|
31
31
|
return context;
|
|
32
32
|
}
|
|
@@ -126,8 +126,7 @@ export function useScrollPositionBlocker() {
|
|
|
126
126
|
};
|
|
127
127
|
}, [scrollController, scrollPositionSaver]);
|
|
128
128
|
useLayoutEffect(() => {
|
|
129
|
-
|
|
130
|
-
(_a = nextLayoutEffectCallbackRef.current) === null || _a === void 0 ? void 0 : _a.call(nextLayoutEffectCallbackRef);
|
|
129
|
+
nextLayoutEffectCallbackRef.current?.();
|
|
131
130
|
});
|
|
132
131
|
return {
|
|
133
132
|
blockElementScrollPositionUntilNextRender,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"scrollUtils.js","sourceRoot":"","sources":["../../src/utils/scrollUtils.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,EACZ,aAAa,EAEb,WAAW,EACX,UAAU,EACV,SAAS,EACT,eAAe,EACf,OAAO,EACP,MAAM,GACP,MAAM,OAAO,CAAC;AACf,OAAO,EAAC,kBAAkB,EAAC,MAAM,cAAc,CAAC;
|
|
1
|
+
{"version":3,"file":"scrollUtils.js","sourceRoot":"","sources":["../../src/utils/scrollUtils.tsx"],"names":[],"mappings":"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"}
|
|
@@ -64,7 +64,7 @@ export const createStorageSlot = (key, options) => {
|
|
|
64
64
|
if (typeof window === 'undefined') {
|
|
65
65
|
return createServerStorageSlot(key);
|
|
66
66
|
}
|
|
67
|
-
const browserStorage = getBrowserStorage(options
|
|
67
|
+
const browserStorage = getBrowserStorage(options?.persistence);
|
|
68
68
|
if (browserStorage === null) {
|
|
69
69
|
return NoopStorageSlot;
|
|
70
70
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"storageUtils.js","sourceRoot":"","sources":["../../src/utils/storageUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,YAAY,GAAG,CAAC,cAAc,EAAE,gBAAgB,EAAE,MAAM,CAAU,CAAC;AAIzE,MAAM,kBAAkB,GAAgB,cAAc,CAAC;AAEvD,8EAA8E;AAC9E,+DAA+D;AAC/D,SAAS,iBAAiB,CACxB,cAA2B,kBAAkB;IAE7C,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE;QACjC,MAAM,IAAI,KAAK,CACb,qEAAqE,CACtE,CAAC;KACH;IACD,IAAI,WAAW,KAAK,MAAM,EAAE;QAC1B,OAAO,IAAI,CAAC;KACb;IACD,IAAI;QACF,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC;KAC5B;IAAC,OAAO,GAAG,EAAE;QACZ,wCAAwC,CAAC,GAAY,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC;KACb;AACH,CAAC;AAED;;;GAGG;AACH,IAAI,0CAA0C,GAAG,KAAK,CAAC;AACvD,SAAS,wCAAwC,CAAC,KAAY;IAC5D,IAAI,CAAC,0CAA0C,EAAE;QAC/C,OAAO,CAAC,IAAI,CACV;kIAC4H,EAC5H,KAAK,CACN,CAAC;QACF,0CAA0C,GAAG,IAAI,CAAC;KACnD;AACH,CAAC;AASD,MAAM,eAAe,GAAgB;IACnC,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI;IACf,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC;IACb,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC;CACd,CAAC;AAEF,wEAAwE;AACxE,SAAS,uBAAuB,CAAC,GAAW;IAC1C,SAAS,UAAU;QACjB,MAAM,IAAI,KAAK,CAAC,8CAA8C,GAAG;;6DAER,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO;QACL,GAAG,EAAE,UAAU;QACf,GAAG,EAAE,UAAU;QACf,GAAG,EAAE,UAAU;KAChB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,GAAW,EACX,OAAqC,EACxB,EAAE;IACf,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE;QACjC,OAAO,uBAAuB,CAAC,GAAG,CAAC,CAAC;KACrC;IACD,MAAM,cAAc,GAAG,iBAAiB,CAAC,OAAO,
|
|
1
|
+
{"version":3,"file":"storageUtils.js","sourceRoot":"","sources":["../../src/utils/storageUtils.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tabGroupChoiceUtils.d.ts","sourceRoot":"","sources":["../../src/utils/tabGroupChoiceUtils.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAc,EAOZ,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;
|
|
1
|
+
{"version":3,"file":"tabGroupChoiceUtils.d.ts","sourceRoot":"","sources":["../../src/utils/tabGroupChoiceUtils.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAc,EAOZ,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAMf,aAAK,0BAA0B,GAAG;IAChC,QAAQ,CAAC,eAAe,EAAE;QAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;KAAC,CAAC;IAC/D,QAAQ,CAAC,kBAAkB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3E,CAAC;AAsCF,wBAAgB,sBAAsB,CAAC,EACrC,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,GAAG,CAAC,OAAO,CAcd;AAED,wBAAgB,iBAAiB,IAAI,0BAA0B,CAM9D"}
|
|
@@ -6,6 +6,7 @@
|
|
|
6
6
|
*/
|
|
7
7
|
import React, { useState, useCallback, useEffect, createContext, useMemo, useContext, } from 'react';
|
|
8
8
|
import { createStorageSlot, listStorageKeys } from './storageUtils';
|
|
9
|
+
import { ReactContextError } from './reactUtils';
|
|
9
10
|
const TAB_CHOICE_PREFIX = 'docusaurus.tab.';
|
|
10
11
|
const TabGroupChoiceContext = createContext(undefined);
|
|
11
12
|
function useTabGroupChoiceContextValue() {
|
|
@@ -47,7 +48,7 @@ export function TabGroupChoiceProvider({ children, }) {
|
|
|
47
48
|
export function useTabGroupChoice() {
|
|
48
49
|
const context = useContext(TabGroupChoiceContext);
|
|
49
50
|
if (context == null) {
|
|
50
|
-
throw new
|
|
51
|
+
throw new ReactContextError('TabGroupChoiceProvider');
|
|
51
52
|
}
|
|
52
53
|
return context;
|
|
53
54
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tabGroupChoiceUtils.js","sourceRoot":"","sources":["../../src/utils/tabGroupChoiceUtils.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,EACZ,QAAQ,EACR,WAAW,EACX,SAAS,EACT,aAAa,EACb,OAAO,EACP,UAAU,GAEX,MAAM,OAAO,CAAC;AACf,OAAO,EAAC,iBAAiB,EAAE,eAAe,EAAC,MAAM,gBAAgB,CAAC;
|
|
1
|
+
{"version":3,"file":"tabGroupChoiceUtils.js","sourceRoot":"","sources":["../../src/utils/tabGroupChoiceUtils.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,EACZ,QAAQ,EACR,WAAW,EACX,SAAS,EACT,aAAa,EACb,OAAO,EACP,UAAU,GAEX,MAAM,OAAO,CAAC;AACf,OAAO,EAAC,iBAAiB,EAAE,eAAe,EAAC,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAC,iBAAiB,EAAC,MAAM,cAAc,CAAC;AAE/C,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AAO5C,MAAM,qBAAqB,GAAG,aAAa,CAEzC,SAAS,CAAC,CAAC;AAEb,SAAS,6BAA6B;IACpC,MAAM,CAAC,eAAe,EAAE,UAAU,CAAC,GAAG,QAAQ,CAE3C,EAAE,CAAC,CAAC;IACP,MAAM,6BAA6B,GAAG,WAAW,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE;QACvE,iBAAiB,CAAC,GAAG,iBAAiB,GAAG,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACrE,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,SAAS,CAAC,GAAG,EAAE;QACb,IAAI;YACF,MAAM,mBAAmB,GAA2B,EAAE,CAAC;YACvD,eAAe,EAAE,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;gBACvC,IAAI,UAAU,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE;oBAC5C,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;oBAC/D,mBAAmB,CAAC,OAAO,CAAC,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC,GAAG,EAAG,CAAC;iBACrE;YACH,CAAC,CAAC,CAAC;YACH,UAAU,CAAC,mBAAmB,CAAC,CAAC;SACjC;QAAC,OAAO,GAAG,EAAE;YACZ,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;SACpB;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO;QACL,eAAe;QACf,kBAAkB,EAAE,CAAC,OAAe,EAAE,SAAiB,EAAE,EAAE;YACzD,UAAU,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,EAAC,GAAG,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE,SAAS,EAAC,CAAC,CAAC,CAAC;YACpE,6BAA6B,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACpD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,EACrC,QAAQ,GAGT;IACC,MAAM,EAAC,eAAe,EAAE,kBAAkB,EAAC,GAAG,6BAA6B,EAAE,CAAC;IAC9E,MAAM,YAAY,GAAG,OAAO,CAC1B,GAAG,EAAE,CAAC,CAAC;QACL,eAAe;QACf,kBAAkB;KACnB,CAAC,EACF,CAAC,eAAe,EAAE,kBAAkB,CAAC,CACtC,CAAC;IACF,OAAO,CACL,oBAAC,qBAAqB,CAAC,QAAQ,IAAC,KAAK,EAAE,YAAY,IAChD,QAAQ,CACsB,CAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,MAAM,OAAO,GAAG,UAAU,CAAC,qBAAqB,CAAC,CAAC;IAClD,IAAI,OAAO,IAAI,IAAI,EAAE;QACnB,MAAM,IAAI,iBAAiB,CAAC,wBAAwB,CAAC,CAAC;KACvD;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}
|
package/lib/utils/tagsUtils.js
CHANGED
|
@@ -17,9 +17,8 @@ export function listTagsByLetters(tags) {
|
|
|
17
17
|
// Group by letters
|
|
18
18
|
const groups = {};
|
|
19
19
|
Object.values(tags).forEach((tag) => {
|
|
20
|
-
var _a;
|
|
21
20
|
const letter = getTagLetter(tag.name);
|
|
22
|
-
groups[letter] =
|
|
21
|
+
groups[letter] = groups[letter] ?? [];
|
|
23
22
|
groups[letter].push(tag);
|
|
24
23
|
});
|
|
25
24
|
return (Object.entries(groups)
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tagsUtils.js","sourceRoot":"","sources":["../../src/utils/tagsUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAC,SAAS,EAAC,MAAM,uBAAuB,CAAC;AAEhD,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAW,EAAE,CACjD,SAAS,CAAC;IACR,EAAE,EAAE,0BAA0B;IAC9B,OAAO,EAAE,MAAM;IACf,WAAW,EAAE,gCAAgC;CAC9C,CAAC,CAAC;AAML,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,IAA6B;IAE7B,mBAAmB;IACnB,MAAM,MAAM,GAAmC,EAAE,CAAC;IAClD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE
|
|
1
|
+
{"version":3,"file":"tagsUtils.js","sourceRoot":"","sources":["../../src/utils/tagsUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAC,SAAS,EAAC,MAAM,uBAAuB,CAAC;AAEhD,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAW,EAAE,CACjD,SAAS,CAAC;IACR,EAAE,EAAE,0BAA0B;IAC9B,OAAO,EAAE,MAAM;IACf,WAAW,EAAE,gCAAgC;CAC9C,CAAC,CAAC;AAML,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,IAA6B;IAE7B,mBAAmB;IACnB,MAAM,MAAM,GAAmC,EAAE,CAAC;IAClD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QAClC,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,OAAO,CACL,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;QACpB,eAAe;SACd,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;SAC9D,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,EAAE;QAC5B,4BAA4B;QAC5B,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAChD,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CACnC,CAAC;QACF,OAAO,EAAC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAC,CAAC;IACpC,CAAC,CAAC,CACL,CAAC;AACJ,CAAC"}
|
|
@@ -16,13 +16,12 @@ export function useContextualSearchFilters() {
|
|
|
16
16
|
const activePluginAndVersion = useActivePluginAndVersion();
|
|
17
17
|
const docsPreferredVersionByPluginId = useDocsPreferredVersionByPluginId();
|
|
18
18
|
function getDocPluginTags(pluginId) {
|
|
19
|
-
|
|
20
|
-
const activeVersion = ((_a = activePluginAndVersion === null || activePluginAndVersion === void 0 ? void 0 : activePluginAndVersion.activePlugin) === null || _a === void 0 ? void 0 : _a.pluginId) === pluginId
|
|
19
|
+
const activeVersion = activePluginAndVersion?.activePlugin?.pluginId === pluginId
|
|
21
20
|
? activePluginAndVersion.activeVersion
|
|
22
21
|
: undefined;
|
|
23
22
|
const preferredVersion = docsPreferredVersionByPluginId[pluginId];
|
|
24
23
|
const latestVersion = allDocsData[pluginId].versions.find((v) => v.isLast);
|
|
25
|
-
const version =
|
|
24
|
+
const version = activeVersion ?? preferredVersion ?? latestVersion;
|
|
26
25
|
return docVersionSearchTag(pluginId, version.name);
|
|
27
26
|
}
|
|
28
27
|
const tags = [
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"useContextualSearchFilters.js","sourceRoot":"","sources":["../../src/utils/useContextualSearchFilters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,cAAc,EACd,yBAAyB,GAC1B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAC,iCAAiC,EAAC,MAAM,gDAAgD,CAAC;AACjG,OAAO,EAAC,mBAAmB,EAAE,kBAAkB,EAAC,MAAM,eAAe,CAAC;AACtE,OAAO,oBAAoB,MAAM,kCAAkC,CAAC;AAOpE,uEAAuE;AACvE,8EAA8E;AAC9E,MAAM,UAAU,0BAA0B;IACxC,MAAM,EAAC,IAAI,EAAC,GAAG,oBAAoB,EAAE,CAAC;IACtC,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,MAAM,sBAAsB,GAAG,yBAAyB,EAAE,CAAC;IAC3D,MAAM,8BAA8B,GAAG,iCAAiC,EAAE,CAAC;IAE3E,SAAS,gBAAgB,CAAC,QAAgB
|
|
1
|
+
{"version":3,"file":"useContextualSearchFilters.js","sourceRoot":"","sources":["../../src/utils/useContextualSearchFilters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,cAAc,EACd,yBAAyB,GAC1B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAC,iCAAiC,EAAC,MAAM,gDAAgD,CAAC;AACjG,OAAO,EAAC,mBAAmB,EAAE,kBAAkB,EAAC,MAAM,eAAe,CAAC;AACtE,OAAO,oBAAoB,MAAM,kCAAkC,CAAC;AAOpE,uEAAuE;AACvE,8EAA8E;AAC9E,MAAM,UAAU,0BAA0B;IACxC,MAAM,EAAC,IAAI,EAAC,GAAG,oBAAoB,EAAE,CAAC;IACtC,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,MAAM,sBAAsB,GAAG,yBAAyB,EAAE,CAAC;IAC3D,MAAM,8BAA8B,GAAG,iCAAiC,EAAE,CAAC;IAE3E,SAAS,gBAAgB,CAAC,QAAgB;QACxC,MAAM,aAAa,GACjB,sBAAsB,EAAE,YAAY,EAAE,QAAQ,KAAK,QAAQ;YACzD,CAAC,CAAC,sBAAsB,CAAC,aAAa;YACtC,CAAC,CAAC,SAAS,CAAC;QAEhB,MAAM,gBAAgB,GAAG,8BAA8B,CAAC,QAAQ,CAAC,CAAC;QAElE,MAAM,aAAa,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAE,CAAC;QAE5E,MAAM,OAAO,GAAG,aAAa,IAAI,gBAAgB,IAAI,aAAa,CAAC;QAEnE,OAAO,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,IAAI,GAAG;QACX,kBAAkB;QAClB,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC;KAClD,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,aAAa;QAC1B,IAAI;KACL,CAAC;AACJ,CAAC"}
|
|
@@ -35,7 +35,6 @@ function getAnchors({ minHeadingLevel, maxHeadingLevel, }) {
|
|
|
35
35
|
return Array.from(document.querySelectorAll(selectors.join()));
|
|
36
36
|
}
|
|
37
37
|
function getActiveAnchor(anchors, { anchorTopOffset, }) {
|
|
38
|
-
var _a;
|
|
39
38
|
// Naming is hard: The "nextVisibleAnchor" is the first anchor that appear
|
|
40
39
|
// under the viewport top boundary. It does not mean this anchor is visible
|
|
41
40
|
// yet, but if user continues scrolling down, it will be the first to become
|
|
@@ -57,7 +56,7 @@ function getActiveAnchor(anchors, { anchorTopOffset, }) {
|
|
|
57
56
|
// main text appearing in the user screen mostly belong to the previous
|
|
58
57
|
// anchor. Returns null for the first anchor, see
|
|
59
58
|
// https://github.com/facebook/docusaurus/issues/5318
|
|
60
|
-
return
|
|
59
|
+
return anchors[anchors.indexOf(nextVisibleAnchor) - 1] ?? null;
|
|
61
60
|
}
|
|
62
61
|
// no anchor under viewport top? (ie we are at the bottom of the page)
|
|
63
62
|
// => highlight the last anchor found
|
|
@@ -92,10 +91,9 @@ export default function useTOCHighlight(config) {
|
|
|
92
91
|
}
|
|
93
92
|
const { linkClassName, linkActiveClassName, minHeadingLevel, maxHeadingLevel, } = config;
|
|
94
93
|
function updateLinkActiveClass(link, active) {
|
|
95
|
-
var _a;
|
|
96
94
|
if (active) {
|
|
97
95
|
if (lastActiveLinkRef.current && lastActiveLinkRef.current !== link) {
|
|
98
|
-
|
|
96
|
+
lastActiveLinkRef.current?.classList.remove(linkActiveClassName);
|
|
99
97
|
}
|
|
100
98
|
link.classList.add(linkActiveClassName);
|
|
101
99
|
lastActiveLinkRef.current = link;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"useTOCHighlight.js","sourceRoot":"","sources":["../../src/utils/useTOCHighlight.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAC,SAAS,EAAE,MAAM,EAAC,MAAM,OAAO,CAAC;AACxC,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAC;AAEhD;;;GAGG;AAEH,+EAA+E;AAC/E,0DAA0D;AAC1D,SAAS,4BAA4B,CAAC,OAAoB;IACxD,MAAM,IAAI,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,MAAM,CAAC;IAC7C,IAAI,WAAW,EAAE;QACf,OAAO,4BAA4B,CAAC,OAAO,CAAC,UAAyB,CAAC,CAAC;KACxE;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,SAAS,mBAAmB,CAAC,YAAqB;IAChD,OAAO,YAAY,CAAC,GAAG,GAAG,CAAC,IAAI,YAAY,CAAC,MAAM,GAAG,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,UAAU,CAAC,EAClB,eAAe,EACf,eAAe,GAIhB;IACC,MAAM,SAAS,GAAG,EAAE,CAAC;IACrB,KAAK,IAAI,CAAC,GAAG,eAAe,EAAE,CAAC,IAAI,eAAe,EAAE,CAAC,IAAI,CAAC,EAAE;QAC1D,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;KAChC;IAED,OAAO,KAAK,CAAC,IAAI,CACf,QAAQ,CAAC,gBAAgB,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAC3B,CAAC;AACrB,CAAC;AAED,SAAS,eAAe,CACtB,OAAsB,EACtB,EACE,eAAe,GAGhB
|
|
1
|
+
{"version":3,"file":"useTOCHighlight.js","sourceRoot":"","sources":["../../src/utils/useTOCHighlight.ts"],"names":[],"mappings":"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"}
|
|
@@ -5,7 +5,6 @@
|
|
|
5
5
|
* LICENSE file in the root directory of this source tree.
|
|
6
6
|
*/
|
|
7
7
|
import type { PrismTheme } from 'prism-react-renderer';
|
|
8
|
-
import type { CSSProperties } from 'react';
|
|
9
8
|
import type { DeepPartial } from 'utility-types';
|
|
10
9
|
export declare type DocsVersionPersistence = 'localStorage' | 'none';
|
|
11
10
|
export declare type NavbarItem = {
|
|
@@ -34,12 +33,6 @@ export declare type ColorModeConfig = {
|
|
|
34
33
|
defaultMode: 'light' | 'dark';
|
|
35
34
|
disableSwitch: boolean;
|
|
36
35
|
respectPrefersColorScheme: boolean;
|
|
37
|
-
switchConfig: {
|
|
38
|
-
darkIcon: string;
|
|
39
|
-
darkIconStyle: CSSProperties;
|
|
40
|
-
lightIcon: string;
|
|
41
|
-
lightIconStyle: CSSProperties;
|
|
42
|
-
};
|
|
43
36
|
};
|
|
44
37
|
export declare type AnnouncementBarConfig = {
|
|
45
38
|
id: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"useThemeConfig.d.ts","sourceRoot":"","sources":["../../src/utils/useThemeConfig.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAC,
|
|
1
|
+
{"version":3,"file":"useThemeConfig.d.ts","sourceRoot":"","sources":["../../src/utils/useThemeConfig.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"useThemeConfig.js","sourceRoot":"","sources":["../../src/utils/useThemeConfig.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,oBAAoB,MAAM,kCAAkC,CAAC;
|
|
1
|
+
{"version":3,"file":"useThemeConfig.js","sourceRoot":"","sources":["../../src/utils/useThemeConfig.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,oBAAoB,MAAM,kCAAkC,CAAC;AAwHpE,MAAM,UAAU,cAAc;IAC5B,OAAO,oBAAoB,EAAE,CAAC,UAAU,CAAC,WAA0B,CAAC;AACtE,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@docusaurus/theme-common",
|
|
3
|
-
"version": "2.0.0-beta.
|
|
3
|
+
"version": "2.0.0-beta.17",
|
|
4
4
|
"description": "Common code for Docusaurus themes.",
|
|
5
5
|
"main": "./lib/index.js",
|
|
6
6
|
"types": "./lib/index.d.ts",
|
|
@@ -18,10 +18,10 @@
|
|
|
18
18
|
},
|
|
19
19
|
"license": "MIT",
|
|
20
20
|
"dependencies": {
|
|
21
|
-
"@docusaurus/module-type-aliases": "2.0.0-beta.
|
|
22
|
-
"@docusaurus/plugin-content-blog": "2.0.0-beta.
|
|
23
|
-
"@docusaurus/plugin-content-docs": "2.0.0-beta.
|
|
24
|
-
"@docusaurus/plugin-content-pages": "2.0.0-beta.
|
|
21
|
+
"@docusaurus/module-type-aliases": "2.0.0-beta.17",
|
|
22
|
+
"@docusaurus/plugin-content-blog": "2.0.0-beta.17",
|
|
23
|
+
"@docusaurus/plugin-content-docs": "2.0.0-beta.17",
|
|
24
|
+
"@docusaurus/plugin-content-pages": "2.0.0-beta.17",
|
|
25
25
|
"clsx": "^1.1.1",
|
|
26
26
|
"parse-numeric-range": "^1.3.0",
|
|
27
27
|
"prism-react-renderer": "^1.3.1",
|
|
@@ -29,8 +29,8 @@
|
|
|
29
29
|
"utility-types": "^3.10.0"
|
|
30
30
|
},
|
|
31
31
|
"devDependencies": {
|
|
32
|
-
"@docusaurus/core": "2.0.0-beta.
|
|
33
|
-
"@docusaurus/types": "2.0.0-beta.
|
|
32
|
+
"@docusaurus/core": "2.0.0-beta.17",
|
|
33
|
+
"@docusaurus/types": "2.0.0-beta.17",
|
|
34
34
|
"@testing-library/react-hooks": "^7.0.2",
|
|
35
35
|
"fs-extra": "^10.0.1",
|
|
36
36
|
"lodash": "^4.17.21"
|
|
@@ -42,5 +42,5 @@
|
|
|
42
42
|
"engines": {
|
|
43
43
|
"node": ">=14"
|
|
44
44
|
},
|
|
45
|
-
"gitHead": "
|
|
45
|
+
"gitHead": "0032c0b0480083227af2e1b4da2d3ee6ce992403"
|
|
46
46
|
}
|
package/src/index.ts
CHANGED
|
@@ -16,6 +16,7 @@ import React, {
|
|
|
16
16
|
} from 'react';
|
|
17
17
|
import useIsBrowser from '@docusaurus/useIsBrowser';
|
|
18
18
|
import {createStorageSlot} from './storageUtils';
|
|
19
|
+
import {ReactContextError} from './reactUtils';
|
|
19
20
|
import {useThemeConfig} from './useThemeConfig';
|
|
20
21
|
|
|
21
22
|
export const AnnouncementBarDismissStorageKey =
|
|
@@ -110,12 +111,10 @@ export function AnnouncementBarProvider({
|
|
|
110
111
|
);
|
|
111
112
|
}
|
|
112
113
|
|
|
113
|
-
export
|
|
114
|
+
export function useAnnouncementBar(): AnnouncementBarAPI {
|
|
114
115
|
const api = useContext(AnnouncementBarContext);
|
|
115
116
|
if (!api) {
|
|
116
|
-
throw new
|
|
117
|
-
'useAnnouncementBar(): AnnouncementBar not found in React context: make sure to use the AnnouncementBarProvider on top of the tree',
|
|
118
|
-
);
|
|
117
|
+
throw new ReactContextError('AnnouncementBarProvider');
|
|
119
118
|
}
|
|
120
119
|
return api;
|
|
121
|
-
}
|
|
120
|
+
}
|
|
@@ -5,14 +5,15 @@
|
|
|
5
5
|
* LICENSE file in the root directory of this source tree.
|
|
6
6
|
*/
|
|
7
7
|
|
|
8
|
-
import type {ReactNode} from 'react';
|
|
9
8
|
import React, {
|
|
10
9
|
useState,
|
|
11
10
|
useCallback,
|
|
12
11
|
useEffect,
|
|
13
12
|
useContext,
|
|
14
13
|
useMemo,
|
|
14
|
+
type ReactNode,
|
|
15
15
|
} from 'react';
|
|
16
|
+
import {ReactContextError} from './reactUtils';
|
|
16
17
|
|
|
17
18
|
import ExecutionEnvironment from '@docusaurus/ExecutionEnvironment';
|
|
18
19
|
import {createStorageSlot} from './storageUtils';
|
|
@@ -148,8 +149,9 @@ export function useColorMode(): ColorModeContextValue {
|
|
|
148
149
|
ColorModeContext,
|
|
149
150
|
);
|
|
150
151
|
if (context == null) {
|
|
151
|
-
throw new
|
|
152
|
-
'
|
|
152
|
+
throw new ReactContextError(
|
|
153
|
+
'ColorModeProvider',
|
|
154
|
+
'Please see https://docusaurus.io/docs/api/themes/configuration#use-color-mode.',
|
|
153
155
|
);
|
|
154
156
|
}
|
|
155
157
|
return context;
|
|
@@ -6,6 +6,7 @@
|
|
|
6
6
|
*/
|
|
7
7
|
|
|
8
8
|
import React, {type ReactNode, useMemo, useState, useContext} from 'react';
|
|
9
|
+
import {ReactContextError} from './reactUtils';
|
|
9
10
|
|
|
10
11
|
const EmptyContext: unique symbol = Symbol('EmptyContext');
|
|
11
12
|
const Context = React.createContext<
|
|
@@ -33,9 +34,7 @@ export function DocSidebarItemsExpandedStateProvider({
|
|
|
33
34
|
export function useDocSidebarItemsExpandedState(): DocSidebarItemsExpandedState {
|
|
34
35
|
const contextValue = useContext(Context);
|
|
35
36
|
if (contextValue === EmptyContext) {
|
|
36
|
-
throw new
|
|
37
|
-
'This hook requires usage of <DocSidebarItemsExpandedStateProvider>',
|
|
38
|
-
);
|
|
37
|
+
throw new ReactContextError('DocSidebarItemsExpandedStateProvider');
|
|
39
38
|
}
|
|
40
39
|
return contextValue;
|
|
41
40
|
}
|
|
@@ -15,6 +15,7 @@ import React, {
|
|
|
15
15
|
} from 'react';
|
|
16
16
|
import {useThemeConfig, type DocsVersionPersistence} from '../useThemeConfig';
|
|
17
17
|
import {isDocsPluginEnabled} from '../docsUtils';
|
|
18
|
+
import {ReactContextError} from '../reactUtils';
|
|
18
19
|
|
|
19
20
|
import {
|
|
20
21
|
useAllDocsData,
|
|
@@ -159,9 +160,7 @@ function DocsPreferredVersionContextProviderUnsafe({
|
|
|
159
160
|
export function useDocsPreferredVersionContext(): DocsPreferredVersionContextValue {
|
|
160
161
|
const value = useContext(Context);
|
|
161
162
|
if (!value) {
|
|
162
|
-
throw new
|
|
163
|
-
'Can\'t find docs preferred context, maybe you forgot to use the "DocsPreferredVersionContextProvider"?',
|
|
164
|
-
);
|
|
163
|
+
throw new ReactContextError('DocsPreferredVersionContextProvider');
|
|
165
164
|
}
|
|
166
165
|
return value;
|
|
167
166
|
}
|
package/src/utils/docsUtils.tsx
CHANGED
|
@@ -19,6 +19,7 @@ import type {
|
|
|
19
19
|
PropSidebarBreadcrumbsItem,
|
|
20
20
|
} from '@docusaurus/plugin-content-docs';
|
|
21
21
|
import {isSamePath} from './pathUtils';
|
|
22
|
+
import {ReactContextError} from './reactUtils';
|
|
22
23
|
import {useLocation} from '@docusaurus/router';
|
|
23
24
|
|
|
24
25
|
// TODO not ideal, see also "useDocs"
|
|
@@ -49,7 +50,7 @@ export function DocsVersionProvider({
|
|
|
49
50
|
export function useDocsVersion(): PropVersionMetadata {
|
|
50
51
|
const version = useContext(DocsVersionContext);
|
|
51
52
|
if (version === EmptyContextValue) {
|
|
52
|
-
throw new
|
|
53
|
+
throw new ReactContextError('DocsVersionProvider');
|
|
53
54
|
}
|
|
54
55
|
return version;
|
|
55
56
|
}
|
|
@@ -89,7 +90,7 @@ export function DocsSidebarProvider({
|
|
|
89
90
|
export function useDocsSidebar(): PropSidebar | null {
|
|
90
91
|
const sidebar = useContext(DocsSidebarContext);
|
|
91
92
|
if (sidebar === EmptyContextValue) {
|
|
92
|
-
throw new
|
|
93
|
+
throw new ReactContextError('DocsSidebarProvider');
|
|
93
94
|
}
|
|
94
95
|
return sidebar;
|
|
95
96
|
}
|
|
@@ -14,6 +14,7 @@ import React, {
|
|
|
14
14
|
type ComponentType,
|
|
15
15
|
useMemo,
|
|
16
16
|
} from 'react';
|
|
17
|
+
import {ReactContextError} from './reactUtils';
|
|
17
18
|
|
|
18
19
|
/*
|
|
19
20
|
The idea behind all this is that a specific component must be able to fill a
|
|
@@ -60,9 +61,7 @@ export function MobileSecondaryMenuProvider({
|
|
|
60
61
|
function useMobileSecondaryMenuContext(): ContextValue {
|
|
61
62
|
const value = useContext(Context);
|
|
62
63
|
if (value === null) {
|
|
63
|
-
throw new
|
|
64
|
-
'MobileSecondaryMenuProvider was not used correctly, context value is null',
|
|
65
|
-
);
|
|
64
|
+
throw new ReactContextError('MobileSecondaryMenuProvider');
|
|
66
65
|
}
|
|
67
66
|
return value;
|
|
68
67
|
}
|
package/src/utils/reactUtils.tsx
CHANGED
|
@@ -41,3 +41,13 @@ export function useDynamicCallback<T extends (...args: never[]) => unknown>(
|
|
|
41
41
|
// but good enough for our use
|
|
42
42
|
return useCallback<T>((...args) => ref.current(...args), []);
|
|
43
43
|
}
|
|
44
|
+
|
|
45
|
+
export class ReactContextError extends Error {
|
|
46
|
+
constructor(providerName: string, additionalInfo?: string) {
|
|
47
|
+
super();
|
|
48
|
+
this.name = 'ReactContextError';
|
|
49
|
+
this.message = `Hook ${
|
|
50
|
+
this.stack?.split('\n')[1]?.match(/at (?<name>\w+)/)?.groups!.name
|
|
51
|
+
} is called outside the <${providerName}>. ${additionalInfo || ''}`;
|
|
52
|
+
}
|
|
53
|
+
}
|
package/src/utils/routesUtils.ts
CHANGED
|
@@ -7,33 +7,50 @@
|
|
|
7
7
|
|
|
8
8
|
import GeneratedRoutes, {type Route} from '@generated/routes';
|
|
9
9
|
import {useMemo} from 'react';
|
|
10
|
-
|
|
11
|
-
function isHomePageRoute(route: Route): boolean {
|
|
12
|
-
return route.path === '/' && route.exact === true;
|
|
13
|
-
}
|
|
14
|
-
|
|
15
|
-
function isHomeParentRoute(route: Route): boolean {
|
|
16
|
-
return route.path === '/' && route.exact === false;
|
|
17
|
-
}
|
|
10
|
+
import useDocusaurusContext from '@docusaurus/useDocusaurusContext';
|
|
18
11
|
|
|
19
12
|
// Note that all sites don't always have a homepage in practice
|
|
20
13
|
// See https://github.com/facebook/docusaurus/pull/6517#issuecomment-1048709116
|
|
21
|
-
export function findHomePageRoute(
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
14
|
+
export function findHomePageRoute({
|
|
15
|
+
baseUrl,
|
|
16
|
+
routes: initialRoutes,
|
|
17
|
+
}: {
|
|
18
|
+
routes: Route[];
|
|
19
|
+
baseUrl: string;
|
|
20
|
+
}): Route | undefined {
|
|
21
|
+
function isHomePageRoute(route: Route): boolean {
|
|
22
|
+
return route.path === baseUrl && route.exact === true;
|
|
26
23
|
}
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
return
|
|
24
|
+
|
|
25
|
+
function isHomeParentRoute(route: Route): boolean {
|
|
26
|
+
return route.path === baseUrl && !route.exact;
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
function doFindHomePageRoute(routes: Route[]): Route | undefined {
|
|
30
|
+
if (routes.length === 0) {
|
|
31
|
+
return undefined;
|
|
32
|
+
}
|
|
33
|
+
const homePage = routes.find(isHomePageRoute);
|
|
34
|
+
if (homePage) {
|
|
35
|
+
return homePage;
|
|
36
|
+
}
|
|
37
|
+
const indexSubRoutes = routes
|
|
38
|
+
.filter(isHomeParentRoute)
|
|
39
|
+
.flatMap((route) => route.routes ?? []);
|
|
40
|
+
return doFindHomePageRoute(indexSubRoutes);
|
|
30
41
|
}
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
.flatMap((route) => route.routes ?? []);
|
|
34
|
-
return findHomePageRoute(indexSubRoutes);
|
|
42
|
+
|
|
43
|
+
return doFindHomePageRoute(initialRoutes);
|
|
35
44
|
}
|
|
36
45
|
|
|
37
46
|
export function useHomePageRoute(): Route | undefined {
|
|
38
|
-
|
|
47
|
+
const {baseUrl} = useDocusaurusContext().siteConfig;
|
|
48
|
+
return useMemo(
|
|
49
|
+
() =>
|
|
50
|
+
findHomePageRoute({
|
|
51
|
+
routes: GeneratedRoutes,
|
|
52
|
+
baseUrl,
|
|
53
|
+
}),
|
|
54
|
+
[baseUrl],
|
|
55
|
+
);
|
|
39
56
|
}
|
|
@@ -15,7 +15,7 @@ import React, {
|
|
|
15
15
|
useMemo,
|
|
16
16
|
useRef,
|
|
17
17
|
} from 'react';
|
|
18
|
-
import {useDynamicCallback} from './reactUtils';
|
|
18
|
+
import {useDynamicCallback, ReactContextError} from './reactUtils';
|
|
19
19
|
import ExecutionEnvironment from '@docusaurus/ExecutionEnvironment';
|
|
20
20
|
|
|
21
21
|
/**
|
|
@@ -76,9 +76,7 @@ export function ScrollControllerProvider({
|
|
|
76
76
|
export function useScrollController(): ScrollController {
|
|
77
77
|
const context = useContext(ScrollMonitorContext);
|
|
78
78
|
if (context == null) {
|
|
79
|
-
throw new
|
|
80
|
-
'"useScrollController" is used but no context provider was found in the React tree.',
|
|
81
|
-
);
|
|
79
|
+
throw new ReactContextError('ScrollControllerProvider');
|
|
82
80
|
}
|
|
83
81
|
return context;
|
|
84
82
|
}
|