@docusaurus/theme-common 3.4.0 → 3.5.1

package/lib/utils/docsUtils.js

@@ -1,276 +0,0 @@
-/**
- * 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.
- */
-import { useMemo } from 'react';
-import { matchPath, useLocation } from '@docusaurus/router';
-import renderRoutes from '@docusaurus/renderRoutes';
-import { useAllDocsData, useActivePlugin, useActiveDocContext, useLatestVersion, } from '@docusaurus/plugin-content-docs/client';
-import { useDocsPreferredVersion } from '../contexts/docsPreferredVersion';
-import { useDocsVersion } from '../contexts/docsVersion';
-import { useDocsSidebar } from '../contexts/docsSidebar';
-import { uniq } from './jsUtils';
-import { isSamePath } from './routesUtils';
-// TODO not ideal, see also "useDocs"
-export const isDocsPluginEnabled = !!useAllDocsData;
-export function useDocById(id) {
-    const version = useDocsVersion();
-    if (!id) {
-        return undefined;
-    }
-    const doc = version.docs[id];
-    if (!doc) {
-        throw new Error(`no version doc found by id=${id}`);
-    }
-    return doc;
-}
-/**
- * Pure function, similar to `Array#find`, but works on the sidebar tree.
- */
-export function findSidebarCategory(sidebar, predicate) {
-    for (const item of sidebar) {
-        if (item.type === 'category') {
-            if (predicate(item)) {
-                return item;
-            }
-            const subItem = findSidebarCategory(item.items, predicate);
-            if (subItem) {
-                return subItem;
-            }
-        }
-    }
-    return undefined;
-}
-/**
- * Best effort to assign a link to a sidebar category. If the category doesn't
- * have a link itself, we link to the first sub item with a link.
- */
-export function findFirstSidebarItemCategoryLink(item) {
-    if (item.href && !item.linkUnlisted) {
-        return item.href;
-    }
-    for (const subItem of item.items) {
-        const link = findFirstSidebarItemLink(subItem);
-        if (link) {
-            return link;
-        }
-    }
-    return undefined;
-}
-/**
- * Best effort to assign a link to a sidebar item.
- */
-export function findFirstSidebarItemLink(item) {
-    if (item.type === 'link' && !item.unlisted) {
-        return item.href;
-    }
-    if (item.type === 'category') {
-        return findFirstSidebarItemCategoryLink(item);
-    }
-    // Other items types, like "html"
-    return undefined;
-}
-/**
- * Gets the category associated with the current location. Should only be used
- * on category index pages.
- */
-export function useCurrentSidebarCategory() {
-    const { pathname } = useLocation();
-    const sidebar = useDocsSidebar();
-    if (!sidebar) {
-        throw new Error('Unexpected: cant find current sidebar in context');
-    }
-    const categoryBreadcrumbs = getSidebarBreadcrumbs({
-        sidebarItems: sidebar.items,
-        pathname,
-        onlyCategories: true,
-    });
-    const deepestCategory = categoryBreadcrumbs.slice(-1)[0];
-    if (!deepestCategory) {
-        throw new Error(`${pathname} is not associated with a category. useCurrentSidebarCategory() should only be used on category index pages.`);
-    }
-    return deepestCategory;
-}
-const isActive = (testedPath, activePath) => typeof testedPath !== 'undefined' && isSamePath(testedPath, activePath);
-const containsActiveSidebarItem = (items, activePath) => items.some((subItem) => isActiveSidebarItem(subItem, activePath));
-/**
- * Checks if a sidebar item should be active, based on the active path.
- */
-export function isActiveSidebarItem(item, activePath) {
-    if (item.type === 'link') {
-        return isActive(item.href, activePath);
-    }
-    if (item.type === 'category') {
-        return (isActive(item.href, activePath) ||
-            containsActiveSidebarItem(item.items, activePath));
-    }
-    return false;
-}
-export function isVisibleSidebarItem(item, activePath) {
-    switch (item.type) {
-        case 'category':
-            return (isActiveSidebarItem(item, activePath) ||
-                item.items.some((subItem) => isVisibleSidebarItem(subItem, activePath)));
-        case 'link':
-            // An unlisted item remains visible if it is active
-            return !item.unlisted || isActiveSidebarItem(item, activePath);
-        default:
-            return true;
-    }
-}
-export function useVisibleSidebarItems(items, activePath) {
-    return useMemo(() => items.filter((item) => isVisibleSidebarItem(item, activePath)), [items, activePath]);
-}
-/**
- * Get the sidebar the breadcrumbs for a given pathname
- * Ordered from top to bottom
- */
-function getSidebarBreadcrumbs({ sidebarItems, pathname, onlyCategories = false, }) {
-    const breadcrumbs = [];
-    function extract(items) {
-        for (const item of items) {
-            if ((item.type === 'category' &&
-                (isSamePath(item.href, pathname) || extract(item.items))) ||
-                (item.type === 'link' && isSamePath(item.href, pathname))) {
-                const filtered = onlyCategories && item.type !== 'category';
-                if (!filtered) {
-                    breadcrumbs.unshift(item);
-                }
-                return true;
-            }
-        }
-        return false;
-    }
-    extract(sidebarItems);
-    return breadcrumbs;
-}
-/**
- * Gets the breadcrumbs of the current doc page, based on its sidebar location.
- * Returns `null` if there's no sidebar or breadcrumbs are disabled.
- */
-export function useSidebarBreadcrumbs() {
-    const sidebar = useDocsSidebar();
-    const { pathname } = useLocation();
-    const breadcrumbsOption = useActivePlugin()?.pluginData.breadcrumbs;
-    if (breadcrumbsOption === false || !sidebar) {
-        return null;
-    }
-    return getSidebarBreadcrumbs({ sidebarItems: sidebar.items, pathname });
-}
-/**
- * "Version candidates" are mostly useful for the layout components, which must
- * be able to work on all pages. For example, if a user has `{ type: "doc",
- * docId: "intro" }` as a navbar item, which version does that refer to? We
- * believe that it could refer to at most three version candidates:
- *
- * 1. The **active version**, the one that the user is currently browsing. See
- * {@link useActiveDocContext}.
- * 2. The **preferred version**, the one that the user last visited. See
- * {@link useDocsPreferredVersion}.
- * 3. The **latest version**, the "default". See {@link useLatestVersion}.
- *
- * @param docsPluginId The plugin ID to get versions from.
- * @returns An array of 1~3 versions with priorities defined above, guaranteed
- * to be unique and non-sparse. Will be memoized, hence stable for deps array.
- */
-export function useDocsVersionCandidates(docsPluginId) {
-    const { activeVersion } = useActiveDocContext(docsPluginId);
-    const { preferredVersion } = useDocsPreferredVersion(docsPluginId);
-    const latestVersion = useLatestVersion(docsPluginId);
-    return useMemo(() => uniq([activeVersion, preferredVersion, latestVersion].filter(Boolean)), [activeVersion, preferredVersion, latestVersion]);
-}
-/**
- * The layout components, like navbar items, must be able to work on all pages,
- * even on non-doc ones where there's no version context, so a sidebar ID could
- * be ambiguous. This hook would always return a sidebar to be linked to. See
- * also {@link useDocsVersionCandidates} for how this selection is done.
- *
- * @throws This hook throws if a sidebar with said ID is not found.
- */
-export function useLayoutDocsSidebar(sidebarId, docsPluginId) {
-    const versions = useDocsVersionCandidates(docsPluginId);
-    return useMemo(() => {
-        const allSidebars = versions.flatMap((version) => version.sidebars ? Object.entries(version.sidebars) : []);
-        const sidebarEntry = allSidebars.find((sidebar) => sidebar[0] === sidebarId);
-        if (!sidebarEntry) {
-            throw new Error(`Can't find any sidebar with id "${sidebarId}" in version${versions.length > 1 ? 's' : ''} ${versions.map((version) => version.name).join(', ')}".
-Available sidebar ids are:
-- ${allSidebars.map((entry) => entry[0]).join('\n- ')}`);
-        }
-        return sidebarEntry[1];
-    }, [sidebarId, versions]);
-}
-/**
- * The layout components, like navbar items, must be able to work on all pages,
- * even on non-doc ones where there's no version context, so a doc ID could be
- * ambiguous. This hook would always return a doc to be linked to. See also
- * {@link useDocsVersionCandidates} for how this selection is done.
- *
- * @throws This hook throws if a doc with said ID is not found.
- */
-export function useLayoutDoc(docId, docsPluginId) {
-    const versions = useDocsVersionCandidates(docsPluginId);
-    return useMemo(() => {
-        const allDocs = versions.flatMap((version) => version.docs);
-        const doc = allDocs.find((versionDoc) => versionDoc.id === docId);
-        if (!doc) {
-            const isDraft = versions
-                .flatMap((version) => version.draftIds)
-                .includes(docId);
-            // Drafts should be silently filtered instead of throwing
-            if (isDraft) {
-                return null;
-            }
-            throw new Error(`Couldn't find any doc with id "${docId}" in version${versions.length > 1 ? 's' : ''} "${versions.map((version) => version.name).join(', ')}".
-Available doc ids are:
-- ${uniq(allDocs.map((versionDoc) => versionDoc.id)).join('\n- ')}`);
-        }
-        return doc;
-    }, [docId, versions]);
-}
-// TODO later read version/route directly from context
-/**
- * The docs plugin creates nested routes, with the top-level route providing the
- * version metadata, and the subroutes creating individual doc pages. This hook
- * will match the current location against all known sub-routes.
- *
- * @param props The props received by `@theme/DocRoot`
- * @returns The data of the relevant document at the current location, or `null`
- * if no document associated with the current location can be found.
- */
-export function useDocRootMetadata({ route }) {
-    const location = useLocation();
-    const versionMetadata = useDocsVersion();
-    const docRoutes = route.routes;
-    const currentDocRoute = docRoutes.find((docRoute) => matchPath(location.pathname, docRoute));
-    if (!currentDocRoute) {
-        return null;
-    }
-    // For now, the sidebarName is added as route config: not ideal!
-    const sidebarName = currentDocRoute.sidebar;
-    const sidebarItems = sidebarName
-        ? versionMetadata.docsSidebars[sidebarName]
-        : undefined;
-    const docElement = renderRoutes(docRoutes);
-    return {
-        docElement,
-        sidebarName,
-        sidebarItems,
-    };
-}
-/**
- * Filter items we don't want to display on the doc card list view
- * @param items
- */
-export function filterDocCardListItems(items) {
-    return items.filter((item) => {
-        const canHaveLink = item.type === 'category' || item.type === 'link';
-        if (canHaveLink) {
-            return !!findFirstSidebarItemLink(item);
-        }
-        return true;
-    });
-}
-//# sourceMappingURL=docsUtils.js.map

