@brillout/docpress 0.9.7 → 0.10.0

package/dist/docsearch/toggleDocsearchModal.js

@@ -1,26 +0,0 @@
-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() {
-    var test1 = !document.body.classList.contains('DocSearch--active');
-    var test2 = document.getElementsByClassName('DocSearch-Modal').length === 0;
-    assert(test1 === test2);
-    return test1 || test2;
-}

package/dist/navigation/Collapsible.d.ts

@@ -1,10 +0,0 @@
-export { Collapsible };
-import React from 'react';
-import './Collapsible.css';
-declare function Collapsible({ head, children, disabled, collapsedInit, marginBottomOnExpand, }: {
-    head: (onClick: () => void) => React.ReactNode;
-    children: React.ReactNode;
-    disabled: boolean;
-    collapsedInit: boolean;
-    marginBottomOnExpand?: number;
-}): React.JSX.Element;

package/dist/navigation/Collapsible.js

@@ -1,35 +0,0 @@
-export { Collapsible };
-import React, { useRef, useState } from 'react';
-import { cls } from '../utils/cls';
-import './Collapsible.css';
-function Collapsible(_a) {
-    var head = _a.head, children = _a.children, _b = _a.disabled, disabled = _b === void 0 ? false : _b, collapsedInit = _a.collapsedInit, marginBottomOnExpand = _a.marginBottomOnExpand;
-    var _c = useState(collapsedInit), collapsed = _c[0], setCollapsed = _c[1];
-    var _d = useState(false), isAnimating = _d[0], setIsAnimating = _d[1];
-    var contentRef = useRef(null);
-    var onClick = function () {
-        if (!disabled) {
-            setIsAnimating(true);
-            if (!collapsed) {
-                // If expanding, set height to current scroll height before animation
-                contentRef.current.style.height = "".concat(contentRef.current.scrollHeight, "px");
-                // Force a reflow
-                contentRef.current.offsetHeight;
-            }
-            setCollapsed(function (prev) { return !prev; });
-        }
-    };
-    var onTransitionEnd = function () {
-        setIsAnimating(false);
-    };
-    var showContent = disabled ? true : !collapsed;
-    return (React.createElement("div", { className: cls(['collapsible', !disabled && (showContent ? 'collapsible-expanded' : 'collapsible-collapsed')]) },
-        head(onClick),
-        React.createElement("div", { ref: contentRef, onTransitionEnd: onTransitionEnd, style: {
-                height: !showContent ? 0 : isAnimating ? contentRef.current.scrollHeight : 'auto',
-                overflow: 'hidden',
-                transition: 'none 0.3s ease',
-                transitionProperty: 'height, margin-bottom',
-                marginBottom: (showContent && marginBottomOnExpand) || undefined,
-            }, "aria-expanded": showContent }, children)));
-}

package/dist/navigation/Navigation.d.ts

@@ -1,21 +0,0 @@
-export { NavigationContent };
-export type { NavItem };
-import React from 'react';
-import './Navigation.css';
-import '@docsearch/css';
-import '../global.d.ts';
-type NavItem = {
-    level: number;
-    url?: string | null;
-    color?: string;
-    title: string;
-    titleInNav: string;
-    menuModalFullWidth?: true;
-    isColumnEntry?: ColumnMap;
-};
-declare function NavigationContent(props: {
-    navItems: NavItem[];
-    showOnlyRelevant?: true;
-    columnLayout?: true;
-}): React.JSX.Element;
-type ColumnMap = Record<number, number>;

package/dist/navigation/Navigation.js

