@stainless-api/docs 0.1.0-beta.13 → 0.1.0-beta.131

package/ambient.d.ts

@@ -0,0 +1,6 @@
+import 'react';
+declare module 'react' {
+  interface CSSProperties {
+    [key: `--${string}`]: string | number;
+  }
+}

package/eslint-suppressions.json

@@ -0,0 +1,90 @@
+{
+  "plugin/components/SnippetCode.tsx": {
+    "@typescript-eslint/no-explicit-any": {
+      "count": 1
+    }
+  },
+  "plugin/components/StainlessIslands.tsx": {
+    "@typescript-eslint/no-unsafe-assignment": {
+      "count": 1
+    },
+    "@typescript-eslint/no-unsafe-member-access": {
+      "count": 2
+    }
+  },
+  "plugin/globalJs/copy.ts": {
+    "@typescript-eslint/no-explicit-any": {
+      "count": 4
+    },
+    "@typescript-eslint/no-floating-promises": {
+      "count": 1
+    },
+    "@typescript-eslint/no-unsafe-assignment": {
+      "count": 2
+    },
+    "@typescript-eslint/no-unsafe-member-access": {
+      "count": 3
+    }
+  },
+  "plugin/index.ts": {
+    "@typescript-eslint/no-explicit-any": {
+      "count": 1
+    },
+    "@typescript-eslint/no-unsafe-assignment": {
+      "count": 1
+    }
+  },
+  "plugin/languages.ts": {
+    "@typescript-eslint/no-explicit-any": {
+      "count": 1
+    }
+  },
+  "plugin/referencePlaceholderUtils.ts": {
+    "@typescript-eslint/no-unsafe-assignment": {
+      "count": 1
+    }
+  },
+  "plugin/specs/generateSpec.ts": {
+    "@typescript-eslint/no-unsafe-assignment": {
+      "count": 2
+    }
+  },
+  "plugin/specs/worker.ts": {
+    "@typescript-eslint/no-explicit-any": {
+      "count": 3
+    },
+    "@typescript-eslint/no-unsafe-argument": {
+      "count": 1
+    },
+    "@typescript-eslint/no-unsafe-assignment": {
+      "count": 7
+    },
+    "@typescript-eslint/no-unsafe-member-access": {
+      "count": 4
+    },
+    "@typescript-eslint/no-unsafe-return": {
+      "count": 1
+    },
+    "@typescript-eslint/prefer-promise-reject-errors": {
+      "count": 4
+    }
+  },
+  "stl-docs/components/sidebars/convertAstroSidebarToStl.tsx": {
+    "@typescript-eslint/no-unsafe-argument": {
+      "count": 1
+    },
+    "@typescript-eslint/no-unsafe-assignment": {
+      "count": 1
+    }
+  },
+  "stl-docs/proseDocSync.ts": {
+    "@typescript-eslint/restrict-template-expressions": {
+      "count": 4
+    }
+  },
+  "stl-docs/proseSearchIndexing.ts": {
+    "@typescript-eslint/restrict-template-expressions": {
+      "count": 1
+    }
+  }
+}

package/{eslint.config.js → eslint.config.ts}

@@ -1,5 +1,3 @@
-// @ts-check
-
 import { defineConfig } from 'eslint/config';
 import { config } from '@stainless/eslint-config/astro';
 

package/locals.d.ts

