@stainless-api/docs-ui 0.1.0-beta.9 → 0.1.0-beta.91

package/dist/components/properties.js

@@ -0,0 +1,143 @@
+import { useIgnoredResources, useLanguage, useSettings } from "../contexts/docs.js";
+import "../contexts/index.js";
+import { useComponents } from "../contexts/use-components.js";
+import style_default from "../style.js";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { ArrowDownWideNarrowIcon, ArrowUpNarrowWideIcon, LinkIcon } from "lucide-react";
+import { Button } from "@stainless-api/ui-primitives";
+//#region src/components/properties.tsx
+function PropertyToggle({ target }) {
+	return /* @__PURE__ */ jsxs("span", {
+		className: style_default.ExpandToggle,
+		"data-stldocs-property-toggle-expanded": "false",
+		"data-stldocs-property-toggle-target": target,
+		children: [/* @__PURE__ */ jsxs("span", {
+			className: style_default.ExpandToggleContent,
+			children: ["Expand ", /* @__PURE__ */ jsx(ArrowDownWideNarrowIcon, {
+				className: style_default.Icon,
+				size: 16
+			})]
+		}), /* @__PURE__ */ jsxs("span", {
+			className: style_default.ExpandToggleContent,
+			children: ["Collapse ", /* @__PURE__ */ jsx(ArrowUpNarrowWideIcon, {
+				className: style_default.Icon,
+				size: 16
+			})]
+		})]
+	});
+}
+function PropertyDescription({ description }) {
+	const { Markdown } = useComponents();
+	if (description) return /* @__PURE__ */ jsx("div", {
+		className: style_default.PropertyDescription,
+		children: /* @__PURE__ */ jsx(Markdown, { content: description })
+	});
+}
+function PropertyTitle({ title }) {
+	const { Markdown } = useComponents();
+	if (title) return /* @__PURE__ */ jsx("div", {
+		className: style_default.PropertyTitle,
+		children: /* @__PURE__ */ jsx(Markdown, { content: title })
+	});
+}
+function splitDescription(description) {
+	const pos = description?.indexOf("\n\n");
+	if (!description || !pos || pos < 0) return [description, null];
+	return [description.slice(0, pos), description.slice(pos)];
+}
+function Property({ id, name, typeName, badges, type, declaration, description, title, deprecated, expand, additional, constraints, children }) {
+	const Docs = useComponents();
+	const language = useLanguage();
+	const { collapseDescription, showTitle, types } = useSettings()?.properties ?? {};
+	if (useIgnoredResources().includes(id || "")) return null;
+	const [descFirstLine, descRest] = collapseDescription === "show-first-line" ? splitDescription(description) : [null, description];
+	const textContent = /* @__PURE__ */ jsxs(Fragment, { children: [
+		typeof deprecated === "string" && /* @__PURE__ */ jsx("div", {
+			className: style_default.PropertyDeprecatedMessage,
+			children: deprecated
+		}),
+		descRest && /* @__PURE__ */ jsx(Docs.PropertyDescription, { description: descRest }),
+		constraints ? /* @__PURE__ */ jsx("div", {
+			className: style_default.PropertyContent,
+			children: constraints
+		}) : null
+	] });
+	const rich = /* @__PURE__ */ jsxs(Fragment, { children: [
+		/* @__PURE__ */ jsxs("div", {
+			className: style_default.PropertyDeclaration,
+			children: [
+				deprecated && /* @__PURE__ */ jsx("span", {
+					className: style_default.PropertyDeprecated,
+					children: "Deprecated"
+				}),
+				declaration,
+				badges ? /* @__PURE__ */ jsx("span", {
+					className: style_default.PropertyBadges,
+					children: badges
+				}) : null
+			]
+		}),
+		title && showTitle && /* @__PURE__ */ jsx(Docs.PropertyTitle, { title }),
+		collapseDescription === false ? textContent : descFirstLine && /* @__PURE__ */ jsx(Docs.PropertyDescription, { description: descFirstLine })
+	] });
+	const simple = /* @__PURE__ */ jsxs(Fragment, { children: [
+		name ? /* @__PURE__ */ jsxs("div", {
+			className: style_default.PropertyHeader,
+			children: [
+				deprecated && /* @__PURE__ */ jsx("span", {
+					className: style_default.PropertyDeprecated,
+					children: "Deprecated"
+				}),
+				/* @__PURE__ */ jsx("span", {
+					className: style_default.PropertyName,
+					children: name
+				}),
+				typeName ? /* @__PURE__ */ jsx("span", {
+					className: style_default.PropertyTypeName,
+					children: typeName
+				}) : null,
+				badges ? /* @__PURE__ */ jsx("span", {
+					className: style_default.PropertyBadges,
+					children: badges
+				}) : null
+			]
+		}) : null,
+		type ? /* @__PURE__ */ jsx("div", {
+			className: style_default.PropertyType,
+			children: type
+		}) : null,
+		title && showTitle && /* @__PURE__ */ jsx(Docs.PropertyTitle, { title }),
+		collapseDescription === false ? textContent : null
+	] });
+	const content = /* @__PURE__ */ jsx("div", {
+		id,
+		className: style_default.PropertyInfo,
+		children: types === "simple" ? simple : rich
+	});
+	return /* @__PURE__ */ jsxs("div", {
+		className: style_default.Property,
+		"data-stldocs-language": language,
+		children: [children || collapseDescription !== false && descRest ? /* @__PURE__ */ jsxs(Docs.Expander, {
+			summary: content,
+			muted: !children,
+			open: expand,
+			children: [
+				collapseDescription !== false ? textContent : null,
+				additional,
+				children ? /* @__PURE__ */ jsx("div", {
+					className: style_default.PropertyChildren,
+					children
+				}) : null
+			]
+		}) : content, id && /* @__PURE__ */ jsx(Button, {
+			className: style_default.DeepLinkButton,
+			variant: "outline",
+			size: "sm",
+			href: `#${encodeURIComponent(id)}`,
+			"aria-label": "Link to this property",
+			children: /* @__PURE__ */ jsx(Button.Icon, { icon: LinkIcon })
+		})]
+	});
+}
+//#endregion
+export { Property, PropertyDescription, PropertyTitle, PropertyToggle };

