@stainless-api/docs-ui 0.1.0-beta.33 → 0.1.0-beta.35

package/dist/{search-xIU7N2Yv.d.ts → search-arc2uMFa.d.ts}

@@ -1,6 +1,6 @@
-import { d as ResultType, h as SearchSettings, m as SearchParams } from "./types-fEIVKcbt.js";
+import { d as ResultType, h as SearchSettings, m as SearchParams } from "./types-BKUIuYYk.js";
 import * as React$1 from "react";
-import * as react_jsx_runtime20 from "react/jsx-runtime";
+import * as react_jsx_runtime38 from "react/jsx-runtime";
 
 //#region src/contexts/search.d.ts
 type SearchContextType = {
@@ -16,6 +16,6 @@ type SearchProviderProps = SearchContextType & {
 declare function SearchProvider({
   children,
   ...props
-}: SearchProviderProps): react_jsx_runtime20.JSX.Element;
+}: SearchProviderProps): react_jsx_runtime38.JSX.Element;
 //#endregion
 export { useSearchContext as a, useSearch as i, SearchProvider as n, SearchProviderProps as r, SearchContextType as t };

package/dist/{sidebar-D3AJHVyb.d.ts → sidebar-Coj2op4S.d.ts}

@@ -1,5 +1,5 @@
 import * as React$1 from "react";
-import * as react_jsx_runtime54 from "react/jsx-runtime";
+import * as react_jsx_runtime33 from "react/jsx-runtime";
 import * as SDKJSON from "@stainless/sdk-json";
 
 //#region src/components/sidebar.d.ts
@@ -12,25 +12,25 @@ declare function SidebarExpander({
   open,
   summary,
   children
-}: SidebarExpanderProps): react_jsx_runtime54.JSX.Element;
+}: SidebarExpanderProps): react_jsx_runtime33.JSX.Element;
 type SidebarMethodProps = {
   method: SDKJSON.Method;
 };
 declare function SidebarMethod({
   method
-}: SidebarMethodProps): react_jsx_runtime54.JSX.Element;
+}: SidebarMethodProps): react_jsx_runtime33.JSX.Element;
 type SidebarResourceProps = {
   resource: SDKJSON.Resource;
 };
 declare function SidebarResource({
   resource
-}: SidebarResourceProps): react_jsx_runtime54.JSX.Element;
+}: SidebarResourceProps): react_jsx_runtime33.JSX.Element;
 type SidebarProps = {
   resources: SDKJSON.Resource[];
   selectedPath?: string;
 };
 declare function Sidebar({
   resources
-}: SidebarProps): react_jsx_runtime54.JSX.Element;
+}: SidebarProps): react_jsx_runtime33.JSX.Element;
 //#endregion
 export { SidebarProps as a, SidebarMethodProps as i, SidebarExpander as n, SidebarResource as o, SidebarMethod as r, SidebarResourceProps as s, Sidebar as t };

package/dist/{snippets-8uy93yC6.d.ts → snippets-CQ0gTP8m.d.ts}

@@ -1,6 +1,6 @@
-import { C as TransformRequestSnippetFn } from "./sdk-CUDyIYiV.js";
+import { C as TransformRequestSnippetFn } from "./sdk-DBxkJu1a.js";
 import * as React$1 from "react";
