@redocly/theme 0.0.0-react18-20231120182601

package/lib/components/SidebarActions/SidebarActions.js

@@ -0,0 +1,38 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SidebarActions = exports.LayoutVariant = void 0;
+const react_1 = __importDefault(require("react"));
+const ChangeViewButton_1 = require("../../components/SidebarActions/ChangeViewButton");
+const ToggleRightPanelButton_1 = require("../../components/SidebarActions/ToggleRightPanelButton");
+const CollapseSidebarButton_1 = require("../../components/SidebarActions/CollapseSidebarButton");
+const styled_1 = require("../../components/SidebarActions/styled");
+const telemetry_1 = require("../../mocks/telemetry");
+var LayoutVariant;
+(function (LayoutVariant) {
+    LayoutVariant["STACKED"] = "stacked";
+    LayoutVariant["THREE_PANEL"] = "three-panel";
+})(LayoutVariant || (exports.LayoutVariant = LayoutVariant = {}));
+const SidebarActions = ({ showChangeLayoutButton, showRightPanelToggle, layout, initialShowRightPanelToggle, hideCollapseSidebarButton = false, collapsedSidebar, isOpenapiDocs, onChangeRightPanelViewClick, onChangeViewClick, onChangeCollapseSidebarClick, requestAccessButton, className, }) => {
+    return (react_1.default.createElement(styled_1.ControlsWrap, { className: className, isOpenapiDocs: isOpenapiDocs, isCollapsed: collapsedSidebar, "data-component-name": "Sidebar/Actions" },
+        isOpenapiDocs && (react_1.default.createElement(styled_1.ControlsWrapChangeLayoutButtons, { isCollapsed: collapsedSidebar },
+            initialShowRightPanelToggle && (react_1.default.createElement(ToggleRightPanelButton_1.ToggleRightPanelButton, { showRightPanelToggle: showRightPanelToggle, onClick: () => {
+                    onChangeRightPanelViewClick();
+                    telemetry_1.telemetry.send('sidebar_samples_button_clicked', {});
+                } })),
+            showChangeLayoutButton && showRightPanelToggle && (react_1.default.createElement(ChangeViewButton_1.ChangeViewButton, { layout: layout, onClick: () => {
+                    onChangeViewClick();
+                    telemetry_1.telemetry.send('change_layout_button_clicked', {});
+                } })))),
+        !collapsedSidebar && requestAccessButton,
+        !hideCollapseSidebarButton && (react_1.default.createElement(CollapseSidebarButton_1.CollapseSidebarButton, { initialValue: collapsedSidebar, onClick: () => {
+                onChangeCollapseSidebarClick();
+                collapsedSidebar
+                    ? telemetry_1.telemetry.send('sidebar_item_expanded', {})
+                    : telemetry_1.telemetry.send('sidebar_item_collapsed', {});
+            } }))));
+};
+exports.SidebarActions = SidebarActions;
+//# sourceMappingURL=SidebarActions.js.map

package/lib/components/SidebarActions/ToggleRightPanelButton.d.ts

@@ -0,0 +1,7 @@
+/// <reference types="react" />
+interface ToggleRightPanelButtonProps {
+    showRightPanelToggle: boolean;
+    onClick: () => void;
+}
+export declare const ToggleRightPanelButton: ({ showRightPanelToggle, onClick, }: ToggleRightPanelButtonProps) => JSX.Element;
+export {};

package/lib/components/SidebarActions/ToggleRightPanelButton.js

@@ -0,0 +1,13 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToggleRightPanelButton = void 0;
+const react_1 = __importDefault(require("react"));
+const styled_1 = require("../../components/SidebarActions/styled");
+const ToggleRightPanelButton = ({ showRightPanelToggle, onClick, }) => {
+    return (react_1.default.createElement(styled_1.StyledToggleRightPanelButton, { title: showRightPanelToggle ? 'Hide samples' : 'Show samples', onClick: onClick }, showRightPanelToggle ? react_1.default.createElement(styled_1.HideRightPanelSVG, null) : react_1.default.createElement(styled_1.ShowRightPanelSVG, null)));
+};
+exports.ToggleRightPanelButton = ToggleRightPanelButton;
+//# sourceMappingURL=ToggleRightPanelButton.js.map

package/lib/components/SidebarActions/index.d.ts

