docusaurus-theme-openapi-docs 2.1.3 → 3.0.0-beta.10

package/lib/markdown/utils.d.ts

@@ -1,4 +1,5 @@
-export type Children = string | undefined | (string | undefined)[];
+import { ReactNode } from "react";
+export type Children = ReactNode | string | undefined | (string | undefined)[];
 export type Props = Record<string, any> & {
     children?: Children;
 };

package/lib/theme/ApiDemoPanel/ApiCodeBlock/ExpandButton/index.d.ts

@@ -0,0 +1,13 @@
+import React from "react";
+import { type Language } from "prism-react-renderer";
+interface Props {
+    code: string;
+    className: string;
+    language: Language;
+    showLineNumbers: boolean;
+    blockClassName: string;
+    title: string;
+    lineClassNames: string[];
+}
+export default function ExpandButton({ code, className, language, showLineNumbers, blockClassName, title, lineClassNames, }: Props): React.JSX.Element;
+export {};

package/lib/theme/ApiDemoPanel/ApiCodeBlock/ExpandButton/index.js

@@ -1,23 +1,81 @@
+"use strict";
 /* ============================================================================
  * 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.
  * ========================================================================== */
-
-import React, { useEffect } from "react";
-
-import { usePrismTheme } from "@docusaurus/theme-common";
-import { translate } from "@docusaurus/Translate";
-import Container from "@theme/ApiDemoPanel/ApiCodeBlock/Container";
-import CopyButton from "@theme/ApiDemoPanel/ApiCodeBlock/CopyButton";
-import ExitButton from "@theme/ApiDemoPanel/ApiCodeBlock/ExitButton";
-import Line from "@theme/ApiDemoPanel/ApiCodeBlock/Line";
-import clsx from "clsx";
-import Highlight, { defaultProps } from "prism-react-renderer";
-import Modal from "react-modal";
-
-export default function ExpandButton({
+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 });
+const react_1 = __importStar(require("react"));
+const theme_common_1 = require("@docusaurus/theme-common");
+const Translate_1 = require("@docusaurus/Translate");
+// @ts-ignore
+const Container_1 = __importDefault(
+  require("@theme/ApiExplorer/ApiCodeBlock/Container")
+);
+// @ts-ignore
+const CopyButton_1 = __importDefault(
+  require("@theme/ApiExplorer/ApiCodeBlock/CopyButton")
+);
+// @ts-ignore
+const ExitButton_1 = __importDefault(
+  require("@theme/ApiExplorer/ApiCodeBlock/ExitButton")
+);
+// @ts-ignore
+const Line_1 = __importDefault(require("@theme/ApiExplorer/ApiCodeBlock/Line"));
+const clsx_1 = __importDefault(require("clsx"));
+const prism_react_renderer_1 = require("prism-react-renderer");
+const react_modal_1 = __importDefault(require("react-modal"));
+function ExpandButton({
   code,
   className,
   language,
@@ -26,140 +84,157 @@ export default function ExpandButton({
   title,
   lineClassNames,
 }) {
-  const prismTheme = usePrismTheme();
-
+  const prismTheme = (0, theme_common_1.usePrismTheme)();
   function openModal() {
     setIsOpen(true);
   }
-
   function closeModal() {
     setIsOpen(false);
   }
-
-  const [modalIsOpen, setIsOpen] = React.useState(false);
-
-  useEffect(() => {
-    Modal.setAppElement("body");
+  const [modalIsOpen, setIsOpen] = react_1.default.useState(false);
+  (0, react_1.useEffect)(() => {
+    react_modal_1.default.setAppElement("body");
   });
-
-  return (
-    <>
-      <button
-        type="button"
-        aria-label={
-          modalIsOpen
-            ? translate({
-                id: "theme.CodeBlock.expanded",
-                message: "Expanded",
-                description: "The expanded button label on code blocks",
-              })
-            : translate({
-                id: "theme.CodeBlock.expandButtonAriaLabel",
-                message: "Expand code to fullscreen",
-                description: "The ARIA label for expand code blocks button",
-              })
-        }
-        title={translate({
+  return react_1.default.createElement(
+    react_1.default.Fragment,
+    null,
+    react_1.default.createElement(
+      "button",
+      {
+        type: "button",
+        "aria-label": modalIsOpen
+          ? (0, Translate_1.translate)({
+              id: "theme.CodeBlock.expanded",
+              message: "Expanded",
+              description: "The expanded button label on code blocks",
+            })
+          : (0, Translate_1.translate)({
+              id: "theme.CodeBlock.expandButtonAriaLabel",
+              message: "Expand code to fullscreen",
+              description: "The ARIA label for expand code blocks button",
+            }),
+        title: (0, Translate_1.translate)({
           id: "theme.CodeBlock.expand",
           message: "Expand",
           description: "The expand button label on code blocks",
-        })}
-        className={clsx(
+        }),
+        className: (0, clsx_1.default)(
           "clean-btn",
           className,
           "openapi-explorer__code-block-expand-btn",
           modalIsOpen && "openapi-explorer__code-block-expand-btn--copied"
-        )}
-        onClick={openModal}
-      >
-        <span
-          className="openapi-explorer__code-block-expand-btn-icons"
-          aria-hidden="true"
-        >
-          <svg
-            className="openapi-explorer__code-block-expand-btn-icon"
-            viewBox="0 0 448 512"
-          >
-            <path d="M32 32C14.3 32 0 46.3 0 64v96c0 17.7 14.3 32 32 32s32-14.3 32-32V96h64c17.7 0 32-14.3 32-32s-14.3-32-32-32H32zM64 352c0-17.7-14.3-32-32-32s-32 14.3-32 32v96c0 17.7 14.3 32 32 32h96c17.7 0 32-14.3 32-32s-14.3-32-32-32H64V352zM320 32c-17.7 0-32 14.3-32 32s14.3 32 32 32h64v64c0 17.7 14.3 32 32 32s32-14.3 32-32V64c0-17.7-14.3-32-32-32H320zM448 352c0-17.7-14.3-32-32-32s-32 14.3-32 32v64H320c-17.7 0-32 14.3-32 32s14.3 32 32 32h96c17.7 0 32-14.3 32-32V352z" />
-          </svg>
-          <svg
-            className="openapi-explorer__code-block-expand-btn-icon--success"
-            viewBox="0 0 24 24"
-          >
-            <path d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z" />
-          </svg>
-        </span>
-      </button>
-      <Modal
-        className="openapi-explorer__expand-modal-content"
-        overlayClassName="openapi-explorer__expand-modal-overlay"
-        isOpen={modalIsOpen}
-        onRequestClose={closeModal}
-        contentLabel="Code Snippet"
-      >
-        <Container
-          as="div"
-          className={clsx(
+        ),
+        onClick: openModal,
+      },
+      react_1.default.createElement(
+        "span",
+        {
+          className: "openapi-explorer__code-block-expand-btn-icons",
+          "aria-hidden": "true",
+        },
+        react_1.default.createElement(
+          "svg",
+          {
+            className: "openapi-explorer__code-block-expand-btn-icon",
+            viewBox: "0 0 448 512",
+          },
+          react_1.default.createElement("path", {
+            d: "M32 32C14.3 32 0 46.3 0 64v96c0 17.7 14.3 32 32 32s32-14.3 32-32V96h64c17.7 0 32-14.3 32-32s-14.3-32-32-32H32zM64 352c0-17.7-14.3-32-32-32s-32 14.3-32 32v96c0 17.7 14.3 32 32 32h96c17.7 0 32-14.3 32-32s-14.3-32-32-32H64V352zM320 32c-17.7 0-32 14.3-32 32s14.3 32 32 32h64v64c0 17.7 14.3 32 32 32s32-14.3 32-32V64c0-17.7-14.3-32-32-32H320zM448 352c0-17.7-14.3-32-32-32s-32 14.3-32 32v64H320c-17.7 0-32 14.3-32 32s14.3 32 32 32h96c17.7 0 32-14.3 32-32V352z",
+          })
+        ),
+        react_1.default.createElement(
+          "svg",
+          {
+            className: "openapi-explorer__code-block-expand-btn-icon--success",
+            viewBox: "0 0 24 24",
+          },
+          react_1.default.createElement("path", {
+            d: "M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z",
+          })
+        )
+      )
+    ),
+    react_1.default.createElement(
+      react_modal_1.default,
+      {
+        className: "openapi-explorer__expand-modal-content",
+        overlayClassName: "openapi-explorer__expand-modal-overlay",
+        isOpen: modalIsOpen,
+        onRequestClose: closeModal,
+        contentLabel: "Code Snippet",
+      },
+      react_1.default.createElement(
+        Container_1.default,
+        {
+          as: "div",
+          className: (0, clsx_1.default)(
             "openapi-explorer__code-block-container",
             language &&
               !blockClassName.includes(`language-${language}`) &&
               `language-${language}`
-          )}
-        >
-          {title && (
-            <div className="openapi-explorer__code-block-title">{title}</div>
-          )}
-          <div className="openapi-explorer__code-block-content">
-            <Highlight
-              {...defaultProps}
-              theme={prismTheme}
-              code={code}
-              language={language ?? "text"}
-            >
-              {({ className, tokens, getLineProps, getTokenProps }) => (
-                <pre
+          ),
+        },
+        title &&
+          react_1.default.createElement(
+            "div",
+            { className: "openapi-explorer__code-block-title" },
+            title
+          ),
+        react_1.default.createElement(
+          "div",
+          { className: "openapi-explorer__code-block-content" },
+          react_1.default.createElement(
+            prism_react_renderer_1.Highlight,
+            { theme: prismTheme, code: code, language: language ?? "text" },
+            ({ className, tokens, getLineProps, getTokenProps }) =>
+              react_1.default.createElement(
+                "pre",
+                {
                   /* eslint-disable-next-line jsx-a11y/no-noninteractive-tabindex */
-                  tabIndex={0}
-                  className={clsx(
+                  tabIndex: 0,
+                  className: (0, clsx_1.default)(
                     className,
                     "openapi-explorer__code-block",
                     "thin-scrollbar"
-                  )}
-                >
-                  <code
-                    className={clsx(
+                  ),
+                },
+                react_1.default.createElement(
+                  "code",
+                  {
+                    className: (0, clsx_1.default)(
                       "openapi-explorer__code-block-lines",
                       showLineNumbers &&
                         "openapi-explorer__code-block-lines-numbers"
-                    )}
-                  >
-                    {tokens.map((line, i) => (
-                      <Line
-                        key={i}
-                        line={line}
-                        getLineProps={getLineProps}
-                        getTokenProps={getTokenProps}
-                        classNames={lineClassNames[i]}
-                        showLineNumbers={showLineNumbers}
-                      />
-                    ))}
-                  </code>
-                </pre>
-              )}
-            </Highlight>
-            <div className="openapi-explorer__code-block-btn-group">
-              <CopyButton
-                className="openapi-explorer__code-block-code-btn"
-                code={code}
-              />
-              <ExitButton
-                className="openapi-dmeo__code-block-code-btn"
-                handler={closeModal}
-              />
-            </div>
-          </div>
-        </Container>
-      </Modal>
-    </>
+                    ),
+                  },
+                  tokens.map((line, i) =>
+                    react_1.default.createElement(Line_1.default, {
+                      key: i,
+                      line: line,
+                      getLineProps: getLineProps,
+                      getTokenProps: getTokenProps,
+                      classNames: lineClassNames,
+                      showLineNumbers: showLineNumbers,
+                    })
+                  )
+                )
+              )
+          ),
+          react_1.default.createElement(
+            "div",
+            { className: "openapi-explorer__code-block-btn-group" },
+            react_1.default.createElement(CopyButton_1.default, {
+              className: "openapi-explorer__code-block-code-btn",
+              code: code,
+            }),
+            react_1.default.createElement(ExitButton_1.default, {
+              className: "openapi-dmeo__code-block-code-btn",
+              handler: closeModal,
+            })
+          )
+        )
+      )
+    )
   );
 }
+exports.default = ExpandButton;

package/lib/theme/ApiExplorer/ApiCodeBlock/Container/index.d.ts

@@ -0,0 +1,4 @@
+import React, { ComponentProps } from "react";
+export default function CodeBlockContainer<T extends "div" | "pre">({ as: As, ...props }: {
+    as: T;
+} & ComponentProps<T>): React.JSX.Element;

package/lib/theme/ApiExplorer/ApiCodeBlock/Container/index.js

@@ -1,29 +1,35 @@
+"use strict";
 /* ============================================================================
  * 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.
  * ========================================================================== */
-
-import React from "react";
-
-import { ThemeClassNames, usePrismTheme } from "@docusaurus/theme-common";
-import { getPrismCssVariables } from "@docusaurus/theme-common/internal";
-import clsx from "clsx";
-
-export default function CodeBlockContainer({ as: As, ...props }) {
-  const prismTheme = usePrismTheme();
-  const prismCssVariables = getPrismCssVariables(prismTheme);
-  return (
-    <As
-      // Polymorphic components are hard to type, without `oneOf` generics
-      {...props}
-      style={prismCssVariables}
-      className={clsx(
+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 internal_1 = require("@docusaurus/theme-common/internal");
+const clsx_1 = __importDefault(require("clsx"));
+function CodeBlockContainer({ as: As, ...props }) {
+  const prismTheme = (0, theme_common_1.usePrismTheme)();
+  const prismCssVariables = (0, internal_1.getPrismCssVariables)(prismTheme);
+  return react_1.default.createElement(
+    As,
+    // Polymorphic components are hard to type, without `oneOf` generics
+    {
+      ...props,
+      style: prismCssVariables,
+      className: (0, clsx_1.default)(
         "openapi-explorer__code-block-container",
         props.className,
-        ThemeClassNames.common.codeBlock
-      )}
-    />
+        theme_common_1.ThemeClassNames.common.codeBlock
+      ),
+    }
   );
 }
+exports.default = CodeBlockContainer;

package/lib/theme/ApiExplorer/ApiCodeBlock/Content/Element.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="@docusaurus/theme-classic" />
+import React from "react";
+import type { Props } from "@theme/CodeBlock/Content/Element";
+export default function CodeBlockJSX({ children, className, }: Props): React.JSX.Element;

package/lib/theme/ApiExplorer/ApiCodeBlock/Content/Element.js

@@ -1,30 +1,41 @@
+"use strict";
 /* ============================================================================
  * 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.
  * ========================================================================== */
-
-import React from "react";
-
-import Container from "@theme/ApiExplorer/ApiCodeBlock/Container";
-import clsx from "clsx";
-
+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 Container_1 = __importDefault(
+  require("@theme/ApiExplorer/ApiCodeBlock/Container")
+);
+const clsx_1 = __importDefault(require("clsx"));
 // <pre> tags in markdown map to CodeBlocks. They may contain JSX children. When
 // the children is not a simple string, we just return a styled block without
 // actually highlighting.
-export default function CodeBlockJSX({ children, className }) {
-  return (
-    <Container
-      as="pre"
-      tabIndex={0}
-      className={clsx(
+function CodeBlockJSX({ children, className }) {
+  return react_1.default.createElement(
+    Container_1.default,
+    {
+      as: "pre",
+      tabIndex: 0,
+      className: (0, clsx_1.default)(
         "openapi-explorer__code-block-standalone",
         "thin-scrollbar",
         className
-      )}
-    >
-      <code className="openapi-explorer__code-block-lines">{children}</code>
-    </Container>
+      ),
+    },
+    react_1.default.createElement(
+      "code",
+      { className: "openapi-explorer__code-block-lines" },
+      children
+    )
   );
 }
+exports.default = CodeBlockJSX;

package/lib/theme/ApiExplorer/ApiCodeBlock/Content/String.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="@docusaurus/theme-classic" />
+import React from "react";
+import type { Props } from "@theme/CodeBlock/Content/String";
+export default function CodeBlockString({ children, className: blockClassName, metastring, title: titleProp, showLineNumbers: showLineNumbersProp, language: languageProp, }: Props): React.JSX.Element;