@clarify-labs/renderer 0.9.3 → 0.10.0

package/output/{OpenApiOperation-C9xyRo5a.js → OpenApiOperation-CyBkzvob.js}

@@ -1,4 +1,4 @@
-import { C as isExternalHref, D as useBuiltInText, E as copyTextToClipboard, M as useLocale, c as lucideIconRegistry, h as useTheme, j as useConfig, l as resolveLucideIconName, n as PageTitleActions, o as useSectionStore, s as remToPx, w as localizeHref } from "./PageActions-B_tSec1f.js";
+import { C as isExternalHref, D as useBuiltInText, E as copyTextToClipboard, N as useLocale, c as lucideIconRegistry, h as useTheme, j as useConfig, l as resolveLucideIconName, n as PageTitleActions, o as useSectionStore, s as remToPx, w as localizeHref } from "./PageActions-Dn8IGWoL.js";
 import { t as markdownRemarkPlugins } from "./remark-Dd2WU50s.js";
 import clsx from "clsx";
 import { Children, createContext, createElement, forwardRef, isValidElement, useContext, useEffect, useId, useLayoutEffect, useRef, useState } from "react";
@@ -1312,10 +1312,10 @@ function schemaToType(schema) {
 	if (!isRecord(schema)) return void 0;
 	if (isReference(schema)) return resolveReferenceName(schema.$ref);
 	if (typeof schema.const !== "undefined") return JSON.stringify(schema.const);
-	if (Array.isArray(schema.enum)) return schema.enum.map(String).join(" | ");
+	if (Array.isArray(schema.enum)) return "enum";
 	const oneOf = schema.oneOf ?? schema.anyOf;
-	if (Array.isArray(oneOf)) return oneOf.map(schemaToType).filter(Boolean).join(" | ");
-	if (Array.isArray(schema.allOf)) return schema.allOf.map(schemaToType).filter(Boolean).join(" & ");
+	if (Array.isArray(oneOf)) return oneOf.map((branch) => schemaToType(branch)).filter(Boolean).join(" | ");
+	if (Array.isArray(schema.allOf)) return schema.allOf.map((branch) => schemaToType(branch)).filter(Boolean).join(" & ");
 	if (schemaHasType(schema, "array")) return `${schemaToType(schema.items) ?? "unknown"}[]`;
 	const type = Array.isArray(schema.type) ? schema.type.map(String).join(" | ") : schema.type;
 	return typeof type === "string" ? [type, typeof schema.format === "string" ? `<${schema.format}>` : void 0].filter(Boolean).join("") : void 0;
@@ -1406,7 +1406,7 @@ function getFieldValue(name, value, schema) {
 }
 function getFormParams(value, requestContent) {
 	const properties = getSchemaProperties(requestContent.value.schema);
-	return Array.from(new Set([...Object.keys(properties), ...isRecord(value) ? Object.keys(value) : []])).flatMap((name) => {
+	return Array.from(/* @__PURE__ */ new Set([...Object.keys(properties), ...isRecord(value) ? Object.keys(value) : []])).flatMap((name) => {
 		const fieldValue = getFieldValue(name, value, properties[name]);
 		if (typeof fieldValue === "undefined") return [];
 		const contentType = requestContent.value.encoding?.[name]?.contentType;
@@ -2217,9 +2217,17 @@ function ResponseExamplesPanel(arg0) {
 }
 //#endregion
 //#region source/openapi/components/SchemaProperties.tsx
+function getEnumDescriptions(schema) {
+	const descriptions = schema["x-enumDescriptions"];
+	if (Array.isArray(descriptions)) return descriptions.map((value) => typeof value === "string" ? value : void 0);
+	if (isRecord(descriptions)) return Array.isArray(schema.enum) ? schema.enum.map((value) => {
+		const description = descriptions[String(value)];
+		return typeof description === "string" ? description : void 0;
+	}) : [];
+	return [];
+}
 function getSchemaDetails(schema) {
 	const details = [
-		Array.isArray(schema.enum) ? `enum: ${schema.enum.map(String).join(", ")}` : void 0,
 		typeof schema.const !== "undefined" ? `const: ${String(schema.const)}` : void 0,
 		typeof schema.default !== "undefined" ? `default: ${String(schema.default)}` : void 0,
 		typeof schema.pattern === "string" ? `pattern: ${schema.pattern}` : void 0,
@@ -2232,6 +2240,21 @@ function getSchemaDetails(schema) {
 function getSchemaDescription(schema) {
 	return typeof schema.description === "string" ? schema.description : void 0;
 }
+function getSchemaNodeType(schema) {
+	return schemaToType(schema);
+}
+function getEnumChildren(schema, path) {
+	if (!Array.isArray(schema.enum) || schema.enum.length === 0) return [];
+	const descriptions = getEnumDescriptions(schema);
+	return schema.enum.map((value, index) => ({
+		key: `${path || "root"}.enum[${index}]`,
+		name: String(value),
+		kind: "enum",
+		description: descriptions[index],
+		required: false,
+		children: []
+	}));
+}
 function getComposedBranches(schema) {
 	const entries = [];
 	for (const key of [
@@ -2249,7 +2272,7 @@ function getComposedBranches(schema) {
 	return entries;
 }
 function getSchemaChildren(arg0) {
-	const { spec, schema, path, required = [], depth = 0, seen = /* @__PURE__ */ new Set() } = arg0;
+	const { spec, path, schema, depth = 0, required = [], seen = /* @__PURE__ */ new Set(), defaultExpanded } = arg0;
 	if (depth > 12) return [];
 	if (isReference(schema)) {
 		if (seen.has(schema.$ref)) return [];
@@ -2259,7 +2282,8 @@ function getSchemaChildren(arg0) {
 			path,
 			required,
 			depth,
-			seen: new Set([...seen, schema.$ref])
+			seen: /* @__PURE__ */ new Set([...seen, schema.$ref]),
+			defaultExpanded
 		});
 	}
 	if (!isRecord(schema)) return [];
@@ -2268,9 +2292,11 @@ function getSchemaChildren(arg0) {
 		schema: schema.items,
 		path: `${path}[]`,
 		depth: depth + 1,
-		seen
+		seen,
+		defaultExpanded
 	}) : [];
 	const objectRequired = Array.isArray(schema.required) ? schema.required.map(String) : required;
+	const enumChildren = getEnumChildren(schema, path);
 	const properties = isRecord(schema.properties) ? schema.properties : {};
 	const propertyChildren = Object.entries(properties).map(([name, propertySchema]) => {
 		const resolvedProperty = resolveSchema(spec, propertySchema);
@@ -2282,31 +2308,38 @@ function getSchemaChildren(arg0) {
 			schema: isArray ? property.items : propertySchema,
 			path: isArray ? `${childPath}[]` : childPath,
 			depth: depth + 1,
-			seen
+			seen,
+			defaultExpanded
 		});
+		const hasEnumValues = Array.isArray(property.enum) && property.enum.length > 0;
 		return {
 			key: childPath,
 			name,
-			type: schemaToType(propertySchema),
+			kind: "property",
+			type: getSchemaNodeType(property),
 			description: getSchemaDescription(property),
 			details: getSchemaDetails(property),
 			required: objectRequired.includes(name),
+			defaultExpanded: hasEnumValues ? defaultExpanded === true : defaultExpanded ?? depth < 1,
 			children
 		};
 	});
 	const additionalPropertyChildren = isRecord(schema.additionalProperties) ? [{
 		key: `${path || "root"}.*`,
 		name: "*",
-		type: schemaToType(schema.additionalProperties),
+		kind: "property",
+		type: getSchemaNodeType(schema.additionalProperties),
 		description: getSchemaDescription(schema.additionalProperties),
 		details: getSchemaDetails(schema.additionalProperties),
 		required: false,
+		defaultExpanded: defaultExpanded ?? depth < 1,
 		children: getSchemaChildren({
 			spec,
 			schema: schema.additionalProperties,
 			path: `${path || "root"}.*`,
 			depth: depth + 1,
-			seen
+			seen,
+			defaultExpanded
 		})
 	}] : [];
 	const composedChildren = getComposedBranches(schema).map(({ label, schema: branchSchema }) => {
@@ -2315,35 +2348,40 @@ function getSchemaChildren(arg0) {
 		return {
 			key: `${path || "root"}.${label}`,
 			name: label,
-			type: schemaToType(branchSchema),
+			kind: "property",
+			type: getSchemaNodeType(branch),
 			description: branch ? getSchemaDescription(branch) : void 0,
 			details: branch ? getSchemaDetails(branch) : void 0,
 			required: false,
+			defaultExpanded: defaultExpanded ?? depth < 1,
 			children: getSchemaChildren({
 				spec,
 				schema: branchSchema,
 				path: `${path || "root"}.${label}`,
 				required: objectRequired,
 				depth: depth + 1,
-				seen
+				seen,
+				defaultExpanded
 			})
 		};
 	});
 	return [
 		...arrayChildren,
+		...enumChildren,
 		...propertyChildren,
 		...additionalPropertyChildren,
 		...composedChildren
 	];
 }
-function getRootSchemaNode(spec, schema) {
+function getRootSchemaNode(spec, schema, defaultExpanded) {
 	if (isReference(schema)) {
 		const resolvedSchema = resolveSchema(spec, schema);
 		const resolved = isRecord(resolvedSchema) ? resolvedSchema : {};
 		return {
 			key: schema.$ref,
 			name: resolveReferenceName(schema.$ref),
-			type: schemaToType(schema),
+			kind: "property",
+			type: getSchemaNodeType(resolved),
 			description: getSchemaDescription(resolved),
 			details: getSchemaDetails(resolved),
 			required: false,
@@ -2351,7 +2389,8 @@ function getRootSchemaNode(spec, schema) {
 				spec,
 				schema: resolvedSchema,
 				path: resolveReferenceName(schema.$ref),
-				seen: new Set([schema.$ref])
+				seen: /* @__PURE__ */ new Set([schema.$ref]),
+				defaultExpanded
 			})
 		};
 	}
@@ -2359,24 +2398,58 @@ function getRootSchemaNode(spec, schema) {
 	return {
 		key: "root",
 		name: "body",
-		type: schemaToType(schema),
+		kind: "property",
+		type: getSchemaNodeType(schema),
 		description: getSchemaDescription(schema),
 		details: getSchemaDetails(schema),
 		required: false,
 		children: getSchemaChildren({
 			spec,
 			schema,
-			path: ""
+			path: "",
+			defaultExpanded
 		})
 	};
 }
-function SchemaNode(arg0) {
+function EnumValueNode(arg0) {
 	const { node, depth = 0 } = arg0;
+	return /* @__PURE__ */ jsx("li", {
+		className: "clarify-schema-node m-0 px-0 py-2 first:pt-0 last:pb-0",
+		children: /* @__PURE__ */ jsx("div", {
+			className: clsx("flex min-w-0 items-start rounded py-0.5 text-left", depth > 0 ? "-mx-2 w-(--clarify-schema-row-nested-width) px-2" : "w-full px-1"),
+			children: /* @__PURE__ */ jsxs("div", {
+				className: "min-w-0 flex-1",
+				children: [/* @__PURE__ */ jsx("div", {
+					className: "flex min-w-0 flex-wrap items-center gap-x-2 gap-y-0.5",
+					children: /* @__PURE__ */ jsx("span", {
+						className: "text-sm/5 font-semibold text-(--clarify-theme-tokens-colors-foreground)",
+						children: node.name
+					})
+				}), node.description || node.details ? /* @__PURE__ */ jsxs("div", {
+					className: "mt-0.5 text-sm/5 text-(--clarify-ui-text-soft) *:first:mt-0 *:last:mb-0",
+					children: [node.description ? /* @__PURE__ */ jsx(Markdown, {
+						className: "*:first:mt-0 *:last:mb-0",
+						children: node.description
+					}) : null, node.details ? /* @__PURE__ */ jsx("p", {
+						className: "text-xs text-(--clarify-ui-text-faint)",
+						children: node.details
+					}) : null]
+				}) : null]
+			})
+		})
+	});
+}
+function SchemaNode(arg0) {
+	const { node, depth = 0, defaultExpanded } = arg0;
 	const t = useBuiltInText();
-	const [expanded, setExpanded] = useState(depth < 1);
+	const [expanded, setExpanded] = useState(defaultExpanded ?? depth < 1);
 	const hasChildren = node.children.length > 0;
+	if (node.kind === "enum") return /* @__PURE__ */ jsx(EnumValueNode, {
+		node,
+		depth
+	});
 	const type = [node.type, node.required ? t("openapi.requiredBadge") : void 0].filter(Boolean).join(", ") || void 0;
-	const fallbackDescription = node.required ? t("openapi.required") : t("openapi.optional");
+	const fallbackDescription = hasChildren ? void 0 : node.required ? t("openapi.required") : t("openapi.optional");
 	const rowClassName = clsx("flex min-w-0 items-start rounded py-0.5 text-left", depth > 0 ? "-mx-2 w-(--clarify-schema-row-nested-width) px-2" : "w-full px-1");
 	const content = /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsxs("div", {
 		className: "min-w-0 flex-1",
@@ -2430,13 +2503,14 @@ function SchemaTree(arg0) {
 		className: clsx("m-0 list-none divide-y divide-(--clarify-theme-tokens-colors-border) p-0", depth > 0 && "mt-2 rounded-lg bg-(--clarify-ui-subtle-background) px-2 py-1"),
 		children: nodes.map((node) => /* @__PURE__ */ jsx(SchemaNode, {
 			node,
-			depth
+			depth,
+			defaultExpanded: node.defaultExpanded
 		}, node.key))
 	});
 }
 function SchemaProperties(arg0) {
-	const { title, schema, spec } = arg0;
-	const root = getRootSchemaNode(spec, schema);
+	const { title, schema, spec, defaultExpanded } = arg0;
+	const root = getRootSchemaNode(spec, schema, defaultExpanded);
 	if (!root || root.children.length === 0) return null;
 	return /* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx("h3", { children: title }), /* @__PURE__ */ jsx("div", {
 		className: "clarify-schema-properties my-6",
@@ -2444,19 +2518,17 @@ function SchemaProperties(arg0) {
 	})] });
 }
 function ParameterList(arg0) {
-	const { title, parameters } = arg0;
 	const t = useBuiltInText();
-	return /* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx("h3", { children: title }), /* @__PURE__ */ jsx(Properties, { children: parameters.length > 0 ? parameters.map((parameter) => /* @__PURE__ */ jsx(Property, {
+	const { title, parameters } = arg0;
+	if (parameters.length === 0) return null;
+	return /* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx("h3", { children: title }), /* @__PURE__ */ jsx(Properties, { children: parameters.map((parameter) => /* @__PURE__ */ jsx(Property, {
 		name: parameter.name ?? t("openapi.parameter"),
 		type: [schemaToType(parameter.schema), parameter.required ? t("openapi.requiredBadge") : void 0].filter(Boolean).join(", ") || void 0,
 		children: parameter.description ? /* @__PURE__ */ jsx(Markdown, {
 			className: "*:first:mt-0 *:last:mb-0",
 			children: parameter.description
 		}) : t("openapi.operationParameter")
-	}, `${parameter.in}-${parameter.name}`)) : /* @__PURE__ */ jsx("span", {
-		className: "text-sm/5 text-(--clarify-ui-text-soft)",
-		children: t("openapi.none")
-	}) })] });
+	}, `${parameter.in}-${parameter.name}`)) })] });
 }
 function ResponseList(arg0) {
 	const { operation, spec, selectedStatus, onSelectStatus } = arg0;
@@ -2534,7 +2606,23 @@ function ResponseList(arg0) {
 function EndpointRequest(arg0) {
 	const { spec, path, method, description, groupedParameters, parameters, requestBody, requestContents, requestSchema, selectedRequestMediaType, onSelectRequestMediaType, selectedServer, serverVariables, auth, sharedExampleKey, onSelectExampleKey } = arg0;
 	const t = useBuiltInText();
-	return /* @__PURE__ */ jsxs(Fragment$1, { children: [description ? /* @__PURE__ */ jsx(Markdown, { children: description }) : null, /* @__PURE__ */ jsxs(Row, {
+	const hasRequestBody = Boolean(requestBody && requestContents.length > 0);
+	const renderDescription = () => {
+		if (!description) return null;
+		return /* @__PURE__ */ jsx(Markdown, { children: description });
+	};
+	const renderRequestBody = () => {
+		if (!hasRequestBody) return /* @__PURE__ */ jsx("p", {
+			className: "text-sm/5 text-(--clarify-ui-text-soft)",
+			children: t("openapi.requestBodyEmpty")
+		});
+		return /* @__PURE__ */ jsxs(Fragment$1, { children: [typeof requestBody?.description === "string" ? /* @__PURE__ */ jsx(Markdown, { children: requestBody.description }) : null, /* @__PURE__ */ jsx(SchemaProperties, {
+			title: t("openapi.bodyProperties"),
+			schema: requestSchema,
+			spec
+		})] });
+	};
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [renderDescription(), /* @__PURE__ */ jsxs(Row, {
 		className: "relative mt-6",
 		children: [/* @__PURE__ */ jsx(Col, { children: /* @__PURE__ */ jsxs("div", {
 			className: "w-full",
@@ -2551,15 +2639,7 @@ function EndpointRequest(arg0) {
 					title: t("openapi.headers"),
 					parameters: groupedParameters.header
 				}),
-				requestBody && requestContents.length > 0 ? /* @__PURE__ */ jsxs(Fragment$1, { children: [
-					/* @__PURE__ */ jsx("h3", { children: t("openapi.requestBody") }),
-					typeof requestBody.description === "string" ? /* @__PURE__ */ jsx(Markdown, { children: requestBody.description }) : null,
-					/* @__PURE__ */ jsx(SchemaProperties, {
-						title: t("openapi.bodyProperties"),
-						schema: requestSchema,
-						spec
-					})
-				] }) : null
+				/* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx("h3", { children: t("openapi.requestBody") }), renderRequestBody()] })
 			]
 		}) }), /* @__PURE__ */ jsx(Col, {
 			sticky: true,
@@ -3082,4 +3162,4 @@ function OpenApiOperation(arg0) {
 //#endregion
 export { Button as A, Code as C, Card as D, Mermaid as E, CardGroup as O, Collapse as S, Pre as T, HeroPattern as _, authPlaceholder as a, Tag as b, getServerKey as c, getRequestBody$1 as d, Markdown as f, GridPattern as g, Prose as h, ResponseExamplesPanel as i, Callout as k, getServers as l, WebFrame as m, OpenApiOperation as n, defaultServerVariables as o, primitives_exports as p, RequestExamplesPanel as r, getAuthOptions as s, EndpointIdentity as t, getMediaTypeEntries as u, Logo as v, CodeGroup as w, Feedback as x, Heading as y };
 
-//# sourceMappingURL=OpenApiOperation-C9xyRo5a.js.map
+//# sourceMappingURL=OpenApiOperation-CyBkzvob.js.map