@@ -0,0 +1,4 @@
+export { SidebarActions, LayoutVariant } from '../../components/SidebarActions/SidebarActions';
+export * from '../../components/SidebarActions/CollapseSidebarButton';
+export * from '../../components/SidebarActions/ToggleRightPanelButton';
+export * from '../../components/SidebarActions/ChangeViewButton';

package/lib/components/SidebarActions/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LayoutVariant = exports.SidebarActions = void 0;
+var SidebarActions_1 = require("../../components/SidebarActions/SidebarActions");
+Object.defineProperty(exports, "SidebarActions", { enumerable: true, get: function () { return SidebarActions_1.SidebarActions; } });
+Object.defineProperty(exports, "LayoutVariant", { enumerable: true, get: function () { return SidebarActions_1.LayoutVariant; } });
+__exportStar(require("../../components/SidebarActions/CollapseSidebarButton"), exports);
+__exportStar(require("../../components/SidebarActions/ToggleRightPanelButton"), exports);
+__exportStar(require("../../components/SidebarActions/ChangeViewButton"), exports);
+//# sourceMappingURL=index.js.map

package/lib/components/SidebarActions/styled.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+export declare const ShowLeftPanelSVG: import("styled-components").StyledComponent<() => React.JSX.Element, any, {}, never>;
+export declare const HideLeftPanelSVG: import("styled-components").StyledComponent<() => React.JSX.Element, any, {}, never>;
+export declare const StyledToggleRightPanelButton: import("styled-components").StyledComponent<"a", any, {}, never>;
+export declare const HideRightPanelSVG: import("styled-components").StyledComponent<() => React.JSX.Element, any, {}, never>;
+export declare const ShowRightPanelSVG: import("styled-components").StyledComponent<() => React.JSX.Element, any, {}, never>;
+export declare const StyledChangeViewButton: import("styled-components").StyledComponent<"a", any, {}, never>;
+export declare const ChangeViewSvgRow: import("styled-components").StyledComponent<() => React.JSX.Element, any, {}, never>;
+export declare const ChangeViewSvgColumn: import("styled-components").StyledComponent<() => React.JSX.Element, any, {}, never>;
+export declare const ControlsWrap: import("styled-components").StyledComponent<"span", any, {
+    iconCount?: number | undefined;
+    isCollapsed?: boolean | undefined;
+    isOpenapiDocs?: boolean | undefined;
+}, never>;
+export declare const ControlsWrapChangeLayoutButtons: import("styled-components").StyledComponent<"span", any, {
+    isCollapsed?: boolean | undefined;
+}, never>;

package/lib/components/SidebarActions/styled.js