package/lib/utils/docsUtils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"docsUtils.js","sourceRoot":"","sources":["../../src/utils/docsUtils.tsx"],"names":[],"mappings":"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"}

package/lib/utils/structuredDataUtils.d.ts

@@ -1,12 +0,0 @@
-/**
- * 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.
- */
-/// <reference types="@docusaurus/plugin-content-blog" />
-import type { Props as BlogListPageStructuredDataProps } from '@theme/BlogListPage/StructuredData';
-import type { Blog, BlogPosting, WithContext } from 'schema-dts';
-export declare function useBlogListPageStructuredData(props: BlogListPageStructuredDataProps): WithContext<Blog>;
-export declare function useBlogPostStructuredData(): WithContext<BlogPosting>;
-//# sourceMappingURL=structuredDataUtils.d.ts.map

package/lib/utils/structuredDataUtils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"structuredDataUtils.d.ts","sourceRoot":"","sources":["../../src/utils/structuredDataUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;;AAKH,OAAO,KAAK,EAAC,KAAK,IAAI,+BAA+B,EAAC,MAAM,oCAAoC,CAAC;AAEjG,OAAO,KAAK,EACV,IAAI,EACJ,WAAW,EACX,WAAW,EAGZ,MAAM,YAAY,CAAC;AAiEpB,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,+BAA+B,GACrC,WAAW,CAAC,IAAI,CAAC,CAsBnB;AAED,wBAAgB,yBAAyB,IAAI,WAAW,CAAC,WAAW,CAAC,CAsCpE"}

