@docusaurus/plugin-content-docs 0.0.0-4071 → 0.0.0-4075

package/lib/sidebars.js

@@ -1,365 +0,0 @@
-"use strict";
-/**
- * Copyright (c) Facebook, Inc. and its affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createSidebarsUtils = exports.collectSidebarsDocIds = exports.transformSidebarItems = exports.collectSidebarLinks = exports.collectSidebarCategories = exports.collectSidebarDocItems = exports.processSidebars = exports.processSidebar = exports.fixSidebarItemInconsistencies = exports.toSidebarItemsGeneratorVersion = exports.toSidebarItemsGeneratorDoc = exports.loadSidebars = exports.resolveSidebarPathOption = exports.DisabledSidebars = exports.DefaultSidebars = void 0;
-const tslib_1 = require("tslib");
-const fs_extra_1 = (0, tslib_1.__importDefault)(require("fs-extra"));
-const import_fresh_1 = (0, tslib_1.__importDefault)(require("import-fresh"));
-const lodash_1 = require("lodash");
-const utils_1 = require("@docusaurus/utils");
-const combine_promises_1 = (0, tslib_1.__importDefault)(require("combine-promises"));
-const sidebarItemsGenerator_1 = require("./sidebarItemsGenerator");
-const path_1 = (0, tslib_1.__importDefault)(require("path"));
-function isCategoryShorthand(item) {
-    return typeof item !== 'string' && !item.type;
-}
-/**
- * Convert {category1: [item1,item2]} shorthand syntax to long-form syntax
- */
-function normalizeCategoryShorthand(sidebar, options) {
-    return Object.entries(sidebar).map(([label, items]) => ({
-        type: 'category',
-        collapsed: options.sidebarCollapsed,
-        collapsible: options.sidebarCollapsible,
-        label,
-        items,
-    }));
-}
-/**
- * Check that item contains only allowed keys.
- */
-function assertItem(item, keys) {
-    const unknownKeys = Object.keys(item).filter((key) => !keys.includes(key) && key !== 'type');
-    if (unknownKeys.length) {
-        throw new Error(`Unknown sidebar item keys: ${unknownKeys}. Item: ${JSON.stringify(item)}`);
-    }
-}
-function assertIsCategory(item) {
-    assertItem(item, [
-        'items',
-        'label',
-        'collapsed',
-        'collapsible',
-        'className',
-        'customProps',
-    ]);
-    if (typeof item.label !== 'string') {
-        throw new Error(`Error loading ${JSON.stringify(item)}: "label" must be a string.`);
-    }
-    if (!Array.isArray(item.items)) {
-        throw new Error(`Error loading ${JSON.stringify(item)}: "items" must be an array.`);
-    }
-    // "collapsed" is an optional property
-    if (typeof item.collapsed !== 'undefined' &&
-        typeof item.collapsed !== 'boolean') {
-        throw new Error(`Error loading ${JSON.stringify(item)}: "collapsed" must be a boolean.`);
-    }
-    if (typeof item.collapsible !== 'undefined' &&
-        typeof item.collapsible !== 'boolean') {
-        throw new Error(`Error loading ${JSON.stringify(item)}: "collapsible" must be a boolean.`);
-    }
-    if (typeof item.className !== 'undefined' &&
-        typeof item.className !== 'string') {
-        throw new Error(`Error loading ${JSON.stringify(item)}: "className" must be a string.`);
-    }
-}
-function assertIsAutogenerated(item) {
-    assertItem(item, ['dirName', 'customProps']);
-    if (typeof item.dirName !== 'string') {
-        throw new Error(`Error loading ${JSON.stringify(item)}: "dirName" must be a string.`);
-    }
-    if (item.dirName.startsWith('/') || item.dirName.endsWith('/')) {
-        throw new Error(`Error loading ${JSON.stringify(item)}: "dirName" must be a dir path relative to the docs folder root, and should not start or end with slash`);
-    }
-}
-function assertIsDoc(item) {
-    assertItem(item, ['id', 'label', 'className', 'customProps']);
-    if (typeof item.id !== 'string') {
-        throw new Error(`Error loading ${JSON.stringify(item)}: "id" must be a string.`);
-    }
-    if (typeof item.label !== 'undefined' && typeof item.label !== 'string') {
-        throw new Error(`Error loading ${JSON.stringify(item)}: "label" must be a string.`);
-    }
-    if (typeof item.className !== 'undefined' &&
-        typeof item.className !== 'string') {
-        throw new Error(`Error loading ${JSON.stringify(item)}: "className" must be a string.`);
-    }
-}
-function assertIsLink(item) {
-    assertItem(item, ['href', 'label', 'className', 'customProps']);
-    if (typeof item.href !== 'string') {
-        throw new Error(`Error loading ${JSON.stringify(item)}: "href" must be a string.`);
-    }
-    if (typeof item.label !== 'string') {
-        throw new Error(`Error loading ${JSON.stringify(item)}: "label" must be a string.`);
-    }
-    if (typeof item.className !== 'undefined' &&
-        typeof item.className !== 'string') {
-        throw new Error(`Error loading ${JSON.stringify(item)}: "className" must be a string.`);
-    }
-}
-/**
- * Normalizes recursively item and all its children. Ensures that at the end
- * each item will be an object with the corresponding type.
- */
-function normalizeItem(item, options) {
-    var _a, _b;
-    if (typeof item === 'string') {
-        return [
-            {
-                type: 'doc',
-                id: item,
-            },
-        ];
-    }
-    if (isCategoryShorthand(item)) {
-        return (0, lodash_1.flatMap)(normalizeCategoryShorthand(item, options), (subitem) => normalizeItem(subitem, options));
-    }
-    switch (item.type) {
-        case 'category':
-            assertIsCategory(item);
-            return [
-                {
-                    ...item,
-                    items: (0, lodash_1.flatMap)(item.items, (subItem) => normalizeItem(subItem, options)),
-                    collapsible: (_a = item.collapsible) !== null && _a !== void 0 ? _a : options.sidebarCollapsible,
-                    collapsed: (_b = item.collapsed) !== null && _b !== void 0 ? _b : options.sidebarCollapsed,
-                },
-            ];
-        case 'autogenerated':
-            assertIsAutogenerated(item);
-            return [item];
-        case 'link':
-            assertIsLink(item);
-            return [item];
-        case 'ref':
-        case 'doc':
-            assertIsDoc(item);
-            return [item];
-        default: {
-            const extraMigrationError = item.type === 'subcategory'
-                ? 'Docusaurus v2: "subcategory" has been renamed as "category".'
-                : '';
-            throw new Error(`Unknown sidebar item type "${item.type}". Sidebar item is ${JSON.stringify(item)}.\n${extraMigrationError}`);
-        }
-    }
-}
-function normalizeSidebar(sidebar, options) {
-    const normalizedSidebar = Array.isArray(sidebar)
-        ? sidebar
-        : normalizeCategoryShorthand(sidebar, options);
-    return (0, lodash_1.flatMap)(normalizedSidebar, (subitem) => normalizeItem(subitem, options));
-}
-function normalizeSidebars(sidebars, options) {
-    return (0, lodash_1.mapValues)(sidebars, (subitem) => normalizeSidebar(subitem, options));
-}
-exports.DefaultSidebars = {
-    defaultSidebar: [
-        {
-            type: 'autogenerated',
-            dirName: '.',
-        },
-    ],
-};
-exports.DisabledSidebars = {};
-// If a path is provided, make it absolute
-// use this before loadSidebars()
-function resolveSidebarPathOption(siteDir, sidebarPathOption) {
-    return sidebarPathOption
-        ? path_1.default.resolve(siteDir, sidebarPathOption)
-        : sidebarPathOption;
-}
-exports.resolveSidebarPathOption = resolveSidebarPathOption;
-// TODO refactor: make async
-// Note: sidebarFilePath must be absolute, use resolveSidebarPathOption
-function loadSidebars(sidebarFilePath, options) {
-    // false => no sidebars
-    if (sidebarFilePath === false) {
-        return exports.DisabledSidebars;
-    }
-    // undefined => defaults to autogenerated sidebars
-    if (typeof sidebarFilePath === 'undefined') {
-        return exports.DefaultSidebars;
-    }
-    // unexisting sidebars file: no sidebars
-    // Note: this edge case can happen on versioned docs, not current version
-    // We avoid creating empty versioned sidebars file with the CLI
-    if (!fs_extra_1.default.existsSync(sidebarFilePath)) {
-        return exports.DisabledSidebars;
-    }
-    // We don't want sidebars to be cached because of hot reloading.
-    const sidebarJson = (0, import_fresh_1.default)(sidebarFilePath);
-    return normalizeSidebars(sidebarJson, options);
-}
-exports.loadSidebars = loadSidebars;
-function toSidebarItemsGeneratorDoc(doc) {
-    return (0, lodash_1.pick)(doc, [
-        'id',
-        'frontMatter',
-        'source',
-        'sourceDirName',
-        'sidebarPosition',
-    ]);
-}
-exports.toSidebarItemsGeneratorDoc = toSidebarItemsGeneratorDoc;
-function toSidebarItemsGeneratorVersion(version) {
-    return (0, lodash_1.pick)(version, ['versionName', 'contentPath']);
-}
-exports.toSidebarItemsGeneratorVersion = toSidebarItemsGeneratorVersion;
-function fixSidebarItemInconsistencies(item) {
-    function fixCategoryInconsistencies(category) {
-        // A non-collapsible category can't be collapsed!
-        if (!category.collapsible && category.collapsed) {
-            return {
-                ...category,
-                collapsed: false,
-            };
-        }
-        return category;
-    }
-    if (item.type === 'category') {
-        return {
-            ...fixCategoryInconsistencies(item),
-            items: item.items.map(fixSidebarItemInconsistencies),
-        };
-    }
-    return item;
-}
-exports.fixSidebarItemInconsistencies = fixSidebarItemInconsistencies;
-// Handle the generation of autogenerated sidebar items and other post-processing checks
-async function processSidebar({ sidebarItemsGenerator, numberPrefixParser, unprocessedSidebar, docs, version, options, }) {
-    // Just a minor lazy transformation optimization
-    const getSidebarItemsGeneratorDocsAndVersion = (0, lodash_1.memoize)(() => ({
-        docs: docs.map(toSidebarItemsGeneratorDoc),
-        version: toSidebarItemsGeneratorVersion(version),
-    }));
-    async function handleAutoGeneratedItems(item) {
-        if (item.type === 'category') {
-            return [
-                {
-                    ...item,
-                    items: (await Promise.all(item.items.map(handleAutoGeneratedItems))).flat(),
-                },
-            ];
-        }
-        if (item.type === 'autogenerated') {
-            return sidebarItemsGenerator({
-                item,
-                numberPrefixParser,
-                defaultSidebarItemsGenerator: sidebarItemsGenerator_1.DefaultSidebarItemsGenerator,
-                ...getSidebarItemsGeneratorDocsAndVersion(),
-                options,
-            });
-        }
-        return [item];
-    }
-    const processedSidebar = (await Promise.all(unprocessedSidebar.map(handleAutoGeneratedItems))).flat();
-    return processedSidebar.map(fixSidebarItemInconsistencies);
-}
-exports.processSidebar = processSidebar;
-async function processSidebars({ sidebarItemsGenerator, numberPrefixParser, unprocessedSidebars, docs, version, options, }) {
-    return (0, combine_promises_1.default)((0, lodash_1.mapValues)(unprocessedSidebars, (unprocessedSidebar) => processSidebar({
-        sidebarItemsGenerator,
-        numberPrefixParser,
-        unprocessedSidebar,
-        docs,
-        version,
-        options,
-    })));
-}
-exports.processSidebars = processSidebars;
-function collectSidebarItemsOfType(type, sidebar) {
-    function collectRecursive(item) {
-        const currentItemsCollected = item.type === type ? [item] : [];
-        const childItemsCollected = item.type === 'category' ? (0, lodash_1.flatten)(item.items.map(collectRecursive)) : [];
-        return [...currentItemsCollected, ...childItemsCollected];
-    }
-    return (0, lodash_1.flatten)(sidebar.map(collectRecursive));
-}
-function collectSidebarDocItems(sidebar) {
-    return collectSidebarItemsOfType('doc', sidebar);
-}
-exports.collectSidebarDocItems = collectSidebarDocItems;
-function collectSidebarCategories(sidebar) {
-    return collectSidebarItemsOfType('category', sidebar);
-}
-exports.collectSidebarCategories = collectSidebarCategories;
-function collectSidebarLinks(sidebar) {
-    return collectSidebarItemsOfType('link', sidebar);
-}
-exports.collectSidebarLinks = collectSidebarLinks;
-function transformSidebarItems(sidebar, updateFn) {
-    function transformRecursive(item) {
-        if (item.type === 'category') {
-            return updateFn({
-                ...item,
-                items: item.items.map(transformRecursive),
-            });
-        }
-        return updateFn(item);
-    }
-    return sidebar.map(transformRecursive);
-}
-exports.transformSidebarItems = transformSidebarItems;
-function collectSidebarsDocIds(sidebars) {
-    return (0, lodash_1.mapValues)(sidebars, (sidebar) => {
-        return collectSidebarDocItems(sidebar).map((docItem) => docItem.id);
-    });
-}
-exports.collectSidebarsDocIds = collectSidebarsDocIds;
-function createSidebarsUtils(sidebars) {
-    const sidebarNameToDocIds = collectSidebarsDocIds(sidebars);
-    function getFirstDocIdOfFirstSidebar() {
-        var _a;
-        return (_a = Object.values(sidebarNameToDocIds)[0]) === null || _a === void 0 ? void 0 : _a[0];
-    }
-    function getSidebarNameByDocId(docId) {
-        // TODO lookup speed can be optimized
-        const entry = Object.entries(sidebarNameToDocIds).find(([_sidebarName, docIds]) => docIds.includes(docId));
-        return entry === null || entry === void 0 ? void 0 : entry[0];
-    }
-    function getDocNavigation(docId) {
-        const sidebarName = getSidebarNameByDocId(docId);
-        if (sidebarName) {
-            const docIds = sidebarNameToDocIds[sidebarName];
-            const currentIndex = docIds.indexOf(docId);
-            const { previous, next } = (0, utils_1.getElementsAround)(docIds, currentIndex);
-            return {
-                sidebarName,
-                previousId: previous,
-                nextId: next,
-            };
-        }
-        else {
-            return {
-                sidebarName: undefined,
-                previousId: undefined,
-                nextId: undefined,
-            };
-        }
-    }
-    function checkSidebarsDocIds(validDocIds, sidebarFilePath) {
-        const allSidebarDocIds = (0, lodash_1.flatten)(Object.values(sidebarNameToDocIds));
-        const invalidSidebarDocIds = (0, lodash_1.difference)(allSidebarDocIds, validDocIds);
-        if (invalidSidebarDocIds.length > 0) {
-            throw new Error(`Invalid sidebar file at "${(0, utils_1.toMessageRelativeFilePath)(sidebarFilePath)}".
-These sidebar document ids do not exist:
-- ${invalidSidebarDocIds.sort().join('\n- ')}
-
-Available document ids are:
-- ${validDocIds.sort().join('\n- ')}`);
-        }
-    }
-    return {
-        getFirstDocIdOfFirstSidebar,
-        getSidebarNameByDocId,
-        getDocNavigation,
-        checkSidebarsDocIds,
-    };
-}
-exports.createSidebarsUtils = createSidebarsUtils;