@@ -0,0 +1,132 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ControlsWrapChangeLayoutButtons = exports.ControlsWrap = exports.ChangeViewSvgColumn = exports.ChangeViewSvgRow = exports.StyledChangeViewButton = exports.ShowRightPanelSVG = exports.HideRightPanelSVG = exports.StyledToggleRightPanelButton = exports.HideLeftPanelSVG = exports.ShowLeftPanelSVG = void 0;
+const react_1 = __importDefault(require("react"));
+const styled_components_1 = __importStar(require("styled-components"));
+exports.ShowLeftPanelSVG = (0, styled_components_1.default)(() => (react_1.default.createElement("svg", { width: "14", height: "14", viewBox: "0 0 14 14", fill: "none", xmlns: "http://www.w3.org/2000/svg" },
+    react_1.default.createElement("path", { d: "M4.375 7L8.75 2.625L9.3625 3.2375L5.6 7L9.3625 10.7625L8.75 11.375L4.375 7Z", fill: "var(--text-secondary)" })))) `
+  position: absolute;
+`;
+exports.HideLeftPanelSVG = (0, styled_components_1.default)(() => (react_1.default.createElement("svg", { width: "14", height: "14", viewBox: "0 0 14 14", fill: "none", xmlns: "http://www.w3.org/2000/svg" },
+    react_1.default.createElement("path", { d: "M9.62495 7L5.24995 11.375L4.63745 10.7625L8.39995 7L4.63745 3.2375L5.24995 2.625L9.62495 7Z", fill: "var(--text-secondary)" })))) `
+  position: absolute;
+`;
+exports.StyledToggleRightPanelButton = styled_components_1.default.a `
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  cursor: pointer;
+  z-index: 1;
+  /* Rectangle 201 */
+  border-radius: var(--border-radius-md);
+  padding: var(--spacing-xs);
+  height: var(--control-height-base);
+  width: var(--control-height-base);
+  border: 1px solid var(--border-primary);
+
+  &:hover {
+    background-color: var(--sidebar-item-hover-background-color);
+  }
+`;
+exports.HideRightPanelSVG = (0, styled_components_1.default)(() => (react_1.default.createElement("svg", { width: "16", height: "16", viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg" },
+    react_1.default.createElement("path", { d: "M14 2H2C1.73478 2 1.48043 2.10536 1.29289 2.29289C1.10536 2.48043 1 2.73478 1 3V13C1 13.2652 1.10536 13.5196 1.29289 13.7071C1.48043 13.8946 1.73478 14 2 14H14C14.2652 14 14.5196 13.8946 14.7071 13.7071C14.8946 13.5196 15 13.2652 15 13V3C15 2.73478 14.8946 2.48043 14.7071 2.29289C14.5196 2.10536 14.2652 2 14 2V2ZM2 3H10V13H2V3Z", fill: "currentColor" })))) `
+  position: absolute;
+`;
+exports.ShowRightPanelSVG = (0, styled_components_1.default)(() => (react_1.default.createElement("svg", { width: "16", height: "16", viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg" },
+    react_1.default.createElement("path", { d: "M14 2H2C1.73478 2 1.48043 2.10536 1.29289 2.29289C1.10536 2.48043 1 2.73478 1 3V13C1 13.2652 1.10536 13.5196 1.29289 13.7071C1.48043 13.8946 1.73478 14 2 14H14C14.2652 14 14.5196 13.8946 14.7071 13.7071C14.8946 13.5196 15 13.2652 15 13V3C15 2.73478 14.8946 2.48043 14.7071 2.29289C14.5196 2.10536 14.2652 2 14 2V2ZM2 3H10V13H2V3ZM14 13H11V3H14V13Z", fill: "currentColor" })))) `
+  position: absolute;
+`;
+exports.StyledChangeViewButton = styled_components_1.default.a `
+  display: flex;
+  position: relative;
+  justify-content: center;
+  align-items: center;
+  cursor: pointer;
+  border-radius: var(--border-radius-md);
+  background: var(--bg-overlay);
+  z-index: 1;
+  /* Rectangle 201 */
+  padding: var(--spacing-xs);
+  height: var(--control-height-base);
+  width: var(--control-height-base);
+
+  &:hover {
+    background-color: var(--sidebar-item-hover-background-color);
+  }
+`;
+exports.ChangeViewSvgRow = (0, styled_components_1.default)(() => (react_1.default.createElement("svg", { width: "14", height: "14", viewBox: "0 0 14 14", fill: "none", xmlns: "http://www.w3.org/2000/svg" },
+    react_1.default.createElement("path", { d: "M1.75 2.625L12.25 2.625L12.25 1.75L1.75 1.75L1.75 2.625Z", fill: "currentColor" }),
+    react_1.default.createElement("path", { d: "M1.75 5.6875L12.25 5.6875L12.25 4.8125L1.75 4.8125L1.75 5.6875Z", fill: "currentColor" }),
+    react_1.default.createElement("path", { d: "M2.625 11.375L2.625 8.75L11.375 8.75L11.375 11.375L2.625 11.375ZM2.625 12.25L11.375 12.25C11.6071 12.25 11.8296 12.1578 11.9937 11.9937C12.1578 11.8296 12.25 11.6071 12.25 11.375L12.25 8.75C12.25 8.51794 12.1578 8.29538 11.9937 8.13128C11.8296 7.96719 11.6071 7.875 11.375 7.875L2.625 7.875C2.39294 7.875 2.17038 7.96719 2.00628 8.13128C1.84219 8.29538 1.75 8.51793 1.75 8.75L1.75 11.375C1.75 11.6071 1.84219 11.8296 2.00628 11.9937C2.17038 12.1578 2.39294 12.25 2.625 12.25Z", fill: "currentColor" })))) `
+  position: absolute;
+`;
+exports.ChangeViewSvgColumn = (0, styled_components_1.default)(() => (react_1.default.createElement("svg", { width: "14", height: "14", viewBox: "0 0 14 14", fill: "none", xmlns: "http://www.w3.org/2000/svg" },
+    react_1.default.createElement("path", { d: "M2.625 12.25L2.625 1.75L1.75 1.75L1.75 12.25L2.625 12.25Z", fill: "currentColor" }),
+    react_1.default.createElement("path", { d: "M5.6875 12.25L5.6875 1.75L4.8125 1.75L4.8125 12.25L5.6875 12.25Z", fill: "currentColor" }),
+    react_1.default.createElement("path", { d: "M11.375 11.375L8.75 11.375L8.75 2.625L11.375 2.625L11.375 11.375ZM12.25 11.375L12.25 2.625C12.25 2.39294 12.1578 2.17038 11.9937 2.00628C11.8296 1.84219 11.6071 1.75 11.375 1.75L8.75 1.75C8.51794 1.75 8.29538 1.84219 8.13128 2.00628C7.96719 2.17038 7.875 2.39294 7.875 2.625L7.875 11.375C7.875 11.6071 7.96719 11.8296 8.13128 11.9937C8.29538 12.1578 8.51794 12.25 8.75 12.25L11.375 12.25C11.6071 12.25 11.8296 12.1578 11.9937 11.9937C12.1578 11.8296 12.25 11.6071 12.25 11.375Z", fill: "currentColor" })))) `
+  position: absolute;
+`;
+exports.ControlsWrap = styled_components_1.default.span `
+  display: none;
+  justify-content: ${({ isOpenapiDocs }) => (isOpenapiDocs ? 'space-between' : 'flex-end')};
+  bottom: 0;
+  flex-direction: row;
+  gap: var(--spacing-xs);
+  align-items: center;
+  margin-left: var(--sidebar-controls-margin-left);
+  z-index: 2;
+  background: var(--sidebar-background-color);
+
+  ${({ isCollapsed }) => isCollapsed &&
+    (0, styled_components_1.css) `
+      flex-direction: column;
+      margin-left: 0;
+      gap: var(--sidebar-controls-collapsed-gap);
+      padding: var(--sidebar-controls-collapsed-padding-vertical)
+        var(--sidebar-controls-collapsed-padding-horizontal);
+    `}
+
+  ${({ theme }) => (0, styled_components_1.css) `
+    ${theme.mediaQueries[theme.showAtBreakpoint.sidebar]} {
+      display: flex;
+    }
+
+    ${theme.mediaQueries.print} {
+      display: none;
+    }
+  `}
+`;
+exports.ControlsWrapChangeLayoutButtons = styled_components_1.default.span `
+  display: flex;
+  bottom: 0;
+  flex-direction: ${({ isCollapsed }) => (isCollapsed ? 'column-reverse' : 'row')};
+  gap: ${({ isCollapsed }) => (isCollapsed ? '10px' : 'var(--spacing-xs)')};
+  align-items: center;
+`;
+//# sourceMappingURL=styled.js.map

package/lib/components/SidebarLogo/SidebarLogo.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="react" />
+export interface LogoProps {
+    imageUrl?: string;
+    href?: string;
+    altText?: string;
+    dataTestId?: string;
+    backgroundColor?: string;
+    className?: string;
+}
+export declare function SidebarLogo({ imageUrl, href, altText, backgroundColor, dataTestId, className, }?: LogoProps): JSX.Element | null;

package/lib/components/SidebarLogo/SidebarLogo.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SidebarLogo = void 0;
+const react_1 = __importDefault(require("react"));
+const styled_components_1 = __importDefault(require("styled-components"));
+function SidebarLogo({ imageUrl, href, altText, backgroundColor, dataTestId, className, } = {}) {
+    if (!imageUrl) {
+        return null;
+    }
+    const logo = react_1.default.createElement(LogoImgEl, { src: imageUrl, alt: altText || 'logo' });
+    return (react_1.default.createElement(LogoWrap, { "data-cy": dataTestId, style: { backgroundColor }, "data-component-name": "SidebarLogo/SidebarLogo", className: className }, href ? react_1.default.createElement(Link, { href: href }, logo) : logo));
+}
+exports.SidebarLogo = SidebarLogo;
+const LogoImgEl = styled_components_1.default.img `
+  max-height: var(--sidebar-logo-max-height);
+  max-width: var(--sidebar-logo-max-width);
+  padding: var(--sidebar-logo-padding);
+  width: 100%;
+  display: block;
+`;
+const LogoWrap = styled_components_1.default.div `
+  text-align: center;
+  line-height: 0;
+`;
+const Link = styled_components_1.default.a `
+  display: inline-block;
+`;
+//# sourceMappingURL=SidebarLogo.js.map

package/lib/components/SidebarLogo/index.d.ts

@@ -0,0 +1 @@
+export * from '../../components/SidebarLogo/SidebarLogo';

package/lib/components/SidebarLogo/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("../../components/SidebarLogo/SidebarLogo"), exports);
+//# sourceMappingURL=index.js.map

package/lib/components/TableOfContent/TableOfContent.d.ts

@@ -0,0 +1,9 @@
+/// <reference types="react" />
+import type { MdHeading } from '../../types/portal';
+interface TableOfContentProps {
+    headings?: Array<MdHeading | null> | null | undefined;
+    contentWrapper: HTMLDivElement | null;
+    className?: string;
+}
+export declare function TableOfContent(props: TableOfContentProps): JSX.Element | null;
+export {};

package/lib/components/TableOfContent/TableOfContent.js

@@ -0,0 +1,113 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TableOfContent = void 0;
+const React = __importStar(require("react"));
+const styled_components_1 = __importDefault(require("styled-components"));
+const useFullHeight_1 = require("../../hooks/useFullHeight");
+const useActiveHeading_1 = require("../../hooks/useActiveHeading");
+const useThemeConfig_1 = require("../../hooks/useThemeConfig");
+const hooks_1 = require("../../mocks/hooks");
+const utils_1 = require("../../components/TableOfContent/utils");
+const telemetry_1 = require("../../mocks/telemetry");
+function TableOfContent(props) {
+    const { headings, contentWrapper, className } = props;
+    const sidebar = React.useRef(null);
+    (0, useFullHeight_1.useFullHeight)(sidebar);
+    const { markdown: { toc = {} } = {} } = (0, useThemeConfig_1.useThemeConfig)();
+    const displayedHeadings = (0, utils_1.getDisplayedHeadings)(headings, toc.depth || 3);
+    const leastDepth = (0, utils_1.getLeastDepth)(displayedHeadings);
+    const activeHeadingId = (0, useActiveHeading_1.useActiveHeading)(contentWrapper, (0, utils_1.getDisplayedHeadingsIds)(displayedHeadings));
+    const { translate } = (0, hooks_1.useTranslate)();
+    if (toc === null || toc === void 0 ? void 0 : toc.hide) {
+        return null;
+    }
+    return (React.createElement(React.Fragment, null,
+        React.createElement(TableOfContentMenu, { "data-component-name": "TableOfContent/TableOfContent", className: className },
+            React.createElement(TableOfContentItems, { ref: sidebar },
+                displayedHeadings.length ? (React.createElement(TocHeader, { "data-translation-key": "theme.toc.header" }, translate('theme.toc.header', toc.header || 'On this page'))) : null,
+                displayedHeadings.map((heading, idx) => {
+                    if (!heading) {
+                        return null;
+                    }
+                    const href = '#' + heading.id;
+                    return (React.createElement(MenuItem, { key: href + idx, href: href, depth: heading.depth - leastDepth + 1 || 0, className: activeHeadingId === heading.id ? 'active' : '', dangerouslySetInnerHTML: { __html: heading.value || '' }, "data-cy": `toc-${heading.value}`, onClick: () => telemetry_1.telemetry.send('toc_item_clicked', {}) }));
+                })))));
+}
+exports.TableOfContent = TableOfContent;
+const TocHeader = styled_components_1.default.div `
+  font-family: var(--toc-heading-font-family);
+  font-size: var(--toc-heading-font-size);
+  font-weight: var(--toc-heading-font-weight);
+  padding: var(--toc-item-padding-vertical) var(--toc-item-padding-horizontal);
+  color: var(--toc-heading-text-color);
+  text-transform: var(--toc-heading-text-transform);
+`;
+const MenuItem = styled_components_1.default.a `
+  display: block;
+  color: var(--toc-item-text-color);
+  font-weight: var(--toc-item-font-weight);
+  background-color: var(--toc-item-background-color);
+  cursor: pointer;
+  font-size: var(--toc-item-font-size);
+  padding: var(--toc-item-padding-vertical) var(--toc-item-padding-horizontal);
+  padding-left: calc(var(--toc-item-nested-offset) * ${({ depth }) => depth});
+  transition: background-color 0.3s, color 0.3s;
+  text-decoration: none;
+  word-break: break-word;
+  font-family: var(--heading-font-family, var(--toc-item-font-family));
+
+  :hover,
+  &.active {
+    color: var(--toc-item-active-text-color);
+    background-color: var(--toc-item-active-background-color);
+    border-radius: var(--border-radius);
+  }
+
+  :empty {
+    padding: 0;
+  }
+`;
+const TableOfContentMenu = styled_components_1.default.aside `
+  background-color: var(--toc-background-color);
+  flex-shrink: 0;
+  display: none !important;
+
+  ${({ theme }) => theme.mediaQueries.medium} {
+    width: var(--toc-width);
+    display: block !important;
+  }
+`;
+const TableOfContentItems = styled_components_1.default.div `
+  position: sticky;
+  top: calc(var(--navbar-height) + var(--toc-offset-top));
+  max-height: calc(100vh - var(--navbar-height) - var(--toc-offset-top));
+  overflow-y: auto;
+  width: var(--toc-width);
+`;
+//# sourceMappingURL=TableOfContent.js.map

package/lib/components/TableOfContent/index.d.ts

@@ -0,0 +1,2 @@
+export * from '../../components/TableOfContent/TableOfContent';
+export * from '../../components/TableOfContent/styledVariables';

package/lib/components/TableOfContent/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("../../components/TableOfContent/TableOfContent"), exports);
+__exportStar(require("../../components/TableOfContent/styledVariables"), exports);
+//# sourceMappingURL=index.js.map