package/lib/utils/structuredDataUtils.js

@@ -1,123 +0,0 @@
-/**
- * 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.
- */
-import { useBaseUrlUtils } from '@docusaurus/useBaseUrl';
-import useDocusaurusContext from '@docusaurus/useDocusaurusContext';
-import { useBlogMetadata } from '@docusaurus/plugin-content-blog/client';
-import { useBlogPost } from '../contexts/blogPost';
-const convertDate = (dateMs) => new Date(dateMs).toISOString();
-function getBlogPost(blogPostContent, siteConfig, withBaseUrl) {
-    const { assets, frontMatter, metadata } = blogPostContent;
-    const { date, title, description, lastUpdatedAt } = metadata;
-    const image = assets.image ?? frontMatter.image;
-    const keywords = frontMatter.keywords ?? [];
-    const blogUrl = `${siteConfig.url}${metadata.permalink}`;
-    const dateModified = lastUpdatedAt ? convertDate(lastUpdatedAt) : undefined;
-    return {
-        '@type': 'BlogPosting',
-        '@id': blogUrl,
-        mainEntityOfPage: blogUrl,
-        url: blogUrl,
-        headline: title,
-        name: title,
-        description,
-        datePublished: date,
-        ...(dateModified ? { dateModified } : {}),
-        ...getAuthor(metadata.authors),
-        ...getImage(image, withBaseUrl, title),
-        ...(keywords ? { keywords } : {}),
-    };
-}
-function getAuthor(authors) {
-    const authorsStructuredData = authors.map(createPersonStructuredData);
-    return {
-        author: authorsStructuredData.length === 1
-            ? authorsStructuredData[0]
-            : authorsStructuredData,
-    };
-}
-function getImage(image, withBaseUrl, title) {
-    return image
-        ? {
-            image: createImageStructuredData({
-                imageUrl: withBaseUrl(image, { absolute: true }),
-                caption: `title image for the blog post: ${title}`,
-            }),
-        }
-        : {};
-}
-export function useBlogListPageStructuredData(props) {
-    const { siteConfig } = useDocusaurusContext();
-    const { withBaseUrl } = useBaseUrlUtils();
-    const { metadata: { blogDescription, blogTitle, permalink }, } = props;
-    const url = `${siteConfig.url}${permalink}`;
-    // details on structured data support: https://schema.org/Blog
-    return {
-        '@context': 'https://schema.org',
-        '@type': 'Blog',
-        '@id': url,
-        mainEntityOfPage: url,
-        headline: blogTitle,
-        description: blogDescription,
-        blogPost: props.items.map((blogItem) => getBlogPost(blogItem.content, siteConfig, withBaseUrl)),
-    };
-}
-export function useBlogPostStructuredData() {
-    const blogMetadata = useBlogMetadata();
-    const { assets, metadata } = useBlogPost();
-    const { siteConfig } = useDocusaurusContext();
-    const { withBaseUrl } = useBaseUrlUtils();
-    const { date, title, description, frontMatter, lastUpdatedAt } = metadata;
-    const image = assets.image ?? frontMatter.image;
-    const keywords = frontMatter.keywords ?? [];
-    const dateModified = lastUpdatedAt ? convertDate(lastUpdatedAt) : undefined;
-    const url = `${siteConfig.url}${metadata.permalink}`;
-    // details on structured data support: https://schema.org/BlogPosting
-    // BlogPosting is one of the structured data types that Google explicitly
-    // supports: https://developers.google.com/search/docs/appearance/structured-data/article#structured-data-type-definitions
-    return {
-        '@context': 'https://schema.org',
-        '@type': 'BlogPosting',
-        '@id': url,
-        mainEntityOfPage: url,
-        url,
-        headline: title,
-        name: title,
-        description,
-        datePublished: date,
-        ...(dateModified ? { dateModified } : {}),
-        ...getAuthor(metadata.authors),
-        ...getImage(image, withBaseUrl, title),
-        ...(keywords ? { keywords } : {}),
-        isPartOf: {
-            '@type': 'Blog',
-            '@id': `${siteConfig.url}${blogMetadata.blogBasePath}`,
-            name: blogMetadata.blogTitle,
-        },
-    };
-}
-/** @returns A {@link https://schema.org/Person} constructed from the {@link Author} */
-function createPersonStructuredData(author) {
-    return {
-        '@type': 'Person',
-        ...(author.name ? { name: author.name } : {}),
-        ...(author.title ? { description: author.title } : {}),
-        ...(author.url ? { url: author.url } : {}),
-        ...(author.email ? { email: author.email } : {}),
-        ...(author.imageURL ? { image: author.imageURL } : {}),
-    };
-}
-/** @returns A {@link https://schema.org/ImageObject} */
-function createImageStructuredData({ imageUrl, caption, }) {
-    return {
-        '@type': 'ImageObject',
-        '@id': imageUrl,
-        url: imageUrl,
-        contentUrl: imageUrl,
-        caption,
-    };
-}
-//# sourceMappingURL=structuredDataUtils.js.map