@@ -1,255 +0,0 @@
-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);
-};
-// TODO/refactor: rename file and/or component
-export { NavigationContent };
-import React, { useEffect, useState } from 'react';
-import { assert, assertWarning, jsxToTextContent } from '../utils/server';
-import './Navigation.css';
-import { parseTitle } from '../parseTitle';
-import { usePageContext } from '../renderer/usePageContext';
-import '@docsearch/css';
-import '../global.d.ts';
-import { getViewportWidth } from '../utils/getViewportWidth';
-import { navLeftWidthMax, navLeftWidthMin } from '../Layout';
-import { throttle } from '../utils/throttle';
-import { Collapsible } from './Collapsible';
-function NavigationContent(props) {
-    var pageContext = usePageContext();
-    var navItemsWithComputed = getNavItemsWithComputed(props.navItems, pageContext.urlPathname);
-    var navContent;
-    if (!props.columnLayout) {
-        var navItemsRelevant = navItemsWithComputed;
-        if (props.showOnlyRelevant)
-            navItemsRelevant = navItemsRelevant.filter(function (navItemGroup) { return navItemGroup.isRelevant; });
-        navContent = navItemsRelevant.map(function (navItem, i) { return React.createElement(NavItemComponent, { navItem: navItem, key: i }); });
-    }
-    else {
-        assert(!props.showOnlyRelevant);
-        navContent = React.createElement(NavigationWithColumnLayout, { navItemsWithComputed: navItemsWithComputed });
-    }
-    return (React.createElement("div", { className: "navigation-content", style: { marginTop: 10 } }, navContent));
-}
-function NavigationWithColumnLayout(props) {
-    var _a = useState(), viewportWidth = _a[0], setViewportWidth = _a[1];
-    var updateviewportwidth = function () { return setViewportWidth(getViewportWidth()); };
-    useEffect(function () {
-        updateviewportwidth();
-        window.addEventListener('resize', throttle(updateviewportwidth, 300), { passive: true });
-    });
-    var navItemsByColumnLayouts = getNavItemsByColumnLayouts(props.navItemsWithComputed, viewportWidth);
-    return (React.createElement(React.Fragment, null, navItemsByColumnLayouts.map(function (columnLayout, i) { return (React.createElement("div", { key: i }, columnLayout.isFullWidthCategory ? (React.createElement("div", { style: { marginTop: 0 } },
-        React.createElement(ColumnsWrapper, { numberOfColumns: columnLayout.columns.length },
-            React.createElement(Collapsible, { head: function (onClick) { return React.createElement(NavItemComponent, { navItem: columnLayout.navItemLevel1, onClick: onClick }); }, disabled: columnLayout.columns.length > 1, collapsedInit: !columnLayout.navItemLevel1.isRelevant, marginBottomOnExpand: 10 },
-                React.createElement(ColumnsLayout, { className: "collapsible" },
-                    columnLayout.columns.map(function (column, j) { return (React.createElement(Column, { key: j }, column.navItems.map(function (navItem, k) { return (React.createElement(NavItemComponent, { key: k, navItem: navItem })); }))); }),
-                    React.createElement(CategoryBorder, { navItemLevel1: columnLayout.navItemLevel1 })))))) : (React.createElement(ColumnsWrapper, { numberOfColumns: columnLayout.columns.length },
-        React.createElement(ColumnsLayout, null, columnLayout.columns.map(function (column, j) { return (React.createElement(Column, { key: j }, column.categories.map(function (category, k) { return (React.createElement("div", { key: k, style: { marginBottom: 0 } },
-            React.createElement(Collapsible, { head: function (onClick) { return React.createElement(NavItemComponent, { navItem: category.navItemLevel1, onClick: onClick }); }, disabled: columnLayout.columns.length > 1, collapsedInit: !category.navItemLevel1.isRelevant, marginBottomOnExpand: 40 },
-                category.navItems.map(function (navItem, l) { return (React.createElement(NavItemComponent, { key: l, navItem: navItem })); }),
-                React.createElement(CategoryBorder, { navItemLevel1: category.navItemLevel1 })))); }))); })))))); })));
-}
-function Column(_a) {
-    var children = _a.children;
-    return (React.createElement("div", { style: {
-            flexGrow: 1,
-            maxWidth: navLeftWidthMax,
-            display: 'flex',
-            flexDirection: 'column',
-        } }, children));
-}
-function ColumnsWrapper(_a) {
-    var children = _a.children, numberOfColumns = _a.numberOfColumns;
-    return (React.createElement("div", { style: {
-            width: numberOfColumns * (navLeftWidthMax + 20),
-            maxWidth: '100%',
-            margin: 'auto',
-        } }, children));
-}
-function ColumnsLayout(_a) {
-    var children = _a.children, className = _a.className;
-    return (React.createElement("div", { className: className, style: {
-            display: 'flex',
-            justifyContent: 'space-between',
-        } }, children));
-}
-function CategoryBorder(_a) {
-    var navItemLevel1 = _a.navItemLevel1;
-    assert(navItemLevel1.level === 1);
-    return React.createElement("div", { className: "category-border", style: { background: navItemLevel1.color } });
-}
-function NavItemComponent(_a) {
-    var _b;
-    var _c;
-    var navItem = _a.navItem, onClick = _a.onClick;
-    assert([1, 2, 3, 4].includes(navItem.level), navItem);
-    var titleJsx = parseTitle(navItem.title);
-    var titleInNavJsx = parseTitle(navItem.titleInNav);
-    if (navItem.level === 1 || navItem.level === 4) {
-        assert(navItem.url === undefined);
-    }
-    else {
-        var sectionTitle = jsxToTextContent(titleJsx);
-        assertWarning(navItem.url, [
-            "".concat(jsxToTextContent(titleInNavJsx), " is missing a URL hash."),
-            "Add a URL hash with: `## ".concat(sectionTitle, "{#some-hash}`."),
-            /* TODO/eventually: not implemented yet.
-            `Use \`<h2 id="url-hash">${sectionTitle}</h2>\` instead of \`## ${sectionTitle}\`.`,
-            */
-        ].join(' '));
-    }
-    var children = titleInNavJsx;
-    if (navItem.level === 1) {
-        children = (React.createElement(React.Fragment, null,
-            children,
-            React.createElement(Chevron, { className: "collapsible-icon", height: 9 })));
-    }
-    var props = {
-        href: (_c = navItem.url) !== null && _c !== void 0 ? _c : undefined,
-        children: children,
-        onClick: onClick,
-        className: [
-            'nav-item',
-            'nav-item-level-' + navItem.level,
-            navItem.url && navItem.isActive && ' is-active',
-            navItem.isFirstOfItsKind && 'nav-item-first-of-its-kind',
-            navItem.isLastOfItsKind && 'nav-item-last-of-its-kind',
-        ]
-            .filter(Boolean)
-            .join(' '),
-    };
-    if (navItem.level === 1) {
-        props.style = (_b = {},
-            _b['--category-color'] = navItem.color,
-            _b);
-    }
-    if (navItem.level === 2 || navItem.level === 3) {
-        return React.createElement("a", __assign({}, props));
-    }
-    else {
-        return React.createElement("span", __assign({}, props));
-    }
-}
-function getNavItemsByColumnLayouts(navItems, viewportWidth) {
-    if (viewportWidth === void 0) { viewportWidth = 0; }
-    var navItemsByColumnEntries = getNavItemsByColumnEntries(navItems);
-    var numberOfColumnsMax = Math.floor(viewportWidth / navLeftWidthMin) || 1;
-    var navItemsByColumnLayouts = navItemsByColumnEntries.map(function (_a) {
-        var columnEntries = _a.columnEntries, isFullWidthCategory = _a.isFullWidthCategory;
-        var numberOfColumns = Math.min(numberOfColumnsMax, columnEntries.length);
-        if (!isFullWidthCategory) {
-            var columns_1 = [];
-            columnEntries.forEach(function (columnEntry) {
-                var _a;
-                var idx = numberOfColumns === 1 ? 0 : columnEntry.columnMap[numberOfColumns];
-                assert(idx >= 0);
-                (_a = columns_1[idx]) !== null && _a !== void 0 ? _a : (columns_1[idx] = { categories: [] });
-                var navItemLevel1 = columnEntry.navItems[0];
-                var navItems = columnEntry.navItems.slice(1);
-                columns_1[idx].categories.push({ navItemLevel1: navItemLevel1, navItems: navItems });
-            });
-            var navItemsByColumnLayout = { columns: columns_1, isFullWidthCategory: isFullWidthCategory };
-            return navItemsByColumnLayout;
-        }
-        else {
-            var navItemLevel1_1;
-            var columns_2 = [];
-            columnEntries.forEach(function (columnEntry, i) {
-                var _a;
-                var _b;
-                var idx = numberOfColumns === 1 ? 0 : columnEntry.columnMap[numberOfColumns];
-                assert(idx >= 0);
-                (_b = columns_2[idx]) !== null && _b !== void 0 ? _b : (columns_2[idx] = { navItems: [] });
-                var navItems = columnEntry.navItems;
-                if (i === 0) {
-                    navItemLevel1_1 = navItems[0];
-                    navItems = navItems.slice(1);
-                }
-                (_a = columns_2[idx].navItems).push.apply(_a, navItems);
-            });
-            var navItemsByColumnLayout = {
-                columns: columns_2,
-                navItemLevel1: navItemLevel1_1,
-                isFullWidthCategory: isFullWidthCategory,
-            };
-            return navItemsByColumnLayout;
-        }
-    });
-    return navItemsByColumnLayouts;
-}
-function getNavItemsByColumnEntries(navItems) {
-    var navItemsByColumnEntries = [];
-    var columnEntries = [];
-    var columnEntry;
-    var isFullWidthCategory;
-    navItems.forEach(function (navItem) {
-        if (navItem.level === 1) {
-            var isFullWidthCategoryPrevious = isFullWidthCategory;
-            isFullWidthCategory = !!navItem.menuModalFullWidth;
-            if (isFullWidthCategoryPrevious !== undefined && isFullWidthCategoryPrevious !== isFullWidthCategory) {
-                navItemsByColumnEntries.push({ columnEntries: columnEntries, isFullWidthCategory: isFullWidthCategoryPrevious });
-                columnEntries = [];
-            }
-        }
-        assert(isFullWidthCategory !== undefined);
-        if (navItem.isColumnEntry) {
-            assert(navItem.level === 1 || navItem.level === 4);
-            columnEntry = { navItems: [navItem], columnMap: navItem.isColumnEntry };
-            columnEntries.push(columnEntry);
-        }
-        else {
-            assert(navItem.level !== 1);
-            columnEntry.navItems.push(navItem);
-        }
-    });
-    assert(isFullWidthCategory !== undefined);
-    navItemsByColumnEntries.push({ columnEntries: columnEntries, isFullWidthCategory: isFullWidthCategory });
-    return navItemsByColumnEntries;
-}
-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 isActive = false;
-        if (navItem.url === currentUrl) {
-            assert(navItem.level === 2, { currentUrl: currentUrl });
-            assert(navItemIdx === undefined);
-            navItemIdx = i;
-            isActive = 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);
-        var navItemComputed = __assign(__assign({}, navItem), { isActive: isActive, isRelevant: false, isFirstOfItsKind: isFirstOfItsKind, isLastOfItsKind: isLastOfItsKind });
-        return navItemComputed;
-    });
-    // 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;
-}
-function Chevron(props) {
-    return (React.createElement("svg", __assign({ viewBox: "0 0 512 292.52", xmlns: "http://www.w3.org/2000/svg" }, props),
-        React.createElement("path", { fill: "#aaa", d: "M10.725 82.42L230.125 261.82c6.8 6.8 16.2 10.7 25.9 10.7s19.1-3.9 25.9-10.7l219.4-179.4c14.3-14.3 14.3-37.4 0-51.7s-37.4-14.3-51.7 0l-193.6 153.6-193.6-153.6c-14.3-14.3-37.4-14.3-51.7 0s-14.3 37.5 0 51.7z" })));
-}