package/lib/components/TableOfContent/styledVariables.d.ts

@@ -0,0 +1 @@
+export declare const toc: import("styled-components").FlattenSimpleInterpolation;

package/lib/components/TableOfContent/styledVariables.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toc = void 0;
+const styled_components_1 = require("styled-components");
+exports.toc = (0, styled_components_1.css) `
+  /**
+    * @tokens TOC
+    * */
+
+  --toc-width: 240px;
+  --toc-background-color: transparent;
+
+  --toc-spacing-unit: var(--spacing-xs);
+  --toc-offset-top: var(--toc-spacing-unit);
+
+  /**
+     * @tokens TOC item typography
+     */
+  --toc-item-font-family: var(--font-family-base); // @presenter FontFamily
+  --toc-item-font-size: var(--font-size-sm); // @presenter FontSize
+
+  /**
+    * @tokens TOC item
+    */
+
+  --toc-item-text-color: var(--text-description); // @presenter Color
+  --toc-item-font-weight: var(--font-weight-regular); // @presenter FontWeight
+  --toc-item-active-text-color: var(--text-primary); // @presenter Color
+  --toc-item-background-color: transparent; // @presenter Color
+  --toc-item-active-background-color: var(--bg-overlay); // @presenter Color
+  --toc-item-nested-offset: calc(var(--toc-spacing-unit) * 2); // @presenter Spacing
+  --toc-item-padding-vertical: var(--toc-spacing-unit); // @presenter Spacing
+  --toc-item-padding-horizontal: calc(var(--toc-spacing-unit) * 2); // @presenter Spacing
+
+  /**
+    * @tokens TOC header
+    */
+
+  --toc-heading-font-size: var(--font-size-base); // @presenter FontSize
+  --toc-heading-font-family: var(--font-family-base); // @presenter FontFamily
+  --toc-heading-font-weight: var(--font-weight-bold); // @presenter FontWeight
+  --toc-heading-text-color: var(--text-primary); // @presenter Color
+  --toc-heading-text-transform: none; // @presenter TextTransform
+
+  // @tokens End
+`;
+//# sourceMappingURL=styledVariables.js.map

