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

package/stl-docs/components/PageTitle.astro

@@ -0,0 +1,82 @@
+---
+import {
+  ENABLE_PROSE_MARKDOWN_RENDERING,
+  ENABLE_CONTEXT_MENU,
+  RENDER_PAGE_DESCRIPTIONS,
+} from 'virtual:stl-docs-virtual-module';
+import type { StarlightRouteData } from '@astrojs/starlight/route-data';
+import Default from '@astrojs/starlight/components/PageTitle.astro';
+import { ContentBreadcrumbs } from './ContentBreadcrumbs';
+import { AIDropdown } from './AIDropdown';
+
+function sidebarHasEntry(sidebarEntry: StarlightRouteData['sidebar'], currentPath?: string) {
+  if (!currentPath) return false;
+  const normalizePath = (path: string) => {
+    return path.endsWith('/') ? path : path + '/';
+  };
+
+  const normalizedCurrent = normalizePath(currentPath);
+
+  for (const entry of sidebarEntry) {
+    if (entry.type === 'link') {
+      const normalizedHref = normalizePath(entry.href);
+      if (normalizedHref === normalizedCurrent) {
+        return true;
+      }
+    } else if (entry.type === 'group') {
+      const hasInGroup = sidebarHasEntry(entry.entries, currentPath);
+      if (hasInGroup) return true;
+    }
+  }
+
+  return false;
+}
+
+const skipRenderingStarlightTitle = Astro.locals._stlStarlightPage?.skipRenderingStarlightTitle ?? false;
+
+const hasMarkdownRoute = Astro.locals._stlStarlightPage?.hasMarkdownRoute ?? true;
+// ⬆️ hopefully this is temporary. But for now, we don't have a markdown representation of the API reference overview page
+
+const currentPath = Astro.url.pathname;
+
+function shouldShowAIDropdown() {
+  // Hide if there is no associated sidebar entry. This applies to pages like the 404 page.
+  const hasSidebarEntry = sidebarHasEntry(Astro.locals.starlightRoute.sidebar, currentPath);
+  if (!hasSidebarEntry) return false;
+
+  if (!hasMarkdownRoute) return false;
+
+  if (!ENABLE_PROSE_MARKDOWN_RENDERING) return false;
+  if (!ENABLE_CONTEXT_MENU) return false;
+
+  return true;
+}
+
+const showAIDropdown = shouldShowAIDropdown();
+
+const description = Astro.locals.starlightRoute.entry.data.description;
+const shouldRenderDescription = RENDER_PAGE_DESCRIPTIONS;
+---
+
+{
+  skipRenderingStarlightTitle ? null : (
+    <>
+      <div class="stl-ui-not-prose stl-page-nav-container stl-prose-page-nav-container" data-pagefind-ignore>
+        <ContentBreadcrumbs currentPath={currentPath} sidebarEntry={Astro.locals.starlightRoute.sidebar} />
+        {showAIDropdown && <AIDropdown />}
+      </div>
+      <Default />
+      {!!description && shouldRenderDescription && <p class="description">{description}</p>}
+    </>
+  )
+}
+
+<style>
+  p.description {
+    font-size: var(--stl-typography-scale-xl);
+    font-weight: 400;
+    line-height: 1.4;
+    letter-spacing: -0.02em;
+    margin-top: 0.4em;
+  }
+</style>