package/dist/utils/PassTrough.d.ts

@@ -1,3 +0,0 @@
-export { PassThrough };
-import React from 'react';
-declare function PassThrough({ children }: any): React.JSX.Element;

package/dist/utils/PassTrough.js

@@ -1,6 +0,0 @@
-export { PassThrough };
-import React from 'react';
-function PassThrough(_a) {
-    var children = _a.children;
-    return React.createElement(React.Fragment, null, children);
-}

package/dist/utils/Style.d.ts

@@ -1,5 +0,0 @@
-export { Style };
-import React from 'react';
-declare function Style({ children }: {
-    children: string;
-}): React.JSX.Element;

package/dist/utils/Style.js

@@ -1,6 +0,0 @@
-export { Style };
-import React from 'react';
-function Style(_a) {
-    var children = _a.children;
-    return React.createElement("style", { dangerouslySetInnerHTML: { __html: children } });
-}

package/dist/utils/css.d.ts

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

package/dist/utils/css.js

@@ -1,27 +0,0 @@
-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/getViewportWidth.d.ts

@@ -1 +0,0 @@
-export declare function getViewportWidth(): number;

package/dist/utils/getViewportWidth.js

@@ -1,4 +0,0 @@
-export function getViewportWidth() {
-    // `window.innerWidth` inlcudes scrollbar width: https://developer.mozilla.org/en-US/docs/Web/API/Window/innerWidth#usage_notes
-    return document.documentElement.clientWidth;
-}

package/dist/utils/throttle.d.ts

@@ -1 +0,0 @@
-export declare function throttle<T extends (...args: any[]) => void>(func: T, limit: number): T;

package/dist/utils/throttle.js

@@ -1,14 +0,0 @@
-export function throttle(func, limit) {
-    var inThrottle;
-    return function () {
-        var args = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
-            args[_i] = arguments[_i];
-        }
-        if (!inThrottle) {
-            func.apply(this, args);
-            inThrottle = true;
-            setTimeout(function () { return (inThrottle = false); }, limit);
-        }
-    };
-}