@stainless-api/docs-ui 0.1.0-beta.82 → 0.1.0-beta.84

package/dist/markdown/index.js

@@ -1,6 +1,6 @@
 import "../use-strict-context-L0c8JKg4.js";
 import { code, fence, heading, item, list, paragraph, parse, strong, text } from "./md.js";
-import { getDecl, getSnippet, stripMarkup } from "./utils.js";
+import { getCustomSnippetTitle, getDecl, getSnippets, stripMarkup } from "./utils.js";
 import { declaration as declaration$1, methodSignature, t as printer_exports } from "./printer.js";
 import Markdoc from "@markdoc/markdoc";
 
@@ -27,7 +27,7 @@ function renderMethod(env, method) {
 	const signature = methodSignature(env.language, decl);
 	const [httpMethod, endpoint] = method.endpoint.split(" ");
 	const output = [
-		heading(2, method.title),
+		heading(2, method.summary ?? method.title),
 		...env.language === "http" ? [] : [paragraph(code(stripMarkup(signature)))],
 		paragraph(strong(text(httpMethod)), text(" "), code(endpoint))
 	];
@@ -47,8 +47,14 @@ function renderMethod(env, method) {
 	}
 	if ("paramsChildren" in decl && Array.isArray(decl.paramsChildren) && decl.paramsChildren.length > 0) output.push(heading(3, "Parameters"), renderChildren(env, decl.paramsChildren));
 	if ("responseChildren" in decl && decl.responseChildren && decl.responseChildren.length > 0) output.push(heading(3, "Returns"), renderChildren(env, decl.responseChildren));
-	const snippet = getSnippet(env, method.stainlessPath);
-	if (snippet) output.push(heading(3, "Example"), fence(env.language, snippet));
+	const snippetEntries = getSnippets(env, method.stainlessPath);
+	for (const [key, { snippet, response }] of Object.entries(snippetEntries)) {
+		if (!snippet) continue;
+		let title = getCustomSnippetTitle(key);
+		if (title.toLowerCase() === "default") title = "Example";
+		output.push(heading(3, title), fence(env.language, snippet));
+		if (response) output.push(heading(4, "Response"), fence("json", response));
+	}
 	return output;
 }
 function renderModel(env, model) {

package/dist/markdown/utils.d.ts

@@ -15,7 +15,14 @@ type EnvironmentType = {
   };
 };
 declare function getDecl(env: EnvironmentType, path: string): LanguageDeclNodes[SpecLanguage] | undefined;
-declare function getSnippet(env: EnvironmentType, path: string, snippetId?: 'default' | `custom:${string}`): string | undefined;
+declare const customSnippetPrefix = "custom:";
+declare const getCustomSnippetTitle: (snippetId: string) => string;
+declare function getSnippets(env: EnvironmentType, path: string): {
+  [k: string]: {
+    snippet: string;
+    response: string | undefined;
+  };
+};
 declare function stripMarkup(content: string): string;
 //#endregion
-export { EnvironmentType, getDecl, getSnippet, stripMarkup };
+export { EnvironmentType, customSnippetPrefix, getCustomSnippetTitle, getDecl, getSnippets, stripMarkup };

package/dist/markdown/utils.js

@@ -10,14 +10,16 @@ function getDecl(env, path) {
 	}
 	return decl;
 }
-function getSnippet(env, path, snippetId = "default") {
+const customSnippetPrefix = "custom:";
+const getCustomSnippetTitle = (snippetId) => snippetId.startsWith(customSnippetPrefix) ? snippetId.slice(7) : snippetId;
+function getSnippets(env, path) {
 	const lang = env.language === "http" ? "http.curl" : `${env.language}.default`;
-	let snippet = env.spec?.snippets?.[lang]?.[path]?.[snippetId]?.content;
-	if (snippet && env.transforms?.transformRequestSnippet) snippet = env.transforms.transformRequestSnippet({
-		snippet,
-		language: env.language
-	});
-	return snippet;
+	const snippets = env.spec?.snippets?.[lang]?.[path];
+	const responses = env.spec?.snippetResponses?.http?.[path];
+	return Object.fromEntries(Object.entries(snippets ?? {}).map(([key, snippet]) => [key, {
+		snippet: snippet.content,
+		response: responses?.[key]?.[0]?.content
+	}]));
 }
 function stripMarkup(content) {
 	let output = "";
@@ -28,4 +30,4 @@ function stripMarkup(content) {
 }
 
 //#endregion
-export { getDecl, getSnippet, stripMarkup };
+export { customSnippetPrefix, getCustomSnippetTitle, getDecl, getSnippets, stripMarkup };

package/dist/routing.d.ts

@@ -8,7 +8,7 @@ declare const Languages: readonly ["http", "node", "python", "go", "typescript",
 declare const SupportedLanguageSyntaxes: string[];
 type DocsLanguage = (typeof Languages)[number];
 declare const LanguageNames: Record<DocsLanguage, string>;
-declare function getLanguageSnippet(language: DocsLanguage): "http.curl" | "cli.default" | "csharp.default" | "go.default" | "java.default" | "kotlin.default" | "node.default" | "php.default" | "python.default" | "ruby.default" | "terraform.default" | "typescript.default";
+declare function getLanguageSnippet(language: DocsLanguage): "http.curl" | "node.default" | "python.default" | "go.default" | "typescript.default" | "terraform.default" | "ruby.default" | "java.default" | "kotlin.default" | "csharp.default" | "php.default" | "cli.default";
 declare function isSupportedLanguage(language: string): language is DocsLanguage;
 type ParsedStainlessPath = ReturnType<typeof parseStainlessPath>;
 declare function parseStainlessPath(stainlessPath: string): {

package/dist/styles/primitives.css

@@ -194,6 +194,13 @@
           margin-left: calc(-1 * var(--stldocs-expander-margin-shift));
           padding-right: var(--stldocs-expander-right-margin);
         }
+        /* move margin to .stldocs-property parent where possible to fix safari subgrid bug */
+        .stldocs-property:has(> .stldocs-expander) {
+          margin-left: calc(-1 * var(--stldocs-expander-margin-shift));
+          & > .stldocs-expander {
+            margin-left: 0;
+          }
+        }
       }
     }
   }

package/dist/styles.css

@@ -1586,6 +1586,13 @@ a.stl-ui-button {
           margin-left: calc(-1 * var(--stldocs-expander-margin-shift));
           padding-right: var(--stldocs-expander-right-margin);
         }
+        /* move margin to .stldocs-property parent where possible to fix safari subgrid bug */
+        .stldocs-property:has(> .stldocs-expander) {
+          margin-left: calc(-1 * var(--stldocs-expander-margin-shift));
+          & > .stldocs-expander {
+            margin-left: 0;
+          }
+        }
       }
     }
   }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stainless-api/docs-ui",
   "private": false,
-  "version": "0.1.0-beta.82",
+  "version": "0.1.0-beta.84",
   "publishConfig": {
     "access": "public"
   },