-import * as react_jsx_runtime64 from "react/jsx-runtime";
+import * as react_jsx_runtime72 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_runtime64.JSX.Element;
+}: SnippetCodeProps): react_jsx_runtime72.JSX.Element;
 type SnippetProps = {
   method: SDKJSON.Method;
   requestTitle?: React$1.ReactNode;
@@ -24,23 +24,23 @@ type SnippetContainerProps = {
 };
 declare function SnippetContainer({
   children
-}: SnippetContainerProps): react_jsx_runtime64.JSX.Element;
+}: SnippetContainerProps): react_jsx_runtime72.JSX.Element;
 type SnippetRequestContainerProps = {
   children?: React$1.ReactNode;
   signature?: string;
 };
 declare function SnippetRequestContainer({
   children
-}: SnippetRequestContainerProps): react_jsx_runtime64.JSX.Element;
+}: SnippetRequestContainerProps): react_jsx_runtime72.JSX.Element;
 declare function Snippet({
   requestTitle,
   method,
   transformRequestSnippet
-}: SnippetProps): react_jsx_runtime64.JSX.Element | null;
+}: SnippetProps): react_jsx_runtime72.JSX.Element | null;
 declare function SnippetResponse({
   responses
 }: {
   responses: SDKJSON.Method['exampleResponses'];
-}): react_jsx_runtime64.JSX.Element | null;
+}): react_jsx_runtime72.JSX.Element | null;
 //#endregion
 export { SnippetContainerProps as a, SnippetRequestContainerProps as c, SnippetContainer as i, SnippetResponse as l, SnippetCode as n, SnippetProps as o, SnippetCodeProps as r, SnippetRequestContainer as s, Snippet as t };

package/dist/spec.d.ts

@@ -0,0 +1,65 @@
+import { t as DocsLanguage } from "./routing-ByeZ2P3d.js";
+import * as SDKJSON from "@stainless/sdk-json";
+
+//#region src/spec.d.ts
+type SecurityScheme = SDKJSON.Spec['security_schemes'][number];
+interface SpecTransforms {
+  resource(resource: SDKJSON.Resource): SDKJSON.Resource;
+  method(method: SDKJSON.Method): SDKJSON.Method;
+  model(model: SDKJSON.Model): SDKJSON.Model;
+  declaration(decl: SDKJSON.DeclarationNode, language: SDKJSON.SpecLanguage): SDKJSON.DeclarationNode;
+  securityScheme(scheme: SecurityScheme): SecurityScheme;
+  snippet(snippet: string, language: string): string;
+  markdown(content?: string): string | undefined;
+}
+declare function defineTransforms(transforms?: Partial<SpecTransforms>): {
+  resource: (resource: SDKJSON.Resource) => SDKJSON.Resource;
+  method: (method: SDKJSON.Method) => SDKJSON.Method;
+  model: (model: SDKJSON.Model) => SDKJSON.Model;
+  declaration: (decl: SDKJSON.DeclarationNode, language: SDKJSON.SpecLanguage) => SDKJSON.DeclarationNode;
+  securityScheme: (scheme: SecurityScheme) => SecurityScheme;
+  snippet: (snippet: string, language: string) => string;
+  markdown: (content?: string) => string | undefined;
+};
+declare function generateNavigation(resource: Partial<SDKJSON.Resource>): {
+  title: string | undefined;
+  name: string | undefined;
+  subresources: Record<string, Partial<SDKJSON.Resource>> | undefined;
+  methods: Record<string, Partial<SDKJSON.Method>> | undefined;
+  models: Record<string, Partial<SDKJSON.Model>> | undefined;
+  stainlessPath: string | undefined;
+  terraform: {
+    Name: string;
+    QualifiedName: string;
+  } | undefined;
+};
+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";
+  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;
+    resources: {
+      [k: string]: {
+        title: string | undefined;
+        name: string | undefined;
+        subresources: Record<string, Partial<SDKJSON.Resource>> | undefined;
+        methods: Record<string, Partial<SDKJSON.Method>> | undefined;
+        models: Record<string, Partial<SDKJSON.Model>> | undefined;
+        stainlessPath: string | undefined;
+        terraform: {
+          Name: string;
+          QualifiedName: string;
+        } | undefined;
+      };
+    };
+  };
+};
+declare function parseSpec(content: string): SDKJSON.Spec | undefined;
+declare function retrieve(apiKey: string, project: string, revision: string): Promise<SDKJSON.Spec | undefined>;
+//#endregion
+export { SecurityScheme, SpecTransforms, defineTransforms, generateNavigation, generateSpecForResource, parseSpec, retrieve, split, transform };

