docusaurus-theme-openapi-docs 0.0.0-618 → 0.0.0-684

package/lib/theme/ApiLogo/index.js

@@ -1,49 +1,51 @@
 "use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = ApiLogo;
-var _react = _interopRequireDefault(require("react"));
-var _themeCommon = require("@docusaurus/theme-common");
-var _useBaseUrl = _interopRequireDefault(require("@docusaurus/useBaseUrl"));
-var _ThemedImage = _interopRequireDefault(require("@theme/ThemedImage"));
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 /* ============================================================================
  * Copyright (c) Palo Alto Networks
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  * ========================================================================== */
-
+var __importDefault =
+  (this && this.__importDefault) ||
+  function (mod) {
+    return mod && mod.__esModule ? mod : { default: mod };
+  };
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = __importDefault(require("react"));
+const theme_common_1 = require("@docusaurus/theme-common");
+const useBaseUrl_1 = __importDefault(require("@docusaurus/useBaseUrl"));
+const ThemedImage_1 = __importDefault(require("@theme/ThemedImage"));
 function ApiLogo(props) {
-  const {
-    colorMode
-  } = (0, _themeCommon.useColorMode)();
-  const {
-    logo,
-    darkLogo
-  } = props;
+  const { colorMode } = (0, theme_common_1.useColorMode)();
+  const { logo, darkLogo } = props;
   const altText = () => {
     if (colorMode === "dark") {
-      var _darkLogo$altText;
-      return (_darkLogo$altText = darkLogo === null || darkLogo === void 0 ? void 0 : darkLogo.altText) !== null && _darkLogo$altText !== void 0 ? _darkLogo$altText : logo === null || logo === void 0 ? void 0 : logo.altText;
+      return darkLogo?.altText ?? logo?.altText;
     }
-    return logo === null || logo === void 0 ? void 0 : logo.altText;
+    return logo?.altText;
   };
-  const lightLogoUrl = (0, _useBaseUrl.default)(logo === null || logo === void 0 ? void 0 : logo.url);
-  const darkLogoUrl = (0, _useBaseUrl.default)(darkLogo === null || darkLogo === void 0 ? void 0 : darkLogo.url);
+  const lightLogoUrl = (0, useBaseUrl_1.default)(logo?.url);
+  const darkLogoUrl = (0, useBaseUrl_1.default)(darkLogo?.url);
   if (logo && darkLogo) {
-    return <_ThemedImage.default alt={altText()} sources={{
-      light: lightLogoUrl,
-      dark: darkLogoUrl
-    }} className="openapi__logo" />;
+    return react_1.default.createElement(ThemedImage_1.default, {
+      alt: altText(),
+      sources: {
+        light: lightLogoUrl,
+        dark: darkLogoUrl,
+      },
+      className: "openapi__logo",
+    });
   }
   if (logo || darkLogo) {
-    return <_ThemedImage.default alt={altText()} sources={{
-      light: lightLogoUrl !== null && lightLogoUrl !== void 0 ? lightLogoUrl : darkLogoUrl,
-      dark: lightLogoUrl !== null && lightLogoUrl !== void 0 ? lightLogoUrl : darkLogoUrl
-    }} className="openapi__logo" />;
+    return react_1.default.createElement(ThemedImage_1.default, {
+      alt: altText(),
+      sources: {
+        light: lightLogoUrl ?? darkLogoUrl,
+        dark: lightLogoUrl ?? darkLogoUrl,
+      },
+      className: "openapi__logo",
+    });
   }
   return undefined;
-}
+}
+exports.default = ApiLogo;

package/lib/theme/ApiTabs/_ApiTabs.scss