package/stl-docs/components/StainlessLogo.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 136 32">
+  <path fill="currentColor" d="M34.29 6.344c1.476 0 2.726.27 3.75.807 1.025.521 1.832 1.242 2.422 2.162.59.92.955 1.98 1.094 3.177l-3.411.157c-.087-.678-.295-1.268-.625-1.772a3.159 3.159 0 0 0-1.303-1.172c-.538-.295-1.198-.442-1.98-.442-.971 0-1.744.225-2.317.677-.555.434-.834 1.016-.834 1.745 0 .503.114.92.34 1.25.242.33.668.616 1.276.86.607.225 1.458.468 2.551.729 1.65.347 2.96.79 3.933 1.328.972.538 1.667 1.163 2.084 1.875.417.712.625 1.528.625 2.448 0 1.129-.286 2.11-.86 2.943-.572.816-1.38 1.45-2.421 1.9-1.042.435-2.267.652-3.673.652-1.528 0-2.847-.27-3.958-.808-1.111-.538-1.989-1.284-2.63-2.239-.626-.972-.99-2.1-1.095-3.386l3.438-.207c.104.798.33 1.475.677 2.03.365.556.843.982 1.433 1.277.608.278 1.337.416 2.188.416.729 0 1.345-.086 1.848-.26.521-.19.912-.46 1.172-.807.278-.365.417-.808.417-1.328 0-.47-.113-.886-.339-1.25-.225-.382-.66-.72-1.301-1.016-.643-.313-1.598-.617-2.866-.912-1.527-.347-2.751-.738-3.672-1.172-.92-.451-1.588-1.007-2.005-1.667-.416-.677-.625-1.52-.625-2.526 0-1.077.27-2.022.807-2.838.538-.834 1.303-1.477 2.292-1.928.99-.469 2.18-.703 3.569-.703Zm25.874 4.687c1.979 0 3.472.504 4.48 1.511 1.023.99 1.535 2.414 1.535 4.272v8.437h-2.864l-.112-2.296c-.159.36-.372.692-.644.994-.434.504-.998.903-1.692 1.199-.695.277-1.477.417-2.345.417-1.44 0-2.604-.331-3.49-.99-.885-.678-1.327-1.615-1.327-2.813 0-1.198.373-2.136 1.12-2.813.746-.677 1.883-1.164 3.41-1.459l4.61-.91c0-.99-.225-1.728-.676-2.215-.452-.503-1.12-.755-2.005-.755-.799 0-1.433.19-1.902.573-.451.364-.764.894-.937 1.589l-3.386-.157c.278-1.475.955-2.604 2.031-3.385 1.077-.799 2.475-1.199 4.194-1.199Zm39.004 0c1.32 0 2.475.296 3.464.886 1.007.59 1.78 1.442 2.318 2.553s.807 2.448.807 4.01v.755h-9.87c.07 1.216.4 2.136.99 2.761.607.608 1.406.911 2.395.911.746 0 1.363-.164 1.85-.494a2.655 2.655 0 0 0 1.042-1.432l3.411.208c-.382 1.354-1.137 2.421-2.266 3.203-1.111.781-2.465 1.172-4.062 1.173-1.39 0-2.596-.296-3.62-.886a6.124 6.124 0 0 1-2.37-2.553c-.556-1.094-.834-2.37-.834-3.828 0-1.458.278-2.726.833-3.803.556-1.093 1.337-1.944 2.344-2.551 1.025-.608 2.214-.913 3.569-.913Zm14.091 0c1.25 0 2.301.209 3.152.625.85.4 1.51.955 1.979 1.667.486.695.79 1.494.911 2.397l-3.359.156a3.336 3.336 0 0 0-.469-1.224 2.104 2.104 0 0 0-.912-.782c-.382-.19-.833-.286-1.353-.286-.782 0-1.373.156-1.772.469-.399.312-.599.73-.599 1.25 0 .364.087.668.26.911.191.243.496.443.912.6.417.139.973.269 1.667.39 1.459.226 2.604.521 3.438.886.85.347 1.449.798 1.797 1.354.364.538.547 1.19.547 1.954-.001.885-.252 1.64-.755 2.265-.487.625-1.182 1.102-2.084 1.432-.886.312-1.927.47-3.125.47-1.372 0-2.527-.2-3.464-.6-.92-.4-1.632-.955-2.136-1.667a4.743 4.743 0 0 1-.859-2.422l3.412-.156c.121.73.425 1.294.911 1.693.486.4 1.207.599 2.162.599.781 0 1.388-.122 1.822-.364.452-.26.678-.66.678-1.199 0-.312-.078-.573-.234-.78-.157-.21-.452-.392-.886-.548-.434-.156-1.076-.312-1.927-.468-1.424-.244-2.544-.539-3.36-.886-.816-.365-1.397-.817-1.744-1.355-.33-.538-.495-1.206-.495-2.005 0-1.302.494-2.352 1.484-3.151 1.007-.816 2.474-1.225 4.401-1.225Zm13.697 0c1.25 0 2.3.209 3.151.625.851.4 1.511.955 1.979 1.667.487.695.79 1.494.912 2.397l-3.36.156a3.336 3.336 0 0 0-.469-1.224 2.098 2.098 0 0 0-.912-.782c-.381-.19-.833-.286-1.353-.286-.782 0-1.372.156-1.772.469-.399.312-.598.73-.598 1.25 0 .364.086.668.259.911.191.243.496.443.913.6.416.139.972.269 1.667.39 1.458.226 2.604.521 3.437.886.851.347 1.45.798 1.797 1.354.365.538.547 1.19.547 1.954 0 .885-.252 1.64-.755 2.265-.486.625-1.181 1.102-2.084 1.432-.886.312-1.927.47-3.125.47-1.372 0-2.526-.2-3.464-.6-.92-.4-1.632-.955-2.136-1.667a4.743 4.743 0 0 1-.859-2.422l3.412-.156c.122.73.425 1.294.911 1.693.486.4 1.207.599 2.162.599.781 0 1.389-.122 1.823-.364.451-.26.677-.66.677-1.199 0-.312-.078-.573-.234-.78-.156-.21-.452-.392-.886-.548-.434-.156-1.076-.312-1.927-.468-1.423-.244-2.544-.539-3.36-.886-.816-.365-1.397-.817-1.744-1.355-.33-.538-.495-1.206-.495-2.005 0-1.302.495-2.352 1.484-3.151 1.007-.816 2.474-1.225 4.402-1.225Zm-78.355.313h3.672v2.579H48.6v7.031c0 .643.14 1.094.417 1.355.278.243.712.364 1.302.364h1.953v2.578h-2.969c-1.389 0-2.413-.32-3.073-.963-.642-.642-.963-1.65-.963-3.021v-7.344H43.08v-2.58h2.188V8.09h3.333v3.255ZM71.393 25.25H68.06V11.344h3.334V25.25Zm9.308-14.22c1.024 0 1.883.227 2.578.678a4.26 4.26 0 0 1 1.614 1.875c.365.781.547 1.693.547 2.735v8.932h-3.333v-7.864c0-.781-.078-1.442-.234-1.98-.157-.538-.417-.947-.782-1.224-.347-.295-.817-.443-1.407-.443-.885 0-1.597.313-2.135.938-.52.625-.78 1.528-.78 2.709v7.864h-3.335V11.344h3.022l.079 2.384a4.08 4.08 0 0 1 .52-.977 3.946 3.946 0 0 1 1.588-1.303 5.01 5.01 0 0 1 2.058-.417Zm9.917 14.22h-3.334V6.761h3.334v18.49Zm-31.366-5.677c-.747.157-1.285.391-1.615.703-.312.296-.468.686-.468 1.172 0 .538.173.955.52 1.25.365.295.877.443 1.537.443.746 0 1.389-.148 1.927-.443a3.14 3.14 0 0 0 1.25-1.223c.295-.521.442-1.138.442-1.85v-.781l-3.593.73Zm39.916-5.912c-.885 0-1.623.287-2.213.86-.573.573-.929 1.398-1.068 2.474h6.433c-.07-1.128-.391-1.962-.964-2.5-.573-.556-1.302-.834-2.188-.834ZM69.752 6.344c.504 0 .912.156 1.224.469.33.295.495.694.495 1.198 0 .52-.165.937-.495 1.25-.312.295-.72.442-1.224.442-.52 0-.946-.147-1.276-.442-.312-.313-.469-.73-.469-1.25 0-.504.157-.903.47-1.198.329-.313.755-.47 1.275-.47Z"/>
+  <image width="20.5" height="20.5" y="6" xlink:href="data:image/png;base64,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"/>
+</svg>

