@stainless-api/docs 0.1.0-beta.1 → 0.1.0-beta.10

package/CHANGELOG.md

@@ -1,5 +1,76 @@
 # @stainless-api/docs
 
+## 0.1.0-beta.10
+
+### Patch Changes
+
+- dc059d2: should include option in stl-docs virtual module
+
+## 0.1.0-beta.9
+
+### Patch Changes
+
+- d15a520: fix initialization of dropdown buttons
+- Updated dependencies [d15a520]
+  - @stainless-api/ui-primitives@0.1.0-beta.8
+  - @stainless-api/docs-ui@0.1.0-beta.7
+
+## 0.1.0-beta.8
+
+### Minor Changes
+
+- 917493d: move stainlessDocs into default export
+
+## 0.1.0-beta.7
+
+### Patch Changes
+
+- Updated dependencies [34e7c61]
+  - @stainless-api/ui-primitives@0.1.0-beta.7
+  - @stainless-api/docs-ui@0.1.0-beta.6
+
+## 0.1.0-beta.6
+
+### Patch Changes
+
+- 34cbd12: verify publishing
+- Updated dependencies [f664b4d]
+- Updated dependencies [34cbd12]
+  - @stainless-api/ui-primitives@0.1.0-beta.6
+  - @stainless-api/docs-ui@0.1.0-beta.5
+
+## 0.1.0-beta.5
+
+### Patch Changes
+
+- Updated dependencies [e7a2a96]
+  - @stainless-api/ui-primitives@0.1.0-beta.5
+  - @stainless-api/docs-ui@0.1.0-beta.4
+
+## 0.1.0-beta.4
+
+### Patch Changes
+
+- Updated dependencies [2853ae8]
+  - @stainless-api/ui-primitives@0.1.0-beta.4
+  - @stainless-api/docs-ui@0.1.0-beta.3
+
+## 0.1.0-beta.3
+
+### Patch Changes
+
+- Updated dependencies [870af8d]
+  - @stainless-api/ui-primitives@0.1.0-beta.3
+  - @stainless-api/docs-ui@0.1.0-beta.2
+
+## 0.1.0-beta.2
+
+### Patch Changes
+
+- Updated dependencies [7a5c841]
+  - @stainless-api/docs-ui@0.1.0-beta.2
+  - @stainless-api/ui-primitives@0.1.0-beta.2
+
 ## 0.1.0-beta.1
 
 ### Patch Changes

package/components/variables.css