package/dist/spec.js

@@ -0,0 +1,167 @@
+import { n as Languages } from "./routing-8itEXLx6.js";
+import { r as isResourceEmpty } from "./utils-2FmcHPHp.js";
+
+//#region src/spec.ts
+const defaultTransforms = {
+	resource: (resource) => resource,
+	method: (method) => method,
+	model: (model) => model,
+	declaration: (decl) => decl,
+	securityScheme: (scheme) => scheme,
+	snippet: (snippet) => snippet,
+	markdown: (content) => content
+};
+function defineTransforms(transforms = {}) {
+	return {
+		...defaultTransforms,
+		...transforms
+	};
+}
+function removeStudioRefs(obj) {
+	if (typeof obj !== "object" || obj === null) return obj;
+	if (Array.isArray(obj)) return obj.map(removeStudioRefs);
+	const newObj = {};
+	for (const [key, value] of Object.entries(obj)) if (key !== "oasRef" && key !== "configRef") newObj[key] = removeStudioRefs(value);
+	return newObj;
+}
+function mapEntries({ input, fn, filter }) {
+	if (!input) return;
+	const output = {};
+	for (const [name, entry] of Object.entries(input)) {
+		if (filter && !filter(name, entry)) continue;
+		output[name] = fn ? fn(entry) : entry;
+	}
+	return output;
+}
+function transformRecursively(resource, transforms) {
+	return {
+		...transforms.resource(resource),
+		methods: mapEntries({
+			input: resource.methods,
+			fn: (method) => transforms.method(method)
+		}) ?? {},
+		models: mapEntries({
+			input: resource.models,
+			fn: (model) => transforms.model(model)
+		}) ?? {},
+		subresources: mapEntries({
+			input: resource.subresources,
+			fn: (sub) => transformRecursively(sub, transforms)
+		}) ?? {}
+	};
+}
+function generateNavigation(resource) {
+	const { title, name, stainlessPath, terraform } = resource;
+	return {
+		title,
+		name,
+		subresources: mapEntries({
+			input: resource.subresources,
+			fn: generateNavigation
+		}),
+		methods: mapEntries({
+			input: resource.methods,
+			fn: (method) => ({
+				name: method.name,
+				stainlessPath: method.stainlessPath,
+				summary: method.summary,
+				httpMethod: method.httpMethod
+			})
+		}),
+		models: mapEntries({
+			input: resource.models,
+			fn: (model) => ({
+				name: model.name,
+				stainlessPath: model.stainlessPath
+			})
+		}),
+		stainlessPath,
+		terraform
+	};
+}
+function generateSpecForResource(spec, name, lang, transforms) {
+	const resource = spec.resources[name];
+	if (!resource) throw new Error(`Invalid resource: ${name}`);
+	return {
+		resources: {
+			[name]: transformRecursively(resource, transforms),
+			...spec.resources["$shared"] ? { $shared: transformRecursively(spec.resources["$shared"], transforms) } : {}
+		},
+		security_schemes: spec.security_schemes?.map((scheme) => transforms.securityScheme(scheme)),
+		decls: { [lang]: mapEntries({
+			input: spec.decls[lang] ?? {},
+			filter: (name$1) => name$1.startsWith(resource.stainlessPath) || name$1.startsWith("(resource) $shared"),
+			fn: (decl) => transforms.declaration(decl, lang)
+		}) },
+		snippets: mapEntries({
+			input: spec.snippets,
+			filter: (name$1) => name$1.startsWith(lang),
+			fn: (snippets) => mapEntries({
+				input: snippets,
+				filter: (name$1) => name$1.startsWith(resource.stainlessPath),
+				fn: (snippet) => transforms.snippet(snippet, lang)
+			}) ?? {}
+		})
+	};
+}
+function transform(spec, transforms) {
+	const t = {
+		...transforms,
+		declaration: (decl, lang) => transforms.declaration({
+			...decl,
+			..."docstring" in decl ? { docstring: transforms.markdown(decl.docstring) } : {}
+		}, lang),
+		method: (method) => transforms.method({
+			...method,
+			description: transforms.markdown(method.description),
+			deprecated: typeof method.deprecated === "string" ? transforms.markdown(method.deprecated) : method.deprecated
+		}),
+		securityScheme: (scheme) => transforms.securityScheme({
+			...scheme,
+			description: transforms.markdown(scheme.description)
+		})
+	};
+	const output = [];
+	for (const lang of Languages) for (const [name, resource] of Object.entries(spec.resources)) {
+		if (isResourceEmpty(resource)) continue;
+		output.push({
+			name,
+			lang,
+			spec: generateSpecForResource(spec, name, lang, t)
+		});
+	}
+	return output;
+}
+function split(spec, transforms) {
+	return {
+		resources: transform(spec, transforms ?? defineTransforms()).map(removeStudioRefs),
+		navigation: {
+			languages: spec.docs?.languages,
+			resources: Object.fromEntries(Object.entries(spec.resources).filter(([, res]) => !isResourceEmpty(res)).map(([name, res]) => [name, generateNavigation(res)]))
+		}
+	};
+}
+function parseSpec(content) {
+	const parsed = JSON.parse(content);
+	if (parsed && typeof parsed === "object" && "kind" in parsed && parsed.kind === "spec") return parsed;
+}
+async function retrieve(apiKey, project, revision) {
+	const data = await (await fetch("https://app.stainless.com/api/generate/spec", {
+		method: "POST",
+		headers: {
+			Authorization: `Bearer ${apiKey}`,
+			"Content-Type": "application/json"
+		},
+		body: JSON.stringify({
+			project,
+			source: {
+				type: "git",
+				revision
+			}
+		})
+	})).json();
+	if (typeof data.spec === "string") return parseSpec(data.spec);
+}
+
+//#endregion
+export { defineTransforms, generateNavigation, generateSpecForResource, parseSpec, retrieve, split, transform };