@@ -0,0 +1,140 @@
+/* ============================================================================
+ * Copyright (c) Palo Alto Networks
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ * ========================================================================== */
+.openapi-tabs__container {
+  margin-left: -1px;
+  margin-bottom: var(--ifm-leading);
+}
+
+.openapi-tabs__response-header {
+  margin-bottom: 0;
+}
+
+.openapi-tabs__response-code-item {
+  border: 1px solid transparent;
+  margin-top: 0 !important;
+  margin-right: 0.5rem;
+  padding: 0.35rem 0.85rem;
+  border-radius: var(--ifm-global-radius);
+  font-weight: var(--ifm-font-weight-bold);
+  font-size: 12px;
+  transition: 300ms;
+  color: var(--ifm-font-color-secondary);
+
+  &.success.active {
+    background-color: var(--ifm-color-success);
+    color: var(--ifm-color-white);
+  }
+
+  &.danger.active {
+    background-color: var(--ifm-color-danger);
+    color: var(--ifm-color-white);
+  }
+
+  &.info.active {
+    background-color: var(--ifm-color-info);
+    color: var(--ifm-color-white);
+  }
+
+  &.active,
+  &:hover {
+    opacity: 1;
+  }
+
+  &:hover:not(.active) {
+    background-color: transparent;
+    border: 1px solid var(--ifm-toc-border-color);
+  }
+}
+
+.openapi-tabs__response-code-item:not(.active) {
+  opacity: 0.65;
+}
+
+.openapi-tabs__response-code-item:hover {
+  opacity: 1;
+}
+
+.openapi-tabs__response-code-item:last-child {
+  margin-right: 0 !important;
+}
+
+/* Open API Response Code Tabs */
+.openapi-tabs__response-header-section {
+  border-top: 1px solid var(--ifm-toc-border-color);
+  margin-top: 2rem;
+  padding-top: 2rem;
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+}
+
+.openapi-tabs__response-container {
+  display: flex;
+  align-items: center;
+  max-width: 390px;
+  padding-left: 1rem;
+  overflow: hidden;
+}
+
+.openapi-tabs__response-list-container {
+  padding: 0 0.25rem;
+  overflow-y: hidden;
+  overflow-x: scroll;
+  scroll-behavior: smooth;
+}
+
+.openapi-tabs__response-list-container::-webkit-scrollbar {
+  display: none;
+}
+
+/* Response Code Tabs - Colored Dots */
+.openapi-tabs__response-dot {
+  width: 12.5px;
+  height: 12.5px;
+  margin-right: 5px;
+  border-radius: 50%;
+}
+
+.openapi-tabs__response-schema-container {
+  max-width: 600px;
+}
+
+/* Tab Arrows */
+.openapi-tabs__arrow {
+  content: "";
+  height: 1.25rem;
+  width: 1.25rem;
+  border: none;
+  min-width: 1.25rem;
+  background: var(--ifm-menu-link-sublist-icon) 50% / 2rem 2rem;
+  filter: var(--ifm-menu-link-sublist-icon-filter);
+
+  &:hover {
+    cursor: pointer;
+  }
+
+  &.left {
+    transform: rotate(270deg);
+  }
+
+  &.right {
+    transform: rotate(90deg);
+  }
+}
+
+@media screen and (max-width: 500px) {
+  .openapi-tabs__response-header-section {
+    flex-direction: column;
+    align-items: flex-start;
+  }
+
+  .openapi-tabs__response-container {
+    width: 100%;
+    margin-top: var(--ifm-spacing-vertical);
+    padding: 0;
+  }
+}

package/lib/theme/ApiTabs/index.js

@@ -5,141 +5,51 @@
  * LICENSE file in the root directory of this source tree.
  * ========================================================================== */
 
-import React, {
-  Children,
-  cloneElement,
-  isValidElement,
-  useEffect,
-  useRef,
-  useState,
-} from "react";
+import React, { cloneElement, useRef, useState, useEffect } from "react";
 
-import { duplicates } from "@docusaurus/theme-common";
+import {
+  useScrollPositionBlocker,
+  useTabs,
+} from "@docusaurus/theme-common/internal";
 import useIsBrowser from "@docusaurus/useIsBrowser";
+import Heading from "@theme/Heading";
 import clsx from "clsx";
 