@@ -1,7 +1,4 @@
 :root {
-  --sl-font: 'Geist', system-ui, sans-serif;
-  --sl-font-mono: 'Geist Mono', ui-monospace, monospace;
-
   --stldocs-font: var(--sl-font, system-ui, sans-serif);
   --stldocs-font-mono: var(--sl-font-mono, ui-monospace, monospace);
 
@@ -78,7 +75,6 @@
   /* UI Overrides */
   --stl-ui-button-border-radius: var(--sl-button-border-radius);
   --stl-ui-text-body: var(--sl-text-sm);
-  --stl-ui-font-family: var(--sl-font);
   --stl-ui-button-size: var(--sl-button-size);
 
   --stl-ui-color-accent-low: var(--sl-color-accent-low);

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@stainless-api/docs",
-  "version": "0.1.0-beta.1",
+  "version": "0.1.0-beta.10",
   "publishConfig": {
     "access": "public"
   },
   "description": "",
   "type": "module",
   "exports": {
+    ".": "./stl-docs/index.ts",
     "./plugin": "./plugin/index.ts",
     "./OverviewRoute": "./plugin/routes/Overview.astro",
     "./DocsRoute": "./plugin/routes/Docs.astro",
@@ -16,10 +17,10 @@
     "./replaceSidebarPlaceholderMiddleware": "./plugin/replaceSidebarPlaceholderMiddleware.ts",
     "./plugin/middleware": "./plugin/middlewareBuilder/stlStarlightMiddleware.ts",
     "./plugin/MiddlewareTypes": "./plugin/middlewareBuilder/stainlessMiddleware.d.ts",
-    "./stainless-docs": "./stl-docs/index.ts",
     "./Header": "./stl-docs/components/Header.astro",
     "./ThemeSelect": "./stl-docs/components/ThemeSelect.astro",
-    "./Sidebar": "./stl-docs/components/Sidebar.astro",
+    "./BaseSidebar": "./stl-docs/components/sidebars/BaseSidebar.astro",
+    "./SDKSelectSidebar": "./stl-docs/components/sidebars/SDKSelectSidebar.astro",
     "./ContentPanel": "./stl-docs/components/content-panel/ContentPanel.astro",
     "./tabsMiddleware": "./stl-docs/tabsMiddleware.ts",
     "./stainless-docs/mintlify-compat": "./stl-docs/components/mintlify-compat/index.ts",
@@ -54,8 +55,8 @@
     "shiki": "^3.9.2",
     "web-worker": "^1.5.0",
     "yaml": "^2.8.0",
-    "@stainless-api/docs-ui": "0.1.0-beta.1",
-    "@stainless-api/ui-primitives": "0.1.0-beta.1"
+    "@stainless-api/docs-ui": "0.1.0-beta.7",
+    "@stainless-api/ui-primitives": "0.1.0-beta.8"
   },
   "devDependencies": {
     "@markdoc/markdoc": "^0.5.2",

package/plugin/components/search/SearchAlgolia.astro

@@ -2,13 +2,6 @@
 import { Icon } from '@astrojs/starlight/components';
 import { DocsSearch } from './SearchIsland';
 import { SEARCH } from 'virtual:stl-starlight-virtual-module';
-
-import '@stainless-api/docs-ui/src/styles/resets.css';
-import '@stainless-api/docs-ui/src/styles/primitives.css';
-import '@stainless-api/docs-ui/src/styles/main.css';
-import '@stainless-api/docs-ui/src/styles/snippets.css';
-import '@stainless-api/docs-ui/src/styles/search.css';
-import '../../../components/variables.css';
 ---
 
 <site-search>

package/plugin/globalJs/navigation.ts

@@ -37,7 +37,6 @@ document.addEventListener(getPageLoadEvent(), () => {
 });
 
 document.addEventListener(getPageLoadEvent(), () => {
-  console.log('Initializing AI Dropdown');
   initDropdownButton({
     dropdownId: 'ai-dropdown-button',
     onSelect: onSelectAIOption,

package/plugin/helpers/getPageLoadEvent.ts

@@ -1,4 +1,4 @@
-// import { ENABLE_CLIENT_ROUTER } from 'virtual:stl-stl-starlight-virtual-module';
+// import { ENABLE_CLIENT_ROUTER } from 'virtual:stl-docs-virtual-module';
 
 export function getPageLoadEvent() {
   // if (ENABLE_CLIENT_ROUTER) {

package/plugin/index.ts

@@ -213,6 +213,7 @@ async function stlStarlightAstroIntegration(
                         EXPERIMENTAL_COLLAPSIBLE_SNIPPETS: pluginConfig.experimentalCollapsibleSnippets,
                         PROPERTY_SETTINGS: pluginConfig.propertySettings,
                         SEARCH: pluginConfig.search,
+                        INCLUDE_AI_DROPDOWN_OPTIONS: pluginConfig.includeAIDropdownOptions,
                       }),
                       vmMiddlewareExport,
                     ].join('\n');

package/plugin/loadPluginConfig.ts

@@ -117,6 +117,13 @@ export type StainlessStarlightUserConfig = {
    * Defaults to `false`.
    */
   experimentalCollapsibleSnippets?: boolean;
+
+  /**
+   * When set to `true`, a dropdown button will be included on all pages to allow users to
+   * view or send markdown to an LLM.
+   * Defaults to `false`.
+   */
+  includeAIDropdownOptions?: boolean;
 };
 
 export type ExternalSpecServerUserConfig = Omit<StainlessStarlightUserConfig, 'stainlessProject'> & {
@@ -190,6 +197,7 @@ function normalizeConfig(partial: SomeStainlessStarlightUserConfig, command: Ast
     search: {
       enableAISearch: partial.search?.enableAISearch ?? false,
     },
+    includeAIDropdownOptions: partial.includeAIDropdownOptions ?? false,
   };
 
   function getSpecRetrieverConfig(): SpecRetrieverConfig {

package/plugin/react/Routing.tsx

@@ -48,6 +48,7 @@ import {
   HIGHLIGHT_THEMES,
   BREADCRUMB_CONFIG,
   PROPERTY_SETTINGS,
+  INCLUDE_AI_DROPDOWN_OPTIONS,
 } from 'virtual:stl-starlight-virtual-module';
 import style from '@stainless-api/docs-ui/src/style';
 import { createHighlighter, type BundledLanguage, type BundledTheme, type HighlighterGeneric } from 'shiki';
@@ -332,7 +333,7 @@ export function RenderSpec({
                     basePath={BASE_PATH}
                     config={BREADCRUMB_CONFIG}
                   />
-                  <APIReferenceAIDropdown />
+                  {INCLUDE_AI_DROPDOWN_OPTIONS && <APIReferenceAIDropdown />}
                 </div>
                 <SDKMethod
                   method={resource.methods[parsed.method]}
@@ -348,7 +349,7 @@ export function RenderSpec({
                     basePath={BASE_PATH}
                     config={BREADCRUMB_CONFIG}
                   />
-                  <APIReferenceAIDropdown />
+                  {INCLUDE_AI_DROPDOWN_OPTIONS && <APIReferenceAIDropdown />}
                 </div>
                 <SDKOverview resource={resource} />
               </div>

package/plugin/replaceSidebarPlaceholderMiddleware.ts

@@ -15,6 +15,10 @@ export const onRequest = defineRouteMiddleware(async (context) => {
 
   const slug = `/${context.locals.starlightRoute.id}`; // same as .slug but not deprecated
 
+  context.locals.starlightRoute._stlStarlight = {
+    basePath: BASE_PATH,
+  };
+
   const apiReferencePlaceholderItems = getAPIReferencePlaceholderItems(context.locals.starlightRoute.sidebar);
 
   const spec = await cmsClient.getSpec();

package/stl-docs/components/APIReferenceAIDropdown.tsx

@@ -1,53 +1,30 @@
-import {
-  DropdownButton,
-  DropdownButtonDivider,
-  DropdownButtonItem,
-  DropdownButtonItemIcon,
-  DropdownButtonItemText,
-  DropdownButtonItemTextSubtle,
-  DropdownButtonMenu,
-  DropdownButtonPrimaryAction,
-  DropdownButtonPrimaryActionText,
-  DropdownButtonTrigger,
-} from '@stainless-api/ui-primitives';
+import { DropdownButton } from '@stainless-api/ui-primitives';
 import { CopyIcon } from 'lucide-react';
+import { ChatGPTIcon } from './icons/chat-gpt';
+import { ClaudeIcon } from './icons/claude';
+import { MarkdownIcon } from './icons/markdown';
 
 export function AIDropdownOptions() {
   return (
     <>
-      <DropdownButtonItem value="chat-gpt" isExternalLink>
-        <DropdownButtonItemIcon>
-          <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16" fill="none">
-            <path
-              d="M3.13924 10.6036L6.28658 8.84444L6.33924 8.69111L6.28658 8.60638H6.13266L5.60608 8.5741L3.8076 8.52568L2.2481 8.46113L0.737215 8.38043L0.356456 8.29973L0 7.83169L0.0364557 7.59766L0.356456 7.38382L0.814177 7.42416L1.82684 7.49276L3.34582 7.59766L4.4476 7.66222L6.08 7.83169H6.33924L6.3757 7.72678L6.28658 7.66222L6.21772 7.59766L4.64608 6.53649L2.94481 5.4148L2.05367 4.76922L1.57165 4.44239L1.32861 4.13574L1.22329 3.46595L1.66076 2.98581L2.2481 3.02615L2.39797 3.0665L2.99342 3.52244L4.26532 4.50292L5.92608 5.72145L6.16911 5.92319L6.26633 5.8546L6.27848 5.80618L6.16911 5.62461L5.26582 3.99856L4.30177 2.34426L3.87241 1.65833L3.75899 1.24678C3.71848 1.07731 3.69013 0.93609 3.69013 0.762591L4.18835 0.0887672L4.4638 0L5.1281 0.0887672L5.4076 0.330859L5.82076 1.27098L6.48911 2.75178L7.52608 4.76518L7.82987 5.36234L7.9919 5.91512L8.05266 6.08459H8.15797V5.98775L8.24304 4.85395L8.40101 3.46192L8.55494 1.67044L8.60759 1.16608L8.85873 0.560847L9.35696 0.234023L9.74582 0.419627L10.0658 0.875567L10.0213 1.17011L9.83089 2.40075L9.45823 4.32942L9.21519 5.62058H9.35696L9.51899 5.45918L10.1752 4.59168L11.277 3.21983L11.763 2.67512L12.3301 2.07392L12.6947 1.78745H13.3833L13.8896 2.53793L13.6628 3.31263L12.9539 4.20837L12.3666 4.96693L11.5241 6.09669L10.9975 7.0005L11.0461 7.07313L11.1716 7.06103L13.0754 6.65754L14.1043 6.47193L15.3316 6.26212L15.8866 6.52035L15.9473 6.78262L15.7286 7.31926L14.4162 7.64205L12.877 7.9487L10.5843 8.48937L10.5559 8.50954L10.5884 8.54989L11.6213 8.64673L12.0628 8.67094H13.1443L15.1575 8.82023L15.6841 9.16723L16 9.59089L15.9473 9.91368L15.1372 10.3252L14.0435 10.067L11.4916 9.46177L10.6167 9.24389H10.4952V9.31652L11.2243 10.0267L12.561 11.229L14.2339 12.7784L14.319 13.1618L14.1043 13.4644L13.8775 13.4321L12.4071 12.3306L11.84 11.8343L10.5559 10.757H10.4709V10.8699L10.7666 11.3017L12.3301 13.6419L12.4111 14.3601L12.2977 14.5941L11.8927 14.7354L11.4471 14.6547L10.5316 13.3756L9.58785 11.9352L8.82633 10.644L8.73316 10.6964L8.28354 15.5181L8.07291 15.7642L7.58684 15.9498L7.18177 15.6432L6.96709 15.1469L7.18177 14.1664L7.44101 12.8874L7.65165 11.8706L7.84203 10.6077L7.95544 10.1881L7.94734 10.1598L7.85418 10.1719L6.89823 11.4792L5.44405 13.4361L4.29367 14.6627L4.01823 14.7717L3.54025 14.5255L3.58481 14.0857L3.85215 13.6944L5.44405 11.6769L6.40405 10.4261L7.0238 9.70387L7.01975 9.59896H6.98329L2.75443 12.3346L2.00101 12.4314L1.67696 12.1288L1.71747 11.6325L1.87139 11.4711L3.14329 10.5996L3.13924 10.6036Z"
-              fill="#D97757"
-            />
-          </svg>
-        </DropdownButtonItemIcon>
-        <DropdownButtonItemText>
-          <DropdownButtonItemTextSubtle>Open in</DropdownButtonItemTextSubtle> Claude
-        </DropdownButtonItemText>
-      </DropdownButtonItem>
-      <DropdownButtonItem value="chat-gpt" isExternalLink>
-        <DropdownButtonItemIcon>
-          <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16" fill="none">
-            <g clip-path="url(#clip0_2771_126147)">
-              <path
-                d="M14.853 6.54857C15.216 5.45907 15.091 4.26557 14.5105 3.27457C13.6375 1.75457 11.8825 0.972574 10.1685 1.34057C9.40596 0.481574 8.31046 -0.00692579 7.16196 7.42116e-05C5.40996 -0.00392579 3.85546 1.12407 3.31646 2.79107C2.19096 3.02157 1.21946 3.72607 0.650955 4.72457C-0.228545 6.24057 -0.0280446 8.15157 1.14696 9.45157C0.783955 10.5411 0.908955 11.7346 1.48946 12.7256C2.36246 14.2456 4.11746 15.0276 5.83146 14.6596C6.59346 15.5186 7.68946 16.0071 8.83796 15.9996C10.591 16.0041 12.146 14.8751 12.685 13.2066C13.8105 12.9761 14.782 12.2716 15.3505 11.2731C16.229 9.75707 16.028 7.84757 14.8535 6.54757L14.853 6.54857ZM8.83896 14.9541C8.13746 14.9551 7.45796 14.7096 6.91946 14.2601C6.94396 14.2471 6.98646 14.2236 7.01396 14.2066L10.2 12.3666C10.363 12.2741 10.463 12.1006 10.462 11.9131V7.42157L11.8085 8.19907C11.823 8.20607 11.8325 8.22007 11.8345 8.23607V11.9556C11.8325 13.6096 10.493 14.9506 8.83896 14.9541ZM2.39696 12.2026C2.04546 11.5956 1.91896 10.8841 2.03946 10.1936C2.06296 10.2076 2.10446 10.2331 2.13396 10.2501L5.31996 12.0901C5.48146 12.1846 5.68146 12.1846 5.84346 12.0901L9.73296 9.84407V11.3991C9.73396 11.4151 9.72646 11.4306 9.71396 11.4406L6.49346 13.3001C5.05896 14.1261 3.22696 13.6351 2.39746 12.2026H2.39696ZM1.55846 5.24807C1.90846 4.64007 2.46096 4.17507 3.11896 3.93357C3.11896 3.96107 3.11746 4.00957 3.11746 4.04357V7.72407C3.11646 7.91107 3.21646 8.08457 3.37896 8.17707L7.26846 10.4226L5.92196 11.2001C5.90846 11.2091 5.89146 11.2106 5.87646 11.2041L2.65546 9.34307C1.22396 8.51407 0.732955 6.68257 1.55796 5.24857L1.55846 5.24807ZM12.6215 7.82257L8.73196 5.57657L10.0785 4.79957C10.092 4.79057 10.109 4.78907 10.124 4.79557L13.345 6.65507C14.779 7.48357 15.2705 9.31807 14.442 10.7521C14.0915 11.3591 13.5395 11.8241 12.882 12.0661V8.27557C12.8835 8.08857 12.784 7.91557 12.622 7.82257H12.6215ZM13.9615 5.80557C13.938 5.79107 13.8965 5.76607 13.867 5.74907L10.681 3.90907C10.5195 3.81457 10.3195 3.81457 10.1575 3.90907L6.26796 6.15507V4.60007C6.26696 4.58407 6.27446 4.56857 6.28696 4.55857L9.50746 2.70057C10.942 1.87307 12.776 2.36557 13.603 3.80057C13.9525 4.40657 14.079 5.11607 13.9605 5.80557H13.9615ZM5.53596 8.57707L4.18896 7.79957C4.17446 7.79257 4.16496 7.77857 4.16296 7.76257V4.04307C4.16396 2.38707 5.50746 1.04507 7.16346 1.04607C7.86396 1.04607 8.54196 1.29207 9.08046 1.74007C9.05596 1.75307 9.01396 1.77657 8.98596 1.79357L5.79996 3.63357C5.63696 3.72607 5.53696 3.89907 5.53796 4.08657L5.53596 8.57607V8.57707ZM6.26746 7.00007L7.99996 5.99957L9.73246 6.99957V9.00007L7.99996 10.0001L6.26746 9.00007V7.00007Z"
-                fill="#262626"
-              />
-            </g>
-            <defs>
-              <clipPath id="clip0_2771_126147">
-                <rect width="16" height="16" fill="white" />
-              </clipPath>
-            </defs>
-          </svg>
-        </DropdownButtonItemIcon>
-        <DropdownButtonItemText>
-          <DropdownButtonItemTextSubtle>Open in</DropdownButtonItemTextSubtle> ChatGPT
-        </DropdownButtonItemText>
-      </DropdownButtonItem>
+      <DropdownButton.MenuItem value="claude" isExternalLink>
+        <DropdownButton.MenuItemIcon>
+          <ClaudeIcon />
+        </DropdownButton.MenuItemIcon>
+        <DropdownButton.MenuItemText subtle>
+          Open in
+          <strong> Claude</strong>
+        </DropdownButton.MenuItemText>
+      </DropdownButton.MenuItem>
+      <DropdownButton.MenuItem value="chat-gpt" isExternalLink>
+        <DropdownButton.MenuItemIcon>
+          <ChatGPTIcon />
+        </DropdownButton.MenuItemIcon>
+        <DropdownButton.MenuItemText subtle>
+          Open in
+          <strong> ChatGPT</strong>
+        </DropdownButton.MenuItemText>
+      </DropdownButton.MenuItem>
     </>
   );
 }
@@ -55,32 +32,27 @@ export function AIDropdownOptions() {
 export function APIReferenceAIDropdown() {
   return (
     <DropdownButton id="ai-dropdown-button">
-      <DropdownButtonPrimaryAction>
+      <DropdownButton.PrimaryAction>
         <CopyIcon size={16} />
-        <DropdownButtonPrimaryActionText>Copy Markdown</DropdownButtonPrimaryActionText>
-      </DropdownButtonPrimaryAction>
-      <DropdownButtonTrigger />
-      <DropdownButtonMenu>
+        <DropdownButton.PrimaryActionText>Copy Markdown</DropdownButton.PrimaryActionText>
+      </DropdownButton.PrimaryAction>
+      <DropdownButton.Trigger />
+      <DropdownButton.Menu>
         <AIDropdownOptions />
-        <DropdownButtonDivider />
-        <DropdownButtonItem value="copy-as-markdown" isExternalLink>
-          <DropdownButtonItemIcon>
+        <hr />
+        <DropdownButton.MenuItem value="copy-as-markdown" isExternalLink>
+          <DropdownButton.MenuItemIcon>
             <CopyIcon size={16} />
-          </DropdownButtonItemIcon>
-          <DropdownButtonItemText>Copy Markdown</DropdownButtonItemText>
-        </DropdownButtonItem>
-        <DropdownButtonItem value="view-as-markdown" isExternalLink>
-          <DropdownButtonItemIcon>
-            <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16" fill="none">
-              <path
-                d="M14.8447 3.33301C15.151 3.33301 15.4455 3.45527 15.6621 3.67188C15.8785 3.88844 16 4.18213 16 4.48828V12.0254C15.9997 12.3315 15.8777 12.6254 15.6611 12.8418C15.4446 13.0581 15.1508 13.1797 14.8447 13.1797H1.15527C0.848967 13.1797 0.55449 13.0584 0.337891 12.8418C0.121288 12.6252 0 12.3307 0 12.0244V4.48828C1.09706e-05 4.18213 0.121501 3.88844 0.337891 3.67188C0.554493 3.45527 0.848951 3.33301 1.15527 3.33301H14.8447ZM1.15527 4.10254C1.10457 4.10245 1.0537 4.11247 1.00684 4.13184C0.960202 4.15116 0.917554 4.17917 0.881836 4.21484C0.845984 4.2507 0.817213 4.29396 0.797852 4.34082C0.778601 4.38756 0.769447 4.43773 0.769531 4.48828V12.0254C0.76962 12.0759 0.779409 12.1262 0.798828 12.1729C0.81827 12.2196 0.846978 12.2621 0.882812 12.2979C0.918602 12.3335 0.961134 12.3616 1.00781 12.3809C1.05454 12.4001 1.10474 12.4102 1.15527 12.4102H14.8447C14.9467 12.4101 15.045 12.3699 15.1172 12.2979C15.1893 12.2258 15.2293 12.1274 15.2295 12.0254V4.48828C15.2296 4.43774 15.2204 4.38755 15.2012 4.34082C15.1819 4.29403 15.1529 4.25166 15.1172 4.21582C15.0814 4.17999 15.0389 4.15126 14.9922 4.13184C14.9455 4.11249 14.8952 4.10258 14.8447 4.10254H1.15527ZM5.38477 7.56348L6.92285 5.64062H8.46094V10.8721H6.92285V7.87109L5.38477 9.79492L3.8457 7.87109V10.8711H2.30762V5.63965H3.8457L5.38477 7.56348ZM12.6924 8.33301H14.2305L11.9229 10.8711L9.61523 8.33301H11.1533V5.64062H12.6924V8.33301Z"
-                fill="#262626"
-              />
-            </svg>
-          </DropdownButtonItemIcon>
-          <DropdownButtonItemText>View as Markdown</DropdownButtonItemText>
-        </DropdownButtonItem>
-      </DropdownButtonMenu>
+          </DropdownButton.MenuItemIcon>
+          <DropdownButton.MenuItemText>Copy Markdown</DropdownButton.MenuItemText>
+        </DropdownButton.MenuItem>
+        <DropdownButton.MenuItem value="view-as-markdown" isExternalLink>
+          <DropdownButton.MenuItemIcon>
+            <MarkdownIcon />
+          </DropdownButton.MenuItemIcon>
+          <DropdownButton.MenuItemText>View as Markdown</DropdownButton.MenuItemText>
+        </DropdownButton.MenuItem>
+      </DropdownButton.Menu>
     </DropdownButton>
   );
 }

package/stl-docs/components/Header.astro

@@ -1,7 +1,7 @@
 ---
 import config from 'virtual:starlight/user-config';
 
-import { HEADER_LAYOUT } from 'virtual:stl-stl-starlight-virtual-module';
+import { HEADER_LAYOUT } from 'virtual:stl-docs-virtual-module';
 import DefaultHeader from './headers/DefaultHeader.astro';
 import StackedHeader from './headers/StackedHeader.astro';
 

package/stl-docs/components/ThemeSelect.astro

@@ -1,10 +1,5 @@
 ---
-import {
-  Dropdown,
-  DropdownTrigger,
-  DropdownMenu,
-  DropdownItem,
-} from '@stainless-api/docs-ui/src/components/dropdown';
+import { Dropdown, DropdownTrigger, DropdownMenu, DropdownItem } from '@stainless-api/docs-ui/src/components/dropdown';
 
 const options = [
   {

package/stl-docs/components/content-panel/ContentPanel.astro

@@ -1,6 +1,7 @@
 ---
 import { ContentBreadcrumbs } from './ContentBreadcrumbs';
 import { ProseAIDropdown } from './ProseAIDropdown';
+import { INCLUDE_AI_DROPDOWN_OPTIONS } from 'virtual:stl-docs-virtual-module';
 const currentPath = Astro.url.pathname;
 ---
 
@@ -8,7 +9,11 @@ const currentPath = Astro.url.pathname;
   <div class="sl-container stl-ui-prose">
     <div class="stl-ui-not-prose stl-page-nav-container stl-prose-page-nav-container">
       <ContentBreadcrumbs currentPath={currentPath} sidebarEntry={Astro.locals.starlightRoute.sidebar} />
-      <ProseAIDropdown currentPath={currentPath} sidebarEntry={Astro.locals.starlightRoute.sidebar} />
+      {
+        INCLUDE_AI_DROPDOWN_OPTIONS && (
+          <ProseAIDropdown currentPath={currentPath} sidebarEntry={Astro.locals.starlightRoute.sidebar} />
+        )
+      }
     </div>
     <slot />
   </div>
@@ -26,10 +31,6 @@ const currentPath = Astro.url.pathname;
       max-width: var(--sl-content-width);
     }
 
-    .sl-container > :global(* + *) {
-      margin-top: 1.5rem;
-    }
-
     @media (min-width: 72rem) {
       .sl-container {
         margin-inline: var(--sl-content-margin-inline, auto);
@@ -39,7 +40,7 @@ const currentPath = Astro.url.pathname;
   /* Overrides */
   @layer stainless {
     .content-panel {
-      padding: 0 var(--sl-content-pad-x);
+      padding: 0 0.5rem 0 var(--sl-content-pad-x);
     }
 
     .stl-prose-page-nav-container {
@@ -60,7 +61,6 @@ const currentPath = Astro.url.pathname;
   import { onSelectAIOption } from '../../../plugin/globalJs/ai-dropdown.ts';
 
   document.addEventListener(getPageLoadEvent(), () => {
-    console.log('Initializing AI Dropdown');
     initDropdownButton({
       dropdownId: 'prose-ai-dropdown-button',
       onSelect: (option: string) => onSelectAIOption(option, false),

package/stl-docs/components/content-panel/ProseAIDropdown.tsx

@@ -1,11 +1,7 @@
-import {
-  DropdownButton,
-  DropdownButtonMenu,
-  DropdownButtonPrimaryAction,
-  DropdownButtonTrigger,
-} from '@stainless-api/ui-primitives';
+import { DropdownButton } from '@stainless-api/ui-primitives';
 import { AIDropdownOptions } from '../APIReferenceAIDropdown';
 import type { StarlightRouteData } from '@astrojs/starlight/route-data';
+import { ClaudeIcon } from '../icons/claude';
 
 const sidebarHasEntry = (sidebarEntry: StarlightRouteData['sidebar'], currentPath?: string) => {
   if (!currentPath) return false;
@@ -46,19 +42,14 @@ export function ProseAIDropdown({
 
   return (
     <DropdownButton id="prose-ai-dropdown-button">
-      <DropdownButtonPrimaryAction>
-        <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16" fill="none">
-          <path
-            d="M3.13924 10.6036L6.28658 8.84444L6.33924 8.69111L6.28658 8.60638H6.13266L5.60608 8.5741L3.8076 8.52568L2.2481 8.46113L0.737215 8.38043L0.356456 8.29973L0 7.83169L0.0364557 7.59766L0.356456 7.38382L0.814177 7.42416L1.82684 7.49276L3.34582 7.59766L4.4476 7.66222L6.08 7.83169H6.33924L6.3757 7.72678L6.28658 7.66222L6.21772 7.59766L4.64608 6.53649L2.94481 5.4148L2.05367 4.76922L1.57165 4.44239L1.32861 4.13574L1.22329 3.46595L1.66076 2.98581L2.2481 3.02615L2.39797 3.0665L2.99342 3.52244L4.26532 4.50292L5.92608 5.72145L6.16911 5.92319L6.26633 5.8546L6.27848 5.80618L6.16911 5.62461L5.26582 3.99856L4.30177 2.34426L3.87241 1.65833L3.75899 1.24678C3.71848 1.07731 3.69013 0.93609 3.69013 0.762591L4.18835 0.0887672L4.4638 0L5.1281 0.0887672L5.4076 0.330859L5.82076 1.27098L6.48911 2.75178L7.52608 4.76518L7.82987 5.36234L7.9919 5.91512L8.05266 6.08459H8.15797V5.98775L8.24304 4.85395L8.40101 3.46192L8.55494 1.67044L8.60759 1.16608L8.85873 0.560847L9.35696 0.234023L9.74582 0.419627L10.0658 0.875567L10.0213 1.17011L9.83089 2.40075L9.45823 4.32942L9.21519 5.62058H9.35696L9.51899 5.45918L10.1752 4.59168L11.277 3.21983L11.763 2.67512L12.3301 2.07392L12.6947 1.78745H13.3833L13.8896 2.53793L13.6628 3.31263L12.9539 4.20837L12.3666 4.96693L11.5241 6.09669L10.9975 7.0005L11.0461 7.07313L11.1716 7.06103L13.0754 6.65754L14.1043 6.47193L15.3316 6.26212L15.8866 6.52035L15.9473 6.78262L15.7286 7.31926L14.4162 7.64205L12.877 7.9487L10.5843 8.48937L10.5559 8.50954L10.5884 8.54989L11.6213 8.64673L12.0628 8.67094H13.1443L15.1575 8.82023L15.6841 9.16723L16 9.59089L15.9473 9.91368L15.1372 10.3252L14.0435 10.067L11.4916 9.46177L10.6167 9.24389H10.4952V9.31652L11.2243 10.0267L12.561 11.229L14.2339 12.7784L14.319 13.1618L14.1043 13.4644L13.8775 13.4321L12.4071 12.3306L11.84 11.8343L10.5559 10.757H10.4709V10.8699L10.7666 11.3017L12.3301 13.6419L12.4111 14.3601L12.2977 14.5941L11.8927 14.7354L11.4471 14.6547L10.5316 13.3756L9.58785 11.9352L8.82633 10.644L8.73316 10.6964L8.28354 15.5181L8.07291 15.7642L7.58684 15.9498L7.18177 15.6432L6.96709 15.1469L7.18177 14.1664L7.44101 12.8874L7.65165 11.8706L7.84203 10.6077L7.95544 10.1881L7.94734 10.1598L7.85418 10.1719L6.89823 11.4792L5.44405 13.4361L4.29367 14.6627L4.01823 14.7717L3.54025 14.5255L3.58481 14.0857L3.85215 13.6944L5.44405 11.6769L6.40405 10.4261L7.0238 9.70387L7.01975 9.59896H6.98329L2.75443 12.3346L2.00101 12.4314L1.67696 12.1288L1.71747 11.6325L1.87139 11.4711L3.14329 10.5996L3.13924 10.6036Z"
-            fill="#D97757"
-          />
-        </svg>{' '}
+      <DropdownButton.PrimaryAction>
+        <ClaudeIcon />
         Open in Claude
-      </DropdownButtonPrimaryAction>
-      <DropdownButtonTrigger />
-      <DropdownButtonMenu>
+      </DropdownButton.PrimaryAction>
+      <DropdownButton.Trigger />
+      <DropdownButton.Menu>
         <AIDropdownOptions />
-      </DropdownButtonMenu>
+      </DropdownButton.Menu>
     </DropdownButton>
   );
 }

package/stl-docs/components/headers/DefaultHeader.astro

@@ -4,7 +4,7 @@ import Search from 'virtual:starlight/components/Search';
 import SiteTitle from 'virtual:starlight/components/SiteTitle';
 import HeaderLinks from './HeaderLinks.astro';
 import NavLinks from '../nav-tabs/NavTabs.astro';
-import { TABS } from 'virtual:stl-stl-starlight-virtual-module';
+import { TABS } from 'virtual:stl-docs-virtual-module';
 import ThemeSelect from 'virtual:starlight/components/ThemeSelect';
 import SplashMobileMenuToggle from './SplashMobileMenuToggle.astro';
 

package/stl-docs/components/headers/HeaderLinks.astro

@@ -1,5 +1,5 @@
 ---
-import { HEADER_LINKS } from 'virtual:stl-stl-starlight-virtual-module';
+import { HEADER_LINKS } from 'virtual:stl-docs-virtual-module';
 import { Button } from '@stainless-api/ui-primitives';
 ---
 

package/stl-docs/components/headers/StackedHeader.astro

@@ -3,7 +3,7 @@ import LanguageSelect from "virtual:starlight/components/LanguageSelect";
 import Search from "virtual:starlight/components/Search";
 import SiteTitle from "virtual:starlight/components/SiteTitle";
 import HeaderLinks from './HeaderLinks.astro';
-import { TABS } from "virtual:stl-stl-starlight-virtual-module";
+import { TABS } from "virtual:stl-docs-virtual-module";
 import ThemeSelect from "virtual:starlight/components/ThemeSelect";
 import SecondaryNavTabs from "../nav-tabs/SecondaryNavTabs.astro";
 import SplashMobileMenuToggle from "./SplashMobileMenuToggle.astro";

package/stl-docs/components/icons/chat-gpt.tsx

@@ -0,0 +1,17 @@
+export function ChatGPTIcon() {
+  return (
+    <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16" fill="none">
+      <g clip-path="url(#clip0_2771_126147)">
+        <path
+          d="M14.853 6.54857C15.216 5.45907 15.091 4.26557 14.5105 3.27457C13.6375 1.75457 11.8825 0.972574 10.1685 1.34057C9.40596 0.481574 8.31046 -0.00692579 7.16196 7.42116e-05C5.40996 -0.00392579 3.85546 1.12407 3.31646 2.79107C2.19096 3.02157 1.21946 3.72607 0.650955 4.72457C-0.228545 6.24057 -0.0280446 8.15157 1.14696 9.45157C0.783955 10.5411 0.908955 11.7346 1.48946 12.7256C2.36246 14.2456 4.11746 15.0276 5.83146 14.6596C6.59346 15.5186 7.68946 16.0071 8.83796 15.9996C10.591 16.0041 12.146 14.8751 12.685 13.2066C13.8105 12.9761 14.782 12.2716 15.3505 11.2731C16.229 9.75707 16.028 7.84757 14.8535 6.54757L14.853 6.54857ZM8.83896 14.9541C8.13746 14.9551 7.45796 14.7096 6.91946 14.2601C6.94396 14.2471 6.98646 14.2236 7.01396 14.2066L10.2 12.3666C10.363 12.2741 10.463 12.1006 10.462 11.9131V7.42157L11.8085 8.19907C11.823 8.20607 11.8325 8.22007 11.8345 8.23607V11.9556C11.8325 13.6096 10.493 14.9506 8.83896 14.9541ZM2.39696 12.2026C2.04546 11.5956 1.91896 10.8841 2.03946 10.1936C2.06296 10.2076 2.10446 10.2331 2.13396 10.2501L5.31996 12.0901C5.48146 12.1846 5.68146 12.1846 5.84346 12.0901L9.73296 9.84407V11.3991C9.73396 11.4151 9.72646 11.4306 9.71396 11.4406L6.49346 13.3001C5.05896 14.1261 3.22696 13.6351 2.39746 12.2026H2.39696ZM1.55846 5.24807C1.90846 4.64007 2.46096 4.17507 3.11896 3.93357C3.11896 3.96107 3.11746 4.00957 3.11746 4.04357V7.72407C3.11646 7.91107 3.21646 8.08457 3.37896 8.17707L7.26846 10.4226L5.92196 11.2001C5.90846 11.2091 5.89146 11.2106 5.87646 11.2041L2.65546 9.34307C1.22396 8.51407 0.732955 6.68257 1.55796 5.24857L1.55846 5.24807ZM12.6215 7.82257L8.73196 5.57657L10.0785 4.79957C10.092 4.79057 10.109 4.78907 10.124 4.79557L13.345 6.65507C14.779 7.48357 15.2705 9.31807 14.442 10.7521C14.0915 11.3591 13.5395 11.8241 12.882 12.0661V8.27557C12.8835 8.08857 12.784 7.91557 12.622 7.82257H12.6215ZM13.9615 5.80557C13.938 5.79107 13.8965 5.76607 13.867 5.74907L10.681 3.90907C10.5195 3.81457 10.3195 3.81457 10.1575 3.90907L6.26796 6.15507V4.60007C6.26696 4.58407 6.27446 4.56857 6.28696 4.55857L9.50746 2.70057C10.942 1.87307 12.776 2.36557 13.603 3.80057C13.9525 4.40657 14.079 5.11607 13.9605 5.80557H13.9615ZM5.53596 8.57707L4.18896 7.79957C4.17446 7.79257 4.16496 7.77857 4.16296 7.76257V4.04307C4.16396 2.38707 5.50746 1.04507 7.16346 1.04607C7.86396 1.04607 8.54196 1.29207 9.08046 1.74007C9.05596 1.75307 9.01396 1.77657 8.98596 1.79357L5.79996 3.63357C5.63696 3.72607 5.53696 3.89907 5.53796 4.08657L5.53596 8.57607V8.57707ZM6.26746 7.00007L7.99996 5.99957L9.73246 6.99957V9.00007L7.99996 10.0001L6.26746 9.00007V7.00007Z"
+          fill="var(--stl-ui-foreground)"
+        />
+      </g>
+      <defs>
+        <clipPath id="clip0_2771_126147">
+          <rect width="16" height="16" fill="white" />
+        </clipPath>
+      </defs>
+    </svg>
+  );
+}

package/stl-docs/components/icons/claude.tsx

@@ -0,0 +1,10 @@
+export function ClaudeIcon() {
+  return (
+    <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16" fill="none">
+      <path
+        d="M3.13924 10.6036L6.28658 8.84444L6.33924 8.69111L6.28658 8.60638H6.13266L5.60608 8.5741L3.8076 8.52568L2.2481 8.46113L0.737215 8.38043L0.356456 8.29973L0 7.83169L0.0364557 7.59766L0.356456 7.38382L0.814177 7.42416L1.82684 7.49276L3.34582 7.59766L4.4476 7.66222L6.08 7.83169H6.33924L6.3757 7.72678L6.28658 7.66222L6.21772 7.59766L4.64608 6.53649L2.94481 5.4148L2.05367 4.76922L1.57165 4.44239L1.32861 4.13574L1.22329 3.46595L1.66076 2.98581L2.2481 3.02615L2.39797 3.0665L2.99342 3.52244L4.26532 4.50292L5.92608 5.72145L6.16911 5.92319L6.26633 5.8546L6.27848 5.80618L6.16911 5.62461L5.26582 3.99856L4.30177 2.34426L3.87241 1.65833L3.75899 1.24678C3.71848 1.07731 3.69013 0.93609 3.69013 0.762591L4.18835 0.0887672L4.4638 0L5.1281 0.0887672L5.4076 0.330859L5.82076 1.27098L6.48911 2.75178L7.52608 4.76518L7.82987 5.36234L7.9919 5.91512L8.05266 6.08459H8.15797V5.98775L8.24304 4.85395L8.40101 3.46192L8.55494 1.67044L8.60759 1.16608L8.85873 0.560847L9.35696 0.234023L9.74582 0.419627L10.0658 0.875567L10.0213 1.17011L9.83089 2.40075L9.45823 4.32942L9.21519 5.62058H9.35696L9.51899 5.45918L10.1752 4.59168L11.277 3.21983L11.763 2.67512L12.3301 2.07392L12.6947 1.78745H13.3833L13.8896 2.53793L13.6628 3.31263L12.9539 4.20837L12.3666 4.96693L11.5241 6.09669L10.9975 7.0005L11.0461 7.07313L11.1716 7.06103L13.0754 6.65754L14.1043 6.47193L15.3316 6.26212L15.8866 6.52035L15.9473 6.78262L15.7286 7.31926L14.4162 7.64205L12.877 7.9487L10.5843 8.48937L10.5559 8.50954L10.5884 8.54989L11.6213 8.64673L12.0628 8.67094H13.1443L15.1575 8.82023L15.6841 9.16723L16 9.59089L15.9473 9.91368L15.1372 10.3252L14.0435 10.067L11.4916 9.46177L10.6167 9.24389H10.4952V9.31652L11.2243 10.0267L12.561 11.229L14.2339 12.7784L14.319 13.1618L14.1043 13.4644L13.8775 13.4321L12.4071 12.3306L11.84 11.8343L10.5559 10.757H10.4709V10.8699L10.7666 11.3017L12.3301 13.6419L12.4111 14.3601L12.2977 14.5941L11.8927 14.7354L11.4471 14.6547L10.5316 13.3756L9.58785 11.9352L8.82633 10.644L8.73316 10.6964L8.28354 15.5181L8.07291 15.7642L7.58684 15.9498L7.18177 15.6432L6.96709 15.1469L7.18177 14.1664L7.44101 12.8874L7.65165 11.8706L7.84203 10.6077L7.95544 10.1881L7.94734 10.1598L7.85418 10.1719L6.89823 11.4792L5.44405 13.4361L4.29367 14.6627L4.01823 14.7717L3.54025 14.5255L3.58481 14.0857L3.85215 13.6944L5.44405 11.6769L6.40405 10.4261L7.0238 9.70387L7.01975 9.59896H6.98329L2.75443 12.3346L2.00101 12.4314L1.67696 12.1288L1.71747 11.6325L1.87139 11.4711L3.14329 10.5996L3.13924 10.6036Z"
+        fill="#D97757"
+      />
+    </svg>
+  );
+}

package/stl-docs/components/icons/markdown.tsx

@@ -0,0 +1,10 @@
+export function MarkdownIcon() {
+  return (
+    <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16" fill="none">
+      <path
+        d="M14.8447 3.33301C15.151 3.33301 15.4455 3.45527 15.6621 3.67188C15.8785 3.88844 16 4.18213 16 4.48828V12.0254C15.9997 12.3315 15.8777 12.6254 15.6611 12.8418C15.4446 13.0581 15.1508 13.1797 14.8447 13.1797H1.15527C0.848967 13.1797 0.55449 13.0584 0.337891 12.8418C0.121288 12.6252 0 12.3307 0 12.0244V4.48828C1.09706e-05 4.18213 0.121501 3.88844 0.337891 3.67188C0.554493 3.45527 0.848951 3.33301 1.15527 3.33301H14.8447ZM1.15527 4.10254C1.10457 4.10245 1.0537 4.11247 1.00684 4.13184C0.960202 4.15116 0.917554 4.17917 0.881836 4.21484C0.845984 4.2507 0.817213 4.29396 0.797852 4.34082C0.778601 4.38756 0.769447 4.43773 0.769531 4.48828V12.0254C0.76962 12.0759 0.779409 12.1262 0.798828 12.1729C0.81827 12.2196 0.846978 12.2621 0.882812 12.2979C0.918602 12.3335 0.961134 12.3616 1.00781 12.3809C1.05454 12.4001 1.10474 12.4102 1.15527 12.4102H14.8447C14.9467 12.4101 15.045 12.3699 15.1172 12.2979C15.1893 12.2258 15.2293 12.1274 15.2295 12.0254V4.48828C15.2296 4.43774 15.2204 4.38755 15.2012 4.34082C15.1819 4.29403 15.1529 4.25166 15.1172 4.21582C15.0814 4.17999 15.0389 4.15126 14.9922 4.13184C14.9455 4.11249 14.8952 4.10258 14.8447 4.10254H1.15527ZM5.38477 7.56348L6.92285 5.64062H8.46094V10.8721H6.92285V7.87109L5.38477 9.79492L3.8457 7.87109V10.8711H2.30762V5.63965H3.8457L5.38477 7.56348ZM12.6924 8.33301H14.2305L11.9229 10.8711L9.61523 8.33301H11.1533V5.64062H12.6924V8.33301Z"
+        fill="#262626"
+      />
+    </svg>
+  );
+}

package/stl-docs/components/mintlify-compat/Accordion.astro

@@ -1,46 +1,13 @@
 ---
 export interface Props {
   title: string;
+  children: astroHTML.JSX.Children;
 }
 
 const { title } = Astro.props;
 ---
 
-<details class="stl-ui-mintlify-compat-accordion" role="button" data-stl-ui-element>
-  <summary class="stl-ui-mintlify-compat-accordion-title">{title}</summary>
-  <div class="stl-ui-mintlify-compat-accordion-content" role="contentinfo">
-    <slot />
-  </div>
+<details>
+  <summary>{title}</summary>
+  <slot />
 </details>
-
-<style>
-  @layer stl-ui-mintlify-compat {
-    .stl-ui-mintlify-compat-accordion {
-      border-inline-start: none;
-      padding-inline-start: 0;
-      border-radius: 12px;
-      border: 1px solid var(--sl-color-hairline);
-      overflow: hidden;
-
-      summary {
-        padding: 16px;
-        margin-inline-start: 0;
-        overflow: hidden;
-
-        &:hover {
-          background-color: var(--sl-color-hairline);
-        }
-      }
-
-      .stl-ui-mintlify-compat-accordion-title {
-        display: flex;
-        align-items: center;
-        gap: 8px;
-      }
-
-      .stl-ui-mintlify-compat-accordion-content {
-        padding: 16px;
-      }
-    }
-  }
-</style>

package/stl-docs/components/mintlify-compat/AccordionGroup.astro

@@ -1,25 +1,11 @@
-<div class="stl-ui-mintlify-compat-accordion-group">
-  <slot />
-</div>
-
-<style>
-  @layer stl-ui-mintlify-compat {
-    .stl-ui-mintlify-compat-accordion-group {
-      border-radius: 12px;
-      border: 1px solid var(--sl-color-hairline);
-      overflow: hidden;
-      padding-inline-start: -5rem;
+---
+import { DetailsGroup } from '@stainless-api/ui-primitives';
 
-      .stl-ui-mintlify-compat-accordion {
-        margin: 0;
-        border-inline-start: none;
-        border: none;
-        border-radius: 0;
+export interface Props {
+  children: astroHTML.JSX.Children;
+}
+---
 
-        &:not(:last-child) {
-          border-bottom: 1px solid var(--sl-color-hairline);
-        }
-      }
-    }
-  }
-</style>
+<DetailsGroup>
+  <slot />
+</DetailsGroup>

package/stl-docs/components/mintlify-compat/callouts/Callout.astro

@@ -1,7 +1,14 @@
 ---
-import { Aside } from '@astrojs/starlight/components';
+import { Callout as StainlessCallout, type CalloutVariant } from '@stainless-api/ui-primitives';
+
+export interface Props {
+  variant?: CalloutVariant;
+  children: astroHTML.JSX.Children;
+}
+
+const { variant } = Astro.props;
 ---
 
-<Aside>
+<StainlessCallout variant={variant}>
   <slot />
-</Aside>
+</StainlessCallout>

package/stl-docs/components/mintlify-compat/callouts/Check.astro

@@ -1,7 +1,11 @@
 ---
-import { Aside } from '@astrojs/starlight/components';
+import { Callout } from '@stainless-api/ui-primitives';
+
+export interface Props {
+  children: astroHTML.JSX.Children;
+}
 ---
 
-<Aside>
+<Callout variant="success">
   <slot />
-</Aside>
+</Callout>

package/stl-docs/components/mintlify-compat/callouts/Danger.astro

@@ -1,7 +1,11 @@
 ---
-import { Aside } from '@astrojs/starlight/components';
+import { Callout } from '@stainless-api/ui-primitives';
+
+export interface Props {
+  children: astroHTML.JSX.Children;
+}
 ---
 
-<Aside type="danger">
+<Callout variant="danger">
   <slot />
-</Aside>
+</Callout>

package/stl-docs/components/mintlify-compat/callouts/Info.astro

@@ -1,7 +1,11 @@
 ---
-import { Aside } from '@astrojs/starlight/components';
+import { Callout } from '@stainless-api/ui-primitives';
+
+export interface Props {
+  children: astroHTML.JSX.Children;
+}
 ---
 
-<Aside>
+<Callout variant="info">
   <slot />
-</Aside>
+</Callout>

package/stl-docs/components/mintlify-compat/callouts/Note.astro

@@ -1,7 +1,11 @@
 ---
-import { Aside } from '@astrojs/starlight/components';
+import { Callout } from '@stainless-api/ui-primitives';
+
+export interface Props {
+  children: astroHTML.JSX.Children;
+}
 ---
 
-<Aside>
+<Callout variant="note">
   <slot />
-</Aside>
+</Callout>

package/stl-docs/components/mintlify-compat/callouts/Tip.astro

@@ -1,7 +1,11 @@
 ---
-import { Aside } from '@astrojs/starlight/components';
+import { Callout } from '@stainless-api/ui-primitives';
+
+export interface Props {
+  children: astroHTML.JSX.Children;
+}
 ---
 
-<Aside type="tip">
+<Callout variant="tip">
   <slot />
-</Aside>
+</Callout>

package/stl-docs/components/mintlify-compat/callouts/Warning.astro

@@ -1,7 +1,11 @@
 ---
-import { Aside } from '@astrojs/starlight/components';
+import { Callout } from '@stainless-api/ui-primitives';
+
+export interface Props {
+  children: astroHTML.JSX.Children;
+}
 ---
 
-<Aside type="caution">
+<Callout variant="warning">
   <slot />
-</Aside>
+</Callout>

package/stl-docs/components/nav-tabs/NavDropdown.astro

@@ -1,10 +1,5 @@
 ---
-import {
-  Dropdown,
-  DropdownTrigger,
-  DropdownMenu,
-  DropdownItem,
-} from '@stainless-api/docs-ui/src/components/dropdown';
+import { Dropdown, DropdownTrigger, DropdownMenu, DropdownItem } from '@stainless-api/docs-ui/src/components/dropdown';
 import { Icon } from '@astrojs/starlight/components';
 import { buildNavLinks } from './buildNavLinks';
 

package/stl-docs/components/nav-tabs/buildNavLinks.ts

@@ -1,9 +1,9 @@
 import type { StarlightRouteData } from '@astrojs/starlight/route-data';
-import { TABS } from 'virtual:stl-stl-starlight-virtual-module';
+import { TABS } from 'virtual:stl-docs-virtual-module';
 
 export function buildNavLinks(starlightRoute: StarlightRouteData) {
-  // TODO: specify the type of Astro.locals.starlightRoute._stlStarlight
-  const activeTabIndex = starlightRoute._stlStarlight?.activeTabIndex;
+  // TODO: specify the type of Astro.locals.starlightRoute._stlDocs
+  const activeTabIndex = starlightRoute._stlDocs?.activeTabIndex;
 
   const navLinks = TABS.map((item, index) => ({
     ...item,

package/stl-docs/components/{Sidebar.astro → sidebars/BaseSidebar.astro}

@@ -1,11 +1,10 @@
 ---
 import Default from '@astrojs/starlight/components/Sidebar.astro';
-import SDKSelect from '../../plugin/components/SDKSelect.astro';
-import HeaderLinks from './headers/HeaderLinks.astro';
+import HeaderLinks from '../headers/HeaderLinks.astro';
 ---
 
 <div class="stl-sidebar-header-links">
   <HeaderLinks />
 </div>
-<SDKSelect />
+<slot name="sdk-select" />
 <Default><slot /></Default>

package/stl-docs/components/sidebars/SDKSelectSidebar.astro

@@ -0,0 +1,8 @@
+---
+import BaseSidebar from './BaseSidebar.astro';
+import SDKSelect from '../../../plugin/components/SDKSelect.astro';
+---
+
+<BaseSidebar>
+  <SDKSelect slot="sdk-select" />
+</BaseSidebar>

package/stl-docs/index.ts

@@ -40,14 +40,21 @@ function stainlessDocsStarlightIntegration(config: NormalizedStainlessDocsConfig
   }
 
   type ComponentOverrides = StarlightConfigDefined['components'];
+  const plugins = [...config.starlightCompat.plugins];
+
   const componentOverrides: ComponentOverrides = {
-    Search: '@stainless-api/docs/Search',
-    Sidebar: '@stainless-api/docs/Sidebar',
+    Sidebar: '@stainless-api/docs/BaseSidebar',
     Header: '@stainless-api/docs/Header',
     ThemeSelect: '@stainless-api/docs/ThemeSelect',
     ContentPanel: '@stainless-api/docs/ContentPanel',
   };
 
+  if (config.apiReference !== null) {
+    componentOverrides.Sidebar = '@stainless-api/docs/SDKSelectSidebar';
+    componentOverrides.Search = '@stainless-api/docs/Search';
+    plugins.unshift(stainlessStarlight(config.apiReference));
+  }
+
   // TODO: re-add once we figure out what to do with the client router
   // if (config.enableClientRouter) {
   //   // logger.info(`Client router is enabled`);
@@ -94,12 +101,12 @@ function stainlessDocsStarlightIntegration(config: NormalizedStainlessDocsConfig
     ],
     routeMiddleware: [...config.starlightCompat.routeMiddleware, '@stainless-api/docs/tabsMiddleware'],
     customCss: ['@stainless-api/docs/theme', ...config.customCss],
-    plugins: [stainlessStarlight(config.apiReference), ...config.starlightCompat.plugins],
+    plugins,
   });
 }
 
 function stainlessDocsIntegration(config: NormalizedStainlessDocsConfig): AstroIntegration {
-  const virtualId = `virtual:stl-stl-starlight-virtual-module`;
+  const virtualId = `virtual:stl-docs-virtual-module`;
   // The '\0' prefix tells Vite “this is a virtual module” and prevents it from being resolved again.
   const resolvedId = `\0${virtualId}`;
   let redirects: NormalizedRedirectConfig | null = null;
@@ -116,6 +123,10 @@ function stainlessDocsIntegration(config: NormalizedStainlessDocsConfig): AstroI
 
         updateConfig({
           vite: {
+            ssr: {
+              noExternal: ['@stainless-api/ui-primitives'],
+            },
+            optimizeDeps: { include: ['@stainless-api/ui-primitives'] },
             plugins: [
               {
                 name: 'stl-docs-vite',
@@ -132,6 +143,7 @@ function stainlessDocsIntegration(config: NormalizedStainlessDocsConfig): AstroI
                       HEADER_LINKS: config.header.links,
                       HEADER_LAYOUT: config.header.layout,
                       ENABLE_CLIENT_ROUTER: config.enableClientRouter,
+                      INCLUDE_AI_DROPDOWN_OPTIONS: config.includeAIDropdownOptions,
                     });
                   }
                 },
@@ -166,6 +178,7 @@ export function stainlessDocs(config: StainlessDocsUserConfig) {
     process.exit(1);
   }
   const normalizedConfig = normalizedConfigResult.config;
+
   return [
     react(),
     stainlessDocsStarlightIntegration(normalizedConfig),

package/stl-docs/loadStlDocsConfig.ts

@@ -58,7 +58,7 @@ export type HeaderLink = {
 };
 
 export type StainlessDocsUserConfig = {
-  apiReference: StainlessStarlightUserConfig;
+  apiReference?: StainlessStarlightUserConfig;
   tabs?: Tabs;
   header?: {
     layout?: HeaderLayout;
@@ -126,8 +126,9 @@ function normalizeConfig(userConfig: StainlessDocsUserConfig) {
       routeMiddleware: normalizeRouteMiddleware(userConfig),
     },
     enableClientRouter: userConfig.experimental?.enableClientRouter ?? false,
-    apiReference: userConfig.apiReference,
+    apiReference: userConfig.apiReference ?? null,
     sidebar: userConfig.sidebar,
+    includeAIDropdownOptions: userConfig.apiReference?.includeAIDropdownOptions ?? false,
   };
 
   return configWithDefaults;

package/stl-docs/tabsMiddleware.ts

@@ -1,7 +1,7 @@
 import type { StarlightRouteData } from '@astrojs/starlight/route-data';
 import { defineRouteMiddleware } from '@astrojs/starlight/route-data';
 
-import { SPLIT_TABS_ENABLED, TABS } from 'virtual:stl-stl-starlight-virtual-module';
+import { SPLIT_TABS_ENABLED, TABS } from 'virtual:stl-docs-virtual-module';
 import clsx from 'clsx';
 
 // this fn is loaded in the plugin via addRouteMiddleware
@@ -143,7 +143,7 @@ export const onRequest = defineRouteMiddleware(async (context) => {
   }
 
   // We store the active tab index so we can use it in our nav tabs component
-  context.locals.starlightRoute._stlStarlight = {
+  context.locals.starlightRoute._stlDocs = {
     activeTabIndex: activeTabIndex.index,
   };
 

package/styles/page.css

@@ -64,7 +64,7 @@
     align-items: center;
     justify-content: space-between;
     gap: 1rem;
-    padding: 1rem 1rem 0;
+    padding: 1rem 0 0 1rem;
     flex-wrap: wrap;
   }
 }

package/theme.css

@@ -1,5 +1,7 @@
 @layer starlight.base, starlight.reset, starlight.core, starlight.content, starlight.components, starlight.utils;
-@layer starlight, docs-ui, stl-ui, stainless;
+@layer starlight;
+@layer stl-ui.typography, stl-ui.components;
+@layer stl-ui, docs-ui, stainless;
 
 @import './styles/fonts.css';
 @import './styles/variables.css';
@@ -13,3 +15,11 @@
 @import './styles/sdk_select.css';
 @import '@stainless-api/ui-primitives/styles.css';
 @import './styles/mintlify-compat.css';
+
+@import '@stainless-api/docs-ui/src/styles/resets.css';
+@import '@stainless-api/docs-ui/src/styles/primitives.css';
+@import '@stainless-api/docs-ui/src/styles/main.css';
+@import '@stainless-api/docs-ui/src/styles/snippets.css';
+@import '@stainless-api/docs-ui/src/styles/search.css';
+
+@import './components/variables.css';

package/virtual-module.d.ts

@@ -18,9 +18,10 @@ declare module 'virtual:stl-starlight-virtual-module' {
   export const PROPERTY_SETTINGS: PropertySettingsType;
   export const MIDDLEWARE: StlStarlightMiddleware;
   export const SEARCH: StainlessStarlightUserConfig['search'];
+  export const INCLUDE_AI_DROPDOWN_OPTIONS: boolean;
 }
 
-declare module 'virtual:stl-stl-starlight-virtual-module' {
+declare module 'virtual:stl-docs-virtual-module' {
   import type { ButtonVariant } from '@stainless-api/ui-primitives';
   import type { AnchorHTMLAttributes } from 'react';
 
@@ -40,4 +41,5 @@ declare module 'virtual:stl-stl-starlight-virtual-module' {
   export const SPLIT_TABS_ENABLED: boolean;
   export const HEADER_LAYOUT: 'default' | 'stacked';
   export const ENABLE_CLIENT_ROUTER: boolean;
+  export const INCLUDE_AI_DROPDOWN_OPTIONS: boolean;
 }