package/dist/{style-CPgcT0Fw.js → style-CuGfVeTo.js}

@@ -149,12 +149,6 @@ var style_default = {
 	SearchResultResourcePath: "stldocs-search-result-resource-path",
 	SearchResultGuideTitle: "stldocs-search-result-guide-title",
 	SearchResultGuideExcerpt: "stldocs-search-result-guide-excerpt",
-	Chat: "stldocs-chat",
-	ChatHeader: "stldocs-chat-header",
-	ChatInput: "stldocs-chat-input",
-	ChatInputButtons: "stldocs-chat-input-buttons",
-	ChatMessages: "stldocs-chat-messages",
-	ChatMessage: "stldocs-chat-message",
 	LanguageBlock: "stldocs-language-block",
 	LanguageBlockContent: "stldocs-language-block-content",
 	LanguageBlockContentIcon: "stldocs-language-block-content-icon",

package/dist/{style-BEMLtSIK.d.ts → style-Dku3IzwI.d.ts}

@@ -149,12 +149,6 @@ declare const _default: {
   readonly SearchResultResourcePath: "stldocs-search-result-resource-path";
   readonly SearchResultGuideTitle: "stldocs-search-result-guide-title";
   readonly SearchResultGuideExcerpt: "stldocs-search-result-guide-excerpt";
-  readonly Chat: "stldocs-chat";
-  readonly ChatHeader: "stldocs-chat-header";
-  readonly ChatInput: "stldocs-chat-input";
-  readonly ChatInputButtons: "stldocs-chat-input-buttons";
-  readonly ChatMessages: "stldocs-chat-messages";
-  readonly ChatMessage: "stldocs-chat-message";
   readonly LanguageBlock: "stldocs-language-block";
   readonly LanguageBlockContent: "stldocs-language-block-content";
   readonly LanguageBlockContentIcon: "stldocs-language-block-content-icon";

package/dist/style.d.ts

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

package/dist/style.js

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

package/dist/styles/search.css

@@ -226,123 +226,6 @@
   }
 }
 
