@stainless-api/docs-ui 0.1.0-beta.48 → 0.1.0-beta.49

package/dist/snippets-BQLXEIf6.js

@@ -0,0 +1,161 @@
+import { a as useLanguage, c as useSnippet, r as useDeclaration } from "./docs-CXqi26jB.js";
+import { r as useHighlight } from "./markdown-CxdeWgjV.js";
+import { t as useComponents } from "./use-components-RWQbviGq.js";
+import { t as style_default } from "./style-gnVEeXFj.js";
+import * as React$1 from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { CheckIcon, CircleAlertIcon, CopyIcon } from "lucide-react";
+import clsx from "clsx";
+import { Button } from "@stainless-api/ui-primitives";
+
+//#region src/components/snippets.tsx
+function SnippetCode({ content, language }) {
+	const lang = useLanguage();
+	const highlighted = useHighlight(content, language || lang);
+	return /* @__PURE__ */ jsx("div", {
+		className: style_default.SnippetCode,
+		children: /* @__PURE__ */ jsx("pre", {
+			className: style_default.SnippetCodeContent,
+			"data-stldocs-copy-content": true,
+			children: /* @__PURE__ */ jsx("code", {
+				className: language === "json" ? "snippet-json" : "snippet",
+				dangerouslySetInnerHTML: { __html: highlighted }
+			})
+		})
+	});
+}
+function SnippetContainer({ children }) {
+	return /* @__PURE__ */ jsx("div", {
+		className: clsx(style_default.Snippet),
+		children
+	});
+}
+function SnippetRequestContainer({ children }) {
+	return /* @__PURE__ */ jsx("div", { children });
+}
+function Snippet({ requestTitle, method, transformRequestSnippet }) {
+	const Docs = useComponents();
+	const language = useLanguage();
+	const originalSnippet = useSnippet(method.stainlessPath, void 0, language === "http" ? "curl" : "default");
+	const decl = useDeclaration(method.stainlessPath, false);
+	if (!originalSnippet) {
+		console.warn(`Snippet not found for method '${method.stainlessPath}'`);
+		return null;
+	}
+	const signature = decl && "qualified" in decl ? decl.qualified : void 0;
+	const responses = method.exampleResponses;
+	const snippet = transformRequestSnippet ? transformRequestSnippet({
+		snippet: originalSnippet,
+		language
+	}) : originalSnippet;
+	return /* @__PURE__ */ jsxs(Docs.SnippetContainer, {
+		signature,
+		children: [snippet && /* @__PURE__ */ jsx(Docs.SnippetRequestContainer, {
+			signature,
+			children: /* @__PURE__ */ jsxs("div", {
+				className: style_default.SnippetRequest,
+				"data-stldocs-copy-parent": true,
+				children: [/* @__PURE__ */ jsxs("div", {
+					className: style_default.SnippetRequestTitle,
+					children: [
+						/* @__PURE__ */ jsxs("div", {
+							className: style_default.SnippetRequestTitleMethod,
+							children: [/* @__PURE__ */ jsx(Docs.MethodRoute, {
+								httpMethod: method.httpMethod,
+								iconOnly: true
+							}), /* @__PURE__ */ jsx("h5", { children: method.summary ?? method.title })]
+						}),
+						/* @__PURE__ */ jsx("div", {
+							className: style_default.SnippetRequestTitleContent,
+							children: requestTitle
+						}),
+						/* @__PURE__ */ jsx(Docs.SnippetButtons, { content: snippet })
+					]
+				}), /* @__PURE__ */ jsx(Docs.SnippetCode, {
+					content: snippet,
+					signature
+				})]
+			})
+		}), responses && /* @__PURE__ */ jsx(Docs.SnippetResponse, { responses })]
+	});
+}
+function SnippetButtons({ content }) {
+	const [CopyButtonIcon, setCopyIcon] = React$1.useState(CopyIcon);
+	async function handleCopy() {
+		try {
+			await navigator.clipboard.writeText(content);
+			setCopyIcon(CheckIcon);
+		} catch {
+			setCopyIcon(CircleAlertIcon);
+		}
+		setTimeout(() => setCopyIcon(CopyIcon), 1e3);
+	}
+	return /* @__PURE__ */ jsx(Button, {
+		variant: "ghost",
+		"data-stldocs-snippet-copy": true,
+		children: /* @__PURE__ */ jsx(CopyButtonIcon, {
+			size: 16,
+			className: style_default.Icon,
+			onClick: handleCopy
+		})
+	});
+}
+function SnippetResponse({ responses }) {
+	const { SnippetCode: SnippetCode$1 } = useComponents();
+	if (!responses) return null;
+	const mappedResponses = Object.keys(responses).map((key) => {
+		const responseContent = responses[key];
+		if (!responseContent) return null;
+		const responseType = Object.keys(responseContent)[0];
+		if (!responseType) return null;
+		const response = responseContent[responseType];
+		if (!response) return null;
+		const examples = response?.examples;
+		if (!examples) return null;
+		const exampleType = Object.keys(examples)[0];
+		if (!exampleType) return null;
+		let value = examples[exampleType]?.value;
+		if (!value) return null;
+		let language = "none";
+		if (responseType === "application/json" || typeof value === "object") {
+			language = "json";
+			value = JSON.stringify(value, null, 2);
+		}
+		return {
+			language,
+			responseCode: key,
+			content: value
+		};
+	}).filter(Boolean);
+	if (mappedResponses.length === 0) return null;
+	return /* @__PURE__ */ jsx("div", {
+		className: style_default.SnippetMultiResponse,
+		children: /* @__PURE__ */ jsxs("div", {
+			className: clsx(style_default.Snippet),
+			children: [/* @__PURE__ */ jsx("div", {
+				className: clsx(style_default.SnippetResponseTab, mappedResponses.length === 1 && style_default.SnippetResponseTabSingleReturn),
+				children: mappedResponses.map(({ responseCode }, index) => /* @__PURE__ */ jsx("div", {
+					"data-snippet-response-tab-id": `snippet-response-tab-${responseCode}-${index}`,
+					className: clsx(style_default.SnippetResponseTabItem, index === 0 && style_default.SnippetResponseTabItemActive),
+					children: /* @__PURE__ */ jsxs(Button, {
+						disabled: mappedResponses.length === 1,
+						variant: "ghost",
+						children: [responseCode, " example"]
+					})
+				}, `snippet-response-tab-item-${responseCode}-${index}`))
+			}), mappedResponses.map(({ responseCode, content, language }, index) => {
+				return /* @__PURE__ */ jsx("div", {
+					className: clsx(style_default.SnippetResponsePane, index === 0 && style_default.SnippetResponsePaneActive),
+					"data-snippet-response-pane-id": `snippet-response-tab-${responseCode}-${index}`,
+					children: /* @__PURE__ */ jsx(SnippetCode$1, {
+						content,
+						language
+					})
+				}, `snippet-response-${responseCode}-${index}`);
+			})]
+		})
+	});
+}
+
+//#endregion
+export { SnippetRequestContainer as a, SnippetContainer as i, SnippetButtons as n, SnippetResponse as o, SnippetCode as r, Snippet as t };

