docusaurus-theme-openapi-docs 0.0.0-1154 → 0.0.0-1155

package/lib/theme/ApiExplorer/MethodEndpoint/index.js

@@ -13,6 +13,9 @@ var __importDefault =
 Object.defineProperty(exports, "__esModule", { value: true });
 const react_1 = __importDefault(require("react"));
 const BrowserOnly_1 = __importDefault(require("@docusaurus/BrowserOnly"));
+const ExecutionEnvironment_1 = __importDefault(
+  require("@docusaurus/ExecutionEnvironment")
+);
 const hooks_1 = require("@theme/ApiItem/hooks");
 function colorForMethod(method) {
   switch (method.toLowerCase()) {
@@ -35,6 +38,31 @@ function colorForMethod(method) {
   }
 }
 function MethodEndpoint({ method, path, context }) {
+  // During SSR, render without Redux store access to avoid "Cannot read properties
+  // of null (reading 'store')" errors caused by useSelector running outside a Provider.
+  if (!ExecutionEnvironment_1.default.canUseDOM) {
+    return react_1.default.createElement(
+      react_1.default.Fragment,
+      null,
+      react_1.default.createElement(
+        "pre",
+        { className: "openapi__method-endpoint" },
+        react_1.default.createElement(
+          "span",
+          { className: "badge badge--" + colorForMethod(method) },
+          method === "event" ? "Webhook" : method.toUpperCase()
+        ),
+        " ",
+        method !== "event" &&
+          react_1.default.createElement(
+            "h2",
+            { className: "openapi__method-endpoint-path" },
+            `${path.replace(/{([a-z0-9-_]+)}/gi, ":$1")}`
+          )
+      ),
+      react_1.default.createElement("div", { className: "openapi__divider" })
+    );
+  }
   let serverValue = (0, hooks_1.useTypedSelector)(
     (state) => state.server.value
   );

package/lib/theme/Schema/index.js

@@ -226,6 +226,12 @@ const Summary = ({ name, schemaName, schema, required }) => {
 };
 const AnyOneOf = ({ schema, schemaType, schemaPath }) => {
   const key = schema.oneOf ? "oneOf" : "anyOf";
+  const schemaArray = schema[key];
+  // Empty oneOf/anyOf arrays are valid in OpenAPI specs but would cause the
+  // Tabs component to throw "requires at least one TabItem". Return null instead.
+  if (!schemaArray || !Array.isArray(schemaArray) || schemaArray.length === 0) {
+    return null;
+  }
   const type = schema.oneOf
     ? (0, Translate_1.translate)({
         id: translationIds_1.OPENAPI_SCHEMA_ITEM.ONE_OF,

package/lib/theme/SchemaTabs/index.d.ts

@@ -7,4 +7,4 @@ export interface SchemaTabsProps extends TabProps {
      */
     onChange?: (index: number) => void;
 }
-export default function SchemaTabs(props: SchemaTabsProps): React.JSX.Element;
+export default function SchemaTabs(props: SchemaTabsProps): React.JSX.Element | null;

package/lib/theme/SchemaTabs/index.js

@@ -252,6 +252,26 @@ function TabsComponent(props) {
 }
 function SchemaTabs(props) {
   const isBrowser = (0, useIsBrowser_1.default)();
+  const children = Array.isArray(props.children)
+    ? props.children.filter(Boolean)
+    : props.children
+      ? [props.children]
+      : [];
+  if (children.length === 0) {
+    return null;
+  }
+  let sanitizedChildren;
+  try {
+    sanitizedChildren = (0, internal_1.sanitizeTabsChildren)(children);
+  } catch {
+    return null;
+  }
+  if (
+    !sanitizedChildren ||
+    (Array.isArray(sanitizedChildren) && sanitizedChildren.length === 0)
+  ) {
+    return null;
+  }
   return react_1.default.createElement(
     TabsComponent,
     // Remount tabs after hydration
@@ -262,6 +282,6 @@ function SchemaTabs(props) {
       key: String(isBrowser),
       ...props,
     },
-    (0, internal_1.sanitizeTabsChildren)(props.children)
+    sanitizedChildren
   );
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "docusaurus-theme-openapi-docs",
   "description": "OpenAPI theme for Docusaurus.",
-  "version": "0.0.0-1154",
+  "version": "0.0.0-1155",
   "license": "MIT",
   "keywords": [
     "openapi",
@@ -38,7 +38,7 @@
     "@types/postman-collection": "^3.5.11",
     "@types/react-modal": "^3.16.3",
     "concurrently": "^9.2.0",
-    "docusaurus-plugin-openapi-docs": "0.0.0-1154",
+    "docusaurus-plugin-openapi-docs": "0.0.0-1155",
     "docusaurus-plugin-sass": "^0.2.6",
     "eslint-plugin-prettier": "^5.5.1"
   },
@@ -82,5 +82,5 @@
   "engines": {
     "node": ">=14"
   },
-  "gitHead": "0debbc67d743f553056175f125d0df187f4e4939"
+  "gitHead": "388036c8328b54f841365688b671422a418098bb"
 }

package/src/theme/ApiExplorer/MethodEndpoint/index.tsx

@@ -8,6 +8,7 @@
 import React from "react";
 
 import BrowserOnly from "@docusaurus/BrowserOnly";
+import ExecutionEnvironment from "@docusaurus/ExecutionEnvironment";
 import { useTypedSelector } from "@theme/ApiItem/hooks";
 
 function colorForMethod(method: string) {
@@ -38,6 +39,26 @@ export interface Props {
 }
 
 function MethodEndpoint({ method, path, context }: Props) {
+  // During SSR, render without Redux store access to avoid "Cannot read properties
+  // of null (reading 'store')" errors caused by useSelector running outside a Provider.
+  if (!ExecutionEnvironment.canUseDOM) {
+    return (
+      <>
+        <pre className="openapi__method-endpoint">
+          <span className={"badge badge--" + colorForMethod(method)}>
+            {method === "event" ? "Webhook" : method.toUpperCase()}
+          </span>{" "}
+          {method !== "event" && (
+            <h2 className="openapi__method-endpoint-path">
+              {`${path.replace(/{([a-z0-9-_]+)}/gi, ":$1")}`}
+            </h2>
+          )}
+        </pre>
+        <div className="openapi__divider" />
+      </>
+    );
+  }
+
   let serverValue = useTypedSelector((state: any) => state.server.value);
   let serverUrlWithVariables = "";
 

package/src/theme/Schema/index.tsx

@@ -214,6 +214,14 @@ const AnyOneOf: React.FC<SchemaProps> = ({
   schemaPath,
 }) => {
   const key = schema.oneOf ? "oneOf" : "anyOf";
+  const schemaArray = schema[key];
+
+  // Empty oneOf/anyOf arrays are valid in OpenAPI specs but would cause the
+  // Tabs component to throw "requires at least one TabItem". Return null instead.
+  if (!schemaArray || !Array.isArray(schemaArray) || schemaArray.length === 0) {
+    return null;
+  }
+
   const type = schema.oneOf
     ? translate({ id: OPENAPI_SCHEMA_ITEM.ONE_OF, message: "oneOf" })
     : translate({ id: OPENAPI_SCHEMA_ITEM.ANY_OF, message: "anyOf" });

package/src/theme/SchemaTabs/index.tsx

@@ -223,8 +223,35 @@ function TabsComponent(props: SchemaTabsProps): React.JSX.Element {
     </div>
   );
 }
-export default function SchemaTabs(props: SchemaTabsProps): React.JSX.Element {
+export default function SchemaTabs(
+  props: SchemaTabsProps
+): React.JSX.Element | null {
   const isBrowser = useIsBrowser();
+
+  const children = Array.isArray(props.children)
+    ? props.children.filter(Boolean)
+    : props.children
+      ? [props.children]
+      : [];
+
+  if (children.length === 0) {
+    return null;
+  }
+
+  let sanitizedChildren;
+  try {
+    sanitizedChildren = sanitizeTabsChildren(children);
+  } catch {
+    return null;
+  }
+
+  if (
+    !sanitizedChildren ||
+    (Array.isArray(sanitizedChildren) && sanitizedChildren.length === 0)
+  ) {
+    return null;
+  }
+
   return (
     <TabsComponent
       // Remount tabs after hydration
@@ -232,7 +259,7 @@ export default function SchemaTabs(props: SchemaTabsProps): React.JSX.Element {
       key={String(isBrowser)}
       {...props}
     >
-      {sanitizeTabsChildren(props.children)}
+      {sanitizedChildren}
     </TabsComponent>
   );
 }