package/lib/utils/structuredDataUtils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"structuredDataUtils.js","sourceRoot":"","sources":["../../src/utils/structuredDataUtils.ts"],"names":[],"mappings":"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"}

package/lib/utils/unlistedUtils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"unlistedUtils.d.ts","sourceRoot":"","sources":["../../src/utils/unlistedUtils.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;;AAMH,wBAAgB,mBAAmB,IAAI,GAAG,CAAC,OAAO,CAQjD;AAED,wBAAgB,qBAAqB,IAAI,GAAG,CAAC,OAAO,CASnD;AAED,wBAAgB,gBAAgB,IAAI,GAAG,CAAC,OAAO,CAM9C"}

package/lib/utils/unlistedUtils.js

@@ -1,26 +0,0 @@
-/**
- * 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.
- */
-import React from 'react';
-import Translate from '@docusaurus/Translate';
-import Head from '@docusaurus/Head';
-export function UnlistedBannerTitle() {
-    return (<Translate id="theme.unlistedContent.title" description="The unlisted content banner title">
-      Unlisted page
-    </Translate>);
-}
-export function UnlistedBannerMessage() {
-    return (<Translate id="theme.unlistedContent.message" description="The unlisted content banner message">
-      This page is unlisted. Search engines will not index it, and only users
-      having a direct link can access it.
-    </Translate>);
-}
-export function UnlistedMetadata() {
-    return (<Head>
-      <meta name="robots" content="noindex, nofollow"/>
-    </Head>);
-}
-//# sourceMappingURL=unlistedUtils.js.map