package/lib/components/TableOfContent/utils.d.ts

@@ -0,0 +1,4 @@
+import type { MdHeading } from '../../types/portal';
+export declare function getDisplayedHeadings(headings: Array<MdHeading | null> | null | undefined, tocDepth: number): Array<MdHeading | null>;
+export declare function getDisplayedHeadingsIds(headings: Array<MdHeading | null> | null | undefined): Array<string | undefined>;
+export declare function getLeastDepth(headings: Array<MdHeading | null> | null | undefined): number;

package/lib/components/TableOfContent/utils.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLeastDepth = exports.getDisplayedHeadingsIds = exports.getDisplayedHeadings = void 0;
+function getDisplayedHeadings(headings, tocDepth) {
+    if (!headings) {
+        return [];
+    }
+    return headings.filter((heading, idx) => {
+        if (!heading) {
+            return false;
+        }
+        if (idx === 0 && heading.depth === 1) {
+            return false;
+        }
+        return !(heading.depth && heading.depth > tocDepth);
+    });
+}
+exports.getDisplayedHeadings = getDisplayedHeadings;
+function getDisplayedHeadingsIds(headings) {
+    if (!headings) {
+        return [];
+    }
+    return headings.map((header) => header === null || header === void 0 ? void 0 : header.id);
+}
+exports.getDisplayedHeadingsIds = getDisplayedHeadingsIds;
+function getLeastDepth(headings) {
+    if (!headings || headings.length === 0) {
+        return 1;
+    }
+    let depth = null;
+    for (const heading of headings) {
+        if (!heading)
+            continue;
+        if (depth === null || depth > heading.depth) {
+            depth = heading.depth;
+        }
+    }
+    return depth !== null && depth !== void 0 ? depth : 1;
+}
+exports.getLeastDepth = getLeastDepth;
+//# sourceMappingURL=utils.js.map

