@stainless-api/docs-ui 0.1.0-beta.67 → 0.1.0-beta.69

package/dist/{sdk-PiHLvMdV.d.ts → sdk-7I25t5FC.d.ts}

@@ -1,7 +1,7 @@
 import { c as ID, d as Method, f as Model, g as SnippetLanguage, o as HasStainlessPath, t as BaseDeclaration } from "./index-CwjGm9zX.js";
 import { t as DocsLanguage } from "./routing-Cm_9XJiQ.js";
 import * as React$1 from "react";
-import * as react_jsx_runtime32 from "react/jsx-runtime";
+import * as react_jsx_runtime42 from "react/jsx-runtime";
 
 //#region src/components/sdk.d.ts
 type PropertyModelContextType = {
@@ -33,7 +33,7 @@ declare function SDKChildren({
   paths,
   expand,
   depth
-}: SDKChildrenProps): react_jsx_runtime32.JSX.Element;
+}: SDKChildrenProps): react_jsx_runtime42.JSX.Element;
 type SDKDeclarationProps = {
   path: string;
   expand?: boolean;
@@ -43,26 +43,26 @@ declare function SDKDeclaration({
   path,
   expand,
   depth
-}: SDKDeclarationProps): react_jsx_runtime32.JSX.Element;
+}: SDKDeclarationProps): react_jsx_runtime42.JSX.Element;
 type SDKConstraintsProps = {
   constraints?: Record<string, any>;
 };
 declare function SDKConstraints({
   constraints
-}: SDKConstraintsProps): react_jsx_runtime32.JSX.Element | undefined;
+}: SDKConstraintsProps): react_jsx_runtime42.JSX.Element | undefined;
 type SDKIconProps = {
   language: SnippetLanguage;
   size?: number;
 };
 declare function SDKIcon({
   language
-}: SDKIconProps): react_jsx_runtime32.JSX.Element | null;
+}: SDKIconProps): react_jsx_runtime42.JSX.Element | null;
 type SDKRequestTitleProps = {
   snippetLanguage: SnippetLanguage;
 };
 declare function SDKRequestTitle({
   snippetLanguage
-}: SDKRequestTitleProps): react_jsx_runtime32.JSX.Element;
+}: SDKRequestTitleProps): react_jsx_runtime42.JSX.Element;
 type SDKExampleProps = {
   method: Partial<Method> & HasStainlessPath;
   transformRequestSnippet?: TransformRequestSnippetFn;
@@ -70,31 +70,31 @@ type SDKExampleProps = {
 declare function SDKExample({
   method,
   transformRequestSnippet
-}: SDKExampleProps): react_jsx_runtime32.JSX.Element;
+}: SDKExampleProps): react_jsx_runtime42.JSX.Element;
 type SDKMethodProps = {
   method: Method;
   transformRequestSnippet?: TransformRequestSnippetFn;
 };
 declare function SDKMethodHeader({
   method
-}: SDKMethodProps): react_jsx_runtime32.JSX.Element;
+}: SDKMethodProps): react_jsx_runtime42.JSX.Element;
 declare function useStreamingResponse(method: BaseDeclaration): ID | undefined;
 declare function SDKMethodInfo({
   method
-}: SDKMethodProps): react_jsx_runtime32.JSX.Element;
+}: SDKMethodProps): react_jsx_runtime42.JSX.Element;
 declare function SDKMethodNotImplemented({
   method
-}: SDKMethodProps): react_jsx_runtime32.JSX.Element;
+}: SDKMethodProps): react_jsx_runtime42.JSX.Element;
 declare function SDKMethod({
   method,
   transformRequestSnippet
-}: SDKMethodProps): react_jsx_runtime32.JSX.Element;
+}: SDKMethodProps): react_jsx_runtime42.JSX.Element;
 type SDKModelProps = {
   model: Model;
 };
 declare function SDKModel({
   model
-}: SDKModelProps): react_jsx_runtime32.JSX.Element | null;
+}: SDKModelProps): react_jsx_runtime42.JSX.Element | null;
 type SDKReferenceProps = {
   stainlessPath: string;
   children?: React$1.ReactNode;
@@ -102,7 +102,7 @@ type SDKReferenceProps = {
 declare function SDKReference({
   stainlessPath,
   children
-}: SDKReferenceProps): string | number | bigint | boolean | Iterable<React$1.ReactNode> | Promise<string | number | bigint | boolean | React$1.ReactPortal | React$1.ReactElement<unknown, string | React$1.JSXElementConstructor<any>> | Iterable<React$1.ReactNode> | null | undefined> | react_jsx_runtime32.JSX.Element | null | undefined;
+}: SDKReferenceProps): string | number | bigint | boolean | Iterable<React$1.ReactNode> | Promise<string | number | bigint | boolean | React$1.ReactPortal | React$1.ReactElement<unknown, string | React$1.JSXElementConstructor<any>> | Iterable<React$1.ReactNode> | null | undefined> | react_jsx_runtime42.JSX.Element | null | undefined;
 type SDKLanguageBlockProps = {
   language: DocsLanguage;
   version: string;
@@ -117,6 +117,6 @@ declare function SDKLanguageBlock({
   version,
   install,
   links
-}: SDKLanguageBlockProps): react_jsx_runtime32.JSX.Element;
+}: SDKLanguageBlockProps): react_jsx_runtime42.JSX.Element;
 //#endregion
 export { SDKSnippetLanguagesType as C, useStreamingResponse as D, useReferenceNesting as E, SDKSnippetLanguages as S, usePropertyModel as T, SDKModel as _, SDKChildren as a, SDKRequestTitle as b, SDKDeclaration as c, SDKLanguageBlock as d, SDKMethod as f, SDKMethodProps as g, SDKMethodNotImplemented as h, ReferenceNestingContextType as i, SDKExample as l, SDKMethodInfo as m, PropertyModelContextType as n, SDKConstraints as o, SDKMethodHeader as p, ReferenceNestingContext as r, SDKConstraintsProps as s, PropertyModelContext as t, SDKIcon as u, SDKModelProps as v, TransformRequestSnippetFn as w, SDKRequestTitleProps as x, SDKReference as y };

