docusaurus-theme-openapi-docs 5.0.1 → 5.1.0

package/lib/theme/ApiExplorer/CodeSnippets/languages.test.js

@@ -0,0 +1,102 @@
+"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.
+ * ========================================================================== */
+Object.defineProperty(exports, "__esModule", { value: true });
+const languages_1 = require("./languages");
+const baseLang = (language, codeSampleLanguage) => ({
+  highlight: language,
+  language,
+  codeSampleLanguage,
+  logoClass: language,
+  variant: "http",
+  variants: ["http"],
+});
+describe("mergeCodeSampleLanguage", () => {
+  it("returns the language unchanged when no codeSamples target it", () => {
+    const langs = [baseLang("python", "Python")];
+    const result = (0, languages_1.mergeCodeSampleLanguage)(langs, []);
+    expect(result[0]).toEqual(langs[0]);
+    expect(result[0].samples).toBeUndefined();
+  });
+  it("attaches a single sample with no label using an indexed id", () => {
+    const samples = [{ lang: "Python", source: "print('hi')" }];
+    const [py] = (0, languages_1.mergeCodeSampleLanguage)(
+      [baseLang("python", "Python")],
+      samples
+    );
+    expect(py.samples).toEqual(["Python-0"]);
+    expect(py.samplesLabels).toEqual(["Python"]);
+    expect(py.samplesSources).toEqual(["print('hi')"]);
+    expect(py.sample).toBe("Python-0");
+  });
+  it("attaches a single sample with a label using lang-label id", () => {
+    const samples = [{ lang: "PHP", label: "Custom", source: "<?php" }];
+    const [php] = (0, languages_1.mergeCodeSampleLanguage)(
+      [baseLang("php", "PHP")],
+      samples
+    );
+    expect(php.samples).toEqual(["PHP-Custom"]);
+    expect(php.samplesLabels).toEqual(["Custom"]);
+  });
+  it("produces unique ids for multiple samples sharing a lang with distinct labels (#1204)", () => {
+    const samples = [
+      { lang: "Python", label: "KeyPair Auth", source: "a" },
+      { lang: "Python", label: "Basic Auth", source: "b" },
+      { lang: "Python", label: "OAuth", source: "c" },
+    ];
+    const [py] = (0, languages_1.mergeCodeSampleLanguage)(
+      [baseLang("python", "Python")],
+      samples
+    );
+    expect(py.samples).toEqual([
+      "Python-KeyPair Auth",
+      "Python-Basic Auth",
+      "Python-OAuth",
+    ]);
+    expect(new Set(py.samples).size).toBe(3);
+    expect(py.samplesLabels).toEqual(["KeyPair Auth", "Basic Auth", "OAuth"]);
+    expect(py.samplesSources).toEqual(["a", "b", "c"]);
+  });
+  it("produces unique indexed ids for multiple samples sharing a lang without labels", () => {
+    const samples = [
+      { lang: "PowerShell", source: "x" },
+      { lang: "PowerShell", source: "y" },
+    ];
+    const [ps] = (0, languages_1.mergeCodeSampleLanguage)(
+      [baseLang("powershell", "PowerShell")],
+      samples
+    );
+    expect(ps.samples).toEqual(["PowerShell-0", "PowerShell-1"]);
+    expect(new Set(ps.samples).size).toBe(2);
+    expect(ps.samplesLabels).toEqual(["PowerShell", "PowerShell"]);
+  });
+  it("defensively suffixes ids when lang+label collides", () => {
+    const samples = [
+      { lang: "Java", label: "Auth", source: "a" },
+      { lang: "Java", label: "Auth", source: "b" },
+    ];
+    const [java] = (0, languages_1.mergeCodeSampleLanguage)(
+      [baseLang("java", "Java")],
+      samples
+    );
+    expect(java.samples).toEqual(["Java-Auth", "Java-Auth-1"]);
+    expect(new Set(java.samples).size).toBe(2);
+    expect(java.samplesLabels).toEqual(["Auth", "Auth"]);
+  });
+  it("filters codeSamples by codeSampleLanguage and leaves other languages alone", () => {
+    const samples = [
+      { lang: "Python", label: "A", source: "a" },
+      { lang: "Java", label: "B", source: "b" },
+    ];
+    const result = (0, languages_1.mergeCodeSampleLanguage)(
+      [baseLang("python", "Python"), baseLang("php", "PHP")],
+      samples
+    );
+    expect(result[0].samples).toEqual(["Python-A"]);
+    expect(result[1].samples).toBeUndefined();
+  });
+});