-import styles from "./styles.module.css"; // A very rough duck type, but good enough to guard against mistakes while
-
-const {
-  useScrollPositionBlocker,
-  useTabGroupChoice,
-} = require("@docusaurus/theme-common/internal");
-
-// allowing customization
-
-function isTabItem(comp) {
-  return typeof comp.props.value !== "undefined";
-}
-
-function ApiTabsComponent(props) {
-  const {
-    lazy,
-    block,
-    defaultValue: defaultValueProp,
-    values: valuesProp,
-    groupId,
-    className,
-  } = props;
-  const children = Children.map(props.children, (child) => {
-    if (isValidElement(child) && isTabItem(child)) {
-      return child;
-    } // child.type.name will give non-sensical values in prod because of
-    // minification, but we assume it won't throw in prod.
-
-    throw new Error(
-      `Docusaurus error: Bad <Tabs> child <${
-        // @ts-expect-error: guarding against unexpected cases
-        typeof child.type === "string" ? child.type : child.type.name
-      }>: all children of the <Tabs> component should be <TabItem>, and every <TabItem> should have a unique "value" prop.`
-    );
-  });
-  const values =
-    valuesProp ?? // We only pick keys that we recognize. MDX would inject some keys by default
-    children.map(({ props: { value, label, attributes } }) => ({
-      value,
-      label,
-      attributes,
-    }));
-  const dup = duplicates(values, (a, b) => a.value === b.value);
-
-  if (dup.length > 0) {
-    throw new Error(
-      `Docusaurus error: Duplicate values "${dup
-        .map((a) => a.value)
-        .join(", ")}" found in <Tabs>. Every value needs to be unique.`
-    );
-  } // When defaultValueProp is null, don't show a default tab
-
-  const defaultValue =
-    defaultValueProp === null
-      ? defaultValueProp
-      : defaultValueProp ??
-        children.find((child) => child.props.default)?.props.value ??
-        children[0]?.props.value;
-
-  if (defaultValue !== null && !values.some((a) => a.value === defaultValue)) {
-    throw new Error(
-      `Docusaurus error: The <Tabs> has a defaultValue "${defaultValue}" but none of its children has the corresponding value. Available values are: ${values
-        .map((a) => a.value)
-        .join(
-          ", "
-        )}. If you intend to show no default tab, use defaultValue={null} instead.`
-    );
-  }
-
-  const { tabGroupChoices, setTabGroupChoices } = useTabGroupChoice();
-  const [selectedValue, setSelectedValue] = useState(defaultValue);
+function TabList({ className, block, selectedValue, selectValue, tabValues }) {
   const tabRefs = [];
   const { blockElementScrollPositionUntilNextRender } =
     useScrollPositionBlocker();
 
-  if (groupId != null) {
-    const relevantTabGroupChoice = tabGroupChoices[groupId];
-
-    if (
-      relevantTabGroupChoice != null &&
-      relevantTabGroupChoice !== selectedValue &&
-      values.some((value) => value.value === relevantTabGroupChoice)
-    ) {
-      setSelectedValue(relevantTabGroupChoice);
-    }
-  }
-
   const handleTabChange = (event) => {
     const newTab = event.currentTarget;
     const newTabIndex = tabRefs.indexOf(newTab);
-    const newTabValue = values[newTabIndex].value;
-
+    const newTabValue = tabValues[newTabIndex].value;
     if (newTabValue !== selectedValue) {
       blockElementScrollPositionUntilNextRender(newTab);
-      setSelectedValue(newTabValue);
-
-      if (groupId != null) {
-        setTabGroupChoices(groupId, newTabValue);
-      }
+      selectValue(newTabValue);
     }
   };
 
   const handleKeydown = (event) => {
     let focusElement = null;
-
     switch (event.key) {
+      case "Enter": {
+        handleTabChange(event);
+        break;
+      }
       case "ArrowRight": {
         const nextTab = tabRefs.indexOf(event.currentTarget) + 1;
-        focusElement = tabRefs[nextTab] || tabRefs[0];
+        focusElement = tabRefs[nextTab] ?? tabRefs[0];
         break;
       }
-
       case "ArrowLeft": {
         const prevTab = tabRefs.indexOf(event.currentTarget) - 1;
-        focusElement = tabRefs[prevTab] || tabRefs[tabRefs.length - 1];
+        focusElement = tabRefs[prevTab] ?? tabRefs[tabRefs.length - 1];
         break;
       }
-
       default:
         break;
     }
-
     focusElement?.focus();
   };
 
@@ -173,102 +83,107 @@ function ApiTabsComponent(props) {
   };
 
   return (
-    <div className="tabs__container">
-      <div className={styles.responseTabsTopSection}>
-        <strong>Responses</strong>
-        <div className={styles.responseTabsContainer}>
-          {showTabArrows && (
-            <button
-              className={clsx(styles.tabArrow, styles.tabArrowLeft)}
-              onClick={handleLeftClick}
-            />
+    <div className="openapi-tabs__response-header-section">
+      <Heading as="h2" id="responses" className="openapi-tabs__response-header">
+        Responses
+      </Heading>
+      <div className="openapi-tabs__response-container">
+        {showTabArrows && (
+          <button
+            className="openapi-tabs__arrow left"
+            onClick={handleLeftClick}
+          />
+        )}
+        <ul
+          ref={tabItemListContainerRef}
+          role="tablist"
+          aria-orientation="horizontal"
+          className={clsx(
+            "openapi-tabs__response-list-container",
+            "tabs",
+            {
+              "tabs--block": block,
+            },
+            className
           )}
-          <ul
-            ref={tabItemListContainerRef}
-            role="tablist"
-            aria-orientation="horizontal"
-            className={clsx(
-              styles.responseTabsListContainer,
-              "tabs",
-              {
-                "tabs--block": block,
-              },
-              className
-            )}
-          >
-            {values.map(({ value, label, attributes }) => {
-              const responseStatusStyle =
+        >
+          {tabValues.map(({ value, label, attributes }) => (
+            <li
+              // TODO extract TabListItem
+              role="tab"
+              tabIndex={selectedValue === value ? 0 : -1}
+              aria-selected={selectedValue === value}
+              key={value}
+              ref={(tabControl) => tabRefs.push(tabControl)}
+              onKeyDown={handleKeydown}
+              onClick={handleTabChange}
+              {...attributes}
+              className={clsx(
+                "tabs__item",
+                "openapi-tabs__response-code-item",
+                attributes?.className,
                 parseInt(value) >= 400
-                  ? styles.responseStatusDanger
+                  ? "danger"
                   : parseInt(value) >= 200 && parseInt(value) < 300
-                  ? styles.responseStatusSuccess
-                  : styles.responseStatusInfo;
-
-              return (
-                <li
-                  role="tab"
-                  tabIndex={selectedValue === value ? 0 : -1}
-                  aria-selected={selectedValue === value}
-                  key={value}
-                  ref={(tabControl) => tabRefs.push(tabControl)}
-                  onKeyDown={handleKeydown}
-                  onFocus={handleTabChange}
-                  onClick={handleTabChange}
-                  {...attributes}
-                  className={clsx(
-                    "tabs__item",
-                    styles.tabItem,
-                    attributes?.className,
-                    responseStatusStyle,
-                    {
-                      [styles.active]: selectedValue === value,
-                    }
-                  )}
-                >
-                  <div className={styles.responseTabDot} />
-                  {label ?? value}
-                </li>
-              );
-            })}
-          </ul>
-          {showTabArrows && (
-            <button
-              className={clsx(styles.tabArrow, styles.tabArrowRight)}
-              onClick={handleRightClick}
-            />
-          )}
-        </div>
+                  ? "success"
+                  : "info",
+                {
+                  active: selectedValue === value,
+                }
+              )}
+            >
+              {label ?? value}
+            </li>
+          ))}
+        </ul>
+        {showTabArrows && (
+          <button
+            className="openapi-tabs__arrow right"
+            onClick={handleRightClick}
+          />
+        )}
       </div>
-      <hr />
-      {lazy ? (
-        cloneElement(
-          children.filter(
-            (tabItem) => tabItem.props.value === selectedValue
-          )[0],
-          {
-            className: clsx("margin-vert--md", styles.responseSchemaContainer),
-          }
-        )
-      ) : (
-        <div
-          className={clsx("margin-vert--md", styles.responseSchemaContainer)}
-        >
-          {children.map((tabItem, i) =>
-            cloneElement(tabItem, {
-              key: i,
-              hidden: tabItem.props.value !== selectedValue,
-            })
-          )}
-        </div>
+    </div>
+  );
+}
+function TabContent({ lazy, children, selectedValue }) {
+  // eslint-disable-next-line no-param-reassign
+  children = Array.isArray(children) ? children : [children];
+  if (lazy) {
+    const selectedTabItem = children.find(
+      (tabItem) => tabItem.props.value === selectedValue
+    );
+    if (!selectedTabItem) {
+      // fail-safe or fail-fast? not sure what's best here
+      return null;
+    }
+    return cloneElement(selectedTabItem, { className: "margin-top--md" });
+  }
+  return (
+    <div className="margin-top--md">
+      {children.map((tabItem, i) =>
+        cloneElement(tabItem, {
+          key: i,
+          hidden: tabItem.props.value !== selectedValue,
+        })
       )}
     </div>
   );
 }
-
+function TabsComponent(props) {
+  const tabs = useTabs(props);
+  return (
+    <div className="openapi-tabs__container">
+      <TabList {...props} {...tabs} />
+      <TabContent {...props} {...tabs} />
+    </div>
+  );
+}
 export default function ApiTabs(props) {
   const isBrowser = useIsBrowser();
   return (
-    <ApiTabsComponent // Remount tabs after hydration
+    <TabsComponent
+      // Remount tabs after hydration
       // Temporary fix for https://github.com/facebook/docusaurus/issues/5653
       key={String(isBrowser)}
       {...props}

package/lib/theme/DiscriminatorTabs/_DiscriminatorTabs.scss

@@ -0,0 +1,97 @@
+/* ============================================================================
+ * Copyright (c) Palo Alto Networks
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ * ========================================================================== */
+.openapi-tabs__discriminator-item {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 0.35rem 0.7rem;
+  border: 1px solid transparent;
+  margin-top: 0 !important;
+  margin-right: 0.5rem;
+  font-weight: var(--ifm-font-weight-bold);
+  font-size: 10px;
+  font-family: var(--ifm-font-family-monospace);
+  white-space: nowrap;
+  transition: 300ms;
+
+  &:hover {
+    background-color: transparent;
+    border: 1px solid var(--ifm-toc-border-color);
+  }
+
+  &.active {
+    border: 1px solid var(--ifm-color-primary);
+    color: var(--ifm-color-primary);
+  }
+
+  &:last-child {
+    margin-right: 0 !important;
+  }
+}
+
+/* Open API Discriminator Tabs */
+.openapi-tabs__discriminator-top-section {
+  margin-top: 1rem;
+  margin-left: 0.9rem;
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+}
+
+.openapi-tabs__discriminator-top-section + hr {
+  display: none;
+}
+
+.openapi-tabs__discriminator-container {
+  display: flex;
+  align-items: center;
+  max-width: 600px;
+  padding-left: 3px;
+  overflow: hidden;
+}
+
+.openapi-tabs__discriminator-list-container {
+  padding: 0 0.25rem;
+  overflow-y: hidden;
+  overflow-x: scroll;
+  scroll-behavior: smooth;
+}
+
+.openapi-tabs__discriminator-list-container::-webkit-scrollbar {
+  display: none;
+}
+
+.openapi-tabs__discriminator-tab-label {
+  white-space: nowrap;
+}
+
+.openapi-discriminator__item {
+  list-style: none;
+  position: relative;
+  margin: 0 !important;
+  padding: 5px 0 5px 0 !important;
+  border-left: thin solid var(--openapi-tree-line-color) !important;
+}
+
+.openapi-discriminator__name {
+  padding-left: 1rem;
+}
+
+@media screen and (max-width: 500px) {
+  .openapi-tabs__discriminator-top-section {
+    flex-direction: column;
+    align-items: flex-start;
+  }
+
+  .openapi-tabs__discriminator-container {
+    width: 100%;
+  }
+
+  .openapi-tabs__discriminator-item {
+    height: 100%;
+  }
+}