package/lib/utils/unlistedUtils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"unlistedUtils.js","sourceRoot":"","sources":["../../src/utils/unlistedUtils.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,SAAS,MAAM,uBAAuB,CAAC;AAC9C,OAAO,IAAI,MAAM,kBAAkB,CAAC;AAEpC,MAAM,UAAU,mBAAmB;IACjC,OAAO,CACL,CAAC,SAAS,CACR,EAAE,CAAC,6BAA6B,CAChC,WAAW,CAAC,mCAAmC,CAC/C;;IACF,EAAE,SAAS,CAAC,CACb,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,CACL,CAAC,SAAS,CACR,EAAE,CAAC,+BAA+B,CAClC,WAAW,CAAC,qCAAqC,CACjD;;;IAEF,EAAE,SAAS,CAAC,CACb,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CACL,CAAC,IAAI,CACH;MAAA,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,mBAAmB,EACjD;IAAA,EAAE,IAAI,CAAC,CACR,CAAC;AACJ,CAAC"}

package/src/contexts/blogPost.tsx

@@ -1,80 +0,0 @@
-/**
- * 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.
- */
-
-import React, {useMemo, type ReactNode, useContext} from 'react';
-import {ReactContextError} from '../utils/reactUtils';
-
-import type {PropBlogPostContent} from '@docusaurus/plugin-content-blog';
-
-/**
- * The React context value returned by the `useBlogPost()` hook.
- * It contains useful data related to the currently browsed blog post.
- */
-export type BlogPostContextValue = Pick<
-  PropBlogPostContent,
-  'metadata' | 'frontMatter' | 'assets' | 'toc'
-> & {
-  readonly isBlogPostPage: boolean;
-};
-
-const Context = React.createContext<BlogPostContextValue | null>(null);
-
-/**
- * Note: we don't use `PropBlogPostContent` as context value on purpose.
- * Metadata is currently stored inside the MDX component, but we may want to
- * change that in the future.
- */
-function useContextValue({
-  content,
-  isBlogPostPage,
-}: {
-  content: PropBlogPostContent;
-  isBlogPostPage: boolean;
-}): BlogPostContextValue {
-  return useMemo(
-    () => ({
-      metadata: content.metadata,
-      frontMatter: content.frontMatter,
-      assets: content.assets,
-      toc: content.toc,
-      isBlogPostPage,
-    }),
-    [content, isBlogPostPage],
-  );
-}
-
-/**
- * This is a very thin layer around the `content` received from the MDX loader.
- * It provides metadata about the blog post to the children tree.
- */
-export function BlogPostProvider({
-  children,
-  content,
-  isBlogPostPage = false,
-}: {
-  children: ReactNode;
-  content: PropBlogPostContent;
-  isBlogPostPage?: boolean;
-}): JSX.Element {
-  const contextValue = useContextValue({content, isBlogPostPage});
-  return <Context.Provider value={contextValue}>{children}</Context.Provider>;
-}
-
-/**
- * Returns the data of the currently browsed blog post. Gives access to
- * front matter, metadata, TOC, etc.
- * When swizzling a low-level component (e.g. the "Edit this page" link)
- * and you need some extra metadata, you don't have to drill the props
- * all the way through the component tree: simply use this hook instead.
- */
-export function useBlogPost(): BlogPostContextValue {
-  const blogPost = useContext(Context);
-  if (blogPost === null) {
-    throw new ReactContextError('BlogPostProvider');
-  }
-  return blogPost;
-}