package/lib/theme/ApiExplorer/CodeTabs/index.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
-import { type TabProps } from "@docusaurus/theme-common/internal";
+import { type TabProps } from "@theme/utils/tabsUtils";
 import { Language } from "../CodeSnippets/code-snippets-types";
 export interface Props {
     action: {

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

@@ -69,9 +69,10 @@ var __importDefault =
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = CodeTabs;
 const react_1 = __importStar(require("react"));
-const internal_1 = require("@docusaurus/theme-common/internal");
 const useIsBrowser_1 = __importDefault(require("@docusaurus/useIsBrowser"));
 const clsx_1 = __importDefault(require("clsx"));
+const scrollUtils_1 = require("@theme/utils/scrollUtils");
+const tabsUtils_1 = require("@theme/utils/tabsUtils");
 function TabList({
   action,
   currentLanguage,
@@ -87,7 +88,7 @@ function TabList({
   const tabRefs = (0, react_1.useRef)([]);
   const tabsScrollContainerRef = (0, react_1.useRef)(null);
   const { blockElementScrollPositionUntilNextRender } = (0,
-  internal_1.useScrollPositionBlocker)();
+  scrollUtils_1.useScrollPositionBlocker)();
   (0, react_1.useEffect)(() => {
     const activeTab = tabRefs.current.find(
       (tab) => tab?.getAttribute("aria-selected") === "true"
@@ -235,10 +236,10 @@ function TabContent({ lazy, children, selectedValue }) {
   );
 }
 function TabsComponent(props) {
-  const tabs = (0, internal_1.useTabsContextValue)(props);
+  const tabs = (0, tabsUtils_1.useTabsContextValue)(props);
   const { className } = props;
   return react_1.default.createElement(
-    internal_1.TabsProvider,
+    tabsUtils_1.TabsProvider,
     { value: tabs },
     react_1.default.createElement(
       "div",
@@ -265,6 +266,6 @@ function CodeTabs(props) {
       key: String(isBrowser),
       ...props,
     },
-    (0, internal_1.sanitizeTabsChildren)(props.children)
+    (0, tabsUtils_1.sanitizeTabsChildren)(props.children)
   );
 }

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

@@ -12,6 +12,7 @@ var __importDefault =
   };
 Object.defineProperty(exports, "__esModule", { value: true });
 const react_1 = __importDefault(require("react"));
+const Translate_1 = require("@docusaurus/Translate");
 const file_saver_1 = __importDefault(require("file-saver"));
 const saveFile = (url) => {
   let fileName;
@@ -30,7 +31,10 @@ function Export({ url, proxy }) {
     react_1.default.createElement(
       "button",
       { className: "export-button button button--sm button--secondary" },
-      "Export"
+      (0, Translate_1.translate)({
+        id: "theme.openapi.export.button",
+        message: "Export",
+      })
     ),
     react_1.default.createElement(
       "ul",
@@ -48,7 +52,10 @@ function Export({ url, proxy }) {
             className: "dropdown__link",
             href: `${url}`,
           },
-          "OpenAPI Spec"
+          (0, Translate_1.translate)({
+            id: "theme.openapi.export.openapiSpec",
+            message: "OpenAPI Spec",
+          })
         )
       )
     )

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

@@ -72,7 +72,6 @@ const Translate_1 = require("@docusaurus/Translate");
 const FloatingButton_1 = __importDefault(
   require("@theme/ApiExplorer/FloatingButton")
 );
-const translationIds_1 = require("@theme/translationIds");
 const react_magic_dropzone_1 = __importDefault(require("react-magic-dropzone"));
 function RenderPreview({ file }) {
   switch (file.type) {
@@ -161,7 +160,7 @@ function FormFileUpload({ placeholder, onChange }) {
                 },
               },
               (0, Translate_1.translate)({
-                id: translationIds_1.OPENAPI_FORM_FILE_UPLOAD.CLEAR_BUTTON,
+                id: "theme.openapi.formFileUpload.clearButton",
                 message: "Clear",
               })
             ),

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

@@ -13,7 +13,6 @@ var __importDefault =
 Object.defineProperty(exports, "__esModule", { value: true });
 const react_1 = __importDefault(require("react"));
 const Translate_1 = require("@docusaurus/Translate");
-const translationIds_1 = require("@theme/translationIds");
 function FormLabel({ htmlFor, label, type, required }) {
   return react_1.default.createElement(
     react_1.default.Fragment,
@@ -41,7 +40,7 @@ function FormLabel({ htmlFor, label, type, required }) {
         "span",
         { className: "openapi-schema__required" },
         (0, Translate_1.translate)({
-          id: translationIds_1.OPENAPI_SCHEMA_ITEM.REQUIRED,
+          id: "theme.openapi.schemaItem.required",
           message: "required",
         })
       )

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

@@ -72,7 +72,6 @@ const react_1 = __importStar(require("react"));
 const Translate_1 = require("@docusaurus/Translate");
 const error_message_1 = require("@hookform/error-message");
 const FormLabel_1 = __importDefault(require("@theme/ApiExplorer/FormLabel"));
-const translationIds_1 = require("@theme/translationIds");
 const clsx_1 = __importDefault(require("clsx"));
 const react_hook_form_1 = require("react-hook-form");
 function FormTextInput({
@@ -108,7 +107,7 @@ function FormTextInput({
           ...register(paramName, {
             required: isRequired
               ? (0, Translate_1.translate)({
-                  id: translationIds_1.OPENAPI_FORM.FIELD_REQUIRED,
+                  id: "theme.openapi.form.fieldRequired",
                   message: "This field is required",
                 })
               : false,

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

@@ -72,7 +72,6 @@ const theme_common_1 = require("@docusaurus/theme-common");
 const Translate_1 = require("@docusaurus/Translate");
 const useIsBrowser_1 = __importDefault(require("@docusaurus/useIsBrowser"));
 const error_message_1 = require("@hookform/error-message");
-const translationIds_1 = require("@theme/translationIds");
 const clsx_1 = __importDefault(require("clsx"));
 const react_hook_form_1 = require("react-hook-form");
 const react_live_1 = require("react-live");
@@ -144,7 +143,7 @@ function App({
           required:
             isRequired && !code
               ? (0, Translate_1.translate)({
-                  id: translationIds_1.OPENAPI_FORM.FIELD_REQUIRED,
+                  id: "theme.openapi.form.fieldRequired",
                   message: "This field is required",
                 })
               : false,

package/lib/theme/ApiExplorer/ParamOptions/ParamFormItems/ParamArrayFormItem.js

@@ -79,7 +79,6 @@ const FormTextInput_1 = __importDefault(
 );
 const slice_1 = require("@theme/ApiExplorer/ParamOptions/slice");
 const hooks_1 = require("@theme/ApiItem/hooks");
-const translationIds_1 = require("@theme/translationIds");
 const react_hook_form_1 = require("react-hook-form");
 function ArrayItem({ param, onChange, initialValue }) {
   const [value, setValue] = (0, react_1.useState)(initialValue || "");
@@ -171,7 +170,7 @@ function ParamArrayFormItem({ param, label, type, required }) {
       rules: {
         required: param.required
           ? (0, Translate_1.translate)({
-              id: translationIds_1.OPENAPI_FORM.FIELD_REQUIRED,
+              id: "theme.openapi.form.fieldRequired",
               message: "This field is required",
             })
           : false,
@@ -219,7 +218,10 @@ function ParamArrayFormItem({ param, label, type, required }) {
           react_1.default.createElement(
             "button",
             { className: "openapi-explorer__thin-btn", onClick: handleAddItem },
-            "Add item"
+            (0, Translate_1.translate)({
+              id: "theme.openapi.paramArray.addItem",
+              message: "Add item",
+            })
           )
         ),
     }),

package/lib/theme/ApiExplorer/ParamOptions/ParamFormItems/ParamBooleanFormItem.js

@@ -5,6 +5,62 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  * ========================================================================== */
+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 () {
+    var ownKeys = function (o) {
+      ownKeys =
+        Object.getOwnPropertyNames ||
+        function (o) {
+          var ar = [];
+          for (var k in o)
+            if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+          return ar;
+        };
+      return ownKeys(o);
+    };
+    return function (mod) {
+      if (mod && mod.__esModule) return mod;
+      var result = {};
+      if (mod != null)
+        for (var k = ownKeys(mod), i = 0; i < k.length; i++)
+          if (k[i] !== "default") __createBinding(result, mod, k[i]);
+      __setModuleDefault(result, mod);
+      return result;
+    };
+  })();
 var __importDefault =
   (this && this.__importDefault) ||
   function (mod) {
@@ -12,21 +68,35 @@ var __importDefault =
   };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = ParamBooleanFormItem;
-const react_1 = __importDefault(require("react"));
+const react_1 = __importStar(require("react"));
 const Translate_1 = require("@docusaurus/Translate");
 const error_message_1 = require("@hookform/error-message");
 const FormSelect_1 = __importDefault(require("@theme/ApiExplorer/FormSelect"));
 const slice_1 = require("@theme/ApiExplorer/ParamOptions/slice");
 const hooks_1 = require("@theme/ApiItem/hooks");
-const translationIds_1 = require("@theme/translationIds");
 const react_hook_form_1 = require("react-hook-form");
 function ParamBooleanFormItem({ param, label, type, required }) {
   const dispatch = (0, hooks_1.useTypedDispatch)();
   const {
     control,
     formState: { errors },
+    setValue,
   } = (0, react_hook_form_1.useFormContext)();
   const showErrorMessage = errors?.paramBoolean;
+  (0, react_1.useEffect)(() => {
+    if (param.value === undefined) return;
+    const initial =
+      typeof param.value === "boolean" ? String(param.value) : param.value;
+    if (initial === "true" || initial === "false") {
+      setValue("paramBoolean", initial);
+      // Boolean defaults arrive in redux as actual booleans; normalize to the
+      // string form the rest of the form uses.
+      if (typeof param.value === "boolean") {
+        dispatch((0, slice_1.setParam)({ ...param, value: initial }));
+      }
+    }
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
   return react_1.default.createElement(
     react_1.default.Fragment,
     null,
@@ -35,17 +105,18 @@ function ParamBooleanFormItem({ param, label, type, required }) {
       rules: {
         required: param.required
           ? (0, Translate_1.translate)({
-              id: translationIds_1.OPENAPI_FORM.FIELD_REQUIRED,
+              id: "theme.openapi.form.fieldRequired",
               message: "This field is required",
             })
           : false,
       },
       name: "paramBoolean",
-      render: ({ field: { onChange } }) =>
+      render: ({ field: { onChange, value } }) =>
         react_1.default.createElement(FormSelect_1.default, {
           label: label,
           type: type,
           required: required,
+          value: value ?? "---",
           options: ["---", "true", "false"],
           onChange: (e) => {
             const val = e.target.value;

package/lib/theme/ApiExplorer/ParamOptions/ParamFormItems/ParamMultiSelectFormItem.js

@@ -21,7 +21,6 @@ const FormMultiSelect_1 = __importDefault(
 const ParamOptions_1 = require("@theme/ApiExplorer/ParamOptions");
 const slice_1 = require("@theme/ApiExplorer/ParamOptions/slice");
 const hooks_1 = require("@theme/ApiItem/hooks");
-const translationIds_1 = require("@theme/translationIds");
 const react_hook_form_1 = require("react-hook-form");
 function ParamMultiSelectFormItem({ param, label, type, required }) {
   const {
@@ -70,7 +69,7 @@ function ParamMultiSelectFormItem({ param, label, type, required }) {
       rules: {
         required: param.required
           ? (0, Translate_1.translate)({
-              id: translationIds_1.OPENAPI_FORM.FIELD_REQUIRED,
+              id: "theme.openapi.form.fieldRequired",
               message: "This field is required",
             })
           : false,

package/lib/theme/ApiExplorer/ParamOptions/ParamFormItems/ParamSelectFormItem.js

@@ -5,6 +5,62 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  * ========================================================================== */
+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 () {
+    var ownKeys = function (o) {
+      ownKeys =
+        Object.getOwnPropertyNames ||
+        function (o) {
+          var ar = [];
+          for (var k in o)
+            if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+          return ar;
+        };
+      return ownKeys(o);
+    };
+    return function (mod) {
+      if (mod && mod.__esModule) return mod;
+      var result = {};
+      if (mod != null)
+        for (var k = ownKeys(mod), i = 0; i < k.length; i++)
+          if (k[i] !== "default") __createBinding(result, mod, k[i]);
+      __setModuleDefault(result, mod);
+      return result;
+    };
+  })();
 var __importDefault =
   (this && this.__importDefault) ||
   function (mod) {
@@ -12,23 +68,29 @@ var __importDefault =
   };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = ParamSelectFormItem;
-const react_1 = __importDefault(require("react"));
+const react_1 = __importStar(require("react"));
 const Translate_1 = require("@docusaurus/Translate");
 const error_message_1 = require("@hookform/error-message");
 const FormSelect_1 = __importDefault(require("@theme/ApiExplorer/FormSelect"));
 const ParamOptions_1 = require("@theme/ApiExplorer/ParamOptions");
 const slice_1 = require("@theme/ApiExplorer/ParamOptions/slice");
 const hooks_1 = require("@theme/ApiItem/hooks");
-const translationIds_1 = require("@theme/translationIds");
 const react_hook_form_1 = require("react-hook-form");
 function ParamSelectFormItem({ param, label, type, required }) {
   const {
     control,
     formState: { errors },
+    setValue,
   } = (0, react_hook_form_1.useFormContext)();
   const showErrorMessage = errors?.paramSelect;
   const dispatch = (0, hooks_1.useTypedDispatch)();
   const options = (0, ParamOptions_1.getSchemaEnum)(param.schema) ?? [];
+  (0, react_1.useEffect)(() => {
+    if (typeof param.value === "string" && options.includes(param.value)) {
+      setValue("paramSelect", param.value);
+    }
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
   return react_1.default.createElement(
     react_1.default.Fragment,
     null,
@@ -37,17 +99,18 @@ function ParamSelectFormItem({ param, label, type, required }) {
       rules: {
         required: param.required
           ? (0, Translate_1.translate)({
-              id: translationIds_1.OPENAPI_FORM.FIELD_REQUIRED,
+              id: "theme.openapi.form.fieldRequired",
               message: "This field is required",
             })
           : false,
       },
       name: "paramSelect",
-      render: ({ field: { onChange } }) =>
+      render: ({ field: { onChange, value } }) =>
         react_1.default.createElement(FormSelect_1.default, {
           label: label,
           type: type,
           required: required,
+          value: value ?? "---",
           options: ["---", ...options],
           onChange: (e) => {
             const val = e.target.value;

package/lib/theme/ApiExplorer/ParamOptions/ParamFormItems/ParamTextFormItem.js

@@ -5,6 +5,62 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  * ========================================================================== */
+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 () {
+    var ownKeys = function (o) {
+      ownKeys =
+        Object.getOwnPropertyNames ||
+        function (o) {
+          var ar = [];
+          for (var k in o)
+            if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+          return ar;
+        };
+      return ownKeys(o);
+    };
+    return function (mod) {
+      if (mod && mod.__esModule) return mod;
+      var result = {};
+      if (mod != null)
+        for (var k = ownKeys(mod), i = 0; i < k.length; i++)
+          if (k[i] !== "default") __createBinding(result, mod, k[i]);
+      __setModuleDefault(result, mod);
+      return result;
+    };
+  })();
 var __importDefault =
   (this && this.__importDefault) ||
   function (mod) {
@@ -12,14 +68,22 @@ var __importDefault =
   };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = ParamTextFormItem;
-const react_1 = __importDefault(require("react"));
+const react_1 = __importStar(require("react"));
 const FormTextInput_1 = __importDefault(
   require("@theme/ApiExplorer/FormTextInput")
 );
 const slice_1 = require("@theme/ApiExplorer/ParamOptions/slice");
 const hooks_1 = require("@theme/ApiItem/hooks");
+const react_hook_form_1 = require("react-hook-form");
 function ParamTextFormItem({ param, label, type, required }) {
   const dispatch = (0, hooks_1.useTypedDispatch)();
+  const { setValue } = (0, react_hook_form_1.useFormContext)();
+  (0, react_1.useEffect)(() => {
+    if (param.value !== undefined && !Array.isArray(param.value)) {
+      setValue(param.name, param.value);
+    }
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
   return react_1.default.createElement(FormTextInput_1.default, {
     label: label,
     type: type,

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

@@ -87,7 +87,6 @@ const ParamTextFormItem_1 = __importDefault(
   require("@theme/ApiExplorer/ParamOptions/ParamFormItems/ParamTextFormItem")
 );
 const hooks_1 = require("@theme/ApiItem/hooks");
-const translationIds_1 = require("@theme/translationIds");
 /**
  * Extracts enum values from a schema, including when wrapped in allOf.
  * This handles cases where an enum is referenced via allOf for composition.
@@ -254,11 +253,11 @@ function ParamOptions() {
           ),
           showOptional
             ? (0, Translate_1.translate)({
-                id: translationIds_1.OPENAPI_PARAM_OPTIONS.HIDE_OPTIONAL,
+                id: "theme.openapi.paramOptions.hideOptional",
                 message: "Hide optional parameters",
               })
             : (0, Translate_1.translate)({
-                id: translationIds_1.OPENAPI_PARAM_OPTIONS.SHOW_OPTIONAL,
+                id: "theme.openapi.paramOptions.showOptional",
                 message: "Show optional parameters",
               })
         ),