-.stldocs-root #stldocs-chat {
-  display: flex;
-  flex-direction: column;
-  display: none;
-
-  .stldocs-chat-header {
-    display: flex;
-    gap: 0.5rem;
-    padding-bottom: 10px;
-
-    h5 {
-      flex-grow: 1;
-    }
-
-    .lucide-message-square-plus {
-      cursor: pointer;
-    }
-  }
-
-  &[data-stldocs-modal-open='true'] {
-    display: flex;
-  }
-
-  .stldocs-chat-messages {
-    padding: 0 2rem;
-    overflow-y: auto;
-    flex-grow: 1;
-
-    .stldocs-loading-spinner {
-      svg {
-        animation: stldocs-spinner-rotate 1s linear infinite;
-      }
-    }
-
-    .stldocs-chat-message {
-      margin-bottom: 50px;
-      display: flex;
-      flex-direction: column;
-      gap: 1rem;
-
-      p,
-      li {
-        line-height: 150%;
-
-        code {
-          white-space: pre;
-          word-break: normal;
-          overflow-wrap: normal;
-        }
-      }
-
-      pre {
-        background-color: rgb(30, 30, 30);
-        padding: 10px;
-        border-radius: 8px;
-        font-family: var(--stldocs-font-mono);
-        font-size: var(--stldocs-font-size-code);
-        line-height: 1.3rem;
-        white-space: pre;
-        margin-bottom: 1rem;
-        overflow-x: auto;
-      }
-
-      table {
-        border-spacing: 10px;
-
-        thead tr {
-          font-weight: bold;
-        }
-      }
-    }
-
-    .stldocs-chat-message[data-stldocs-chat-message='user'] {
-      background-color: var(--stldocs-color-gray-6);
-      border-radius: 6px;
-      margin-left: auto;
-      padding: 12px;
-      width: 60%;
-    }
-  }
-
-  .stldocs-chat-input {
-    border: 1px solid var(--stldocs-color-hairline);
-    background-color: var(--stldocs-color-snippet-box-bg);
-    border-radius: 8px;
-    padding: 10px;
-    display: flex;
-    gap: 1rem;
-    min-height: 100px;
-
-    textarea {
-      flex-grow: 1;
-      border: none;
-      background-color: var(--stldocs-color-snippet-box-bg);
-      outline: none;
-    }
-
-    .stldocs-chat-input-buttons {
-      display: flex;
-      flex-direction: column;
-      gap: 0.5rem;
-    }
-
-    button {
-      padding: 0.3rem;
-      align-self: flex-start;
-      border-radius: 8px;
-      border: 1px solid var(--stldocs-color-hairline);
-      cursor: pointer;
-
-      &:hover {
-        background-color: var(--stldocs-color-gray-6);
-      }
-    }
-  }
-}
-
 @keyframes stldocs-spinner-rotate {
   100% {
     transform: rotate(360deg);

package/dist/{types-fEIVKcbt.d.ts → types-BKUIuYYk.d.ts}

@@ -1,4 +1,4 @@
-import { t as DocsLanguage } from "./routing-CHvzedJA.js";
+import { t as DocsLanguage } from "./routing-ByeZ2P3d.js";
 import * as SDKJSON from "@stainless/sdk-json";
 
 //#region src/search/types.d.ts

package/dist/{utils-DYoSclrR.d.ts → utils-D0OXpyQu.d.ts}

@@ -1,5 +1,5 @@
-import { t as DocsLanguage } from "./routing-CHvzedJA.js";
-import { C as TransformRequestSnippetFn } from "./sdk-CUDyIYiV.js";
+import { t as DocsLanguage } from "./routing-ByeZ2P3d.js";
+import { C as TransformRequestSnippetFn } from "./sdk-DBxkJu1a.js";
 import * as SDKJSON from "@stainless/sdk-json";
 
 //#region src/markdown/utils.d.ts

package/dist/{utils-BCfb0F9R.js → utils-Jo_o4DX9.js}

@@ -11,7 +11,8 @@ function getDecl(env, path) {
 	return decl;
 }
 function getSnippet(env, path) {
-	let snippet = env.spec?.snippets?.[`${env.language}.default`]?.[path];
+	const lang = env.language === "http" ? "http.curl" : `${env.language}.default`;
+	let snippet = env.spec?.snippets?.[lang]?.[path];
 	if (typeof snippet === "string" && env.transforms?.transformRequestSnippet) snippet = env.transforms.transformRequestSnippet({
 		snippet,
 		language: env.language

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stainless-api/docs-ui",
   "private": false,
-  "version": "0.1.0-beta.33",
+  "version": "0.1.0-beta.35",
   "publishConfig": {
     "access": "public"
   },
@@ -9,6 +9,32 @@
   "files": [
     "dist"
   ],
+  "peerDependencies": {
+    "react": ">=19.0.0",
+    "react-dom": ">=19.0.0"
+  },
+  "dependencies": {
+    "@algolia/client-search": "^5.25.0",
+    "@markdoc/markdoc": "^0.5.4",
+    "clsx": "^2.1.1",
+    "fuse.js": "^7.1.0",
+    "htmlparser2": "^10.0.0",
+    "lucide-react": "^0.554.0",
+    "@stainless-api/ui-primitives": "0.1.0-beta.25"
+  },
+  "devDependencies": {
+    "@types/node": "24.10.1",
+    "@types/react": "^19.2.6",
+    "@types/react-dom": "^19.2.3",
+    "dotenv": "17.2.3",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "tsdown": "^0.16.5",
+    "tsx": "^4.20.3",
+    "typescript": "5.9.3",
+    "@stainless/eslint-config": "0.1.0-beta.0",
+    "@stainless/sdk-json": "^0.1.0-beta.0"
+  },
   "exports": {
     ".": {
       "default": "./dist/index.js"
@@ -60,35 +86,11 @@
     },
     "./search/providers/*": {
       "default": "./dist/search/providers/*.js"
+    },
+    "./spec": {
+      "default": "./dist/spec.ts"
     }
   },
-  "peerDependencies": {
-    "react": ">=19.0.0",
-    "react-dom": ">=19.0.0"
-  },
-  "dependencies": {
-    "@algolia/client-search": "^5.25.0",
-    "@markdoc/markdoc": "^0.5.2",
-    "ai": "4.3.19",
-    "clsx": "^2.1.1",
-    "fuse.js": "^7.1.0",
-    "htmlparser2": "^10.0.0",
-    "lucide-react": "^0.553.0",
-    "@stainless-api/ui-primitives": "0.1.0-beta.25"
-  },
-  "devDependencies": {
-    "@types/node": "24.5.1",
-    "@types/react": "^19.2.4",
-    "@types/react-dom": "^19.2.3",
-    "dotenv": "17.2.3",
-    "react": "^19.2.0",
-    "react-dom": "^19.2.0",
-    "tsdown": "^0.16.4",
-    "tsx": "^4.20.3",
-    "typescript": "5.9.3",
-    "@stainless/eslint-config": "0.1.0-beta.0",
-    "@stainless/sdk-json": "^0.1.0-beta.0"
-  },
   "scripts": {
     "build": "tsdown",
     "clean": "rm -rf dist",

package/dist/components/chat.d.ts

@@ -1,14 +0,0 @@
-import * as react_jsx_runtime0 from "react/jsx-runtime";
-
-//#region src/components/chat.d.ts
-declare function Chat(): react_jsx_runtime0.JSX.Element;
-type ChatModalProps = {
-  id?: string;
-  open?: boolean;
-};
-declare function ChatModal({
-  id,
-  open: isOpen
-}: ChatModalProps): react_jsx_runtime0.JSX.Element;
-//#endregion
-export { Chat, ChatModal, ChatModalProps };