package/src/contexts/doc.tsx

@@ -1,71 +0,0 @@
-/**
- * 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.
- */
-
-import React, {useMemo, type ReactNode, useContext} from 'react';
-import {ReactContextError} from '../utils/reactUtils';
-import type {PropDocContent} from '@docusaurus/plugin-content-docs';
-
-/**
- * The React context value returned by the `useDoc()` hook.
- * It contains useful data related to the currently browsed doc.
- */
-export type DocContextValue = Pick<
-  PropDocContent,
-  'metadata' | 'frontMatter' | 'toc' | 'assets' | 'contentTitle'
->;
-
-const Context = React.createContext<DocContextValue | null>(null);
-
-/**
- * Note: we don't use `PropDoc` as context value on purpose. Metadata is
- * currently stored inside the MDX component, but we may want to change that in
- * the future. This layer is a good opportunity to decouple storage from
- * consuming API, potentially allowing us to provide metadata as both props and
- * route context without duplicating the chunks in the future.
- */
-function useContextValue(content: PropDocContent): DocContextValue {
-  return useMemo(
-    () => ({
-      metadata: content.metadata,
-      frontMatter: content.frontMatter,
-      assets: content.assets,
-      contentTitle: content.contentTitle,
-      toc: content.toc,
-    }),
-    [content],
-  );
-}
-
-/**
- * This is a very thin layer around the `content` received from the MDX loader.
- * It provides metadata about the doc to the children tree.
- */
-export function DocProvider({
-  children,
-  content,
-}: {
-  children: ReactNode;
-  content: PropDocContent;
-}): JSX.Element {
-  const contextValue = useContextValue(content);
-  return <Context.Provider value={contextValue}>{children}</Context.Provider>;
-}
-
-/**
- * Returns the data of the currently browsed doc. Gives access to the doc's MDX
- * Component, front matter, metadata, TOC, etc. When swizzling a low-level
- * component (e.g. the "Edit this page" link) and you need some extra metadata,
- * you don't have to drill the props all the way through the component tree:
- * simply use this hook instead.
- */
-export function useDoc(): DocContextValue {
-  const doc = useContext(Context);
-  if (doc === null) {
-    throw new ReactContextError('DocProvider');
-  }
-  return doc;
-}