package/stl-docs/components/ThemeProvider.astro

@@ -0,0 +1,36 @@
+{/* Inlined to avoid FOUC. All theme selects are initialized here */}
+<script is:inline>
+  window.didInitThemePickers = window.didInitThemePickers ?? false;
+
+  // Only run once.
+  if (!window.didInitThemePickers) {
+    window.didInitThemePickers = true;
+
+    // The stored theme will be either 'auto', 'light', 'dark' or null.
+    const storedTheme = typeof localStorage !== 'undefined' && localStorage.getItem('starlight-theme');
+
+    // This theme is either 'light' or 'dark'. It's used for setting the data-theme attribute.
+    const theme =
+      !storedTheme || storedTheme === 'auto'
+        ? window.matchMedia('(prefers-color-scheme: light)').matches
+          ? 'light'
+          : 'dark'
+        : storedTheme;
+
+    document.documentElement.dataset.theme = theme === 'light' ? 'light' : 'dark';
+
+    const themeSelects = document.querySelectorAll('[data-theme-select]');
+    const selectedThemeValue = storedTheme || 'auto';
+
+    themeSelects.forEach((select) => {
+      const tmpl = select.querySelector(`[data-value="${selectedThemeValue}"] template`);
+      const selectedSlot = select.querySelector('[data-part="trigger-selected"]');
+
+      selectedSlot.innerHTML = '';
+      if (tmpl) {
+        selectedSlot.appendChild(tmpl.content.cloneNode(true));
+        return;
+      }
+    });
+  }
+</script>

package/stl-docs/components/ThemeSelect.astro