package/lib/components/Tabs/Tab.d.ts

@@ -0,0 +1,9 @@
+/// <reference types="react" />
+type TabProps = {
+    activeTab: string;
+    label: string;
+    className?: string;
+    onClick: (e: string) => void;
+};
+export declare function Tab({ activeTab, label, onClick, className }: TabProps): JSX.Element;
+export {};

package/lib/components/Tabs/Tab.js

@@ -0,0 +1,58 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Tab = void 0;
+const react_1 = __importDefault(require("react"));
+const styled_components_1 = __importDefault(require("styled-components"));
+function Tab({ activeTab, label, onClick, className }) {
+    const isActive = activeTab === label;
+    return (react_1.default.createElement(TabItem, { active: isActive, onClick: () => onClick(label), "data-component-name": "Markdown/Tabs/Tab", className: className }, label));
+}
+exports.Tab = Tab;
+const TabItem = styled_components_1.default.li `
+  display: inline-block;
+  list-style: none;
+  cursor: pointer;
+
+  color: var(--md-tabs-tab-text-color);
+  font-size: var(--md-tabs-tab-font-size);
+  font-family: var(--md-tabs-tab-font-family);
+  font-style: var(--md-tabs-tab-font-style);
+  font-weight: var(--md-tabs-tab-font-weight);
+  background-color: var(--md-tabs-tab-background-color);
+  border-radius: var(--md-tabs-tab-border-radius);
+  padding: var(--md-tabs-tab-padding);
+  border: var(--md-tabs-tab-border);
+  border-width: var(--md-tabs-tab-border-width);
+
+  ${({ active }) => active
+    ? `      
+      color: var(--md-tabs-active-tab-text-color);
+      font-size: var(--md-tabs-active-tab-font-size);
+      font-family: var(--md-tabs-active-tab-font-family);
+      font-style: var(--md-tabs-active-tab-font-style);
+      font-weight: var(--md-tabs-active-tab-font-weight);
+      background-color: var(--md-tabs-active-tab-background-color);
+      border-radius: var(--md-tabs-active-tab-border-radius);
+      padding: var(--md-tabs-active-tab-padding);
+      border: solid var(--md-tabs-active-tab-border-color);
+      border-width: var(--md-tabs-active-tab-border-width);
+    `
+    : `
+    &:hover {
+      color: var(--md-tabs-hover-tab-text-color);
+      font-size: var(--md-tabs-hover-tab-font-size);
+      font-family: var(--md-tabs-hover-tab-font-family);
+      font-style: var(--md-tabs-hover-tab-font-style);
+      font-weight: var(--md-tabs-hover-tab-font-weight);
+      background-color: var(--md-tabs-hover-tab-background-color);
+      border-radius: var(--md-tabs-hover-tab-border-radius);
+      padding: var(--md-tabs-hover-tab-padding);
+      border: solid var(--md-tabs-hover-tab-border-color);
+      border-width: var(--md-tabs-hover-tab-border-width);
+    }
+  `}
+`;
+//# sourceMappingURL=Tab.js.map

package/lib/components/Tabs/Tabs.d.ts

@@ -0,0 +1,12 @@
+import type { PropsWithChildren } from 'react';
+type Child = {
+    props: {
+        label: string;
+    } & TabsProps;
+};
+type TabsProps = PropsWithChildren<{
+    children: Child[];
+    className?: string;
+}>;
+export declare function Tabs(props: TabsProps): JSX.Element;
+export {};