package/dist/components/sdk-sidebar.d.ts

@@ -0,0 +1,2 @@
+import { n as SDKSidebarProps, t as SDKSidebar } from "../sdk-sidebar-CRqLm3YO.js";
+export { SDKSidebar, SDKSidebarProps };

package/dist/components/sdk-sidebar.js

@@ -0,0 +1,49 @@
+import { useNavigation } from "../contexts/navigation.js";
+import "../contexts/index.js";
+import { isResourceEmpty } from "../utils.js";
+import { StlSidebar } from "./stl-sidebar.js";
+import * as React$1 from "react";
+import { jsx } from "react/jsx-runtime";
+import { Badge, getHttpMethod } from "@stainless-api/ui-primitives";
+//#region src/components/sdk-sidebar.tsx
+function resourceToEntry(resource, selectedPath) {
+	const result = {
+		type: "group",
+		collapsed: false,
+		label: resource.title,
+		entries: [],
+		target: {
+			type: "stainlessPath",
+			stainlessPath: resource.stainlessPath
+		},
+		isCurrent: selectedPath === resource.stainlessPath
+	};
+	for (const method of Object.values(resource.methods)) {
+		const httpMethod = getHttpMethod(method.httpMethod);
+		result.entries.push({
+			type: "link",
+			target: {
+				type: "stainlessPath",
+				stainlessPath: method.stainlessPath
+			},
+			label: method.title,
+			isCurrent: selectedPath === method.stainlessPath,
+			icon: httpMethod ? /* @__PURE__ */ jsx(Badge.HTTP, {
+				method: httpMethod,
+				iconOnly: true,
+				size: "sm"
+			}) : void 0
+		});
+	}
+	for (const subresource of Object.values(resource.subresources ?? {})) result.entries.push(resourceToEntry(subresource, selectedPath));
+	return result;
+}
+/**
+* Given some SDKJSON.Resources, calls into StlSidebar with the appropriate sidebar entries.
+*/
+function SDKSidebar({ resources }) {
+	const { selectedPath } = useNavigation();
+	return /* @__PURE__ */ jsx(StlSidebar, { entries: React$1.useMemo(() => resources.filter((resource) => !isResourceEmpty(resource)).map((resource) => resourceToEntry(resource, selectedPath)), [resources, selectedPath]) });
+}
+//#endregion
+export { SDKSidebar };