@@ -1,94 +1,96 @@
 ---
-import {
-  Dropdown,
-  DropdownTrigger,
-  DropdownMenu,
-  DropdownItem,
-} from '@stainless-api/docs-ui/src/components/dropdown';
+import { Dropdown } from '@stainless-api/docs/components';
+import { ChevronsUpDownIcon } from 'lucide-react';
 
 const options = [
   {
     value: 'auto',
     label: 'Auto',
-    icon: `<svg
-  width="24"
-  height="24"
-  viewBox="0 0 24 24"
-  fill="none"
-  xmlns="http://www.w3.org/2000/svg"
->
-  <path
+    icon: `
+      <svg
+        width="24"
+        height="24"
+        viewBox="0 0 24 24"
+        fill="none"
+        xmlns="http://www.w3.org/2000/svg"
+      >
+        <path
           d="M21 5C21 4.44771 20.5523 4 20 4H4C3.44772 4 3 4.44772 3 5V15C3 15.5523 3.44772 16 4 16H20C20.5523 16 21 15.5523 21 15V5ZM23 15C23 16.6569 21.6569 18 20 18H13V20H16C16.5523 20 17 20.4477 17 21C17 21.5523 16.5523 22 16 22H8C7.44772 22 7 21.5523 7 21C7 20.4477 7.44772 20 8 20H11V18H4C2.34315 18 1 16.6569 1 15V5C1 3.34315 2.34315 2 4 2H20C21.6569 2 23 3.34315 23 5V15Z"
-          fill="#262626"></path></svg
->`,
+          fill="var(--stl-color-foreground)"
+        ></path>
+      </svg>
+    `,
   },
   {
     value: 'light',
     label: 'Light',
-    icon: `<svg
-  width="24"
-  height="24"
-  viewBox="0 0 24 24"
-  fill="none"
-  xmlns="http://www.w3.org/2000/svg"
->
-  <path
+    icon: `
+      <svg
+        width="24"
+        height="24"
+        viewBox="0 0 24 24"
+        fill="none"
+        xmlns="http://www.w3.org/2000/svg"
+      >
+        <path
           d="M11 22V20C11 19.4477 11.4477 19 12 19C12.5523 19 13 19.4477 13 20V22C13 22.5523 12.5523 23 12 23C11.4477 23 11 22.5523 11 22ZM5.63281 16.9531C6.02332 16.5626 6.65635 16.5626 7.04688 16.9531C7.4374 17.3436 7.4374 17.9767 7.04688 18.3672L5.6377 19.7773C5.24717 20.1679 4.61318 20.1679 4.22266 19.7773C3.83232 19.387 3.83259 18.7538 4.22266 18.3633L5.63281 16.9531ZM16.9531 16.9531C17.3191 16.5871 17.8982 16.5637 18.291 16.8838L18.3672 16.9531L19.7773 18.3633L19.8457 18.4385C20.1663 18.8313 20.1435 19.4111 19.7773 19.7773C19.4113 20.1433 18.8322 20.1658 18.4395 19.8457L18.3633 19.7773L16.9531 18.3672L16.8848 18.291C16.5643 17.8983 16.5871 17.3193 16.9531 16.9531ZM15 12C15 10.3431 13.6569 9 12 9C10.3431 9 9 10.3431 9 12C9 13.6569 10.3431 15 12 15C13.6569 15 15 13.6569 15 12ZM4 11C4.55228 11 5 11.4477 5 12C5 12.5523 4.55228 13 4 13H2C1.44772 13 1 12.5523 1 12C1 11.4477 1.44772 11 2 11H4ZM22 11C22.5523 11 23 11.4477 23 12C23 12.5523 22.5523 13 22 13H20C19.4477 13 19 12.5523 19 12C19 11.4477 19.4477 11 20 11H22ZM7.04688 5.63281C7.4374 6.02334 7.4374 6.65635 7.04688 7.04688C6.65634 7.43728 6.0233 7.43736 5.63281 7.04688L4.22266 5.63672L5.6377 4.22266L7.04688 5.63281ZM18.3633 4.22266C18.7538 3.83235 19.3869 3.83224 19.7773 4.22266C20.1678 4.61311 20.1677 5.24618 19.7773 5.63672L18.3672 7.04688C17.9767 7.4374 17.3436 7.4374 16.9531 7.04688C16.5626 6.65635 16.5626 6.02332 16.9531 5.63281L18.3633 4.22266ZM4.22266 4.22266C4.61318 3.83213 5.24717 3.83213 5.6377 4.22266L4.22266 5.63672C3.83254 5.24621 3.83238 4.61307 4.22266 4.22266ZM11 4V2C11 1.44772 11.4477 1 12 1C12.5523 1 13 1.44772 13 2V4C13 4.55228 12.5523 5 12 5C11.4477 5 11 4.55228 11 4ZM17 12C17 14.7614 14.7614 17 12 17C9.23858 17 7 14.7614 7 12C7 9.23858 9.23858 7 12 7C14.7614 7 17 9.23858 17 12Z"
-          fill="#262626"></path></svg
->`,
+          fill="var(--stl-color-foreground)"
+        ></path>
+      </svg>
+    `,
   },
   {
     value: 'dark',
     label: 'Dark',
-    icon: `<svg
-  width="24"
-  height="24"
-  viewBox="0 0 24 24"
-  fill="none"
-  xmlns="http://www.w3.org/2000/svg"
->
-  <path
-    d="M9.13569 7.5C9.13569 6.37669 9.39314 5.28007 9.87397 4.28809C9.05381 4.51419 8.27063 4.87087 7.55561 5.34863C6.24009 6.22764 5.21483 7.47676 4.60932 8.93848C4.00386 10.4002 3.84465 12.0088 4.15327 13.5605C4.46195 15.1124 5.2239 16.5384 6.34272 17.6572C7.46154 18.776 8.88756 19.538 10.4394 19.8467C11.9912 20.1553 13.5997 19.9961 15.0615 19.3906C16.5232 18.7851 17.7723 17.7599 18.6513 16.4443C19.1292 15.7291 19.4848 14.9454 19.7109 14.125C18.719 14.6057 17.6231 14.8643 16.4999 14.8643C14.5469 14.8643 12.6739 14.088 11.2929 12.707C9.91191 11.326 9.13569 9.45304 9.13569 7.5ZM11.1357 7.5C11.1357 8.92261 11.701 10.287 12.707 11.293C13.7129 12.2989 15.0773 12.8643 16.4999 12.8643C17.9226 12.8643 19.287 12.2989 20.2929 11.293C20.5789 11.007 21.0091 10.9214 21.3828 11.0762C21.7564 11.231 22 11.5956 22 12C22 13.9778 21.4132 15.9112 20.3144 17.5557C19.2156 19.2001 17.6543 20.4824 15.8271 21.2393C13.9998 21.9961 11.9886 22.1935 10.0488 21.8076C8.10909 21.4217 6.32711 20.4697 4.92866 19.0713C3.53021 17.6728 2.57822 15.8909 2.19233 13.9512C1.80648 12.0114 2.00382 10.0001 2.76069 8.17285C3.51756 6.34567 4.79987 4.78434 6.44429 3.68555C8.08878 2.58673 10.0221 2 11.9999 2C12.4044 2 12.769 2.24359 12.9238 2.61719C13.0786 2.99086 12.993 3.42103 12.707 3.70703C11.701 4.71297 11.1357 6.07739 11.1357 7.5Z"
-    fill="#262626"></path></svg
->`,
+    icon: `
+      <svg
+        width="24"
+        height="24"
+        viewBox="0 0 24 24"
+        fill="none"
+        xmlns="http://www.w3.org/2000/svg"
+      >
+        <path
+          d="M9.13569 7.5C9.13569 6.37669 9.39314 5.28007 9.87397 4.28809C9.05381 4.51419 8.27063 4.87087 7.55561 5.34863C6.24009 6.22764 5.21483 7.47676 4.60932 8.93848C4.00386 10.4002 3.84465 12.0088 4.15327 13.5605C4.46195 15.1124 5.2239 16.5384 6.34272 17.6572C7.46154 18.776 8.88756 19.538 10.4394 19.8467C11.9912 20.1553 13.5997 19.9961 15.0615 19.3906C16.5232 18.7851 17.7723 17.7599 18.6513 16.4443C19.1292 15.7291 19.4848 14.9454 19.7109 14.125C18.719 14.6057 17.6231 14.8643 16.4999 14.8643C14.5469 14.8643 12.6739 14.088 11.2929 12.707C9.91191 11.326 9.13569 9.45304 9.13569 7.5ZM11.1357 7.5C11.1357 8.92261 11.701 10.287 12.707 11.293C13.7129 12.2989 15.0773 12.8643 16.4999 12.8643C17.9226 12.8643 19.287 12.2989 20.2929 11.293C20.5789 11.007 21.0091 10.9214 21.3828 11.0762C21.7564 11.231 22 11.5956 22 12C22 13.9778 21.4132 15.9112 20.3144 17.5557C19.2156 19.2001 17.6543 20.4824 15.8271 21.2393C13.9998 21.9961 11.9886 22.1935 10.0488 21.8076C8.10909 21.4217 6.32711 20.4697 4.92866 19.0713C3.53021 17.6728 2.57822 15.8909 2.19233 13.9512C1.80648 12.0114 2.00382 10.0001 2.76069 8.17285C3.51756 6.34567 4.79987 4.78434 6.44429 3.68555C8.08878 2.58673 10.0221 2 11.9999 2C12.4044 2 12.769 2.24359 12.9238 2.61719C13.0786 2.99086 12.993 3.42103 12.707 3.70703C11.701 4.71297 11.1357 6.07739 11.1357 7.5Z"
+          fill="var(--stl-color-foreground)"
+        ></path>
+      </svg>
+    `,
   },
 ];
 ---
 