package/dist/{snippets-BwifQYD4.d.ts → snippets-CbVFNmfq.d.ts}

@@ -1,6 +1,6 @@
-import { C as TransformRequestSnippetFn } from "./sdk-CuOpWo9I.js";
+import { C as TransformRequestSnippetFn } from "./sdk-CdhDsvo3.js";
 import * as React$1 from "react";
-import * as react_jsx_runtime36 from "react/jsx-runtime";
+import * as react_jsx_runtime52 from "react/jsx-runtime";
 import * as SDKJSON from "@stainless/sdk-json";
 
 //#region src/components/snippets.d.ts
@@ -12,7 +12,7 @@ type SnippetCodeProps = {
 declare function SnippetCode({
   content,
   language
-}: SnippetCodeProps): react_jsx_runtime36.JSX.Element;
+}: SnippetCodeProps): react_jsx_runtime52.JSX.Element;
 type SnippetProps = {
   method: SDKJSON.Method;
   requestTitle?: React$1.ReactNode;
@@ -24,28 +24,28 @@ type SnippetContainerProps = {
 };
 declare function SnippetContainer({
   children
-}: SnippetContainerProps): react_jsx_runtime36.JSX.Element;
+}: SnippetContainerProps): react_jsx_runtime52.JSX.Element;
 type SnippetRequestContainerProps = {
   children?: React$1.ReactNode;
   signature?: string;
 };
 declare function SnippetRequestContainer({
   children
-}: SnippetRequestContainerProps): react_jsx_runtime36.JSX.Element;
+}: SnippetRequestContainerProps): react_jsx_runtime52.JSX.Element;
 declare function Snippet({
   requestTitle,
   method,
   transformRequestSnippet
-}: SnippetProps): react_jsx_runtime36.JSX.Element | null;
+}: SnippetProps): react_jsx_runtime52.JSX.Element | null;
 declare function SnippetButtons({
   content
 }: {
   content: string;
-}): react_jsx_runtime36.JSX.Element;
+}): react_jsx_runtime52.JSX.Element;
 declare function SnippetResponse({
   responses
 }: {
   responses: SDKJSON.Method['exampleResponses'];
-}): react_jsx_runtime36.JSX.Element | null;
+}): react_jsx_runtime52.JSX.Element | null;
 //#endregion
 export { SnippetContainer as a, SnippetRequestContainer as c, SnippetCodeProps as i, SnippetRequestContainerProps as l, SnippetButtons as n, SnippetContainerProps as o, SnippetCode as r, SnippetProps as s, Snippet as t, SnippetResponse as u };