package/dist/components/sdk.d.ts

@@ -0,0 +1,2 @@
+import { A as useStreamingResponse, C as SDKRequestTitleProps, D as useDeclarationParents, E as TransformRequestSnippetFn, O as usePropertyModel, S as SDKRequestTitle, T as SDKSnippetLanguagesType, _ as SDKMethodNotImplemented, a as ReferenceNestingContextType, b as SDKModelProps, c as SDKConstraintsProps, d as SDKIcon, f as SDKLanguageBlock, g as SDKMethodInfoContent, h as SDKMethodInfo, i as ReferenceNestingContext, k as useReferenceNesting, l as SDKDeclaration, m as SDKMethodHeader, n as PropertyModelContext, o as SDKChildren, p as SDKMethod, r as PropertyModelContextType, s as SDKConstraints, t as DeclarationParentsContextType, u as SDKExample, v as SDKMethodProps, w as SDKSnippetLanguages, x as SDKReference, y as SDKModel } from "../sdk-BengV7mg.js";
+export { DeclarationParentsContextType, PropertyModelContext, PropertyModelContextType, ReferenceNestingContext, ReferenceNestingContextType, SDKChildren, SDKConstraints, SDKConstraintsProps, SDKDeclaration, SDKExample, SDKIcon, SDKLanguageBlock, SDKMethod, SDKMethodHeader, SDKMethodInfo, SDKMethodInfoContent, SDKMethodNotImplemented, SDKMethodProps, SDKModel, SDKModelProps, SDKReference, SDKRequestTitle, SDKRequestTitleProps, SDKSnippetLanguages, SDKSnippetLanguagesType, TransformRequestSnippetFn, useDeclarationParents, usePropertyModel, useReferenceNesting, useStreamingResponse };

package/dist/components/sdk.js