-<div class="stldocs-root theme-select-root">
-  <Dropdown className="theme-select-container" data-theme-select>
-    <DropdownTrigger withChevron>
-      <span class="stl-dropdown-icon">
-        {options.map(({ value, label, icon }) => <Fragment set:html={icon} />)}
-      </span>
-    </DropdownTrigger>
-    <DropdownMenu role="listbox">
-      {
-        options.map(({ value, label, icon }) => (
-          <DropdownItem role="option" value={value}>
-            <div>
-              <span class="stl-dropdown-icon">
-                <Fragment set:html={icon} />
-              </span>
-              <span class="stl-dropdown-label">{label}</span>
-            </div>
-          </DropdownItem>
-        ))
-      }
-    </DropdownMenu>
-  </Dropdown>
-</div>
-
-{/* Inlined to avoid FOUC. Uses global scope from `ThemeProvider.astro` */}
-<script is:inline>
-  document.addEventListener('astro:page-load', () => {
-    StarlightThemeProvider.updatePickers();
-  });
-  StarlightThemeProvider.updatePickers();
-</script>
+<Dropdown data-theme-select>
+  <Dropdown.Trigger>
+    <Dropdown.TriggerSelectedItem>
+      <span class="stl-dropdown-icon"></span>
+    </Dropdown.TriggerSelectedItem>
+    <Dropdown.TriggerIcon>
+      <ChevronsUpDownIcon size={16} />
+    </Dropdown.TriggerIcon>
+  </Dropdown.Trigger>
+  <Dropdown.Menu>
+    {
+      options.map(({ value, label, icon }) => (
+        <Dropdown.MenuItem value={value}>
+          <Dropdown.Icon>
+            <Fragment set:html={icon} />
+          </Dropdown.Icon>
+          <Dropdown.MenuItemText>{label}</Dropdown.MenuItemText>
+          <Dropdown.MenuItemTemplate>
+            <span class="stl-dropdown-icon">
+              <Fragment set:html={icon} />
+            </span>
+          </Dropdown.MenuItemTemplate>
+        </Dropdown.MenuItem>
+      ))
+    }
+  </Dropdown.Menu>
+</Dropdown>
 
 <script>
   import { getPageLoadEvent } from '../../plugin/helpers/getPageLoadEvent';