package/dist/snippets-Wjo2dJNw.d.ts

@@ -0,0 +1,51 @@
+import { C as TransformRequestSnippetFn } from "./sdk-BOwYR0k6.js";
+import * as React$1 from "react";
+import * as react_jsx_runtime51 from "react/jsx-runtime";
+import * as SDKJSON from "@stainless/sdk-json";
+
+//#region src/components/snippets.d.ts
+type SnippetCodeProps = {
+  content: string;
+  signature?: string;
+  language?: string;
+};
+declare function SnippetCode({
+  content,
+  language
+}: SnippetCodeProps): react_jsx_runtime51.JSX.Element;
+type SnippetProps = {
+  method: SDKJSON.Method;
+  requestTitle?: React$1.ReactNode;
+  transformRequestSnippet?: TransformRequestSnippetFn;
+};
+type SnippetContainerProps = {
+  children: React$1.ReactNode;
+  signature?: string;
+};
+declare function SnippetContainer({
+  children
+}: SnippetContainerProps): react_jsx_runtime51.JSX.Element;
+type SnippetRequestContainerProps = {
+  children?: React$1.ReactNode;
+  signature?: string;
+};
+declare function SnippetRequestContainer({
+  children
+}: SnippetRequestContainerProps): react_jsx_runtime51.JSX.Element;
+declare function Snippet({
+  requestTitle,
+  method,
+  transformRequestSnippet
+}: SnippetProps): react_jsx_runtime51.JSX.Element | null;
+declare function SnippetButtons({
+  content
+}: {
+  content: string;
+}): react_jsx_runtime51.JSX.Element;
+declare function SnippetResponse({
+  responses
+}: {
+  responses: SDKJSON.Method['exampleResponses'];
+}): react_jsx_runtime51.JSX.Element | null;
+//#endregion
+export { SnippetContainer as a, SnippetRequestContainer as c, SnippetCodeProps as i, SnippetRequestContainerProps as l, SnippetButtons as n, SnippetContainerProps as o, SnippetCode as r, SnippetProps as s, Snippet as t, SnippetResponse as u };

package/dist/spec.d.ts

@@ -1,4 +1,4 @@
-import { t as DocsLanguage } from "./routing-BcGPNh2R.js";
+import { t as DocsLanguage } from "./routing-CMqh1cTZ.js";
 import * as SDKJSON from "@stainless/sdk-json";
 
 //#region src/spec.d.ts
