@stainless-api/docs-ui 0.1.0-beta.34 → 0.1.0-beta.36

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-BUaRdg0v.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-DZBqvhxT.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-DZBqvhxT.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-BUaRdg0v.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-D3jChPAG.d.ts → types-DNSz4kuM.d.ts}

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

package/dist/{use-components-mJnQErn0.js → use-components-BHEwm0mE.js}

@@ -1,4 +1,4 @@
-import { i as useComponents } from "./component-generics-Baa_QTKJ.js";
+import { i as useComponents } from "./component-generics-D3ybuN5r.js";
 
 //#region src/contexts/use-components.tsx
 const useComponents$1 = () => useComponents();

package/dist/{utils-B0F_20cr.js → utils-2FmcHPHp.js}

@@ -1,5 +1,5 @@
-import { t as __export } from "./chunk-BZIdVjpq.js";
-import { f as parseStainlessPath } from "./routing-C4JpPxpl.js";
+import { t as __export } from "./chunk-DsStOjWQ.js";
+import { f as parseStainlessPath } from "./routing-8itEXLx6.js";
 
 //#region src/utils.ts
 var utils_exports = /* @__PURE__ */ __export({

package/dist/{utils-BJ2b0pdl.d.ts → utils-BwsGzMOo.d.ts}

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

package/dist/{utils-Br_vI9GZ.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/dist/utils.d.ts

@@ -1,2 +1,2 @@
-import { n as getResourceFromSpec, r as isResourceEmpty, t as flatResources } from "./utils-By4F4SN7.js";
+import { n as getResourceFromSpec, r as isResourceEmpty, t as flatResources } from "./utils-D43p_yTd.js";
 export { flatResources, getResourceFromSpec, isResourceEmpty };

package/dist/utils.js

@@ -1,4 +1,4 @@
-import "./routing-C4JpPxpl.js";
-import { n as getResourceFromSpec, r as isResourceEmpty, t as flatResources } from "./utils-B0F_20cr.js";
+import "./routing-8itEXLx6.js";
+import { n as getResourceFromSpec, r as isResourceEmpty, t as flatResources } from "./utils-2FmcHPHp.js";
 
 export { flatResources, getResourceFromSpec, isResourceEmpty };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stainless-api/docs-ui",
   "private": false,
-  "version": "0.1.0-beta.34",
+  "version": "0.1.0-beta.36",
   "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,34 +86,11 @@
     },
     "./search/providers/*": {
       "default": "./dist/search/providers/*.js"
+    },
+    "./spec": {
+      "default": "./dist/spec.js"
     }
   },
-  "peerDependencies": {
-    "react": ">=19.0.0",
-    "react-dom": ">=19.0.0"
-  },
-  "dependencies": {
-    "@algolia/client-search": "^5.25.0",
-    "@markdoc/markdoc": "^0.5.2",
-    "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",