+  import { initDropdown } from '@stainless-api/docs/components/scripts';
 
   const storageKey = 'starlight-theme';
 
@@ -100,116 +102,54 @@ const options = [
   const loadTheme = (): Theme => parseTheme(localStorage.getItem(storageKey));
 
   const storeTheme = (theme: Theme) => {
-    localStorage.setItem(storageKey, theme === 'light' || theme === 'dark' ? theme : '');
+    localStorage.setItem(storageKey, parseTheme(theme));
   };
 
   const getPreferredColorScheme = (): Theme =>
     window.matchMedia('(prefers-color-scheme: light)').matches ? 'light' : 'dark';
 
-  const highlightSelected = (doc: Document, theme: Theme) => {
-    doc.querySelectorAll('.theme-select-container.stldocs-dropdown').forEach((container) => {
-      const icons = container.querySelectorAll('.stl-dropdown-icon svg');
-      icons.forEach((icon, index) => {
-        const themeForIcon = ['auto', 'light', 'dark'][index];
-        icon.classList.toggle('selected', theme === themeForIcon);
-      });
-
-      container.querySelectorAll('.stldocs-dropdown-item').forEach((option) => {
-        const label = option.querySelector('.stl-dropdown-label')?.textContent?.toLowerCase();
-        option.classList.toggle('selected', label === theme);
-      });
-
-      const menu = container.querySelector('.stldocs-dropdown-menu');
-      menu?.classList.remove('open');
-    });
-  };
-
   const applyTheme = (doc: Document, theme: Theme) => {
     const effective = theme === 'auto' ? getPreferredColorScheme() : theme;
     doc.documentElement.dataset.theme = effective;
     storeTheme(theme);
-    StarlightThemeProvider?.updatePickers?.(theme);
-    highlightSelected(doc, theme);
   };
 
   function setupThemeMode(doc: Document) {
-    // Attach to all instances of .theme-select-container.stldocs-dropdown. We need this because
-    // the theme component is used in the mobile dropdown and the desktop sidebar.
-    doc.querySelectorAll('.theme-select-container.stldocs-dropdown').forEach((container) => {
-      const trigger = container.querySelector('.stldocs-dropdown-trigger');
-      const menu = container.querySelector('.stldocs-dropdown-menu');
-
-      if (trigger && menu) {
-        trigger.addEventListener('click', (e) => {
-          e.stopPropagation();
-
-          doc.querySelectorAll('.theme-select-container .stldocs-dropdown-menu.open').forEach((otherMenu) => {
-            if (otherMenu !== menu) otherMenu.classList.remove('open');
-          });
-
-          menu.classList.toggle('open');
-        });
-
-        container.querySelectorAll('.stldocs-dropdown-item').forEach((option) => {
-          option.addEventListener('click', () => {
-            const label = option.querySelector('.stl-dropdown-label')?.textContent?.toLowerCase() ?? '';
-            if (['auto', 'light', 'dark'].includes(label)) {
-              applyTheme(doc, label as Theme);
-            }
-          });
-        });
-      }
-    });
-
-    // Close dropdown if you click outside
-    doc.addEventListener('click', (e) => {
-      doc.querySelectorAll('.theme-select-container .stldocs-dropdown-menu.open').forEach((menu) => {
-        if (e.target instanceof HTMLElement && !menu.contains(e.target)) {
-          menu.classList.remove('open');
-        }
-      });
-    });
-
-    // React to system preference changes
     matchMedia('(prefers-color-scheme: light)').addEventListener('change', () => {
       if (loadTheme() === 'auto') applyTheme(doc, 'auto');
     });
 
     applyTheme(doc, loadTheme());
+    return loadTheme();
   }
 
   document.addEventListener('astro:before-swap', (event) => {
     applyTheme(event.newDocument, loadTheme());
   });
 
-  document.addEventListener(getPageLoadEvent(), (e) => {
-    setupThemeMode(document);
+  document.addEventListener(getPageLoadEvent(), () => {
+    const initialTheme = setupThemeMode(document);
+    const themeSelects = document.querySelectorAll<HTMLElement>('[data-theme-select]');
+    themeSelects.forEach((select) => {
+      initDropdown({
+        root: select,
+        onSelect: (value: string) => applyTheme(document, value as Theme),
+        initialValue: initialTheme as string,
+      });
+    });
   });
 </script>
 
 <style is:global>
-  .theme-select-root {
-    background-color: unset;
-    display: flex;
-    align-items: center;
-  }
   .stl-dropdown-icon svg {
     width: 16px;
     height: 16px;
 
     path {
-      fill: var(--sl-color-gray-2);
+      fill: var(--stl-color-foreground-reduced);
     }
   }
 
-  .stldocs-dropdown-trigger .stl-dropdown-icon svg {
-    display: none;
-
-    &.selected {
-      display: flex;
-    }
-  }
-  .stldocs-root .stl-dropdown-icon,
   .stl-dropdown-icon {
     display: flex;
     align-items: center;
@@ -218,9 +158,7 @@ const options = [
     height: 16px;
   }
 
-  .stldocs-root span.stl-dropdown-icon,
-  span.stl-dropdown-icon,
-  span.stl-dropdown-chevron {
+  span.stl-dropdown-icon {
     padding-left: 0;
     padding-right: 0%;
   }

package/stl-docs/components/TwoColumnContent.astro

@@ -0,0 +1,2 @@
+<slot />
+<slot name="right-sidebar" slot="right-sidebar" />

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

@@ -6,17 +6,15 @@ import HeaderLinks from './HeaderLinks.astro';
 import NavLinks from '../nav-tabs/NavTabs.astro';
 import { TABS } from 'virtual:stl-docs-virtual-module';
 import ThemeSelect from 'virtual:starlight/components/ThemeSelect';
-import SplashMobileMenuToggle from './SplashMobileMenuToggle.astro';
 
-interface Props {
+type Props = {
   shouldRenderSearch?: boolean;
-}
+};
 
 const { shouldRenderSearch } = Astro.props;
-const { hasSidebar } = Astro.locals.starlightRoute;
 ---
 
-<div class="header my-header">
+<div class="header">
   <div class="left-group">
     <div class="title-wrapper sl-flex">
       <SiteTitle />
@@ -24,9 +22,9 @@ const { hasSidebar } = Astro.locals.starlightRoute;
   </div>
   {TABS.length > 0 && <NavLinks />}
 
-  <div class={'sl-flex print:hidden right-group default-tabs-container'}>
-    {shouldRenderSearch && <Search />}
-    {!hasSidebar && <SplashMobileMenuToggle />}
+  {shouldRenderSearch && <Search />}
+
+  <div class="right-group">
     <div class="sl-hidden md:sl-flex">
       <ThemeSelect />
       <HeaderLinks />

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

@@ -1,34 +1,28 @@
 ---
-import LanguageSelect from "virtual:starlight/components/LanguageSelect";
-import Search from "virtual:starlight/components/Search";
-import SiteTitle from "virtual:starlight/components/SiteTitle";
+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-docs-virtual-module";
-import ThemeSelect from "virtual:starlight/components/ThemeSelect";
-import SecondaryNavTabs from "../nav-tabs/SecondaryNavTabs.astro";
-import SplashMobileMenuToggle from "./SplashMobileMenuToggle.astro";
+import ThemeSelect from 'virtual:starlight/components/ThemeSelect';
+import SecondaryNavTabs from '../nav-tabs/SecondaryNavTabs.astro';
 
-interface Props {
+type Props = {
   shouldRenderSearch?: boolean;
-}
+};
 
 const { shouldRenderSearch } = Astro.props;
-const { hasSidebar } = Astro.locals.starlightRoute;
 ---
 
-<div class="header my-header">
+<div class="header">
   <div class="left-group">
     <div class="title-wrapper sl-flex">
       <SiteTitle />
     </div>
   </div>
 
-  <div class="stl-top-container">
-    {shouldRenderSearch && <Search />}
-    {!hasSidebar && <SplashMobileMenuToggle />}
-  </div>
+  {shouldRenderSearch && <Search />}
 
-  <div class={`sl-hidden md:sl-flex print:hidden right-group`}>
+  <div class="right-group">
     <ThemeSelect />
     <HeaderLinks />
     <LanguageSelect />
@@ -36,40 +30,3 @@ const { hasSidebar } = Astro.locals.starlightRoute;
 </div>
 
 <SecondaryNavTabs />
-
-<style is:inline>
-    .stl-top-container {
-      display: flex;
-      flex-direction: row;
-      align-items: center;
-      justify-content: end;
-      gap: 0.5rem;
-      width: 100%;
-    }
-  @media (min-width: 50rem) {
-    :root {
-      --sl-nav-height: 80px;
-    }
-
-    header.header {
-      display: flex;
-      flex-direction: column;
-      gap: 0.29rem;
-      padding-bottom: 0;
-    }
-
-    .stl-top-container {
-      justify-content: center;
-    }
-  }
-</style>
-
-{TABS.length === 0 && (
-  <style is:inline>
-    @media (min-width: 50rem) {
-      :root {
-        --sl-nav-height: 56px;
-      }
-    }
-  </style>
-)}

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

@@ -1,10 +1,10 @@
 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)">
+      <g clipPath="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)"
+          fill="currentColor"
         />
       </g>
       <defs>

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

@@ -0,0 +1,10 @@
+export function CursorIcon() {
+  return (
+    <svg xmlns="http://www.w3.org/2000/svg" height="16" width="16" viewBox="0 0 466.73 532.09">
+      <path
+        fill="currentColor"
+        d="M457.43,125.94L244.42,2.96c-6.84-3.95-15.28-3.95-22.12,0L9.3,125.94c-5.75,3.32-9.3,9.46-9.3,16.11v247.99c0,6.65,3.55,12.79,9.3,16.11l213.01,122.98c6.84,3.95,15.28,3.95,22.12,0l213.01-122.98c5.75-3.32,9.3-9.46,9.3-16.11v-247.99c0-6.65-3.55-12.79-9.3-16.11h-.01ZM444.05,151.99l-205.63,356.16c-1.39,2.4-5.06,1.42-5.06-1.36v-233.21c0-4.66-2.49-8.97-6.53-11.31L24.87,145.67c-2.4-1.39-1.42-5.06,1.36-5.06h411.26c5.84,0,9.49,6.33,6.57,11.39h-.01Z"
+      />
+    </svg>
+  );
+}