@@ -0,0 +1,17 @@
+type SidebarEntry = App.Locals['starlightRoute']['sidebar'][number];
+
+/**
+ * Extending Astro’s `App.Locals` interface
+ */
+declare namespace App {
+  interface Locals {
+    _stlStarlightPage?: {
+      skipRenderingStarlightTitle?: boolean;
+      hasMarkdownRoute?: boolean;
+      fullSidebar?: SidebarEntry[];
+    };
+
+    stainlessProject?: string;
+    language?: import('@stainless-api/docs-ui/routing').DocsLanguage;
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stainless-api/docs",
-  "version": "0.1.0-beta.13",
+  "version": "0.1.0-beta.131",
   "publishConfig": {
     "access": "public"
   },
@@ -9,68 +9,86 @@
   "exports": {
     ".": "./stl-docs/index.ts",
     "./plugin": "./plugin/index.ts",
-    "./OverviewRoute": "./plugin/routes/Overview.astro",
-    "./DocsRoute": "./plugin/routes/Docs.astro",
-    "./DocsStaticRoute": "./plugin/routes/DocsStatic.astro",
-    "./MarkdownRoute": "./plugin/routes/markdown.ts",
-    "./Search": "./plugin/components/search/Search.astro",
-    "./replaceSidebarPlaceholderMiddleware": "./plugin/replaceSidebarPlaceholderMiddleware.ts",
     "./plugin/middleware": "./plugin/middlewareBuilder/stlStarlightMiddleware.ts",
     "./plugin/MiddlewareTypes": "./plugin/middlewareBuilder/stainlessMiddleware.d.ts",
-    "./Header": "./stl-docs/components/Header.astro",
-    "./ThemeSelect": "./stl-docs/components/ThemeSelect.astro",
-    "./BaseSidebar": "./stl-docs/components/sidebars/BaseSidebar.astro",
-    "./SDKSelectSidebar": "./stl-docs/components/sidebars/SDKSelectSidebar.astro",
-    "./ContentPanel": "./stl-docs/components/content-panel/ContentPanel.astro",
-    "./TableOfContents": "./stl-docs/components/TableOfContents.astro",
-    "./tabsMiddleware": "./stl-docs/tabsMiddleware.ts",
+    "./plugin/languages": "./plugin/languages.ts",
     "./stainless-docs/mintlify-compat": "./stl-docs/components/mintlify-compat/index.ts",
-    "./theme": "./theme.css",
     "./mintlify-compat.css": "./styles/mintlify-compat.css",
-    "./font-imports": "./styles/fonts.css"
+    "./docs-config": "./stl-docs/loadStlDocsConfig.ts",
+    "./specs/fetchSpecSSR": "./plugin/specs/fetchSpecSSR.ts",
+    "./generate-docs-routes": "./plugin/helpers/generateDocsRoutes.ts",
+    "./components": "./stl-docs/components/index.ts",
+    "./components/scripts": "./stl-docs/components/scripts.ts",
+    "./components/Head": "./stl-docs/components/Head.astro",
+    "./components/PageFrame": "./stl-docs/components/PageFrame.astro",
+    "./components/PageTitle": "./stl-docs/components/PageTitle.astro",
+    "./components/ContentBreadcrumbs": "./stl-docs/components/ContentBreadcrumbs.tsx",
+    "./components/AIDropdown": "./stl-docs/components/AIDropdown.tsx",
+    "./components/Footer": "./stl-docs/components/Footer.astro",
+    "./components/Pagination": "./stl-docs/components/pagination/Pagination.astro"
   },
   "keywords": [],
   "author": "",
   "license": "ISC",
   "engines": {
-    "node": ">=18.17.1"
+    "node": ">=22.12.0"
   },
   "peerDependencies": {
-    "@astrojs/starlight": ">=0.36.1",
-    "astro": ">=5.15.3"
+    "@astrojs/starlight": ">=0.38.0",
+    "astro": ">=6.0.0",
+    "react": ">=19.0.0",
+    "react-dom": ">=19.0.0",
+    "vite": ">=7.3.1"
   },
   "dependencies": {
-    "@astrojs/markdown-remark": "^6.3.2",
-    "@astrojs/react": "^4.4.1",
-    "@stainless-api/sdk": "0.1.0-alpha.12",
-    "cheerio": "^1.1.2",
+    "@astrojs/markdown-remark": "^7.1.0",
+    "@astrojs/react": "^5.0.3",
+    "@markdoc/markdoc": "^0.5.7",
+    "@stainless-api/sdk": "0.5.0",
+    "@streamparser/json-whatwg": "^0.0.22",
+    "cheerio": "^1.2.0",
     "clsx": "^2.1.1",
-    "dotenv": "17.2.3",
-    "get-port": "^7.1.0",
-    "highlight.js": "^11.11.1",
-    "lucide-react": "^0.544.0",
-    "marked": "^16.0.0",
-    "react": "^19.2.0",
-    "react-dom": "^19.2.0",
+    "dotenv": "17.4.1",
+    "lucide-react": "^0.577.0",
+    "motion": "^12.38.0",
+    "node-html-parser": "^7.1.0",
+    "rehype-parse": "^9.0.1",
+    "rehype-remark": "^10.0.1",
+    "react-markdown": "^10.1.0",
+    "react-syntax-highlighter": "^16.1.1",
+    "remark-gfm": "^4.0.1",
     "remark-github-alerts": "^0.1.1",
-    "shiki": "^3.9.2",
+    "remark-stringify": "^11.0.0",
+    "remend": "^1.3.0",
+    "shiki": "^4.0.2",
+    "unified": "^11.0.5",
+    "vite-plugin-prebundle-workers": "^0.2.0",
     "web-worker": "^1.5.0",
-    "yaml": "^2.8.0",
-    "@stainless-api/docs-ui": "0.1.0-beta.10",
-    "@stainless-api/ui-primitives": "0.1.0-beta.11"
+    "@stainless-api/docs-search": "0.1.0-beta.47",
+    "@stainless-api/docs-ui": "0.1.0-beta.94",
+    "@stainless-api/ui-primitives": "0.1.0-beta.53"
   },
   "devDependencies": {
-    "@markdoc/markdoc": "^0.5.2",
-    "@types/node": "^24.4.0",
-    "@types/react": "^19.2.2",
-    "@types/react-dom": "^19.2.2",
-    "tsx": "^4.20.3",
-    "zod": "^4.0.0",
-    "@stainless/eslint-config": "0.0.0"
+    "@astrojs/check": "^0.9.8",
+    "@types/node": "24.12.2",
+    "@types/react": "19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@types/react-syntax-highlighter": "^15.5.13",
+    "astro": "^6.1.5",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "typescript": "6.0.2",
+    "vite": "^7.3.2",
+    "vitest": "^4.1.3",
+    "zod": "^4.3.6",
+    "@stainless/eslint-config": "0.1.0-beta.2",
+    "@stainless/sdk-json": "^0.1.0-beta.10"
   },
   "scripts": {
-    "vendor-deps": "pnpm tsx scripts/vendor_deps.ts",
-    "lint": "eslint . --max-warnings 0",
-    "sync": "astro sync"
+    "vendor-deps": "node scripts/vendor_deps.ts",
+    "lint": "eslint --flag unstable_native_nodejs_ts_config . --max-warnings 0",
+    "sync": "astro sync",
+    "check:types": "astro check",
+    "test": "vitest run"
   }
 }

package/playground-virtual-modules.d.ts

@@ -0,0 +1,96 @@
+declare module 'virtual:stl-playground/typescript.json' {
+  const data: {
+    links: [string, string][];
+    files: [string, string][];
+  } | null;
+  export { data as default };
+}
+declare module 'virtual:stl-playground/python.json' {
+  const data: { files: Record<string, string>; wheel: string } | null;
+  export { data as default };
+}
+declare module 'virtual:stl-playground/auth.json' {
+  const data:
+    | ({
+        type: 'http_bearer' | 'query' | 'header' | 'oauth2' | 'http_basic' | 'http_digest';
+        description?: string;
+        name: string;
+        title: string;
+        header: string | undefined;
+        example: string | undefined;
+      } & {
+        opts: {
+          name: string;
+          type: 'string' | 'number' | 'boolean' | 'null' | 'integer';
+          nullable: boolean;
+          description?: string | undefined;
+          example?: unknown;
+          default?: unknown;
+          read_env?: string | undefined;
+          auth?:
+            | {
+                security_scheme: string;
+                role?: 'value' | 'password' | 'username' | 'client_id' | 'client_secret' | undefined;
+              }
+            | undefined;
+        }[];
+      })[]
+    | null;
+  export { data as default };
+}
+declare module 'virtual:stl-playground/data' {
+  import type { Config } from 'virtual:stl-playground/create';
+  declare const data: Config;
+  export { data as default };
+}
+declare module 'virtual:stl-playground/create' {
+  export type PlaygroundLanguage = 'python' | 'typescript' | 'http';
+  export type Config = {
+    wheelUrl: string;
+    pyTypes: {
+      files: Record<string, string>;
+      wheel: string;
+    } | null;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    HIGHLIGHT_THEMES: any;
+    tsTypes: {
+      links: [string, string][];
+      files: [string, string][];
+    } | null;
+    authData:
+      | ({
+          type: 'http_bearer' | 'query' | 'header' | 'oauth2' | 'http_basic' | 'http_digest';
+          description?: string;
+          name: string;
+          title: string;
+          header: string | undefined;
+          example: string | undefined;
+        } & {
+          opts: {
+            name: string;
+            type: 'string' | 'number' | 'boolean' | 'null' | 'integer';
+            nullable: boolean;
+            description?: string | undefined;
+            example?: unknown;
+            default?: unknown;
+            read_env?: string | undefined;
+            auth?:
+              | {
+                  security_scheme: string;
+                  role?: 'value' | 'password' | 'username' | 'client_id' | 'client_secret' | undefined;
+                }
+              | undefined;
+          }[];
+        })[]
+      | null;
+  };
+  export function createPlayground(
+    props: {
+      lang: PlaygroundLanguage;
+      doc: string;
+      /** div.stl-snippet-request-container */
+      container: HTMLElement;
+      onLanguageSelect: (value: string) => void;
+    } & Config,
+  ): () => Promise<void>;
+}

package/plugin/assets/languages/cli.svg

@@ -0,0 +1,14 @@
+    <svg
+      xmlns="http://www.w3.org/2000/svg"
+      viewBox="0 0 20 20"
+      width="24"
+      height="24"
+      fill="nopne"
+    >
+      <path
+        fill-rule="evenodd"
+        d="M3.25 3A2.25 2.25 0 0 0 1 5.25v9.5A2.25 2.25 0 0 0 3.25 17h13.5A2.25 2.25 0 0 0 19 14.75v-9.5A2.25 2.25 0 0 0 16.75 3zm.943 8.752a.75.75 0 0 1 .055-1.06L6.128 9l-1.88-1.693a.75.75 0 1 1 1.004-1.114l2.5 2.25a.75.75 0 0 1 0 1.114l-2.5 2.25a.75.75 0 0 1-1.06-.055M9.75 10.25a.75.75 0 0 0 0 1.5h2.5a.75.75 0 0 0 0-1.5z"
+        clip-rule="evenodd"
+        fill="#a2a1a1"
+      />
+    </svg>

package/plugin/assets/languages/csharp.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none"><defs><linearGradient id="a-_r_1_" x1="46.77" x2="69.91" y1="86.46" y2="126.73" gradientTransform="matrix(8.78996,0,0,8.78996,-233.98,-518.97)" gradientUnits="userSpaceOnUse"><stop stop-color="#927be5"></stop><stop offset="1" stop-color="#512bd4"></stop></linearGradient><filter id="b-_r_1_" width="42.84" height="39.14" x="44.63" y="91.89" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"></feFlood><feColorMatrix in="SourceAlpha" result="hardAlpha" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"></feColorMatrix><feOffset></feOffset><feColorMatrix values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.1 0"></feColorMatrix><feBlend in2="BackgroundImageFix" result="effect1_dropShadow_2037_2800"></feBlend><feColorMatrix in="SourceAlpha" result="hardAlpha" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"></feColorMatrix><feOffset dy="1"></feOffset><feGaussianBlur stdDeviation="2.5"></feGaussianBlur><feColorMatrix values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.1 0"></feColorMatrix><feBlend in2="effect1_dropShadow_2037_2800" result="effect2_dropShadow_2037_2800"></feBlend><feColorMatrix in="SourceAlpha" result="hardAlpha" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"></feColorMatrix><feOffset dy="4"></feOffset><feGaussianBlur stdDeviation="2"></feGaussianBlur><feColorMatrix values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.09 0"></feColorMatrix><feBlend in2="effect2_dropShadow_2037_2800" result="effect3_dropShadow_2037_2800"></feBlend><feColorMatrix in="SourceAlpha" result="hardAlpha" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"></feColorMatrix><feOffset dy="9"></feOffset><feGaussianBlur stdDeviation="2.5"></feGaussianBlur><feColorMatrix values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.05 0"></feColorMatrix><feBlend in2="effect3_dropShadow_2037_2800" result="effect4_dropShadow_2037_2800"></feBlend><feColorMatrix in="SourceAlpha" result="hardAlpha" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"></feColorMatrix><feOffset dy="15"></feOffset><feGaussianBlur stdDeviation="3"></feGaussianBlur><feColorMatrix values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.01 0"></feColorMatrix><feBlend in2="effect4_dropShadow_2037_2800" result="effect5_dropShadow_2037_2800"></feBlend><feBlend in="SourceGraphic" in2="effect5_dropShadow_2037_2800" result="shape"></feBlend></filter></defs><path fill="url(#a-_r_1_)" d="M135.73 285.85v173.93a60.2 60.2 0 0 0 30.13 52.17l150.62 86.97a60.2 60.2 0 0 0 60.25 0l150.62-86.97a60.2 60.2 0 0 0 30.13-52.17V285.85a60.2 60.2 0 0 0-30.13-52.18l-150.62-86.95a60.2 60.2 0 0 0-60.25 0l-150.62 86.95a60.3 60.3 0 0 0-30.13 52.18" transform="scale(0.44288615) matrix(0.1,0,0,0.1,-7.57,-10.19)"></path><path fill="#fff" d="M54.06 98.03v6.86a1.7 1.7 0 0 0 1.71 1.7 1.7 1.7 0 0 0 1.71-1.7 1.71 1.71 0 1 1 3.43 0 5.14 5.14 0 1 1-10.28 0v-6.86a5.14 5.14 0 1 1 10.28 0 1.71 1.71 0 1 1-3.43 0 1.71 1.71 0 1 0-3.42 0zm27.41 6.86a1.7 1.7 0 0 1-1.71 1.7h-1.71v1.72c0 .46-.18.9-.5 1.21a1.7 1.7 0 0 1-2.43 0 1.7 1.7 0 0 1-.5-1.2v-1.72h-3.43v1.71a1.7 1.7 0 0 1-1.71 1.72 1.7 1.7 0 0 1-1.72-1.72v-1.71h-1.71a1.71 1.71 0 1 1 0-3.43h1.71v-3.43h-1.71a1.71 1.71 0 1 1 0-3.42h1.71V94.6a1.71 1.71 0 1 1 3.43 0v1.72h3.43V94.6a1.71 1.71 0 1 1 3.43 0v1.72h1.7c.46 0 .9.18 1.22.5a1.7 1.7 0 0 1 0 2.42 1.7 1.7 0 0 1-1.21.5h-1.71v3.43h1.7a1.7 1.7 0 0 1 1.72 1.71m-6.85-5.14h-3.43v3.42h3.43z" filter="url(#b-_r_1_)" style="mix-blend-mode: screen;" transform="scale(0.44288615) matrix(0.879,0,0,0.879,-30.96,-62.09)"></path></svg>

package/plugin/assets/languages/php.svg

@@ -0,0 +1,4 @@
+
+<svg viewBox="0 0 128 128" width="24" height="24">
+<path fill="url(#a)" d="M0 64c0 18.593 28.654 33.667 64 33.667 35.346 0 64-15.074 64-33.667 0-18.593-28.655-33.667-64-33.667C28.654 30.333 0 45.407 0 64Z"></path><path fill="#777bb3" d="M64 95.167c33.965 0 61.5-13.955 61.5-31.167 0-17.214-27.535-31.167-61.5-31.167S2.5 46.786 2.5 64c0 17.212 27.535 31.167 61.5 31.167Z"></path><path d="M34.772 67.864c2.793 0 4.877-.515 6.196-1.53 1.306-1.006 2.207-2.747 2.68-5.175.44-2.27.272-3.854-.5-4.71-.788-.874-2.493-1.317-5.067-1.317h-4.464l-2.473 12.732zM20.173 83.547a.694.694 0 0 1-.68-.828l6.557-33.738a.695.695 0 0 1 .68-.561h14.134c4.442 0 7.748 1.206 9.827 3.585 2.088 2.39 2.734 5.734 1.917 9.935-.333 1.711-.905 3.3-1.7 4.724a15.818 15.818 0 0 1-3.128 3.92c-1.531 1.432-3.264 2.472-5.147 3.083-1.852.604-4.232.91-7.07.91h-5.724l-1.634 8.408a.695.695 0 0 1-.682.562z"></path><path fill="#fff" d="M34.19 55.826h3.891c3.107 0 4.186.682 4.553 1.089.607.674.723 2.097.331 4.112-.439 2.257-1.253 3.858-2.42 4.756-1.194.92-3.138 1.386-5.773 1.386h-2.786l2.205-11.342zm6.674-8.1H26.731a1.39 1.39 0 0 0-1.364 1.123L18.81 82.588a1.39 1.39 0 0 0 1.363 1.653h7.35a1.39 1.39 0 0 0 1.363-1.124l1.525-7.846h5.151c2.912 0 5.364-.318 7.287-.944 1.977-.642 3.796-1.731 5.406-3.237a16.522 16.522 0 0 0 3.259-4.087c.831-1.487 1.429-3.147 1.775-4.931.86-4.423.161-7.964-2.076-10.524-2.216-2.537-5.698-3.823-10.349-3.823zM30.301 68.557h4.471c2.963 0 5.17-.557 6.62-1.675 1.451-1.116 2.428-2.98 2.938-5.591.485-2.508.264-4.277-.665-5.308-.931-1.03-2.791-1.546-5.584-1.546h-5.036l-2.743 14.12m10.563-19.445c4.252 0 7.353 1.117 9.303 3.348 1.95 2.232 2.536 5.347 1.76 9.346-.322 1.648-.863 3.154-1.625 4.518-.764 1.366-1.76 2.614-2.991 3.747-1.468 1.373-3.097 2.352-4.892 2.935-1.794.584-4.08.875-6.857.875h-6.296l-1.743 8.97h-7.35l6.558-33.739h14.133"></path><path d="M69.459 74.577a.694.694 0 0 1-.682-.827l2.9-14.928c.277-1.42.209-2.438-.19-2.87-.245-.263-.979-.704-3.15-.704h-5.256l-3.646 18.768a.695.695 0 0 1-.683.56h-7.29a.695.695 0 0 1-.683-.826l6.558-33.739a.695.695 0 0 1 .682-.561h7.29a.695.695 0 0 1 .683.826L64.41 48.42h5.653c4.307 0 7.227.758 8.928 2.321 1.733 1.593 2.275 4.14 1.608 7.573l-3.051 15.702a.695.695 0 0 1-.682.56h-7.407z"></path><path fill="#fff" d="M65.31 38.755h-7.291a1.39 1.39 0 0 0-1.364 1.124l-6.557 33.738a1.39 1.39 0 0 0 1.363 1.654h7.291a1.39 1.39 0 0 0 1.364-1.124l3.537-18.205h4.682c2.168 0 2.624.463 2.641.484.132.14.305.795.019 2.264l-2.9 14.927a1.39 1.39 0 0 0 1.364 1.654h7.408a1.39 1.39 0 0 0 1.363-1.124l3.051-15.7c.715-3.686.103-6.45-1.82-8.217-1.836-1.686-4.91-2.505-9.398-2.505h-4.81l1.421-7.315a1.39 1.39 0 0 0-1.364-1.655zm0 1.39-1.743 8.968h6.496c4.087 0 6.907.714 8.457 2.14 1.553 1.426 2.017 3.735 1.398 6.93l-3.052 15.699h-7.407l2.901-14.928c.33-1.698.208-2.856-.365-3.474-.573-.617-1.793-.926-3.658-.926h-5.829l-3.756 19.327H51.46l6.558-33.739h7.292z"></path><path d="M92.136 67.864c2.793 0 4.878-.515 6.198-1.53 1.304-1.006 2.206-2.747 2.679-5.175.44-2.27.273-3.854-.5-4.71-.788-.874-2.493-1.317-5.067-1.317h-4.463l-2.475 12.732zM77.54 83.547a.694.694 0 0 1-.682-.828l6.557-33.738a.695.695 0 0 1 .682-.561H98.23c4.442 0 7.748 1.206 9.826 3.585 2.089 2.39 2.734 5.734 1.917 9.935a15.878 15.878 0 0 1-1.699 4.724 15.838 15.838 0 0 1-3.128 3.92c-1.53 1.432-3.265 2.472-5.147 3.083-1.852.604-4.232.91-7.071.91h-5.723l-1.633 8.408a.695.695 0 0 1-.683.562z"></path><path fill="#fff" d="M91.555 55.826h3.891c3.107 0 4.186.682 4.552 1.089.61.674.724 2.097.333 4.112-.44 2.257-1.254 3.858-2.421 4.756-1.195.92-3.139 1.386-5.773 1.386h-2.786l2.204-11.342zm6.674-8.1H84.096a1.39 1.39 0 0 0-1.363 1.123l-6.558 33.739a1.39 1.39 0 0 0 1.364 1.653h7.35a1.39 1.39 0 0 0 1.363-1.124l1.525-7.846h5.15c2.911 0 5.364-.318 7.286-.944 1.978-.642 3.797-1.731 5.408-3.238a16.52 16.52 0 0 0 3.258-4.086c.832-1.487 1.428-3.147 1.775-4.931.86-4.423.162-7.964-2.076-10.524-2.216-2.537-5.697-3.823-10.35-3.823zM87.666 68.557h4.47c2.964 0 5.17-.557 6.622-1.675 1.45-1.116 2.428-2.98 2.936-5.591.487-2.508.266-4.277-.665-5.308-.93-1.03-2.791-1.546-5.583-1.546h-5.035Zm10.563-19.445c4.251 0 7.354 1.117 9.303 3.348 1.95 2.232 2.537 5.347 1.759 9.346-.32 1.648-.862 3.154-1.624 4.518-.763 1.366-1.76 2.614-2.992 3.747-1.467 1.373-3.097 2.352-4.892 2.935-1.793.584-4.078.875-6.856.875h-6.295l-1.745 8.97h-7.35l6.558-33.739h14.133"></path><defs><radialGradient id="a" cx="0" cy="0" r="1" gradientTransform="matrix(84.04136 0 0 84.04136 38.426 42.169)" gradientUnits="userSpaceOnUse"><stop stop-color="#AEB2D5"></stop><stop offset=".3" stop-color="#AEB2D5"></stop><stop offset=".75" stop-color="#484C89"></stop><stop offset="1" stop-color="#484C89"></stop></radialGradient></defs>
+</svg>

package/plugin/buildAlgoliaIndex.ts

@@ -1,10 +1,8 @@
 import Markdoc from '@markdoc/markdoc';
-import Stainless from '@stainless-api/sdk';
-import { createSDKJSON, parseInputs, transformOAS } from './cms/worker';
-import type * as SDKJSON from '~/lib/json-spec-v2/types';
-import { Languages } from '@stainless-api/docs-ui/src/routing';
-import { buildIndex } from '@stainless-api/docs-ui/src/search/providers/algolia';
-import type { VersionUserConfig } from './loadPluginConfig';
+import { buildIndex } from '@stainless-api/docs-search/providers/algolia';
+import type { AstroIntegrationLogger } from 'astro';
+import { generateIndex } from '@stainless-api/docs-search/indexer';
+import { SpecComposite } from './specs';
 
 const markdocConfig = {
   nodes: {
@@ -20,37 +18,28 @@ function renderMarkdown(content?: string) {
   return Markdoc.renderers.html(transformed);
 }
 
-export async function buildAlgoliaIndex({ version, apiKey }: { version: VersionUserConfig; apiKey: string }) {
-  const client = new Stainless({ apiKey });
-  const configs = await client.projects.configs.retrieve({
-    project: version.stainlessProject,
-    branch: version.branch,
-    include: 'openapi',
-  });
-
-  const configYML = Object.values(configs)[0] as { content: any };
-  const oasJson = Object.values(configs)[1] as { content: any };
-  const configStr = configYML['content'];
-  const oasStr = oasJson['content'];
-  const { oas, config } = await parseInputs({
-    oas: oasStr,
-    config: configStr,
-  });
-
-  const transformedOAS = await transformOAS({ oas, config });
-
-  const languages =
-    config.docs?.languages ??
-    (Object.entries(config.targets)
-      // @ts-expect-error we don't have the actual Stainless config type here
-      .filter(([name, target]) => Languages.includes(name) && !target.skip)
-      .map(([name]) => name) as SDKJSON.SpecLanguage[]);
+export async function buildAlgoliaIndex({
+  specComposite,
+  logger,
+}: {
+  specComposite: SpecComposite;
+  logger?: AstroIntegrationLogger;
+}) {
+  function warnLog(message: string) {
+    if (logger) {
+      logger.warn(message);
+    } else {
+      console.warn(message);
+    }
+  }
 
-  const sdkJson = await createSDKJSON({
-    oas: transformedOAS,
-    config,
-    languages,
-  });
+  function infoLog(message: string) {
+    if (logger) {
+      logger.info(message);
+    } else {
+      console.log(message);
+    }
+  }
 
   const {
     PUBLIC_ALGOLIA_APP_ID: appId,
@@ -64,9 +53,21 @@ export async function buildAlgoliaIndex({ version, apiKey }: { version: VersionU
       !indexName && 'PUBLIC_ALGOLIA_INDEX',
       !algoliaWriteKey && 'PRIVATE_ALGOLIA_WRITE_KEY',
     ].filter(Boolean);
-    console.warn(`⚠️ Skipping Algolia indexing due to missing environment variables: ${missing.join(', ')}`);
+    warnLog(`Skipping Algolia indexing due to missing environment variables: ${missing.join(', ')}`);
     return;
   }
-  await buildIndex(appId, indexName, algoliaWriteKey, sdkJson, renderMarkdown);
-  console.log('Indexing complete.');
+
+  const indexEntries = specComposite.listUniqueSpecs().flatMap((spec) =>
+    Array.from(
+      generateIndex(
+        spec.data.sdkJson,
+        renderMarkdown,
+        true,
+        spec.data.languages.filter((l) => l !== 'sql' && l !== 'openapi'),
+      ),
+    ),
+  );
+
+  await buildIndex(appId, indexName, algoliaWriteKey, indexEntries, renderMarkdown);
+  infoLog('Indexing complete.');
 }

package/plugin/components/MethodDescription.tsx

@@ -0,0 +1,54 @@
+import { MethodDescriptionProps } from '@stainless-api/docs-ui/components';
+import { useComponents } from '@stainless-api/docs-ui/contexts/use-components';
+import style from '@stainless-api/docs-ui/style';
+import { Button } from '@stainless-api/ui-primitives';
+
+function shouldCollapseDescription(description: string) {
+  const MIN_CHARS = 400;
+  const MIN_LINES = 6;
+
+  const lineCount = description.split('\n').length;
+
+  if (description.length >= MIN_CHARS) return true;
+  if (lineCount >= MIN_LINES) return true;
+
+  // Markdown structure often means longer content
+  if (/#\s/.test(description)) return true; // has headings
+  if (/```/.test(description)) return true; // has code blocks
+  if (/^\s*[-*]\s+/m.test(description)) return true; // has lists
+
+  return false;
+}
+
+export function MethodDescription({ description }: MethodDescriptionProps) {
+  const { Markdown } = useComponents();
+
+  if (description) {
+    // Attempt to determine if we should make the description collapsible initially
+    // or not. If we get this right, there will be no FOUC.
+    const collapsible = shouldCollapseDescription(description);
+
+    return (
+      <div className="stl-method-description">
+        <div
+          className={style.MethodDescription}
+          data-stldocs-property-group="method-description"
+          data-collapsed={collapsible ? 'true' : 'false'}
+        >
+          <Markdown content={description} />
+        </div>
+        <div className="stl-method-description-overflow-wrapper">
+          <Button
+            type="button"
+            data-method-description-toggle
+            size="sm"
+            variant="ghost"
+            hidden={!collapsible}
+          >
+            Show more
+          </Button>
+        </div>
+      </div>
+    );
+  }
+}

package/plugin/components/RequestBuilder/ParamEditor.tsx

@@ -0,0 +1,55 @@
+import { useMemo } from 'react';
+import { Button } from '@stainless-api/ui-primitives';
+import type { Param } from './spec-helpers';
+import { InfoIcon } from 'lucide-react';
+import { Input } from '@stainless-api/docs-ui/components';
+
+function setHighlight(stainlessPath: string, highlighted: boolean) {
+  const ele = document.getElementById(stainlessPath);
+  if (!ele) return;
+  ele.classList.toggle('stldocs-property-highlighted', highlighted);
+  if (highlighted) {
+    if (location.hash) {
+      const prevScroll = document.documentElement.scrollTop;
+      location.hash = '';
+      document.documentElement.scrollTop = prevScroll;
+    }
+    if (document.body.clientWidth >= 1280) {
+      ele.scrollIntoView({
+        behavior: 'smooth',
+      });
+    }
+  }
+}
+
+function htmlToText(html: string) {
+  const template = document.createElement('template');
+  template.innerHTML = html;
+  return template.content.textContent;
+}
+
+export function ParamEditor({ param }: { param: Param }) {
+  const type = useMemo(() => htmlToText(param.type), [param.type]);
+
+  return (
+    <label className="request-builder-param">
+      <Button
+        className="request-builder-param-info-button"
+        variant="ghost"
+        href={`#${encodeURIComponent(param.stainlessPath)}`}
+      >
+        <Button.Icon icon={InfoIcon} size={16} />
+      </Button>
+
+      <span className="request-builder-param-label">{param.key}</span>
+      <span className="request-builder-param-colon">:</span>
+
+      <Input
+        className="request-builder-param-value"
+        onFocus={() => setHighlight(param.stainlessPath, true)}
+        onBlur={() => setHighlight(param.stainlessPath, false)}
+        placeholder={type}
+      />
+    </label>
+  );
+}