@@ -0,0 +1,487 @@
+import { useAvailableLanguages, useContentPanelLayout, useDeclaration, useLanguage, useSettings, useSnippetIds, useSnippetResponse, useSpec } from "../contexts/docs.js";
+import { useNavigation } from "../contexts/navigation.js";
+import { useLanguageComponents } from "../contexts/index.js";
+import { useComponents } from "../contexts/use-components.js";
+import style_default from "../style.js";
+import { LanguageNames, generateRoute, getLanguageSnippet, parseStainlessPath } from "../routing.js";
+import { CLIIcon, CSharpIcon, CurlIcon, GithubIcon, GoIcon, JavaIcon, KotlinIcon, PHPIcon, PowershellIcon, PythonIcon, RubyIcon, TerraformIcon, TypescriptIcon } from "./icons.js";
+import * as React$1 from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+import clsx from "clsx";
+import { BookOpenIcon, CopyIcon } from "lucide-react";
+import { Button, Callout } from "@stainless-api/ui-primitives";
+//#region src/components/sdk.tsx
+const PropertyModelContext = React$1.createContext({});
+function usePropertyModel() {
+	return React$1.use(PropertyModelContext);
+}
+const ReferenceNestingContext = React$1.createContext([]);
+function useReferenceNesting() {
+	return React$1.use(ReferenceNestingContext);
+}
+const DeclarationParentsContext = React$1.createContext(/* @__PURE__ */ new Set());
+const AddToDeclarationParents = ({ id, children }) => /* @__PURE__ */ jsx(DeclarationParentsContext, {
+	value: new Set([...useDeclarationParents(), id.replace(/(?<=> \(schema\))((?!> \(schema\) > ).)+$/, "")]),
+	children
+});
+function useDeclarationParents() {
+	return React$1.use(DeclarationParentsContext);
+}
+const SDKSnippetLanguages = {
+	"node.default": { name: "TypeScript" },
+	"typescript.default": { name: "TypeScript" },
+	"python.default": { name: "Python" },
+	"go.default": { name: "Go" },
+	"java.default": { name: "Java" },
+	"kotlin.default": { name: "Kotlin" },
+	"http.curl": { name: "cURL" },
+	"http.powershell": { name: "Powershell" },
+	"terraform.default": { name: "Terraform" },
+	"ruby.default": { name: "Ruby" },
+	"csharp.default": { name: "C#" },
+	"php.default": { name: "PHP" },
+	"cli.default": { name: "CLI tool" }
+};
+function SDKChildren({ paths, expand, depth }) {
+	const Docs = useComponents();
+	return /* @__PURE__ */ jsx("div", {
+		className: style_default.Properties,
+		children: paths.map((path, i) => /* @__PURE__ */ jsx(Docs.SDKDeclaration, {
+			path,
+			expand,
+			depth
+		}, i))
+	});
+}
+function normalizeDeclaration(raw, http) {
+	if (raw.kind === "JavaDeclProperty" && raw.type.kind === "JavaTypeString" && raw.constraints?.format === "binary") return {
+		...raw,
+		type: {
+			kind: "JavaTypeReference",
+			typeName: "InputStream"
+		}
+	};
+	if (http?.kind === "HttpDeclProperty" && http.type.kind === "HttpTypeString" && http.constraints?.format === "binary") switch (raw.kind) {
+		case "CLISchemaProperty":
+		case "CLIFlag":
+		case "HttpDeclProperty": return {
+			...raw,
+			type: {
+				kind: "HttpTypeBinary",
+				contentType: []
+			}
+		};
+		case "RubyDeclProperty": return {
+			...raw,
+			type: {
+				kind: "RubyTypeBinary",
+				contentType: []
+			}
+		};
+	}
+	return raw;
+}
+function SDKDeclaration({ path, expand, depth = 0 }) {
+	const Lang = useLanguageComponents();
+	const Docs = useComponents();
+	let pendingDecl = normalizeDeclaration(useDeclaration(path, true), useDeclaration(path.replace(/ > \(schema\)$/, "") + " > (schema)", false, "http"));
+	const settings = useSettings();
+	const model = usePropertyModel();
+	const nesting = useReferenceNesting();
+	const { selectedPath, basePath } = useNavigation();
+	const parents = useDeclarationParents();
+	const language = useLanguage();
+	if (parents.has(path)) if (pendingDecl.kind === "GoDeclType") pendingDecl = {
+		...pendingDecl,
+		kind: "GoDeclType",
+		type: {
+			kind: "GoTypeReference",
+			typeName: pendingDecl.ident,
+			$ref: pendingDecl.stainlessPath
+		},
+		children: []
+	};
+	else if (pendingDecl.kind === "HttpDeclTypeAlias") pendingDecl = {
+		...pendingDecl,
+		kind: "HttpDeclTypeAlias",
+		children: []
+	};
+	else if (pendingDecl.kind === "PythonDeclClass") pendingDecl = {
+		kind: "PythonDeclType",
+		ident: pendingDecl.ident,
+		stainlessPath: pendingDecl.stainlessPath,
+		type: {
+			kind: "PythonTypeReference",
+			typeName: pendingDecl.ident,
+			$ref: pendingDecl.stainlessPath
+		}
+	};
+	else if (pendingDecl.kind === "TSDeclInterface") pendingDecl = {
+		kind: "TSDeclTypeAlias",
+		ident: pendingDecl.ident,
+		stainlessPath: pendingDecl.stainlessPath,
+		type: {
+			kind: "TSTypeReference",
+			ident: pendingDecl.ident,
+			$ref: pendingDecl.stainlessPath
+		}
+	};
+	else if ("ident" in pendingDecl) {
+		const ident = pendingDecl.ident;
+		const url = generateRoute(basePath ?? "/", language, pendingDecl.stainlessPath);
+		return /* @__PURE__ */ jsx("span", {
+			className: style_default.Type,
+			children: /* @__PURE__ */ jsx("span", {
+				className: style_default.TypeReference,
+				children: url ? /* @__PURE__ */ jsx("a", {
+					href: url,
+					children: ident
+				}) : ident
+			})
+		});
+	} else throw new Error("Infinite recursion in SDKDeclaration: " + JSON.stringify({
+		parents: [...parents],
+		path,
+		pendingDecl
+	}));
+	const decl = pendingDecl;
+	if (decl.kind.endsWith("Reference")) {
+		const refId = "type" in decl && decl.type !== void 0 && typeof decl.type !== "string" && "$ref" in decl.type ? decl.type["$ref"] : void 0;
+		if (refId && refId !== path && !nesting.includes(refId)) return /* @__PURE__ */ jsx(AddToDeclarationParents, {
+			id: path,
+			children: /* @__PURE__ */ jsx(ReferenceNestingContext, {
+				value: [...nesting, refId],
+				children: /* @__PURE__ */ jsx(SDKDeclaration, {
+					path: refId,
+					expand,
+					depth
+				})
+			})
+		});
+	}
+	const parsedPath = selectedPath ? parseStainlessPath(selectedPath) : null;
+	const modelPropSetting = settings?.properties?.includeModelProperties;
+	const inlineModelProps = modelPropSetting === "method-page" ? Boolean(parsedPath?.method) : modelPropSetting !== false;
+	const isUnion = "childrenParentSchema" in decl && !!decl.childrenParentSchema && decl.kind !== "CLIFlag" && decl.kind !== "CLISchemaProperty" && ["enum", "union"].includes(decl.childrenParentSchema);
+	const id = model?.propertyPath ? `${model.propertyPath} + ${path}` : path;
+	const shouldExpand = selectedPath?.startsWith(path) && nesting.length < 1 || settings?.properties?.expandDepth && depth <= settings?.properties?.expandDepth && !isUnion || expand;
+	const hasChildren = "children" in decl && (decl.children?.length ?? 0) > 0 && !decl.children?.includes(path) && !(isUnion && decl.childrenParentSchema === "enum" && decl.children?.length === 1) && (inlineModelProps || !("modelPath" in decl));
+	const content = /* @__PURE__ */ jsx(Lang.Property, {
+		decl,
+		children: ({ ...props }) => /* @__PURE__ */ jsx(Docs.Property, {
+			id,
+			expand: shouldExpand,
+			constraints: "constraints" in decl && decl.kind !== "CLIFlag" && decl.kind !== "CLISchemaProperty" && /* @__PURE__ */ jsx(Docs.SDKConstraints, { constraints: decl["constraints"] }),
+			declaration: /* @__PURE__ */ jsx(Lang.Declaration, { decl }),
+			title: "title" in decl ? decl.title : void 0,
+			description: "docstring" in decl ? decl["docstring"] : void 0,
+			deprecated: decl.deprecated,
+			...props,
+			children: hasChildren && /* @__PURE__ */ jsxs(Fragment$1, { children: [isUnion && /* @__PURE__ */ jsx("div", {
+				className: style_default.PropertyAnnotation,
+				children: "One of the following:"
+			}), /* @__PURE__ */ jsx(Docs.SDKChildren, {
+				paths: decl.children ?? [],
+				depth: depth + 1
+			})] })
+		})
+	});
+	if ("modelPath" in decl) return /* @__PURE__ */ jsx(AddToDeclarationParents, {
+		id: path,
+		children: /* @__PURE__ */ jsx(PropertyModelContext, {
+			value: {
+				modelPath: decl.modelPath,
+				propertyPath: decl.stainlessPath
+			},
+			children: content
+		})
+	});
+	return /* @__PURE__ */ jsx(AddToDeclarationParents, {
+		id: path,
+		children: content
+	});
+}
+function SDKConstraints({ constraints }) {
+	if (constraints) return /* @__PURE__ */ jsx("div", {
+		className: style_default.PropertyConstraints,
+		children: Object.entries(constraints).map(([name, value]) => name === "format" && value === "binary" ? null : /* @__PURE__ */ jsxs("div", {
+			className: style_default.PropertyConstraint,
+			children: [/* @__PURE__ */ jsx("span", {
+				className: style_default.PropertyConstraintName,
+				children: name
+			}), /* @__PURE__ */ jsx("span", {
+				className: style_default.PropertyConstraintValue,
+				children: value
+			})]
+		}, name))
+	});
+}
+const snippetIcons = {
+	"node.default": TypescriptIcon,
+	"typescript.default": TypescriptIcon,
+	"go.default": GoIcon,
+	"python.default": PythonIcon,
+	"terraform.default": TerraformIcon,
+	"http.curl": CurlIcon,
+	"http.powershell": PowershellIcon,
+	"ruby.default": RubyIcon,
+	"java.default": JavaIcon,
+	"kotlin.default": KotlinIcon,
+	"csharp.default": CSharpIcon,
+	"cli.default": CLIIcon,
+	"php.default": PHPIcon
+};
+function SDKIcon({ language }) {
+	const LangIcon = snippetIcons[language];
+	if (!LangIcon) return null;
+	return /* @__PURE__ */ jsx(LangIcon, { className: clsx(style_default.Icon, language.split(".").shift()) });
+}
+function SDKRequestTitle({ snippetLanguage }) {
+	const languageName = SDKSnippetLanguages[snippetLanguage]?.name;
+	return /* @__PURE__ */ jsxs("span", {
+		className: style_default.SnippetRequestTitleLanguage,
+		children: [
+			/* @__PURE__ */ jsx(SDKIcon, { language: snippetLanguage }),
+			" ",
+			languageName
+		]
+	});
+}
+function SDKExample({ method, transformRequestSnippet }) {
+	const Docs = useComponents();
+	const language = useLanguage();
+	const snippetLanguage = getLanguageSnippet(language);
+	if ((useSnippetIds(method.stainlessPath, language)?.filter((id) => id !== "default")?.length ?? 0) >= 2) return /* @__PURE__ */ jsx(Docs.MultiSnippets, {
+		requestTitle: /* @__PURE__ */ jsx(Docs.SDKRequestTitle, { snippetLanguage }),
+		method
+	});
+	return /* @__PURE__ */ jsx(Docs.Snippet, {
+		requestTitle: /* @__PURE__ */ jsx(Docs.SDKRequestTitle, { snippetLanguage }),
+		method,
+		transformRequestSnippet
+	});
+}
+function SDKMethodHeader({ method }) {
+	const Docs = useComponents();
+	const Lang = useLanguageComponents();
+	const decl = useDeclaration(method.stainlessPath, true);
+	return /* @__PURE__ */ jsx(Docs.MethodHeader, {
+		level: "h1",
+		title: method.summary || method.title,
+		signature: /* @__PURE__ */ jsx(Lang.MethodSignature, { decl }),
+		badges: method.deprecated && /* @__PURE__ */ jsx(Docs.Badge, {
+			id: "deprecated",
+			children: "Deprecated"
+		}),
+		children: /* @__PURE__ */ jsx(Docs.MethodRoute, {
+			httpMethod: method.httpMethod,
+			endpoint: method.endpoint.split(" ", 2).at(-1)
+		})
+	});
+}
+function useStreamingResponse(method) {
+	const tsDecl = useDeclaration(method.stainlessPath, false, "typescript");
+	if (tsDecl?.kind === "TSDeclFunction" && tsDecl.overloads) {
+		for (const e of tsDecl.overloads) if (e.returns.kind === "TSTypeReference" && (e.returns.$ref === "$.typescript.Stream" || e.returns.$ref === "$.node.Stream") && e.returns.typeParameters?.[0]?.kind === "TSTypeReference") {
+			const id = e.returns.typeParameters?.[0].$ref;
+			if (id) return id;
+		}
+	}
+}
+function SDKMethodInfo({ method, children }) {
+	const Docs = useComponents();
+	const Lang = useLanguageComponents();
+	const decl = useDeclaration(method.stainlessPath, true);
+	const streamingResponseID = useStreamingResponse(method);
+	const streamingResponseDecl = useDeclaration(streamingResponseID ?? "", false);
+	const spec = useSpec();
+	const language = useLanguage();
+	if (Lang.MethodInfo) return /* @__PURE__ */ jsx(Lang.MethodInfo, {
+		decl,
+		children
+	});
+	function shouldExpand(items) {
+		if (items.length > 1) return false;
+		const item = items[0];
+		if (!item) return false;
+		const decl = spec?.decls?.[language]?.[item];
+		return decl && "children" in decl && decl.children && decl.children.length > 0;
+	}
+	const responseChildren = "responseChildren" in decl && decl.responseChildren && decl.responseChildren.length > 0 ? [...decl.responseChildren] : [];
+	if (streamingResponseDecl && streamingResponseID && !responseChildren.includes(streamingResponseID)) responseChildren.push(streamingResponseID);
+	return /* @__PURE__ */ jsx(Docs.MethodInfo, {
+		parameters: "paramsChildren" in decl && Array.isArray(decl.paramsChildren) && decl.paramsChildren.length > 0 && /* @__PURE__ */ jsx(Docs.SDKChildren, {
+			expand: shouldExpand(decl.paramsChildren),
+			paths: decl.paramsChildren
+		}),
+		returns: responseChildren.length > 0 && /* @__PURE__ */ jsx(Docs.SDKChildren, {
+			expand: shouldExpand(responseChildren),
+			paths: responseChildren
+		}),
+		children
+	});
+}
+function SDKMethodNotImplemented({ method }) {
+	const Docs = useComponents();
+	const languages = useAvailableLanguages(method?.stainlessPath);
+	const language = useLanguage();
+	const { basePath } = useNavigation();
+	const availableLanguageLinks = languages.flatMap((lang) => {
+		const url = generateRoute(basePath ?? "/", lang, method.stainlessPath);
+		return url ? [{
+			url,
+			label: LanguageNames[lang] ?? lang
+		}] : [];
+	});
+	return /* @__PURE__ */ jsxs("div", {
+		className: style_default.Method,
+		children: [/* @__PURE__ */ jsx(Docs.MethodHeader, {
+			level: "h1",
+			title: method.summary || method.title,
+			children: /* @__PURE__ */ jsx(Docs.MethodRoute, {
+				httpMethod: method.httpMethod,
+				endpoint: method.endpoint.split(" ", 2).at(-1)
+			})
+		}), /* @__PURE__ */ jsxs(Callout, {
+			variant: "warning",
+			children: [
+				"The method ",
+				/* @__PURE__ */ jsx("code", { children: method.name }),
+				" is not implemented in ",
+				LanguageNames[language] ?? language,
+				basePath && availableLanguageLinks.length > 0 ? /* @__PURE__ */ jsxs(Fragment$1, { children: [", but it is available in the following languages:", /* @__PURE__ */ jsx("ul", { children: availableLanguageLinks.map(({ url, label }) => {
+					return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx("a", {
+						href: url,
+						children: label
+					}) }, url);
+				}) })] }) : "."
+			]
+		})]
+	});
+}
+function SDKMethodInfoContent(_props) {
+	return null;
+}
+function SDKMethod({ method, transformRequestSnippet }) {
+	const Docs = useComponents();
+	const decl = useDeclaration(method?.stainlessPath, false);
+	const layout = useContentPanelLayout();
+	const defaultResponses = useSnippetResponse(method.stainlessPath);
+	if (!decl) return /* @__PURE__ */ jsx(SDKMethodNotImplemented, { method });
+	return /* @__PURE__ */ jsxs(Docs.Method, {
+		id: method.stainlessPath,
+		header: /* @__PURE__ */ jsx(Docs.SDKMethodHeader, { method }),
+		className: clsx({
+			[style_default.MethodSinglePane]: layout === "single-pane",
+			[style_default.MethodDoublePane]: layout === "double-pane"
+		}),
+		children: [
+			/* @__PURE__ */ jsxs("div", {
+				className: style_default.MethodContentColumn,
+				children: [/* @__PURE__ */ jsx(Docs.MethodDescription, { description: method.description }), /* @__PURE__ */ jsx(Docs.SDKMethodInfo, {
+					method,
+					children: /* @__PURE__ */ jsx(Docs.SDKMethodInfoContent, { method })
+				})]
+			}),
+			/* @__PURE__ */ jsx("div", {
+				className: clsx(style_default.MethodExample, "not-content", "stl-ui-not-prose"),
+				children: /* @__PURE__ */ jsx(Docs.SDKExample, {
+					method,
+					transformRequestSnippet
+				})
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: style_default.MethodResponseColumn,
+				children: [/* @__PURE__ */ jsx("h5", { children: "Returns Examples" }), /* @__PURE__ */ jsx(Docs.SnippetResponse, { responses: defaultResponses })]
+			})
+		]
+	});
+}
+function SDKModel({ model }) {
+	const Docs = useComponents();
+	if (!useDeclaration(`${model.stainlessPath} > (schema)`, true)) return null;
+	return /* @__PURE__ */ jsx("div", {
+		className: style_default.Model,
+		tabIndex: 0,
+		children: /* @__PURE__ */ jsx("div", {
+			className: style_default.ResourceContentProperties,
+			children: /* @__PURE__ */ jsx(Docs.SDKDeclaration, { path: `${model.stainlessPath} > (schema)` })
+		})
+	});
+}
+function SDKReference({ stainlessPath, children }) {
+	const Docs = useComponents();
+	if (!stainlessPath || !stainlessPath.endsWith("(schema)")) return children;
+	return /* @__PURE__ */ jsx("span", {
+		className: style_default.TypeReference,
+		children: /* @__PURE__ */ jsx(Docs.Link, {
+			stainlessPath,
+			children
+		})
+	});
+}
+function SDKLanguageBlock({ language, version, install, links }) {
+	const Docs = useComponents();
+	const lang = `${language}.default`;
+	return /* @__PURE__ */ jsxs("div", {
+		className: style_default.LanguageBlock,
+		children: [
+			/* @__PURE__ */ jsxs("div", {
+				className: style_default.LanguageBlockContent,
+				children: [/* @__PURE__ */ jsx("div", {
+					className: style_default.LanguageBlockContentIcon,
+					children: /* @__PURE__ */ jsx(Docs.SDKIcon, {
+						language: lang,
+						size: 24
+					})
+				}), /* @__PURE__ */ jsxs("div", {
+					className: style_default.LanguageBlockContentInfo,
+					children: [/* @__PURE__ */ jsx("div", {
+						className: style_default.LanguageBlockContentInfoLanguage,
+						children: Docs.SDKSnippetLanguages[lang].name
+					}), /* @__PURE__ */ jsx("div", {
+						className: style_default.LanguageBlockContentInfoVersion,
+						children: version
+					})]
+				})]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: style_default.LanguageBlockInstall,
+				"data-stldocs-copy-parent": true,
+				children: [
+					/* @__PURE__ */ jsx("pre", {
+						"data-stldocs-copy-content": true,
+						children: install
+					}),
+					" ",
+					/* @__PURE__ */ jsx(Button, {
+						variant: "ghost",
+						size: "sm",
+						"data-stldocs-snippet-copy": true,
+						children: /* @__PURE__ */ jsx(CopyIcon, {
+							size: 16,
+							className: style_default.Icon
+						})
+					})
+				]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: style_default.LanguageBlockLinks,
+				children: [/* @__PURE__ */ jsx(Button, {
+					href: links.repo,
+					variant: "outline",
+					children: /* @__PURE__ */ jsx(Button.Icon, {
+						icon: GithubIcon,
+						style: { color: "var(--stl-color-foreground-reduced)" }
+					})
+				}), /* @__PURE__ */ jsxs(Button, {
+					href: links.docs,
+					variant: "outline",
+					children: [/* @__PURE__ */ jsx(Button.Icon, { icon: BookOpenIcon }), /* @__PURE__ */ jsx(Button.Label, { children: "Read Docs" })]
+				})]
+			})
+		]
+	});
+}
+//#endregion
+export { PropertyModelContext, ReferenceNestingContext, SDKChildren, SDKConstraints, SDKDeclaration, SDKExample, SDKIcon, SDKLanguageBlock, SDKMethod, SDKMethodHeader, SDKMethodInfo, SDKMethodInfoContent, SDKMethodNotImplemented, SDKModel, SDKReference, SDKRequestTitle, SDKSnippetLanguages, useDeclarationParents, usePropertyModel, useReferenceNesting, useStreamingResponse };