@stainless-api/docs 0.1.0-beta.7 → 0.1.0-beta.70

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

@@ -16,51 +16,49 @@ const { cols } = Astro.props;
 </div>
 
 <style>
-  @layer stl-ui-mintlify-compat {
-    .stl-ui-mintlify-compat-columns {
-      display: grid;
-      gap: 1rem;
-      grid-template-columns: 1fr;
+  .stl-ui-mintlify-compat-columns {
+    display: grid;
+    gap: 1rem;
+    grid-template-columns: 1fr;
 
-      > [data-stl-ui-element] {
-        margin: 0;
-      }
+    > [data-stl-ui-element] {
+      margin: 0;
     }
+  }
 
-    @media (min-width: 50rem) {
-      .stl-ui-mintlify-compat-columns--2 {
-        grid-template-columns: repeat(2, minmax(0, 1fr));
-      }
-      .stl-ui-mintlify-compat-columns--3 {
-        grid-template-columns: repeat(3, minmax(0, 1fr));
-      }
-      .stl-ui-mintlify-compat-columns--4 {
-        grid-template-columns: repeat(4, minmax(0, 1fr));
-      }
-      .stl-ui-mintlify-compat-columns--5 {
-        grid-template-columns: repeat(5, minmax(0, 1fr));
-      }
-      .stl-ui-mintlify-compat-columns--6 {
-        grid-template-columns: repeat(6, minmax(0, 1fr));
-      }
-      .stl-ui-mintlify-compat-columns--7 {
-        grid-template-columns: repeat(7, minmax(0, 1fr));
-      }
-      .stl-ui-mintlify-compat-columns--8 {
-        grid-template-columns: repeat(8, minmax(0, 1fr));
-      }
-      .stl-ui-mintlify-compat-columns--9 {
-        grid-template-columns: repeat(9, minmax(0, 1fr));
-      }
-      .stl-ui-mintlify-compat-columns--10 {
-        grid-template-columns: repeat(10, minmax(0, 1fr));
-      }
-      .stl-ui-mintlify-compat-columns--11 {
-        grid-template-columns: repeat(11, minmax(0, 1fr));
-      }
-      .stl-ui-mintlify-compat-columns--12 {
-        grid-template-columns: repeat(12, minmax(0, 1fr));
-      }
+  @media (min-width: 50rem) {
+    .stl-ui-mintlify-compat-columns--2 {
+      grid-template-columns: repeat(2, minmax(0, 1fr));
+    }
+    .stl-ui-mintlify-compat-columns--3 {
+      grid-template-columns: repeat(3, minmax(0, 1fr));
+    }
+    .stl-ui-mintlify-compat-columns--4 {
+      grid-template-columns: repeat(4, minmax(0, 1fr));
+    }
+    .stl-ui-mintlify-compat-columns--5 {
+      grid-template-columns: repeat(5, minmax(0, 1fr));
+    }
+    .stl-ui-mintlify-compat-columns--6 {
+      grid-template-columns: repeat(6, minmax(0, 1fr));
+    }
+    .stl-ui-mintlify-compat-columns--7 {
+      grid-template-columns: repeat(7, minmax(0, 1fr));
+    }
+    .stl-ui-mintlify-compat-columns--8 {
+      grid-template-columns: repeat(8, minmax(0, 1fr));
+    }
+    .stl-ui-mintlify-compat-columns--9 {
+      grid-template-columns: repeat(9, minmax(0, 1fr));
+    }
+    .stl-ui-mintlify-compat-columns--10 {
+      grid-template-columns: repeat(10, minmax(0, 1fr));
+    }
+    .stl-ui-mintlify-compat-columns--11 {
+      grid-template-columns: repeat(11, minmax(0, 1fr));
+    }
+    .stl-ui-mintlify-compat-columns--12 {
+      grid-template-columns: repeat(12, minmax(0, 1fr));
     }
   }
 </style>

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

@@ -12,26 +12,24 @@ const { caption } = Astro.props;
 </div>
 
 <style>
-  @layer stl-ui-mintlify-compat {
-    .stl-ui-mintlify-compat-frame {
-      padding: 6px;
-      border-radius: 10px;
-      background-color: var(--sl-color-gray-7);
-      border: 1px solid var(--sl-color-gray-6);
+  .stl-ui-mintlify-compat-frame {
+    padding: 6px;
+    border-radius: 10px;
+    background-color: var(--stl-color-ui-background);
+    border: 1px solid var(--stl-color-border);
 
-      .stl-ui-mintlify-compat-frame-content {
-        border-radius: 8px;
-        overflow: hidden;
-      }
+    .stl-ui-mintlify-compat-frame-content {
+      border-radius: 8px;
+      overflow: hidden;
+    }
 
-      .stl-ui-mintlify-compat-frame-caption {
-        text-align: center;
-        padding-top: 12px;
-        padding-bottom: 6px;
-        font-size: var(--sl-text-body);
-        color: var(--sl-color-gray-3);
-        line-height: 100%;
-      }
+    .stl-ui-mintlify-compat-frame-caption {
+      text-align: center;
+      padding-top: 12px;
+      padding-bottom: 6px;
+      font-size: var(--stl-typography-scale-base);
+      color: var(--stl-color-foreground-reduced);
+      line-height: 100%;
     }
   }
 </style>

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

@@ -3,7 +3,7 @@ import { Callout as StainlessCallout, type CalloutVariant } from '@stainless-api
 
 export interface Props {
   variant?: CalloutVariant;
-  children: unknown;
+  children: astroHTML.JSX.Children;
 }
 
 const { variant } = Astro.props;

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

@@ -2,7 +2,7 @@
 import { Callout } from '@stainless-api/ui-primitives';
 
 export interface Props {
-  children: unknown;
+  children: astroHTML.JSX.Children;
 }
 ---
 

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

@@ -2,7 +2,7 @@
 import { Callout } from '@stainless-api/ui-primitives';
 
 export interface Props {
-  children: unknown;
+  children: astroHTML.JSX.Children;
 }
 ---
 

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

@@ -2,7 +2,7 @@
 import { Callout } from '@stainless-api/ui-primitives';
 
 export interface Props {
-  children: unknown;
+  children: astroHTML.JSX.Children;
 }
 ---
 

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

@@ -2,7 +2,7 @@
 import { Callout } from '@stainless-api/ui-primitives';
 
 export interface Props {
-  children: unknown;
+  children: astroHTML.JSX.Children;
 }
 ---
 

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

@@ -2,7 +2,7 @@
 import { Callout } from '@stainless-api/ui-primitives';
 
 export interface Props {
-  children: unknown;
+  children: astroHTML.JSX.Children;
 }
 ---
 

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

@@ -2,7 +2,7 @@
 import { Callout } from '@stainless-api/ui-primitives';
 
 export interface Props {
-  children: unknown;
+  children: astroHTML.JSX.Children;
 }
 ---
 

package/stl-docs/components/mintlify-compat/card.css

@@ -1,44 +1,42 @@
-@layer stl-ui-mintlify-compat {
-  .stl-ui-mintlify-compat-card {
-    border-radius: 12px;
-    padding: 16px;
-    font-size: var(--sl-text-body);
-    display: flex;
-    gap: 8px;
-    border: 1px solid var(--sl-color-hairline);
-    flex-direction: column;
+.stl-ui-mintlify-compat-card {
+  border-radius: 12px;
+  padding: 16px;
+  font-size: var(--stl-typography-scale-base);
+  display: flex;
+  gap: 8px;
+  border: 1px solid var(--stl-color-border);
+  flex-direction: column;
 
-    .stl-ui-mintlify-compat-card-icon svg {
-      color: var(--sl-color-accent);
-    }
+  .stl-ui-mintlify-compat-card-icon svg {
+    color: var(--sl-color-accent);
+  }
 
-    .stl-ui-mintlify-compat-card-title {
-      font-weight: 600;
-      font-size: 1.125rem;
-      display: flex;
-      align-items: center;
-      gap: 8px;
-      margin-top: 8px;
-    }
+  .stl-ui-mintlify-compat-card-title {
+    font-weight: 600;
+    font-size: 1.125rem;
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    margin-top: 8px;
+  }
 
-    .stl-ui-mintlify-compat-card-content {
-      margin-top: 0;
-      color: var(--sl-color-text-secondary);
-    }
+  .stl-ui-mintlify-compat-card-content {
+    margin-top: 0;
+    color: var(--stl-color-foreground-reduced);
   }
+}
 
-  a.stl-ui-mintlify-compat-card {
-    text-decoration: none;
-    color: var(--sl-color-text-secondary);
+a.stl-ui-mintlify-compat-card {
+  text-decoration: none;
+  color: var(--stl-color-foreground-reduced);
 
-    &:hover {
-      border-color: var(--sl-color-accent);
-    }
+  &:hover {
+    border-color: var(--sl-color-accent);
   }
+}
 
-  .stl-ui-mintlify-compat-card-group {
-    display: grid;
-    gap: 1rem;
-    grid-template-columns: repeat(2, minmax(0, 1fr));
-  }
+.stl-ui-mintlify-compat-card-group {
+  display: grid;
+  gap: 1rem;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
 }

package/stl-docs/components/mintlify-compat/index.ts

@@ -3,13 +3,11 @@ import Tab from './Tab.astro';
 import Tabs from './Tabs.astro';
 import Frame from './Frame.astro';
 import Columns from './Columns.astro';
-import Steps from './Steps.astro';
-import Step from './Step.astro';
 import Accordion from './Accordion.astro';
 import AccordionGroup from './AccordionGroup.astro';
 
 export * from './callouts';
 export * from './Card';
 
-export { Tab, Tabs, Frame, Columns, Steps, Step, AccordionGroup, Accordion };
-export { Button } from '@stainless-api/ui-primitives';
+export { Tab, Tabs, Frame, Columns, AccordionGroup, Accordion };
+export { Button, Steps, Step } from '@stainless-api/ui-primitives';

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

@@ -1,76 +1,52 @@
 ---
-import { Dropdown, DropdownTrigger, DropdownMenu, DropdownItem } from '@stainless-api/docs-ui/src/components/dropdown';
-import { Icon } from '@astrojs/starlight/components';
+import { Dropdown } from '@stainless-api/docs/components';
 import { buildNavLinks } from './buildNavLinks';
-
-export interface Props {
-  useHamburgerIcon?: boolean;
-}
-
-const { useHamburgerIcon = false } = Astro.props as Props;
-const BUTTON_ID = 'nav-dropdown-button';
+import { ChevronsUpDownIcon } from 'lucide-react';
 
 const navLinks = buildNavLinks(Astro.locals.starlightRoute);
 
-const buttonText = (navLinks.find((item) => item.active) ?? navLinks[0]).label;
+const buttonText = (navLinks.find((item) => item.active) ?? navLinks[0]!).label;
 ---
 
-<div class="stldocs-root nav-dropdown-root">
-  <Dropdown id="nav-dropdown">
-    <DropdownTrigger
-      className={`dropdown-toggle stldocs-button-tertiary nav-dropdown-button`}
-      type="button"
-      id={BUTTON_ID}
-      aria-expanded="false"
-      withChevron={!useHamburgerIcon}
-      isIcon
-    >
-      {useHamburgerIcon ? <Icon name="bars" size="16px" /> : buttonText}
-    </DropdownTrigger>
-    <DropdownMenu className="dropdown-menu" position="below" aria-labelledby={BUTTON_ID}>
-      {
-        navLinks.map((item) => (
-          <DropdownItem key={item.link} href={item.link} className="dropdown-item">
-            {item.label}
-          </DropdownItem>
-        ))
-      }
-    </DropdownMenu>
-  </Dropdown>
-</div>
+<Dropdown id="nav-dropdown" className="nav-dropdown-root">
+  <Dropdown.Trigger>
+    <Dropdown.TriggerSelectedItem>{buttonText}</Dropdown.TriggerSelectedItem>
+    <Dropdown.TriggerIcon>
+      <ChevronsUpDownIcon size={16} />
+    </Dropdown.TriggerIcon>
+  </Dropdown.Trigger>
+  <Dropdown.Menu className="dropdown-menu">
+    {
+      navLinks.map((item) => (
+        <Dropdown.MenuItem
+          key={item.link}
+          href={item.link}
+          className="dropdown-item"
+          value={item.label}
+          isSelected={item.label === buttonText}
+        >
+          {item.label}
+          <Dropdown.MenuItemTemplate>{item.label}</Dropdown.MenuItemTemplate>
+        </Dropdown.MenuItem>
+      ))
+    }
+  </Dropdown.Menu>
+</Dropdown>
 
 <script>
-  import { initDropdown } from '@stainless-api/docs-ui/src/components/scripts/dropdown';
+  import { initDropdown } from '@stainless-api/docs/components/scripts';
   import { getPageLoadEvent } from '../../../plugin/helpers/getPageLoadEvent';
 
   document.addEventListener(getPageLoadEvent(), () => {
     initDropdown({
-      dropdownId: 'nav-dropdown',
-      isFixed: true,
+      root: document.getElementById('nav-dropdown'),
     });
   });
 </script>
-<style is:global>
-  .nav-dropdown-root .dropdown-menu.stldocs-dropdown-menu {
-    display: none;
-    position: fixed;
-    z-index: 1000;
-    width: 200px;
-    margin: 0.125rem 0 0;
-    font-size: 1rem;
-    text-align: left;
-    list-style: none;
-    background-clip: padding-box;
-  }
-
-  .nav-dropdown-root .dropdown-menu.open {
-    display: block;
-  }
-</style>
 
 <style>
   :root {
-    --menu-font-size: calc(var(--sl-text-body) * 0.9);
+    --menu-font-size: calc(var(--stl-typography-scale-base) * 0.9);
   }
 
   .dropdown {
@@ -78,24 +54,9 @@ const buttonText = (navLinks.find((item) => item.active) ?? navLinks[0]).label;
   }
 
   .dropdown-item {
-    clear: both;
-    color: var(--sl-color-text);
+    color: inherit;
     text-align: inherit;
     text-decoration: none;
     white-space: nowrap;
   }
-
-  .dropdown-item:focus {
-    color: #1e2125;
-    background-color: #e9ecef;
-  }
-
-  .nav-dropdown-root {
-    background-color: var(--sl-color-bg-nav);
-  }
-
-  .nav-dropdown-button {
-    color: var(--sl-color-text);
-    font-weight: 500;
-  }
 </style>

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

@@ -7,80 +7,98 @@ import clsx from 'clsx';
 const navLinks = buildNavLinks(Astro.locals.starlightRoute);
 ---
 
-<div id="nav-links-container">
-  <ul class="nav-links" id="nav-links-list">
-    <li class="mobile-menu-item" data-mobile-only>
-      <NavDropdown />
-    </li>
-    {
-      navLinks.map((item) => (
-        <li data-desktop-only>
-          <Button
-            href={item.link}
-            className={clsx('nav-link')}
-            variant={item.active ? 'accent-muted' : 'ghost'}
-          >
-            <span>{item.label}</span>
-          </Button>
-        </li>
-      ))
-    }
-  </ul>
-  <!-- The test container is used to measure the width of the nav links and see if they fit -->
-  <!-- TODO: probably want to clean this up bc it's duplicated code -->
-  <ul class="nav-links" id="nav-links-test-container">
-    {
-      navLinks.map((item) => (
-        <li>
-          <Button href={item.link} className={clsx('nav-link')} variant={item.active ? 'accent' : 'ghost'}>
-            <span>{item.label}</span>
-          </Button>
-        </li>
-      ))
-    }
-  </ul>
+<div id="nav-links-container" class="nav-links-container">
+  <div class="desktop-nav-links-container">
+    <ul class="nav-links" id="nav-links-list">
+      {
+        navLinks.map((item) => (
+          <li data-desktop-only>
+            <Button
+              href={item.link}
+              className={clsx('nav-link')}
+              variant={item.active ? 'accent-muted' : 'ghost'}
+            >
+              <span>{item.label}</span>
+            </Button>
+          </li>
+        ))
+      }
+    </ul>
+  </div>
+  <div class="mobile-nav-dropdown" data-mobile-only>
+    <NavDropdown />
+  </div>
 </div>
 
 <script>
   import { getPageLoadEvent } from '../../../plugin/helpers/getPageLoadEvent';
 
-  function getRequiredWidth() {
-    const navLinksTestContainer = document.getElementById('nav-links-test-container');
-    if (!navLinksTestContainer) return 1000000; // fallback to a large number
+  // We need to measure the nav links to see if they fit. We create an offscreen hidden clone for measurement.
+  function createOffscreenClone(element: HTMLElement): HTMLElement {
+    const clone = element.cloneNode(true) as HTMLElement;
+    clone.removeAttribute('id');
+    clone.id = 'cloned-nav-links-measurement';
+    clone.style.position = 'absolute';
+    clone.style.visibility = 'hidden';
+    clone.style.top = '0';
+    clone.style.left = '0';
+    clone.style.width = 'auto';
+    clone.style.whiteSpace = 'nowrap';
+    clone.style.pointerEvents = 'none';
+    clone.style.zIndex = '-9999';
+
+    clone.querySelectorAll('[data-desktop-only], [data-mobile-only]').forEach((el) => {
+      el.removeAttribute('data-desktop-only');
+    });
 
-    const rw = navLinksTestContainer.scrollWidth;
-    navLinksTestContainer.remove();
-    return rw;
+    document.body.appendChild(clone);
+    return clone;
   }
 
   function initNavbar() {
-    const masterContainer = document.getElementById('nav-links-container');
-    if (!masterContainer) return;
+    const navLinksContainer = document.getElementById('nav-links-container');
+    if (!navLinksContainer) {
+      console.error(`NavTabs: #nav-links-container not found`);
+      return;
+    }
 
-    const navLinksContainer = document.getElementById('nav-links-list');
-    if (!navLinksContainer) return;
+    const navLinksList = document.getElementById('nav-links-list');
+    if (!navLinksList) {
+      console.error(`NavTabs: #nav-links-list not found`);
+      return;
+    }
+
+    const measurementClone = createOffscreenClone(navLinksList);
+    const requiredWidth = measurementClone.clientWidth;
 
-    const requiredWidth = getRequiredWidth();
+    let currentMode: 'desktop' | 'mobile' | null = null;
 
     function checkIfFits() {
-      if (!masterContainer) return;
       if (!navLinksContainer) return;
-      const availableWidth = masterContainer.clientWidth;
-      const canFit = availableWidth >= requiredWidth;
+
+      // 16px buffer helps it feel less crowded before switching modes
+      const bufferSpace = 16;
+      const availableWidth = navLinksContainer.clientWidth;
+      const canFit = availableWidth - bufferSpace >= requiredWidth;
 
       const mode = canFit ? 'desktop' : 'mobile';
 
-      localStorage.setItem('stl-nav-links-mode', mode);
+      // Only update if mode actually changed
+      if (mode === currentMode) return;
+
+      currentMode = mode;
 
-      document.documentElement.classList.remove('stl-nav-links-mode-desktop');
-      document.documentElement.classList.remove('stl-nav-links-mode-mobile');
+      localStorage.setItem('stl-nav-links-mode', mode);
 
+      document.documentElement.classList.remove('stl-nav-links-mode-desktop', 'stl-nav-links-mode-mobile');
       document.documentElement.classList.add('stl-nav-links-mode-' + mode);
     }
 
-    window.addEventListener('resize', () => {
+    const resizeObserver = new ResizeObserver(() => {
       checkIfFits();
     });
+
+    resizeObserver.observe(navLinksContainer);
     checkIfFits();
   }
 
@@ -109,55 +127,35 @@ const navLinks = buildNavLinks(Astro.locals.starlightRoute);
 </style>
 
 <style>
-  /* :root {
-    --menu-font-size: calc(var(--sl-text-body));
-  } */
+  .nav-links-container {
+    flex-grow: 1;
+    margin-left: 1rem;
+    margin-right: 1rem;
+  }
 
-  #nav-links-container {
-    visibility: hidden;
+  .desktop-nav-links-container {
     display: flex;
     flex-grow: 1;
     justify-content: flex-start;
     overflow: hidden;
-    margin-left: 1rem;
-    margin-right: 1rem;
   }
 
   .nav-links {
     display: flex;
     list-style: none;
-    gap: 0;
+    gap: 4px;
     padding: 0;
     margin: 0;
     white-space: nowrap;
     overflow: hidden;
   }
 
-  #nav-links-test-container {
-    position: absolute;
-    top: 0;
-    left: 0;
-    visibility: hidden;
-  }
-
-  .nav-links li {
-    display: flex;
-    align-items: center;
-    justify-content: center;
-  }
-
-  .nav-link {
-    text-decoration: none;
-    flex: 1;
-
-    &.stl-ui-button--ghost:hover {
-      color: var(--sl-color-text-accent);
-      background-color: transparent;
-    }
+  .mobile-nav-dropdown {
+    flex-grow: 1;
   }
 
   @media (min-width: 50rem) {
-    #nav-links-container {
+    .desktop-nav-links-container {
       display: flex;
       visibility: visible;
     }