@@ -36,13 +36,13 @@ declare function generateNavigation(resource: Partial<SDKJSON.Resource>): {
 declare function generateSpecForResource(spec: SDKJSON.Spec, name: string, lang: DocsLanguage, transforms: SpecTransforms): Partial<SDKJSON.Spec>;
 declare function transform(spec: SDKJSON.Spec, transforms: SpecTransforms): {
   name: string;
-  lang: "node" | "go" | "python" | "terraform" | "http" | "typescript" | "ruby" | "java" | "kotlin" | "csharp" | "php";
+  lang: "http" | "node" | "python" | "go" | "typescript" | "terraform" | "ruby" | "java" | "kotlin" | "csharp" | "php";
   spec: Partial<SDKJSON.Spec>;
 }[];
 declare function split(spec: SDKJSON.Spec, transforms?: SpecTransforms): {
   resources: ReturnType<typeof transform>;
   navigation: {
-    languages: ("node" | "go" | "python" | "terraform" | "http" | "typescript" | "ruby" | "java" | "kotlin")[] | undefined;
+    languages: ("http" | "node" | "python" | "go" | "typescript" | "terraform" | "ruby" | "java" | "kotlin")[] | undefined;
     resources: {
       [k: string]: {
         title: string | undefined;

package/dist/spec.js

@@ -1,5 +1,5 @@
-import { n as Languages } from "./routing-BGBmkDBL.js";
-import { r as isResourceEmpty } from "./utils-0z34vxY4.js";
+import { n as Languages } from "./routing-Wbb7YECB.js";
+import { r as isResourceEmpty } from "./utils-D_1AWSRX.js";
 
 //#region src/spec.ts
 const defaultTransforms = {

package/dist/style.d.ts

@@ -1,2 +1,2 @@
-import { t as _default } from "./style-D8hwSwrv.js";
+import { t as _default } from "./style-D7RO5ymE.js";
 export { _default as default };

package/dist/style.js

@@ -1,3 +1,3 @@
-import { t as style_default } from "./style-0miv2y38.js";
+import { t as style_default } from "./style-gnVEeXFj.js";
 
 export { style_default as default };

package/dist/styles/resets.css

@@ -20,7 +20,8 @@
     display: block;
     color: var(--stl-color-foreground);
     font-weight: 500;
-    line-height: var(--stl-typography-line-height-headings);
+    line-height: var(--stl-typography-line-height-heading);
+    font-family: var(--stl-typography-font-heading);
   }
 
   display: block;

package/dist/styles.css

@@ -3,8 +3,10 @@
   :root {
     --stl-typography-font: 'Geist', system-ui, sans-serif;
     --stl-typography-font-mono: 'Geist Mono', ui-monospace, monospace;
+    --stl-typography-font-heading: var(--stl-typography-font);
+
     --stl-typography-line-height: 1.5;
-    --stl-typography-line-height-headings: 1.2;
+    --stl-typography-line-height-heading: 1.2;
 
     --stl-typography-text-body: var(--stl-typography-scale-base);
     --stl-typography-text-body-sm: var(--stl-typography-scale-sm);
@@ -79,7 +81,8 @@ body {
   :where(h1, h2, h3, h4, h5, h6):where(:not(.stl-ui-not-prose *), .stl-ui-not-prose .stl-ui-prose *) {
     color: var(--stl-color-foreground);
     font-weight: 500;
-    line-height: var(--stl-typography-line-height-headings);
+    line-height: var(--stl-typography-line-height-heading);
+    font-family: var(--stl-typography-font-heading);
   }
 
   :where(h1:not(.stl-ui-not-prose *), .stl-ui-not-prose .stl-ui-prose h1) {
@@ -1110,7 +1113,8 @@ a.stl-ui-button {
     display: block;
     color: var(--stl-color-foreground);
     font-weight: 500;
-    line-height: var(--stl-typography-line-height-headings);
+    line-height: var(--stl-typography-line-height-heading);
+    font-family: var(--stl-typography-font-heading);
   }
 
   display: block;