package/dist/{sdk-CMMvOAdj.js → sdk-B69ZT1zY.js}

@@ -3,7 +3,7 @@ import { n as useNavigation } from "./navigation-aoYZ_tl4.js";
 import { n as useLanguageComponents } from "./contexts-CVj20VV4.js";
 import { t as useComponents } from "./use-components-BUz3GbO4.js";
 import { t as style_default } from "./style-HpXpcJ9v.js";
-import { l as getLanguageSnippet, p as parseStainlessPath, s as generateRoute, t as LanguageNames } from "./routing-B7QoUwlD.js";
+import { l as getLanguageSnippet, p as parseStainlessPath, s as generateRoute, t as LanguageNames } from "./routing-C64k4fmX.js";
 import { a as JavaIcon, c as PythonIcon, d as TypescriptIcon, i as GoIcon, l as RubyIcon, n as CSharpIcon, o as KotlinIcon, r as CurlIcon, s as PowershellIcon, t as CLIIcon, u as TerraformIcon } from "./icons-BYKn5X8E.js";
 import * as React$1 from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
@@ -46,10 +46,42 @@ function SDKChildren({ paths, expand, depth }) {
 		}, i))
 	});
 }
+function normalizeDeclaration(raw, http) {
+	console.log({
+		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();
-	const decl = useDeclaration(path, true);
+	const decl = normalizeDeclaration(useDeclaration(path, true), useDeclaration(path.replace(/ > \(schema\)$/, "") + " > (schema)", false, "http"));
 	const settings = useSettings();
 	const model = usePropertyModel();
 	const nesting = useReferenceNesting();
@@ -107,7 +139,7 @@ function SDKDeclaration({ path, expand, depth = 0 }) {
 function SDKConstraints({ constraints }) {
 	if (constraints) return /* @__PURE__ */ jsx("div", {
 		className: style_default.PropertyConstraints,
-		children: Object.entries(constraints).map(([name, value]) => /* @__PURE__ */ jsxs("div", {
+		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,

package/dist/{sdk-sidebar-Ck41RYV8.d.ts → sdk-sidebar-JyrSuu5b.d.ts}

@@ -1,5 +1,5 @@
 import { m as Resource } from "./index-CwjGm9zX.js";
-import * as react_jsx_runtime31 from "react/jsx-runtime";
+import * as react_jsx_runtime41 from "react/jsx-runtime";
 
 //#region src/components/sdk-sidebar.d.ts
 type SDKSidebarProps = {
@@ -10,6 +10,6 @@ type SDKSidebarProps = {
  */
 declare function SDKSidebar({
   resources
-}: SDKSidebarProps): react_jsx_runtime31.JSX.Element;
+}: SDKSidebarProps): react_jsx_runtime41.JSX.Element;
 //#endregion
 export { SDKSidebarProps as n, SDKSidebar as t };

package/dist/{sdk-sidebar-FL7e7_BM.js → sdk-sidebar-V_MTkVw8.js}

@@ -1,5 +1,5 @@
 import { n as useNavigation } from "./navigation-aoYZ_tl4.js";
-import { r as isResourceEmpty } from "./utils-KWHcUI-r.js";
+import { i as isResourceEmpty } from "./utils-DPbkW1Tz.js";
 import { t as StlSidebar } from "./stl-sidebar-WtimNrk1.js";
 import * as React$1 from "react";
 import { jsx } from "react/jsx-runtime";

package/dist/{snippets-DoY3fghd.d.ts → snippets-DZM_ogqa.d.ts}

@@ -1,7 +1,7 @@
 import { d as Method, o as HasStainlessPath } from "./index-CwjGm9zX.js";
-import { w as TransformRequestSnippetFn } from "./sdk-PiHLvMdV.js";
+import { w as TransformRequestSnippetFn } from "./sdk-7I25t5FC.js";
 import * as React$1 from "react";
-import * as react_jsx_runtime45 from "react/jsx-runtime";
+import * as react_jsx_runtime55 from "react/jsx-runtime";
 
 //#region src/components/snippets.d.ts
 type SnippetCodeProps = {
@@ -12,7 +12,7 @@ type SnippetCodeProps = {
 declare function SnippetCode({
   content,
   language
-}: SnippetCodeProps): react_jsx_runtime45.JSX.Element;
+}: SnippetCodeProps): react_jsx_runtime55.JSX.Element;
 type SnippetProps = {
   method: Partial<Method> & HasStainlessPath;
   requestTitle?: React$1.ReactNode;
@@ -25,29 +25,29 @@ type SnippetContainerProps = {
 };
 declare function SnippetContainer({
   children
-}: SnippetContainerProps): react_jsx_runtime45.JSX.Element;
+}: SnippetContainerProps): react_jsx_runtime55.JSX.Element;
 type SnippetRequestContainerProps = {
   children?: React$1.ReactNode;
   signature?: string;
 };
 declare function SnippetRequestContainer({
   children
-}: SnippetRequestContainerProps): react_jsx_runtime45.JSX.Element;
+}: SnippetRequestContainerProps): react_jsx_runtime55.JSX.Element;
 declare function Snippet({
   requestTitle,
   method,
   transformRequestSnippet
-}: SnippetProps): react_jsx_runtime45.JSX.Element | null;
+}: SnippetProps): react_jsx_runtime55.JSX.Element | null;
 declare function SnippetButtons({
   content
 }: {
   content: string;
-}): react_jsx_runtime45.JSX.Element;
+}): react_jsx_runtime55.JSX.Element;
 declare function SnippetFooter(): React$1.ReactNode;
 declare function SnippetResponse({
   responses
 }: {
   responses: Method['exampleResponses'];
-}): react_jsx_runtime45.JSX.Element | null;
+}): react_jsx_runtime55.JSX.Element | null;
 //#endregion
 export { SnippetContainer as a, SnippetProps as c, SnippetResponse as d, SnippetCodeProps as i, SnippetRequestContainer as l, SnippetButtons as n, SnippetContainerProps as o, SnippetCode as r, SnippetFooter as s, Snippet as t, SnippetRequestContainerProps as u };

package/dist/spec.d.ts

@@ -36,13 +36,13 @@ declare function generateNavigation(resource: Partial<Resource>): {
 declare function generateSpecForResource(spec: Spec, name: string, lang: DocsLanguage, transforms: SpecTransforms): Partial<Spec>;
 declare function transform(spec: Spec, transforms: SpecTransforms): {
   name: string;
-  lang: "http" | "node" | "python" | "go" | "typescript" | "terraform" | "ruby" | "java" | "kotlin" | "csharp" | "php" | "cli";
+  lang: "cli" | "csharp" | "go" | "http" | "java" | "kotlin" | "node" | "php" | "python" | "ruby" | "terraform" | "typescript";
   spec: Partial<Spec>;
 }[];
 declare function split(spec: Spec, transforms?: SpecTransforms): {
   resources: ReturnType<typeof transform>;
   navigation: {
-    languages: ("http" | "node" | "python" | "go" | "typescript" | "terraform" | "ruby" | "java" | "kotlin")[] | undefined;
+    languages: ("go" | "http" | "java" | "kotlin" | "node" | "python" | "ruby" | "terraform" | "typescript")[] | undefined;
     resources: {
       [k: string]: {
         title: string | undefined;

package/dist/spec.js

@@ -1,5 +1,5 @@
-import { n as Languages } from "./routing-B7QoUwlD.js";
-import { r as isResourceEmpty } from "./utils-KWHcUI-r.js";
+import { n as Languages } from "./routing-C64k4fmX.js";
+import { i as isResourceEmpty } from "./utils-DPbkW1Tz.js";
 
 //#region src/spec.ts
 const defaultTransforms = {

package/dist/{stl-sidebar-CNGimF4q.d.ts → stl-sidebar-BR04ktwN.d.ts}

@@ -1,5 +1,5 @@
 import { ReactNode } from "react";
-import * as react_jsx_runtime52 from "react/jsx-runtime";
+import * as react_jsx_runtime21 from "react/jsx-runtime";
 
 //#region src/components/stl-sidebar.d.ts
 declare module 'react' {
@@ -53,6 +53,6 @@ type StlSidebarProps = {
 declare function StlSidebar({
   entries,
   withStarlightRestoration
-}: StlSidebarProps): react_jsx_runtime52.JSX.Element;
+}: StlSidebarProps): react_jsx_runtime21.JSX.Element;
 //#endregion
 export { StlSidebarProps as a, StlSidebarLink as i, StlSidebarEntry as n, StlSidebarTarget as o, StlSidebarGroup as r, StlSidebar as t };

package/dist/styles/main.css

@@ -489,6 +489,13 @@
     display: flex;
     gap: 0.5rem;
     flex-direction: column;
+
+    h5 .stl-ui-badge {
+      vertical-align: bottom;
+      margin-left: 0.5em;
+      margin-top: -1px;
+      transform: translateY(1px);
+    }
   }
 
   .stldocs-method-content-column {

package/dist/styles.css

@@ -2319,6 +2319,13 @@ a.stl-ui-button {
     display: flex;
     gap: 0.5rem;
     flex-direction: column;
+
+    h5 .stl-ui-badge {
+      vertical-align: bottom;
+      margin-left: 0.5em;
+      margin-top: -1px;
+      transform: translateY(1px);
+    }
   }
 
   .stldocs-method-content-column {

package/dist/{utils-KWHcUI-r.js → utils-DPbkW1Tz.js}

@@ -1,9 +1,10 @@
 import { t as __exportAll } from "./chunk-BN_g-Awi.js";
-import { p as parseStainlessPath } from "./routing-B7QoUwlD.js";
+import { p as parseStainlessPath } from "./routing-C64k4fmX.js";
 
 //#region src/utils.ts
 var utils_exports = /* @__PURE__ */ __exportAll({
 	flatResources: () => flatResources,
+	getBodyParams: () => getBodyParams,
 	getResourceFromSpec: () => getResourceFromSpec,
 	isResourceEmpty: () => isResourceEmpty
 });
@@ -27,6 +28,27 @@ function getResourceFromSpec(stainlessPath, spec) {
 function isResourceEmpty(resource) {
 	return !(Object.values(resource.methods).length > 0 || Object.values(resource.models).length > 0 || Object.values(resource.subresources).length > 0);
 }
+function getBodyParams(decl) {
+	if (!decl.bodyParamsChildren) return null;
+	const keys = Object.keys(decl.bodyParamsChildren);
+	if (keys.length > 1) console.warn("multiple bodyParams content types in " + decl.stainlessPath + ":", keys);
+	const jsonKey = keys.find((e) => /[/+]json(;|$)/.test(e));
+	if (jsonKey) return {
+		params: decl.bodyParamsChildren[jsonKey],
+		encoding: "json"
+	};
+	const formDataKey = keys.find((e) => /^multipart\/form-data(;|$)/.test(e));
+	if (formDataKey) return {
+		params: decl.bodyParamsChildren[formDataKey],
+		encoding: "form-data"
+	};
+	const firstKey = keys[0];
+	if (firstKey) return {
+		params: decl.bodyParamsChildren[firstKey],
+		encoding: "unknown"
+	};
+	return null;
+}
 
 //#endregion
-export { utils_exports as i, getResourceFromSpec as n, isResourceEmpty as r, flatResources as t };
+export { utils_exports as a, isResourceEmpty as i, getBodyParams as n, getResourceFromSpec as r, flatResources as t };

package/dist/utils.d.ts

@@ -1,8 +1,8 @@
-import { _ as Spec, m as Resource } from "./index-CwjGm9zX.js";
+import { _ as Spec, c as ID, m as Resource, s as HttpAST } from "./index-CwjGm9zX.js";
 
 //#region src/utils.d.ts
 declare namespace utils_d_exports {
-  export { flatResources, getResourceFromSpec, isResourceEmpty };
+  export { AssertExhaustive, HttpBodyEncoding, flatResources, getBodyParams, getResourceFromSpec, isResourceEmpty };
 }
 declare function flatResources(resources: Record<string, Resource> | undefined, parents: Resource[]): {
   resource: Resource;
@@ -10,5 +10,11 @@ declare function flatResources(resources: Record<string, Resource> | undefined,
 }[];
 declare function getResourceFromSpec(stainlessPath: string | string[], spec: Spec): Resource | null;
 declare function isResourceEmpty(resource: Resource): boolean;
+type HttpBodyEncoding = 'json' | 'form-data' | 'unknown';
+declare function getBodyParams(decl: HttpAST.HttpDeclFunction): {
+  params: ID[];
+  encoding: HttpBodyEncoding;
+} | null;
+type AssertExhaustive<T extends never> = T;
 //#endregion
-export { flatResources, getResourceFromSpec, isResourceEmpty, utils_d_exports as t };
+export { AssertExhaustive, HttpBodyEncoding, flatResources, getBodyParams, getResourceFromSpec, isResourceEmpty, utils_d_exports as t };

package/dist/utils.js

@@ -1,3 +1,3 @@
-import { n as getResourceFromSpec, r as isResourceEmpty, t as flatResources } from "./utils-KWHcUI-r.js";
+import { i as isResourceEmpty, n as getBodyParams, r as getResourceFromSpec, t as flatResources } from "./utils-DPbkW1Tz.js";
 
-export { flatResources, getResourceFromSpec, isResourceEmpty };
+export { flatResources, getBodyParams, getResourceFromSpec, isResourceEmpty };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stainless-api/docs-ui",
   "private": false,
-  "version": "0.1.0-beta.67",
+  "version": "0.1.0-beta.69",
   "publishConfig": {
     "access": "public"
   },
@@ -16,17 +16,17 @@
   "dependencies": {
     "@markdoc/markdoc": "^0.5.4",
     "clsx": "^2.1.1",
-    "htmlparser2": "^10.0.0",
+    "htmlparser2": "^10.1.0",
     "lucide-react": "^0.562.0",
     "@stainless-api/ui-primitives": "0.1.0-beta.47"
   },
   "devDependencies": {
     "@types/node": "24.10.9",
-    "@types/react": "19.2.7",
+    "@types/react": "19.2.10",
     "@types/react-dom": "^19.2.3",
     "dotenv": "17.2.3",
-    "react": "^19.2.3",
-    "react-dom": "^19.2.3",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
     "tsdown": "^0.20.0",
     "typescript": "5.9.3",
     "@stainless/eslint-config": "0.1.0-beta.1",