@brillout/docpress 0.7.10 → 0.8.0

package/dist/config/resolvePageContext.d.ts

@@ -10,24 +10,22 @@ type Exports = {
 type PageContextOriginal = PageContextServer;
 type PageContextResolved = ReturnType<typeof resolvePageContext>;
 declare function resolvePageContext(pageContext: PageContextOriginal): {
-    navigationData: {
-        navItems: import("../navigation/Navigation").NavItem[];
-        navItemsAll: import("../navigation/Navigation").NavItem[];
-        currentUrl: string;
-        isDetachedPage: boolean;
-    };
+    isDetachedPage: boolean;
+    navItems: import("../navigation/Navigation").NavItem[];
+    navItemsAll: import("../navigation/Navigation").NavItemAll[];
     linksAll: import("../components").LinkData[];
     isLandingPage: boolean;
     pageTitle: string | null;
     documentTitle: string;
-    noSideNavigation: (true | "no-logo") | undefined;
     topNavigationList: {
         title: string;
         url: string | null | undefined;
     }[];
+    columnLayouts: number[][];
 } & {
     urlPathname: string;
     meta: {
+        projectName: string;
         faviconUrl: string;
         twitterHandle: string;
         bannerUrl: string | undefined;

package/dist/config/resolvePageContext.js

@@ -6,10 +6,11 @@ function resolvePageContext(pageContext) {
     var pageContextResolved = {};
     objectAssign(pageContextResolved, resolveHeadingsData(pageContext));
     var config = getConfig();
-    var faviconUrl = config.faviconUrl, algolia = config.algolia, tagline = config.tagline, twitterHandle = config.twitterHandle, bannerUrl = config.bannerUrl, websiteUrl = config.websiteUrl, topNavigationStyle = config.topNavigationStyle;
+    var faviconUrl = config.faviconUrl, algolia = config.algolia, tagline = config.tagline, twitterHandle = config.twitterHandle, bannerUrl = config.bannerUrl, websiteUrl = config.websiteUrl, topNavigationStyle = config.topNavigationStyle, projectName = config.projectInfo.projectName;
     objectAssign(pageContextResolved, {
         urlPathname: pageContext.urlPathname, // TODO: remove
         meta: {
+            projectName: projectName,
             faviconUrl: faviconUrl,
             twitterHandle: twitterHandle,
             bannerUrl: bannerUrl,

package/dist/navigation/Navigation.d.ts

@@ -1,26 +1,21 @@
-export { Navigation };
-export { NavigationMask };
-export type { NavigationData };
+export { NavigationContent };
 export type { NavItem };
-export { groupByLevelMin };
-export type { NavItemGrouped };
+export type { NavItemAll };
 import React from 'react';
 import './Navigation.css';
-type NavigationData = Parameters<typeof Navigation>[0];
-declare function Navigation({ navItems, navItemsAll, currentUrl, isDetachedPage, }: {
-    navItems: NavItem[];
-    navItemsAll: NavItem[];
-    currentUrl: string;
-    isDetachedPage: boolean;
-}): React.JSX.Element;
-declare function NavigationMask(): React.JSX.Element;
+import '@docsearch/css';
 type NavItem = {
     level: number;
     url?: string | null;
     title: string;
     titleInNav: string;
+    menuModalFullWidth?: true;
+};
+type NavItemAll = NavItem & {
+    columnLayoutElement?: true;
 };
-type NavItemGrouped = ReturnType<typeof groupByLevelMin>[number];
-declare function groupByLevelMin<T extends NavItem>(navItems: T[]): (T & {
-    navItemChilds: T[];
-})[];
+declare function NavigationContent(props: {
+    navItems: NavItem[];
+    showOnlyRelevant?: true;
+    columnLayout?: true;
+}): React.JSX.Element;

package/dist/navigation/Navigation.js

@@ -9,39 +9,47 @@ var __assign = (this && this.__assign) || function () {
     };
     return __assign.apply(this, arguments);
 };
-export { Navigation };
-export { NavigationMask };
-// TODO/refactor: do this only on the server side?
-export { groupByLevelMin };
+// TODO/refactor: rename file and/or component
+export { NavigationContent };
 import React from 'react';
-import { NavigationHeader } from './NavigationHeader';
-import { assert, Emoji, assertWarning, jsxToTextContent } from '../utils/server';
+import { assert, assertWarning, jsxToTextContent } from '../utils/server';
 import './Navigation.css';
-import { NavigationFullscreenClose } from './navigation-fullscreen/NavigationFullscreenButton';
 import { parseTitle } from '../parseTitle';
-import { autoScrollNav_SSR } from '../autoScrollNav';
-function Navigation(_a) {
-    var navItems = _a.navItems, navItemsAll = _a.navItemsAll, currentUrl = _a.currentUrl, isDetachedPage = _a.isDetachedPage;
-    return (React.createElement(React.Fragment, null,
-        React.createElement("div", { id: "navigation-container" },
-            React.createElement(NavigationHeader, null),
-            React.createElement("div", { id: "navigation-body" },
-                isDetachedPage && (React.createElement(React.Fragment, null,
-                    navItems.length > 1 && (React.createElement(NavigationContent, { id: "navigation-content-detached", navItems: navItems, currentUrl: currentUrl })),
-                    React.createElement(DetachedPageNote, null))),
-                React.createElement(NavigationContent, { id: "navigation-content-main", navItems: navItemsAll, currentUrl: currentUrl }),
-                React.createElement(NavigationFullscreenClose, null))),
-        React.createElement("script", { dangerouslySetInnerHTML: { __html: autoScrollNav_SSR } })));
-}
-function NavigationMask() {
-    return React.createElement("div", { id: "mobile-navigation-mask" });
-}
+import { usePageContext } from '../renderer/usePageContext';
+import '@docsearch/css';
 function NavigationContent(props) {
-    var navItemsWithComputed = addComputedProps(props.navItems, props.currentUrl);
-    var navItemsGrouped = groupByLevelMin(navItemsWithComputed);
-    return (React.createElement("div", { id: props.id, className: "navigation-content" }, navItemsGrouped.map(function (navItemGroup, i) { return (React.createElement("div", { className: "nav-items-group", key: i },
-        React.createElement(NavItemComponent, { navItem: navItemGroup }),
-        navItemGroup.navItemChilds.map(function (navItem, j) { return (React.createElement(NavItemComponent, { navItem: navItem, key: j })); }))); })));
+    var pageContext = usePageContext();
+    var navItemsWithComputed = getNavItemsWithComputed(props.navItems, pageContext.urlPathname);
+    var navContent;
+    if (!props.columnLayout) {
+        navContent = navItemsWithComputed
+            .filter(function (navItemGroup) { return !props.showOnlyRelevant || navItemGroup.isRelevant; })
+            .map(function (navItem, i) { return React.createElement(NavItemComponent, { navItem: navItem, key: i }); });
+    }
+    else {
+        assert(!props.showOnlyRelevant);
+        var navItemsColumnLayout = groupByColumnLayout(navItemsWithComputed);
+        var paddingBottom_1 = 40;
+        navContent = (React.createElement(React.Fragment, null, navItemsColumnLayout.map(function (_a, i) {
+            var navItemsColumnEntries = _a.navItemsColumnEntries, isFullWidth = _a.isFullWidth;
+            return (React.createElement("div", { key: i, style: {
+                    display: 'flex',
+                    justifyContent: 'center',
+                } },
+                React.createElement("div", { className: "column-layout-".concat(i), style: {
+                        flexGrow: 1,
+                        columnGap: 20,
+                        paddingBottom: isFullWidth ? paddingBottom_1 : undefined,
+                    } }, navItemsColumnEntries.map(function (navItemColumnEntry, j) { return (React.createElement("div", { key: j, className: "column-layout-entry", style: {
+                        breakInside: 'avoid',
+                        paddingBottom: !isFullWidth ? paddingBottom_1 : undefined,
+                        width: '100%',
+                    } },
+                    React.createElement(NavItemComponent, { navItem: navItemColumnEntry }),
+                    navItemColumnEntry.navItemChilds.map(function (navItem, k) { return (React.createElement(NavItemComponent, { navItem: navItem, key: k })); }))); }))));
+        })));
+    }
+    return (React.createElement("div", { className: "navigation-content", style: { marginTop: 10 } }, navContent));
 }
 function NavItemComponent(_a) {
     var _b;
@@ -66,72 +74,72 @@ function NavItemComponent(_a) {
             'nav-item',
             'nav-item-level-' + navItem.level,
             navItem.url && navItem.isActive && ' is-active',
-            navItem.url && navItem.isActiveFirst && ' is-active-first',
-            navItem.url && navItem.isActiveLast && ' is-active-last',
             navItem.isFirstOfItsKind && 'nav-item-first-of-its-kind',
             navItem.isLastOfItsKind && 'nav-item-last-of-its-kind',
         ]
             .filter(Boolean)
             .join(' '), href: (_b = navItem.url) !== null && _b !== void 0 ? _b : undefined }, titleInNavJsx));
 }
-function groupByLevelMin(navItems) {
-    var navItemsGrouped = [];
-    var levelMin = Math.min.apply(Math, navItems.map(function (h) { return h.level; }));
+function groupByColumnLayout(navItems) {
+    var navItemsColumnLayout = [];
+    var navItemsColumnEntries = [];
+    var isFullWidth;
     navItems.forEach(function (navItem) {
-        if (navItem.level === levelMin) {
-            navItemsGrouped.push(__assign(__assign({}, navItem), { navItemChilds: [] }));
+        if (navItem.level === 1) {
+            var isFullWidthPrevious = isFullWidth;
+            isFullWidth = !!navItem.menuModalFullWidth;
+            if (isFullWidthPrevious !== undefined && isFullWidthPrevious !== isFullWidth) {
+                navItemsColumnLayout.push({ navItemsColumnEntries: navItemsColumnEntries, isFullWidth: isFullWidthPrevious });
+                navItemsColumnEntries = [];
+            }
+        }
+        assert(isFullWidth !== undefined);
+        if (navItem.columnLayoutElement) {
+            assert(navItem.level === 1 || navItem.level === 4);
+            var navItemColumnEntry = __assign(__assign({}, navItem), { navItemChilds: [] });
+            navItemsColumnEntries.push(navItemColumnEntry);
         }
         else {
-            navItemsGrouped[navItemsGrouped.length - 1].navItemChilds.push(navItem);
+            assert(navItem.level !== 1);
+            navItemsColumnEntries[navItemsColumnEntries.length - 1].navItemChilds.push(navItem);
         }
     });
-    return navItemsGrouped;
+    assert(isFullWidth !== undefined);
+    navItemsColumnLayout.push({ navItemsColumnEntries: navItemsColumnEntries, isFullWidth: isFullWidth });
+    return navItemsColumnLayout;
 }
-function addComputedProps(navItems, currentUrl) {
-    return navItems.map(function (navItem, i) {
+function getNavItemsWithComputed(navItems, currentUrl) {
+    var navItemIdx;
+    var navItemsWithComputed = navItems.map(function (navItem, i) {
         assert([1, 2, 3, 4].includes(navItem.level), navItem);
         var navItemPrevious = navItems[i - 1];
         var navItemNext = navItems[i + 1];
-        var isActiveFirst = false;
-        var isActiveLast = false;
         var isActive = false;
         if (navItem.url === currentUrl) {
             assert(navItem.level === 2, { currentUrl: currentUrl });
+            assert(navItemIdx === undefined);
+            navItemIdx = i;
             isActive = true;
-            isActiveFirst = true;
-            if ((navItemNext === null || navItemNext === void 0 ? void 0 : navItemNext.level) !== 3) {
-                isActiveLast = true;
-            }
-        }
-        if (navItem.level === 3) {
-            isActive = true;
-            if ((navItemNext === null || navItemNext === void 0 ? void 0 : navItemNext.level) !== 3) {
-                isActiveLast = true;
-            }
         }
         var isFirstOfItsKind = navItem.level !== (navItemPrevious === null || navItemPrevious === void 0 ? void 0 : navItemPrevious.level);
         var isLastOfItsKind = navItem.level !== (navItemNext === null || navItemNext === void 0 ? void 0 : navItemNext.level);
-        return __assign(__assign({}, navItem), { isActive: isActive, isActiveFirst: isActiveFirst, isActiveLast: isActiveLast, isFirstOfItsKind: isFirstOfItsKind, isLastOfItsKind: isLastOfItsKind });
+        var navItemComputed = __assign(__assign({}, navItem), { isActive: isActive, isRelevant: false, isFirstOfItsKind: isFirstOfItsKind, isLastOfItsKind: isLastOfItsKind });
+        return navItemComputed;
     });
-}
-function DetachedPageNote() {
-    return (React.createElement("div", { id: "detached-note", style: {
-            backgroundColor: 'var(--background-color)',
-            textAlign: 'left',
-            marginLeft: 10,
-            marginRight: 10,
-            marginTop: 25,
-            marginBottom: -5,
-            borderRadius: 5,
-            padding: 10,
-        } },
-        React.createElement(Emoji, { name: "info" }),
-        ' ',
-        React.createElement("b", null,
-            React.createElement("em", null, "Detached")),
-        React.createElement("span", { style: {
-                opacity: 0.8,
-            } },
-            ' ',
-            "\u2014 this page isn't listed in the navigation below.")));
+    // Set `isRelevant`
+    if (navItemIdx !== undefined) {
+        for (var i = navItemIdx; i >= 0; i--) {
+            var navItem = navItemsWithComputed[i];
+            navItem.isRelevant = true;
+            if (navItem.level === 1)
+                break;
+        }
+        for (var i = navItemIdx; i < navItemsWithComputed.length; i++) {
+            var navItem = navItemsWithComputed[i];
+            if (navItem.level === 1)
+                break;
+            navItem.isRelevant = true;
+        }
+    }
+    return navItemsWithComputed;
 }

package/dist/renderer/getStyleColumnLayout.d.ts

@@ -0,0 +1,7 @@
+export { getStyleColumnLayout };
+export { determineColumnLayoutEntries };
+import { type NavItemAll } from '../navigation/Navigation';
+declare function determineColumnLayoutEntries(navItems: NavItemAll[]): {
+    columnLayouts: number[][];
+};
+declare function getStyleColumnLayout(columnLayouts: number[][]): string;

package/dist/renderer/getStyleColumnLayout.js

@@ -0,0 +1,174 @@
+var __makeTemplateObject = (this && this.__makeTemplateObject) || function (cooked, raw) {
+    if (Object.defineProperty) { Object.defineProperty(cooked, "raw", { value: raw }); } else { cooked.raw = raw; }
+    return cooked;
+};
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+export { getStyleColumnLayout };
+export { determineColumnLayoutEntries };
+import { css } from '../utils/css';
+import { assert, isBrowser } from '../utils/server';
+assert(!isBrowser());
+var columnWidthMin = 300;
+var columnWidthMax = 350;
+function determineColumnLayoutEntries(navItems) {
+    var navItemsWithLength = navItems.map(function (navItem) { return (__assign(__assign({}, navItem), { numberOfHeadings: navItem.level === 1 || navItem.level === 4 ? 0 : null })); });
+    var navItemLevel1;
+    var navItemLevel4;
+    navItemsWithLength.forEach(function (navItem) {
+        if (navItem.level === 1) {
+            navItemLevel1 = navItem;
+            navItemLevel4 = undefined;
+            return;
+        }
+        if (navItem.level === 4) {
+            navItemLevel4 = navItem;
+            return;
+        }
+        var bumpNavItemLength = function (navItem) {
+            assert(navItem.numberOfHeadings !== null);
+            navItem.numberOfHeadings++;
+        };
+        assert(navItemLevel1);
+        bumpNavItemLength(navItemLevel1);
+        if (navItemLevel4) {
+            bumpNavItemLength(navItemLevel4);
+        }
+    });
+    var columnLayouts = [];
+    var columns = [];
+    var isFullWidth;
+    navItemsWithLength.forEach(function (navItem, i) {
+        var isFullWidthBegin = false;
+        if (navItem.level === 1) {
+            var isFullWidthPrevious = isFullWidth;
+            isFullWidth = !!navItem.menuModalFullWidth;
+            if (isFullWidth)
+                isFullWidthBegin = true;
+            if (isFullWidthPrevious !== undefined && isFullWidthPrevious !== isFullWidth) {
+                columnLayouts.push(columns);
+                columns = [];
+            }
+        }
+        if (!isFullWidth
+            ? navItem.level === 1
+            : (navItem.level === 4 && navItemsWithLength[i - 1].level !== 1) || isFullWidthBegin) {
+            if (isFullWidth) {
+                assert(navItem.level === 4 || (navItem.level === 1 && isFullWidthBegin));
+            }
+            else {
+                assert(navItem.level === 1);
+            }
+            assert(navItem.numberOfHeadings !== null);
+            columns.push(navItem.numberOfHeadings);
+            navItems[i].columnLayoutElement = true;
+        }
+    });
+    columnLayouts.push(columns);
+    return { columnLayouts: columnLayouts };
+}
+function getStyleColumnLayout(columnLayouts) {
+    var style = '\n';
+    columnLayouts.forEach(function (columns, i) {
+        var _loop_1 = function (numberOfColumns) {
+            var styleGivenNumberOfColumns = [];
+            styleGivenNumberOfColumns.push(css(templateObject_1 || (templateObject_1 = __makeTemplateObject(["\n.column-layout-", " {\n  column-count: ", ";\n  max-width: min(100%, ", "px);\n}\n"], ["\n.column-layout-", " {\n  column-count: ", ";\n  max-width: min(100%, ", "px);\n}\n"])), i, numberOfColumns, columnWidthMax * numberOfColumns));
+            var columnsIdMap = determineColumns(columns, numberOfColumns);
+            var columnBreakPoints = determineColumnBreakPoints(columnsIdMap);
+            columnBreakPoints.forEach(function (columnBreakPoint, columnUngroupedId) {
+                styleGivenNumberOfColumns.push(css(templateObject_2 || (templateObject_2 = __makeTemplateObject(["\n.column-layout-", " .column-layout-entry:nth-child(", ") {\n  break-before: ", ";\n}\n"], ["\n.column-layout-", " .column-layout-entry:nth-child(", ") {\n  break-before: ", ";\n}\n"])), i, columnUngroupedId + 1, columnBreakPoint ? 'column' : 'avoid'));
+            });
+            var noContainerQuery = numberOfColumns === columns.length;
+            if (!noContainerQuery) {
+                var maxWidth = (numberOfColumns + 1) * columnWidthMin - 1;
+                styleGivenNumberOfColumns = __spreadArray(__spreadArray([
+                    //
+                    "@container(max-width: ".concat(maxWidth, "px) {")
+                ], styleGivenNumberOfColumns, true), [
+                    "}",
+                ], false);
+            }
+            style += styleGivenNumberOfColumns.join('\n') + '\n';
+        };
+        for (var numberOfColumns = columns.length; numberOfColumns >= 1; numberOfColumns--) {
+            _loop_1(numberOfColumns);
+        }
+    });
+    return style;
+}
+function determineColumnBreakPoints(columnsIdMap) {
+    assert(columnsIdMap[0] === 0);
+    var columnGroupedIdBefore = -1;
+    var columnBreakPoints = columnsIdMap.map(function (columnGroupedId) {
+        assert([
+            //
+            columnGroupedIdBefore,
+            columnGroupedIdBefore + 1,
+        ].includes(columnGroupedId));
+        var val = columnGroupedId !== columnGroupedIdBefore;
+        columnGroupedIdBefore = columnGroupedId;
+        return val;
+    });
+    return columnBreakPoints;
+}
+function determineColumns(columnsUnmerged, numberOfColumns) {
+    assert(numberOfColumns <= columnsUnmerged.length);
+    var columnsMergingInit = columnsUnmerged.map(function (columnHeight, i) { return ({
+        columnIdsMerged: [i],
+        heightTotal: columnHeight,
+    }); });
+    var columnsMerged = mergeColumns(columnsMergingInit, numberOfColumns);
+    var columnsIdMap = new Array(columnsUnmerged.length);
+    assert(columnsMerged.length === numberOfColumns);
+    columnsMerged.forEach(function (columnMerged, columnMergedId) {
+        columnMerged.columnIdsMerged.forEach(function (columnId) {
+            columnsIdMap[columnId] = columnMergedId;
+        });
+    });
+    assert(columnsIdMap.length === columnsUnmerged.length);
+    return columnsIdMap;
+}
+function mergeColumns(columnsMerging, numberOfColumns) {
+    if (columnsMerging.length <= numberOfColumns)
+        return columnsMerging;
+    var mergeCandidate = null;
+    for (var i_1 = 0; i_1 <= columnsMerging.length - 2; i_1++) {
+        var column1 = columnsMerging[i_1 + 0];
+        var column2 = columnsMerging[i_1 + 1];
+        var heightTotal = column1.heightTotal + column2.heightTotal;
+        if (!mergeCandidate || mergeCandidate.heightTotal > heightTotal) {
+            mergeCandidate = {
+                i: i_1,
+                columnIdsMerged: __spreadArray(__spreadArray([], column1.columnIdsMerged, true), column2.columnIdsMerged, true),
+                heightTotal: heightTotal,
+            };
+        }
+    }
+    assert(mergeCandidate);
+    var i = mergeCandidate.i;
+    assert(-1 < i && i < columnsMerging.length - 1);
+    var columnsMergingMod = __spreadArray(__spreadArray(__spreadArray([], columnsMerging.slice(0, i), true), [
+        mergeCandidate
+    ], false), columnsMerging.slice(i + 2), true);
+    assert(columnsMergingMod.length === columnsMerging.length - 1);
+    return mergeColumns(columnsMergingMod, numberOfColumns);
+}
+var templateObject_1, templateObject_2;

package/dist/types/Heading.d.ts

@@ -7,10 +7,10 @@ type HeadingResolved = {
     level: number;
     title: string;
     titleInNav: string;
-    noSideNavigation?: NoSideNavigation;
     topNavigation?: true | string;
     linkBreadcrumb: string[];
     sectionTitles?: string[];
+    menuModalFullWidth?: true;
 } & Tmp;
 type HeadingDetachedResolved = Omit<HeadingResolved, 'level' | 'linkBreadcrumb'> & {
     level: 2;
@@ -19,6 +19,7 @@ type HeadingDetachedResolved = Omit<HeadingResolved, 'level' | 'linkBreadcrumb'>
 type HeadingDefinitionCommon = {
     title: string;
     topNavigation?: true | string;
+    menuModalFullWidth?: true;
 };
 type HeadingDetachedDefinition = HeadingDefinitionCommon & {
     url: string;
@@ -27,13 +28,11 @@ type HeadingDetachedDefinition = HeadingDefinitionCommon & {
 type HeadingDefinition = HeadingDefinitionCommon & {
     url?: null | string;
     titleInNav?: string;
-    noSideNavigation?: NoSideNavigation;
 } & HeadingDefinitionLevel & Tmp;
 type IsCategory = {
     url?: undefined;
     titleDocument?: undefined;
     titleInNav?: undefined;
-    noSideNavigation?: undefined;
 };
 type HeadingDefinitionLevel = ({
     level: 1;
@@ -47,4 +46,3 @@ type HeadingDefinitionLevel = ({
 type Tmp = {
     titleDocument?: string;
 };
-type NoSideNavigation = true | 'no-logo';

package/dist/utils/client.d.ts

@@ -1,2 +1,3 @@
 export * from './assert';
 export * from './isBrowser';
+export * from './getGlobalObject';

package/dist/utils/client.js

@@ -1,2 +1,3 @@
 export * from './assert';
 export * from './isBrowser';
+export * from './getGlobalObject';

package/dist/utils/css.d.ts

@@ -0,0 +1 @@
+export declare function css(strings: TemplateStringsArray | string[], ...values: (string | number)[]): string;

package/dist/utils/css.js

@@ -0,0 +1,27 @@
+export function css(strings) {
+    var values = [];
+    for (var _i = 1; _i < arguments.length; _i++) {
+        values[_i - 1] = arguments[_i];
+    }
+    // The boring part
+    var result = strings
+        .map(function (str, i) {
+        var s = str;
+        if (i !== strings.length - 1) {
+            s += values[i];
+        }
+        return s;
+    })
+        .join('');
+    // Remove comments
+    result = result
+        .split('\n')
+        .filter(function (line) { return !line.startsWith('// '); })
+        .join('\n');
+    // Minifiy
+    result = result
+        .replace(/\s+/g, ' ') // Replace all whitespace sequences with a single space
+        .replace(/\s*([{}:;])\s*/g, '$1') // Remove space around {, }, :, ;
+        .trim(); // Trim any leading/trailing whitespace
+    return result;
+}

package/dist/utils/getGlobalObject.d.ts

@@ -0,0 +1 @@
+export declare function getGlobalObject<T extends Record<string, unknown> = never>(key: `${string}.ts`, defaultValue: T): T;

package/dist/utils/getGlobalObject.js

@@ -0,0 +1,9 @@
+export function getGlobalObject(
+// We use the filename as key; each `getGlobalObject()` call should live inside a file with a unique filename.
+key, defaultValue) {
+    // @ts-ignore
+    var globalObjectsAll = (globalThis[projectKey] = globalThis[projectKey] || {});
+    var globalObject = (globalObjectsAll[key] = globalObjectsAll[key] || defaultValue);
+    return globalObject;
+}
+var projectKey = '_docpress';

package/docsearch/DocSearchInstall.tsx

@@ -0,0 +1,23 @@
+export { DocSearchInstall }
+
+import React from 'react'
+import { usePageContext } from '../renderer/usePageContext'
+import { DocSearch as DocSearchButton } from '@docsearch/react'
+import { Hit } from '../components/Algolia/Hit'
+
+function DocSearchInstall() {
+  const pageContext = usePageContext()
+  const { algolia } = pageContext.meta
+  if (!algolia) return null
+  return (
+    <div style={{ display: 'none' }}>
+      <DocSearchButton
+        appId={algolia.appId}
+        indexName={algolia.indexName}
+        apiKey={algolia.apiKey}
+        insights={true}
+        hitComponent={Hit}
+      />
+    </div>
+  )
+}

package/docsearch/SearchLink.tsx

@@ -0,0 +1,48 @@
+export { SearchLink }
+
+import React from 'react'
+import { openDocsearchModal } from './toggleDocsearchModal'
+
+type PropsDiv = React.HTMLProps<HTMLDivElement>
+function SearchLink(props: PropsDiv) {
+  return (
+    <div
+      {...props}
+      style={{
+        height: '100%',
+        display: 'flex',
+        alignItems: 'center',
+        cursor: 'pointer',
+        ...props.style,
+      }}
+      className="colorize-on-hover"
+      onClick={(ev) => {
+        ev.preventDefault()
+        openDocsearchModal()
+      }}
+      aria-label="Ctrl + K"
+      data-balloon-pos="left"
+      data-balloon-blunt
+      data-balloon-nofocus
+    >
+      <SearchIcon />
+      Search
+    </div>
+  )
+}
+function SearchIcon() {
+  return (
+    <svg
+      style={{ marginRight: 'var(--icon-padding)', lineHeight: 0, width: '1.3em' }}
+      className="decolorize-6"
+      viewBox="0 0 20 20"
+    >
+      <path
+        d="M14.386 14.386l4.0877 4.0877-4.0877-4.0877c-2.9418 2.9419-7.7115 2.9419-10.6533 0-2.9419-2.9418-2.9419-7.7115 0-10.6533 2.9418-2.9419 7.7115-2.9419 10.6533 0 2.9419 2.9418 2.9419 7.7115 0 10.6533z"
+        fill="none"
+        stroke="currentColor"
+        strokeWidth="2"
+      ></path>
+    </svg>
+  )
+}

package/docsearch/toggleDocsearchModal.ts

@@ -0,0 +1,29 @@
+export { closeDocsearchModal }
+export { openDocsearchModal }
+
+import { assert } from '../utils/client'
+
+function closeDocsearchModal() {
+  if (isClosed()) return
+  toggle()
+}
+
+function openDocsearchModal() {
+  if (!isClosed()) return
+  toggle()
+}
+
+// There doesn't seem be an official API to open/close the DocSearch modal:
+// - https://github.com/algolia/docsearch/issues/2321
+// - https://github.com/algolia/docsearch/blob/90f3c6aabbc324fe49e9a1dfe0906fcd4d90f27b/packages/docsearch-react/src/DocSearch.tsx#L52
+function toggle() {
+  // Trigger https://github.com/algolia/docsearch/blob/90f3c6aabbc324fe49e9a1dfe0906fcd4d90f27b/packages/docsearch-react/src/useDocSearchKeyboardEvents.ts#L71
+  window.dispatchEvent(new KeyboardEvent('keydown', { key: 'k', ctrlKey: true }))
+}
+
+function isClosed() {
+  const test1 = !document.body.classList.contains('DocSearch--active')
+  const test2 = document.getElementsByClassName('DocSearch-Modal').length === 0
+  assert(test1 === test2)
+  return test1 || test2
+}