@digi-frontend/dgate-api-documentation 4.0.5 → 4.0.8

package/dist/index.mjs

@@ -12,7 +12,6 @@ import Title from "antd/es/typography/Title.js";
 import { Light } from "react-syntax-highlighter";
 import json from "react-syntax-highlighter/dist/esm/languages/hljs/json.js";
 import * as hljs from "react-syntax-highlighter/dist/esm/styles/hljs/index.js";
-import { nanoid } from "nanoid";
 //#region src/store/slices/view.ts
 const createViewSlice = (set) => ({ view: {
 	selectedNodeKey: null,
@@ -2669,6 +2668,7 @@ const PARAM_IN_OPTIONS = [
 		value: "path"
 	}
 ];
+const RESPONSE_PARAM_IN_OPTIONS = PARAM_IN_OPTIONS.filter((o) => o.value === "header");
 const PARAM_TYPE_OPTIONS = [
 	{
 		label: "string",
@@ -2695,7 +2695,7 @@ const PARAM_TYPE_OPTIONS = [
 		value: "object"
 	}
 ];
-const AddParameterDrawer = ({ open, onClose, onAdd, onEdit, mode = "add", initialValues }) => {
+const AddParameterDrawer = ({ open, onClose, onAdd, onEdit, mode = "add", initialValues, source }) => {
 	const [form] = Form.useForm();
 	const [messageApi, contextHolder] = message.useMessage();
 	const [confirmModalOpen, setConfirmModalOpen] = useState(false);
@@ -2913,6 +2913,7 @@ const AddParameterDrawer = ({ open, onClose, onAdd, onEdit, mode = "add", initia
 		}
 	}));
 	const isAddEnabled = mode === "edit" ? hasChanges : !!(nameValue?.trim() && inValue && typeValue);
+	const paramInOptions = source === "response" ? RESPONSE_PARAM_IN_OPTIONS : PARAM_IN_OPTIONS;
 	const resetForm = () => {
 		form.resetFields();
 		setEnumInput("");
@@ -3017,10 +3018,11 @@ const AddParameterDrawer = ({ open, onClose, onAdd, onEdit, mode = "add", initia
 				className: cx("form-body"),
 				initialValues: {
 					required: true,
-					in: "query",
+					in: source === "response" ? "header" : "query",
 					type: "string"
 				},
-				onValuesChange: () => {
+				onValuesChange: (_changed, allValues) => {
+					if (allValues.in === "path") form.setFieldValue("required", true);
 					if (mode === "edit" && initialValues) {
 						const current = form.getFieldsValue();
 						setHasChanges(current.name !== initialValues.name || current.in !== initialValues.in || current.type !== initialValues.type || current.required !== initialValues.required || (current.description ?? "") !== (initialValues.description ?? "") || JSON.stringify(enumValues) !== JSON.stringify(initialValues.enum ?? []));
@@ -3065,7 +3067,7 @@ const AddParameterDrawer = ({ open, onClose, onAdd, onEdit, mode = "add", initia
 						children: /* @__PURE__ */ jsx(Select, {
 							size: "large",
 							placeholder: "Select",
-							options: PARAM_IN_OPTIONS
+							options: paramInOptions
 						})
 					}),
 					/* @__PURE__ */ jsx(Form.Item, {
@@ -3092,12 +3094,20 @@ const AddParameterDrawer = ({ open, onClose, onAdd, onEdit, mode = "add", initia
 						children: /* @__PURE__ */ jsxs("div", {
 							className: cx("switch-row"),
 							children: [/* @__PURE__ */ jsx(Switch, {
-								checked: requiredValue ?? true,
+								checked: inValue === "path" ? true : requiredValue ?? true,
+								disabled: inValue === "path",
 								onChange: (checked) => form.setFieldValue("required", checked),
-								style: { backgroundColor: requiredValue ?? true ? token.colorPrimary : void 0 }
-							}), /* @__PURE__ */ jsx("span", {
+								style: { backgroundColor: (inValue === "path" ? true : requiredValue ?? true) ? token.colorPrimary : void 0 }
+							}), /* @__PURE__ */ jsxs("span", {
 								className: cx("switch-label"),
-								children: "Required?"
+								children: ["Required?", inValue === "path" && /* @__PURE__ */ jsx("span", {
+									style: {
+										color: token.colorTextTertiary,
+										fontSize: 12,
+										marginLeft: 4
+									},
+									children: "(Always required for path parameter)"
+								})]
 							})]
 						})
 					}),
@@ -3270,7 +3280,7 @@ const buildViewParamRows = (params) => params.map((p, idx) => ({
 	description: p.description ?? "",
 	enum: p.enum ?? []
 }));
-const EndpointsSection = ({ endpointsByTag, collapsed = false, onToggleCollapse, endpointNames, endpointDescs, endpointTags, availableTags, onEndpointNameChange, onEndpointDescChange, onEndpointTagsChange, endpointParams, onAddParameter, onEditParameter, onDeleteParameter, endpointResponseParams, onAddResponseParameter, onEditResponseParameter, onDeleteResponseParameter, mode = "edit", selectedEndpointKey }) => {
+const EndpointsSection = ({ endpointsByTag, collapsed = false, onToggleCollapse, endpointNames, endpointDescs, endpointTags, availableTags, onEndpointNameChange, onEndpointDescChange, onEndpointTagsChange, endpointParams, onAddParameter, onEditParameter, onDeleteParameter, endpointResponseParams, onAddResponseParameter, onEditResponseParameter, onDeleteResponseParameter, onRequestContentChange, onResponseContentChange, requestBodySchemas, responseBodySchemas, mode = "edit", selectedEndpointKey }) => {
 	const [expandedId, setExpandedId] = useState(null);
 	const [activeTab, setActiveTab] = useState("general");
 	useEffect(() => {
@@ -3311,6 +3321,48 @@ const EndpointsSection = ({ endpointsByTag, collapsed = false, onToggleCollapse,
 	const [showResponseSearch, setShowResponseSearch] = useState({});
 	const debouncedRequestSearches = useDebounce(requestSearches);
 	const debouncedResponseSearches = useDebounce(responseSearches);
+	const [editableRequestContent, setEditableRequestContent] = useState({});
+	const [editableResponseContent, setEditableResponseContent] = useState({});
+	useEffect(() => {
+		if (!openRequestPanels.size) return;
+		openRequestPanels.forEach((epId) => {
+			if (editableRequestContent[epId] !== void 0) return;
+			const val = requestBodySchemas?.[epId];
+			const json = val ? JSON.stringify(val, null, 2) : "";
+			setEditableRequestContent((prev) => ({
+				...prev,
+				[epId]: json
+			}));
+		});
+	}, [openRequestPanels, requestBodySchemas]);
+	useEffect(() => {
+		if (!openResponsePanels.size) return;
+		openResponsePanels.forEach((epId) => {
+			if (editableResponseContent[epId] !== void 0) return;
+			const val = responseBodySchemas?.[epId];
+			const json = val ? JSON.stringify(val, null, 2) : "";
+			setEditableResponseContent((prev) => ({
+				...prev,
+				[epId]: json
+			}));
+		});
+	}, [openResponsePanels, responseBodySchemas]);
+	const handleValidate = (content) => {
+		try {
+			JSON.parse(content);
+			message.success("Definition is valid JSON.");
+		} catch {
+			message.error("Invalid JSON definition.");
+		}
+	};
+	const handleBeautify = (content, setter) => {
+		try {
+			const parsed = JSON.parse(content);
+			setter(JSON.stringify(parsed, null, 2));
+		} catch {
+			message.error("Could not beautify — content is not valid JSON.");
+		}
+	};
 	const { selectNodeByKey } = useNodeSelection();
 	const { token: antdToken } = theme.useToken();
 	const isMobile = !useBreakpoint$2().md;
@@ -3465,6 +3517,7 @@ const EndpointsSection = ({ endpointsByTag, collapsed = false, onToggleCollapse,
 			userSelect: "none",
 			"&:hover": { background: token.colorFillTertiary }
 		},
+		[scope("param-row--open")]: { borderRadius: `${token.borderRadius}px ${token.borderRadius}px 0 0` },
 		[scope("param-row-icon")]: {
 			fontSize: 12,
 			transition: "transform 0.2s"
@@ -3472,10 +3525,13 @@ const EndpointsSection = ({ endpointsByTag, collapsed = false, onToggleCollapse,
 		[scope("param-row-icon--open")]: { transform: "rotate(180deg)" },
 		[scope("code-panel")]: {
 			width: "100%",
-			overflow: "hidden"
+			overflow: "hidden",
+			background: "#1D2856",
+			borderBottomLeftRadius: 8,
+			borderBottomRightRadius: 8
 		},
 		[scope("code-area")]: {
-			background: token.colorBgSpotlight,
+			background: "#1D2856",
 			padding: "10px 12px",
 			fontFamily: "Cairo, sans-serif",
 			fontSize: 14,
@@ -3487,7 +3543,7 @@ const EndpointsSection = ({ endpointsByTag, collapsed = false, onToggleCollapse,
 			display: "block"
 		},
 		[scope("code-footer")]: {
-			background: token.colorBgSpotlight,
+			background: "#161D40",
 			padding: 12,
 			borderBottomLeftRadius: 8,
 			borderBottomRightRadius: 8,
@@ -4471,8 +4527,8 @@ const EndpointsSection = ({ endpointsByTag, collapsed = false, onToggleCollapse,
 											className: cx("pagination")
 										})] });
 									})(),
-									/* @__PURE__ */ jsxs("div", {
-										className: cx("param-row"),
+									!["GET", "DELETE"].includes(ep.method) && /* @__PURE__ */ jsxs("div", {
+										className: cx("param-row", openRequestPanels.has(ep.id) ? "param-row--open" : ""),
 										style: { marginTop: token.margin },
 										onClick: () => toggleRequestPanel(ep.id),
 										children: [/* @__PURE__ */ jsx(DownOutlined, { className: cx("param-row-icon", openRequestPanels.has(ep.id) ? "param-row-icon--open" : "") }), /* @__PURE__ */ jsxs("span", {
@@ -4483,29 +4539,43 @@ const EndpointsSection = ({ endpointsByTag, collapsed = false, onToggleCollapse,
 											})]
 										})]
 									}),
-									openRequestPanels.has(ep.id) && /* @__PURE__ */ jsxs("div", {
+									!["GET", "DELETE"].includes(ep.method) && openRequestPanels.has(ep.id) && /* @__PURE__ */ jsxs("div", {
 										className: cx("code-panel"),
-										children: [/* @__PURE__ */ jsx("code", {
-											className: cx("code-area"),
-											children: JSON.stringify((endpointParams[ep.id] ?? []).map((p) => ({
-												name: p.name,
-												in: p.in,
-												type: p.type,
-												required: p.required,
-												...p.description ? { description: p.description } : {},
-												...p.enum && p.enum.length > 0 ? { enum: p.enum } : {}
-											})), null, 2)
+										children: [/* @__PURE__ */ jsx(Input.TextArea, {
+											value: editableRequestContent[ep.id] ?? "",
+											onChange: (e) => {
+												setEditableRequestContent((prev) => ({
+													...prev,
+													[ep.id]: e.target.value
+												}));
+												onRequestContentChange?.(ep.id, e.target.value);
+											},
+											rows: Math.max(3, (editableRequestContent[ep.id] ?? "").split("\n").length),
+											style: {
+												fontFamily: "monospace",
+												fontSize: "0.75rem",
+												background: "#1D2856",
+												color: "#fff",
+												outline: "none",
+												boxShadow: "none",
+												border: "none"
+											}
 										}), /* @__PURE__ */ jsxs("div", {
 											className: cx("code-footer"),
 											children: [/* @__PURE__ */ jsx(Button, {
 												ghost: true,
 												size: "small",
 												className: cx("code-btn"),
+												onClick: () => handleValidate(editableRequestContent[ep.id] ?? ""),
 												children: "Validate"
 											}), /* @__PURE__ */ jsx(Button, {
 												ghost: true,
 												size: "small",
 												className: cx("code-btn"),
+												onClick: () => handleBeautify(editableRequestContent[ep.id] ?? "", (v) => setEditableRequestContent((prev) => ({
+													...prev,
+													[ep.id]: v
+												}))),
 												children: "Beautify"
 											})]
 										})]
@@ -4931,7 +5001,7 @@ const EndpointsSection = ({ endpointsByTag, collapsed = false, onToggleCollapse,
 										})] });
 									})(),
 									/* @__PURE__ */ jsxs("div", {
-										className: cx("param-row"),
+										className: cx("param-row", openResponsePanels.has(ep.id) ? "param-row--open" : ""),
 										style: { marginTop: token.margin },
 										onClick: () => toggleResponsePanel(ep.id),
 										children: [
@@ -4951,27 +5021,41 @@ const EndpointsSection = ({ endpointsByTag, collapsed = false, onToggleCollapse,
 									}),
 									openResponsePanels.has(ep.id) && /* @__PURE__ */ jsxs("div", {
 										className: cx("code-panel"),
-										children: [/* @__PURE__ */ jsx("code", {
-											className: cx("code-area"),
-											children: JSON.stringify((endpointResponseParams[ep.id] ?? []).map((p) => ({
-												name: p.name,
-												in: p.in,
-												type: p.type,
-												required: p.required,
-												...p.description ? { description: p.description } : {},
-												...p.enum && p.enum.length > 0 ? { enum: p.enum } : {}
-											})), null, 2)
+										children: [/* @__PURE__ */ jsx(Input.TextArea, {
+											value: editableResponseContent[ep.id] ?? "",
+											onChange: (e) => {
+												setEditableResponseContent((prev) => ({
+													...prev,
+													[ep.id]: e.target.value
+												}));
+												onResponseContentChange?.(ep.id, e.target.value);
+											},
+											rows: Math.max(3, (editableResponseContent[ep.id] ?? "").split("\n").length),
+											style: {
+												fontFamily: "monospace",
+												fontSize: "0.75rem",
+												background: "#1D2856",
+												color: "#fff",
+												outline: "none",
+												boxShadow: "none",
+												border: "none"
+											}
 										}), /* @__PURE__ */ jsxs("div", {
 											className: cx("code-footer"),
 											children: [/* @__PURE__ */ jsx(Button, {
 												ghost: true,
 												size: "small",
 												className: cx("code-btn"),
+												onClick: () => handleValidate(editableResponseContent[ep.id] ?? ""),
 												children: "Validate"
 											}), /* @__PURE__ */ jsx(Button, {
 												ghost: true,
 												size: "small",
 												className: cx("code-btn"),
+												onClick: () => handleBeautify(editableResponseContent[ep.id] ?? "", (v) => setEditableResponseContent((prev) => ({
+													...prev,
+													[ep.id]: v
+												}))),
 												children: "Beautify"
 											})]
 										})]
@@ -5118,7 +5202,8 @@ const EndpointsSection = ({ endpointsByTag, collapsed = false, onToggleCollapse,
 						setParamDrawerEndpointId(null);
 						setParamDrawerMode("add");
 						setEditParamIdx(null);
-					}
+					},
+					source: drawerSource
 				})
 			]
 		}));
@@ -5707,8 +5792,8 @@ const EndpointsSection = ({ endpointsByTag, collapsed = false, onToggleCollapse,
 												className: cx("pagination")
 											})] });
 										})(),
-										/* @__PURE__ */ jsxs("div", {
-											className: cx("param-row"),
+										!["GET", "DELETE"].includes(ep.method) && /* @__PURE__ */ jsxs("div", {
+											className: cx("param-row", openRequestPanels.has(ep.id) ? "param-row--open" : ""),
 											style: { marginTop: token.margin },
 											onClick: () => toggleRequestPanel(ep.id),
 											children: [/* @__PURE__ */ jsx(DownOutlined, { className: cx("param-row-icon", openRequestPanels.has(ep.id) ? "param-row-icon--open" : "") }), /* @__PURE__ */ jsxs("span", {
@@ -5719,29 +5804,43 @@ const EndpointsSection = ({ endpointsByTag, collapsed = false, onToggleCollapse,
 												})]
 											})]
 										}),
-										openRequestPanels.has(ep.id) && /* @__PURE__ */ jsxs("div", {
+										!["GET", "DELETE"].includes(ep.method) && openRequestPanels.has(ep.id) && /* @__PURE__ */ jsxs("div", {
 											className: cx("code-panel"),
-											children: [/* @__PURE__ */ jsx("code", {
-												className: cx("code-area"),
-												children: JSON.stringify((endpointParams[ep.id] ?? []).map((p) => ({
-													name: p.name,
-													in: p.in,
-													type: p.type,
-													required: p.required,
-													...p.description ? { description: p.description } : {},
-													...p.enum && p.enum.length > 0 ? { enum: p.enum } : {}
-												})), null, 2)
+											children: [/* @__PURE__ */ jsx(Input.TextArea, {
+												value: editableRequestContent[ep.id] ?? "",
+												onChange: (e) => {
+													setEditableRequestContent((prev) => ({
+														...prev,
+														[ep.id]: e.target.value
+													}));
+													onRequestContentChange?.(ep.id, e.target.value);
+												},
+												rows: Math.max(3, (editableRequestContent[ep.id] ?? "").split("\n").length),
+												style: {
+													fontFamily: "monospace",
+													fontSize: "0.75rem",
+													background: "#1D2856",
+													color: "#fff",
+													outline: "none",
+													boxShadow: "none",
+													border: "none"
+												}
 											}), /* @__PURE__ */ jsxs("div", {
 												className: cx("code-footer"),
 												children: [/* @__PURE__ */ jsx(Button, {
 													ghost: true,
 													size: "small",
 													className: cx("code-btn"),
+													onClick: () => handleValidate(editableRequestContent[ep.id] ?? ""),
 													children: "Validate"
 												}), /* @__PURE__ */ jsx(Button, {
 													ghost: true,
 													size: "small",
 													className: cx("code-btn"),
+													onClick: () => handleBeautify(editableRequestContent[ep.id] ?? "", (v) => setEditableRequestContent((prev) => ({
+														...prev,
+														[ep.id]: v
+													}))),
 													children: "Beautify"
 												})]
 											})]
@@ -6165,7 +6264,7 @@ const EndpointsSection = ({ endpointsByTag, collapsed = false, onToggleCollapse,
 											})] });
 										})(),
 										/* @__PURE__ */ jsxs("div", {
-											className: cx("param-row"),
+											className: cx("param-row", openResponsePanels.has(ep.id) ? "param-row--open" : ""),
 											style: { marginTop: token.margin },
 											onClick: () => toggleResponsePanel(ep.id),
 											children: [
@@ -6185,27 +6284,41 @@ const EndpointsSection = ({ endpointsByTag, collapsed = false, onToggleCollapse,
 										}),
 										openResponsePanels.has(ep.id) && /* @__PURE__ */ jsxs("div", {
 											className: cx("code-panel"),
-											children: [/* @__PURE__ */ jsx("code", {
-												className: cx("code-area"),
-												children: JSON.stringify((endpointResponseParams[ep.id] ?? []).map((p) => ({
-													name: p.name,
-													in: p.in,
-													type: p.type,
-													required: p.required,
-													...p.description ? { description: p.description } : {},
-													...p.enum && p.enum.length > 0 ? { enum: p.enum } : {}
-												})), null, 2)
+											children: [/* @__PURE__ */ jsx(Input.TextArea, {
+												value: editableResponseContent[ep.id] ?? "",
+												onChange: (e) => {
+													setEditableResponseContent((prev) => ({
+														...prev,
+														[ep.id]: e.target.value
+													}));
+													onResponseContentChange?.(ep.id, e.target.value);
+												},
+												rows: Math.max(3, (editableResponseContent[ep.id] ?? "").split("\n").length),
+												style: {
+													fontFamily: "monospace",
+													fontSize: "0.75rem",
+													background: "#1D2856",
+													color: "#fff",
+													outline: "none",
+													boxShadow: "none",
+													border: "none"
+												}
 											}), /* @__PURE__ */ jsxs("div", {
 												className: cx("code-footer"),
 												children: [/* @__PURE__ */ jsx(Button, {
 													ghost: true,
 													size: "small",
 													className: cx("code-btn"),
+													onClick: () => handleValidate(editableResponseContent[ep.id] ?? ""),
 													children: "Validate"
 												}), /* @__PURE__ */ jsx(Button, {
 													ghost: true,
 													size: "small",
 													className: cx("code-btn"),
+													onClick: () => handleBeautify(editableResponseContent[ep.id] ?? "", (v) => setEditableResponseContent((prev) => ({
+														...prev,
+														[ep.id]: v
+													}))),
 													children: "Beautify"
 												})]
 											})]
@@ -6354,7 +6467,8 @@ const EndpointsSection = ({ endpointsByTag, collapsed = false, onToggleCollapse,
 					setParamDrawerEndpointId(null);
 					setParamDrawerMode("add");
 					setEditParamIdx(null);
-				}
+				},
+				source: drawerSource
 			})
 		]
 	}));
@@ -6856,9 +6970,9 @@ const TagsSection = ({ tags, collapsed, onToggleCollapse, onAddTag, onEditTag, o
 };
 //#endregion
 //#region src/view/components/ApiPage/components/AddTagDrawer.tsx
-const TAG_NAME_REGEX = /^[A-Za-z0-9_-]+$/;
-const TAG_DESC_REGEX = /^[A-Za-z0-9_-]+$/;
-const EXT_DESC_REGEX = /^[A-Za-z0-9_-]+$/;
+const TAG_NAME_REGEX = /^[A-Za-z0-9_\s-]+$/;
+const TAG_DESC_REGEX = /^[A-Za-z0-9_\s-]+$/;
+const EXTERNAL_DOCS_DESC_REGEX = /^[A-Za-z0-9_\s-]+$/;
 const AddTagDrawer = ({ open, onClose, mode, initialValues, onAddTag, onEditTag }) => {
 	const [form] = Form.useForm();
 	const [messageApi, contextHolder] = message.useMessage();
@@ -7099,7 +7213,7 @@ const AddTagDrawer = ({ open, onClose, mode, initialValues, onAddTag, onEditTag
 							},
 							{
 								pattern: TAG_NAME_REGEX,
-								message: "Only letters, numbers, underscores, and hyphens"
+								message: "Only letters, numbers, spaces, underscores, and hyphens"
 							}
 						],
 						children: /* @__PURE__ */ jsx(Input, {
@@ -7120,10 +7234,10 @@ const AddTagDrawer = ({ open, onClose, mode, initialValues, onAddTag, onEditTag
 						rules: [{
 							max: 50,
 							message: "Maximum 50 characters"
-						}, { validator: (_, value) => {
-							if (!value || TAG_DESC_REGEX.test(value)) return Promise.resolve();
-							return Promise.reject(/* @__PURE__ */ new Error("Only letters, numbers, underscores, and hyphens"));
-						} }],
+						}, {
+							pattern: TAG_DESC_REGEX,
+							message: "Only letters, numbers, spaces, _ and - allowed"
+						}],
 						children: /* @__PURE__ */ jsx(Input.TextArea, {
 							showCount: true,
 							maxLength: 50,
@@ -7143,10 +7257,10 @@ const AddTagDrawer = ({ open, onClose, mode, initialValues, onAddTag, onEditTag
 						rules: [{
 							max: 25,
 							message: "Maximum 25 characters"
-						}, { validator: (_, value) => {
-							if (!value || EXT_DESC_REGEX.test(value)) return Promise.resolve();
-							return Promise.reject(/* @__PURE__ */ new Error("Only letters, numbers, underscores, and hyphens"));
-						} }],
+						}, {
+							pattern: EXTERNAL_DOCS_DESC_REGEX,
+							message: "Only letters, numbers, spaces, _ and - allowed"
+						}],
 						children: /* @__PURE__ */ jsx(Input, {
 							showCount: true,
 							maxLength: 25,
@@ -7168,8 +7282,8 @@ const AddTagDrawer = ({ open, onClose, mode, initialValues, onAddTag, onEditTag
 							children: "External Docs Link"
 						}),
 						rules: [{
-							max: 512,
-							message: "Maximum 512 characters"
+							max: 500,
+							message: "Maximum 500 characters"
 						}, { validator: async () => {
 							const desc = form.getFieldValue("externalDocsDescription");
 							const link = form.getFieldValue("externalDocsLink");
@@ -8505,7 +8619,7 @@ const Codebox$1 = ({ code, language, wrapLongLines }) => {
 //#endregion
 //#region src/view/console/CodeboxSidebar.tsx
 function CodeboxSidebar$1() {
-	const { selectedEndpoint, selectedApi, activeRequestTab, selectedStatusCode, statusCodeOptions, setSelectedStatusCode } = useStore(({ view }) => view);
+	const { selectedEndpoint, selectedApi, selectedStatusCode, statusCodeOptions, setSelectedStatusCode } = useStore(({ view }) => view);
 	const httpStatusOptions = useMemo(() => statusCodeOptions.map((code) => ({
 		value: code,
 		label: /* @__PURE__ */ jsxs("span", {
@@ -8538,7 +8652,7 @@ function CodeboxSidebar$1() {
 		const queryParams = params.filter((p) => p.in === "query");
 		return [`curl --location '${serverUrl}${resolvedPath}${queryParams.length > 0 ? "?" + queryParams.map((p) => `${p.name}=sample-value`).join("&") : ""}'`, ...params.filter((p) => p.in === "header").map((p) => `--header '${p.name}: sample-value'`)];
 	})();
-	const hasActiveTabParams = (selectedEndpoint?.parameters ?? []).some((p) => p.in === activeRequestTab);
+	const hasAnyParams = (selectedEndpoint?.parameters ?? []).some((p) => p.in === "header" || p.in === "path" || p.in === "query");
 	const { token: antdToken, theme: themeConfig } = theme.useToken();
 	const isDark = themeConfig.id == 1;
 	const headerBg = isDark ? antdToken.colorBgElevated : "#1d2856";
@@ -8660,7 +8774,7 @@ function CodeboxSidebar$1() {
 	}));
 	return /* @__PURE__ */ jsxs("div", {
 		className: cx("container"),
-		children: [hasActiveTabParams && /* @__PURE__ */ jsxs("div", {
+		children: [hasAnyParams && /* @__PURE__ */ jsxs("div", {
 			className: cx("rightCard", "rightCardRequest"),
 			children: [/* @__PURE__ */ jsxs("div", {
 				className: cx("rightCardHeader"),
@@ -8715,6 +8829,15 @@ function CodeboxSidebar$1() {
 }
 //#endregion
 //#region src/view/helper/mutate.ts
+/**
+* Simple deterministic string hash (djb2 variant).
+* Produces a stable, short base-36 hash for the same input.
+*/
+const stableHash = (input) => {
+	let hash = 5381;
+	for (let i = 0; i < input.length; i++) hash = (hash << 5) + hash + input.charCodeAt(i);
+	return (hash >>> 0).toString(36);
+};
 const resolveSchema = (schema, components) => {
 	if (!schema) return void 0;
 	if (!schema.$ref) return schema;
@@ -8777,14 +8900,14 @@ const transformOpenApiToDocs = (api) => {
 			if (!groupedPathsByTags[tag]) groupedPathsByTags[tag] = [];
 			groupedPathsByTags[tag].push({
 				...entry,
-				id: `endpoint-${nanoid(8)}`
+				id: `endpoint-${stableHash(entry.method + "-" + entry.path)}`
 			});
 		});
 		else {
 			if (!groupedPathsByTags.default) groupedPathsByTags.default = [];
 			groupedPathsByTags.default.push({
 				...entry,
-				id: `endpoint-${nanoid(8)}`
+				id: `endpoint-${stableHash(entry.method + "-" + entry.path)}`
 			});
 		}
 	}
@@ -8798,7 +8921,7 @@ const transformOpenApiToDocs = (api) => {
 	}, {});
 	return {
 		...api.info,
-		id: `api-${nanoid(8)}`,
+		id: `api-${contextPath ?? "unknown"}`,
 		contextPath,
 		tags: sortedGroupedPathsByTags,
 		servers: api.servers,
@@ -8827,7 +8950,7 @@ const ConsoleDocumentationLayout = ({ data, preSelectedApi, handleVisitLandingPa
 	const [apiNameTouched, setApiNameTouched] = useState(false);
 	const [localDescription, setLocalDescription] = useState("");
 	const [descriptionTouched, setDescriptionTouched] = useState(false);
-	const hasApiNameError = apiNameTouched && (!localApiName.trim() || !/^[A-Za-z0-9_-]+$/.test(localApiName.trim()));
+	const hasApiNameError = apiNameTouched && (!localApiName.trim() || !/^[A-Za-z0-9_\s-]+$/.test(localApiName.trim()));
 	const hasDescriptionError = descriptionTouched && !localDescription.trim();
 	const hasGeneralError = hasApiNameError || hasDescriptionError;
 	const [saveErrors, setSaveErrors] = useState([]);
@@ -8837,6 +8960,8 @@ const ConsoleDocumentationLayout = ({ data, preSelectedApi, handleVisitLandingPa
 	const [endpointTags, setEndpointTags] = useState({});
 	const [endpointParams, setEndpointParams] = useState({});
 	const [endpointResponseParams, setEndpointResponseParams] = useState({});
+	const [endpointRequestBody, setEndpointRequestBody] = useState({});
+	const [endpointResponseBody, setEndpointResponseBody] = useState({});
 	const [tagDrawerState, setTagDrawerState] = useState({
 		open: false,
 		mode: "add"
@@ -8847,7 +8972,7 @@ const ConsoleDocumentationLayout = ({ data, preSelectedApi, handleVisitLandingPa
 	});
 	const [localTags, setLocalTags] = useState([]);
 	const [messageApi, contextHolder] = message.useMessage();
-	const { focusedContent, selectedNodeKey, selectedApi, originalData, builtTreeData, selectedEndpoint, setOriginalData, setTransformedData, setBuiltTreeData, setFocusedContent, setExpandedKeys, setSelectedEndpoint } = useStore(({ view }) => view);
+	const { focusedContent, selectedNodeKey, selectedApi, originalData, transformedData, builtTreeData, selectedEndpoint, setOriginalData, setTransformedData, setBuiltTreeData, setSelectedApi, setFocusedContent, setExpandedKeys, setSelectedEndpoint } = useStore(({ view }) => view);
 	const { selectFirstApi, selectPreSelectedApi, clearSelection } = useNodeSelection();
 	const hasInitializedRef = useRef(false);
 	const { useBreakpoint } = Grid;
@@ -9071,10 +9196,50 @@ const ConsoleDocumentationLayout = ({ data, preSelectedApi, handleVisitLandingPa
 		});
 		return result;
 	}, [originalData, selectedApi]);
+	const initialEndpointRequestBody = useMemo(() => {
+		if (!originalData || !selectedApi) return {};
+		const rawFile = originalData.find((f) => Object.keys(f.paths)[0] === selectedApi.contextPath);
+		if (!rawFile) return {};
+		const pathMethodToId = {};
+		Object.values(selectedApi.tags).flat().forEach((ep) => {
+			pathMethodToId[`${ep.path}||${ep.method.toLowerCase()}`] = ep.id;
+		});
+		const result = {};
+		Object.entries(rawFile.paths).forEach(([path, methods]) => {
+			Object.entries(methods).forEach(([method, operation]) => {
+				const schema = operation.requestBody?.content?.["application/json"]?.schema;
+				const epId = pathMethodToId[`${path}||${method}`];
+				if (epId && schema) result[epId] = schema;
+			});
+		});
+		return result;
+	}, [originalData, selectedApi]);
+	const initialEndpointResponseBody = useMemo(() => {
+		if (!originalData || !selectedApi) return {};
+		const rawFile = originalData.find((f) => Object.keys(f.paths)[0] === selectedApi.contextPath);
+		if (!rawFile) return {};
+		const pathMethodToId = {};
+		Object.values(selectedApi.tags).flat().forEach((ep) => {
+			pathMethodToId[`${ep.path}||${ep.method.toLowerCase()}`] = ep.id;
+		});
+		const result = {};
+		Object.entries(rawFile.paths).forEach(([path, methods]) => {
+			Object.entries(methods).forEach(([method, operation]) => {
+				const responses = operation.responses;
+				if (!responses) return;
+				const schema = responses["200" in responses ? "200" : Object.keys(responses)[0]]?.content?.["application/json"]?.schema;
+				const epId = pathMethodToId[`${path}||${method}`];
+				if (epId && schema) result[epId] = schema;
+			});
+		});
+		return result;
+	}, [originalData, selectedApi]);
 	useEffect(() => {
 		setLocalTags(tagMetadata);
 		setEndpointParams(initialEndpointParams);
 		setEndpointResponseParams(initialEndpointResponseParams);
+		setEndpointRequestBody(initialEndpointRequestBody);
+		setEndpointResponseBody(initialEndpointResponseBody);
 	}, [selectedApi]);
 	const hasChanges = useMemo(() => {
 		if (!selectedApi) return false;
@@ -9289,11 +9454,45 @@ const ConsoleDocumentationLayout = ({ data, preSelectedApi, handleVisitLandingPa
 				else delete methodObj["x-response-params"];
 			}
 		});
+		Object.entries(endpointRequestBody).forEach(([id, schema]) => {
+			const loc = idToPathMethod[id];
+			if (!loc) return;
+			const pathEntry = cloned.paths[loc.path];
+			if (!pathEntry) return;
+			const methodObj = pathEntry[loc.method];
+			if (!methodObj) return;
+			const methodObjAny = methodObj;
+			if (!methodObjAny.requestBody) methodObjAny.requestBody = {};
+			const rb = methodObjAny.requestBody;
+			if (!rb.content) rb.content = {};
+			rb.content["application/json"] = { schema };
+		});
+		Object.entries(endpointResponseBody).forEach(([id, schema]) => {
+			const loc = idToPathMethod[id];
+			if (!loc) return;
+			const pathEntry = cloned.paths[loc.path];
+			if (!pathEntry) return;
+			const methodObj = pathEntry[loc.method];
+			if (!methodObj) return;
+			const methodObjAny = methodObj;
+			if (!methodObjAny.responses) return;
+			const responses = methodObjAny.responses;
+			const statusCode = "200" in responses ? "200" : Object.keys(responses)[0];
+			if (!responses[statusCode]) return;
+			if (!responses[statusCode].content) responses[statusCode].content = {};
+			responses[statusCode].content["application/json"] = { schema };
+		});
 		try {
 			await onSave?.(cloned);
 			setBannerVisible(false);
 			setSaveErrors([]);
 			messageApi.success("Changes have been saved and published successfully.");
+			setOriginalData(originalData.map((f) => Object.keys(f.paths)[0] === selectedApi.contextPath ? cloned : f));
+			const newTransformed = [cloned].map(transformOpenApiToDocs)[0];
+			const newTransformedData = (transformedData ?? []).map((t) => t.contextPath === selectedApi.contextPath ? newTransformed : t);
+			setTransformedData(newTransformedData);
+			setBuiltTreeData(buildTreeDataStructure(newTransformedData) ?? []);
+			setSelectedApi(newTransformed);
 		} catch (err) {
 			let messages = [];
 			if (err && typeof err === "object" && "errors" in err) {
@@ -9628,7 +9827,29 @@ const ConsoleDocumentationLayout = ({ data, preSelectedApi, handleVisitLandingPa
 										[endpointId]: prev[endpointId]?.filter((_, i) => i !== idx) ?? []
 									}));
 									setBannerVisible(true);
-								}
+								},
+								onRequestContentChange: (endpointId, jsonString) => {
+									try {
+										const schema = JSON.parse(jsonString);
+										setEndpointRequestBody((prev) => ({
+											...prev,
+											[endpointId]: schema
+										}));
+										setBannerVisible(true);
+									} catch {}
+								},
+								onResponseContentChange: (endpointId, jsonString) => {
+									try {
+										const schema = JSON.parse(jsonString);
+										setEndpointResponseBody((prev) => ({
+											...prev,
+											[endpointId]: schema
+										}));
+										setBannerVisible(true);
+									} catch {}
+								},
+								requestBodySchemas: endpointRequestBody,
+								responseBodySchemas: endpointResponseBody
 							}, resetKey)
 						})
 					] }) : /* @__PURE__ */ jsxs(Fragment, { children: [
@@ -9767,7 +9988,29 @@ const ConsoleDocumentationLayout = ({ data, preSelectedApi, handleVisitLandingPa
 									[endpointId]: prev[endpointId]?.filter((_, i) => i !== idx) ?? []
 								}));
 								setBannerVisible(true);
-							}
+							},
+							onRequestContentChange: (endpointId, jsonString) => {
+								try {
+									const schema = JSON.parse(jsonString);
+									setEndpointRequestBody((prev) => ({
+										...prev,
+										[endpointId]: schema
+									}));
+									setBannerVisible(true);
+								} catch {}
+							},
+							onResponseContentChange: (endpointId, jsonString) => {
+								try {
+									const schema = JSON.parse(jsonString);
+									setEndpointResponseBody((prev) => ({
+										...prev,
+										[endpointId]: schema
+									}));
+									setBannerVisible(true);
+								} catch {}
+							},
+							requestBodySchemas: endpointRequestBody,
+							responseBodySchemas: endpointResponseBody
 						}, resetKey)
 					] })
 				})]